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

package/dist/workflow/definitions.js

@@ -0,0 +1,178 @@
+/**
+ * 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.
+ */
+/** Bump when the canonical structure changes so the worker sync can
+ *  reconcile versions (worker payload carries its own version). */
+export const WORKFLOW_DEFINITIONS_VERSION = 1;
+/* ---------------- greenfield: 6 phases / 18 steps ---------------- */
+const GREENFIELD = {
+    kind: 'greenfield',
+    title: 'Desarrollo de app nueva (6 fases / 18 pasos)',
+    whenToUse: 'El proyecto se construye desde cero (no hay implementacion previa en el directorio).',
+    stages: [
+        {
+            id: 'i-discovery', title: 'I. Triage e intencion',
+            purpose: 'Entender que se pide, el peso del proyecto y el terreno.',
+            steps: [
+                { id: 'triage', title: 'Triage de tier', content: 'Clasificar simple/medium/full con su justificacion.' },
+                { id: 'vault-inventory', title: 'Inventario del vault', content: 'Que secretos/credenciales necesita el proyecto.' },
+                { id: 'intent', title: 'Intencion', content: 'Modo, plataforma, interaccion, distribucion. (Si hubiera legacy, auditarlo aca -- paso 3.5, no aplica en greenfield.)' },
+            ],
+        },
+        {
+            id: 'ii-clarification', title: 'II. Clarificacion',
+            purpose: 'Cerrar el funcional + los NFR + descomponer en bloques.',
+            steps: [
+                { id: 'functional', title: 'Funcional', content: 'Persona, north-star, MVP.' },
+                { id: 'nfr-quantitative', title: 'NFR cuantitativo', content: 'Volumetria, paralelismo, presupuesto.' },
+                { id: 'nfr-structural', title: 'NFR estructural', content: 'Persistencia, middleware, workers.' },
+                { id: 'nfr-governance', title: 'NFR governance', content: 'Compliance, secretos, RBAC.' },
+                { id: 'nfr-operational', title: 'NFR operacional', content: 'i18n, a11y, monitoreo, navegadores.' },
+                { id: 'blocks', title: 'Bloques', content: 'Descomponer el MVP en bloques implementables.' },
+            ],
+        },
+        {
+            id: 'iii-specification', title: 'III. Especificacion',
+            purpose: 'Producir los entregables: RFP, arquitectura, diseno.',
+            steps: [
+                { id: 'rfp', title: 'RFP/SPEC', content: 'El contrato funcional del producto.' },
+                { id: 'architecture', title: 'Arquitectura', content: 'Como se construye: piezas + conexiones.' },
+                { id: 'design', title: 'Diseno de solucion', content: 'Decisiones de experiencia + interfaz.' },
+            ],
+        },
+        {
+            id: 'iv-approval', title: 'IV. Aprobacion',
+            purpose: 'El owner aprueba antes de construir.',
+            steps: [
+                { id: 'gate-13', title: 'Gate 13', content: 'OK explicito del owner sobre RFP + arquitectura + diseno.', gate: true },
+            ],
+        },
+        {
+            id: 'v-construction', title: 'V. Construccion',
+            purpose: 'Bootstrap + desarrollo por bloques con tests (testing-policy: tests post-implementacion, scaffold gate verde).',
+            steps: [
+                { id: 'bootstrap', title: 'Bootstrap', content: 'Stack, scaffolding, CI gates.' },
+                { id: 'block-dev', title: 'Desarrollo por bloques', content: 'Implementar cada bloque (codigo + tests verdes antes de scaffold).' },
+            ],
+        },
+        {
+            id: 'vi-delivery', title: 'VI. Entrega',
+            purpose: 'Manuales, despliegue, post-lanzamiento e iteracion.',
+            steps: [
+                { id: 'manuals', title: 'Manuales', content: 'Generar DOS entregables derivados de TODAS las funcionalidades del codigo (no stubs): (1) MANUAL DE IMPLEMENTACION -- arquitectura, decisiones, stack, build/deploy y como extender, para que otro dev retome el proyecto; (2) MANUAL DE USUARIO completo -- cada feature real, paso a paso. Guardar en docs/ del proyecto.' },
+                { id: 'deploy', title: 'Deploy', content: 'QA visual + publicar (npm/hosting) con los gates verdes.' },
+                { id: 'postlaunch', title: 'Post-lanzamiento', content: 'Metricas, handoff, monitoreo post-deploy.' },
+                { id: 'iterate', title: 'Iteracion', content: 'Cambios post-lanzamiento; aca el proyecto suele pasar al flujo correctivo/evolutivo.' },
+            ],
+        },
+    ],
+};
+/* ---------------- maintenance: corrective + evolutive ----------------
+ * Compact 6-stage flow for LIVE projects. The two kinds share the
+ * shape; stage II differs (root-cause vs design) and the triage
+ * records which kind it is. BOTH require the docs refresh stage. */
+function maintenanceDef(kind) {
+    const corrective = kind === 'corrective';
+    return {
+        kind,
+        title: corrective
+            ? 'Correctivo (arreglar un defecto en un proyecto vivo)'
+            : 'Evolutivo (extender/mejorar un proyecto vivo)',
+        whenToUse: corrective
+            ? 'El proyecto ya existe y hay que ARREGLAR un comportamiento roto.'
+            : 'El proyecto ya existe y hay que AGREGAR o MEJORAR funcionalidad.',
+        stages: [
+            {
+                id: 'm-triage', title: 'I. Triage',
+                purpose: 'Clasificar el pedido y acotar el alcance.',
+                steps: [
+                    { id: 'classify', title: 'Clasificar', content: 'Confirmar correctivo vs evolutivo + el peso del cambio.' },
+                    { id: 'register', title: 'Registrar', content: 'Alta del pedido en el pending registry (request-lifecycle micro).' },
+                ],
+            },
+            {
+                id: 'm-locate', title: corrective ? 'II. Reproducir + causa raiz' : 'II. Diseno del cambio',
+                purpose: corrective
+                    ? 'Reproducir el defecto y localizar la causa raiz en el codigo/grafo.'
+                    : 'Decidir como encaja el cambio en la arquitectura existente.',
+                steps: corrective
+                    ? [
+                        { id: 'reproduce', title: 'Reproducir', content: 'Confirmar el bug con un caso minimo (idealmente un test rojo).' },
+                        { id: 'root-cause', title: 'Causa raiz', content: 'Leer codigo + grafo; identificar la causa, no el sintoma.' },
+                    ]
+                    : [
+                        { id: 'fit', title: 'Encaje', content: 'Como se integra en la arquitectura/diseno actual (mini-spec).' },
+                        { id: 'impact', title: 'Impacto', content: 'Que modulos/docs/contratos toca el cambio.' },
+                    ],
+            },
+            {
+                id: 'm-change', title: 'III. Implementar',
+                purpose: 'Aplicar el cambio en el codigo.',
+                steps: [
+                    { id: 'implement', title: 'Implementar', content: corrective ? 'Aplicar la correccion sobre la causa raiz.' : 'Construir la mejora.' },
+                ],
+            },
+            {
+                id: 'm-validate', title: 'IV. Validar (ciclo iterativo)',
+                purpose: 'Probar; si falla o se puede mejorar, corregir y re-validar hasta converger.',
+                steps: [
+                    { id: 'validate', title: 'Validar', content: 'Tests/checks verdes; el caso reproducido ahora pasa. Loguear cada iteracion (pending.note).' },
+                ],
+            },
+            {
+                id: 'm-docs', title: 'V. Actualizar documentacion',
+                purpose: 'Mantener la docu al dia -- requisito explicito del flujo de mantenimiento.',
+                steps: [
+                    { id: 'docs', title: 'Refrescar docs', content: 'Actualizar README/ARCHITECTURE/DESIGN, el grafo, y las secciones afectadas del MANUAL DE IMPLEMENTACION + MANUAL DE USUARIO segun lo que cambio. No dejar deriva.' },
+                ],
+            },
+            {
+                id: 'm-close', title: 'VI. Cerrar',
+                purpose: 'Entregar y dejar registro.',
+                steps: [
+                    { id: 'commit', title: 'Commit', content: 'Commit con el porque; referenciar el PND.' },
+                    { id: 'close', title: 'Cerrar + log', content: 'Cerrar el pending con resolution (history) y registrar la evolucion del wfl.' },
+                ],
+            },
+        ],
+    };
+}
+const CORRECTIVE = maintenanceDef('corrective');
+const EVOLUTIVE = maintenanceDef('evolutive');
+export const WORKFLOW_DEFINITIONS = {
+    greenfield: GREENFIELD,
+    corrective: CORRECTIVE,
+    evolutive: EVOLUTIVE,
+};
+/** All step ids of a workflow, in order (stage by stage). */
+export function workflowStepIds(kind) {
+    return WORKFLOW_DEFINITIONS[kind].stages.flatMap((s) => s.steps.map((st) => st.id));
+}
+/** Total step count for a workflow kind. */
+export function workflowStepCount(kind) {
+    return workflowStepIds(kind).length;
+}
+//# sourceMappingURL=definitions.js.map

