intentdna 1.5.12 → 1.5.14

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "intentdna",
       "description": "DNA template compilation + runtime enforcement",
-      "version": "1.5.12",
+      "version": "1.5.14",
       "source": "./"
     }
   ]

package/.claude-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "intentdna",
-  "version": "1.5.12",
+  "version": "1.5.14",
   "description": "Declarative policy layer for AI agent governance"
 }

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

@@ -11,4 +11,8 @@ export interface InitOptions {
     register?: string;
     upgrade?: string | boolean;
 }
+/**
+ * Calculate SHA256 hash of template content (truncated to 16 hex chars).
+ */
+export declare function calculateTemplateHash(content: string): string;
 export declare function runInit(opts: InitOptions): Promise<number>;

package/dist/cli/commands/init.js

@@ -6,8 +6,9 @@
 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 { getPackageVersion, sanitizeTemplateName } from "../util/version.js";
+import { sanitizeTemplateName } from "../util/version.js";
 import { validateDNA } from "../../schema/validate.js";
 import { askString, askChoice, askNumber, askYesNo, closePrompt } from "../util/prompt.js";
 const TEMPLATES_DIR = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "templates");
@@ -65,17 +66,24 @@ async function listTemplates() {
     return results;
 }
 /**
- * Inject _source_template and _template_version fields after the namespace/type line in YAML content.
+ * Calculate SHA256 hash of template content (truncated to 16 hex chars).
  */
