zelari-code 2.12.0 → 2.14.0

package/dist/cli/orchestration/facts.js

@@ -0,0 +1,127 @@
+/**
+ * orchestration/facts — t23 (§P1.E): cheap I/O inputs for the decision.
+ *
+ * chooseOrchestration itself stays PURE (no I/O, no env reads) — this module
+ * is the only place that touches disk / the task-contract seam, and callers
+ * inject its output into the pure classifier. Every collector fails soft:
+ * on any error it returns `undefined` for that input (the table then treats
+ * the fact as "unknown", never as an escalation reason).
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { activeContractScope } from '../kraken/contractCompiler.js';
+/** Repos above this file count count as "large" (weak explore-signal only). */
+export const LARGE_REPO_FILES = 800;
+/** Bounded walk budget: stop counting after this many files. */
+const MAX_WALK_FILES = 5_000;
+/** Directories never descended into (dependency/vendor noise). */
+const SKIP_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    '.next',
+    'coverage',
+    '.zelari',
+    '.venv',
+]);
+/**
+ * Count workspace files with a bounded iterative walk (cheap, no deps).
+ * `undefined` when the root is unreadable — unknown is not an error.
+ */
+export async function collectRepoFileCount(root = process.cwd()) {
+    try {
+        // The ROOT failing to read is "unknown repo"; a nested dir failing is
+        // just skipped noise. Distinguish them honestly.
+        await fs.readdir(root);
+    }
+    catch {
+        return undefined;
+    }
+    try {
+        let count = 0;
+        const queue = [root];
+        while (queue.length > 0 && count <= MAX_WALK_FILES) {
+            const dir = queue.pop();
+            let entries;
+            try {
+                entries = await fs.readdir(dir, { withFileTypes: true });
+            }
+            catch {
+                continue; // unreadable subdir → skip silently
+            }
+            for (const e of entries) {
+                if (e.isDirectory()) {
+                    if (!SKIP_DIRS.has(e.name))
+                        queue.push(path.join(dir, e.name));
+                }
+                else if (e.isFile()) {
+                    count++;
+                    if (count > MAX_WALK_FILES)
+                        return count;
+                }
+            }
+        }
+        return count;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Gather all v2 decision inputs in one place:
+ * - risk/scope come from the ACTIVE TaskContract registered on the
+ *   contractCompiler seam (`setActiveContractScope`, t22); headless turns
+ *   start fresh per process, so usually undefined ⇒ neutral defaults apply
+ *   inside the policy (medium-ish risk, no scope).
+ * - repoSize from the bounded walk above.
+ * - previousFailures is always 0 until a spine look-up is threaded through
+ *   (see OrchestrationFacts.previousFailures note).
+ */
+export async function collectOrchestrationFacts(cwd = process.cwd()) {
+    const scope = safeActiveScope();
+    const [repoSize] = await Promise.all([collectRepoFileCount(cwd)]);
+    return {
+        ...(scope?.contract.risk ? { risk: scope.contract.risk } : {}),
+        ...(scope?.contract.scope
+            ? {
+                scopePathsCount: (scope.contract.scope.allowedPaths?.length ?? 0) +
+                    (scope.contract.scope.forbiddenPaths?.length ?? 0),
+            }
+            : {}),
+        ...(repoSize !== undefined ? { repoSize } : {}),
+        previousFailures: 0,
+    };
+}
+function safeActiveScope() {
+    try {
+        return activeContractScope();
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Telemetry: record the decision on the session spine as a state-only `note`
+ * event (ADR-0021 vocabulary — `note` is existing, never model-surface, and
+ * the tolerant replay invariant already ignores it). Adding a brand-new core
+ * kind would require a schema review, so we REUSE `note` with a namespaced
+ * payload: data.subject === 'orchestration_decision'.
+ */
+export function spineOrchestrationNote(handle, decision) {
+    try {
+        handle.note(`orchestration_decision ${decision.strategy}`, {
+            subject: 'orchestration_decision',
+            strategy: decision.strategy,
+            surface: decision.surface,
+            confidence: decision.confidence,
+            rationaleCode: decision.rationaleCode,
+            reason: decision.reason,
+            estimatedLatencyMs: decision.estimatedLatencyMs,
+        });
+    }
+    catch {
+        // Degraded/disabled spine must NEVER break the run over telemetry.
+    }
+}
+//# sourceMappingURL=facts.js.map

package/dist/cli/orchestration/facts.js.map

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

package/dist/cli/orchestration/policy.js

@@ -1,88 +1,141 @@
+import { AMBIGUOUS_RE, CROSS_CUTTING_RE, DESIGN_RE, ESTIMATED_LATENCY_MS, EXPLAIN_RE, HEAVY_SIGNALS, MULTI_ARTIFACT_RE, QUESTION_RE, READONLY_RE, STRATEGY_RANK, strategySurface, } from './signals.js';
+/** Human-readable twins of the rationaleCodes (safe to log verbatim). */
+const RATIONALE_TEXT = {
+    fail_closed_empty: 'empty task',
+    design_conflict_signal: 'design + ambiguity conflict',
+    contract_high_risk: 'high-risk contract',
+    cross_cutting_scope: 'cross-cutting scope',
+    multi_artifact_count: 'multi-artifact count',
+    multi_path_scope: 'multi-path contract scope',
+    ambiguous_task: 'ambiguous task',
+    question_shaped_task: 'question-shaped task',
+    explanation_request: 'explanation request',
+    read_only_request: 'read-only request',
+    small_task_no_heavy_signals: 'small task, no heavy signals',
+    fail_closed_default: 'fail-closed default',
+    repeated_verification_failures: 'repeated verification failures',
+    prior_failure_verification_bump: 'prior failure verification bump',
+};
+/** Per-rule confidence constants (heuristics — documented, stable, pure). */
+const RATIONALE_CONFIDENCE = {
+    fail_closed_empty: 0.35,
+    design_conflict_signal: 0.8,
+    contract_high_risk: 0.85,
+    cross_cutting_scope: 0.75,
+    multi_artifact_count: 0.7,
+    multi_path_scope: 0.7,
+    implementation_signal: 0.72,
+    refactor_signal: 0.72,
+    migration_signal: 0.75,
+    new_capability_signal: 0.7,
+    test_writing_signal: 0.7,
+    ambiguous_task: 0.55,
+    read_only_request: 0.65,
+    question_shaped_task: 0.6,
+    explanation_request: 0.6,
+    small_task_no_heavy_signals: 0.62,
+    fail_closed_default: 0.3,
+    repeated_verification_failures: 0.78,
+    prior_failure_verification_bump: 0.66,
+};
 /**
- * orchestration/policy — pure task classifier for `--mode auto` (t12 / P1.1).
- *
- * Given a raw task prompt, decide which orchestration surface owns the run.
- * Deterministic and side-effect-free: no clock, no randomness, no I/O, no
- * environment reads — callers pass their flags/overrides in via `opts`.
- *
- * Tiers (first match wins):
- *   1. heavy intent   -> 'kraken'  implement/refactor/migrate, new capabilities,
- *                                  test-writing, counted artifacts, cross-cutting
- *   2. light intent   -> 'solo'    questions ("...?"), explain/describe,
- *                                  read-only requests (find/show/list/grep)
- *   3. size           -> 'solo'    short prompt without heavy intent
- *   4. default        -> 'solo'    fail-closed: unsure means "current behavior"
- *
- * Only surfaces that actually exist in runHeadless dispatch are produced
- * ('kraken' today rides the single-harness super-agent path; 'solo' is the
- * ordinary lightweight turn). No invented values here — council/zelari
- * remain explicit opt-ins, never auto-selected.
- */
-/**
- * Prompts at or under this length with no heavy intent are treated as small.
- * Conservative on purpose: longer neutral prompts fall through to the same
- * 'solo' default, just with the fail-closed reason.
+ * Prompts at or under this length with no signal matched are treated as
+ * small (v1 constant kept for compat). Larger neutral prompts still fall
+ * through to the fail-closed default — never escalate on size alone.
  */
 export const DEFAULT_MAX_SOLO_CHARS = 300;
-/** Heavy-intent signals — evaluated first so they outrank any light signal. */
-const KRAKEN_SIGNALS = [
-    { re: /\bimplement(?:s|ed|ing)?\b/i, reason: 'implementation signal' },
-    { re: /\brefactor(?:ing|ed)?\b/i, reason: 'refactor signal' },
-    { re: /\bmigrat(?:e|es|ed|ion|ing)\b/i, reason: 'migration signal' },
-    {
-        re: /\b(?:add|build|create|introduce)\b[^.?!]{0,48}\b(?:feature|endpoint|module|service|command|api|registry|runtime)\b/i,
-        reason: 'new-capability signal',
-    },
-    {
-        re: /\b(?:unit|integration|e2e|end-to-end)\s+(?:tests?|testing|specs?)\b|\bwrite\s+(?:the\s+|some\s+)?tests?\b/i,
-        reason: 'test-writing signal',
-    },
-    {
-        re: /\b\d+\s*-?\s*(?:files?|modules?|packages?|components?|services?|endpoints?|worktrees?)\b/i,
-        reason: 'multi-artifact count',
-    },
-    {
-        re: /\b(?:across|spanning|between|touching)\s+(?:all\s+|the\s+)?(?:\w+\s+){0,2}(?:files|modules|packages|layers|surfaces)\b/i,
-        reason: 'cross-cutting scope',
-    },
-];
-/** Question-shaped prompt: trailing '?' or a leading interrogative/modal. */
-const QUESTION_RE = /\?\s*$|^(?:who|what|why|when|where|which|how|is|are|was|were|does|do|did|can|could|should|would|will)\b/i;
-const EXPLAIN_RE = /\b(?:explain|describe|summarize|summarise|clarify|walk\W*me\W*through)\b/i;
-const READONLY_RE = /\b(?:find|show|list|grep|search|locate|inspect|read|check|review|where\W+is)\b/i;
+/** Contract-scope path count that implies several disjoint slices. */
+export const PARALLEL_SCOPE_PATHS = 3;
+const HEAVY_CODES = new Set([
+    'implementation_signal',
+    'refactor_signal',
+    'migration_signal',
+    'new_capability_signal',
+    'test_writing_signal',
+]);
 /**
- * Classify a task prompt into an orchestration surface.
- *
- * Pure function: identical inputs always yield identical verdicts.
- * Fail-closed — when nothing matches, the answer is the CLI's historical
- * behavior ('solo'), never a speculative escalation.
+ * Classify a task into a full v2 OrchestrationDecision. Pure function:
+ * identical inputs always yield identical outputs (property-tested).
  */
 export function chooseOrchestration(task, opts = {}) {
     const text = String(task ?? '').trim();
-    const failClosed = () => ({
-        surface: 'solo',
-        reason: 'fail-closed default',
-    });
-    if (!text)
-        return failClosed();
-    // Tier 1 — heavy intent wins over everything below.
-    for (const { re, reason } of KRAKEN_SIGNALS) {
-        if (re.test(text))
-            return { surface: 'kraken', reason };
+    let hit = !text
+        ? hitOf('lead-only', 'fail_closed_empty')
+        : baseRule(text, opts);
+    // Failure post-adjustment — escalation only (never lowers, never touches a
+    // council decision: councils are not verification tools).
+    if (hit.strategy !== 'council' && (opts.previousFailures ?? 0) > 0) {
+        if ((opts.previousFailures ?? 0) >= 2 && STRATEGY_RANK[hit.strategy] < STRATEGY_RANK.graph) {
+            hit = hitOf('graph', 'repeated_verification_failures');
+        }
+        else if ((opts.previousFailures ?? 0) >= 1 &&
+            STRATEGY_RANK[hit.strategy] < STRATEGY_RANK['lead+verify']) {
+            hit = hitOf('lead+verify', 'prior_failure_verification_bump');
+        }
+    }
+    return {
+        ...hit,
+        reason: RATIONALE_TEXT[hit.rationaleCode] ?? hit.rationaleCode,
+        surface: strategySurface(hit.strategy),
+        estimatedLatencyMs: ESTIMATED_LATENCY_MS[hit.strategy],
+    };
+}
+function hitOf(strategy, code) {
+    return {
+        strategy,
+        confidence: RATIONALE_CONFIDENCE[code],
+        rationaleCode: code,
+    };
+}
+/** Rules 1–12 of the DECISION TABLE above, in documented order. */
+function baseRule(text, o) {
+    const risk = o.risk;
+    const highRisk = risk === 'high' || risk === 'critical';
+    // 1 — the ONLY council trigger: design wording + explicit ambiguity marker.
+    if (DESIGN_RE.test(text) && AMBIGUOUS_RE.test(text)) {
+        return hitOf('council', 'design_conflict_signal');
     }
-    // Tier 2 — light intent: questions, explanations, read-only asks.
+    // 2–3 — graph-level care: declared high risk or cross-cutting phrases.
+    if (highRisk)
+        return hitOf('graph', 'contract_high_risk');
+    if (CROSS_CUTTING_RE.test(text))
+        return hitOf('graph', 'cross_cutting_scope');
+    // 4–5 — parallelism potential: counted artifacts or a multi-path scope.
+    if (MULTI_ARTIFACT_RE.test(text))
+        return hitOf('parallel-build', 'multi_artifact_count');
+    if ((o.scopePathsCount ?? 0) >= PARALLEL_SCOPE_PATHS) {
+        return hitOf('parallel-build', 'multi_path_scope');
+    }
+    // 6 — ordinary build work ⇒ implement then verify.
+    for (const { re, code } of HEAVY_SIGNALS) {
+        if (re.test(text) && HEAVY_CODES.has(code))
+            return hitOf('lead+verify', code);
+    }
+    // 7–11 — light tiers, most-specific first.
+    if (AMBIGUOUS_RE.test(text))
+        return hitOf('explore', 'ambiguous_task');
+    if (READONLY_RE.test(text))
+        return hitOf('explore', 'read_only_request');
     if (QUESTION_RE.test(text))
-        return { surface: 'solo', reason: 'question-shaped task' };
+        return hitOf('lead-only', 'question_shaped_task');
     if (EXPLAIN_RE.test(text))
-        return { surface: 'solo', reason: 'explanation request' };
-    if (READONLY_RE.test(text))
-        return { surface: 'solo', reason: 'read-only request' };
-    // Tier 3 — short and unremarkable: comfortably within the solo budget.
-    const budget = opts.maxSoloChars ?? DEFAULT_MAX_SOLO_CHARS;
-    if (text.length <= budget) {
-        return { surface: 'solo', reason: 'small task, no heavy signals' };
+        return hitOf('lead-only', 'explanation_request');
+    const budget = o.maxSoloChars ?? DEFAULT_MAX_SOLO_CHARS;
+    // Tuning knob mirrors facts.collectOrchestrationFacts' bounded walk; kept
+    // local so this module stays a pure leaf (facts must not be imported here).
+    const largeRepo = (o.repoSize ?? 0) > 800;
+    if (text.length <= budget &&
+        (o.scopePathsCount ?? 0) <= 1 &&
+        (o.previousFailures ?? 0) === 0 &&
+        !highRisk &&
+        !largeRepo) {
+        return hitOf('lead-only', 'small_task_no_heavy_signals');
     }
-    // Tier 4 — unsure (long, no signals): stay on today's default path.
-    return failClosed();
+    // 12 — long neutral prompts stay on the historical default (fail-closed).
+    return hitOf('lead-only', 'fail_closed_default');
+}
+/** Shared reason resolution for hosts/logs/tests. */
+export function orchestrationReason(decision) {
+    return RATIONALE_TEXT[decision.rationaleCode] ?? decision.rationaleCode;
 }
 //# sourceMappingURL=policy.js.map

package/dist/cli/orchestration/policy.js.map

@@ -1 +1 @@
-{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../src/cli/orchestration/policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAmBH;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C,+EAA+E;AAC/E,MAAM,cAAc,GAAkD;IACpE,EAAE,EAAE,EAAE,6BAA6B,EAAE,MAAM,EAAE,uBAAuB,EAAE;IACtE,EAAE,EAAE,EAAE,0BAA0B,EAAE,MAAM,EAAE,iBAAiB,EAAE;IAC7D,EAAE,EAAE,EAAE,gCAAgC,EAAE,MAAM,EAAE,kBAAkB,EAAE;IACpE;QACE,EAAE,EAAE,qHAAqH;QACzH,MAAM,EAAE,uBAAuB;KAChC;IACD;QACE,EAAE,EAAE,4GAA4G;QAChH,MAAM,EAAE,qBAAqB;KAC9B;IACD;QACE,EAAE,EAAE,2FAA2F;QAC/F,MAAM,EAAE,sBAAsB;KAC/B;IACD;QACE,EAAE,EAAE,yHAAyH;QAC7H,MAAM,EAAE,qBAAqB;KAC9B;CACF,CAAC;AAEF,6EAA6E;AAC7E,MAAM,WAAW,GACf,0GAA0G,CAAC;AAE7G,MAAM,UAAU,GAAG,2EAA2E,CAAC;AAE/F,MAAM,WAAW,GAAG,iFAAiF,CAAC;AAEtG;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,OAAgC,EAAE;IAElC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAEvC,MAAM,UAAU,GAAG,GAAyB,EAAE,CAAC,CAAC;QAC9C,OAAO,EAAE,MAAM;QACf,MAAM,EAAE,qBAAqB;KAC9B,CAAC,CAAC;IAEH,IAAI,CAAC,IAAI;QAAE,OAAO,UAAU,EAAE,CAAC;IAE/B,oDAAoD;IACpD,KAAK,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,cAAc,EAAE,CAAC;QAC5C,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC1D,CAAC;IAED,kEAAkE;IAClE,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACvF,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IACrF,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAEpF,uEAAuE;IACvE,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,IAAI,sBAAsB,CAAC;IAC3D,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;QAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,8BAA8B,EAAE,CAAC;IACrE,CAAC;IAED,oEAAoE;IACpE,OAAO,UAAU,EAAE,CAAC;AACtB,CAAC"}
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../src/cli/orchestration/policy.ts"],"names":[],"mappings":"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"}

package/dist/cli/orchestration/signals.js

@@ -0,0 +1,96 @@
+/**
+ * orchestration/signals — t23 (§P1.E × PW §9): shared vocabulary + signal
+ * tables for the deterministic OrchestrationDecision v2.
+ *
+ * LEAF MODULE on purpose: it imports nothing (not even other cli files) so
+ * both orchestration/policy.ts and kraken/delegationPolicy.ts can consume the
+ * strategy union without creating an import cycle. Pure data + pure fns only.
+ *
+ * Strategy ladder (escalation order — see policy.ts decision table):
+ *   lead-only      one focused dev, no tentacles.
+ *   explore        read/search-oriented work, still single harness.
+ *   lead+verify    implement + mandatory verify pass.
+ *   parallel-build multiple disjoint slices → tentacles preferred.
+ *   graph          high risk / cross-cutting → plan-graph level care.
+ *   council        ONLY with the design-conflict trigger (never invented).
+ */
+/** Fine-grained v2 strategies (supersedes the v1 two-value surface only —
+ * `surface` remains for operator logs and back-compat). */
+export const ORCHESTRATION_STRATEGIES = [
+    'lead-only',
+    'explore',
+    'lead+verify',
+    'parallel-build',
+    'graph',
+    'council',
+];
+/** Monotonic complexity rank: a failure/risk bump may raise but never lower. */
+export const STRATEGY_RANK = {
+    'lead-only': 0,
+    explore: 1,
+    'lead+verify': 2,
+    'parallel-build': 3,
+    graph: 4,
+    council: 5,
+};
+/**
+ * estimatedLatency heuristic (UNIT: milliseconds, ORDER-OF-MAGNITUDE ONLY —
+ * NOT a prediction): rough cost of a typical single-turn run per strategy,
+ * measured-in-the-head at authoring time and kept monotonic with
+ * STRATEGY_RANK. Used by telemetry dashboards and tests to compare relative
+ * orchestration weight, never to promise wall-clock behavior.
+ */
+export const ESTIMATED_LATENCY_MS = {
+    'lead-only': 15_000,
+    explore: 45_000,
+    'lead+verify': 120_000,
+    'parallel-build': 360_000,
+    graph: 720_000,
+    council: 900_000,
+};
+/** strategy → headless dispatch surface (mode-selection input). */
+export function strategySurface(strategy) {
+    if (strategy === 'council')
+        return 'council';
+    if (STRATEGY_RANK[strategy] >= STRATEGY_RANK['lead+verify'])
+        return 'kraken';
+    return 'solo';
+}
+/**
+ * Heavy-intent signals (t12 table carried over verbatim, now tagged with a
+ * stable rationaleCode). Evaluated FIRST: heavy intent outranks any light
+ * signal below.
+ */
+export const HEAVY_SIGNALS = [
+    { re: /\bimplement(?:s|ed|ing)?\b/i, code: 'implementation_signal' },
+    { re: /\brefactor(?:ing|ed)?\b/i, code: 'refactor_signal' },
+    { re: /\bmigrat(?:e|es|ed|ion|ing)\b/i, code: 'migration_signal' },
+    {
+        re: /\b(?:add|build|create|introduce)\b[^.?!]{0,48}\b(?:feature|endpoint|module|service|command|api|registry|runtime)\b/i,
+        code: 'new_capability_signal',
+    },
+    {
+        re: /\b(?:unit|integration|e2e|end-to-end)\s+(?:tests?|testing|specs?)\b|\bwrite\s+(?:the\s+|some\s+)?tests?\b/i,
+        code: 'test_writing_signal',
+    },
+];
+/**
+ * Counted artifacts ("Split the helpers into 4 files") — evidence of several
+ * DISJOINT targets, i.e. parallelism potential (rank ≥ parallel-build).
+ */
+export const MULTI_ARTIFACT_RE = /\b\d+\s*-?\s*(?:files?|modules?|packages?|components?|services?|endpoints?|worktrees?)\b/i;
+/** Cross-cutting scope phrases → graph-level care regardless of verb. */
+export const CROSS_CUTTING_RE = /\b(?:across|spanning|between|touching)\s+(?:all\s+|the\s+)?(?:\w+\s+){0,2}(?:files|modules|packages|layers|surfaces)\b/i;
+/** Question-shaped prompt: trailing '?' or a leading interrogative/modal. */
+export const QUESTION_RE = /\?\s*$|^(?:who|what|why|when|where|which|how|is|are|was|were|does|do|did|can|could|should|would|will)\b/i;
+export const EXPLAIN_RE = /\b(?:explain|describe|summarize|summarise|clarify|walk\W*me\W*through)\b/i;
+export const READONLY_RE = /\b(?:find|show|list|grep|search|locate|inspect|read|check|review|where\W+is)\b/i;
+/** Ambiguity markers: task asks for judgment on unclear/conflicting ground. */
+export const AMBIGUOUS_RE = /\b(?:ambiguous|ambiguity|unclear|vague|contradict(?:ory|ions?)?|conflicts?\b|trade[- ]?offs?\b|not\s+sure|unsure)\b/i;
+/**
+ * Design-intent nouns for the (ONLY) council trigger: "plan/design/architect"
+ * wording CO-OCCURRING with ambiguity markers above ⇒ multi-member review.
+ * Both halves required — neither alone ever selects council.
+ */
+export const DESIGN_RE = /\b(?:design|architecture|architect(?:ure)?\b|approach|proposal|blueprint)/i;
+//# sourceMappingURL=signals.js.map

package/dist/cli/orchestration/signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.js","sourceRoot":"","sources":["../../../src/cli/orchestration/signals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;2DAC2D;AAC3D,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,WAAW;IACX,SAAS;IACT,aAAa;IACb,gBAAgB;IAChB,OAAO;IACP,SAAS;CACD,CAAC;AAOX,gFAAgF;AAChF,MAAM,CAAC,MAAM,aAAa,GAAoD;IAC5E,WAAW,EAAE,CAAC;IACd,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,CAAC;IAChB,gBAAgB,EAAE,CAAC;IACnB,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;CACX,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAoD;IACnF,WAAW,EAAE,MAAM;IACnB,OAAO,EAAE,MAAM;IACf,aAAa,EAAE,OAAO;IACtB,gBAAgB,EAAE,OAAO;IACzB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,OAAO;CACjB,CAAC;AAEF,mEAAmE;AACnE,MAAM,UAAU,eAAe,CAAC,QAA+B;IAC7D,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,aAAa,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC7E,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAgD;IACxE,EAAE,EAAE,EAAE,6BAA6B,EAAE,IAAI,EAAE,uBAAuB,EAAE;IACpE,EAAE,EAAE,EAAE,0BAA0B,EAAE,IAAI,EAAE,iBAAiB,EAAE;IAC3D,EAAE,EAAE,EAAE,gCAAgC,EAAE,IAAI,EAAE,kBAAkB,EAAE;IAClE;QACE,EAAE,EAAE,qHAAqH;QACzH,IAAI,EAAE,uBAAuB;KAC9B;IACD;QACE,EAAE,EAAE,4GAA4G;QAChH,IAAI,EAAE,qBAAqB;KAC5B;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAC5B,2FAA2F,CAAC;AAE9F,yEAAyE;AACzE,MAAM,CAAC,MAAM,gBAAgB,GAC3B,yHAAyH,CAAC;AAE5H,6EAA6E;AAC7E,MAAM,CAAC,MAAM,WAAW,GACtB,0GAA0G,CAAC;AAE7G,MAAM,CAAC,MAAM,UAAU,GAAG,2EAA2E,CAAC;AAEtG,MAAM,CAAC,MAAM,WAAW,GAAG,iFAAiF,CAAC;AAE7G,+EAA+E;AAC/E,MAAM,CAAC,MAAM,YAAY,GACvB,sHAAsH,CAAC;AAEzH;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,4EAA4E,CAAC"}