synorch 0.2.0 → 0.4.0-beta.0

package/dist/cli.js

@@ -6,7 +6,8 @@ import { ProjectDiscoveryService } from "./application/project-discovery.js";
 import { StructureService } from "./application/structure-service.js";
 import { scopeSchema } from "./domain/config.js";
 import { CliError } from "./domain/errors.js";
-import { SYNORCH_VERSION } from "./domain/product.js";
+import { versionLine } from "./infrastructure/build-info.js";
+import { closestMatch } from "./domain/suggest.js";
 import { NodeFileSystem } from "./infrastructure/file-system.js";
 const HELP = `syn — Synorch orchestration structure generator for Codex and Claude Code
 
@@ -22,26 +23,127 @@ Commands:
   sync     Discover projects after a manual trigger and refresh the registry.
   doctor   Validate structure, profiles and constitutional safety settings.
 
+Runtime commands (syn <command> --help for details):
+  agent             Interactive orchestrated session (--resume <session>, --fork <session>).
+  run "<goal>"      Run one goal to completion; --mode jsonl writes machine frames.
+  runs              List the runs of this project.
+  show <id>         Plan, workers, approvals, evidence and usage of a run or session.
+  doctor --runtime  Sandbox, store, auth and capability health; no network request.
+  login, logout     Connect or remove a provider identity.
+  auth status       Provider identities, without secrets.
+  memory <command>  Project memory: status, search, show, review, accept, reject.
+  trust [--revoke]  Trust this workspace's tests and build scripts to run unconfined.
+  config <command>  User settings: list, get, set, unset, edit, path.
+
 Safety:
   Existing differing files are never overwritten unless --force is explicit.
   Model fallback is never silent.
 `;
