intentdna 1.6.4 → 1.7.0

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "intentdna",
       "description": "Declarative policy layer for AI agent behavior with plugin-managed hook runtime for Claude Code.",
-      "version": "1.6.4",
+      "version": "1.7.0",
       "author": {
         "name": "Samuel"
       },
@@ -25,5 +25,5 @@
       ]
     }
   ],
-  "version": "1.6.4"
+  "version": "1.7.0"
 }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "intentdna",
-  "version": "1.6.4",
+  "version": "1.7.0",
   "description": "Declarative policy layer for AI agent behavior",
   "author": {
     "name": "Samuel"

package/dist/cli/commands/compile.js

@@ -4,53 +4,8 @@
  * Compile DNA files to framework-specific configuration.
  */
 import { writeFile } from "node:fs/promises";
-import { resolve, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-import { compileFromFiles } from "../../compiler/index.js";
+import { compileFromFiles, expandDNAInputFiles } from "../../compiler/index.js";
 import { compileForClaude } from "../../runtime/claude-sdk.js";
-/**
- * Resolve the species default DNA path relative to this module's location.
- */
-function resolveSpeciesPath(ref) {
-    if (!ref.startsWith("species:"))
-        return null;
-    const name = ref.slice("species:".length);
-    const thisDir = dirname(fileURLToPath(import.meta.url));
-    // From dist/cli/commands/ -> dist/species/
-    return resolve(thisDir, "..", "..", "species", `${name}.dna.json`);
-}
-/**
- * Expand species references in file list and add species default if any DNA inherits it.
- */
-async function expandFiles(files) {
-    const { readFile } = await import("node:fs/promises");
-    const expanded = [];
-    const seen = new Set();
-    // First pass: collect all files and check for species references
-    for (const file of files) {
-        const abs = resolve(file);
-        if (seen.has(abs))
-            continue;
-        seen.add(abs);
-        expanded.push(abs);
-        // Check if this DNA inherits from species
-        try {
-            const raw = await readFile(abs, "utf-8");
-            const dna = JSON.parse(raw);
-            for (const ref of dna.cascade?.inherits ?? []) {
-                const speciesPath = resolveSpeciesPath(ref);
-                if (speciesPath && !seen.has(speciesPath)) {
-                    seen.add(speciesPath);
-                    expanded.unshift(speciesPath); // species goes first (lowest priority)
-                }
-            }
-        }
-        catch {
-            // Will fail later during compilation with proper error
-        }
-    }
-    return expanded;
-}
 export async function runCompile(opts) {
     if (opts.files.length === 0) {
         process.stderr.write("Error: no files specified\n");
@@ -62,7 +17,7 @@ export async function runCompile(opts) {
         return 2;
     }
     try {
-        const expandedFiles = await expandFiles(opts.files);
+        const expandedFiles = await expandDNAInputFiles(opts.files);
         const ir = await compileFromFiles(expandedFiles, opts.context);
         let output;
         if (opts.ir) {

package/dist/cli/commands/context.d.ts

@@ -0,0 +1,8 @@
+export interface ContextOptions {
+    subcommand: string;
+    query?: string;
+    id?: string;
+    files?: string[];
+    projectDir?: string;
+}
+export declare function runContext(opts: ContextOptions): Promise<number>;

package/dist/cli/commands/context.js

@@ -0,0 +1,63 @@
+import { resolve } from "node:path";
+import { findContextSource, formatContextSource, loadContextSourceIndex, readContextSourceDocument, searchContextSources, } from "../../runtime/context-sources.js";
+function usage() {
+    return "Usage: dna context <index|search|doc> [query|id] [files...]\n";
+}
+export async function runContext(opts) {
+    const projectDir = opts.projectDir ?? process.cwd();
+    const files = opts.files?.map((file) => resolve(projectDir, file));
+    const index = await loadContextSourceIndex(projectDir, files);
+    switch (opts.subcommand) {
+        case "index": {
+            if (index.sources.length === 0) {
+                process.stdout.write("No advisory context sources declared.\n");
+                return 0;
+            }
+            process.stdout.write(index.sources.map(formatContextSource).join("\n") + "\n");
+            if (index.planning_instructions.length > 0) {
+                process.stdout.write("\nPlanning instructions:\n");
+                for (const instruction of index.planning_instructions) {
+                    process.stdout.write(`- ${instruction}\n`);
+                }
+            }
+            return 0;
+        }
+        case "search": {
+            const query = opts.query ?? "";
+            const matches = searchContextSources(index, query);
+            if (matches.length === 0) {
+                process.stdout.write(`No advisory context sources matched '${query}'.\n`);
+                return 1;
+            }
+            process.stdout.write(matches.map(formatContextSource).join("\n") + "\n");
+            return 0;
+        }
+        case "doc": {
+            const id = opts.id ?? "";
+            if (!id) {
+                process.stderr.write("Error: context doc requires a source id.\n");
+                process.stderr.write(usage());
+                return 2;
+            }
+            const source = findContextSource(index, id);
+            if (!source) {
+                process.stderr.write(`Error: unknown advisory context source '${id}'.\n`);
+                return 1;
+            }
+            const doc = await readContextSourceDocument(projectDir, source);
+            process.stdout.write(`${formatContextSource(source)}\n`);
+            process.stdout.write("Planning-only advisory context; does not satisfy enforcement, handoff, or ArtifactManifest requirements.\n");
+            if (doc.content !== undefined) {
+                process.stdout.write("\n---\n");
+                process.stdout.write(doc.content.endsWith("\n") ? doc.content : `${doc.content}\n`);
+            }
+            else {
+                process.stdout.write("No local document body is available for this source type.\n");
+            }
+            return 0;
+        }
+        default:
+            process.stderr.write(usage());
+            return 2;
+    }
+}

package/dist/cli/commands/feedback.d.ts

@@ -9,5 +9,6 @@ export interface FeedbackOptions {
     json: boolean;
     evolve: boolean;
     dnaId?: string;
+    packageReport?: boolean;
 }
 export declare function runFeedback(opts: FeedbackOptions): Promise<number>;

package/dist/cli/commands/feedback.js

@@ -5,7 +5,18 @@
  * With --evolve: include a preview-only marker diff derived from local signals.
  */
 import { buildKernelReport, formatKernelReport } from "../../report/kernel-report.js";
+import { buildReportPackage } from "../../report/report-package.js";
 export async function runFeedback(opts) {
+    if (opts.packageReport) {
+        const reportPackage = await buildReportPackage({
+            projectDir: process.cwd(),
+            days: opts.days,
+            includeMarkerPreview: opts.evolve,
+            dnaId: opts.dnaId,
+        });
+        process.stdout.write(JSON.stringify(reportPackage, null, 2) + "\n");
+        return 0;
+    }
     const report = await buildKernelReport({
         projectDir: process.cwd(),
         days: opts.days,

package/dist/cli/commands/generate.js

@@ -11,51 +11,23 @@
 import { readFile, writeFile } from "node:fs/promises";
 import { resolve, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
+import { TEMPLATE_MATCH_METADATA } from "../../templates/metadata.js";
 const SPEC_PATH = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "..", "spec", "schema-spec.md");
 const TEMPLATES_DIR = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "templates");
-/** Keyword → template name mapping for scoring */
-const TEMPLATE_KEYWORDS = {
-    "code-review-pipeline": ["review", "code review", "pr review", "pull request", "审查"],
-    "safe-refactoring": ["refactor", "refactoring", "restructure", "rewrite safely", "重构"],
-    "tdd-strict": ["tdd", "test driven", "test first", "red green", "测试驱动"],
-    "full-pipeline": ["pipeline", "plan implement test", "full workflow", "完整流水线"],
-    "systematic-debugging": ["debug", "debugging", "bug fix", "troubleshoot", "调试"],
-    "verification-loop": ["verify", "verification", "validate", "check", "验证"],
-    "secure-dev": ["security", "secure", "owasp", "vulnerability", "安全"],
-    "enterprise-baseline": ["enterprise", "organization", "company", "corporate", "企业"],
-    "frontend-quality": ["frontend", "react", "vue", "css", "ui", "前端"],
-    "api-backend": ["api", "backend", "rest", "graphql", "server", "后端"],
-    "mobile-dev": ["mobile", "ios", "android", "react native", "移动"],
-    "documentation-writer": ["doc", "documentation", "readme", "wiki", "文档"],
-    "devops-cicd": ["devops", "ci", "cd", "deploy", "pipeline", "运维"],
-    "monorepo-governance": ["monorepo", "workspace", "packages", "governance"],
-    "flutter-behavior-lock": ["flutter", "behavior lock", "behavior spec", "行为锁定"],
-    "flutter-rewrite": ["flutter", "rewrite", "migration", "flutter rewrite"],
-    "flutter-refactoring-rescue": ["flutter", "rescue", "refactoring rescue"],
-    "multi-perspective-review": ["multi perspective", "multiple reviewer", "多角度"],
-    "subagent-parallel": ["parallel", "subagent", "concurrent", "并行"],
-    "yolo-with-guardrails": ["yolo", "fast", "guardrails", "move fast"],
-    "brainstorming-first": ["brainstorm", "explore", "ideation", "探索"],
-    "branch-finishing": ["branch", "finish", "cleanup", "pr prep"],
-    "pr-submitter": ["pr", "pull request", "submit"],
-    "migration-safety": ["migration", "migrate", "upgrade", "database migration", "dependency upgrade", "迁移"],
-    "incident-response": ["incident", "production issue", "hotfix", "outage", "postmortem", "事故"],
-    "performance-audit": ["performance", "profiling", "benchmark", "optimize", "latency", "性能"],
-};
 function scoreTemplates(description) {
     const lower = description.toLowerCase();
     const scores = [];
-    for (const [template, keywords] of Object.entries(TEMPLATE_KEYWORDS)) {
+    for (const template of TEMPLATE_MATCH_METADATA) {
         const matched = [];
-        for (const kw of keywords) {
+        for (const kw of template.keywords) {
             if (lower.includes(kw)) {
                 matched.push(kw);
             }
         }
         if (matched.length > 0) {
             scores.push({
-                name: template,
-                displayName: template.replace(/-/g, " "),
+                name: template.name,
+                displayName: template.name.replace(/-/g, " "),
                 score: matched.length,
                 matchedKeywords: matched,
             });

package/dist/cli/commands/init.js

@@ -6,8 +6,8 @@
 import { writeFile, readFile, readdir, mkdir, copyFile, access } from "node:fs/promises";
 import { resolve, dirname, basename } from "node:path";
 import { fileURLToPath } from "node:url";
-import { createHash } from "node:crypto";
 import { parseYAML } from "../../schema/yaml-parser.js";
+import { listTemplateCatalog, calculateTemplateContentHash } from "../../templates/catalog.js";
 import { sanitizeTemplateName } from "../util/version.js";
 import { validateDNA } from "../../schema/validate.js";
 import { askString, askChoice, askNumber, askYesNo, closePrompt } from "../util/prompt.js";
@@ -23,53 +23,20 @@ async function dirExists(path) {
         return false;
     }
 }
-/**
- * Extract namespace and display name from a template YAML file.
- */
-async function readTemplateMetadata(filePath) {
-    try {
-        const content = await readFile(filePath, "utf-8");
-        const data = parseYAML(content);
-        return {
-            namespace: typeof data.namespace === "string" ? data.namespace : undefined,
-            displayName: typeof data.name === "string" ? data.name : undefined,
-        };
-    }
-    catch {
-        return {};
-    }
-}
 async function listTemplates() {
-    const results = [];
-    // Built-in templates
-    try {
-        const files = await readdir(TEMPLATES_DIR);
-        for (const f of files.filter((f) => f.endsWith(".dna.yaml"))) {
-            const name = f.replace(".dna.yaml", "");
-            const meta = await readTemplateMetadata(resolve(TEMPLATES_DIR, f));
-            results.push({ name, namespace: meta.namespace, displayName: meta.displayName, source: "builtin" });
-        }
-    }
-    catch { /* no built-in templates */ }
-    // Project-local templates
-    if (await dirExists(PROJECT_TEMPLATES_DIR)) {
-        try {
-            const files = await readdir(PROJECT_TEMPLATES_DIR);
-            for (const f of files.filter((f) => f.endsWith(".dna.yaml"))) {
-                const name = f.replace(".dna.yaml", "");
-                const meta = await readTemplateMetadata(resolve(PROJECT_TEMPLATES_DIR, f));
-                results.push({ name, namespace: meta.namespace, displayName: meta.displayName, source: "project" });
-            }
-        }
-        catch { /* no project templates */ }
-    }
-    return results;
+    const entries = await listTemplateCatalog();
+    return entries.map((entry) => ({
+        name: entry.name,
+        namespace: entry.namespace,
+        displayName: entry.displayName,
+        source: entry.source,
+    }));
 }
 /**
  * Calculate SHA256 hash of template content (truncated to 16 hex chars).
  */
 export function calculateTemplateHash(content) {
-    return createHash("sha256").update(content, "utf-8").digest("hex").slice(0, 16);
+    return calculateTemplateContentHash(content);
 }
 /**
  * Inject _source_template, _template_version, and _template_content_hash fields after the namespace/type line in YAML content.
@@ -122,27 +89,8 @@ function inferTemplateName(id) {
  * Priority: .dna/configs/*.yaml (multi-config) > legacy single-config
  */
 async function autoDetectConfigsForUpgrade() {
-    // Priority 1: .dna/configs/*.yaml (multi-config)
-    try {
-        const files = await readdir(MULTI_CONFIG_DIR);
-        const yamls = files
-            .filter(f => f.endsWith(".yaml") || f.endsWith(".yml"))
-            .sort()
-            .map(f => resolve(MULTI_CONFIG_DIR, f));
-        if (yamls.length > 0)
-            return yamls;
-    }
-    catch { /* dir doesn't exist */ }
-    // Fallback: legacy single-config paths
-    const candidates = [
-        ".dna/config.yaml", ".dna/config.yml", ".dna/config.json",
-        ".dna.yaml", ".dna.yml", ".dna.json",
-    ];
-    for (const name of candidates) {
-        if (await dirExists(name))
-            return [name];
-    }
-    return [];
+    const { detectDNAConfigs } = await import("../../compiler/index.js");
+    return detectDNAConfigs(process.cwd());
 }
 /**
  * Upgrade config from a newer template version while preserving user-filled variables.

package/dist/cli/commands/run.js

@@ -9,7 +9,7 @@ import { spawn } from "node:child_process";
 import { mkdir, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 import { randomUUID } from "node:crypto";
-import { loadDNA, compileFromFiles } from "../../compiler/index.js";
+import { loadDNA, compileFromFiles, expandDNAInputFiles } from "../../compiler/index.js";
 import { cascadeDNA } from "../../compiler/cascade.js";
 import { compileWorkflow } from "../../compiler/workflow.js";
 import { compileAllRolesToAgentMD, writeAgentMDFiles, toKebabCase, } from "../../runtime/agent-md.js";
@@ -254,14 +254,15 @@ export async function runRun(opts) {
         return 2;
     }
     const maxBudget = opts.maxBudget ?? 5;
-    const permissionMode = opts.permissionMode ?? "bypassPermissions";
+    const permissionMode = opts.permissionMode ?? "default";
     const agentsDir = opts.agentsDir ?? ".claude/agents";
     try {
         // ── Step 1: Load & compile DNA ───────────────────────
         log("Loading DNA files...");
-        const dnas = await Promise.all(opts.dnaFiles.map(loadDNA));
+        const expandedDNAFiles = await expandDNAInputFiles(opts.dnaFiles);
+        const dnas = await Promise.all(expandedDNAFiles.map(loadDNA));
         const cascaded = cascadeDNA(dnas);
-        const ir = await compileFromFiles(opts.dnaFiles, {
+        const ir = await compileFromFiles(expandedDNAFiles, {
             context: opts.context,
         });
         // ── Step 2: Find & compile workflow ──────────────────

package/dist/cli/commands/show.js

@@ -3,51 +3,15 @@
  *
  * Show DNA gene expression state in human-readable format.
  */
-import { resolve, dirname } from "node:path";
-import { readFile } from "node:fs/promises";
-import { fileURLToPath } from "node:url";
-import { loadDNA, cascadeDNA, activateDNA } from "../../compiler/index.js";
+import { loadDNA, cascadeDNA, activateDNA, expandDNAInputFiles } from "../../compiler/index.js";
 import { formatGene, bold } from "../util/format.js";
-function resolveSpeciesPath(ref) {
-    if (!ref.startsWith("species:"))
-        return null;
-    const name = ref.slice("species:".length);
-    const thisDir = dirname(fileURLToPath(import.meta.url));
-    return resolve(thisDir, "..", "..", "species", `${name}.dna.json`);
-}
-async function expandFiles(files) {
-    const expanded = [];
-    const seen = new Set();
-    for (const file of files) {
-        const abs = resolve(file);
-        if (seen.has(abs))
-            continue;
-        seen.add(abs);
-        expanded.push(abs);
-        try {
-            const raw = await readFile(abs, "utf-8");
-            const dna = JSON.parse(raw);
-            for (const ref of dna.cascade?.inherits ?? []) {
-                const speciesPath = resolveSpeciesPath(ref);
-                if (speciesPath && !seen.has(speciesPath)) {
-                    seen.add(speciesPath);
-                    expanded.unshift(speciesPath);
-                }
-            }
-        }
-        catch {
-            // Will fail later with proper error
-        }
-    }
-    return expanded;
-}
 export async function runShow(opts) {
     if (opts.files.length === 0) {
         process.stderr.write("Error: no files specified\n");
         return 2;
     }
     try {
-        const expandedFiles = await expandFiles(opts.files);
+        const expandedFiles = await expandDNAInputFiles(opts.files);
         const dnas = await Promise.all(expandedFiles.map(loadDNA));
         const cascaded = cascadeDNA(dnas);
         const activated = activateDNA(cascaded, opts.context ?? null);

package/dist/cli/commands/sync.d.ts

@@ -10,6 +10,7 @@
  *
  * Targets: claude-md, soul-md, cursorrules, system-prompt
  */
+export type SyncMode = "auto" | "plugin" | "bin";
 export interface SyncOptions {
     files: string[];
     target: string;
@@ -26,7 +27,10 @@ export interface SyncOptions {
     settingsPath?: string;
     lockFile?: string;
     remove: boolean;
+    mode?: SyncMode;
     plugin?: boolean;
+    dryRun?: boolean;
+    postSummary?: boolean;
 }
 /**
  * Detect whether intentdna is running as a Claude Code plugin or standalone binary.
@@ -47,8 +51,8 @@ export declare function detectMode(): Promise<"plugin" | "bin">;
  */
 export declare function cleanStaleDNAFiles(dir: string, type: "agents" | "skills", activeNamespaces: string[]): Promise<string[]>;
 /**
- * Auto-detect DNA configs: multi-config (.dna/configs/*.yaml) or legacy single-config.
- * Returns array of absolute paths.
+ * Auto-detect DNA config file in current directory (legacy single-config).
+ * Priority: .dna/config.yaml > .dna/config.yml > .dna/config.json > .dna.yaml > .dna.yml > .dna.json
  */
 export declare function autoDetectConfigs(): Promise<string[]>;
 /**
@@ -74,12 +78,11 @@ export interface TemplateUpgradeInfo {
     templateName: string;
     currentVersion: string;
     availableVersion: string;
+    reason: "version-update" | "missing-hash" | "content-drift";
 }
 /**
- * Check template versions against current template content hashes.
- * Returns upgrade info for changed configs and prints human-readable suggestions.
- *
- * Uses content hash comparison instead of semver — detects any template content change.
+ * Check stamped template metadata against the current template catalog.
+ * Version mismatch is the primary upgrade signal; content hash drift is a fallback.
  */
 export declare function checkTemplateVersions(configPaths: string[]): Promise<TemplateUpgradeInfo[]>;
 export declare function runSync(opts: SyncOptions): Promise<number>;