@nac3/forge-cli 0.2.1-alpha.60 → 1.0.1

package/dist/workflow/multi_view.d.ts

@@ -0,0 +1,27 @@
+import type { WorkflowKind } from './definitions.js';
+export interface WorkflowTaskView {
+    id: string;
+    title: string;
+    closed: boolean;
+    order: number;
+    ad_hoc: boolean;
+    category?: string;
+}
+export interface WorkflowStageTasksView {
+    id: string;
+    title: string;
+    tasks: WorkflowTaskView[];
+}
+export interface WorkflowCardView {
+    code: string;
+    name: string;
+    kind: WorkflowKind;
+    status: 'open' | 'closed';
+    done: number;
+    total: number;
+    stages: WorkflowStageTasksView[];
+}
+/** Build the per-workflow card views (stages -> ordered tasks) for a
+ *  project. Best-effort: a missing store yields an empty list. */
+export declare function computeWorkflowsView(slug: string, status?: 'open' | 'all'): Promise<WorkflowCardView[]>;
+//# sourceMappingURL=multi_view.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"multi_view.d.ts","sourceRoot":"","sources":["../../src/workflow/multi_view.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AACD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,sBAAsB,EAAE,CAAC;CAClC;AAOD;kEACkE;AAClE,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,GAAG,KAAc,GAC5C,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA8C7B"}

package/dist/workflow/multi_view.js

