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

package/dist/qa/brain_matrix/types.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Brain matrix QA harness -- shared types.
+ *
+ * The harness runs a Scenario (a recipe: setup state + N turns +
+ * invariants) against N brains (provider+model pairs) and
+ * reports pass/fail per (scenario, brain) cell.
+ *
+ * Each Turn either:
+ *  - sends a `user_input` to the LLM and captures the response, or
+ *  - mocks a `tool_result` for a prior tool_use the LLM emitted
+ *    (multi-turn flows that would otherwise call real handlers).
+ *
+ * Invariants run AFTER the last turn, against the captured
+ * transcript. They are small, named, parameterised predicates.
+ *
+ * ASCII-only.
+ */
+import type { Nac3Verb } from '../../nac3/internal_manifest.js';
+export type BrainProvider = 'anthropic' | 'google_ai' | 'openai' | 'deepseek' | 'xai' | 'mistral' | 'cohere' | 'yujin_managed' | 'fake';
+export interface BrainConfig {
+    /** Stable id used in reports + filtering, e.g. "claude-sonnet-4-6". */
+    id: string;
+    provider: BrainProvider;
+    model: string;
+    tier: 'eco' | 'frontier';
+    /** Vault slot whose value is passed to the provider client.
+     *  When provider='fake', api_key is taken from `scripted` map
+     *  inline. */
+    vault_slot?: string;
+    /** Brain notes (e.g. "released 2026-04", "$0.10/1M in"). */
+    notes?: string;
+    /** Skip in default runs. Useful for slow or expensive brains. */
+    skip_default?: boolean;
+}
+/** Mocked workflow + graph state injected into the system prompt
+ *  for THIS scenario. The harness builds the prompt from these
+ *  fields plus the real static prompt + manifest stub. */
+export interface ScenarioSetup {
+    /** Optional workflow state -- injected as the "PROJECT WORKFLOW
+     *  STATE" section if present. Same shape as workflow/state.ts. */
+    workflow_state?: Record<string, unknown>;
+    /** Optional graph nodes injected as PROJECT KNOWLEDGE GRAPH. */
+    graph_nodes?: Array<{
+        kind: string;
+        slug: string;
+        description?: string;
+    }>;
+    /** Manifest mode for this scenario. Defaults to env / lazy. */
+    manifest_mode?: 'lazy' | 'eager';
+    /** Optional pre-history -- messages already exchanged before the
+     *  first scenario turn (sets up multi-turn context cheaply). */
+    pre_history?: Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>;
+    /** alpha.59z.23 -- synthetic GLOBAL LEARNINGS to inject into the
+     *  system prompt for THIS scenario. The harness does not fetch
+     *  from the worker (that would couple QA to live D1 state); each
+     *  scenario that wants to validate respect-of-lesson behaviour
+     *  declares the lesson here. Mirrors the shape produced by
+     *  buildGlobalLearningsSection() in production. */
+    injected_global_learnings?: Array<{
+        slug: string;
+        rule_text: string;
+    }>;
+    /** alpha.59z.45 -- per-verb canned tool_result the harness returns
+     *  when the brain invokes that verb_id and no scenario.turn
+     *  tool_result is queued. Keyed by inner verb_id (e.g.
+     *  "yujin.manifest.read"). Without this, the harness returns
+     *  {ok:true, fake:true} which causes brains to confabulate. */
+    harness_responses?: Record<string, unknown>;
+    /** alpha.59z.45 -- ad-hoc text appended to the system prompt for
+     *  this scenario. Use when the scenario tests verbs not in the
+     *  default lazy stub (e.g. backend tools app.*, MCP bridge tools)
+     *  -- declares the verb stub directly so the brain knows it
+     *  exists + can invoke it. */
+    extra_system_prompt?: string;
+    /** alpha.59z.45 -- force MCP-meta verbs (yujin.mcp.*) into the
+     *  manifest stub. By default they are filtered (Invariant 1).
+     *  Scenarios that test MCP flows declare expose_mcp_verbs=true so
+     *  yujin.mcp.invoke-tool + yujin.mcp.list-bridges + ... appear in
+     *  the prompt and the brain can pick them. */
+    expose_mcp_verbs?: boolean;
+}
+/** One step in the scenario script. */
+export type ScenarioTurn = {
+    kind: 'user_says';
+    text: string;
+} | {
+    /** When the previous LLM response contained a tool_use, mock
+     *  the result so the LLM can continue. Match by tool name
+     *  or by index in the toolRounds[]. */
+    kind: 'tool_result';
+    tool_name?: string;
+    /** Mock the result payload. is_error defaults to false. */
+    result: unknown;
+    is_error?: boolean;
+};
+export type InvariantKind = 'tool_called' | 'tool_not_called' | 'no_invent_verb' | 'text_contains' | 'text_contains_any' | 'text_excludes' | 'max_turns' | 'verb_invoked' | 'verb_not_invoked' | 'args_match' | 'discover_schemas_before_invoke' | 'past_tense_only_after_invoke' | 'no_redundant_confirm' | 'regex_match' | 'regex_not_match' | 'args_contain_key' | 'min_tool_calls' | 'max_tool_calls' | 'min_text_length' | 'verb_invoked_in_order';
+export interface InvariantSpec {
+    /** Display name in reports. */
+    name: string;
+    kind: InvariantKind;
+    /** Parameters specific to the invariant kind. See invariants.ts
+     *  for shape per kind. */
+    params?: Record<string, unknown>;
+}
+export interface Scenario {
+    id: string;
+    description: string;
+    setup: ScenarioSetup;
+    turns: ScenarioTurn[];
+    invariants: InvariantSpec[];
+    /** Cost cap in tokens -- skip brain if estimated cost exceeds. */
+    max_tokens?: number;
+    /** Skip in default runs (e.g. exploratory scenarios). */
+    skip_default?: boolean;
+    /** alpha.59z.5 F3 -- override the runner's per-turn maxToolRounds
+     *  (default 3). Stateful scenarios where the LLM needs
+     *  tool_use -> result -> final reply benefit from 5+ (eco
+     *  brains spend one extra round per state lookup). */
+    max_tool_rounds?: number;
+}
+/** What the harness captures per (scenario, brain) execution. */
+export interface BrainTurnRecord {
+    /** Index in the response sequence. */
+    index: number;
+    /** Free-text from the LLM in this turn. */
+    text: string;
+    /** Tool calls the LLM emitted in this turn (name + args). */
+    tool_calls: Array<{
+        name: string;
+        args: Record<string, unknown>;
+    }>;
+    /** Token spend for this turn. */
+    tokens_in: number;
+    tokens_out: number;
+    /** Wall-clock ms. */
+    duration_ms: number;
+}
+export interface ScenarioRun {
+    scenario_id: string;
+    brain_id: string;
+    started_at: string;
+    ended_at: string;
+    turns: BrainTurnRecord[];
+    /** Total tokens + ms across all turns. */
+    total_tokens_in: number;
+    total_tokens_out: number;
+    total_ms: number;
+    /** Errors during the run (network, schema, etc) -- not
+     *  invariant failures. */
+    error?: string;
+}
+export interface InvariantResult {
+    invariant: string;
+    kind: InvariantKind;
+    pass: boolean;
+    reason: string;
+}
+export interface ScenarioReport {
+    run: ScenarioRun;
+    invariants: InvariantResult[];
+    /** True iff every invariant passed AND error is undefined. */
+    pass: boolean;
+}
+export interface MatrixReport {
+    generated_at: string;
+    forge_version: string;
+    scenarios: Array<{
+        id: string;
+        description: string;
+    }>;
+    brains: BrainConfig[];
+    /** Indexed by [scenario_id][brain_id]. */
+    results: Record<string, Record<string, ScenarioReport>>;
+}
+/** Re-export for fixture authors. */
+export type { Nac3Verb };
+//# sourceMappingURL=types.d.ts.map

