@nac3/forge-cli 0.2.0-alpha.9 → 1.0.0

package/dist/wiring/store.js

@@ -0,0 +1,182 @@
+/**
+ * Yujin Forge -- wiring registry store.
+ *
+ * One JSON file per project at
+ *   ~/.yujin-forge/projects/<slug>/wiring.json
+ *
+ * Mirror of the pending registry pattern. Atomic writes via
+ * `renameWithRetry` (Windows EPERM resilient). Cached for ~5s
+ * in-process so buildSystemPrompt can call readWiring() multiple
+ * times per turn without disk thrash.
+ *
+ * Lookup by hook id, by kind, by source_file. The discover module
+ * is the only writer for the hooks[] array; user annotations go
+ * through annotateHook() which preserves them across re-scans by
+ * keying on the hook id.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { renameWithRetry } from '../core/atomic_write.js';
+import { WIRING_FILE_VERSION, emptyWiringFile, } from './types.js';
+const FILE_NAME = 'wiring.json';
+const READ_CACHE_TTL_MS = 5_000;
+const READ_CACHE = new Map();
+function configRoot() {
+    if (process.env['YUJIN_FORGE_HOME'])
+        return process.env['YUJIN_FORGE_HOME'];
+    if (process.env['YF_CONFIG_DIR'])
+        return process.env['YF_CONFIG_DIR'];
+    const xdg = process.env['XDG_CONFIG_HOME'];
+    if (xdg && process.platform === 'linux')
+        return path.join(xdg, 'yujin-forge');
+    return path.join(os.homedir(), '.yujin-forge');
+}
+function projectDir(project_slug) {
+    if (!project_slug || project_slug.includes('..') || /[/\\]/.test(project_slug)) {
+        throw new Error('wiring: invalid project_slug ' + JSON.stringify(project_slug));
+    }
+    return path.join(configRoot(), 'projects', project_slug);
+}
+function fileFor(project_slug) {
+    return path.join(projectDir(project_slug), FILE_NAME);
+}
+/** Read the wiring file for a project. Returns an empty file when
+ *  none exists; never throws ENOENT. Other I/O errors propagate. */
+export async function readWiring(project_slug) {
+    const cached = READ_CACHE.get(project_slug);
+    if (cached && (Date.now() - cached.at) < READ_CACHE_TTL_MS)
+        return cached.file;
+    const f = fileFor(project_slug);
+    try {
+        const raw = await fs.readFile(f, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object' || parsed.version !== WIRING_FILE_VERSION
+            || !Array.isArray(parsed.hooks)) {
+            const fresh = emptyWiringFile(project_slug);
+            READ_CACHE.set(project_slug, { at: Date.now(), file: fresh });
+            return fresh;
+        }
+        const file = {
+            version: WIRING_FILE_VERSION,
+            project_slug,
+            scanned_at: typeof parsed.scanned_at === 'string' ? parsed.scanned_at : new Date(0).toISOString(),
+            scanned_sha: typeof parsed.scanned_sha === 'string' ? parsed.scanned_sha : '',
+            hooks: parsed.hooks.filter(isValidHook),
+        };
+        READ_CACHE.set(project_slug, { at: Date.now(), file });
+        return file;
+    }
+    catch (err) {
+        /* ENOENT -> empty file (no wiring yet).
+         * SyntaxError (hand-edited JSON) -> empty file too: better than
+         * a hard crash inside buildSystemPrompt at chat-server boot. */
+        const code = err instanceof Error && 'code' in err ? err.code : undefined;
+        if (code === 'ENOENT' || err instanceof SyntaxError) {
+            const fresh = emptyWiringFile(project_slug);
+            READ_CACHE.set(project_slug, { at: Date.now(), file: fresh });
+            return fresh;
+        }
+        throw err;
+    }
+}
+function isValidHook(h) {
+    if (!h || typeof h !== 'object')
+        return false;
+    const o = h;
+    return typeof o['id'] === 'string'
+        && typeof o['kind'] === 'string'
+        && typeof o['trigger'] === 'string'
+        && typeof o['destination'] === 'string'
+        && typeof o['source_file'] === 'string'
+        && Array.isArray(o['auto_runs_on']);
+}
+export async function writeWiring(file) {
+    if (file.version !== WIRING_FILE_VERSION) {
+        throw new Error('wiring: writeWiring rejected -- version mismatch');
+    }
+    const dir = projectDir(file.project_slug);
+    await fs.mkdir(dir, { recursive: true });
+    const f = fileFor(file.project_slug);
+    const tmp = f + '.tmp';
+    await fs.writeFile(tmp, JSON.stringify(file, null, 2) + '\n', 'utf-8');
+    await renameWithRetry(tmp, f);
+    READ_CACHE.set(file.project_slug, { at: Date.now(), file });
+}
+/** Replace the hooks[] of a project (discover writes this). Preserves
+ *  user annotations + disabled flags by matching incoming hooks to
+ *  existing ones via hook id. New hooks land without annotations;
+ *  hooks that vanish from the new scan get dropped entirely. */
+export async function replaceHooks(project_slug, freshHooks, scanned_sha) {
+    const current = await readWiring(project_slug);
+    const annotationsById = new Map();
+    for (const h of current.hooks) {
+        const e = {};
+        if (h.user_annotation !== undefined)
+            e.annotation = h.user_annotation;
+        if (h.disabled !== undefined)
+            e.disabled = h.disabled;
+        if (Object.keys(e).length > 0)
+            annotationsById.set(h.id, e);
+    }
+    const merged = freshHooks.map((h) => {
+        const ann = annotationsById.get(h.id);
+        if (!ann)
+            return h;
+        const out = { ...h };
+        if (ann.annotation !== undefined)
+            out.user_annotation = ann.annotation;
+        if (ann.disabled !== undefined)
+            out.disabled = ann.disabled;
+        return out;
+    });
+    const next = {
+        version: WIRING_FILE_VERSION,
+        project_slug,
+        scanned_at: new Date().toISOString(),
+        scanned_sha,
+        hooks: merged,
+    };
+    await writeWiring(next);
+    return next;
+}
+export async function annotateHook(project_slug, hook_id, patch) {
+    const file = await readWiring(project_slug);
+    const idx = file.hooks.findIndex((h) => h.id === hook_id);
+    if (idx === -1)
+        throw new Error('wiring: hook not found: ' + hook_id);
+    const updated = { ...file.hooks[idx] };
+    if (patch.user_annotation !== undefined) {
+        if (patch.user_annotation === '')
+            delete updated.user_annotation;
+        else
+            updated.user_annotation = patch.user_annotation;
+    }
+    if (patch.disabled !== undefined) {
+        if (patch.disabled === false)
+            delete updated.disabled;
+        else
+            updated.disabled = true;
+    }
+    file.hooks[idx] = updated;
+    await writeWiring(file);
+    return file;
+}
+/** Drop the whole wiring file for a project (yf wiring forget). */
+export async function forgetWiring(project_slug) {
+    const f = fileFor(project_slug);
+    try {
+        await fs.unlink(f);
+    }
+    catch (err) {
+        if (err instanceof Error && 'code' in err && err.code === 'ENOENT')
+            return;
+        throw err;
+    }
+    READ_CACHE.delete(project_slug);
+}
+/** Test seam -- bust the in-process cache without touching disk. */
+export function _clearWiringCacheForTest() { READ_CACHE.clear(); }
+//# sourceMappingURL=store.js.map