package/dist/workflow/definitions.js.map

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

package/dist/workflow/definitions_client.d.ts

@@ -0,0 +1,12 @@
+import { type WorkflowDef, type WorkflowKind } from './definitions.js';
+/** Resolve a workflow definition for a kind. Worker first (cached
+ *  5 min), local fallback on any miss/failure. `source` says where
+ *  it came from so the caller can be honest about it. */
+export declare function loadWorkflowDef(kind: WorkflowKind, opts?: {
+    fetchImpl?: typeof fetch;
+}): Promise<{
+    def: WorkflowDef;
+    version: number;
+    source: 'worker' | 'cache' | 'local';
+}>;
+//# sourceMappingURL=definitions_client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"definitions_client.d.ts","sourceRoot":"","sources":["../../src/workflow/definitions_client.ts"],"names":[],"mappings":"AAuBA,OAAO,EAEL,KAAK,WAAW,EAAE,KAAK,YAAY,EACpC,MAAM,kBAAkB,CAAC;AAgC1B;;yDAEyD;AACzD,wBAAsB,eAAe,CACnC,IAAI,EAAE,YAAY,EAClB,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO,GACtC,OAAO,CAAC;IAAE,GAAG,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAA;CAAE,CAAC,CA6BtF"}

package/dist/workflow/definitions_client.js