package/dist/qa/brain_matrix/types.d.ts.map

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

package/dist/qa/brain_matrix/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/qa/brain_matrix/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/qa/brain_matrix/types.ts"],"names":[],"mappings":""}

package/dist/qa/brain_matrix/validate_scenario.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Scenario shape validator. Catches common authoring mistakes
+ * BEFORE they show up as silent fake-gate failures:
+ *   - text_contains_any with `needles` instead of `substrs`
+ *   - text_excludes with `needle` instead of `substr`
+ *   - args_match without `verb_id` or `args`
+ *   - empty `turns[]`
+ *   - turns with neither `user_says` nor `tool_result`
+ *   - duplicate id within a scenario file (defensive)
+ *   - fake_responses count off from required turns
+ *
+ * Returns the list of human-readable warnings per scenario. Empty
+ * array = clean.
+ */
+import type { Scenario } from './types.js';
+export interface ValidationIssue {
+    scenario_id: string;
+    severity: 'error' | 'warning';
+    invariant: string | null;
+    message: string;
+}
+export declare function validateScenarioShape(s: Scenario): ValidationIssue[];
+//# sourceMappingURL=validate_scenario.d.ts.map

package/dist/qa/brain_matrix/validate_scenario.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate_scenario.d.ts","sourceRoot":"","sources":["../../../src/qa/brain_matrix/validate_scenario.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,YAAY,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAK,OAAO,GAAG,SAAS,CAAC;IACjC,SAAS,EAAI,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAM,MAAM,CAAC;CACrB;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,QAAQ,GAAG,eAAe,EAAE,CA2BpE"}