package/dist/wiring/store.js.map

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

package/dist/wiring/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Yujin Forge -- wiring registry types.
+ *
+ * Per-project record of CI/CD + deploy + publish + release hooks
+ * that Forge has DETECTED automatically by scanning the workspace.
+ * The point is that Forge does not forget what wiring a project
+ * already has -- when the user says "deploy this", Forge sees
+ * "this project deploys via GHA on push to main" and stops itself
+ * from running a redundant local script.
+ *
+ * Store: one JSON file per project at
+ *   ~/.yujin-forge/projects/<slug>/wiring.json
+ *
+ * Same pattern as pending registry (PND-159). User annotations
+ * persist across re-discovers so "this workflow is broken,
+ * ignore it" survives a re-scan.
+ *
+ * ASCII-only.
+ */
+export declare const WIRING_FILE_VERSION = 1;
+/** Categories of automation Forge detects. Add new kinds here when
+ *  you add a new scanner in src/wiring/discover.ts. */
+export type WiringKind = 'ci_deploy' | 'ci_publish' | 'ci_release' | 'edge_deploy' | 'mobile_distribution' | 'static_hosting' | 'npm_script_deploy' | 'docker_build';
+/** Triggers that fire a hook. */
+export type WiringTrigger = 'push:main' | 'push:master' | 'push:any' | 'tag:v*' | 'tag:release-*' | 'pr:opened' | 'pr:merged' | 'manual' | 'schedule' | 'unknown';
+export interface WiringHook {
+    /** Stable id, e.g. 'gha:deploy.yml' or 'npm:scripts.publish' or
+     *  'eas:apps/forge-mobile:submit'. */
+    id: string;
+    kind: WiringKind;
+    trigger: WiringTrigger;
+    /** Free-text destination: "godaddy:yujin.app", "npm:@nac3/forge-cli",
+     *  "cloudflare:yujin-hito4", "play:internal", etc. */
+    destination: string;
+    /** Path relative to project root where the hook is defined. */
+    source_file: string;
+    /** Concrete commands a user can run to trigger this hook manually.
+     *  Surfaced into the system prompt so Forge tells the user "git
+     *  push origin main" rather than re-running a deploy script. */
+    auto_runs_on: string[];
+    /** Optional free-text the user added via `yf wiring annotate`. */
+    user_annotation?: string;
+    /** When true, scanner found it but user said "ignore this". */
+    disabled?: boolean;
+}
+export interface WiringFile {
+    version: typeof WIRING_FILE_VERSION;
+    project_slug: string;
+    /** ISO 8601 timestamp of the last scanner pass. */
+    scanned_at: string;
+    /** Hash of the mtimes of every file the scanner considered, so a
+     *  cheap re-scan can short-circuit when nothing relevant changed. */
+    scanned_sha: string;
+    hooks: WiringHook[];
+}
+export declare function emptyWiringFile(project_slug: string): WiringFile;
+/** Heuristic checks the caller can run before invoking discover so
+ *  the system prompt does not advertise wiring when none was
+ *  detected. */
+export declare function hasActiveHooks(file: WiringFile): boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/wiring/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/wiring/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;uDACuD;AACvD,MAAM,MAAM,UAAU,GAClB,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,qBAAqB,GACrB,gBAAgB,GAChB,mBAAmB,GACnB,cAAc,CAAC;AAEnB,iCAAiC;AACjC,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,aAAa,GACb,UAAU,GACV,QAAQ,GACR,eAAe,GACf,WAAW,GACX,WAAW,GACX,QAAQ,GACR,UAAU,GACV,SAAS,CAAC;AAEd,MAAM,WAAW,UAAU;IACzB;0CACsC;IACtC,EAAE,EAAe,MAAM,CAAC;IACxB,IAAI,EAAa,UAAU,CAAC;IAC5B,OAAO,EAAU,aAAa,CAAC;IAC/B;0DACsD;IACtD,WAAW,EAAM,MAAM,CAAC;IACxB,+DAA+D;IAC/D,WAAW,EAAM,MAAM,CAAC;IACxB;;oEAEgE;IAChE,YAAY,EAAK,MAAM,EAAE,CAAC;IAC1B,kEAAkE;IAClE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,EAAS,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAS,OAAO,mBAAmB,CAAC;IAC3C,YAAY,EAAI,MAAM,CAAC;IACvB,mDAAmD;IACnD,UAAU,EAAM,MAAM,CAAC;IACvB;yEACqE;IACrE,WAAW,EAAK,MAAM,CAAC;IACvB,KAAK,EAAW,UAAU,EAAE,CAAC;CAC9B;AAED,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,CAQhE;AAED;;gBAEgB;AAChB,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAExD"}