-function injectSourceTemplate(content, templateName, version) {
+export function calculateTemplateHash(content) {
+    return createHash("sha256").update(content, "utf-8").digest("hex").slice(0, 16);
+}
+/**
+ * Inject _source_template, _template_version, and _template_content_hash fields after the namespace/type line in YAML content.
+ */
+function injectSourceTemplate(content, templateName, templateVersion, templateHash) {
     const marker = /^(namespace:\s*.+)$/m;
     const typeMarker = /^(type:\s*.+)$/m;
     const match = content.match(marker) || content.match(typeMarker);
-    const versionLine = version ? `\n_template_version: "${version}"` : "";
+    const versionLine = templateVersion ? `\n_template_version: "${templateVersion}"` : "";
+    const hashLine = templateHash ? `\n_template_content_hash: "${templateHash}"` : "";
     if (match) {
-        return content.replace(match[0], `${match[0]}\n_source_template: ${templateName}${versionLine}`);
+        return content.replace(match[0], `${match[0]}\n_source_template: ${templateName}${versionLine}${hashLine}`);
     }
-    return `_source_template: ${templateName}${versionLine}\n${content}`;
+    return `_source_template: ${templateName}${versionLine}${hashLine}\n${content}`;
 }
 /**
  * Check namespace collision against existing configs in .dna/configs/.
@@ -164,9 +172,11 @@ async function upgradeConfig(configPath, templateName) {
     const srcDir = found.source === "project" ? PROJECT_TEMPLATES_DIR : TEMPLATES_DIR;
     const srcPath = resolve(srcDir, `${found.name}.dna.yaml`);
     let newContent = await readFile(srcPath, "utf-8");
-    // 4. Inject _source_template and _template_version
-    const pkgVersion = await getPackageVersion();
-    newContent = injectSourceTemplate(newContent, found.name, pkgVersion ?? undefined);
+    // 4. Inject _source_template, _template_version, and _template_content_hash
+    const templateData = parseYAML(newContent);
+    const templateVersion = typeof templateData.version === "string" ? templateData.version : undefined;
+    const templateHash = calculateTemplateHash(newContent);
+    newContent = injectSourceTemplate(newContent, found.name, templateVersion, templateHash);
     // 5. Replace VariableDef entries with user values where they exist
     for (const [key, value] of Object.entries(userVars)) {
         // Match multi-line VariableDef: "key:\n    description: ...\n    default: ..."
@@ -290,8 +300,11 @@ export async function runInit(opts) {
         const srcPath = resolve(srcDir, `${found.name}.dna.yaml`);
         const content = await readFile(srcPath, "utf-8");
         // Inject _source_template and _template_version metadata for upgrade tracking
-        const pkgVersion = await getPackageVersion();
-        const contentWithSource = injectSourceTemplate(content, found.name, pkgVersion ?? undefined);
+        // Inject _source_template, _template_version, and _template_content_hash for upgrade tracking
+        const templateData = parseYAML(content);
+        const templateVersion = typeof templateData.version === "string" ? templateData.version : undefined;
+        const templateHash = calculateTemplateHash(content);
+        const contentWithSource = injectSourceTemplate(content, found.name, templateVersion, templateHash);
         // Check namespace collision against existing configs
         const srcData = parseYAML(content);
         const srcNs = typeof srcData.namespace === "string" ? srcData.namespace : undefined;

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

@@ -40,6 +40,12 @@ export interface SyncOptions {
  *   → ALSO write settings.json to register dna-hook events
  */
 export declare function detectMode(): Promise<"plugin" | "bin">;
+/**
+ * Remove stale DNA-managed files from a directory.
+ * Only removes files matching activeNamespaces (dna-{ns}-*).
+ * Returns list of removed paths.
+ */
+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.
@@ -70,11 +76,10 @@ export interface TemplateUpgradeInfo {
     availableVersion: string;
 }
 /**
- * Check template versions against current package version.
- * Returns upgrade info for outdated configs and prints human-readable suggestions.
+ * Check template versions against current template content hashes.
+ * Returns upgrade info for changed configs and prints human-readable suggestions.
  *
- * U1: Semver-aware comparison — only suggests upgrades when package is strictly newer.
- * Handles missing _template_version (old configs created before versioning).
+ * Uses content hash comparison instead of semver — detects any template content change.
  */
 export declare function checkTemplateVersions(configPaths: string[]): Promise<TemplateUpgradeInfo[]>;
 export declare function runSync(opts: SyncOptions): Promise<number>;

package/dist/cli/commands/sync.js

@@ -17,7 +17,6 @@ import { fileURLToPath } from "node:url";
 import { createInterface } from "node:readline";
 import { loadDNA, compileFromFiles } from "../../compiler/index.js";
 import { parseYAML } from "../../schema/yaml-parser.js";
-import { getPackageVersion } from "../util/version.js";
 import { compileToMarkdown, injectIntoFile, removeFromFile } from "../../runtime/markdown.js";
 import { compileAllRolesToAgentMD, writeAgentMDFiles, removeAgentMDFiles } from "../../runtime/agent-md.js";
 import { removeWorkflowScripts } from "../../runtime/workflow-runner.js";
@@ -72,6 +71,32 @@ const LEGACY_BASH_HOOKS = [
     "dna-pre-compact.sh",
     "dna-notification.sh",
 ];
+const TEMPLATES_DIR = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "templates");
+function calculateTemplateHash(content) {
+    return createHash("sha256").update(content, "utf-8").digest("hex").slice(0, 16);
+}
+async function findTemplateFile(templateName) {
+    // Try direct filename match first
+    const directPath = resolve(TEMPLATES_DIR, `${templateName}.dna.yaml`);
+    if (await fileExists(directPath))
+        return directPath;
+    // Fallback: search by id or name field
+    try {
+        const files = await readdir(TEMPLATES_DIR);
+        for (const file of files) {
+            if (!file.endsWith(".dna.yaml") && !file.endsWith(".dna.yml"))
+                continue;
+            const fullPath = resolve(TEMPLATES_DIR, file);
+            const content = await readFile(fullPath, "utf-8");
+            const data = parseYAML(content);
+            if (data.id === templateName || data.name === templateName) {
+                return fullPath;
+            }
+        }
+    }
+    catch { /* fail-open */ }
+    return null;
+}
 /**
  * Remove legacy bash hook scripts written by previous Intent DNA versions.
  * Only removes files that contain the sentinel comment.
@@ -93,15 +118,22 @@ async function removeLegacyBashHooks(hooksDir) {
 }
 /**
  * Remove stale DNA-managed files from a directory.
- * Scans for files/dirs containing the sentinel marker and deletes them.
+ * Only removes files matching activeNamespaces (dna-{ns}-*).
  * Returns list of removed paths.
  */