@@ -0,0 +1,81 @@
+/**
+ * Canonical workflow definitions client (PND-094 part b).
+ *
+ * Pablo's directive: workflows are LOCAL per project, but the
+ * CANONICAL steps are imported from the general worker. Same pattern
+ * as learnings_client.ts / the doctrines: worker is the source of
+ * truth, the local definitions (definitions.ts) are the offline
+ * fallback so Forge keeps working when the worker is unreachable.
+ *
+ * Today there is no worker endpoint yet, so every call resolves to
+ * the local fallback. The structure is in place: when the worker
+ * stands up GET /v1/workflows/<kind>, the same definitions just flow
+ * from there (versioned) without touching callers.
+ *
+ * Cache: ~/.yujin-forge/cache/workflows.json, 5-min TTL, same as
+ * lessons/doctrines.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { homedir } from 'node:os';
+import { VERSION } from '../version.js';
+import { WORKFLOW_DEFINITIONS, WORKFLOW_DEFINITIONS_VERSION, } from './definitions.js';
+const CACHE_TTL_MS = 5 * 60 * 1000;
+const STALE_TTL_MS = 24 * 60 * 60 * 1000;
+function cacheFile() {
+    return path.join(homedir(), '.yujin-forge', 'cache', 'workflows.json');
+}
+function workerBaseUrl() {
+    return process.env.YUJIN_WORKER_URL
+        || process.env.YF_WORKER_URL
+        || 'https://yujin-hito4.yujinapp.workers.dev';
+}
+async function readCache() {
+    try {
+        return JSON.parse(await fs.readFile(cacheFile(), 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+async function writeCache(c) {
+    try {
+        await fs.mkdir(path.dirname(cacheFile()), { recursive: true });
+        await fs.writeFile(cacheFile(), JSON.stringify(c, null, 2), 'utf-8');
+    }
+    catch { /* best-effort */ }
+}
+/** Resolve a workflow definition for a kind. Worker first (cached
+ *  5 min), local fallback on any miss/failure. `source` says where
+ *  it came from so the caller can be honest about it. */
+export async function loadWorkflowDef(kind, opts = {}) {
+    const local = WORKFLOW_DEFINITIONS[kind];
+    const cached = await readCache();
+    const fresh = cached && Date.now() - cached.fetched_at < CACHE_TTL_MS;
+    if (fresh && cached.payload[kind]) {
+        return { def: cached.payload[kind].def, version: cached.payload[kind].version, source: 'cache' };
+    }
+    const fetchImpl = opts.fetchImpl ?? fetch;
+    const url = workerBaseUrl() + '/v1/workflows/' + kind;
+    try {
+        const r = await fetchImpl(url, { headers: { 'x-yf-cli-version': VERSION } });
+        if (r.ok) {
+            const body = await r.json();
+            if (body && body.ok && body.def && typeof body.version === 'number') {
+                const payload = (cached?.payload ?? {});
+                payload[kind] = { version: body.version, def: body.def };
+                await writeCache({ fetched_at: Date.now(), payload });
+                return { def: body.def, version: body.version, source: 'worker' };
+            }
+        }
+    }
+    catch { /* fall through to fallback */ }
+    /* Worker unreachable / no endpoint yet -> stale cache, then local. */
+    if (cached && Date.now() - cached.fetched_at < STALE_TTL_MS && cached.payload[kind]) {
+        return { def: cached.payload[kind].def, version: cached.payload[kind].version, source: 'cache' };
+    }
+    return { def: local, version: WORKFLOW_DEFINITIONS_VERSION, source: 'local' };
+}
+//# sourceMappingURL=definitions_client.js.map