package/dist/wiring/types.js

@@ -0,0 +1,36 @@
+/**
+ * Yujin Forge -- wiring registry types.
+ *
+ * Per-project record of CI/CD + deploy + publish + release hooks
+ * that Forge has DETECTED automatically by scanning the workspace.
+ * The point is that Forge does not forget what wiring a project
+ * already has -- when the user says "deploy this", Forge sees
+ * "this project deploys via GHA on push to main" and stops itself
+ * from running a redundant local script.
+ *
+ * Store: one JSON file per project at
+ *   ~/.yujin-forge/projects/<slug>/wiring.json
+ *
+ * Same pattern as pending registry (PND-159). User annotations
+ * persist across re-discovers so "this workflow is broken,
+ * ignore it" survives a re-scan.
+ *
+ * ASCII-only.
+ */
+export const WIRING_FILE_VERSION = 1;
+export function emptyWiringFile(project_slug) {
+    return {
+        version: WIRING_FILE_VERSION,
+        project_slug,
+        scanned_at: new Date(0).toISOString(),
+        scanned_sha: '',
+        hooks: [],
+    };
+}
+/** Heuristic checks the caller can run before invoking discover so
+ *  the system prompt does not advertise wiring when none was
+ *  detected. */
+export function hasActiveHooks(file) {
+    return file.hooks.some((h) => !h.disabled);
+}
+//# sourceMappingURL=types.js.map