package/dist/qa/brain_matrix/validate_scenario.js

@@ -0,0 +1,128 @@
+export function validateScenarioShape(s) {
+    const out = [];
+    if (!s.id || typeof s.id !== 'string') {
+        out.push({ scenario_id: s.id ?? '<missing>', severity: 'error', invariant: null,
+            message: 'scenario.id is missing or not a string' });
+    }
+    if (!Array.isArray(s.turns) || s.turns.length === 0) {
+        out.push({ scenario_id: s.id, severity: 'error', invariant: null,
+            message: 'scenario.turns is empty' });
+    }
+    else {
+        for (let i = 0; i < s.turns.length; i++) {
+            const t = s.turns[i];
+            if (!t || (t.kind !== 'user_says' && t.kind !== 'tool_result')) {
+                out.push({ scenario_id: s.id, severity: 'error', invariant: null,
+                    message: 'turns[' + i + '].kind must be user_says or tool_result' });
+            }
+        }
+    }
+    if (!Array.isArray(s.invariants)) {
+        out.push({ scenario_id: s.id, severity: 'error', invariant: null,
+            message: 'scenario.invariants must be an array' });
+    }
+    else {
+        for (const inv of s.invariants) {
+            out.push(...validateInvariantShape(s.id, inv));
+        }
+    }
+    return out;
+}
+function validateInvariantShape(scenarioId, inv) {
+    const out = [];
+    if (!inv.name || typeof inv.name !== 'string') {
+        out.push({ scenario_id: scenarioId, severity: 'error', invariant: null,
+            message: 'invariant.name is missing' });
+        return out;
+    }
+    const p = (inv.params || {});
+    switch (inv.kind) {
+        case 'text_contains_any':
+            if (!Array.isArray(p.substrs)) {
+                const wrong = Array.isArray(p.needles) ? ' (found "needles", did you mean "substrs"?)' : '';
+                out.push({ scenario_id: scenarioId, severity: 'error', invariant: inv.name,
+                    message: 'text_contains_any requires params.substrs (string[])' + wrong });
+            }
+            break;
+        case 'text_contains':
+            if (typeof p.substr !== 'string') {
+                out.push({ scenario_id: scenarioId, severity: 'error', invariant: inv.name,
+                    message: 'text_contains requires params.substr (string)' });
+            }
+            break;
+        case 'text_excludes':
+            if (typeof p.substr !== 'string') {
+                const wrong = typeof p.needle === 'string' ? ' (found "needle", did you mean "substr"?)' : '';
+                out.push({ scenario_id: scenarioId, severity: 'error', invariant: inv.name,
+                    message: 'text_excludes requires params.substr (string)' + wrong });
+            }
+            break;
+        case 'verb_invoked':
+        case 'verb_not_invoked':
+        case 'tool_called':
+        case 'tool_not_called':
+        case 'no_invent_verb':
+            if (inv.kind === 'verb_invoked' || inv.kind === 'verb_not_invoked') {
+                if (typeof p.verb_id !== 'string') {
+                    out.push({ scenario_id: scenarioId, severity: 'error', invariant: inv.name,
+                        message: inv.kind + ' requires params.verb_id (string)' });
+                }
+            }
+            break;
+        case 'args_match':
+            if (typeof p.verb_id !== 'string' || typeof p.args !== 'object') {
+                out.push({ scenario_id: scenarioId, severity: 'error', invariant: inv.name,
+                    message: 'args_match requires params.verb_id (string) and params.args (object)' });
+            }
+            break;
+        case 'discover_schemas_before_invoke':
+            if (typeof p.verb_id !== 'string') {
+                out.push({ scenario_id: scenarioId, severity: 'error', invariant: inv.name,
+                    message: 'discover_schemas_before_invoke requires params.verb_id (string)' });
+            }
+            break;
+        case 'max_turns':
+        case 'min_text_length':
+        case 'min_tool_calls':
+        case 'max_tool_calls':
+            if (typeof (p.max ?? p.min) !== 'number') {
+                out.push({ scenario_id: scenarioId, severity: 'warning', invariant: inv.name,
+                    message: inv.kind + ' typically needs params.max or params.min (number)' });
+            }
+            break;
+        case 'regex_match':
+        case 'regex_not_match':
+            if (typeof p.pattern !== 'string') {
+                out.push({ scenario_id: scenarioId, severity: 'error', invariant: inv.name,
+                    message: inv.kind + ' requires params.pattern (string)' });
+            }
+            else {
+                try {
+                    new RegExp(p.pattern, p.flags || '');
+                }
+                catch (e) {
+                    out.push({ scenario_id: scenarioId, severity: 'error', invariant: inv.name,
+                        message: inv.kind + ' has invalid regex: ' + (e instanceof Error ? e.message : String(e)) });
+                }
+            }
+            break;
+        case 'args_contain_key':
+            if (typeof p.verb_id !== 'string' || typeof p.key !== 'string') {
+                out.push({ scenario_id: scenarioId, severity: 'error', invariant: inv.name,
+                    message: 'args_contain_key requires params.verb_id + params.key (both strings)' });
+            }
+            break;
+        case 'verb_invoked_in_order':
+            if (!Array.isArray(p.sequence) || p.sequence.length < 2) {
+                out.push({ scenario_id: scenarioId, severity: 'error', invariant: inv.name,
+                    message: 'verb_invoked_in_order requires params.sequence (string[], length >= 2)' });
+            }
+            break;
+        /* no-param invariants -- nothing to check */
+        case 'past_tense_only_after_invoke':
+        case 'no_redundant_confirm':
+            break;
+    }
+    return out;
+}
+//# sourceMappingURL=validate_scenario.js.map

