@momentiq/dark-factory-cli 2.17.0 → 3.0.0

package/dist/mode/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/mode/init.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,8CAA8C;AAC9C,EAAE;AACF,sBAAsB;AACtB,8EAA8E;AAC9E,mEAAmE;AACnE,4EAA4E;AAC5E,+EAA+E;AAC/E,8EAA8E;AAC9E,yEAAyE;AACzE,6EAA6E;AAE7E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AACtE,OAAO,EACL,YAAY,EACZ,sBAAsB,GAEvB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AASjD,MAAM,uBAAuB,GAAG;IAC9B,YAAY;IACZ,WAAW;IACX,kBAAkB;IAClB,YAAY;IACZ,eAAe;IACf,cAAc;IACd,mBAAmB;CACpB,CAAC;AAEF,MAAM,yBAAyB,GAAG;IAChC,gBAAgB;IAChB,SAAS;IACT,WAAW;IACX,YAAY;IACZ,KAAK;IACL,YAAY;IACZ,OAAO;IACP,QAAQ;IACR,QAAQ;CACT,CAAC;AAEF,MAAM,2BAA2B,GAAG,CAAC,gBAAgB,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;AAEzF,SAAS,KAAK,CAAC,IAAY;IACzB,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,SAAS,IAAI,yBAAyB,EAAE,CAAC;QAClD,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,KAAK,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACxC,IAAI,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpB,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACjD,KAAK,MAAM,GAAG,IAAI,2BAA2B,EAAE,CAAC;gBAC9C,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;oBACtC,MAAM,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,GAAG,KAAK,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC/C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAEnD,CAAC;QACF,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,uBAAuB,EAAE,CAAC;QAClE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;IAC1E,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,QAAgB;IACtE,MAAM,WAAW,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAe;QACxB,WAAW;QACX,cAAc,EAAE,CAAC,GAAG,uBAAuB,CAAC;QAC5C,gBAAgB,EAAE,MAAM;QACxB,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE;QAC3C,YAAY,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE;QACvC,QAAQ,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE;KACjC,CAAC;IACF,IAAI,SAAS;QAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IAC3C,KAAK,QAAQ,CAAC,CAAC,sDAAsD;IACrE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,QAAgB;IACzD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,gEAAgE;QAChE,iEAAiE;QACjE,qEAAqE;QACrE,8CAA8C;QAC9C,MAAM,IAAI,KAAK,CACb,mCAAmC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,wBAAwB;YACjF,4BAA4B,YAAY,CAAC,MAAM,qBAAqB,CACvE,CAAC;IACJ,CAAC;IACD,wEAAwE;IACxE,0EAA0E;IAC1E,mDAAmD;IACnD,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,GAC9D,cAAc,CAAC,QAAQ,CAAC,CAAC;IAE3B,MAAM,KAAK,GAAG,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAExD,IAAI,cAAc,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrC,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,QAAQ;YACR,UAAU;YACV,WAAW,EAAE,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,WAAW,IAAI,EAAE;SAC/D,CAAC;IACJ,CAAC;IACD,IAAI,cAAc,CAAC,KAAK,EAAE,CAAC;QACzB,wEAAwE;QACxE,sEAAsE;QACtE,0EAA0E;QAC1E,MAAM,IAAI,KAAK,CACb,iEAAiE;YAC/D,aAAa,QAAQ,kDAAkD;YACvE,+CAA+C,CAClD,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GACT,mEAAmE,QAAQ,OAAO;QAClF,8EAA8E;QAC9E,aAAa,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IAElD,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,KAAK,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACvF,MAAM,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,KAAK,CAAC;IAEnD,sEAAsE;IACtE,sBAAsB,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;IAE7C,aAAa,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACrC,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,QAAQ;QACR,UAAU;QACV,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;KACrC,CAAC;AACJ,CAAC"}

package/dist/mode/loadConfig.d.ts

