@nac3/forge-cli 0.2.0-alpha.5 → 0.2.0-alpha.59z.119

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":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAEhE,MAAM,MAAM,aAAa,GACrB,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GACjD,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,eAAe,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,EAAE,EAAS,MAAM,CAAC;IAClB,QAAQ,EAAG,aAAa,CAAC;IACzB,KAAK,EAAM,MAAM,CAAC;IAClB,IAAI,EAAO,KAAK,GAAG,UAAU,CAAC;IAC9B;;kBAEc;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;0DAE0D;AAC1D,MAAM,WAAW,aAAa;IAC5B;sEACkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,gEAAgE;IAChE,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1E,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC;oEACgE;IAChE,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE;;;;;uDAKmD;IACnD,yBAAyB,CAAC,EAAE,KAAK,CAAC;QAChC,IAAI,EAAO,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH;;;;mEAI+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C;;;;kCAI8B;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;kDAI8C;IAC9C,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,uCAAuC;AACvC,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnC;IACE;;2CAEuC;IACvC,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEN,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,iBAAiB,GACjB,gBAAgB,GAChB,eAAe,GACf,mBAAmB,GACnB,eAAe,GACf,WAAW,GACX,cAAc,GACd,kBAAkB,GAClB,YAAY,GACZ,gCAAgC,GAChC,8BAA8B,GAC9B,sBAAsB,GAEtB,aAAa,GACb,iBAAiB,GACjB,kBAAkB,GAClB,gBAAgB,GAChB,gBAAgB,GAEhB,iBAAiB,GACjB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,aAAa,CAAC;IACpB;8BAC0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;0DAGsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IACnE,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,0CAA0C;IAC1C,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB;8BAC0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,WAAW,CAAC;IACjB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,8DAA8D;IAC9D,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAK,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,MAAM,EAAQ,WAAW,EAAE,CAAC;IAC5B,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;CACzD;AAED,qCAAqC;AACrC,YAAY,EAAE,QAAQ,EAAE,CAAC"}

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/support/github_dispatcher.d.ts

@@ -0,0 +1,36 @@
+import { type SupportReport } from './reports.js';
+/** Hash a report into a stable fingerprint so re-occurrences
+ *  cluster. Uses message + first two non-empty stack lines. */
+export declare function fingerprintReport(r: SupportReport): string;
+export interface DispatchOptions {
+    /** Owner/repo slug, e.g. "yujinapp/yujin-forge". Inferred from
+     *  git remote when omitted. */
+    repo_slug?: string;
+    /** Limit how many fingerprints to push in a single run (rate
+     *  limiting). Default 10. */
+    max_fingerprints_per_run?: number;
+    /** Dry-run: build payloads but do not call gh. Returns the
+     *  payloads for inspection. */
+    dry_run?: boolean;
+}
+export interface DispatchResult {
+    ok: boolean;
+    opened: Array<{
+        fingerprint: string;
+        issue_number: number;
+        title: string;
+    }>;
+    commented: Array<{
+        fingerprint: string;
+        issue_number: number;
+        new_occurrences: number;
+    }>;
+    skipped_no_gh: boolean;
+    dry_run: boolean;
+    cursor_advanced_to: string;
+    errors: string[];
+}
+/** Main entry point. Walks reports, dedups by fingerprint, opens
+ *  / comments on GitHub. */
+export declare function dispatchSupportReportsToGithub(opts?: DispatchOptions): Promise<DispatchResult>;
+//# sourceMappingURL=github_dispatcher.d.ts.map

package/dist/support/github_dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github_dispatcher.d.ts","sourceRoot":"","sources":["../../src/support/github_dispatcher.ts"],"names":[],"mappings":"AA6BA,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAmC/D;+DAC+D;AAC/D,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAI1D;AAkFD,MAAM,WAAW,eAAe;IAC9B;mCAC+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;iCAC6B;IAC7B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;mCAC+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,SAAS,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzF,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAuBD;4BAC4B;AAC5B,wBAAsB,8BAA8B,CAAC,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CA6HxG"}