intentdna 1.9.0 → 1.9.1

package/dist/cli/commands/sync.js

@@ -10,7 +10,7 @@
  *
  * Targets: claude-md, soul-md, cursorrules, system-prompt
  */
-import { resolve, dirname } from "node:path";
+import { resolve, dirname, relative, sep } from "node:path";
 import { readFile, writeFile as writeFileAsync, stat, mkdir, readdir, unlink, rm } from "node:fs/promises";
 import { createHash } from "node:crypto";
 import { createInterface } from "node:readline";
@@ -959,6 +959,12 @@ export async function runSync(opts) {
             const workflows = cascadedForSkills.workflows;
             const controllers = cascadedForSkills.controllers;
             const roles = cascadedForSkills.roles;
+            const skillDnaSources = opts.files.map((file) => {
+                const projectRelative = relative(projectDir, file);
+                return projectRelative === "" || projectRelative === ".." || projectRelative.startsWith(`..${sep}`)
+                    ? file
+                    : projectRelative.split(sep).join("/");
+            });
             // Step 8: Generate project-root .mcp.json only for Claude Code skills.
             if (skillSurface === "claude_code") {
                 const mcpDeps = {};
@@ -986,21 +992,19 @@ export async function runSync(opts) {
                     const result = compileWorkflow(wfDef, { workflow_key: name });
                     if (result.ok) {
                         const workflowVariables = variableScopes.forNamespace(variableScopes.workflowNamespaces.get(name) ?? "");
-                        skillResults.push(compileWorkflowToSkill(result.plan, roles, ir, workflowVariables, { surface: skillSurface }));
+                        skillResults.push(compileWorkflowToSkill(result.plan, roles, ir, workflowVariables, {
+                            surface: skillSurface,
+                            dnaSources: skillDnaSources,
+                        }));
                     }
                 }
-                if (skillSurface === "claude_code") {
-                    for (const [name, controllerDef] of Object.entries(controllers)) {
-                        const controllerKind = getControllerKindMetadata(controllerDef.kind);
-                        if (controllerKind?.supportsSkillGeneration) {
-                            const controllerVariables = variableScopes.forNamespace(variableScopes.controllerNamespaces.get(name) ?? "");
-                            skillResults.push(compileControllerToSkill(name, controllerDef, controllerVariables, workflows));
-                        }
+                for (const [name, controllerDef] of Object.entries(controllers)) {
+                    const controllerKind = getControllerKindMetadata(controllerDef.kind);
+                    if (controllerKind?.supportsSkillGeneration) {
+                        const controllerVariables = variableScopes.forNamespace(variableScopes.controllerNamespaces.get(name) ?? "");
+                        skillResults.push(compileControllerToSkill(name, controllerDef, controllerVariables, workflows, { surface: skillSurface, dnaSources: skillDnaSources }));
                     }
                 }
-                else if (Object.keys(controllers).length > 0) {
-                    process.stderr.write("codex_cli unsupported: controller_skill_projection\n");
-                }
                 if (skillResults.length > 0) {
                     let written = skillResults.flatMap((result) => {
                         const files = [resolve(opts.skillsDir, result.dirName, "SKILL.md")];

package/dist/cli/index.js

@@ -190,6 +190,7 @@ Examples:
   dna run inspect <run-id>
   dna run resume <run-id>
   dna run cancel <run-id> --reason "operator request"
+  dna run close <run-id> --reason "legacy runtime retired"
   dna compile my.dna.json --context work
   dna show my.dna.json --context work
   dna evolve my_dna_id                  Preview marker changes without persisting
@@ -282,21 +283,25 @@ Boundaries:
     quickstart: `Usage: dna quickstart [asset] [--asset <name>] [--sync-target <target>] [--project-dir <path>] [--json]\n\nShows the shortest local route for getting value without Online or Supabase: choose a workflow asset, initialize local dna, preview sync, sync the harness, run in the harness, package/sign/verify local evidence, then inspect sync status.\n\nOptions:\n  --asset <name>           Workflow asset to start from (default prefers ${WORKFLOW_ASSET_IDS.default})\n  --sync-target <target>   Runtime surface such as codex or claude for suggested commands\n  --project-dir <path>     Read organization state and project-local assets from another project directory\n  --json                   Print a concise intentdna.local_quickstart.v1 packet\n\nBoundaries:\n  - quickstart is read-only guidance; it does not initialize, sync, run workflows, sign reports, upload reports, or deploy anything\n  - local dna/dna-hook remain runtime truth\n  - Online, marketplace, and Supabase do not execute workflows or make allow/warn/block/validate decisions\n  - MCP remains hidden transport\n`,
     context: `Usage: dna context <index|search|doc> [query|id] [files...]\n\nSubcommands:\n  index                    List explicitly declared planning-only advisory context sources\n  search <query>           Search source metadata\n  doc <id>                 Read a local file/doc source body\n`,
     run: `Usage:
-  dna run [start] --dna <file> --workflow <name> --task <id> [options]
+  dna run [start] --dna <file> (--workflow <name> | --controller <name>) --task <id> [options]
   dna run asset-refinery --var source_packet=<path> --var candidate_path=<path> [--dry-run]
   dna run status  <run-id> [--json] [--project-dir <path>]
   dna run inspect <run-id> [--json] [--project-dir <path>]
   dna run resume  <run-id> [--json] [--project-dir <path>]
   dna run cancel  <run-id> [--reason <text>] [--json] [--project-dir <path>]
+  dna run close   <run-id> [--reason <text>] [--json] [--project-dir <path>]
 
 Actions:
   start                    Create a durable run and execute until terminal (default)
   status                   Read the durable run summary
   inspect                  Read attempts, worker sessions, handoffs, events, and results
-  resume                   Resume from durable task/attempt/result state
-  cancel                   Persist durable cancellation intent
+  resume                   Resume a canonical run; legacy ledgers are rejected
+  cancel                   Persist cancellation intent for a legacy run
+  close                    Terminalize a legacy run without migrating it
 
 Options:
+  --workflow <name>        Run one workflow target; mutually exclusive with --controller
+  --controller <name>      Run one controller target; mutually exclusive with --workflow
   --run-id <id>            Explicit run id; lifecycle actions also accept a positional id
   --var <key=value>        Set a workflow variable; repeat for multiple values
   --dry-run                Print the compiled Controller plan without starting a run
@@ -308,7 +313,7 @@ Options:
   --max-budget <usd>       Claude budget per Step attempt (default: 5)
   --permission-mode <mode> Claude permission mode (default: default)
   --agents <dir>           Project agent output directory (default: .claude/agents)
-  --reason <text>          Cancellation reason
+  --reason <text>          Cancellation or closure reason
   --json                   Print lifecycle output as JSON
   --project-dir <path>     Read/write the project-scoped runtime in another directory
 `,
@@ -472,6 +477,7 @@ async function main() {
                 options: {
                     dna: { type: "string", multiple: true },
                     workflow: { type: "string", short: "w" },
+                    controller: { type: "string" },
                     task: { type: "string", short: "t" },
                     context: { type: "string", short: "c" },
                     var: { type: "string", multiple: true },
@@ -500,6 +506,7 @@ async function main() {
                 "inspect",
                 "resume",
                 "cancel",
+                "close",
             ]);
             const actionCandidate = runPositionals[0] ?? "";
             const runAction = runActions.has(actionCandidate)
@@ -535,6 +542,7 @@ async function main() {
             }
             let dnaFiles = runValues.dna ?? runPositionals;
             let workflowName = runValues.workflow;
+            const controllerName = runValues.controller;
             let taskId = runValues.task;
             if (runAction === "start"
                 && !runValues.dna
@@ -555,7 +563,7 @@ async function main() {
                     }
                     dnaFiles = [template.path];
                     taskId ??= template.name;
-                    if (!workflowName) {
+                    if (!workflowName && !controllerName) {
                         const { loadDNA } = await import("../compiler/index.js");
                         const dna = await loadDNA(template.path);
                         const workflowNames = Object.keys(dna.workflows ?? {});
@@ -575,6 +583,7 @@ async function main() {
                 runId: optionRunId ?? positionalRunId,
                 dnaFiles,
                 workflowName,
+                controllerName,
                 taskId,
                 context: runValues.context,
                 vars: Object.keys(vars).length > 0 ? vars : undefined,

package/dist/compiler/compile.d.ts

@@ -10,6 +10,7 @@
 import type { ConstraintIR } from "../schema/types.js";
 import type { ActivatedDNA } from "./activate.js";
 import type { CascadedDNA } from "./cascade.js";
+export declare function resolvePostCheckCommand(check: string): string;
 /**
  * Compile activated DNA into a Constraint IR.
  */

package/dist/compiler/compile.js

@@ -206,7 +206,7 @@ function compileAdvisoryContext(cascaded) {
         injections,
     };
 }
-function resolvePostCheckCommand(check) {
+export function resolvePostCheckCommand(check) {
     const normalized = check.trim();
     const builtins = {
         vitest_run: "npm test",

package/dist/compiler/controller.d.ts

@@ -0,0 +1,16 @@
+import type { ControllerDef } from "../schema/types.js";
+import { type ExecutableRunPlanPayload, type Sha256Digest } from "../runtime/executable-run-plan.js";
+export type ControllerPlanCompilerErrorCode = "invalid_controller_program" | "invalid_component_plan" | "invalid_controller_route";
+export declare class ControllerPlanCompilerError extends Error {
+    readonly code: ControllerPlanCompilerErrorCode;
+    constructor(code: ControllerPlanCompilerErrorCode, message: string);
+}
+export interface CompileControllerPlanOptions {
+    readonly controller_key: string;
+    readonly controller: ControllerDef;
+    readonly diagnosis_plan: ExecutableRunPlanPayload;
+    readonly fix_plan: ExecutableRunPlanPayload;
+    readonly source_provenance: ExecutableRunPlanPayload["source_provenance"];
+}
+export declare function compileControllerPlan(options: CompileControllerPlanOptions): ExecutableRunPlanPayload;
+export type ControllerPlanDigest = Sha256Digest;