{"_id":"@aikdna/kdna-studio","_rev":"2-8a4f759fff68e9330981b286bc8e0596","name":"@aikdna/kdna-studio","dist-tags":{"latest":"1.2.1"},"versions":{"1.2.1":{"name":"@aikdna/kdna-studio","version":"1.2.1","keywords":["kdna","domain-judgment","authoring","judgment-cards","human-lock","compile","validate"],"license":"Apache-2.0","_id":"@aikdna/kdna-studio@1.2.1","maintainers":[{"name":"code2mp4","email":"hi@code2mp4.com"}],"homepage":"https://github.com/aikdna/kdna-studio-core#readme","bugs":{"url":"https://github.com/aikdna/kdna-studio-core/issues"},"dist":{"shasum":"4214a7ffc4766a85fc1bf183813b5ec4006a2a26","tarball":"https://registry.npmjs.org/@aikdna/kdna-studio/-/kdna-studio-1.2.1.tgz","fileCount":29,"integrity":"sha512-Imxd+JOwk3ydl4hH91l9CArQ5OvjztxadbvW3RQfty6rDSsS82mZt/WXcga0sAOq4W0dBNkItEOv2lwpqSrsmw==","signatures":[{"sig":"MEYCIQCI03gOjB4icFenf6gz4gB79tsTooQ1reXSn9Usk1t8KQIhAKkGxO7AF4Hyela/NxxYldlFDMfP6OYSMV1uUGYFDlJz","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":186089},"main":"src/index.js","type":"commonjs","engines":{"node":">=18"},"gitHead":"08283ef1736cedb96b58024389363d3d2732a5c2","scripts":{"test":"node --test tests/*.test.js"},"_npmUser":{"name":"code2mp4","email":"hi@code2mp4.com"},"repository":{"url":"git+https://github.com/aikdna/kdna-studio-core.git","type":"git"},"_npmVersion":"10.9.4","description":"Open-source authoring kernel for creating KDNA domains — JS/npm package. KDNA Studio lets any app create valid, testable, packageable KDNA domains.","directories":{},"_nodeVersion":"22.21.1","dependencies":{"@aikdna/kdna-core":"^0.3.0"},"_hasShrinkwrap":false,"peerDependencies":{"@aikdna/kdna-cli":">=0.16.0"},"_npmOperationalInternal":{"tmp":"tmp/kdna-studio_1.2.1_1779688507759_0.5481584791478522","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Renamed and split: use @aikdna/kdna-studio-core for SDK/compiler kernel and @aikdna/kdna-studio-cli for the kdna-studio command."}},"time":{"created":"2026-05-25T05:55:07.659Z","modified":"2026-05-29T14:24:32.626Z","1.2.1":"2026-05-25T05:55:07.902Z"},"bugs":{"url":"https://github.com/aikdna/kdna-studio-core/issues"},"license":"Apache-2.0","homepage":"https://github.com/aikdna/kdna-studio-core#readme","keywords":["kdna","domain-judgment","authoring","judgment-cards","human-lock","compile","validate"],"repository":{"url":"git+https://github.com/aikdna/kdna-studio-core.git","type":"git"},"description":"Open-source authoring kernel for creating KDNA domains — JS/npm package. KDNA Studio lets any app create valid, testable, packageable KDNA domains.","maintainers":[{"name":"code2mp4","email":"hi@code2mp4.com"}],"readme":"# KDNA Studio\n\nOpen-source authoring kernel for creating KDNA domains — JS/npm package. AI can propose. Humans confirm. Only locked judgment compiles.\n\n**KDNA Studio is the JS authoring kernel.** It is not a UI tool. It is a pure-logic engine for creating KDNA domains from any JavaScript application.\n\n| Library | Language | Role |\n|---------|----------|------|\n| `@aikdna/kdna-cli` | JS/npm | **Operate** KDNA — install, verify, pack, publish |\n| **`@aikdna/kdna-studio`** | JS/npm | **Create** KDNA — author, lock, compile, export |\n| `@aikdna/kdna-core` | JS/npm | **Use** KDNA — load, validate, format |\n\n## What it does\n\n- **Project Model** — `studio.project.json` with full metadata, provenance tracking\n- **Evidence Room** — import raw material (text, markdown, interviews, cases)\n- **Judgment Cards** — 8 card types: axiom, ontology, stance, framework, misunderstanding, self_check, banned_term, terminology\n- **Human Lock** — AI proposes, human confirms. Only locked cards compile.\n- **Feynman Restatement** — verify understanding, not just agreement\n- **Quality Gates** — readiness check: draft → structurally_ready → judgment_ready → publish_ready\n- **Compiler** — locked cards → `KDNA_Core.json` + `KDNA_Patterns.json`\n- **Test Lab** — A/B comparison (No KDNA vs Best Prompt vs KDNA)\n- **Provenance** — content fingerprinting, build tracking, audit trail\n\n## What it is not\n\n- Not a UI framework\n- Not the official KDNA Studio App\n- Not a one-click AI generator\n- Not a prompt engineering tool\n\n## Authoring Flow\n\n```\nEvidence Room → Judgment Cards → Human Lock → Quality Gate → Compile → Validate → Export\n```\n\n## Install\n\n```bash\nnpm install @aikdna/kdna-studio\n```\n\n## Quick Start\n\n```js\nconst { createProject, createCard, lockCard, compileDomain } = require('@aikdna/kdna-studio-core');\n\n// 1. Create a project\nconst project = createProject('writing_judgment', 'domain', {\n  author: { name: 'Writing Expert', id: 'writer_001' }\n});\n\n// 2. Create judgment cards\nconst card = createCard('axiom', {\n  one_sentence: 'Most writing problems are structural, not language-level.',\n  full_statement: 'When reviewing content, diagnose structure before language.',\n  why: 'Surface polishing on structurally weak content wastes effort.',\n  applies_when: ['User asks to review content'],\n  does_not_apply_when: ['User explicitly asks for grammar check only'],\n  failure_risk: 'May over-diagnose structural problems in content that only needs polish.'\n});\nproject.cards.push(card);\n\n// 3. Human Lock\nconst locked = lockCard(card, {\n  by: 'writer_001',\n  statement: 'This represents my professional writing judgment.',\n  checked: { applies_when: true, does_not_apply_when: true, failure_risk: true }\n});\n\n// 4. Check readiness\nconst { checkHumanLockGate, exportProject } = require('@aikdna/kdna-studio-core');\nconst gate = checkHumanLockGate(project);\nif (!gate.blocked) {\n  // 5. Export\n  const json = exportProject(project);\n  console.log('Ready to publish');\n}\n```\n\n## Card Types (v1.0)\n\n| Type | Compiles to | Description |\n|------|------------|-------------|\n| `axiom` | KDNA_Core.json | Core judgment principle |\n| `ontology` | KDNA_Core.json | Concept boundaries |\n| `framework` | KDNA_Core.json | Structured diagnostic approach |\n| `stance` | KDNA_Core.json | Domain position/perspective |\n| `misunderstanding` | KDNA_Patterns.json | Common wrong interpretation |\n| `self_check` | KDNA_Patterns.json | Yes/no verification question |\n| `banned_term` | KDNA_Patterns.json | Terms to avoid and replacements |\n| `terminology` | KDNA_Patterns.json | Standard term definitions |\n\n## Card State Machine\n\n```\ndraft → revised → locked → tested → published → deprecated\n```\n\nRules:\n- Only `locked`/`tested`/`published` cards can be compiled\n- Cards must have Human Lock (`human_lock.by` + `human_lock.statement`) before locking\n- Human Lock must confirm `applies_when`, `does_not_apply_when`, `failure_risk` were reviewed\n\n## Human Lock\n\nAI can propose. Human must confirm. Only locked judgment can compile.\n\n```js\nlockCard(card, {\n  by: 'expert_id',\n  statement: 'I confirm this reflects my domain judgment.',\n  checked: {\n    applies_when: true,\n    does_not_apply_when: true,\n    failure_risk: true\n  }\n});\n```\n\n## License\n\nApache-2.0 — see [LICENSE](LICENSE).\n\nKDNA Studio Core is open source. Official KDNA Studio App, hosted collaboration, managed registry, quality review workflows, and enterprise private registry may be commercial services.\n\n## Related\n\n- [KDNA Protocol](https://github.com/aikdna/kdna) — Specification\n- [kdna-cli](https://github.com/aikdna/kdna-cli) — CLI tools\n- [kdna-core-swift](https://github.com/aikdna/kdna-core-swift) — Swift runtime for macOS/iOS\n- [aikdna.com](https://aikdna.com) — Website\n","readmeFilename":"README.md"}