package/dist/qa/brain_matrix/validate_scenario.js.map

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

package/dist/reader/parsers/epub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"epub.d.ts","sourceRoot":"","sources":["../../../src/reader/parsers/epub.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAsMD,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,kBAAkB,CA+CpE"}
+{"version":3,"file":"epub.d.ts","sourceRoot":"","sources":["../../../src/reader/parsers/epub.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA2MD,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,kBAAkB,CA+CpE"}

package/dist/reader/parsers/epub.js

@@ -84,7 +84,12 @@ function readLocalFile(buf, entry) {
         return Buffer.from(compressed);
     }
     if (entry.method === 8) {
-        return zlib.inflateRawSync(compressed);
+        /* PND-054 -- cap the inflated size to defuse zip bombs (a few KB that
+         * expand to gigabytes -> OOM crash). Trust the declared uncompressed
+         * size only up to a hard ceiling; inflateRawSync throws if exceeded. */
+        const HARD_CAP = 64 * 1024 * 1024; /* 64 MB / entry */
+        const declared = entry.uncompressedSize > 0 ? entry.uncompressedSize + 1024 : HARD_CAP;
+        return zlib.inflateRawSync(compressed, { maxOutputLength: Math.min(declared, HARD_CAP) });
     }
     throw new Error('epub: unsupported compression method ' + entry.method + ' for ' + entry.name);
 }