package/dist/workflow/definitions_client.js.map

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

package/dist/workflow/evolution.d.ts

@@ -0,0 +1,10 @@
+import { type WorkflowEvolutionEntry } from './state.js';
+export declare const EVOLUTION_DOC_REL: string;
+/** Append a workflow evolution entry to BOTH the project doc and the
+ *  machine-readable mirror in yujin.forge.json. Returns the doc path
+ *  (absolute) written. */
+export declare function logWorkflowEvent(projectRoot: string, entry: WorkflowEvolutionEntry): Promise<{
+    doc_path: string;
+    entries: number;
+}>;
+//# sourceMappingURL=evolution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evolution.d.ts","sourceRoot":"","sources":["../../src/workflow/evolution.ts"],"names":[],"mappings":"AAgBA,OAAO,EAA+B,KAAK,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEtF,eAAO,MAAM,iBAAiB,QAAuC,CAAC;AAyBtE;;0BAE0B;AAC1B,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBhD"}

package/dist/workflow/evolution.js

@@ -0,0 +1,62 @@
+/**
+ * Workflow evolution log (PND-094).
+ *
+ * Pablo's directive: each project documents the EVOLUTION of its
+ * workflow in a doc -- steps + stages with start / end / content.
+ *
+ * Two sinks, written together so they never drift:
+ *   1. docs/WORKFLOW_LOG.md  -- human-readable markdown table,
+ *      committed with the project (the auditable record).
+ *   2. yujin.forge.json workflow.evolution[] -- machine-readable
+ *      mirror for the panel / tooling.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { readWorkflow, writeWorkflow } from './state.js';
+export const EVOLUTION_DOC_REL = path.join('docs', 'WORKFLOW_LOG.md');
+const DOC_HEADER = [
+    '# Workflow evolution',
+    '',
+    'Registro automatico de la evolucion del workflow del proyecto',
+    '(PND-094). Cada fila es una transicion: inicio/fin de etapa o de',
+    'paso, con su contenido. No editar a mano -- Forge lo mantiene.',
+    '',
+    '| Fecha (UTC) | Workflow | Etapa | Paso | Evento | Contenido |',
+    '|---|---|---|---|---|---|',
+    '',
+].join('\n');
+function cell(v) {
+    return (v ?? '').replace(/\|/g, '/').replace(/\n+/g, ' ').trim();
+}
+function row(e) {
+    return '| ' + [
+        cell(e.at), cell(e.kind), cell(e.stage_title || e.stage_id),
+        cell(e.step_title || e.step_id || '-'), cell(e.event), cell(e.content || ''),
+    ].join(' | ') + ' |\n';
+}
+/** Append a workflow evolution entry to BOTH the project doc and the
+ *  machine-readable mirror in yujin.forge.json. Returns the doc path
+ *  (absolute) written. */
+export async function logWorkflowEvent(projectRoot, entry) {
+    /* 1. Markdown doc. */
+    const docAbs = path.join(projectRoot, EVOLUTION_DOC_REL);
+    let existing = '';
+    try {
+        existing = await fs.readFile(docAbs, 'utf-8');
+    }
+    catch { /* new doc */ }
+    if (!existing.includes('| Fecha (UTC) |')) {
+        existing = DOC_HEADER;
+    }
+    await fs.mkdir(path.dirname(docAbs), { recursive: true });
+    await fs.writeFile(docAbs, existing.replace(/\n*$/, '\n') + row(entry), 'utf-8');
+    /* 2. Machine mirror. */
+    const wf = await readWorkflow(projectRoot);
+    const list = Array.isArray(wf.evolution) ? wf.evolution.slice() : [];
+    list.push(entry);
+    await writeWorkflow(projectRoot, { evolution: list });
+    return { doc_path: docAbs, entries: list.length };
+}
+//# sourceMappingURL=evolution.js.map