+const HARNESS_COMMAND_NAMES = ["agent", "setup", "run", "runs", "show", "login", "logout", "auth", "memory", "trust", "config", "mcp", "skills", "plugin"];
+const LEGACY_OPTIONS = {
+    target: { type: "string", short: "t" },
+    scope: { type: "string", short: "s" },
+    force: { type: "boolean", short: "f", default: false },
+    json: { type: "boolean", default: false },
+    help: { type: "boolean", short: "h", default: false },
+    version: { type: "boolean", short: "v", default: false },
+};
+const LEGACY_COMMAND_FLAGS = {
+    inspect: ["--target", "-t", "--scope", "-s", "--force", "-f", "--json", "--help", "-h"],
+    init: ["--target", "-t", "--scope", "-s", "--force", "-f", "--json", "--help", "-h"],
+    sync: ["--target", "-t", "--force", "-f", "--json", "--help", "-h"],
+    doctor: ["--target", "-t", "--json", "--help", "-h"],
+};
+const LEGACY_COMMAND_NAMES = Object.keys(LEGACY_COMMAND_FLAGS);
+class UsageFailure extends CliError {
+    constructor(lines) {
+        super(lines.join("\n"), 2);
+        this.name = "UsageFailure";
+    }
+}
+function usageLine(command) {
+    return HELP.split("\n").find((line) => line.trim().startsWith(`syn ${command} `))?.trim();
+}
+function flagName(token) {
+    const separator = token.indexOf("=");
+    return separator === -1 ? token : token.slice(0, separator);
+}
+async function flagsAccepted(command, args) {
+    const flags = args.filter((token) => token.startsWith("-") && token !== "--").map(flagName);
+    if (flags.length === 0)
+        return true;
+    const accepted = new Set(LEGACY_COMMAND_FLAGS[command] ?? []);
+    if (HARNESS_COMMAND_NAMES.includes(command) || command === "doctor") {
+        const harness = await import("./harness/cli/index.js");
+        for (const flag of harness.harnessCommandFlags(command))
+            accepted.add(flag);
+    }
+    return flags.every((flag) => accepted.has(flag));
+}
+async function unknownCommand(command, args) {
+    const lines = [`Unknown command: ${command}`];
+    const match = closestMatch(command, [...LEGACY_COMMAND_NAMES, ...HARNESS_COMMAND_NAMES]);
+    if (match !== undefined) {
+        const suggestion = (await flagsAccepted(match, args)) ? ["syn", match, ...args] : ["syn", match];
+        lines.push(`Did you mean: ${suggestion.join(" ")}?`);
+    }
+    lines.push("Run syn --help for all commands.");
+    return new UsageFailure(lines);
+}
+function unknownOption(error, command) {
+    if (error?.code !== "ERR_PARSE_ARGS_UNKNOWN_OPTION")
+        return undefined;
+    const flag = /Unknown option '([^']+)'/.exec(error instanceof Error ? error.message : "")?.[1] ?? "";
+    if (command === undefined || LEGACY_COMMAND_FLAGS[command] === undefined) {
+        return new UsageFailure([`Unknown option ${flag}`, "Run syn --help for all commands."]);
+    }
+    const lines = [`Unknown option ${flag} for syn ${command}`];
+    const match = flag.startsWith("--") ? closestMatch(flag, (LEGACY_COMMAND_FLAGS[command] ?? []).filter((candidate) => candidate.startsWith("--"))) : undefined;
+    if (match !== undefined)
+        lines.push(`Did you mean ${match}?`);
+    const usage = usageLine(command);
+    if (usage !== undefined)
+        lines.push(`Usage: ${usage}`);
+    return new UsageFailure(lines);
+}
+function isHarnessInvocation(argv) {
+    const [command] = argv;
+    if (HARNESS_COMMAND_NAMES.includes(command ?? "")) {
+        return true;
+    }
+    if (command !== "doctor") {
+        return false;
+    }
+    const terminator = argv.indexOf("--");
+    return (terminator === -1 ? argv : argv.slice(0, terminator)).includes("--runtime");
+}
 async function main() {
-    const { values, positionals } = parseArgs({
-        args: process.argv.slice(2),
-        allowPositionals: true,
-        strict: true,
-        options: {
-            target: { type: "string", short: "t" },
-            scope: { type: "string", short: "s" },
-            force: { type: "boolean", short: "f", default: false },
-            json: { type: "boolean", default: false },
-            help: { type: "boolean", short: "h", default: false },
-            version: { type: "boolean", short: "v", default: false },
-        },
-    });
+    const argv = process.argv.slice(2);
+    if (isHarnessInvocation(argv)) {
+        const harness = await import("./harness/cli/index.js");
+        process.exitCode = await harness.runHarnessCommand(argv);
+        return;
+    }
+    // Bare `syn` in an interactive terminal opens the conversation (like `claude`); pipes and CI keep the help text.
+    if (argv.length === 0 && process.stdin.isTTY === true && process.stdout.isTTY === true) {
+        const harness = await import("./harness/cli/index.js");
+        process.exitCode = await harness.runHarnessCommand(["agent"]);
+        return;
+    }
+    const [first] = argv;
+    if (first !== undefined && !first.startsWith("-") && !LEGACY_COMMAND_NAMES.includes(first)) {
+        throw await unknownCommand(first, argv.slice(1));
+    }
+    let parsed;
+    try {
+        parsed = parseArgs({ args: argv, allowPositionals: true, strict: true, options: LEGACY_OPTIONS });
+    }
+    catch (error) {
+        throw unknownOption(error, argv.find((token) => !token.startsWith("-"))) ?? new CliError(error instanceof Error ? error.message : String(error), 2);
+    }
+    const { values, positionals } = parsed;
     if (values.version) {
-        console.log(SYNORCH_VERSION);
+        console.log(versionLine());
         return;
     }
     if (values.help || positionals.length === 0) {
@@ -70,7 +172,11 @@ async function main() {
             }
             else {
                 console.log(`Initialized ${plan.scope} structure at ${plan.targetDirectory}`);
-                console.log(`Created: ${result.created.length}, updated: ${result.updated.length}, unchanged: ${result.unchanged.length}`);
+                console.log(`Created: ${result.created.length}, updated: ${result.updated.length}, ` +
+                    `unchanged: ${result.unchanged.length}, preserved: ${result.preserved.length}`);
+                if (result.preserved.length > 0) {
+                    console.log(`Preserved (never overwritten): ${result.preserved.join(", ")}`);
+                }
                 console.log("Next: run `syn sync`, then `syn doctor`.");
             }
             return;
@@ -88,6 +194,9 @@ async function main() {
                 for (const project of result.projects) {
                     console.log(`  ${project.id}: ${project.path}`);
                 }
+                if (result.prunedObservations > 0) {
+                    console.log(`Pruned ${result.prunedObservations} expired observation(s).`);
+                }
             }
             return;
         }
@@ -102,7 +211,7 @@ async function main() {
             return;
         }
         default:
-            throw new CliError(`Unknown command: ${String(command)}\n\n${HELP}`, 2);
+            throw await unknownCommand(String(command), []);
     }
 }
 function parseScope(value) {
@@ -143,6 +252,8 @@ function statusSymbol(status) {
             return "~";
         case "unchanged":
             return "=";
+        case "preserved":
+            return "=";
         case "conflict":
             return "!";
     }
@@ -158,12 +269,18 @@ function printDiagnostics(diagnostics, asJson) {
     }
 }
 main().catch((error) => {
+    if (error instanceof UsageFailure) {
+        console.error(error.message);
+        process.exitCode = error.exitCode;
+        return;
+    }
     if (error instanceof CliError) {
         console.error(`Error: ${error.message}`);
         process.exitCode = error.exitCode;
         return;
     }
-    const message = error instanceof Error ? error.stack ?? error.message : String(error);
+    const debug = process.env.SYN_DEBUG === "1";
+    const message = error instanceof Error ? (debug ? error.stack ?? error.message : error.message) : String(error);
     console.error(`Unexpected error: ${message}`);
     process.exitCode = 1;
 });

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,aAAa,EAAmB,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,WAAW,EAAuB,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;CAiBZ,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;QACxC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3B,gBAAgB,EAAE,IAAI;QACtB,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE;YACP,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;YACtC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;YACrC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;YACtD,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;YACzC,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;YACrD,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;SACzD;KACF,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC7B,OAAO;IACT,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,QAAQ,CAAC,oCAAoC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,IAAI,cAAc,EAAE,CAAC;IAExC,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,IAAI,GAAG,MAAM,IAAI,gBAAgB,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5F,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC,UAAU,CAAC,CAAC;YACjD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAChB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACvG,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,CAAC,KAAK,iBAAiB,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;gBAC9E,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,OAAO,CAAC,MAAM,cAAc,MAAM,CAAC,OAAO,CAAC,MAAM,gBAAgB,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC3H,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;YAC1D,CAAC;YACD,OAAO;QACT,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,iBAAiB,CAAC,KAAK,KAAK,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YAC3D,MAAM,MAAM,GAAG,MAAM,IAAI,uBAAuB,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE;gBACxE,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAChB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,QAAQ,CAAC,MAAM,cAAc,CAAC,CAAC;gBAChE,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACtC,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;gBAClD,CAAC;YACH,CAAC;YACD,OAAO;QACT,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,iBAAiB,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YACpD,iBAAiB,CAAC,KAAK,KAAK,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YAC3D,MAAM,WAAW,GAAG,MAAM,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACzE,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,KAAK,OAAO,CAAC,EAAE,CAAC;gBACtE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACvB,CAAC;YACD,OAAO;QACT,CAAC;QACD;YACE,MAAM,IAAI,QAAQ,CAAC,oBAAoB,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAyB;IAC3C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,QAAQ,CAAC,kBAAkB,KAAK,qCAAqC,EAAE,CAAC,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAkB,EAAE,MAAc,EAAE,OAAe;IAC5E,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,IAAI,QAAQ,CAAC,GAAG,MAAM,4BAA4B,OAAO,WAAW,EAAE,CAAC,CAAC,CAAC;IACjF,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAoB,EAAE,MAAe;IACtD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,MAAM,CAAC;IACjF,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,6EAA6E,CAAC,CAAC;IAC3G,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,MAAiD;IACrE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,GAAG,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,GAAG,CAAC;QACb,KAAK,WAAW;YACd,OAAO,GAAG,CAAC;QACb,KAAK,UAAU;YACb,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,WAAkC,EAAE,MAAe;IAC3E,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAClD,OAAO;IACT,CAAC;IACD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,IAAI,GAAG,CAAC;QAC9E,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,OAAO,GAAG,QAAQ,EAAE,CAAC,CAAC;IAC3G,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAClC,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtF,OAAO,CAAC,KAAK,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/domain/canonical-contracts.d.ts