package/dist/wiring/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/wiring/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AA2DrC,MAAM,UAAU,eAAe,CAAC,YAAoB;IAClD,OAAO;QACL,OAAO,EAAE,mBAAmB;QAC5B,YAAY;QACZ,UAAU,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;QACrC,WAAW,EAAE,EAAE;QACf,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC;AAED;;gBAEgB;AAChB,MAAM,UAAU,cAAc,CAAC,IAAgB;IAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAC7C,CAAC"}

package/dist/workflow/config.d.ts

@@ -0,0 +1,43 @@
+import { type WorkflowDef, type WorkflowKind } from './definitions.js';
+export interface WorkflowConfigFile {
+    version: number;
+    workflows: Record<WorkflowKind, WorkflowDef>;
+}
+export declare function workflowConfigPath(projectRoot: string): string;
+/** The immutable code default, deep-cloned so callers cannot mutate it. */
+export declare function defaultWorkflowConfig(): WorkflowConfigFile;
+export declare function isValidWorkflowConfig(x: unknown): x is WorkflowConfigFile;
+/** Load the active config: project JSON when valid, else the code
+ *  default (the file may be missing or hand-broken -- never throw). */
+export declare function loadWorkflowConfig(projectRoot: string): Promise<WorkflowConfigFile>;
+/** Write the code default to the project (+ the DR snapshot) the first
+ *  time a project needs a config. Idempotent: never clobbers an
+ *  existing active config. */
+export declare function seedWorkflowConfigIfMissing(projectRoot: string): Promise<void>;
+/** Disaster recovery: restore the active config from the on-disk default
+ *  snapshot, or from the code default when no snapshot exists. */
+export declare function resetWorkflowConfig(projectRoot: string): Promise<WorkflowConfigFile>;
+export interface WorkflowConfigPatch {
+    /** Replace the FULL definition for one or more kinds. Arrays replace
+     *  (they are not deep-merged) so "set corrective's stages to X" is
+     *  unambiguous. Omitted kinds are left untouched. */
+    workflows?: Partial<Record<WorkflowKind, WorkflowDef>>;
+}
+/** Apply a validated patch + persist. Backs up the default first so the
+ *  edit is always reversible. Throws (without writing) when the result
+ *  would be an invalid config -- the active file stays intact. */
+export declare function applyWorkflowConfigPatch(projectRoot: string, patch: WorkflowConfigPatch): Promise<WorkflowConfigFile>;
+/** Resolve one kind's definition from the active config. */
+export declare function resolveWorkflowDef(projectRoot: string, kind: WorkflowKind): Promise<WorkflowDef>;
+/** Flat ordered list of {stage_id, step} for a kind, from the active
+ *  config. This is the task list the orchestrator turns into pendings. */
+export declare function resolveOrderedTasks(projectRoot: string, kind: WorkflowKind): Promise<Array<{
+    stage_id: string;
+    stage_title: string;
+    step_id: string;
+    title: string;
+    content: string;
+    gate: boolean;
+    order: number;
+}>>;
+//# sourceMappingURL=config.d.ts.map