-async function cleanStaleDNAFiles(dir, type) {
+export async function cleanStaleDNAFiles(dir, type, activeNamespaces) {
     const removed = [];
     try {
         const entries = await readdir(dir, { withFileTypes: true });
         for (const entry of entries) {
             const fullPath = resolve(dir, entry.name);
+            // Extract namespace from filename: dna-{namespace}-*
+            const nsMatch = entry.name.match(/^dna-([a-z0-9_-]+)-/);
+            const fileNamespace = nsMatch ? nsMatch[1] : null;
+            // Skip if namespace doesn't match active namespaces
+            if (!fileNamespace || !activeNamespaces.includes(fileNamespace)) {
+                continue;
+            }
             if (type === "agents" && entry.isFile() && entry.name.endsWith(".md")) {
                 const content = await readFile(fullPath, "utf-8").catch(() => "");
                 if (content.includes(DNA_SENTINEL)) {
@@ -276,42 +308,44 @@ export function compareSemver(a, b) {
     return 0;
 }
 /**
- * Check template versions against current package version.
- * Returns upgrade info for outdated configs and prints human-readable suggestions.
+ * Check template versions against current template content hashes.
+ * Returns upgrade info for changed configs and prints human-readable suggestions.
  *
- * U1: Semver-aware comparison — only suggests upgrades when package is strictly newer.
- * Handles missing _template_version (old configs created before versioning).
+ * Uses content hash comparison instead of semver — detects any template content change.
  */
 export async function checkTemplateVersions(configPaths) {
-    const pkgVersion = await getPackageVersion();
-    if (!pkgVersion)
-        return [];
     const upgrades = [];
     for (const configPath of configPaths) {
         try {
             const content = await readFile(configPath, "utf-8");
             const data = parseYAML(content);
-            const tmplVersion = typeof data._template_version === "string" ? data._template_version : undefined;
             const tmplName = typeof data._source_template === "string" ? data._source_template : undefined;
-            if (tmplName && !tmplVersion) {
-                // Old config without version tracking — suggest upgrade
+            const tmplHash = typeof data._template_content_hash === "string" ? data._template_content_hash : undefined;
+            const tmplVersion = typeof data._template_version === "string" ? data._template_version : undefined;
+            if (!tmplName)
+                continue;
+            const templatePath = await findTemplateFile(tmplName);
+            if (!templatePath)
+                continue;
+            const currentTemplateContent = await readFile(templatePath, "utf-8");
+            const currentHash = calculateTemplateHash(currentTemplateContent);
+            if (!tmplHash) {
                 upgrades.push({
                     configPath,
                     templateName: tmplName,
-                    currentVersion: "unknown",
-                    availableVersion: pkgVersion,
+                    currentVersion: tmplVersion ?? "unknown",
+                    availableVersion: "content-changed",
                 });
-                process.stderr.write(`Upgrade available: "${tmplName}" has no version tag. Run: dna init --upgrade ${tmplName}\n`);
+                process.stderr.write(`Upgrade available: "${tmplName}" has no content hash. Run: dna init --upgrade ${tmplName}\n`);
             }
-            else if (tmplVersion && tmplName && compareSemver(pkgVersion, tmplVersion) > 0) {
-                // Package is strictly newer than template — suggest upgrade
+            else if (currentHash !== tmplHash) {
                 upgrades.push({
                     configPath,
                     templateName: tmplName,
-                    currentVersion: tmplVersion,
-                    availableVersion: pkgVersion,
+                    currentVersion: tmplVersion ?? "unknown",
+                    availableVersion: "content-changed",
                 });
-                process.stderr.write(`Upgrade available: "${tmplName}" ${tmplVersion} → ${pkgVersion}. Run: dna init --upgrade ${tmplName}\n`);
+                process.stderr.write(`Template content changed: "${tmplName}". Run: dna init --upgrade ${tmplName}\n`);
             }
         }
         catch {
@@ -544,10 +578,14 @@ export async function runSync(opts) {
         else if (opts.plugin && opts.settingsPath) {
             process.stderr.write(`Plugin mode: hooks managed by plugin framework (skipping settings.json)\n`);
         }
+        // Extract active namespaces from loaded DNAs for namespace-scoped cleanup
+        const activeNamespaces = loadedDNAs
+            .map(d => d.namespace)
+            .filter((ns) => typeof ns === "string");
         // Step 5: Generate agent MD files
         if (opts.agentsDir) {
             // Clean stale DNA-managed agents before regenerating
-            const staleAgents = await cleanStaleDNAFiles(opts.agentsDir, "agents");
+            const staleAgents = await cleanStaleDNAFiles(opts.agentsDir, "agents", activeNamespaces);
             if (staleAgents.length > 0) {
                 process.stderr.write(`Cleaned ${staleAgents.length} stale agent file(s)\n`);
             }
@@ -608,7 +646,7 @@ export async function runSync(opts) {
         // Step 7: Generate skill files from workflows
         if (opts.skillsDir) {
             // Clean stale DNA-managed skills before regenerating
-            const staleSkills = await cleanStaleDNAFiles(opts.skillsDir, "skills");
+            const staleSkills = await cleanStaleDNAFiles(opts.skillsDir, "skills", activeNamespaces);
             if (staleSkills.length > 0) {
                 process.stderr.write(`Cleaned ${staleSkills.length} stale skill dir(s)\n`);
             }

package/dist/templates/flutter-rewrite.dna.yaml

@@ -201,6 +201,7 @@ roles:
       read: ["**/*"]
       write: ["lib/**", "v2/**", "test/**"]
     instructions:
+      - "REQUIRED FIRST: Read context files — CLAUDE.md, docs/refactoring-workflow-v2.md, v2/docs/PROVIDER_DESIGN.md, and the diagnosis spec (.omc/specs/diagnosis-$ARGUMENTS.md). Then read v1 corresponding file before any Edit. Hook will block Edit if context files are not read."
       - Fix only the identified breakpoint or missing implementation
       - Read v1 to understand intent, rewrite in v2 framework style
       - Do not copy v1 code verbatim — adapt to v2 architecture
@@ -316,19 +317,17 @@ workflows:
           Scenario 2 (re-run/incremental):
           - Read the incremental diff from behavior doc
           - Update existing tests incrementally — do NOT rewrite all tests (preserves rescue progress)
-          - Run ALL tests for this module (do NOT skip previously green tests)
-          - Compare with last baseline:
-            GREEN→RED = REGRESSION (mark HIGH_PRIORITY)
-            RED→GREEN = FIXED
-            NEW tests = new coverage
-            REMOVED tests = coverage shrunk
-          - Update baseline with full result
+          - Run ALL tests (do NOT skip previously green tests). Compare with previous baseline: GREEN→RED = REGRESSION (mark HIGH_PRIORITY), RED→GREEN = FIXED, NEW = new coverage. Update baseline with complete results.
           - Git commit: "behavior-lock($ARGUMENTS): N tests (X green, Y red from behavior change)"
 
           BANNED patterns:
           - Do NOT use `sleep N && check` polling — run commands in foreground
           - Do NOT use `timeout Nm flutter test` — let tests run to completion
           - Do NOT rewrite existing test files from scratch — update incrementally
+
+          Report results and STOP.
+
+          Next step for user: Run /dna-frw-diagnosis $ARGUMENTS to analyze failing tests.
         handoff:
           consumes:
             - type: file
@@ -573,6 +572,8 @@ workflows:
         blocked_items_path: "docs/behavior/blocked_items.md"
         description: "Fix issues according to diagnosis spec classifications"
         prompt: |
+          Read .dna/state/workflow/experience.md first if it exists. It contains previous failed approaches — do NOT repeat them.
+
           Read context + diagnosis spec first.
 
           Process issues in priority order: INFRA → BUG → TEST_BUG

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "intentdna",
-  "version": "1.5.12",
+  "version": "1.5.14",
   "description": "Intent DNA — Declarative policy layer for AI agent behavior",
   "type": "module",
   "main": "dist/index.js",