@@ -0,0 +1,34 @@
+import { type DarkFactoryConfig } from "@momentiq/dark-factory-schemas";
+export declare const MODE_CONFIG_FILENAME = "darkfactory.yaml";
+export interface LoadedModeConfig {
+    /**
+     * Absolute path to `darkfactory.yaml`, whether or not the file exists
+     * (`resolve`d against `repoRoot`, matching the skills-side loader).
+     */
+    readonly configPath: string;
+    /**
+     * Raw file text. `""` when the file is missing OR exists but is empty — so
+     * `text === ""` alone does NOT distinguish those two; a caller that needs
+     * the distinction checks the path on disk. `df mode init` appends to this
+     * verbatim so hand-maintained comments/formatting survive.
+     */
+    readonly text: string;
+    /**
+     * Canonically-parsed config. `{}` (defaults everywhere) when the file is
+     * missing, empty, or comment-only. Throws when the file exists with content
+     * that `parseDarkFactoryConfig` rejects — a mode command must fail closed on
+     * a malformed config rather than operate on a silently-defaulted one.
+     */
+    readonly config: DarkFactoryConfig;
+}
+/**
+ * Load `darkfactory.yaml` from `repoRoot` for the `df mode …` commands.
+ *
+ * A missing file, an empty file, and a comment/whitespace-only file all
+ * resolve to the empty config (`{}`) — the same defaulted-everywhere case the
+ * canonical parser treats `parseDarkFactoryConfig({})` as. Any other content
+ * is YAML-parsed then handed to `parseDarkFactoryConfig`, which throws a
+ * `SchemaError` naming the offending path on an invalid shape.
+ */
+export declare function loadModeConfig(repoRoot: string): LoadedModeConfig;
+//# sourceMappingURL=loadConfig.d.ts.map

package/dist/mode/loadConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadConfig.d.ts","sourceRoot":"","sources":["../../src/mode/loadConfig.ts"],"names":[],"mappings":"AAmBA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,gCAAgC,CAAC;AAExC,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAQjE"}

package/dist/mode/loadConfig.js

@@ -0,0 +1,38 @@
+// Cycle 27 — shared `darkfactory.yaml` loader for the `df mode …` surface.
+//
+// `df mode status` and `df mode init` both performed the same
+// read → parseYaml → parseDarkFactoryConfig ritual inline. This module is the
+// single home for that ritual so there is ONE place that decides how the mode
+// commands turn the file on disk into a typed config.
+//
+// It delegates shape validation to the canonical `parseDarkFactoryConfig`
+// (@momentiq/dark-factory-schemas) — the exact same parser `skills/config.ts`
+// (via `loadDarkFactoryConfig`) and `df doctor` (`checkDarkFactoryConfig`) use.
+// There is no second interpretation of `darkfactory.yaml`; the two loaders
+// differ only in ergonomics (this one returns the raw `text` so `df mode init`
+// can APPEND to the consumer's file without re-serializing it; the skills
+// loader adds an `isDefault` flag + a friendly error wrapper).
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { parseDarkFactoryConfig, } from "@momentiq/dark-factory-schemas";
+export const MODE_CONFIG_FILENAME = "darkfactory.yaml";
+/**
+ * Load `darkfactory.yaml` from `repoRoot` for the `df mode …` commands.
+ *
+ * A missing file, an empty file, and a comment/whitespace-only file all
+ * resolve to the empty config (`{}`) — the same defaulted-everywhere case the
+ * canonical parser treats `parseDarkFactoryConfig({})` as. Any other content
+ * is YAML-parsed then handed to `parseDarkFactoryConfig`, which throws a
+ * `SchemaError` naming the offending path on an invalid shape.
+ */
+export function loadModeConfig(repoRoot) {
+    const configPath = resolve(repoRoot, MODE_CONFIG_FILENAME);
+    const text = existsSync(configPath) ? readFileSync(configPath, "utf8") : "";
+    // Only YAML-parse when there is real content: the parser returns null for a
+    // comment/whitespace-only file, so `?? {}` folds that into the empty config.
+    const raw = text.trim().length > 0 ? parseYaml(text) : {};
+    const config = parseDarkFactoryConfig(raw ?? {});
+    return { configPath, text, config };
+}
+//# sourceMappingURL=loadConfig.js.map

package/dist/mode/loadConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadConfig.js","sourceRoot":"","sources":["../../src/mode/loadConfig.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,EAAE;AACF,8DAA8D;AAC9D,8EAA8E;AAC9E,8EAA8E;AAC9E,sDAAsD;AACtD,EAAE;AACF,0EAA0E;AAC1E,8EAA8E;AAC9E,gFAAgF;AAChF,2EAA2E;AAC3E,+EAA+E;AAC/E,0EAA0E;AAC1E,+DAA+D;AAE/D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EACL,sBAAsB,GAEvB,MAAM,gCAAgC,CAAC;AAExC,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAwBvD;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,4EAA4E;IAC5E,6EAA6E;IAC7E,MAAM,GAAG,GAAY,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IACjD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACtC,CAAC"}

package/dist/mode/prompts/designer-baseline.md