package/dist/reader/parsers/epub.js.map

@@ -1 +1 @@
-{"version":3,"file":"epub.js","sourceRoot":"","sources":["../../../src/reader/parsers/epub.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"epub.js","sourceRoot":"","sources":["../../../src/reader/parsers/epub.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAmBtC,MAAM,QAAQ,GAAG,UAAU,CAAC;AAC5B,MAAM,MAAM,GAAG,UAAU,CAAC;AAC1B,MAAM,OAAO,GAAG,UAAU,CAAC;AAE3B,SAAS,QAAQ,CAAC,GAAW;IAC3B;mDAC+C;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,cAAc,CAAC,GAAW;IACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,IAAI,CAAC,GAAG,QAAQ,CAAC;IACjB,MAAM,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,IAAI,CAAC,GAAG,EAAE,IAAI,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,8CAA8C,GAAG,CAAC,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QACxC,MAAM,cAAc,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAChD,MAAM,gBAAgB,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAClD,MAAM,WAAW,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1C,MAAM,UAAU,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC5C,MAAM,iBAAiB,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACpF,CAAC,IAAI,EAAE,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;IAChD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,aAAa,CAAC,GAAW,EAAE,KAAsB;IACxD,MAAM,CAAC,GAAG,KAAK,CAAC,iBAAiB,CAAC;IAClC,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,wCAAwC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,WAAW,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,GAAG,WAAW,GAAG,QAAQ,CAAC;IAClD,MAAM,OAAO,GAAG,SAAS,GAAG,KAAK,CAAC,cAAc,CAAC;IACjD,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACpD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB;;gFAEwE;QACxE,MAAM,QAAQ,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,mBAAmB;QACtD,MAAM,QAAQ,GAAG,KAAK,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;QACvF,OAAO,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,EAAE,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,uCAAuC,GAAG,KAAK,CAAC,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;AACjG,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC,yDAAyD;QACzD,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QACvC,IAAI,CAAC;YACH,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb;0CAC8B;QAChC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,qCAAqC;AAErC,SAAS,cAAc,CAAC,CAAS;IAC/B,OAAO,CAAC;SACL,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;QACzC,IAAI,CAAC;YAAC,OAAO,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,EAAE,CAAC;QAAC,CAAC;IAC9E,CAAC,CAAC;SACD,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;QAC/B,IAAI,CAAC;YAAC,OAAO,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,EAAE,CAAC;QAAC,CAAC;IAC9E,CAAC,CAAC;SACD,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,OAAO,CAAC,GAAW,EAAE,IAAY;IACxC,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,KAAK,GAAG,IAAI,GAAG,qCAAqC,EAAE,GAAG,CAAC,CAAC;IACjF,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxB,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW,EAAE,OAAe;IAC5C,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,OAAO,GAAG,OAAO,GAAG,WAAW,EAAE,GAAG,CAAC,CAAC;IAC5D,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxB,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACzB,CAAC;AAED,SAAS,OAAO,CAAC,GAAW,EAAE,OAAe;IAC3C,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,OAAO,GAAG,OAAO,GAAG,WAAW,EAAE,IAAI,CAAC,CAAC;IAC7D,OAAO,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED,SAAS,YAAY,CAAC,GAAW,EAAE,OAAe;IAChD,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,OAAO,GAAG,OAAO,GAAG,iCAAiC,GAAG,OAAO,GAAG,OAAO,EAAE,GAAG,CAAC,CAAC;IACtG,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7B,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,0CAA0C;AAE1C,SAAS,WAAW,CAAC,IAAY,EAAE,GAAW;IAC5C,+BAA+B;IAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,gDAAgD;IAChD,MAAM,IAAI,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,GAAG;YAAE,SAAS;QAClC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,KAAK,CAAC,GAAG,EAAE,CAAC;YAClC,SAAS;QACX,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,cAAc,CAAC,YAAoB;IAC1C,MAAM,GAAG,GAAG,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC/C,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAC3E,OAAO,IAAI,CAAC;AACd,CAAC;AASD,SAAS,QAAQ,CAAC,MAAc;IAC9B,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;IACtF,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,EAAE,aAAa,CAAC,IAAI,SAAS,CAAC;IAElE,eAAe;IACf,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,sDAAsD;IACtD,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAChF,IAAI,aAAa,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAChD,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YACjC,IAAI,EAAE,IAAI,IAAI;gBAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,YAAY;IACZ,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACvE,IAAI,UAAU,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAChD,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YACnC,IAAI,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAkB,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACvD,IAAI,QAAQ;QAAE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACvC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,sBAAsB;AAEtB,MAAM,UAAU,SAAS,CAAC,IAAsB;IAC9C,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACzD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,OAAO,GAAG,wBAAwB,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAE/C;;sCAEkC;IAClC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxC;;8DAEsD;QACtD,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC9D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED;;uDAEmD;IACnD,MAAM,SAAS,GAAG,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC;IACvE,MAAM,KAAK,GAAG,SAAS,CAAC;QACtB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC;QACvC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;KACpG,CAAC,CAAC;IAEH,4DAA4D;IAC5D,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IACjC,IAAI,GAAG,CAAC,KAAK;QAAE,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;IACvC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/relay/board_snapshot.d.ts

@@ -0,0 +1,69 @@
+export interface BoardSnapshot {
+    /** Legacy single-workflow summary (kept for back-compat). */
+    workflow?: {
+        title: string;
+        done: number;
+        total: number;
+        stages: Array<{
+            title: string;
+            status: string;
+            done: number;
+            total: number;
+        }>;
+    };
+    /** PND-094 ext -- the coexisting workflows, each with its stages and
+     *  the ordered task pendings under each stage. */
+    workflows?: Array<{
+        code: string;
+        name: string;
+        kind: string;
+        status: string;
+        done: number;
+        total: number;
+        stages: Array<{
+            id: string;
+            title: string;
+            tasks: Array<{
+                id: string;
+                title: string;
+                closed: boolean;
+                ad_hoc?: boolean;
+            }>;
+        }>;
+    }>;
+    pendings?: {
+        open: number;
+        top: Array<{
+            id: string;
+            title: string;
+            priority: number;
+            category?: string;
+            body?: string;
+        }>;
+    };
+    graph?: GraphSnapshot;
+    ts: string;
+}
+export interface GraphSnapshot {
+    nodes: Array<{
+        id: string;
+        label: string;
+        kind: string;
+        group: NodeGroup;
+    }>;
+    edges: Array<{
+        from: string;
+        to: string;
+        kind: string;
+    }>;
+}
+export type NodeGroup = 'backend' | 'frontend' | 'mobile' | 'tests' | 'tools' | 'scripts' | 'libs' | 'protocol';
+export declare const NODE_GROUPS: readonly NodeGroup[];
+/** Deterministic high-level grouping of a graph node from its id + kind.
+ *  Tool/script/lib are exact by id prefix; module/component fall back to
+ *  path/name heuristics (best-effort -- coarse module nodes are fuzzy). */
+export declare function nodeGroup(id: string, name: string, kind: string): NodeGroup;
+/** Build a compact board snapshot. Never throws. */
+export declare function buildBoardSnapshot(projectRoot: string, slug?: string | null): Promise<BoardSnapshot>;
+export declare function buildGraphSnapshot(slug: string): Promise<GraphSnapshot | null>;
+//# sourceMappingURL=board_snapshot.d.ts.map

package/dist/relay/board_snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board_snapshot.d.ts","sourceRoot":"","sources":["../../src/relay/board_snapshot.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC/E,CAAC;IACF;sDACkD;IAClD,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QACzD,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAC5B,MAAM,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,KAAK,CAAC;gBAAE,EAAE,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,OAAO,CAAC;gBAAC,MAAM,CAAC,EAAE,OAAO,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC,CAAC;KAC9H,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC/F,CAAC;IAKF,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAC5E,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1D;AAED,MAAM,MAAM,SAAS,GACjB,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAC3C,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAE9C,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAE3C,CAAC;AAEF;;2EAE2E;AAC3E,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAU3E;AAED,oDAAoD;AACpD,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GACnB,OAAO,CAAC,aAAa,CAAC,CA2DxB;AAUD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAgCpF"}

package/dist/relay/board_snapshot.js

@@ -0,0 +1,149 @@
+/**
+ * Compact "board" snapshot for the P2 relay -- what the phone's Pizarron
+ * tab mirrors. The desktop's canonical boards (semantic graph, BPMN,
+ * etc.) are large; this is a small, high-signal digest that fits the
+ * relay payload budget (<32KB): the workflow phases/progress + the open
+ * pendings. Best-effort -- a missing source just drops that section.
+ *
+ * ASCII-only.
+ */
+import { readWorkflow } from '../workflow/state.js';
+import { computeWorkflowView } from '../workflow/view.js';
+import { readPending } from '../pending/store.js';
+export const NODE_GROUPS = [
+    'backend', 'frontend', 'mobile', 'tests', 'tools', 'scripts', 'libs', 'protocol',
+];
+/** Deterministic high-level grouping of a graph node from its id + kind.
+ *  Tool/script/lib are exact by id prefix; module/component fall back to
+ *  path/name heuristics (best-effort -- coarse module nodes are fuzzy). */
+export function nodeGroup(id, name, kind) {
+    if (id.startsWith('tool.ci.'))
+        return 'tools';
+    if (id.startsWith('tool.npm.') || id.startsWith('tool.script.'))
+        return 'scripts';
+    if (kind === 'library' || id.startsWith('lib.'))
+        return 'libs';
+    const s = (id + ' ' + name).toLowerCase();
+    if (/(^|[._-])(test|tests|spec|vitest|playwright|qa)([._-]|$)|test_agent|\.test\b/.test(s))
+        return 'tests';
+    if (/forge-mobile|nac3-rn|expo|metro|apps[._-]forge|(^|[._-])mobile([._-]|$)/.test(s))
+        return 'mobile';
+    if (/panel|pizarron|chat|reader|design|figma|(^|[._-])ui([._-]|$)|component|webview|board|view/.test(s))
+        return 'frontend';
+    if (kind === 'protocol' || id.startsWith('proto'))
+        return 'protocol';
+    return 'backend';
+}
+/** Build a compact board snapshot. Never throws. */
+export async function buildBoardSnapshot(projectRoot, slug) {
+    const snap = { ts: new Date().toISOString() };
+    try {
+        const wf = await readWorkflow(projectRoot);
+        const v = computeWorkflowView(wf);
+        snap.workflow = {
+            title: v.title,
+            done: v.done_steps,
+            total: v.total_steps,
+            stages: v.stages.slice(0, 12).map((s) => ({
+                title: s.title, status: s.status, done: s.done, total: s.total,
+            })),
+        };
+    }
+    catch { /* no workflow yet -> omit */ }
+    if (slug) {
+        try {
+            const pf = await readPending(slug);
+            const open = pf.items.filter((i) => !i.closed_at);
+            open.sort((a, b) => a.priority - b.priority);
+            snap.pendings = {
+                open: open.length,
+                /* Pablo 2026-06-15: 6 was too few -- the phone's list looked
+                 * truncated. Send up to 40 (the mobile scrolls). */
+                top: open.slice(0, 40).map((i) => ({
+                    id: i.id, title: i.title, priority: i.priority,
+                    category: i.category,
+                    /* functional detail for the phone's pending-detail view (#4),
+                     * bounded so the snapshot stays compact. */
+                    body: typeof i.body === 'string'
+                        ? i.body.slice(0, 500) : undefined,
+                })),
+            };
+        }
+        catch { /* no pendings -> omit */ }
+        /* PND-094 ext -- the coexisting workflows + tasks-by-stage. Compact:
+         * task id/title/closed only (the phone cross-refs `pendings` for the
+         * full detail). Capped so the board stays small. */
+        try {
+            const { computeWorkflowsView } = await import('../workflow/multi_view.js');
+            const cards = await computeWorkflowsView(slug, 'open');
+            if (cards.length) {
+                snap.workflows = cards.slice(0, 8).map((c) => ({
+                    code: c.code, name: c.name, kind: c.kind, status: c.status,
+                    done: c.done, total: c.total,
+                    stages: c.stages.map((s) => ({
+                        id: s.id, title: s.title,
+                        tasks: s.tasks.slice(0, 60).map((t) => ({
+                            id: t.id, title: t.title.slice(0, 90), closed: t.closed,
+                            ...(t.ad_hoc ? { ad_hoc: true } : {}),
+                        })),
+                    })),
+                }));
+            }
+        }
+        catch { /* no workflows -> omit */ }
+    }
+    return snap;
+}
+/* The semantic graph for the phone's "Grafo" tab travels in its OWN
+ * relay event (kind 'graph') so it does not share the board's 32KB
+ * budget -- that is what let the old code cap nodes at 60 and drop most
+ * edges. With its own budget we send the whole connected subgraph (all
+ * edges + their nodes) plus a generous fill of relevant isolated nodes.
+ *
+ * Same edge-fidelity rule: pick the EDGE-CONNECTED nodes first so no
+ * edge is orphaned, then fill with the most relevant nodes. */
+export async function buildGraphSnapshot(slug) {
+    try {
+        const { listRelevant, listAllEdges } = await import('../semantic_graph/store.js');
+        const NODE_CAP = 300; /* own event budget -- far above the old 60 */
+        const EDGE_CAP = 600;
+        /* Exclude `comp.*` (function-level) nodes -- too granular + their long
+         * ids blow the payload past 32KB. Same level the desktop graph shows
+         * (modules / libs / tooling / protocol). */
+        const pool = (await listRelevant(slug, { limit: 2000, min_confidence: 'claimed' }))
+            .filter((n) => !n.id.startsWith('comp.'));
+        if (!pool.length)
+            return null;
+        const byId = new Map(pool.map((n) => [n.id, n]));
+        const allEdges = (await listAllEdges(slug)).slice(0, EDGE_CAP);
+        const chosen = new Map();
+        for (const e of allEdges) {
+            if (chosen.size >= NODE_CAP)
+                break;
+            const a = byId.get(e.from_id);
+            if (a)
+                chosen.set(a.id, a);
+            const b = byId.get(e.to_id);
+            if (b)
+                chosen.set(b.id, b);
+        }
+        for (const n of pool) {
+            if (chosen.size >= NODE_CAP)
+                break;
+            if (!chosen.has(n.id))
+                chosen.set(n.id, n);
+        }
+        const nodeIds = new Set(chosen.keys());
+        const edges = allEdges.filter((e) => nodeIds.has(e.from_id) && nodeIds.has(e.to_id));
+        return {
+            nodes: [...chosen.values()].map((n) => ({
+                id: n.id, label: n.name, kind: n.kind, group: nodeGroup(n.id, n.name, n.kind),
+            })),
+            edges: edges.map((e) => ({ from: e.from_id, to: e.to_id, kind: e.kind })),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=board_snapshot.js.map