@momentiq/dark-factory-cli 2.17.0 → 3.0.0

package/dist/commands/mode.js

@@ -0,0 +1,235 @@
+// Cycle 27 Phase A — `df mode` CLI wrapper.
+//
+// Subcommands:
+//   df mode init [name]     Seed a `modes.<name>` catalog entry into
+//                           darkfactory.yaml (default name: designer).
+//                           Appends — never rewrites the consumer's file.
+//   df mode status [--json] Report the active operator mode, resolved from
+//                           `--mode <name>` / `DF_MODE`. No mode active is
+//                           the normal engineer path (exit 0).
+//
+// The logic lives in src/mode/ (init.ts / status.ts / resolve.ts); this is
+// the thin argv shim, mirroring commands/skills.ts.
+import { readFileSync } from "node:fs";
+import { initMode } from "../mode/init.js";
+import { applyModeScopeCriticRegistration } from "../mode/critic-registration.js";
+import { modeStatus } from "../mode/status.js";
+import { applyMode } from "../mode/apply.js";
+import { decideGuard } from "../mode/guard.js";
+import { buildModeContext, safeDesignMdPath } from "../mode/context.js";
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString("utf8");
+}
+function parseModeFlags(rest) {
+    const flags = {};
+    const positional = [];
+    for (let i = 0; i < rest.length; i++) {
+        const a = rest[i] ?? "";
+        if (a.startsWith("--")) {
+            const eq = a.indexOf("=");
+            if (eq >= 0) {
+                flags[a.slice(2, eq)] = a.slice(eq + 1);
+            }
+            else {
+                const next = rest[i + 1];
+                if (next !== undefined && !next.startsWith("--")) {
+                    flags[a.slice(2)] = next;
+                    i++;
+                }
+                else {
+                    flags[a.slice(2)] = true;
+                }
+            }
+        }
+        else {
+            positional.push(a);
+        }
+    }
+    return { flags, positional };
+}
+const USAGE = [
+    "usage:",
+    "  df mode init [name]       Seed a modes.<name> catalog entry into darkfactory.yaml",
+    "                            (default: designer). Appends; never rewrites your file.",
+    "  df mode status [--json]   Report the active operator mode (--mode <name> / DF_MODE).",
+    "  df mode apply [name]      Write the per-user Claude Code overlay into",
+    "                            .claude/settings.local.json (env, hooks, deny belt, MCP).",
+    "  df mode guard --hook      PreToolUse hook binding: reads the hook JSON on stdin,",
+    "                            emits an allow/deny decision per the mode catalog.",
+    "  df mode context --hook    SessionStart hook binding: emits the mode persona +",
+    "                            catalog summary + DESIGN.md as additional context.",
+    "",
+    "The mode axis is an OPERATOR axis (who is driving the session). It is",
+    "independent of the critic-fleet --profile / AGENT_REVIEW_PROFILE axis.",
+].join("\n");
+export async function cmdMode(rest) {
+    const { flags, positional } = parseModeFlags(rest);
+    const wantsHelp = flags["help"] === true || rest.includes("-h");
+    const sub = positional.filter((p) => p !== "-h")[0];
+    if (sub === undefined || wantsHelp) {
+        process.stdout.write(`${USAGE}\n`);
+        return sub === undefined && !wantsHelp ? 1 : 0;
+    }
+    if (sub === "init") {
+        const modeName = positional[1] ?? "designer";
+        try {
+            const result = initMode(process.cwd(), modeName);
+            const lines = [];
+            if (result.status === "exists") {
+                lines.push(`df mode: "${modeName}" already in the catalog at ${result.configPath} — catalog unchanged.`);
+            }
+            else {
+                lines.push(`df mode: seeded modes.${modeName} into ${result.configPath}.`, `df mode: proposed writeScopes (review in the init PR — protectedPaths wins on overlap):`, ...result.writeScopes.map((s) => `  - ${s}`));
+            }
+            // Register the deterministic ModeScope scope critic so out-of-scope
+            // diffs are blocked in local `df review`/`df gate-push` AND CI
+            // `agent-critic` (inside the existing required check — no consumer
+            // ruleset/workflow changes). Runs on every init (idempotent) so a
+            // repo whose catalog predates the critic still gets it wired.
+            const reg = applyModeScopeCriticRegistration(process.cwd());
+            // A registration `error` (malformed / failed-validation `.agent-review/
+            // config.json`) is a HARD failure: the catalog was seeded but the
+            // deterministic scope critic is NOT wired, so `Mode:` PRs would merge
+            // WITHOUT the scope gate — the exact unsafe state this critic exists to
+            // prevent. Exiting 0 there reads as "the mode is guarded" and hides it,
+            // so we fail non-zero and suppress the "next" hint. `absent` is NOT an
+            // error: it is the specified pre-`df onboard` skip (no config yet), so it
+            // stays exit 0 and keeps the next-step (the catalog seed is real work).
+            let registrationFailed = false;
+            switch (reg.status) {
+                case "registered":
+                    lines.push(`df mode: registered the ModeScope scope critic in ${reg.configPath}:`);
+                    lines.push(...reg.changes.map((c) => `  - ${c}`));
+                    break;
+                case "already-registered":
+                    lines.push(`df mode: ModeScope scope critic already registered in ${reg.configPath} — unchanged.`);
+                    break;
+                case "absent":
+                    lines.push(`df mode: NOTE ${reg.configPath} not found — run \`df onboard\` first, then re-run ` +
+                        `\`df mode init ${modeName}\` to wire the scope critic (idempotent).`);
+                    break;
+                case "error":
+                    registrationFailed = true;
+                    lines.push(`df mode: ERROR could not register the ModeScope scope critic in ${reg.configPath}: ${reg.error}. ` +
+                        `The catalog was seeded but the scope gate is NOT wired — \`Mode:\` PRs would skip it. ` +
+                        `Fix ${reg.configPath} and re-run \`df mode init ${modeName}\` (idempotent).`);
+                    break;
+            }
+            if (registrationFailed) {
+                // Fail loud on stderr with a non-zero exit — do NOT print the "next"
+                // hint, which would imply the mode is ready to commit and guarded.
+                process.stderr.write(`${lines.join("\n")}\n`);
+                return 1;
+            }
+            lines.push(`df mode: next: commit darkfactory.yaml + .agent-review/config.json, then run \`df doctor\`.`);
+            process.stdout.write(`${lines.join("\n")}\n`);
+            return 0;
+        }
+        catch (e) {
+            process.stderr.write(`df mode init failed: ${e instanceof Error ? e.message : String(e)}\n`);
+            return 1;
+        }
+    }
+    if (sub === "status") {
+        try {
+            const status = modeStatus(process.cwd(), { mode: flags["mode"] }, { DF_MODE: process.env["DF_MODE"] });
+            if (flags["json"] === true) {
+                process.stdout.write(`${JSON.stringify(status, null, 2)}\n`);
+                return 0;
+            }
+            if (!status.active) {
+                process.stdout.write("df mode: no operator mode active (normal engineer session). " +
+                    "Activate with --mode <name> or DF_MODE=<name>.\n");
+                return 0;
+            }
+            const scopes = status.mode.writeScopes ?? [];
+            process.stdout.write([
+                `df mode: ACTIVE — ${status.modeName}`,
+                `  writeScopes: ${scopes.length > 0 ? scopes.join(", ") : "(none configured)"}`,
+                `  protectedPaths: ${(status.mode.protectedPaths ?? []).join(", ") || "(none)"}`,
+                `  dependencyPolicy: ${status.mode.dependencyPolicy ?? "(unset)"}`,
+                `  visual evidence: ${status.mode.evidence?.visual ?? "(unset)"}`,
+            ].join("\n") + "\n");
+            return 0;
+        }
+        catch (e) {
+            process.stderr.write(`df mode status failed: ${e instanceof Error ? e.message : String(e)}\n`);
+            return 1;
+        }
+    }
+    if (sub === "apply") {
+        const modeName = positional[1] ?? "designer";
+        try {
+            const result = applyMode(process.cwd(), modeName);
+            process.stdout.write([
+                `df mode: ${result.created ? "created" : "updated"} ${result.settingsPath} for mode "${result.modeName}".`,
+                `df mode: next: open Claude Code in this repo — the session starts in ${result.modeName} mode.`,
+            ].join("\n") + "\n");
+            return 0;
+        }
+        catch (e) {
+            process.stderr.write(`df mode apply failed: ${e instanceof Error ? e.message : String(e)}\n`);
+            return 1;
+        }
+    }
+    if (sub === "guard" && flags["hook"] === true) {
+        // PreToolUse binding. JSON out on stdout, always exit 0 — the decision
+        // payload carries allow/deny; a crashed guard must not wedge the session.
+        let decision;
+        try {
+            const stdin = await readStdin();
+            let hookInput = null;
+            try {
+                hookInput = JSON.parse(stdin);
+            }
+            catch {
+                hookInput = null; // decideGuard fail-closes when a mode is active
+            }
+            const status = modeStatus(process.cwd(), {}, { DF_MODE: process.env["DF_MODE"] });
+            decision = decideGuard(hookInput, status.active ? { modeName: status.modeName, mode: status.mode } : undefined);
+        }
+        catch (e) {
+            // Catalog unresolvable while DF_MODE set (unknown mode, broken yaml):
+            // fail CLOSED — an unenforceable mode must not silently allow.
+            decision = {
+                decision: "deny",
+                plain: "To be safe, the mode guard blocked this action — the mode setup couldn't be read.",
+                hint: `guard could not resolve the active mode (${e instanceof Error ? e.message : String(e)}) — fix darkfactory.yaml/DF_MODE or unset DF_MODE`,
+            };
+        }
+        const payload = decision.decision === "allow"
+            ? { hookEventName: "PreToolUse", permissionDecision: "allow" }
+            : {
+                hookEventName: "PreToolUse",
+                permissionDecision: "deny",
+                permissionDecisionReason: `${decision.plain} [agent: ${decision.hint}]`,
+            };
+        process.stdout.write(`${JSON.stringify({ hookSpecificOutput: payload })}\n`);
+        return 0;
+    }
+    if (sub === "context" && flags["hook"] === true) {
+        try {
+            const status = modeStatus(process.cwd(), {}, { DF_MODE: process.env["DF_MODE"] });
+            if (!status.active)
+                return 0; // no mode → no context injection
+            // null covers missing, non-relative, traversal, and symlink-escape —
+            // all narrated as "unseeded" by buildModeContext (fail-safe silence).
+            const designMdPath = safeDesignMdPath(process.cwd(), status.mode.designSystem?.designMd ?? "DESIGN.md");
+            const designMd = designMdPath !== null ? readFileSync(designMdPath, "utf8") : undefined;
+            const additionalContext = buildModeContext({ modeName: status.modeName, mode: status.mode }, designMd);
+            process.stdout.write(`${JSON.stringify({ hookSpecificOutput: { hookEventName: "SessionStart", additionalContext } })}\n`);
+            return 0;
+        }
+        catch (e) {
+            process.stderr.write(`df mode context failed: ${e instanceof Error ? e.message : String(e)}\n`);
+            return 1;
+        }
+    }
+    process.stderr.write(`df mode: unknown subcommand "${sub}".\n${USAGE}\n`);
+    return 1;
+}
+//# sourceMappingURL=mode.js.map