@@ -0,0 +1,69 @@
+import { z } from "zod";
+/** The only value a canonical or generated skill may declare for `priority`. */
+export declare const SKILL_PRIORITIES: readonly ["skill"];
+/** Capability tiers a worker dispatch may request for a role. */
+export declare const AGENT_MODEL_TIERS: readonly ["orchestrator", "complex_worker", "fast_worker", "any"];
+/** The report shapes a role is allowed to return. */
+export declare const AGENT_REPORT_CONTRACTS: readonly ["completion-packet", "evidence-report", "review-report", "final-report"];
+/**
+ * The literal token an agent uses to allow the technology skills carried by the
+ * task packet, whose ids are only known after project discovery.
+ */
+export declare const TECHNOLOGY_SKILL_TOKEN = "technology:*";
+export declare const skillContractSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    version: z.ZodString;
+    not_for: z.ZodOptional<z.ZodString>;
+    inputs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    outputs: z.ZodOptional<z.ZodString>;
+    references: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    priority: z.ZodDefault<z.ZodEnum<{
+        skill: "skill";
+    }>>;
+}, z.core.$strip>;
+export declare const agentManifestSchema: z.ZodObject<{
+    name: z.ZodString;
+    role: z.ZodString;
+    writes_product_files: z.ZodBoolean;
+    model_tier: z.ZodEnum<{
+        orchestrator: "orchestrator";
+        complex_worker: "complex_worker";
+        fast_worker: "fast_worker";
+        any: "any";
+    }>;
+    allowed_skills: z.ZodArray<z.ZodString>;
+    reports: z.ZodEnum<{
+        "completion-packet": "completion-packet";
+        "evidence-report": "evidence-report";
+        "review-report": "review-report";
+        "final-report": "final-report";
+    }>;
+    forbidden_skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    control_plane_write_scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SkillContract = z.infer<typeof skillContractSchema>;
+export type AgentManifest = z.infer<typeof agentManifestSchema>;
+export type AgentModelTier = (typeof AGENT_MODEL_TIERS)[number];
+export type AgentReportContract = (typeof AGENT_REPORT_CONTRACTS)[number];
+/** H2 headings every canonical skill body must carry, in no required order. */
+export declare const REQUIRED_SKILL_SECTIONS: readonly ["When this applies", "When it does not", "Required inputs", "Procedure", "Tools", "Verification", "Stop and escalate", "Output contract"];
+/** H2 headings every canonical agent manifest body must carry. */
+export declare const REQUIRED_AGENT_SECTIONS: readonly ["Purpose", "Authority", "Required inputs", "Procedure", "Escalation", "Report contract", "Completion conditions"];
+/** The section whose body must be a numbered list in both kinds. */
+export declare const NUMBERED_PROCEDURE_SECTION = "Procedure";
+/**
+ * Byte ceilings per layer. They encode the load-frequency asymmetry: content
+ * loaded every session is held flat, content loaded on match may be deep.
+ */
+export declare const CANONICAL_SIZE_CEILINGS: {
+    readonly entrypoint: 2500;
+    readonly constitution: 1500;
+    readonly protocol: 2000;
+    readonly agentManifest: 3000;
+    readonly baseSkill: 6000;
+    readonly skillReference: 15000;
+};
+export type CanonicalSizeLayer = keyof typeof CANONICAL_SIZE_CEILINGS;
+//# sourceMappingURL=canonical-contracts.d.ts.map

package/dist/domain/canonical-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-contracts.d.ts","sourceRoot":"","sources":["../../src/domain/canonical-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB,gFAAgF;AAChF,eAAO,MAAM,gBAAgB,oBAAqB,CAAC;AAEnD,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,mEAKpB,CAAC;AAEX,qDAAqD;AACrD,eAAO,MAAM,sBAAsB,oFAKzB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AAIrD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;iBAU9B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;iBAS9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAChE,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB,qJAS1B,CAAC;AAEX,kEAAkE;AAClE,eAAO,MAAM,uBAAuB,6HAQ1B,CAAC;AAEX,oEAAoE;AACpE,eAAO,MAAM,0BAA0B,cAAc,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;CAO1B,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,uBAAuB,CAAC"}

package/dist/domain/canonical-contracts.js

@@ -0,0 +1,92 @@
+import { z } from "zod";
+/**
+ * Canonical Agent Manifest v1 and Canonical Skill Contract v1.
+ *
+ * These schemas describe the machine-checkable frontmatter of the generated
+ * `.ai/agents/<id>/AGENT.md` and `.ai/skills/<id>/SKILL.md` files. They are the
+ * single source of truth for `doctor` and for any module that produces or
+ * extends canonical content: both object schemas are intentionally left open to
+ * `.extend()` so downstream contracts (for example generated, non-canonical
+ * skills) can add fields without redefining the base shape.
+ */
+const KEBAB_CASE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const SEMVER = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
+/** The only value a canonical or generated skill may declare for `priority`. */
+export const SKILL_PRIORITIES = ["skill"];
+/** Capability tiers a worker dispatch may request for a role. */
+export const AGENT_MODEL_TIERS = [
+    "orchestrator",
+    "complex_worker",
+    "fast_worker",
+    "any",
+];
+/** The report shapes a role is allowed to return. */
+export const AGENT_REPORT_CONTRACTS = [
+    "completion-packet",
+    "evidence-report",
+    "review-report",
+    "final-report",
+];
+/**
+ * The literal token an agent uses to allow the technology skills carried by the
+ * task packet, whose ids are only known after project discovery.
+ */
+export const TECHNOLOGY_SKILL_TOKEN = "technology:*";
+const nonEmptyString = z.string().trim().min(1);
+export const skillContractSchema = z.object({
+    name: z.string().regex(KEBAB_CASE, "Skill name must be kebab-case."),
+    description: nonEmptyString,
+    version: z.string().regex(SEMVER, "Skill version must be a semantic version."),
+    not_for: nonEmptyString.optional(),
+    inputs: z.array(nonEmptyString).optional(),
+    tools: z.array(nonEmptyString).optional(),
+    outputs: nonEmptyString.optional(),
+    references: z.array(nonEmptyString).optional(),
+    priority: z.enum(SKILL_PRIORITIES).default("skill"),
+});
+export const agentManifestSchema = z.object({
+    name: z.string().regex(KEBAB_CASE, "Agent name must be kebab-case."),
+    role: nonEmptyString,
+    writes_product_files: z.boolean(),
+    model_tier: z.enum(AGENT_MODEL_TIERS),
+    allowed_skills: z.array(nonEmptyString).min(1),
+    reports: z.enum(AGENT_REPORT_CONTRACTS),
+    forbidden_skills: z.array(nonEmptyString).optional(),
+    control_plane_write_scope: nonEmptyString.optional(),
+});
+/** H2 headings every canonical skill body must carry, in no required order. */
+export const REQUIRED_SKILL_SECTIONS = [
+    "When this applies",
+    "When it does not",
+    "Required inputs",
+    "Procedure",
+    "Tools",
+    "Verification",
+    "Stop and escalate",
+    "Output contract",
+];
+/** H2 headings every canonical agent manifest body must carry. */
+export const REQUIRED_AGENT_SECTIONS = [
+    "Purpose",
+    "Authority",
+    "Required inputs",
+    "Procedure",
+    "Escalation",
+    "Report contract",
+    "Completion conditions",
+];
+/** The section whose body must be a numbered list in both kinds. */
+export const NUMBERED_PROCEDURE_SECTION = "Procedure";
+/**
+ * Byte ceilings per layer. They encode the load-frequency asymmetry: content
+ * loaded every session is held flat, content loaded on match may be deep.
+ */
+export const CANONICAL_SIZE_CEILINGS = {
+    entrypoint: 2_500,
+    constitution: 1_500,
+    protocol: 2_000,
+    agentManifest: 3_000,
+    baseSkill: 6_000,
+    skillReference: 15_000,
+};
+//# sourceMappingURL=canonical-contracts.js.map

package/dist/domain/canonical-contracts.js.map

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

package/dist/domain/generated-skill.d.ts

@@ -0,0 +1,55 @@
+import { z } from "zod";
+/** Generated project skills live in their own namespace and are never touched by `sync`. */
+export declare const GENERATED_SKILL_DIRECTORY = ".ai/skills/project";
+/** Blocking size ceiling for a generated `SKILL.md`, in bytes. */
+export declare const GENERATED_SKILL_MAX_BYTES = 15360;
+/** Blocking budget: the number of project skills that may be `active` at the same time. */
+export declare const GENERATED_SKILL_ACTIVE_BUDGET = 12;
+export declare const generatedSkillEvidenceSchema: z.ZodObject<{
+    claim: z.ZodString;
+    source: z.ZodString;
+    digest: z.ZodString;
+}, z.core.$strip>;
+export type GeneratedSkillEvidence = z.infer<typeof generatedSkillEvidenceSchema>;
+/**
+ * Canonical Skill Contract v1 (`skillContractSchema`) plus the provenance fields of
+ * design §5. Only two inherited fields are overridden, both to tighten them: a generated
+ * skill must state `priority: skill` explicitly rather than inherit the shared default,
+ * because the ceiling is a security property a reviewer has to be able to read in the file
+ * itself; and its `references` must be provably relative, since nothing else validates the
+ * reference paths of a skill outside the canonical set.
+ */
+export declare const generatedSkillFrontmatterSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    version: z.ZodString;
+    not_for: z.ZodOptional<z.ZodString>;
+    inputs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    outputs: z.ZodOptional<z.ZodString>;
+    references: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    priority: z.ZodLiteral<"skill">;
+    origin: z.ZodLiteral<"generated">;
+    status: z.ZodEnum<{
+        proposed: "proposed";
+        active: "active";
+        stale: "stale";
+        retired: "retired";
+    }>;
+    generated_at: z.ZodString;
+    verified_at: z.ZodString;
+    confirmations: z.ZodInt;
+    promotion: z.ZodEnum<{
+        "user-correction": "user-correction";
+        threshold: "threshold";
+    }>;
+    confirmed_by: z.ZodArray<z.ZodString>;
+    evidence: z.ZodArray<z.ZodObject<{
+        claim: z.ZodString;
+        source: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strip>>;
+    supersedes: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type GeneratedSkillFrontmatter = z.infer<typeof generatedSkillFrontmatterSchema>;
+//# sourceMappingURL=generated-skill.d.ts.map

package/dist/domain/generated-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-skill.d.ts","sourceRoot":"","sources":["../../src/domain/generated-skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,4FAA4F;AAC5F,eAAO,MAAM,yBAAyB,uBAAuB,CAAC;AAE9D,kEAAkE;AAClE,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,2FAA2F;AAC3F,eAAO,MAAM,6BAA6B,KAAK,CAAC;AA6BhD,eAAO,MAAM,4BAA4B;;;;iBAIvC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6CxC,CAAC;AACL,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC"}

package/dist/domain/generated-skill.js

@@ -0,0 +1,90 @@
+import { z } from "zod";
+import { skillContractSchema } from "./canonical-contracts.js";
+import { OBSERVATION_PROMOTION_THRESHOLD, digestSchema, } from "./observation-ledger.js";
+import { isSafeDescendantPath } from "./relative-path.js";
+/** Generated project skills live in their own namespace and are never touched by `sync`. */
+export const GENERATED_SKILL_DIRECTORY = ".ai/skills/project";
+/** Blocking size ceiling for a generated `SKILL.md`, in bytes. */
+export const GENERATED_SKILL_MAX_BYTES = 15_360;
+/** Blocking budget: the number of project skills that may be `active` at the same time. */
+export const GENERATED_SKILL_ACTIVE_BUDGET = 12;
+const isoDateSchema = z
+    .string()
+    .regex(/^\d{4}-\d{2}-\d{2}$/, "must be an ISO calendar date (YYYY-MM-DD)")
+    .refine(isRealIsoDate, "must be a real calendar date");
+function isRealIsoDate(value) {
+    const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
+    if (match === null)
+        return false;
+    const [year, month, day] = [Number(match[1]), Number(match[2]), Number(match[3])];
+    const date = new Date(Date.UTC(year, month - 1, day));
+    return (date.getUTCFullYear() === year &&
+        date.getUTCMonth() === month - 1 &&
+        date.getUTCDate() === day);
+}
+/**
+ * A reference must stay inside the skill's own directory. The lexical rule is shared with the
+ * doctors (`isSafeRelativePath`), so a UNC root, a drive letter, a leading separator in either
+ * separator style and any `..` segment are rejected here rather than only at the file system.
+ */
+const referencePathSchema = z
+    .string()
+    .min(1)
+    .refine(isSafeDescendantPath, "must be a relative path inside the skill directory");
+export const generatedSkillEvidenceSchema = z.object({
+    claim: z.string().min(1),
+    source: z.string().min(1),
+    digest: digestSchema,
+});
+/**
+ * Canonical Skill Contract v1 (`skillContractSchema`) plus the provenance fields of
+ * design §5. Only two inherited fields are overridden, both to tighten them: a generated
+ * skill must state `priority: skill` explicitly rather than inherit the shared default,
+ * because the ceiling is a security property a reviewer has to be able to read in the file
+ * itself; and its `references` must be provably relative, since nothing else validates the
+ * reference paths of a skill outside the canonical set.
+ */
+export const generatedSkillFrontmatterSchema = skillContractSchema
+    .extend({
+    references: z.array(referencePathSchema).optional(),
+    priority: z.literal("skill"),
+    origin: z.literal("generated"),
+    status: z.enum(["proposed", "active", "stale", "retired"]),
+    generated_at: isoDateSchema,
+    verified_at: isoDateSchema,
+    confirmations: z.int().min(1),
+    /**
+     * `threshold` is the ordinary three-confirmation path; `user-correction` is the fast path
+     * from D6 and is the only way a skill may carry fewer than three confirmations.
+     */
+    promotion: z.enum(["threshold", "user-correction"]),
+    confirmed_by: z.array(z.string().min(1)).min(1),
+    evidence: z.array(generatedSkillEvidenceSchema).min(1),
+    supersedes: z.array(z.string().min(1)),
+})
+    .superRefine((frontmatter, context) => {
+    if (frontmatter.promotion === "threshold" &&
+        frontmatter.confirmations < OBSERVATION_PROMOTION_THRESHOLD) {
+        context.addIssue({
+            code: "custom",
+            message: `confirmations must be at least ${OBSERVATION_PROMOTION_THRESHOLD} unless ` +
+                "promotion is user-correction",
+            path: ["confirmations"],
+        });
+    }
+    if (frontmatter.confirmations !== frontmatter.confirmed_by.length) {
+        context.addIssue({
+            code: "custom",
+            message: "confirmations must equal the number of confirming task ids",
+            path: ["confirmations"],
+        });
+    }
+    if (new Set(frontmatter.confirmed_by).size !== frontmatter.confirmed_by.length) {
+        context.addIssue({
+            code: "custom",
+            message: "confirmed_by must contain distinct task ids",
+            path: ["confirmed_by"],
+        });
+    }
+});
+//# sourceMappingURL=generated-skill.js.map

package/dist/domain/generated-skill.js.map

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

package/dist/domain/generation.d.ts

@@ -1,10 +1,22 @@
-export type PlannedFileKind = "entrypoint" | "canonical" | "protocol" | "agent" | "skill" | "schema" | "provider";
+export type PlannedFileKind = "entrypoint" | "canonical" | "protocol" | "agent" | "skill" | "reference" | "schema" | "provider";
+/**
+ * How `init` may write a file that already exists.
+ *
+ * `overwrite` is the canonical default: the file is generated content, so `--force` refreshes it.
+ * `create-only` marks a seed for state the user and the agents own afterwards — the observation
+ * ledger is the only one today. It is written when absent and never again, with or without
+ * `--force`, because design D12/§9 forbid destroying user-approved state silently.
+ */
+export type FileWritePolicy = "overwrite" | "create-only";
 export interface FileDefinition {
     readonly relativePath: string;
     readonly content: string;
     readonly kind: PlannedFileKind;
+    readonly writePolicy?: FileWritePolicy;
 }
-export type PlannedFileStatus = "create" | "unchanged" | "conflict" | "update";
+export type PlannedFileStatus = "create" | "unchanged" | "conflict" | "update"
+/** The file exists and is create-only, so `init` leaves it exactly as it found it. */
+ | "preserved";
 export interface PlannedFile extends FileDefinition {
     readonly status: PlannedFileStatus;
 }
@@ -17,5 +29,6 @@ export interface InitResult {
     readonly created: readonly string[];
     readonly updated: readonly string[];
     readonly unchanged: readonly string[];
+    readonly preserved: readonly string[];
 }
 //# sourceMappingURL=generation.d.ts.map

package/dist/domain/generation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generation.d.ts","sourceRoot":"","sources":["../../src/domain/generation.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,WAAW,GACX,UAAU,GACV,OAAO,GACP,OAAO,GACP,QAAQ,GACR,UAAU,CAAC;AAEf,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE/E,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC"}
+{"version":3,"file":"generation.d.ts","sourceRoot":"","sources":["../../src/domain/generation.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,WAAW,GACX,UAAU,GACV,OAAO,GACP,OAAO,GACP,WAAW,GACX,QAAQ,GACR,UAAU,CAAC;AAEf;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,aAAa,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;CACxC;AAED,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,WAAW,GACX,UAAU,GACV,QAAQ;AACV,sFAAsF;GACpF,WAAW,CAAC;AAEhB,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC"}