@@ -0,0 +1,47 @@
+<!-- DF-PROFILE: baseline -->
+# Designer Mode — session doctrine (baseline)
+
+You are working with a **non-technical operator** — a designer, PM, or founder
+describing product intent. You own every technical decision; they own every
+product decision. Their trust in this session depends on the rules below.
+
+## Language
+
+- Speak plain product language. Never show code, diffs, stack traces, file
+  trees, or git/terminal vocabulary unless the operator explicitly asks.
+- Translate progress and problems into outcomes: what changed, what they'll
+  see, what happens next. Never paste raw errors — say what went wrong in one
+  sentence and what you're doing about it.
+
+## Questions
+
+- Ask ONLY product or visual questions ("Should the banner stay visible while
+  scrolling?"), never technical ones (frameworks, files, state, APIs — decide
+  those yourself, following the repo's existing conventions).
+- Prefer multiple choice with 2–3 concrete options plus "you decide". One
+  question at a time. If you can make a reasonable call, make it and say so.
+
+## Design doctrine
+
+- `DESIGN.md` at the repo root is the design source of truth: take every
+  color, font, and spacing value from its tokens; follow its do's and don'ts.
+- Reuse existing components before creating anything new — extend, don't fork.
+- Never remove accessibility affordances (focus rings, labels, contrast).
+
+## Verification
+
+- Show, don't tell: run the dev server and present before/after screenshots
+  for every visual change. Iterate until the operator says it looks right.
+
+## Guardrails
+
+- When a tool call is denied by the mode guard, do NOT retry or work around
+  it. Explain in one plain sentence, then offer to package the request for an
+  engineer (a handoff) — framed as progress, not rejection.
+- Never bypass, weaken, or ask the operator to bypass any gate.
+
+## Shipping
+
+- Branches, PRs, reviews, and merges are invisible plumbing: run them
+  yourself and report status plainly ("It's in review with our automated
+  checks — I'll tell you when it's live.").

package/dist/mode/resolve.d.ts

@@ -0,0 +1,24 @@
+import { type DarkFactoryConfig, type ModeConfig } from "@momentiq/dark-factory-schemas";
+/**
+ * Pure precedence resolver. The CLI arg map can contain `mode` as a string
+ * (the value), `true` (bare `--mode` with no value), or be absent. The env
+ * map is `process.env` shape. Whitespace-trimmed; empty strings fall
+ * through. Returns `undefined` when no mode is selected.
+ */
+export declare function resolveMode(args: {
+    mode?: string | boolean | undefined;
+}, env: {
+    DF_MODE?: string | undefined;
+}): string | undefined;
+/**
+ * The result of applying a resolved mode name against the loaded
+ * darkfactory.yaml. Unlike the profile axis there is no back-compat
+ * pass-through: a mode name is meaningless without its guardrail catalog,
+ * so both "no catalog" and "name not in catalog" fail loudly.
+ */
+export interface ResolvedMode {
+    modeName: string;
+    mode: ModeConfig;
+}
+export declare function resolveModeWithConfig(config: DarkFactoryConfig, modeName: string): ResolvedMode;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/mode/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/mode/resolve.ts"],"names":[],"mappings":"AAcA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,UAAU,EAChB,MAAM,gCAAgC,CAAC;AAcxC;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;CAAE,EAC7C,GAAG,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACpC,MAAM,GAAG,SAAS,CAYpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,MAAM,GACf,YAAY,CAyBd"}

package/dist/mode/resolve.js

@@ -0,0 +1,65 @@
+// Cycle 27 Phase A — `DF_MODE` / `--mode` operator-axis resolution.
+//
+// Selects an OPERATOR mode (Designer Mode first) from the `modes` catalog in
+// darkfactory.yaml. This is deliberately a SEPARATE axis from the critic-fleet
+// profile selector (`--profile` / `AGENT_REVIEW_PROFILE` / policy/profile.ts):
+// a mode says who is driving the session and which guardrails apply; a profile
+// says which critic fleet reviews the commit. Neither reads the other's inputs.
+//
+// Selection precedence (highest → lowest):
+//   1. CLI `--mode <name>` flag.
+//   2. `DF_MODE` env var.
+//   3. No mode — unlike profiles there is NO default: an unmoded session is
+//      the normal engineer path, so absence must stay meaningful.
+import { MODE_NAME_RE, } from "@momentiq/dark-factory-schemas";
+function assertSlug(value, source) {
+    if (!MODE_NAME_RE.test(value)) {
+        // JSON.stringify renders the hostile value safely escaped (newlines,
+        // backticks, quotes) — never raw, and never inside a copyable command.
+        throw new Error(`df mode: invalid mode name ${JSON.stringify(value)} from ${source} — ` +
+            `mode names are lowercase slugs matching ${MODE_NAME_RE.source}.`);
+    }
+    return value;
+}
+/**
+ * Pure precedence resolver. The CLI arg map can contain `mode` as a string
+ * (the value), `true` (bare `--mode` with no value), or be absent. The env
+ * map is `process.env` shape. Whitespace-trimmed; empty strings fall
+ * through. Returns `undefined` when no mode is selected.
+ */
+export function resolveMode(args, env) {
+    const flagRaw = args.mode;
+    if (typeof flagRaw === "string") {
+        const trimmed = flagRaw.trim();
+        if (trimmed.length > 0)
+            return assertSlug(trimmed, "--mode");
+    }
+    const envRaw = env.DF_MODE;
+    if (typeof envRaw === "string") {
+        const trimmed = envRaw.trim();
+        if (trimmed.length > 0)
+            return assertSlug(trimmed, "DF_MODE");
+    }
+    return undefined;
+}
+export function resolveModeWithConfig(config, modeName) {
+    // Callers reach here via resolveMode (slug-validated), but this function is
+    // exported — re-assert so no path interpolates an unvalidated name.
+    if (!MODE_NAME_RE.test(modeName)) {
+        throw new Error(`df mode: invalid mode name ${JSON.stringify(modeName)} — ` +
+            `mode names are lowercase slugs matching ${MODE_NAME_RE.source}.`);
+    }
+    if (!config.modes) {
+        throw new Error(`df mode: no \`modes\` catalog in darkfactory.yaml — mode "${modeName}" ` +
+            `cannot be resolved. Run \`df mode init <name>\` (e.g. \`df mode init designer\`) to seed one.`);
+    }
+    const mode = config.modes[modeName];
+    if (!mode) {
+        const available = Object.keys(config.modes);
+        throw new Error(`df mode: unknown mode "${modeName}". ` +
+            `Available modes: ${available.length > 0 ? available.join(", ") : "(none)"}. ` +
+            `Set via --mode <name> or DF_MODE=<name>; no mode is the default.`);
+    }
+    return { modeName, mode };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/mode/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/mode/resolve.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,+EAA+E;AAC/E,+EAA+E;AAC/E,gFAAgF;AAChF,EAAE;AACF,2CAA2C;AAC3C,iCAAiC;AACjC,0BAA0B;AAC1B,4EAA4E;AAC5E,kEAAkE;AAElE,OAAO,EACL,YAAY,GAGb,MAAM,gCAAgC,CAAC;AAExC,SAAS,UAAU,CAAC,KAAa,EAAE,MAA4B;IAC7D,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,qEAAqE;QACrE,uEAAuE;QACvE,MAAM,IAAI,KAAK,CACb,8BAA8B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,MAAM,KAAK;YACrE,2CAA2C,YAAY,CAAC,MAAM,GAAG,CACpE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,IAA6C,EAC7C,GAAqC;IAErC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC;IAC1B,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC;IAC3B,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAaD,MAAM,UAAU,qBAAqB,CACnC,MAAyB,EACzB,QAAgB;IAEhB,4EAA4E;IAC5E,oEAAoE;IACpE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,8BAA8B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK;YACzD,2CAA2C,YAAY,CAAC,MAAM,GAAG,CACpE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,6DAA6D,QAAQ,IAAI;YACvE,+FAA+F,CAClG,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,0BAA0B,QAAQ,KAAK;YACrC,oBAAoB,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI;YAC9E,kEAAkE,CACrE,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC"}

package/dist/mode/scope-policy.d.ts

@@ -0,0 +1,41 @@
+import type { ModeConfig } from "@momentiq/dark-factory-schemas";
+/**
+ * Bounded glob matcher for mode-catalog patterns. Supports exactly the
+ * forms the catalog uses — `**` (any depth, including none, across
+ * separators), `*` (any run within a segment), literal text — via safe
+ * regex translation. Deliberately NOT a general glob engine and NOT a new
+ * dependency: catalog patterns are repo-author-controlled.
+ */
+export declare function globMatch(pattern: string, path: string): boolean;
+export declare const DEPENDENCY_MANIFESTS: readonly string[];
+/**
+ * The rule that fired for a single repo-relative path against a mode
+ * catalog. `allow` means the path is within the mode's permitted surface;
+ * every other kind is a scope violation, in precedence order.
+ */
+export type ModePathClassification = {
+    kind: "allow";
+} | {
+    kind: "protected";
+} | {
+    kind: "dependency";
+} | {
+    kind: "out-of-scope";
+};
+/**
+ * Classify ONE repo-relative, forward-slash path against a mode catalog.
+ * Pure and total. Precedence (highest → lowest), matching spec §4.3 /
+ * §4.4:
+ *   1. `protectedPaths` — ALWAYS wins over writeScopes on overlap.
+ *   2. dependency manifest under `dependencyPolicy: "none"`.
+ *   3. `writeScopes` membership — only enforced when the mode declares at
+ *      least one write scope (an empty/absent writeScopes list means "no
+ *      scope narrowing", so nothing is out-of-scope on that axis).
+ *
+ * The caller supplies an already-relativized path (no leading `/`, no
+ * `..`); path canonicalization / repo-escape rejection is the caller's
+ * concern (the guard relativizes tool-call paths; the critic reads
+ * git-relative diff paths, which are already repo-relative).
+ */
+export declare function classifyModePath(path: string, mode: ModeConfig): ModePathClassification;
+//# sourceMappingURL=scope-policy.d.ts.map

package/dist/mode/scope-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-policy.d.ts","sourceRoot":"","sources":["../../src/mode/scope-policy.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CA4BhE;AAMD,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAOjD,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,CAAC;AAE7B;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,sBAAsB,CAcvF"}

package/dist/mode/scope-policy.js

@@ -0,0 +1,97 @@
+// Cycle 27 Phase C — shared operator-mode scope-policy core.
+//
+// Single source of truth for the catalog scope decision that BOTH
+// enforcement layers consume (spec §4.4 frames them as ONE policy, so
+// they must not drift):
+//   - Layer 2 (`mode/guard.ts` PreToolUse hook) — per-tool-call, live in
+//     the session, dual-register deny messages.
+//   - Layer 4 (`adapters/mode-scope.ts` CI/pre-push critic) — per-diff,
+//     tamper-proof, `blocker` findings.
+//
+// The precedence is invariant across both: `protectedPaths` ALWAYS wins
+// over `writeScopes` on overlap, then dependency-manifest edits under
+// `dependencyPolicy: "none"`, then writeScopes membership. Extracting the
+// classifier here means a change to that precedence lands in one place and
+// is enforced identically at both layers.
+/**
+ * Bounded glob matcher for mode-catalog patterns. Supports exactly the
+ * forms the catalog uses — `**` (any depth, including none, across
+ * separators), `*` (any run within a segment), literal text — via safe
+ * regex translation. Deliberately NOT a general glob engine and NOT a new
+ * dependency: catalog patterns are repo-author-controlled.
+ */
+export function globMatch(pattern, path) {
+    let re = "";
+    for (let i = 0; i < pattern.length; i++) {
+        const ch = pattern[i];
+        if (ch === "*") {
+            if (pattern[i + 1] === "*") {
+                // `**` = any depth. Two shapes: a `**/` prefix/interior swallows its
+                // slash (`(?:.*/)?`) so `**/x` also matches a root-level `x`; a trailing
+                // `**` becomes `.*`, so `a/**` → `^a/.*$` matches everything UNDER `a/`
+                // at any depth (the paths classified here are files, never a bare dir).
+                const next = pattern[i + 2];
+                if (next === "/") {
+                    re += "(?:.*/)?";
+                    i += 2;
+                }
+                else {
+                    re += ".*";
+                    i += 1;
+                }
+            }
+            else {
+                re += "[^/]*";
+            }
+        }
+        else if ("\\^$.|?+()[]{}".includes(ch)) {
+            re += `\\${ch}`;
+        }
+        else {
+            re += ch;
+        }
+    }
+    return new RegExp(`^${re}$`).test(path);
+}
+// Manifest/lockfile basenames that a `dependencyPolicy: "none"` mode may
+// not touch. Basename match (a nested `apps/web/package.json` is still a
+// dependency manifest). Kept in lockstep with the guard's Bash dependency
+// denylist by construction — both live in this module's consumers.
+export const DEPENDENCY_MANIFESTS = [
+    "package.json",
+    "package-lock.json",
+    "npm-shrinkwrap.json",
+    "pnpm-lock.yaml",
+    "yarn.lock",
+    "bun.lockb",
+];
+/**
+ * Classify ONE repo-relative, forward-slash path against a mode catalog.
+ * Pure and total. Precedence (highest → lowest), matching spec §4.3 /
+ * §4.4:
+ *   1. `protectedPaths` — ALWAYS wins over writeScopes on overlap.
+ *   2. dependency manifest under `dependencyPolicy: "none"`.
+ *   3. `writeScopes` membership — only enforced when the mode declares at
+ *      least one write scope (an empty/absent writeScopes list means "no
+ *      scope narrowing", so nothing is out-of-scope on that axis).
+ *
+ * The caller supplies an already-relativized path (no leading `/`, no
+ * `..`); path canonicalization / repo-escape rejection is the caller's
+ * concern (the guard relativizes tool-call paths; the critic reads
+ * git-relative diff paths, which are already repo-relative).
+ */
+export function classifyModePath(path, mode) {
+    const basename = path.split("/").pop() ?? path;
+    if ((mode.protectedPaths ?? []).some((p) => globMatch(p, path))) {
+        return { kind: "protected" };
+    }
+    if (mode.dependencyPolicy === "none" && DEPENDENCY_MANIFESTS.includes(basename)) {
+        return { kind: "dependency" };
+    }
+    const scopes = mode.writeScopes ?? [];
+    if (scopes.length > 0 && !scopes.some((p) => globMatch(p, path))) {
+        return { kind: "out-of-scope" };
+    }
+    return { kind: "allow" };
+}
+//# sourceMappingURL=scope-policy.js.map

package/dist/mode/scope-policy.js.map

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

package/dist/mode/status.d.ts

@@ -0,0 +1,14 @@
+import { type ModeConfig } from "@momentiq/dark-factory-schemas";
+export type ModeStatusResult = {
+    active: false;
+} | {
+    active: true;
+    modeName: string;
+    mode: ModeConfig;
+};
+export declare function modeStatus(repoRoot: string, args: {
+    mode?: string | boolean | undefined;
+}, env: {
+    DF_MODE?: string | undefined;
+}): ModeStatusResult;
+//# sourceMappingURL=status.d.ts.map

package/dist/mode/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/mode/status.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAKjE,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GACjB;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAEzD,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;CAAE,EAC7C,GAAG,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACpC,gBAAgB,CAOlB"}

package/dist/mode/status.js

@@ -0,0 +1,13 @@
+// Cycle 27 Phase A — `df mode status`: report the session's active operator
+// mode. "No mode" is the normal engineer path, not an error.
+import { loadModeConfig } from "./loadConfig.js";
+import { resolveMode, resolveModeWithConfig } from "./resolve.js";
+export function modeStatus(repoRoot, args, env) {
+    const modeName = resolveMode(args, env);
+    if (!modeName)
+        return { active: false };
+    const { config } = loadModeConfig(repoRoot);
+    const resolved = resolveModeWithConfig(config, modeName);
+    return { active: true, modeName: resolved.modeName, mode: resolved.mode };
+}
+//# sourceMappingURL=status.js.map

package/dist/mode/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/mode/status.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,6DAA6D;AAI7D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAMlE,MAAM,UAAU,UAAU,CACxB,QAAgB,EAChB,IAA6C,EAC7C,GAAqC;IAErC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAExC,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACzD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;AAC5E,CAAC"}

package/dist/onboard/seeders/design-md.d.ts

@@ -0,0 +1,3 @@
+import type { Seeder } from "./index.js";
+export declare const designMdSeeder: Seeder;
+//# sourceMappingURL=design-md.d.ts.map

package/dist/onboard/seeders/design-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-md.d.ts","sourceRoot":"","sources":["../../../src/onboard/seeders/design-md.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,YAAY,CAAC;AAoGtD,eAAO,MAAM,cAAc,EAAE,MA0B5B,CAAC"}

package/dist/onboard/seeders/design-md.js

@@ -0,0 +1,138 @@
+// packages/cli/src/onboard/seeders/design-md.ts
+//
+// DESIGN.md seeder — cycle 27 Phase A.
+//
+// Every DF-onboarded repo carries a DESIGN.md (Google Labs open DESIGN.md
+// spec, Apr 2026): machine-readable design tokens as a YAML frontmatter
+// block + human-readable design intent underneath — the design-side sibling
+// of AGENTS.md. Deterministic emitter:
+//
+//  - UI repo (react/next/vue/svelte/angular/... in `analysis.dependencies`)
+//    → full skeleton with token placeholders + a reuse-existing-components
+//    mandate (the guidance Designer Mode's persona and the chief-designer
+//    critic bind to).
+//  - No UI dependencies → minimal declaration that the repo currently has
+//    no UI surface, so agents don't invent one; the skeleton upgrades when
+//    a UI lands.
+//  - Repo already has a DESIGN.md → explicit `skip` plan (observability in
+//    the onboard dry-run rendering), never overwrite.
+const UI_DEPENDENCY_NAMES = new Set([
+    "react",
+    "react-dom",
+    "next",
+    "vue",
+    "nuxt",
+    "svelte",
+    "@sveltejs/kit",
+    "solid-js",
+    "preact",
+    "astro",
+    "@angular/core",
+]);
+function hasUiSurface(input) {
+    const deps = input.analysis
+        .dependencies;
+    if (!Array.isArray(deps))
+        return false;
+    return deps.some((d) => UI_DEPENDENCY_NAMES.has(d.name));
+}
+function repoName(input) {
+    const name = input.analysis.repo?.name;
+    return name && name.length > 0 ? name : "this repo";
+}
+const TOKEN_FRONTMATTER = `---
+# DESIGN.md — machine-readable design tokens (Google Labs DESIGN.md spec).
+# Replace the placeholder values below with your product's real tokens;
+# agents treat this block as the single source of design truth.
+colors:
+  primary: "#4f46e5"
+  surface: "#ffffff"
+  text: "#111827"
+  muted: "#6b7280"
+typography:
+  body:
+    family: "system-ui"
+    size: "16px"
+    lineHeight: 1.5
+  heading:
+    family: "system-ui"
+    weight: 600
+spacing:
+  unit: "4px"
+  scale: [4, 8, 12, 16, 24, 32, 48]
+components:
+  policy: "reuse existing components before creating new ones"
+---
+`;
+function uiBody(name) {
+    return `${TOKEN_FRONTMATTER}
+# ${name} — Design System
+
+Seeded by \`df onboard\` (cycle 27). This file is the design-side sibling of
+AGENTS.md: coding agents read it before generating or changing UI, and the
+design-lens critics review against it. Keep it truthful — placeholder tokens
+that don't match the product are worse than none.
+
+## Design Philosophy
+
+Describe, in a few sentences, what the product should feel like and why.
+Agents use this to make the thousand small calls tokens can't encode.
+
+## Visual Theme & Atmosphere
+
+Describe density, tone, motion, and imagery expectations.
+
+## Do's and Don'ts
+
+- DO reuse existing components before creating new ones — extend, don't fork.
+- DO take every color, font, and spacing value from the tokens above.
+- DON'T introduce new colors, fonts, or spacing values outside the tokens.
+- DON'T remove accessibility affordances (focus rings, labels, contrast).
+`;
+}
+function noUiBody(name) {
+    return `${TOKEN_FRONTMATTER}
+# ${name} — Design System
+
+Seeded by \`df onboard\` (cycle 27). ${name} currently exposes **no UI
+surface** — no UI framework was detected among its dependencies. Agents must
+not invent one. If a UI lands later, replace the placeholder tokens above
+with real values and expand the sections below.
+
+## Design Philosophy
+
+(No UI surface yet.)
+
+## Do's and Don'ts
+
+- DON'T scaffold UI components in this repo without an approved plan.
+- DO update this file in the same PR that introduces any UI surface.
+`;
+}
+export const designMdSeeder = {
+    name: "design-md",
+    async seed(input) {
+        if (input.designMdExists) {
+            return [
+                {
+                    path: "DESIGN.md",
+                    action: "skip",
+                    rationale: "DESIGN.md already present at repo root — df never overwrites a hand-maintained design doctrine file.",
+                },
+            ];
+        }
+        const name = repoName(input);
+        const ui = hasUiSurface(input);
+        return [
+            {
+                path: "DESIGN.md",
+                action: "emit",
+                rationale: ui
+                    ? "UI dependencies detected — seed the Google Labs DESIGN.md skeleton (token frontmatter + design intent) so agents and design-lens critics share one design source of truth."
+                    : "No UI dependencies detected — seed a minimal DESIGN.md declaring the absence of a UI surface so agents don't invent one.",
+                tailored_content: ui ? uiBody(name) : noUiBody(name),
+            },
+        ];
+    },
+};
+//# sourceMappingURL=design-md.js.map

package/dist/onboard/seeders/design-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-md.js","sourceRoot":"","sources":["../../../src/onboard/seeders/design-md.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,uCAAuC;AACvC,EAAE;AACF,0EAA0E;AAC1E,wEAAwE;AACxE,4EAA4E;AAC5E,uCAAuC;AACvC,EAAE;AACF,4EAA4E;AAC5E,2EAA2E;AAC3E,0EAA0E;AAC1E,sBAAsB;AACtB,0EAA0E;AAC1E,2EAA2E;AAC3E,iBAAiB;AACjB,2EAA2E;AAC3E,sDAAsD;AAKtD,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,OAAO;IACP,WAAW;IACX,MAAM;IACN,KAAK;IACL,MAAM;IACN,QAAQ;IACR,eAAe;IACf,UAAU;IACV,QAAQ;IACR,OAAO;IACP,eAAe;CAChB,CAAC,CAAC;AAEH,SAAS,YAAY,CAAC,KAAkB;IACtC,MAAM,IAAI,GAAI,KAAK,CAAC,QAAuD;SACxE,YAAY,CAAC;IAChB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,QAAQ,CAAC,KAAkB;IAClC,MAAM,IAAI,GAAI,KAAK,CAAC,QAAyC,CAAC,IAAI,EAAE,IAAI,CAAC;IACzE,OAAO,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC;AACtD,CAAC;AAED,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;CAuBzB,CAAC;AAEF,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,GAAG,iBAAiB;IACzB,IAAI;;;;;;;;;;;;;;;;;;;;;;CAsBP,CAAC;AACF,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,GAAG,iBAAiB;IACzB,IAAI;;uCAE+B,IAAI;;;;;;;;;;;;;CAa1C,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAW;IACpC,IAAI,EAAE,WAAW;IACjB,KAAK,CAAC,IAAI,CAAC,KAAkB;QAC3B,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;YACzB,OAAO;gBACL;oBACE,IAAI,EAAE,WAAW;oBACjB,MAAM,EAAE,MAAM;oBACd,SAAS,EACP,sGAAsG;iBACzG;aACF,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC7B,MAAM,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/B,OAAO;YACL;gBACE,IAAI,EAAE,WAAW;gBACjB,MAAM,EAAE,MAAM;gBACd,SAAS,EAAE,EAAE;oBACX,CAAC,CAAC,4KAA4K;oBAC9K,CAAC,CAAC,0HAA0H;gBAC9H,gBAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;aACrD;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/onboard/seeders/index.d.ts

@@ -1,5 +1,6 @@
 import type { FilePlan } from "../scaffold-schema.js";
 import type { RepoAnalysis } from "../schema.js";
+import { designMdSeeder } from "./design-md.js";
 export type { FilePlan } from "../scaffold-schema.js";
 /**
  * Input to a Phase C seeder.
@@ -23,6 +24,12 @@ export interface SeederInput {
     readonly existingRunbooks?: readonly string[];
     readonly now: Date;
     readonly profile?: "local" | "cloud";
+    /**
+     * True when the target repo already has a root DESIGN.md (cycle 27 —
+     * the design-md seeder must skip rather than overwrite). Populated by
+     * `cmdOnboard`; optional so prose-seeder unit tests need not set it.
+     */
+    readonly designMdExists?: boolean;
 }
 export interface Seeder {
     readonly name: string;
@@ -39,6 +46,7 @@ export { adrSeeder } from "./adr.js";
 export { cycle1BootstrapSeeder } from "./cycle1-bootstrap.js";
 export { runbookSeeder } from "./runbook.js";
 export { agentReviewConfigSeeder } from "./agent-review-config.js";
+export { designMdSeeder };
 /**
  * The canonical seeder set wired into `cmdOnboard` (Task 4.5). Order is
  * presentation-only — `runSeeders` runs them concurrently.

package/dist/onboard/seeders/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/onboard/seeders/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAOjD,YAAY,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CACtC;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;CAC/C;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAcrB;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAKhD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/onboard/seeders/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAMjD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,YAAY,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;CAC/C;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAcrB;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAMhD,CAAC"}

package/dist/onboard/seeders/index.js

@@ -2,6 +2,7 @@ import { adrSeeder } from "./adr.js";
 import { cycle1BootstrapSeeder } from "./cycle1-bootstrap.js";
 import { runbookSeeder } from "./runbook.js";
 import { agentReviewConfigSeeder } from "./agent-review-config.js";
+import { designMdSeeder } from "./design-md.js";
 /**
  * Run every seeder in parallel, isolating individual failures to stderr so a
  * single broken seeder does NOT block the rest of the merge. Phase C seeders
@@ -24,6 +25,7 @@ export { adrSeeder } from "./adr.js";
 export { cycle1BootstrapSeeder } from "./cycle1-bootstrap.js";
 export { runbookSeeder } from "./runbook.js";
 export { agentReviewConfigSeeder } from "./agent-review-config.js";
+export { designMdSeeder };
 /**
  * The canonical seeder set wired into `cmdOnboard` (Task 4.5). Order is
  * presentation-only — `runSeeders` runs them concurrently.
@@ -33,5 +35,6 @@ export const ALL_SEEDERS_DEFAULT = [
     cycle1BootstrapSeeder,
     runbookSeeder,
     agentReviewConfigSeeder,
+    designMdSeeder,
 ];
 //# sourceMappingURL=index.js.map