package/dist/workflow/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/workflow/config.ts"],"names":[],"mappings":"AAuBA,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAI1B,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;CAC9C;AAKD,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE9D;AAKD,2EAA2E;AAC3E,wBAAgB,qBAAqB,IAAI,kBAAkB,CAK1D;AAmCD,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,kBAAkB,CAOzE;AAID;uEACuE;AACvE,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAOzF;AASD;;8BAE8B;AAC9B,wBAAsB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOpF;AAUD;kEACkE;AAClE,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAS1F;AAID,MAAM,WAAW,mBAAmB;IAClC;;yDAEqD;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC;CACxD;AAED;;kEAEkE;AAClE,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAC9C,OAAO,CAAC,kBAAkB,CAAC,CAgB7B;AAED,4DAA4D;AAC5D,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAGtG;AAED;0EAC0E;AAC1E,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GACtC,OAAO,CAAC,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAe1I"}

package/dist/workflow/config.js

@@ -0,0 +1,199 @@
+/**
+ * Workflow config -- user-editable phases/tasks per project (PND-094 ext).
+ *
+ * The canonical stage/task definitions in `definitions.ts` are the
+ * IMMUTABLE DEFAULT (disaster-recovery source). A project may override
+ * them with an editable JSON that Forge writes on request:
+ *
+ *   <projectRoot>/.forge/workflow-config.json          (editable, active)
+ *   <projectRoot>/.forge/workflow-config.default.json  (DR snapshot)
+ *
+ * Resolution order: project JSON -> code default. (The worker-canonical
+ * layer plugs in later via definitions_client, same as doctrines.)
+ *
+ * Determinism: loading, validating, seeding, patching + restoring are
+ * pure file ops. The ONLY non-deterministic touch is upstream -- an LLM
+ * turning a natural-language "add a QA stage" request into the `patch`
+ * object. The patch is schema-validated and the default is always
+ * recoverable, so a bad edit can never brick the workflow.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { WORKFLOW_DEFINITIONS, WORKFLOW_DEFINITIONS_VERSION, } from './definitions.js';
+const KINDS = ['greenfield', 'corrective', 'evolutive'];
+function forgeDir(projectRoot) {
+    return path.join(projectRoot, '.forge');
+}
+export function workflowConfigPath(projectRoot) {
+    return path.join(forgeDir(projectRoot), 'workflow-config.json');
+}
+function defaultBackupPath(projectRoot) {
+    return path.join(forgeDir(projectRoot), 'workflow-config.default.json');
+}
+/** The immutable code default, deep-cloned so callers cannot mutate it. */
+export function defaultWorkflowConfig() {
+    return {
+        version: WORKFLOW_DEFINITIONS_VERSION,
+        workflows: structuredClone(WORKFLOW_DEFINITIONS),
+    };
+}
+/* ----- validation ----- */
+function isStringField(o, k) {
+    return typeof o[k] === 'string' && o[k].length > 0;
+}
+function isValidDef(x, kind) {
+    if (!x || typeof x !== 'object')
+        return false;
+    const d = x;
+    if (d.kind !== kind)
+        return false;
+    if (!isStringField(d, 'title') || !isStringField(d, 'whenToUse'))
+        return false;
+    if (!Array.isArray(d.stages) || d.stages.length === 0)
+        return false;
+    const stageIds = new Set();
+    for (const st of d.stages) {
+        if (!st || typeof st !== 'object')
+            return false;
+        const s = st;
+        if (!isStringField(s, 'id') || !isStringField(s, 'title') || !isStringField(s, 'purpose'))
+            return false;
+        if (stageIds.has(s.id))
+            return false; /* duplicate stage id */
+        stageIds.add(s.id);
+        if (!Array.isArray(s.steps) || s.steps.length === 0)
+            return false;
+        const stepIds = new Set();
+        for (const stp of s.steps) {
+            if (!stp || typeof stp !== 'object')
+                return false;
+            const p = stp;
+            if (!isStringField(p, 'id') || !isStringField(p, 'title') || !isStringField(p, 'content'))
+                return false;
+            if (stepIds.has(p.id))
+                return false; /* duplicate step id within a workflow */
+            stepIds.add(p.id);
+            if ('gate' in p && typeof p.gate !== 'boolean')
+                return false;
+        }
+    }
+    return true;
+}
+export function isValidWorkflowConfig(x) {
+    if (!x || typeof x !== 'object')
+        return false;
+    const c = x;
+    if (typeof c.version !== 'number')
+        return false;
+    if (!c.workflows || typeof c.workflows !== 'object')
+        return false;
+    const w = c.workflows;
+    return KINDS.every((k) => isValidDef(w[k], k));
+}
+/* ----- load / seed / restore ----- */
+/** Load the active config: project JSON when valid, else the code
+ *  default (the file may be missing or hand-broken -- never throw). */
+export async function loadWorkflowConfig(projectRoot) {
+    try {
+        const raw = await fs.readFile(workflowConfigPath(projectRoot), 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (isValidWorkflowConfig(parsed))
+            return parsed;
+    }
+    catch { /* missing / malformed -> default */ }
+    return defaultWorkflowConfig();
+}
+async function writeJson(file, value) {
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    const tmp = file + '.tmp';
+    await fs.writeFile(tmp, JSON.stringify(value, null, 2), { encoding: 'utf-8', mode: 0o600 });
+    await fs.rename(tmp, file);
+}
+/** Write the code default to the project (+ the DR snapshot) the first
+ *  time a project needs a config. Idempotent: never clobbers an
+ *  existing active config. */
+export async function seedWorkflowConfigIfMissing(projectRoot) {
+    const active = workflowConfigPath(projectRoot);
+    let exists = false;
+    try {
+        await fs.access(active);
+        exists = true;
+    }
+    catch { /* missing */ }
+    const def = defaultWorkflowConfig();
+    if (!exists)
+        await writeJson(active, def);
+    await ensureDefaultBackup(projectRoot, def);
+}
+/** Keep an immutable on-disk snapshot of the code default so a user can
+ *  always recover after an edit. Written once. */
+async function ensureDefaultBackup(projectRoot, def) {
+    const backup = defaultBackupPath(projectRoot);
+    try {
+        await fs.access(backup);
+        return;
+    }
+    catch { /* needs writing */ }
+    await writeJson(backup, def ?? defaultWorkflowConfig());
+}
+/** Disaster recovery: restore the active config from the on-disk default
+ *  snapshot, or from the code default when no snapshot exists. */
+export async function resetWorkflowConfig(projectRoot) {
+    let restore = defaultWorkflowConfig();
+    try {
+        const raw = await fs.readFile(defaultBackupPath(projectRoot), 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (isValidWorkflowConfig(parsed))
+            restore = parsed;
+    }
+    catch { /* no snapshot -> code default */ }
+    await writeJson(workflowConfigPath(projectRoot), restore);
+    return restore;
+}
+/** Apply a validated patch + persist. Backs up the default first so the
+ *  edit is always reversible. Throws (without writing) when the result
+ *  would be an invalid config -- the active file stays intact. */
+export async function applyWorkflowConfigPatch(projectRoot, patch) {
+    const cur = await loadWorkflowConfig(projectRoot);
+    const next = {
+        version: cur.version,
+        workflows: { ...cur.workflows },
+    };
+    for (const k of KINDS) {
+        const replacement = patch.workflows?.[k];
+        if (replacement !== undefined)
+            next.workflows[k] = replacement;
+    }
+    if (!isValidWorkflowConfig(next)) {
+        throw new Error('workflow config patch rejected: result is not a valid config (check kind/stage/step ids + required fields)');
+    }
+    await ensureDefaultBackup(projectRoot);
+    await writeJson(workflowConfigPath(projectRoot), next);
+    return next;
+}
+/** Resolve one kind's definition from the active config. */
+export async function resolveWorkflowDef(projectRoot, kind) {
+    const cfg = await loadWorkflowConfig(projectRoot);
+    return cfg.workflows[kind];
+}
+/** Flat ordered list of {stage_id, step} for a kind, from the active
+ *  config. This is the task list the orchestrator turns into pendings. */
+export async function resolveOrderedTasks(projectRoot, kind) {
+    const def = await resolveWorkflowDef(projectRoot, kind);
+    const out = [];
+    let order = 0;
+    for (const stage of def.stages) {
+        for (const step of stage.steps) {
+            out.push({
+                stage_id: stage.id, stage_title: stage.title,
+                step_id: step.id, title: step.title, content: step.content,
+                gate: step.gate === true, order,
+            });
+            order += 1;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=config.js.map

package/dist/workflow/config.js.map

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

package/dist/workflow/definitions.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Workflow definitions (PND-094).
+ *
+ * Forge formalises THREE workflow kinds instead of forcing the
+ * 18-step greenfield methodology onto every project:
+ *
+ *   greenfield  -- a new app from zero: the canonical 6 phases /
+ *                  18 steps.
+ *   corrective  -- fix a defect in a LIVE project: compact, root-
+ *                  cause first, MUST refresh the affected docs.
+ *   evolutive   -- enhance/extend a LIVE project: compact, design
+ *                  first, MUST refresh the affected docs.
+ *
+ * These literals are the LOCAL definitions. They double as the
+ * offline fallback for the worker-synced canonical steps (see
+ * workflow_definitions_client.ts) -- same pattern as doctrines +
+ * lessons: worker is the source of truth, this is the fallback so
+ * Forge keeps working offline.
+ *
+ * Pablo's directives (2026-06-10): workflows are LOCAL per project,
+ * canonical steps come from the worker; Forge asks + decides
+ * corrective vs evolutive; each project logs the workflow evolution
+ * (stage + step start/end/content) to a doc.
+ *
+ * ASCII-only.
+ */
+export type WorkflowKind = 'greenfield' | 'corrective' | 'evolutive';
+export interface WorkflowStepDef {
+    /** Stable id, kebab-case, unique within the workflow. */
+    id: string;
+    /** Short human title. */
+    title: string;
+    /** What this step produces / the question it answers. */
+    content: string;
+    /** True when this step needs the owner's explicit OK (a gate). */
+    gate?: boolean;
+}
+export interface WorkflowStageDef {
+    id: string;
+    title: string;
+    /** Why this stage exists. */
+    purpose: string;
+    steps: WorkflowStepDef[];
+}
+export interface WorkflowDef {
+    kind: WorkflowKind;
+    title: string;
+    /** One line on when Forge should pick this workflow. */
+    whenToUse: string;
+    stages: WorkflowStageDef[];
+}
+/** Bump when the canonical structure changes so the worker sync can
+ *  reconcile versions (worker payload carries its own version). */
+export declare const WORKFLOW_DEFINITIONS_VERSION = 1;
+export declare const WORKFLOW_DEFINITIONS: Record<WorkflowKind, WorkflowDef>;
+/** All step ids of a workflow, in order (stage by stage). */
+export declare function workflowStepIds(kind: WorkflowKind): string[];
+/** Total step count for a workflow kind. */
+export declare function workflowStepCount(kind: WorkflowKind): number;
+//# sourceMappingURL=definitions.d.ts.map

package/dist/workflow/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/workflow/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,WAAW,CAAC;AAErE,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IACX,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED;mEACmE;AACnE,eAAO,MAAM,4BAA4B,IAAI,CAAC;AA8I9C,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,YAAY,EAAE,WAAW,CAIlE,CAAC;AAEF,6DAA6D;AAC7D,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,EAAE,CAE5D;AAED,4CAA4C;AAC5C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAE5D"}