@@ -0,0 +1,76 @@
+/**
+ * Multi-workflow view (PND-094 ext).
+ *
+ * The old computeWorkflowView produced ONE workflow from the legacy
+ * WorkflowState. The new model has several coexisting WorkflowInstances
+ * whose TASKS are pendings (linked via PendingItem.workflow). This
+ * crosses the instances with their task-pendings to produce, per
+ * workflow, its stages each with its ordered tasks -- the structure both
+ * the desktop panel and the mobile board render.
+ *
+ * ASCII-only.
+ */
+import { listInstances } from './instances.js';
+import { listPending } from '../pending/store.js';
+function stripCode(code, title) {
+    const p = '[' + code + '] ';
+    return title.startsWith(p) ? title.slice(p.length) : title;
+}
+/** Build the per-workflow card views (stages -> ordered tasks) for a
+ *  project. Best-effort: a missing store yields an empty list. */
+export async function computeWorkflowsView(slug, status = 'open') {
+    let instances;
+    try {
+        instances = await listInstances(slug, status === 'all' ? 'all' : 'open');
+    }
+    catch {
+        return [];
+    }
+    if (instances.length === 0)
+        return [];
+    let allPend;
+    try {
+        allPend = await listPending(slug, { status: 'all' });
+    }
+    catch {
+        allPend = [];
+    }
+    const out = [];
+    for (const inst of instances) {
+        const tasks = allPend.filter((p) => p.workflow?.code === inst.code);
+        const byStage = new Map();
+        for (const t of tasks) {
+            const w = t.workflow;
+            const tv = {
+                id: t.id,
+                title: stripCode(inst.code, t.title),
+                closed: t.closed_at !== undefined,
+                order: w.order,
+                ad_hoc: w.ad_hoc === true,
+                ...(t.category ? { category: t.category } : {}),
+            };
+            const arr = byStage.get(w.stage_id) ?? [];
+            arr.push(tv);
+            byStage.set(w.stage_id, arr);
+        }
+        const stages = inst.stages.map((s) => ({
+            id: s.id, title: s.title,
+            tasks: (byStage.get(s.id) ?? []).sort((a, b) => a.order - b.order),
+        }));
+        /* Ad-hoc tasks may use a stage_id that is not in the instance
+         * skeleton -- surface them under their own stage so nothing is lost. */
+        const known = new Set(inst.stages.map((s) => s.id));
+        for (const [sid, arr] of byStage) {
+            if (!known.has(sid))
+                stages.push({ id: sid, title: sid, tasks: arr.sort((a, b) => a.order - b.order) });
+        }
+        out.push({
+            code: inst.code, name: inst.name, kind: inst.kind, status: inst.status,
+            done: tasks.filter((t) => t.closed_at !== undefined).length,
+            total: tasks.length,
+            stages,
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=multi_view.js.map

package/dist/workflow/multi_view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi_view.js","sourceRoot":"","sources":["../../src/workflow/multi_view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AA0BlD,SAAS,SAAS,CAAC,IAAY,EAAE,KAAa;IAC5C,MAAM,CAAC,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;IAC5B,OAAO,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC7D,CAAC;AAED;kEACkE;AAClE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAY,EAAE,SAAyB,MAAM;IAE7C,IAAI,SAAoD,CAAC;IACzD,IAAI,CAAC;QAAC,SAAS,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAAC,CAAC;IACjF,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC;IAAC,CAAC;IACpB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEtC,IAAI,OAAgD,CAAC;IACrD,IAAI,CAAC;QAAC,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAAC,CAAC;IAC7D,MAAM,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;IAAC,CAAC;IAEvB,MAAM,GAAG,GAAuB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,OAAO,GAAG,IAAI,GAAG,EAA8B,CAAC;QACtD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,CAAC,CAAC,QAAS,CAAC;YACtB,MAAM,EAAE,GAAqB;gBAC3B,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC;gBACpC,MAAM,EAAE,CAAC,CAAC,SAAS,KAAK,SAAS;gBACjC,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,MAAM,EAAE,CAAC,CAAC,MAAM,KAAK,IAAI;gBACzB,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAChD,CAAC;YACF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC1C,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC/B,CAAC;QACD,MAAM,MAAM,GAA6B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/D,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK;YACxB,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SACnE,CAAC,CAAC,CAAC;QACJ;gFACwE;QACxE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACpD,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1G,CAAC;QACD,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM;YACtE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,MAAM;YAC3D,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/workflow/orchestrator.d.ts

@@ -0,0 +1,111 @@
+import { type WorkflowInstance } from './instances.js';
+import type { WorkflowKind } from './definitions.js';
+import type { PendingItem, PendingCategory } from '../pending/types.js';
+/** True when the project already has an implementation. Pure fs scan:
+ *  a package.json / known source dir, or >3 real top-level entries. */
+export declare function projectHasCode(projectRoot: string): Promise<boolean>;
+export interface ClassifyResult {
+    kind: WorkflowKind;
+    confidence: number;
+    rationale: string;
+    /** True when confidence is low -- the caller must ASK the user
+     *  (decision: on doubt, confirm). */
+    needs_confirm: boolean;
+}
+export declare function classifyForProject(projectRoot: string, requestText: string): Promise<ClassifyResult>;
+export interface InstantiateInput {
+    slug: string;
+    projectRoot: string;
+    kind: WorkflowKind;
+    name: string;
+}
+export interface InstantiateResult {
+    instance: WorkflowInstance;
+    tasks: PendingItem[];
+}
+/** Create a workflow instance + spawn one pending per canonical task,
+ *  in mandatory order. Seeds the editable config (+ DR snapshot) first. */
+export declare function instantiateWorkflow(input: InstantiateInput): Promise<InstantiateResult>;
+/** Spawn ONE pending per canonical task of the instance's kind, in
+ *  mandatory order, linked to the given EXISTING instance. The primitive
+ *  shared by instantiateWorkflow and by upgrading a backlog-only shell so
+ *  every phase gets its canonical scaffold (triage/diseno/.../cerrar). */
+export declare function seedCanonicalTasks(slug: string, projectRoot: string, instance: WorkflowInstance): Promise<PendingItem[]>;
+/** Create a workflow instance WITHOUT spawning canonical task pendings.
+ *  Used when the tasks already exist (a backlog folded into a brownfield
+ *  workflow via attachPendingsToWorkflow). */
+export declare function createWorkflowShell(input: InstantiateInput): Promise<WorkflowInstance>;
+/** Fold EXISTING pendings into a workflow as its tasks, in the given
+ *  order (default: the order they are passed). Each gets a workflow
+ *  link with a sequential `order` after any tasks already on the
+ *  instance. Skips ids that do not exist. Returns the linked items. */
+export declare function attachPendingsToWorkflow(input: {
+    slug: string;
+    code: string;
+    ids: string[];
+    stage_id?: string;
+}): Promise<PendingItem[]>;
+export interface RouteInput {
+    slug: string;
+    projectRoot: string;
+    kind: WorkflowKind;
+    name: string;
+}
+/** Find an OPEN instance with the same name (same initiative) or create
+ *  a new one. Coexistence: instances are keyed by code + name, so two
+ *  distinct initiatives of the same kind run side by side. */
+export declare function routeRequest(input: RouteInput): Promise<{
+    instance: WorkflowInstance;
+    created: boolean;
+}>;
+export interface MapHookResult {
+    created: boolean;
+    kind?: WorkflowKind;
+    code?: string;
+    name?: string;
+    reason: string;
+}
+/** On mapping a project, ensure the RIGHT workflow exists -- deterministic,
+ *  no LLM. greenfield (no code) -> instantiate the build skeleton (tasks
+ *  spawned). brownfield (has code) -> an evolutive maintenance workflow
+ *  WITH its canonical tasks per phase (triage/diseno/implementar/validar/
+ *  docs/cerrar) spawned, so every phase has its canonical scaffold and no
+ *  phase looks empty; ad-hoc backlog items attach under Implementar.
+ *  Idempotent: a no-op when the project already has an open workflow, so
+ *  it is safe to call on every scan/add. Best-effort -- callers must not
+ *  let it break the map. */
+export declare function ensureWorkflowForMappedProject(slug: string, projectRoot: string, projectName?: string): Promise<MapHookResult>;
+export interface AddTaskInput {
+    slug: string;
+    code: string;
+    title: string;
+    body?: string;
+    category?: PendingCategory;
+    stage_id?: string;
+    priority?: number;
+}
+/** Append a task to a running workflow at the END of its order. Used
+ *  for corrective/evolutive tasks the user adds at discretion during a
+ *  workflow, AND for tasks the brain decides to add mid-execution. */
+export declare function addTaskToWorkflow(input: AddTaskInput): Promise<PendingItem>;
+/** All task-pendings of a workflow, sorted by mandatory order. */
+export declare function workflowTasks(slug: string, code: string, status?: 'open' | 'closed' | 'all'): Promise<PendingItem[]>;
+/** The next task to work: the open task with the lowest order. */
+export declare function nextTask(slug: string, code: string): Promise<PendingItem | undefined>;
+export interface OrderGateResult {
+    ok: boolean;
+    /** When !ok, the earlier-order open task that blocks this close. */
+    blocked_by?: {
+        id: string;
+        title: string;
+        order: number;
+    };
+}
+/** Mandatory ordering gate: a task may not close while an EARLIER-order
+ *  task in the same workflow is still open. Non-workflow items always
+ *  pass. The caller may override explicitly (force). */
+export declare function canCloseTask(slug: string, id: string): Promise<OrderGateResult>;
+/** After a task closes: if every task of its workflow is now closed,
+ *  auto-close the instance. Returns the closed instance when it closed. */
+export declare function onWorkflowTaskClosed(slug: string, code: string): Promise<WorkflowInstance | undefined>;
+//# sourceMappingURL=orchestrator.d.ts.map

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

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

package/dist/workflow/orchestrator.js

@@ -0,0 +1,241 @@
+/**
+ * Workflow orchestrator (PND-094 ext) -- DETERMINISTIC, no LLM.
+ *
+ * Ties the three layers together with plain code:
+ *   - config.ts       -- the editable stage/task definitions (+ DR).
+ *   - instances.ts    -- the running workflow instances (coexisting).
+ *   - pending store   -- the tasks (stages are NOT pendings; tasks are).
+ *
+ * What this module does, all deterministically:
+ *   - classify a request (greenfield vs corrective vs evolutive) +
+ *     flag when confidence is low so the caller ASKS the user.
+ *   - instantiate a workflow: create the instance + spawn ONE pending
+ *     per canonical task, in mandatory `order`.
+ *   - add a task to a running workflow (user OR brain, ad-hoc).
+ *   - enforce mandatory ordering on close (a task cannot close while an
+ *     earlier-order task in the same workflow is still open).
+ *   - auto-close the instance when all its tasks are closed.
+ *
+ * The LLM is NOT in this loop. It only does the WORK inside each task
+ * and (separately) translates NL config-edit requests into a patch.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import { classifyWorkflowKind } from './select.js';
+import { resolveOrderedTasks, seedWorkflowConfigIfMissing } from './config.js';
+import { createInstance, findInstance, findOpenByName, closeInstance, } from './instances.js';
+import { resolveWorkflowDef } from './config.js';
+import { addPending, listPending, } from '../pending/store.js';
+/* ----- project code detection (deterministic heuristic) ----- */
+const CODE_DIR_HINTS = ['src', 'app', 'lib', 'components', 'packages', 'pages'];
+const IGNORE_ENTRIES = new Set(['.forge', '.git', '.github', 'node_modules', 'docs', 'dist', 'build']);
+/** True when the project already has an implementation. Pure fs scan:
+ *  a package.json / known source dir, or >3 real top-level entries. */
+export async function projectHasCode(projectRoot) {
+    try {
+        const entries = await fs.readdir(projectRoot, { withFileTypes: true });
+        if (entries.some((e) => e.isFile() && e.name === 'package.json'))
+            return true;
+        if (entries.some((e) => e.isDirectory() && CODE_DIR_HINTS.includes(e.name)))
+            return true;
+        const real = entries.filter((e) => !e.name.startsWith('.') && !IGNORE_ENTRIES.has(e.name)
+            && !/^readme/i.test(e.name) && !/^license/i.test(e.name));
+        return real.length > 3;
+    }
+    catch {
+        return false;
+    }
+}
+const CONFIRM_THRESHOLD = 0.6;
+export async function classifyForProject(projectRoot, requestText) {
+    const hasExistingCode = await projectHasCode(projectRoot);
+    const r = classifyWorkflowKind({ text: requestText, hasExistingCode });
+    return { ...r, needs_confirm: r.confidence < CONFIRM_THRESHOLD };
+}
+/* ----- task <-> pending mapping ----- */
+function taskCategory(gate) {
+    /* A gate task needs the owner's explicit OK; everything else Sumi can
+     * pick up unsupervised. */
+    return gate ? 'user_blocked' : 'autopilot';
+}
+function taskPriority(order) {
+    /* Cluster workflow tasks together + keep them in order in the normal
+     * pending list (priority asc). */
+    return Math.min(100, 20 + order);
+}
+/** Create a workflow instance + spawn one pending per canonical task,
+ *  in mandatory order. Seeds the editable config (+ DR snapshot) first. */
+export async function instantiateWorkflow(input) {
+    await seedWorkflowConfigIfMissing(input.projectRoot);
+    const def = await resolveWorkflowDef(input.projectRoot, input.kind);
+    const instance = await createInstance(input.slug, {
+        kind: input.kind,
+        name: input.name,
+        stages: def.stages.map((s) => ({ id: s.id, title: s.title })),
+    });
+    const tasks = await seedCanonicalTasks(input.slug, input.projectRoot, instance);
+    return { instance, tasks };
+}
+/** Spawn ONE pending per canonical task of the instance's kind, in
+ *  mandatory order, linked to the given EXISTING instance. The primitive
+ *  shared by instantiateWorkflow and by upgrading a backlog-only shell so
+ *  every phase gets its canonical scaffold (triage/diseno/.../cerrar). */
+export async function seedCanonicalTasks(slug, projectRoot, instance) {
+    const orderedTasks = await resolveOrderedTasks(projectRoot, instance.kind);
+    const tasks = [];
+    for (const t of orderedTasks) {
+        const add = {
+            title: '[' + instance.code + '] ' + t.title,
+            body: t.content,
+            category: taskCategory(t.gate),
+            priority: taskPriority(t.order),
+            workflow: { code: instance.code, kind: instance.kind, stage_id: t.stage_id, order: t.order },
+            ...(t.gate ? { blocker_kind: 'user_decision', blocker_who: 'pablo' } : {}),
+        };
+        tasks.push(await addPending(slug, add));
+    }
+    return tasks;
+}
+/** Create a workflow instance WITHOUT spawning canonical task pendings.
+ *  Used when the tasks already exist (a backlog folded into a brownfield
+ *  workflow via attachPendingsToWorkflow). */
+export async function createWorkflowShell(input) {
+    await seedWorkflowConfigIfMissing(input.projectRoot);
+    const def = await resolveWorkflowDef(input.projectRoot, input.kind);
+    return createInstance(input.slug, {
+        kind: input.kind,
+        name: input.name,
+        stages: def.stages.map((s) => ({ id: s.id, title: s.title })),
+    });
+}
+/** Fold EXISTING pendings into a workflow as its tasks, in the given
+ *  order (default: the order they are passed). Each gets a workflow
+ *  link with a sequential `order` after any tasks already on the
+ *  instance. Skips ids that do not exist. Returns the linked items. */
+export async function attachPendingsToWorkflow(input) {
+    const inst = await findInstance(input.slug, input.code);
+    if (!inst)
+        throw new Error('attachPendingsToWorkflow: unknown workflow ' + input.code);
+    const existing = await workflowTasks(input.slug, input.code, 'all');
+    let order = existing.reduce((m, t) => Math.max(m, t.workflow?.order ?? -1), -1) + 1;
+    const stage_id = input.stage_id ?? inst.stages[0]?.id ?? 'stage';
+    const { setPendingWorkflow, findPending } = await import('../pending/store.js');
+    const out = [];
+    for (const id of input.ids) {
+        const found = await findPending(input.slug, id);
+        if (!found)
+            continue;
+        /* Attached backlog items are INDEPENDENT (not canonical sequential
+         * steps), so they are ad_hoc -> exempt from the ordering gate. */
+        const linked = await setPendingWorkflow(input.slug, id, {
+            code: inst.code, kind: inst.kind, stage_id, order, ad_hoc: true,
+        });
+        out.push(linked);
+        order += 1;
+    }
+    return out;
+}
+/** Find an OPEN instance with the same name (same initiative) or create
+ *  a new one. Coexistence: instances are keyed by code + name, so two
+ *  distinct initiatives of the same kind run side by side. */
+export async function routeRequest(input) {
+    const existing = await findOpenByName(input.slug, input.name);
+    if (existing && existing.kind === input.kind)
+        return { instance: existing, created: false };
+    const { instance } = await instantiateWorkflow(input);
+    return { instance, created: true };
+}
+/** On mapping a project, ensure the RIGHT workflow exists -- deterministic,
+ *  no LLM. greenfield (no code) -> instantiate the build skeleton (tasks
+ *  spawned). brownfield (has code) -> an evolutive maintenance workflow
+ *  WITH its canonical tasks per phase (triage/diseno/implementar/validar/
+ *  docs/cerrar) spawned, so every phase has its canonical scaffold and no
+ *  phase looks empty; ad-hoc backlog items attach under Implementar.
+ *  Idempotent: a no-op when the project already has an open workflow, so
+ *  it is safe to call on every scan/add. Best-effort -- callers must not
+ *  let it break the map. */
+export async function ensureWorkflowForMappedProject(slug, projectRoot, projectName) {
+    const { listInstances } = await import('./instances.js');
+    const open = await listInstances(slug, 'open');
+    if (open.length > 0) {
+        return { created: false, reason: 'ya hay un workflow abierto (' + open[0].code + ')' };
+    }
+    const label = (projectName && projectName.trim()) || slug;
+    const hasCode = await projectHasCode(projectRoot);
+    if (hasCode) {
+        const { instance } = await instantiateWorkflow({ slug, projectRoot, kind: 'evolutive', name: label + ' -- mantenimiento' });
+        return { created: true, kind: 'evolutive', code: instance.code, name: instance.name, reason: 'brownfield (el proyecto ya tiene codigo) -> workflow evolutivo con tareas canonicas por fase' };
+    }
+    const { instance } = await instantiateWorkflow({ slug, projectRoot, kind: 'greenfield', name: label + ' -- build' });
+    return { created: true, kind: 'greenfield', code: instance.code, name: instance.name, reason: 'greenfield (sin codigo) -> skeleton de 18 pasos' };
+}
+/** Append a task to a running workflow at the END of its order. Used
+ *  for corrective/evolutive tasks the user adds at discretion during a
+ *  workflow, AND for tasks the brain decides to add mid-execution. */
+export async function addTaskToWorkflow(input) {
+    const inst = await findInstance(input.slug, input.code);
+    if (!inst)
+        throw new Error('addTaskToWorkflow: unknown workflow ' + input.code);
+    if (inst.status !== 'open')
+        throw new Error('addTaskToWorkflow: workflow ' + input.code + ' is closed');
+    const tasks = await workflowTasks(input.slug, input.code, 'all');
+    const nextOrder = tasks.reduce((m, t) => Math.max(m, t.workflow?.order ?? 0), -1) + 1;
+    const stage_id = input.stage_id ?? inst.stages[inst.stages.length - 1]?.id ?? 'ad-hoc';
+    return addPending(input.slug, {
+        title: '[' + inst.code + '] ' + input.title,
+        ...(input.body ? { body: input.body } : {}),
+        category: input.category ?? 'autopilot',
+        priority: input.priority ?? taskPriority(nextOrder),
+        workflow: { code: inst.code, kind: inst.kind, stage_id, order: nextOrder, ad_hoc: true },
+    });
+}
+/* ----- queries + gates ----- */
+/** All task-pendings of a workflow, sorted by mandatory order. */
+export async function workflowTasks(slug, code, status = 'all') {
+    const all = await listPending(slug, { status });
+    return all
+        .filter((p) => p.workflow?.code === code)
+        .sort((a, b) => (a.workflow.order - b.workflow.order));
+}
+/** The next task to work: the open task with the lowest order. */
+export async function nextTask(slug, code) {
+    const open = await workflowTasks(slug, code, 'open');
+    return open[0];
+}
+/** Mandatory ordering gate: a task may not close while an EARLIER-order
+ *  task in the same workflow is still open. Non-workflow items always
+ *  pass. The caller may override explicitly (force). */
+export async function canCloseTask(slug, id) {
+    const all = await listPending(slug, { status: 'all' });
+    const item = all.find((p) => p.id === id);
+    if (!item || !item.workflow)
+        return { ok: true };
+    /* ad_hoc tasks (folded-in backlog items) are INDEPENDENT -- they are
+     * never gated, and they never block a canonical step either. The gate
+     * applies only among the canonical sequential steps. */
+    if (item.workflow.ad_hoc)
+        return { ok: true };
+    const earlierOpen = all
+        .filter((p) => p.workflow?.code === item.workflow.code
+        && p.closed_at === undefined
+        && !p.workflow.ad_hoc
+        && (p.workflow.order < item.workflow.order))
+        .sort((a, b) => a.workflow.order - b.workflow.order)[0];
+    if (earlierOpen) {
+        return { ok: false, blocked_by: { id: earlierOpen.id, title: earlierOpen.title, order: earlierOpen.workflow.order } };
+    }
+    return { ok: true };
+}
+/** After a task closes: if every task of its workflow is now closed,
+ *  auto-close the instance. Returns the closed instance when it closed. */
+export async function onWorkflowTaskClosed(slug, code) {
+    const open = await workflowTasks(slug, code, 'open');
+    if (open.length > 0)
+        return undefined;
+    const all = await workflowTasks(slug, code, 'all');
+    if (all.length === 0)
+        return undefined; /* nothing to close on */
+    return closeInstance(slug, code);
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/workflow/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../src/workflow/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EACL,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,GAE5D,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,UAAU,EAAE,WAAW,GACxB,MAAM,qBAAqB,CAAC;AAG7B,kEAAkE;AAElE,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AAChF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEvG;uEACuE;AACvE,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAAmB;IACtD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACvE,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC;YAAE,OAAO,IAAI,CAAC;QAC9E,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACzF,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;eACpF,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AAC3B,CAAC;AAaD,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,WAAmB,EAAE,WAAmB;IAC/E,MAAM,eAAe,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;IAC1D,MAAM,CAAC,GAAG,oBAAoB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC,CAAC;IACvE,OAAO,EAAE,GAAG,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,UAAU,GAAG,iBAAiB,EAAE,CAAC;AACnE,CAAC;AAED,0CAA0C;AAE1C,SAAS,YAAY,CAAC,IAAa;IACjC;+BAC2B;IAC3B,OAAO,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC;AAC7C,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC;sCACkC;IAClC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,KAAK,CAAC,CAAC;AACnC,CAAC;AAgBD;2EAC2E;AAC3E,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAuB;IAC/D,MAAM,2BAA2B,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,GAAG,GAAgB,MAAM,kBAAkB,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAEjF,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE;QAChD,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;KAC9D,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAChF,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;;0EAG0E;AAC1E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EAAE,WAAmB,EAAE,QAA0B;IAE7D,MAAM,YAAY,GAAG,MAAM,mBAAmB,CAAC,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAoB;YAC3B,KAAK,EAAE,GAAG,GAAG,QAAQ,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK;YAC3C,IAAI,EAAE,CAAC,CAAC,OAAO;YACf,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;YAC9B,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC;YAC/B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE;YAC5F,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,eAAwB,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpF,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,MAAM,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;8CAE8C;AAC9C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAuB;IAC/D,MAAM,2BAA2B,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,GAAG,GAAgB,MAAM,kBAAkB,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACjF,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE;QAChC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;KAC9D,CAAC,CAAC;AACL,CAAC;AAED;;;uEAGuE;AACvE,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAAuE;IAEvE,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IACvF,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACpE,IAAI,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACpF,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,OAAO,CAAC;IACjE,MAAM,EAAE,kBAAkB,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAChF,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB;0EACkE;QAClE,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE;YACtD,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI;SAChE,CAAC,CAAC;QACH,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjB,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAWD;;8DAE8D;AAC9D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAiB;IAClD,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9D,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;QAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5F,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACtD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACrC,CAAC;AAYD;;;;;;;;4BAQ4B;AAC5B,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,IAAY,EAAE,WAAmB,EAAE,WAAoB;IAEvD,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,8BAA8B,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC;IAC1F,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC;IAC1D,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;IAClD,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,mBAAmB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,GAAG,mBAAmB,EAAE,CAAC,CAAC;QAC5H,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,8FAA8F,EAAE,CAAC;IAChM,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,mBAAmB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,GAAG,WAAW,EAAE,CAAC,CAAC;IACrH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,iDAAiD,EAAE,CAAC;AACpJ,CAAC;AAcD;;sEAEsE;AACtE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAmB;IACzD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAChF,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC;IACxG,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACtF,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,IAAI,QAAQ,CAAC;IACvF,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE;QAC5B,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC,KAAK;QAC3C,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,WAAW;QACvC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,YAAY,CAAC,SAAS,CAAC;QACnD,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE;KACzF,CAAC,CAAC;AACL,CAAC;AAED,iCAAiC;AAEjC,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,IAAY,EAAE,SAAoC,KAAK;IACvG,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAChD,OAAO,GAAG;SACP,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,KAAK,IAAI,CAAC;SACxC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAS,CAAC,KAAK,GAAG,CAAC,CAAC,QAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAY,EAAE,IAAY;IACvD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC;AAQD;;wDAEwD;AACxD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,EAAU;IACzD,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACjD;;4DAEwD;IACxD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IAC9C,MAAM,WAAW,GAAG,GAAG;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,KAAK,IAAI,CAAC,QAAS,CAAC,IAAI;WAClD,CAAC,CAAC,SAAS,KAAK,SAAS;WACzB,CAAC,CAAC,CAAC,QAAS,CAAC,MAAM;WACnB,CAAC,CAAC,CAAC,QAAS,CAAC,KAAK,GAAG,IAAI,CAAC,QAAS,CAAC,KAAK,CAAC,CAAC;SAC/C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAS,CAAC,KAAK,GAAG,CAAC,CAAC,QAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,CAAC,QAAS,CAAC,KAAK,EAAE,EAAE,CAAC;IACzH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED;2EAC2E;AAC3E,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY,EAAE,IAAY;IACnE,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACrD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACtC,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACnD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC,CAAC,yBAAyB;IACjE,OAAO,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC"}

package/docs/doctrine/default-design-system.md

@@ -118,3 +118,35 @@ yujin-design-system/
 - **Director**: when the user explicitly requests an override
   ("use shadcn"), invokes `yujin.design.override` instead of
   silently accepting. The R8 modal confirms.
+
+## Variants -- selectable design systems (PND-112)
+
+The Yujin DS ships in two variants. The sumi-e one is the
+DEFAULT; the art deco one is opt-in per product / panel.
+
+- **`yujin-design-system`** (default) -- sumi-e aesthetic:
+  indigo/teal/amber tones, 170 sumi-e icons, kanji wordmarks.
+- **`yujin-design-system-artdeco`** -- pastel art deco: powder
+  blues + warm slate grays + creams + a sparing brass rule,
+  Poiret One / Josefin Sans typography, 48 geometric art deco
+  icons. NO kanji, NO sumi-e. Crisper geometry (radii 2/4/8).
+
+Both expose the SAME semantic token contract (`--color-accent`,
+`--color-bg-*`, `--color-text-*`, `--color-border-*`, state
+colors) and SHARE the same 30 components (theme-agnostic --
+they consume `var(--color-*)`), so picking a variant is purely
+a token + icon swap, never a component rewrite.
+
+Selection: the resolver (`src/design/yujin_design_resolver.ts`)
+takes a `ds` selector on every reader (`getManifest({ds})`,
+`getTokensCss({ds})`, `listIcons(tag,{ds})`, `getIconSvg`,
+`listTemplates`, `getTemplate`). `ds: 'artdeco'` -> the pastel
+variant; absent / `'sumie'` / `'default'` -> the sumi-e default.
+`getTokensCss({ds})` returns the theme CSS a generated product
+or the panel injects to apply the look.
+
+When a product should use the art deco look (signals: "art
+deco", "pastel", "elegante geometrico", "sin kanjis", "estetica
+clasica/dorada"), select the artdeco variant; otherwise keep the
+sumi-e default. The icon catalog of the SELECTED variant is the
+only one to pull from (no mixing sets).

package/docs/doctrine/office-tools.md

@@ -100,3 +100,23 @@ similar. The verbs are cross-platform; no shell needed.
   the doc is long.
 - Pair `office.*.write` with R8 modal (policy=approval-required;
   user confirms before disk write).
+
+## Opening vs reading (desktop.open vs office.*.read)
+
+There are TWO different intents -- pick by what the user wants:
+
+- **OPEN / SHOW it to the user** ("abri la planilla", "open this Excel",
+  "show me the doc") -> `desktop.open({target})`. It launches the file
+  in its native app (.xlsx -> Excel, .docx -> Word, .pdf -> the viewer)
+  or, for a Google Sheets/Docs URL or a `.gsheet`/`.gdoc` shortcut, in
+  the browser. This is the right move when the human wants to SEE it.
+
+- **READ / COMPUTE over the data** ("what's the total", "extract the
+  rows", "summarize the doc") -> `office.excel.read` / `office.word.read`
+  / `office.pdf.read`. These return structured data for YOU to reason
+  over.
+
+NEVER open a binary office file as a pizarron editor tab
+(`forge_open_file_for_editor` / fs.read-file): the bytes render as
+noise and FREEZE the panel (PND-102). The open-file verb now refuses
+office/binary extensions and points here.

package/docs/doctrine/pizarron.md

@@ -50,3 +50,43 @@ R7 -- HONEST SEQUENCING (anti-hallucination cont.):
           then yujin.git.commit. Three chained invokes. Your chat
           reply summarises the 3 actions AFTER all 3 returned
           result_ok=true.
+
+KIND SELECTION (MANDATORY) -- choose the create-tab kind BEFORE
+you invoke. This is a hard rule (invariant level, like R1-R8);
+do NOT improvise. Map the request to a kind by this table:
+
+  | Request words / intent                              | kind  |
+  |-----------------------------------------------------|-------|
+  | Flow / flujo / flowchart / proceso / circuito /     | bpmn  |
+  |   "los pasos de X" / diagrama de proceso / BPMN     |       |
+  | Relaciones / dependencias / "que usa que" / grafo   | graph |
+  |   del proyecto / nodos sin orden                    |       |
+  | Documento / reporte / spec / analisis / diseño /    | doc   |
+  |   arquitectura / propuesta / how-to                 |       |
+  | Codigo fuente                                       | code  |
+  | Datos tabulares                                     | table |
+
+  PROHIBITED: kind="graph" for a process/flow. The graph is for
+  relations/dependencies WITHOUT order; a flow has a start, an
+  end and ordered steps.
+
+  Tie-breaker (bpmn vs graph): does the thing have a START and an
+  END and ordered STEPS / decisions? -> bpmn. Is it a web of
+  relations with no inherent order? -> graph.
+
+  bpmn content shape (JSON string):
+    {"lanes":[{"id","label"}]            (optional swimlanes),
+     "nodes":[{"id","type","label","lane"?,"gateway"?}],
+     "flows":[{"from","to","label"?}]}
+    type in startEvent | endEvent | intermediate | task |
+      userTask | serviceTask | scriptTask | sendTask |
+      receiveTask | gateway
+    gateway in exclusive | parallel | inclusive
+
+  graph content shape (JSON string):
+    {"nodes":[{"id","label","weight"?,"kind"?,"detail"?}],
+     "edges":[{"from","to","kind"?,"label"?}]}
+
+Anti-pattern this prevents (see docs/GOTCHAS.md): rendering a
+business flow with kind="graph". The user asks for a FLUJO and
+gets a force-directed node web instead of a BPMN diagram.

package/docs/doctrine/verb-composition.md

@@ -59,6 +59,22 @@ In those cases, invoke `yujin.shell.exec` directly. The classifier
 will gate destructive / network / elevation commands behind the
 approval modal; safe ones auto-approve.
 
+## Long-running commands -> yujin.task.run (MANDATORY)
+
+`yujin.shell.exec` runs SYNCHRONOUSLY: it blocks the turn and the
+child process is killed when the turn ends. So a command that does NOT
+terminate on its own -- a dev server, a watcher, `tail -f`, a tunnel
+(`npm/pnpm run dev|start|serve|watch`, `expo start`, `vite`,
+`next dev`, `nodemon`, `wrangler dev`, `docker compose up`,
+`cloudflared tunnel`, ...) -- MUST be launched with `yujin.task.run`,
+which runs it detached so it SURVIVES the turn. Follow it with
+`yujin.task.status` / `yujin.task.list`; the user stops or deletes it
+from the Tareas tab in the pizarron.
+
+shell.exec ENFORCES this: it refuses such commands and points you to
+`yujin.task.run` (error `long_running_must_use_task`). Only pass
+`allow_long_running:true` in the rare case you truly need it in-turn.
+
 ## When to fetch this doctrine
 
 Fetch when: