intentdna 1.0.0

package/dist/runtime/agent-md.js

@@ -0,0 +1,257 @@
+/**
+ * Intent DNA — Agent MD Adapter
+ *
+ * Compiles RoleDef definitions into Claude Code agent markdown files.
+ * Each role produces a .md file with YAML frontmatter (name, tools,
+ * disallowedTools, model) and a markdown body containing role description,
+ * scope rules, and DNA behavioral guidelines.
+ *
+ * Output directory: .claude/agents/<name>.md
+ */
+import { mkdir, writeFile, readFile, readdir, rm } from "node:fs/promises";
+import { join } from "node:path";
+const SENTINEL_COMMENT = "<!-- intentdna:managed — do not edit manually -->";
+// ── Helpers ────────────────────────────────────────────────
+/**
+ * Convert camelCase or snake_case to kebab-case.
+ */
+export function toKebabCase(name) {
+    return name
+        // Insert hyphen before uppercase letters (camelCase → camel-Case)
+        .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+        // Replace underscores with hyphens (snake_case → snake-case)
+        .replace(/_/g, "-")
+        .toLowerCase();
+}
+/**
+ * Render YAML frontmatter string (without --- delimiters).
+ */
+function renderFrontmatter(name, role, options) {
+    const prefix = options?.namePrefix ?? "dna-";
+    const fullName = `${prefix}${toKebabCase(name)}`;
+    const lines = [];
+    lines.push(`name: ${fullName}`);
+    lines.push(`description: "${escapeYamlString(role.description)}"`);
+    if (role.tool_permissions?.allow && role.tool_permissions.allow.length > 0) {
+        lines.push(`tools: ${role.tool_permissions.allow.join(", ")}`);
+    }
+    if (role.tool_permissions?.deny && role.tool_permissions.deny.length > 0) {
+        lines.push(`disallowedTools: ${role.tool_permissions.deny.join(", ")}`);
+    }
+    if (role.model) {
+        lines.push(`model: ${role.model}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Escape special characters in YAML string values.
+ */
+function escapeYamlString(s) {
+    return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+/**
+ * Render scope section if scope is defined.
+ */
+function renderScope(scope) {
+    const lines = [];
+    lines.push("## Scope\n");
+    if (scope.read && scope.read.length > 0) {
+        lines.push(`- Read: ${scope.read.join(", ")}`);
+    }
+    if (scope.write && scope.write.length > 0) {
+        lines.push(`- Write: ${scope.write.join(", ")}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Render behavioral guidelines from ConstraintIR prompt_directives.
+ */
+function renderGuidelines(ir) {
+    if (ir.prompt_directives.length === 0)
+        return "";
+    const lines = [];
+    lines.push("## Behavioral Guidelines\n");
+    // Group by priority
+    const high = ir.prompt_directives.filter((d) => d.priority === "high");
+    const medium = ir.prompt_directives.filter((d) => d.priority === "medium");
+    const low = ir.prompt_directives.filter((d) => d.priority === "low");
+    if (high.length > 0) {
+        lines.push("### Critical");
+        for (const d of high) {
+            lines.push(`- **${d.text}**`);
+        }
+        lines.push("");
+    }
+    if (medium.length > 0) {
+        lines.push("### Standard");
+        for (const d of medium) {
+            lines.push(`- ${d.text}`);
+        }
+        lines.push("");
+    }
+    if (low.length > 0) {
+        lines.push("### Preferences");
+        for (const d of low) {
+            lines.push(`- ${d.text}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n").trimEnd();
+}
+/**
+ * Render instructions section as a numbered list.
+ */
+function renderInstructions(instructions) {
+    const lines = [];
+    lines.push("## Instructions\n");
+    for (let i = 0; i < instructions.length; i++) {
+        lines.push(`${i + 1}. ${instructions[i]}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Render output schema section.
+ */
+function renderOutputSchema(schema) {
+    const lines = [];
+    lines.push("## Output Format\n");
+    if (schema.path) {
+        lines.push(`- Output path: \`${schema.path}\``);
+    }
+    if (schema.format && schema.format !== "markdown") {
+        lines.push(`- Final format: ${schema.format}`);
+    }
+    if (schema.required_sections && schema.required_sections.length > 0) {
+        lines.push("");
+        lines.push("Required sections:");
+        for (const section of schema.required_sections) {
+            lines.push(`- \`## ${section}\``);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Render post checks section.
+ */
+function renderPostChecks(checks) {
+    const lines = [];
+    lines.push("## Post Checks\n");
+    for (const check of checks) {
+        lines.push(`- ${check}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Render the full markdown body.
+ */
+function renderBody(name, role, ir, options) {
+    const prefix = options?.namePrefix ?? "dna-";
+    const fullName = `${prefix}${toKebabCase(name)}`;
+    const compiledAt = new Date().toISOString();
+    const includeDNA = options?.includeDNAGuidelines ?? true;
+    const sections = [];
+    // Sentinel + metadata
+    sections.push(SENTINEL_COMMENT);
+    sections.push(`<!-- Compiled: ${compiledAt} -->`);
+    sections.push("");
+    // Title + description
+    sections.push(`# ${fullName}`);
+    sections.push("");
+    sections.push(role.description);
+    // Instructions
+    if (role.instructions && role.instructions.length > 0) {
+        sections.push("");
+        sections.push(renderInstructions(role.instructions));
+    }
+    // Scope
+    if (role.scope) {
+        sections.push("");
+        sections.push(renderScope(role.scope));
+    }
+    // Behavioral guidelines from IR
+    if (includeDNA && ir && ir.prompt_directives.length > 0) {
+        sections.push("");
+        sections.push(renderGuidelines(ir));
+    }
+    // Output format
+    if (role.output_schema && typeof role.output_schema !== "string") {
+        sections.push("");
+        sections.push(renderOutputSchema(role.output_schema));
+    }
+    // Post checks
+    if (role.post_checks && role.post_checks.length > 0) {
+        sections.push("");
+        sections.push(renderPostChecks(role.post_checks));
+    }
+    return sections.join("\n") + "\n";
+}
+// ── Core Functions ─────────────────────────────────────────
+/**
+ * Compile a single RoleDef into an agent MD file.
+ * Pure function, no side effects.
+ */
+export function compileRoleToAgentMD(roleName, role, ir, options) {
+    const prefix = options?.namePrefix ?? "dna-";
+    const kebabName = toKebabCase(roleName);
+    const fileName = `${prefix}${kebabName}.md`;
+    const frontmatter = renderFrontmatter(roleName, role, options);
+    const body = renderBody(roleName, role, ir, options);
+    const content = `---\n${frontmatter}\n---\n\n${body}`;
+    return { roleName, fileName, content };
+}
+/**
+ * Compile all roles from IntentDNA into agent MD files.
+ * Returns compilation results for each role.
+ */
+export function compileAllRolesToAgentMD(roles, ir, options) {
+    return Object.entries(roles).map(([name, role]) => compileRoleToAgentMD(name, role, ir, options));
+}
+// ── File Operations ────────────────────────────────────────
+/**
+ * Write agent MD results to the file system.
+ * Creates the output directory if it doesn't exist.
+ * Returns list of written file paths.
+ */
+export async function writeAgentMDFiles(results, outputDir) {
+    await mkdir(outputDir, { recursive: true });
+    const written = [];
+    for (const result of results) {
+        const path = join(outputDir, result.fileName);
+        await writeFile(path, result.content, "utf-8");
+        written.push(path);
+    }
+    return written;
+}
+/**
+ * Remove Intent DNA generated agent MD files from a directory.
+ * Only removes files that contain the sentinel comment.
+ * Returns number of files removed.
+ */
+export async function removeAgentMDFiles(outputDir) {
+    let entries;
+    try {
+        entries = await readdir(outputDir);
+    }
+    catch {
+        // Directory doesn't exist
+        return 0;
+    }
+    let removed = 0;
+    for (const entry of entries) {
+        if (!entry.endsWith(".md"))
+            continue;
+        const path = join(outputDir, entry);
+        try {
+            const content = await readFile(path, "utf-8");
+            if (content.includes(SENTINEL_COMMENT)) {
+                await rm(path);
+                removed++;
+            }
+        }
+        catch {
+            // Skip files that can't be read
+        }
+    }
+    return removed;
+}
+//# sourceMappingURL=agent-md.js.map

package/dist/runtime/agent-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-md.js","sourceRoot":"","sources":["../../src/runtime/agent-md.ts"],"names":[],"mappings":"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"}

package/dist/runtime/claude-sdk.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Intent DNA — Claude Agent SDK Adapter
+ *
+ * Compiles Constraint IR into ClaudeAgentOptions-compatible configuration:
+ *   prompt_directives     → system_prompt
+ *   tool_filters          → allowed_tools filtering
+ *   pre_execution_gates   → PreToolUse hooks
+ *   post_execution_validators → PostToolUse hooks
+ *   context_injections    → UserPromptSubmit hook
+ */
+import type { ConstraintIR } from "../schema/types.js";
+export interface DNAHookOutput {
+    hookSpecificOutput?: {
+        hookEventName: string;
+        permissionDecision?: "allow" | "deny" | "ask";
+        permissionDecisionReason?: string;
+    };
+    systemMessage?: string;
+}
+export interface ClaudeDNAConfig {
+    /** DNA-generated system prompt addition */
+    system_prompt_addition: string;
+    /** PreToolUse hook function source (serializable logic) */
+    pre_tool_rules: PreToolRule[];
+    /** PostToolUse hook function source (serializable logic) */
+    post_tool_rules: PostToolRule[];
+    /** Context to inject via UserPromptSubmit */
+    context_additions: string[];
+    /** Tool names/patterns to deprioritize in descriptions */
+    deprioritized_tools: string[];
+    /** Source DNA IDs for tracing */
+    source_dna_ids: string[];
+    /** Compilation timestamp */
+    compiled_at: string;
+}
+export interface PreToolRule {
+    condition: string;
+    action: "block" | "escalate" | "warn";
+    message: string;
+    source_gene: string;
+}
+export interface PostToolRule {
+    check: string;
+    threshold?: number;
+    source_gene: string;
+}
+/**
+ * Compile Constraint IR to Claude Agent SDK configuration.
+ */
+export declare function compileForClaude(ir: ConstraintIR): ClaudeDNAConfig;
+//# sourceMappingURL=claude-sdk.d.ts.map

package/dist/runtime/claude-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-sdk.d.ts","sourceRoot":"","sources":["../../src/runtime/claude-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,MAAM,WAAW,aAAa;IAC5B,kBAAkB,CAAC,EAAE;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,kBAAkB,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;QAC9C,wBAAwB,CAAC,EAAE,MAAM,CAAC;KACnC,CAAC;IACF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,sBAAsB,EAAE,MAAM,CAAC;IAE/B,2DAA2D;IAC3D,cAAc,EAAE,WAAW,EAAE,CAAC;IAE9B,4DAA4D;IAC5D,eAAe,EAAE,YAAY,EAAE,CAAC;IAEhC,6CAA6C;IAC7C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAE5B,0DAA0D;IAC1D,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAE9B,iCAAiC;IACjC,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAID;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,YAAY,GAAG,eAAe,CAsElE"}

package/dist/runtime/claude-sdk.js

@@ -0,0 +1,78 @@
+/**
+ * Intent DNA — Claude Agent SDK Adapter
+ *
+ * Compiles Constraint IR into ClaudeAgentOptions-compatible configuration:
+ *   prompt_directives     → system_prompt
+ *   tool_filters          → allowed_tools filtering
+ *   pre_execution_gates   → PreToolUse hooks
+ *   post_execution_validators → PostToolUse hooks
+ *   context_injections    → UserPromptSubmit hook
+ */
+// ── Compiler ────────────────────────────────────────────────
+/**
+ * Compile Constraint IR to Claude Agent SDK configuration.
+ */
+export function compileForClaude(ir) {
+    // Build system prompt addition from directives
+    const promptLines = [];
+    promptLines.push("# Intent DNA — Active Behavioral Guidelines");
+    promptLines.push("");
+    if (ir.active_context) {
+        promptLines.push(`Active context: ${ir.active_context}`);
+        promptLines.push("");
+    }
+    // Group by priority
+    const highPriority = ir.prompt_directives.filter((d) => d.priority === "high");
+    const medPriority = ir.prompt_directives.filter((d) => d.priority === "medium");
+    const lowPriority = ir.prompt_directives.filter((d) => d.priority === "low");
+    if (highPriority.length > 0) {
+        promptLines.push("## Critical Guidelines");
+        for (const d of highPriority) {
+            promptLines.push(`- ${d.text}`);
+        }
+        promptLines.push("");
+    }
+    if (medPriority.length > 0) {
+        promptLines.push("## Standard Guidelines");
+        for (const d of medPriority) {
+            promptLines.push(`- ${d.text}`);
+        }
+        promptLines.push("");
+    }
+    if (lowPriority.length > 0) {
+        promptLines.push("## Soft Preferences");
+        for (const d of lowPriority) {
+            promptLines.push(`- ${d.text}`);
+        }
+        promptLines.push("");
+    }
+    // Add gate descriptions to prompt (so LLM is aware of constraints)
+    if (ir.pre_execution_gates.length > 0) {
+        promptLines.push("## Hard Constraints (will be enforced by system)");
+        for (const gate of ir.pre_execution_gates) {
+            promptLines.push(`- ${gate.message}`);
+        }
+        promptLines.push("");
+    }
+    return {
+        system_prompt_addition: promptLines.join("\n"),
+        pre_tool_rules: ir.pre_execution_gates.map((g) => ({
+            condition: g.condition,
+            action: g.action,
+            message: g.message,
+            source_gene: g.source_gene,
+        })),
+        post_tool_rules: ir.post_execution_validators.map((v) => ({
+            check: v.check,
+            threshold: v.threshold,
+            source_gene: v.source_gene,
+        })),
+        context_additions: ir.context_injections.map((c) => c.text),
+        deprioritized_tools: ir.tool_filters
+            .filter((f) => f.action === "deprioritize" && f.target)
+            .map((f) => f.target),
+        source_dna_ids: ir.source_dna_ids,
+        compiled_at: ir.compiled_at,
+    };
+}
+//# sourceMappingURL=claude-sdk.js.map

package/dist/runtime/claude-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-sdk.js","sourceRoot":"","sources":["../../src/runtime/claude-sdk.ts"],"names":[],"mappings":"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"}

package/dist/runtime/hooks.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Intent DNA — Hook Adapter
+ *
+ * Compiles Constraint IR into shell scripts for Claude Code hooks.
+ * These scripts enforce DNA constraints at the harness level (deterministic),
+ * not the prompt level (probabilistic).
+ *
+ * Output:
+ *   - PreToolUse hook: blocks/escalates tool calls based on pre_execution_gates + tool_filters
+ *   - PostToolUse hook: validates tool outputs based on post_execution_validators
+ *   - UserPromptSubmit hook: injects DNA policy reminders on each user prompt
+ *   - SubagentStop hook: audits role scope compliance when subagents finish
+ *   - PreCompact hook: preserves critical DNA directives before context compaction
+ *   - Notification hook: fires on DNA policy violations
+ *
+ * See docs/references/cc-source-analysis.md for the full Claude Code hook event catalog (27 events).
+ *
+ * Hook scripts read JSON from stdin (tool_name, tool_input, agent_type)
+ * and exit with code 2 to block, or 0 to allow.
+ */
+import type { ConstraintIR } from "../schema/types.js";
+export interface HookScripts {
+    preToolUse: string | null;
+    postToolUse: string | null;
+    userPromptSubmit: string | null;
+    subagentStop: string | null;
+    preCompact: string | null;
+    notification: string | null;
+}
+/** Options for hook compilation */
+export interface HookCompileOptions {
+    /** Agent name prefix for role scope case matching (default "dna-") */
+    agentPrefix?: string;
+    /** Role definitions for output_schema enforcement */
+    roles?: Record<string, import("../schema/types.js").RoleDef>;
+}
+/**
+ * Compile Constraint IR into hook shell scripts.
+ * Returns null for a hook type if there are no relevant constraints.
+ */
+export declare function compileToHooks(ir: ConstraintIR, options?: HookCompileOptions): HookScripts;
+/**
+ * Write hook scripts to the .claude/hooks/ directory.
+ * Creates the directory if it doesn't exist.
+ * Returns list of files written.
+ */
+export declare function writeHookScripts(hooksDir: string, scripts: HookScripts): Promise<string[]>;
+/**
+ * Remove hook scripts previously written by Intent DNA.
+ * Only removes files that contain the sentinel comment.
+ * Returns number of files removed.
+ */
+export declare function removeHookScripts(hooksDir: string): Promise<number>;
+/**
+ * Generate settings.json hook configuration snippet.
+ * This can be merged into the project's .claude/settings.json.
+ */
+export declare function generateSettingsSnippet(hooksDir: string): object;
+/**
+ * Extract directory prefix from a glob pattern.
+ * "src/**\/*.ts" → "src/"
+ * "test/**" → "test/"
+ * "*.md" → "" (root)
+ * "package.json" → "package.json" (exact path)
+ */
+export declare function globToPrefix(glob: string): string;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/runtime/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/runtime/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAgD,MAAM,oBAAoB,CAAC;AAKrG,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,mCAAmC;AACnC,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,oBAAoB,EAAE,OAAO,CAAC,CAAC;CAC9D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,WAAW,CAU1F;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBnB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBzE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAmChE;AAkTD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIjD"}