package/dist/workflow/evolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evolution.js","sourceRoot":"","sources":["../../src/workflow/evolution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,aAAa,EAA+B,MAAM,YAAY,CAAC;AAEtF,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAEtE,MAAM,UAAU,GAAG;IACjB,sBAAsB;IACtB,EAAE;IACF,+DAA+D;IAC/D,kEAAkE;IAClE,gEAAgE;IAChE,EAAE;IACF,gEAAgE;IAChE,2BAA2B;IAC3B,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,SAAS,IAAI,CAAC,CAAqB;IACjC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACnE,CAAC;AAED,SAAS,GAAG,CAAC,CAAyB;IACpC,OAAO,IAAI,GAAG;QACZ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,QAAQ,CAAC;QAC3D,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;KAC7E,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;AACzB,CAAC;AAED;;0BAE0B;AAC1B,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAmB,EACnB,KAA6B;IAE7B,sBAAsB;IACtB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;IACzD,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,CAAC;QAAC,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;IAC9E,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC1C,QAAQ,GAAG,UAAU,CAAC;IACxB,CAAC;IACD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;IAEjF,wBAAwB;IACxB,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjB,MAAM,aAAa,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;AACpD,CAAC"}

package/dist/workflow/graph.d.ts

@@ -0,0 +1,59 @@
+/**
+ * src/workflow/graph.ts -- Director sprint slice 7.
+ *
+ * Pure transformer that takes the current `WorkflowState` and
+ * returns a {nodes, edges} shape the panel SVG (and any future
+ * consumer: CLI ASCII rendering, audit log, BPMN export) can
+ * render without re-implementing the 18-step model.
+ *
+ * The transformer mirrors the 6-phase taxonomy from
+ * `phase_inference.ts`:
+ *
+ *   phase_i   -- triage / intent / audits
+ *   phase_ii  -- clarification (functional + 4 NFR + blocks plan)
+ *   phase_iii -- specs (RFP + Arch + Design + approvals)
+ *   phase_iv  -- bootstrap
+ *   phase_v   -- block implementation (per blocks_progress)
+ *   phase_vi  -- deploy + postlaunch
+ *
+ * Status derivation:
+ *  - active phase = `inferActivePhase()`
+ *  - phases before active = 'done'
+ *  - active phase = 'active' UNLESS the project is fully closed,
+ *    in which case phase_vi flips from 'active' to 'done'.
+ *  - phases after active = 'pending'
+ *
+ * Step counts are granular per phase (4/6/6/1/N/2) so callers
+ * can render a progress chip. `step_done_count` never exceeds
+ * `step_count`. Phase V step count defaults to 1 when no blocks
+ * have been planned yet (placeholder slot for UI sizing).
+ *
+ * Labels are i18n keys (`workflow.phase.<phase>`) -- never raw
+ * text. The consumer resolves them at render time per locale.
+ *
+ * ASCII-only.
+ */
+import type { WorkflowState } from './state.js';
+import { type WorkflowPhase } from './phase_inference.js';
+export type WorkflowGraphNodeStatus = 'pending' | 'active' | 'done';
+export interface WorkflowGraphNode {
+    id: WorkflowPhase;
+    /** i18n catalog key -- `workflow.phase.i`..`workflow.phase.vi`. */
+    label_i18n_key: string;
+    status: WorkflowGraphNodeStatus;
+    /** Total atomic steps inside the phase (constant per phase, or
+     *  derived for phase_v from blocks_progress.length). */
+    step_count: number;
+    /** How many of those steps have a recorded closure milestone. */
+    step_done_count: number;
+}
+export interface WorkflowGraphEdge {
+    from: WorkflowPhase;
+    to: WorkflowPhase;
+}
+export interface WorkflowGraph {
+    nodes: WorkflowGraphNode[];
+    edges: WorkflowGraphEdge[];
+}
+export declare function buildWorkflowGraph(state: WorkflowState | undefined | null): WorkflowGraph;
+//# sourceMappingURL=graph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/workflow/graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE5E,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAiB,aAAa,CAAC;IACjC,mEAAmE;IACnE,cAAc,EAAK,MAAM,CAAC;IAC1B,MAAM,EAAa,uBAAuB,CAAC;IAC3C;4DACwD;IACxD,UAAU,EAAS,MAAM,CAAC;IAC1B,iEAAiE;IACjE,eAAe,EAAI,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAI,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAeD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,GAAG,aAAa,CAiCzF"}

