@nac3/forge-cli 0.2.0-alpha.9 → 0.2.1-alpha.60

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/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"}

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"}