@wrongstack/core 0.298.3 → 0.300.0

package/dist/design/index.js

@@ -91,7 +91,9 @@ function safeProfileName(name) {
 function activeProfileName(globalRoot) {
   try {
     const parsed = JSON.parse(fs.readFileSync(path.join(globalRoot, "config.json"), "utf8"));
-    return safeProfileName(typeof parsed.activeProfile === "string" ? parsed.activeProfile : void 0);
+    return safeProfileName(
+      typeof parsed.activeProfile === "string" ? parsed.activeProfile : void 0
+    );
   } catch {
     return "default";
   }
@@ -171,6 +173,7 @@ function resolveWstackPaths(opts) {
     projectPlan: path.join(projectDir, "plan.json"),
     projectAutophase: path.join(projectDir, "autophase"),
     projectSddBoards: path.join(projectDir, "sdd-boards"),
+    projectRequirementIntakes: path.join(projectDir, "requirement-intakes"),
     syncConfig: path.join(profileDir, "sync.json"),
     configHistoryDir: path.join(globalRoot, "config-history"),
     projectStatus: (projectHash2) => path.join(globalRoot, "projects", projectHash2, "status.json")

package/dist/execution/autonomy-brain.d.ts

@@ -218,6 +218,8 @@ export declare function completeBrainLlm(target: BrainLlmTarget, input: {
     user: string;
     timeoutMs: number;
     maxTokens?: number | undefined;
+    /** External cancellation (e.g. a council's overall budget or user abort). */
+    signal?: AbortSignal | undefined;
 }): Promise<string>;
 /** Text plus the observable call metadata a trace/quality gate needs. */
 interface BrainLlmCallResult {
@@ -237,12 +239,17 @@ interface BrainLlmCallResult {
  * Usage was previously thrown away at this boundary, which is why the council
  * adapter reported hardcoded zero tokens for every seat and why "what do
  * Brain decisions cost" had no answer.
+ *
+ * The per-call timeout is composed with any caller-supplied `signal` so an
+ * external abort (the council's overall budget, a user cancel) interrupts an
+ * in-flight provider call instead of waiting out the per-call timeout.
  */
 export declare function completeBrainLlmDetailed(target: BrainLlmTarget, input: {
     system: string;
     user: string;
     timeoutMs: number;
     maxTokens?: number | undefined;
+    signal?: AbortSignal | undefined;
 }): Promise<BrainLlmCallResult>;
 /**
  * Output budget for a Brain decision call.

package/dist/execution/council-brain.d.ts

@@ -13,10 +13,15 @@
  *   - maintainer   — evaluates complexity, compatibility, long-term ownership.
  *   - user-advocate — evaluates from the affected user's perspective.
  *
+ * Any other persona string is registered as an ad-hoc lens instead of being
+ * rejected — see `resolvePersonaRegistry`.
+ *
  * @module council-brain
  */
 import type { BrainArbiter, BrainDecisionRequest } from '../coordination/brain.js';
+import { type BrainLlmTarget } from './autonomy-brain.js';
 import type { EventBus } from '../kernel/events.js';
+import type { CouncilLLMCaller } from '../types/council.js';
 import type { Provider } from '../types/provider.js';
 /**
  * Refusal option id used by the Brain adapter. Re-exported from the
@@ -30,8 +35,9 @@ export interface CouncilVoter {
     /** Model id this voter uses. */
     model: string;
     /**
-     * Decision lens. Built-ins: 'executor', 'skeptic', 'auditor'. Any other
-     * string is injected verbatim as the persona description.
+     * Decision lens. Built-ins: 'executor', 'skeptic', 'auditor', 'security',
+     * 'maintainer', 'user-advocate'. Any other string is registered as an ad-hoc
+     * lens whose instruction is the string itself (see `resolvePersonaRegistry`).
      */
     persona?: string | undefined;
     /** Vote weight. Default 1. */
@@ -71,6 +77,15 @@ export interface CouncilBrainOptions {
      */
     traceContent?: boolean | undefined;
 }
+/**
+ * Build the per-seat LLM caller that wraps `completeBrainLlmDetailed` for
+ * one BrainLlmTarget. Exported so tests can drive the exact production
+ * wiring: it forwards the orchestrator's `input.signal` (overall budget +
+ * caller cancellation) into the provider call so an in-flight seat is
+ * interrupted on timeout/cancel instead of running out its per-call
+ * timeout.
+ */
+export declare function makeSeatCallerForVoter(target: BrainLlmTarget): CouncilLLMCaller;
 /**
  * Create a council-of-LLMs Brain arbiter backed by CouncilOrchestrator
  * with per-seat LLM callers — each voter's own Provider is used for its

package/dist/execution/council-orchestrator.d.ts

@@ -53,17 +53,36 @@ export declare class CouncilOrchestrator {
     private readonly fallbackProfileManager;
     private readonly seatCaller;
     private readonly judgeCaller;
+    /**
+     * Normalized ad-hoc profiles keyed by the caller's config object identity.
+     * The Brain adapter reuses ONE profile object for every decision, so this
+     * avoids re-validating + re-freezing it on every ask() without caching
+     * string-keyed registry lookups (those are already O(1)).
+     *
+     * Hosts must treat ad-hoc profile configs as IMMUTABLE once passed to
+     * ask(): the cache is keyed by object identity and never invalidated, so
+     * mutating a cached profile would silently serve the first snapshot.
+     */
+    private readonly profileCache;
     constructor(opts: CouncilOrchestratorOptions);
+    /**
+     * Resolve the effective profile for a question. String ids and the default
+     * go through the registry (already O(1)); ad-hoc config objects are
+     * normalized once per stable object identity and cached, because hosts such
+     * as the Brain adapter pass the same profile object on every ask().
+     */
+    private resolveProfile;
     ask(question: CouncilQuestion): Promise<CouncilResult>;
     private callSeat;
     private resolveOptionQuestion;
     private resolveOpenQuestion;
     private callJudge;
     /**
-     * Resolve the effective LLM caller for a call. Voter seats use
-     * `seatCaller(seatIndex)` when wired. Judge seats (seatIndex undefined)
-     * use `judgeCaller` if set, otherwise `seatCaller(0)` if set, otherwise
-     * the shared `caller`.
+     * Resolve the effective LLM caller for a call. Voter seats (defined
+     * seatIndex) use `seatCaller(seatIndex)` when wired, otherwise the shared
+     * `caller` — a seat never falls through to the judge caller. Judge seats
+     * (seatIndex undefined) use `judgeCaller` if set, otherwise `seatCaller(0)`
+     * if set, otherwise the shared `caller`.
      */
     private resolveCaller;
     private safeCall;

package/dist/execution/council-personas.d.ts

@@ -1,6 +1,16 @@
 import type { CouncilPersona } from '../types/council.js';
 /** Provider-neutral personas shipped with every Council installation. */
 export declare const BUILTIN_COUNCIL_PERSONAS: readonly CouncilPersona[];
+/**
+ * Built-in persona ids in display order.
+ *
+ * The single source every surface cycles through. The TUI panel, the WebUI
+ * settings section and `/brain council` each used to hard-code
+ * `['executor','skeptic','auditor']`, which is why `security`, `maintainer`
+ * and `user-advocate` shipped in the registry but were unreachable from any
+ * UI — exactly the lenses `risk-review` is built around.
+ */
+export declare const BUILTIN_COUNCIL_PERSONA_IDS: readonly string[];
 /** Immutable registry of trusted Council persona definitions. */
 export declare class CouncilPersonaRegistry {
     private readonly byId;

package/dist/execution/council-prompts.d.ts

@@ -1,4 +1,4 @@
-import type { CouncilPersona, CouncilQuestion, CouncilVoteResult, ResolvedCouncilSeat } from '../types/council.js';
+import type { CouncilOption, CouncilPersona, CouncilQuestion, CouncilVoteResult, ResolvedCouncilSeat } from '../types/council.js';
 export declare const COUNCIL_VOTER_PROMPT_PATH = "llm/council-voter.md";
 export declare const COUNCIL_JUDGE_PROMPT_PATH = "llm/council-judge.md";
 /** Build the trusted system instruction for one independent seat. */
@@ -18,4 +18,15 @@ export declare function buildCouncilJudgeUserPrompt(question: CouncilQuestion, v
     reason?: string | undefined;
     refusalOptionId?: string | undefined;
 }): string;
+/**
+ * Validate a Council option list; returns human-readable problems (empty
+ * array = valid). Single source of the id/label/duplicate rules shared by the
+ * `council` tool validator (fixable errors returned to the caller) and the
+ * prompt builder (which throws with every problem joined).
+ *
+ * Note: empty ids are added to the `seen` set, so two empty-id options also
+ * report `Duplicate option id ""` next to the empty-id error — harmless noise
+ * that preserves the historical tool-validator behavior exactly.
+ */
+export declare function validateCouncilOptions(options: readonly CouncilOption[] | undefined): string[];
 //# sourceMappingURL=council-prompts.d.ts.map

package/dist/execution/index.d.ts

@@ -7,7 +7,7 @@ export { BRAIN_EVALUATION_CASE_VERSION, type BrainEvaluationCaseResult, type Bra
 export { type BrainApplyResult, type BrainConfigPatch, type BrainConfigSnapshot, type BrainCouncilMinRisk, type BrainCouncilPatch, type BrainDefaultsContext, type BrainPoolStrategy, type BrainRuntime, type BrainRuntimeLedgerHost, type BrainRuntimeOptions, createBrainRuntime, resolveBrainConfigDefaults, } from './brain-runtime.js';
 export { COUNCIL_REFUSE_OPTION_ID, type CouncilBrainOptions, type CouncilVoter, createCouncilBrainArbiter, } from './council-brain.js';
 export { type CouncilResolution, type CouncilResolutionInput, type CouncilResolutionSeat, type CouncilResolutionVote, resolveCouncilVotes, } from './council-resolution.js';
-export { BUILTIN_COUNCIL_PERSONAS, CouncilPersonaRegistry, createCouncilPersonaRegistry, DEFAULT_COUNCIL_PERSONA_REGISTRY, } from './council-personas.js';
+export { BUILTIN_COUNCIL_PERSONA_IDS, BUILTIN_COUNCIL_PERSONAS, CouncilPersonaRegistry, createCouncilPersonaRegistry, DEFAULT_COUNCIL_PERSONA_REGISTRY, } from './council-personas.js';
 export { BUILTIN_COUNCIL_PROFILES, CouncilProfileRegistry, createCouncilProfileRegistry, DEFAULT_COUNCIL_APPROVAL_FRACTION, DEFAULT_COUNCIL_JUDGE_MAX_TOKENS, DEFAULT_COUNCIL_OVERALL_TIMEOUT_MS, DEFAULT_COUNCIL_PER_CALL_TIMEOUT_MS, DEFAULT_COUNCIL_PROFILE_REGISTRY, DEFAULT_COUNCIL_QUORUM_FRACTION, DEFAULT_COUNCIL_VOTER_MAX_TOKENS, normalizeCouncilProfile, resolveCouncilProfile, } from './council-profiles.js';
 export { buildCouncilJudgeSystemPrompt, buildCouncilJudgeUserPrompt, buildCouncilQuestionPrompt, buildCouncilVoterSystemPrompt, buildCouncilVoterUserPrompt, COUNCIL_JUDGE_PROMPT_PATH, COUNCIL_VOTER_PROMPT_PATH, } from './council-prompts.js';
 export { COUNCIL_REFUSAL_OPTION_ID, CouncilOrchestrator, type CouncilOrchestratorOptions, DEFAULT_COUNCIL_MAX_CONCURRENCY, MAX_COUNCIL_CONCURRENCY, } from './council-orchestrator.js';