package/dist/workflow/graph.js

@@ -0,0 +1,137 @@
+import { inferActivePhase } from './phase_inference.js';
+const PHASES = [
+    'phase_i', 'phase_ii', 'phase_iii', 'phase_iv', 'phase_v', 'phase_vi',
+];
+const PHASE_LABEL_KEYS = {
+    phase_i: 'workflow.phase.i',
+    phase_ii: 'workflow.phase.ii',
+    phase_iii: 'workflow.phase.iii',
+    phase_iv: 'workflow.phase.iv',
+    phase_v: 'workflow.phase.v',
+    phase_vi: 'workflow.phase.vi',
+};
+export function buildWorkflowGraph(state) {
+    const wf = state || {};
+    const active = inferActivePhase(wf);
+    const allDone = isFullyClosed(wf);
+    const nodes = PHASES.map((phase) => {
+        const idx = PHASES.indexOf(phase);
+        const activeIdx = PHASES.indexOf(active);
+        const counts = countSteps(phase, wf);
+        let status;
+        if (allDone) {
+            status = 'done';
+        }
+        else if (idx < activeIdx) {
+            status = 'done';
+        }
+        else if (idx === activeIdx) {
+            status = 'active';
+        }
+        else {
+            status = 'pending';
+        }
+        return {
+            id: phase,
+            label_i18n_key: PHASE_LABEL_KEYS[phase],
+            status,
+            step_count: counts.total,
+            step_done_count: counts.done,
+        };
+    });
+    const edges = [];
+    for (let i = 0; i < PHASES.length - 1; i++) {
+        edges.push({ from: PHASES[i], to: PHASES[i + 1] });
+    }
+    return { nodes, edges };
+}
+function countSteps(phase, wf) {
+    switch (phase) {
+        case 'phase_i': {
+            const total = 4;
+            let done = 0;
+            if (wf.tier)
+                done += 1;
+            if (wf.intent?.decided_at)
+                done += 1;
+            if (wf.legacy_audit?.ran_at)
+                done += 1;
+            if (wf.vault_inventory?.ran_at)
+                done += 1;
+            return { total, done };
+        }
+        case 'phase_ii': {
+            const total = 6;
+            const c = wf.clarification || {};
+            let done = 0;
+            const rounds = [
+                c.functional, c.nfr_quantitative, c.nfr_structural,
+                c.nfr_governance, c.nfr_operational,
+            ];
+            for (const r of rounds) {
+                if (r && r.done_at)
+                    done += 1;
+            }
+            if (c.blocks?.done_at)
+                done += 1;
+            return { total, done };
+        }
+        case 'phase_iii': {
+            const total = 6;
+            const s = wf.specs || {};
+            const a = wf.approvals || {};
+            let done = 0;
+            if (s.rfp?.done_at)
+                done += 1;
+            if (s.arch?.done_at)
+                done += 1;
+            if (s.design?.done_at)
+                done += 1;
+            if (a.rfp?.approved_at)
+                done += 1;
+            if (a.arch?.approved_at)
+                done += 1;
+            if (a.design?.approved_at)
+                done += 1;
+            return { total, done };
+        }
+        case 'phase_iv': {
+            const total = 1;
+            const done = wf.bootstrap?.done_at ? 1 : 0;
+            return { total, done };
+        }
+        case 'phase_v': {
+            const blocks = wf.blocks_progress || [];
+            if (blocks.length === 0) {
+                /* Placeholder slot so the UI reserves a chip for the phase
+                 * even before block planning materialises. */
+                return { total: 1, done: 0 };
+            }
+            const done = blocks.filter((b) => b.status === 'green').length;
+            return { total: blocks.length, done };
+        }
+        case 'phase_vi': {
+            const total = 2;
+            let done = 0;
+            if (wf.deploy?.done_at)
+                done += 1;
+            if (wf.postlaunch?.manual_at)
+                done += 1;
+            return { total, done };
+        }
+    }
+}
+function isFullyClosed(wf) {
+    /* Project is fully closed when phase_vi has its closure
+     * milestones (deploy.done_at + postlaunch.manual_at). Mirrors
+     * the inferActivePhase return-of-phase_vi terminal case. */
+    const deployed = !!wf.deploy?.done_at;
+    const postlaunchD = !!wf.postlaunch?.manual_at;
+    if (!deployed || !postlaunchD)
+        return false;
+    /* Also require everything upstream so a stray deploy on top of
+     * an unfinished phase_v does not falsely mark the project done. */
+    const upstreamActive = inferActivePhase(wf);
+    return upstreamActive === 'phase_vi';
+}
+//# sourceMappingURL=graph.js.map