package/dist/commands/mode.js.map

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

package/dist/commands/objectives.d.ts

@@ -10,9 +10,16 @@ interface HashOptions {
     subcommand: "hash";
     text: string;
 }
+type DeriveSource = {
+    kind: "cycle";
+    cycle: string;
+} | {
+    kind: "brief";
+    briefPath: string;
+};
 interface DeriveOptions {
     subcommand: "derive";
-    cycle: string;
+    source: DeriveSource;
     apply: boolean;
     json: boolean;
     cwd: string;
@@ -30,11 +37,19 @@ export declare function parseObjectivesArgs(rest: string[]): ParsedOptions | {
     error: string;
 };
 export interface ExtractedCriterion {
-    /** Criterion id (`ec<k>`) — the validator-compatible locator suffix. */
+    /**
+     * Criterion id — the locator suffix. `ec<k>` for a cycle-doc exit criterion,
+     * `ac<k>` for a brief Done-when checkbox.
+     */
     id: string;
     /** Human-facing display text (label + emphasis stripped). */
     text: string;
-    /** The verbatim source line — the canonical hash input. */
+    /**
+     * The canonical hash input for this criterion — the exact string fed to
+     * `canonicalizeCriterion`. For an exit-criteria item this is the verbatim
+     * source line; for a brief Done-when checkbox it is the criterion text with
+     * the `[ ]`/`[x]` marker stripped, so toggling the box never moves the hash.
+     */
     raw: string;
     /**
      * Non-blank, NON-marker lines that follow this item's `raw` line before the
@@ -61,6 +76,15 @@ export interface ExtractedCriterion {
  * criteria — see `continuationLines`.
  */
 export declare function extractExitCriteria(sectionBody: string): ExtractedCriterion[];
+/**
+ * Enumerate a brief `## Done-when` section body's checkboxes into criteria,
+ * assigning each a positional `ac<k>` id. Mirrors `extractExitCriteria`'s
+ * continuation-line collection so the single-line-atomic-criterion guard applies
+ * to briefs too. `raw` is the checkbox-stripped criterion text (the canonical
+ * hash input); NON-checkbox list items and prose in the section are ignored (one
+ * objective per Done-when checkbox).
+ */
+export declare function extractBriefCriteria(sectionBody: string): ExtractedCriterion[];
 export declare function cmdObjectives(rest: string[], io: ObjectivesIo, deps?: ObjectivesDeps): Promise<number>;
 export {};
 //# sourceMappingURL=objectives.d.ts.map

package/dist/commands/objectives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"objectives.d.ts","sourceRoot":"","sources":["../../src/commands/objectives.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,YAAY,EAAgB,MAAM,4BAA4B,CAAC;AAExE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAMD,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,OAAO,YAAY,CAAC;CACpC;AAED,UAAU,WAAW;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,aAAa;IACrB,UAAU,EAAE,QAAQ,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,YAAY;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,aAAa;IACrB,UAAU,EAAE,SAAS,CAAC;CACvB;AAED,KAAK,aAAa,GAAG,WAAW,GAAG,aAAa,GAAG,YAAY,GAAG,aAAa,CAAC;AAEhF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAqBrF;AAoMD,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;;;;;;;OAYG;IACH,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,EAAE,CA4B7E;AAyCD,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,EAAE,EAAE,YAAY,EAChB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,MAAM,CAAC,CAmCjB"}
+{"version":3,"file":"objectives.d.ts","sourceRoot":"","sources":["../../src/commands/objectives.ts"],"names":[],"mappings":"AAuBA,OAAO,EACL,YAAY,EAIb,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAMD,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,OAAO,YAAY,CAAC;CACpC;AAED,UAAU,WAAW;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,KAAK,YAAY,GACb;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,UAAU,aAAa;IACrB,UAAU,EAAE,QAAQ,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,YAAY;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,aAAa;IACrB,UAAU,EAAE,SAAS,CAAC;CACvB;AAED,KAAK,aAAa,GAAG,WAAW,GAAG,aAAa,GAAG,YAAY,GAAG,aAAa,CAAC;AAEhF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAqBrF;AA2ND,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;;;;;;;OAYG;IACH,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,EAAE,CA4B7E;AAkDD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,EAAE,CA2B9E;AAoED,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,EAAE,EAAE,YAAY,EAChB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,MAAM,CAAC,CAmCjB"}