package/dist/workflow/graph.js.map

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

package/dist/workflow/instances.d.ts

@@ -0,0 +1,40 @@
+import type { WorkflowKind } from './definitions.js';
+export interface WorkflowInstanceStage {
+    id: string;
+    title: string;
+}
+export interface WorkflowInstance {
+    /** Auto code, e.g. "WFL-001". Never reused. */
+    code: string;
+    /** Human name, derived from the request or set by the user. */
+    name: string;
+    kind: WorkflowKind;
+    status: 'open' | 'closed';
+    opened_at: number;
+    closed_at?: number;
+    /** Stage skeleton for the card view (tasks are pendings, not here). */
+    stages: WorkflowInstanceStage[];
+}
+export interface WorkflowInstancesFile {
+    version: 1;
+    project_slug: string;
+    next_code: number;
+    instances: WorkflowInstance[];
+}
+export declare function emptyInstancesFile(slug: string): WorkflowInstancesFile;
+export declare function formatWflCode(n: number): string;
+export declare function readInstances(slug: string): Promise<WorkflowInstancesFile>;
+export declare function writeInstances(file: WorkflowInstancesFile): Promise<void>;
+export interface CreateInstanceInput {
+    kind: WorkflowKind;
+    name: string;
+    stages: WorkflowInstanceStage[];
+}
+export declare function createInstance(slug: string, input: CreateInstanceInput): Promise<WorkflowInstance>;
+export declare function findInstance(slug: string, code: string): Promise<WorkflowInstance | undefined>;
+export declare function listInstances(slug: string, status?: 'open' | 'closed' | 'all'): Promise<WorkflowInstance[]>;
+/** Find an OPEN instance by name (case-insensitive) -- used to attach a
+ *  new request to an existing initiative instead of opening a duplicate. */
+export declare function findOpenByName(slug: string, name: string): Promise<WorkflowInstance | undefined>;
+export declare function closeInstance(slug: string, code: string): Promise<WorkflowInstance | undefined>;
+//# sourceMappingURL=instances.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../src/workflow/instances.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,CAAC,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAsBD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,CAEtE;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAchF;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAO/E;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAcxG;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAIpG;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAOjH;AAED;4EAC4E;AAC5E,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAKtG;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CASrG"}