@pellux/goodvibes-sdk 0.37.1 → 0.38.0

package/dist/platform/agents/turn-knowledge-injection.d.ts

@@ -0,0 +1,107 @@
+import type { ProviderMessage } from '../providers/interface.js';
+import type { MemoryRecord, MemoryRegistry, MemorySemanticSearchResult, MemoryVectorStats } from '../state/index.js';
+/**
+ * Default per-turn injection budget: min(800 tokens, 3% of the model's context window).
+ * 800 is the static floor for models with an unknown/zero context window (0 short-circuits
+ * the percentage term); the percentage term keeps the block a small, bounded slice of the
+ * turn's own budget for large-context models rather than a fixed absolute cost.
+ */
+export declare const DEFAULT_TURN_KNOWLEDGE_BUDGET_TOKENS = 800;
+/**
+ * Default relevance floor: the minimum `scoreKnowledge` score required to survive stage 2
+ * filtering (stage 1 is the existing confidence>=55 gate inside selectKnowledgeForTaskScored).
+ * Derived directly from the scoreKnowledge weights (knowledge-injection.ts) rather than
+ * picked arbitrarily: a record sitting exactly at the confidence floor (55) with the
+ * weakest positive reviewState bonus ('fresh', +20) that matches at least one task token
+ * (+20) scores 55 + 20 + 20 = 95. Below that, a record is either under-confidence, has no
+ * reviewState credit, or matched nothing about the current turn — filler, not relevance.
+ */
+export declare const DEFAULT_TURN_KNOWLEDGE_RELEVANCE_FLOOR = 95;
+/** Default candidate breadth passed through to selectKnowledgeForTaskScored. */
+export declare const DEFAULT_TURN_KNOWLEDGE_LIMIT = 3;
+/** Bounded ring size for AgentRecord.turnInjections (see recordTurnInjection). */
+export declare const DEFAULT_TURN_INJECTION_RING_SIZE = 20;
+export declare function defaultTurnKnowledgeBudgetTokens(contextWindow: number): number;
+/**
+ * Per-turn honesty record for one agent turn's passive-injection attempt. Stored on
+ * `AgentRecord.turnInjections` (bounded ring) and appended verbatim to the agent's
+ * session transcript (`{type:'knowledge_injection', turn, ...record}`) — no new
+ * event-contract member, per the brief's "prefer existing-event reuse" constraint.
+ */
+export interface TurnInjectionRecord {
+    /** The agent turn number this retrieval ran on. */
+    readonly turn: number;
+    /** The derived query actually sent through the ranking pipeline (task + conversation tail). */
+    readonly query: string;
+    /** Count of scored, confidence-gated, not-already-injected candidates considered this turn. */
+    readonly candidatesConsidered: number;
+    /** Record ids actually injected into the prompt this turn (empty when block===null). */
+    readonly injectedIds: readonly string[];
+    /** Record ids that cleared the relevance floor but were dropped to fit the token budget. */
+    readonly droppedForBudget: readonly string[];
+    /** Estimated token cost of the rendered block (0 when block===null). */
+    readonly tokenCost: number;
+    /** The token budget this turn was evaluated against. */
+    readonly budgetTokens: number;
+    /** The relevance floor this turn was evaluated against. */
+    readonly relevanceFloor: number;
+    /** Ingest mode (keyword/semantic/hybrid) of each injected record, same order as injectedIds. */
+    readonly ingestModes: readonly string[];
+    /** Honest embeddings signal: 'available' when the registry's vector index is enabled and
+     *  usable, 'fallback-lexical' when memory-store.ts's searchSemantic() degraded to keyword
+     *  ranking (no vector index, or the registry does not expose vectorStats at all). */
+    readonly embeddingBackend: 'available' | 'fallback-lexical';
+    /** Present exactly when block===null: why nothing was injected. */
+    readonly reason?: string | undefined;
+}
+/**
+ * Structural registry surface, mirroring knowledge-injection.ts's private
+ * `KnowledgeRegistrySource` plus one addition: optional `vectorStats`, the sole signal this
+ * module uses to tell a real semantic search apart from memory-store.ts's silent lexical
+ * fallback (searchSemantic() never throws on a missing/disabled vector index — it just
+ * degrades to keyword ranking). Kept structural (not `Pick<MemoryRegistry, ...>`) so tests
+ * can supply a minimal fake without constructing a real MemoryStore/SQLite.
+ */
+export type TurnKnowledgeRegistrySource = {
+    getAll(): readonly MemoryRecord[];
+    searchSemantic?(input: Parameters<MemoryRegistry['searchSemantic']>[0]): readonly MemorySemanticSearchResult[];
+    vectorStats?(): MemoryVectorStats;
+};
+export interface BuildPerTurnKnowledgeInjectionInput {
+    readonly memoryRegistry: TurnKnowledgeRegistrySource;
+    /** The agent's (possibly frozen) task text — always included in the derived query. */
+    readonly task: string;
+    readonly writeScope?: readonly string[] | undefined;
+    /** The current conversation, formatted for the LLM — the source of "what changed this turn". */
+    readonly conversationTail: readonly ProviderMessage[];
+    /** Hard token budget for the rendered block. budgetTokens<=0 is the caller's job to no-op on;
+     *  this function still honors it correctly (an empty/null block, honest record). */
+    readonly budgetTokens: number;
+    readonly relevanceFloor: number;
+    readonly limit?: number | undefined;
+    /** Ids never to re-list (the spawn-time baseline plus every id injected on prior turns). */
+    readonly alreadyInjectedIds: readonly string[];
+    readonly turn: number;
+}
+export interface BuildPerTurnKnowledgeInjectionResult {
+    readonly block: string | null;
+    readonly record: TurnInjectionRecord;
+}
+/**
+ * The one behavioral difference from spawn-time selection: derive the query from the
+ * LATEST user-role message in the conversation tail (a steer, a drained directive, or —
+ * on turn 1, before any steer exists — the initial task itself) concatenated with the
+ * task, instead of the task alone. On turn 1 the latest user message IS the task (the
+ * runner seeds it via `conversation.addUserMessage(record.task)` before the turn loop),
+ * so this collapses to the task with no duplication.
+ */
+export declare function deriveTurnKnowledgeQuery(task: string, conversationTail: readonly ProviderMessage[]): string;
+export declare function buildPerTurnKnowledgeInjection(input: BuildPerTurnKnowledgeInjectionInput): BuildPerTurnKnowledgeInjectionResult;
+/**
+ * Push one entry onto a bounded ring, evicting the oldest entry once
+ * `retention` is exceeded. Pure and exported so it is independently
+ * unit-testable (and so orchestrator-runner.ts never has to hand-roll ring
+ * eviction inline).
+ */
+export declare function recordTurnInjection(existing: readonly TurnInjectionRecord[] | undefined, entry: TurnInjectionRecord, retention?: number): TurnInjectionRecord[];
+//# sourceMappingURL=turn-knowledge-injection.d.ts.map

package/dist/platform/agents/turn-knowledge-injection.d.ts.map

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

package/dist/platform/agents/turn-knowledge-injection.js

@@ -0,0 +1,152 @@
+import { estimateTokens } from '../core/context-compaction.js';
+import { buildKnowledgeInjectionPrompt, selectKnowledgeForTaskScored } from '../state/index.js';
+/**
+ * Default per-turn injection budget: min(800 tokens, 3% of the model's context window).
+ * 800 is the static floor for models with an unknown/zero context window (0 short-circuits
+ * the percentage term); the percentage term keeps the block a small, bounded slice of the
+ * turn's own budget for large-context models rather than a fixed absolute cost.
+ */
+export const DEFAULT_TURN_KNOWLEDGE_BUDGET_TOKENS = 800;
+/**
+ * Default relevance floor: the minimum `scoreKnowledge` score required to survive stage 2
+ * filtering (stage 1 is the existing confidence>=55 gate inside selectKnowledgeForTaskScored).
+ * Derived directly from the scoreKnowledge weights (knowledge-injection.ts) rather than
+ * picked arbitrarily: a record sitting exactly at the confidence floor (55) with the
+ * weakest positive reviewState bonus ('fresh', +20) that matches at least one task token
+ * (+20) scores 55 + 20 + 20 = 95. Below that, a record is either under-confidence, has no
+ * reviewState credit, or matched nothing about the current turn — filler, not relevance.
+ */
+export const DEFAULT_TURN_KNOWLEDGE_RELEVANCE_FLOOR = 95;
+/** Default candidate breadth passed through to selectKnowledgeForTaskScored. */
+export const DEFAULT_TURN_KNOWLEDGE_LIMIT = 3;
+/** Bounded ring size for AgentRecord.turnInjections (see recordTurnInjection). */
+export const DEFAULT_TURN_INJECTION_RING_SIZE = 20;
+export function defaultTurnKnowledgeBudgetTokens(contextWindow) {
+    if (!Number.isFinite(contextWindow) || contextWindow <= 0) {
+        return DEFAULT_TURN_KNOWLEDGE_BUDGET_TOKENS;
+    }
+    return Math.min(DEFAULT_TURN_KNOWLEDGE_BUDGET_TOKENS, Math.floor(contextWindow * 0.03));
+}
+function extractTextContent(content) {
+    if (typeof content === 'string')
+        return content;
+    return content
+        .filter((part) => part.type === 'text')
+        .map((part) => part.text)
+        .join(' ');
+}
+/**
+ * The one behavioral difference from spawn-time selection: derive the query from the
+ * LATEST user-role message in the conversation tail (a steer, a drained directive, or —
+ * on turn 1, before any steer exists — the initial task itself) concatenated with the
+ * task, instead of the task alone. On turn 1 the latest user message IS the task (the
+ * runner seeds it via `conversation.addUserMessage(record.task)` before the turn loop),
+ * so this collapses to the task with no duplication.
+ */
+export function deriveTurnKnowledgeQuery(task, conversationTail) {
+    let latestUserContent = '';
+    for (let i = conversationTail.length - 1; i >= 0; i--) {
+        const message = conversationTail[i];
+        if (message?.role === 'user') {
+            latestUserContent = extractTextContent(message.content).trim();
+            break;
+        }
+    }
+    const trimmedTask = task.trim();
+    if (!latestUserContent || latestUserContent === trimmedTask) {
+        return trimmedTask;
+    }
+    return `${trimmedTask} ${latestUserContent}`.trim();
+}
+function resolveEmbeddingBackend(registry) {
+    const stats = registry.vectorStats?.();
+    if (!stats)
+        return 'fallback-lexical';
+    return stats.enabled && stats.available ? 'available' : 'fallback-lexical';
+}
+export function buildPerTurnKnowledgeInjection(input) {
+    const { memoryRegistry, task, writeScope = [], conversationTail, budgetTokens, relevanceFloor, limit = DEFAULT_TURN_KNOWLEDGE_LIMIT, alreadyInjectedIds, turn, } = input;
+    const query = deriveTurnKnowledgeQuery(task, conversationTail);
+    const alreadyInjectedIdSet = new Set(alreadyInjectedIds);
+    const embeddingBackend = resolveEmbeddingBackend(memoryRegistry);
+    const scored = selectKnowledgeForTaskScored(memoryRegistry, query, writeScope, limit)
+        .filter((entry) => !alreadyInjectedIdSet.has(entry.injection.id));
+    const candidatesConsidered = scored.length;
+    const clearedFloor = scored.filter((entry) => entry.score >= relevanceFloor).slice(0, limit);
+    if (clearedFloor.length === 0) {
+        return {
+            block: null,
+            record: {
+                turn,
+                query,
+                candidatesConsidered,
+                injectedIds: [],
+                droppedForBudget: [],
+                tokenCost: 0,
+                budgetTokens,
+                relevanceFloor,
+                ingestModes: [],
+                embeddingBackend,
+                reason: 'no records cleared relevance floor',
+            },
+        };
+    }
+    // Greedy budget trim: clearedFloor is already sorted best-first (selectKnowledgeForTaskScored's
+    // contract), so dropping from the tail always drops the lowest-scored surviving entry.
+    const kept = [...clearedFloor];
+    const droppedForBudget = [];
+    let tokenCost = estimateTokens(buildKnowledgeInjectionPrompt(kept.map((entry) => entry.injection)) ?? '');
+    while (kept.length > 0 && tokenCost > budgetTokens) {
+        const removed = kept.pop();
+        if (!removed)
+            break;
+        droppedForBudget.push(removed.injection.id);
+        tokenCost = kept.length > 0
+            ? estimateTokens(buildKnowledgeInjectionPrompt(kept.map((entry) => entry.injection)) ?? '')
+            : 0;
+    }
+    if (kept.length === 0) {
+        return {
+            block: null,
+            record: {
+                turn,
+                query,
+                candidatesConsidered,
+                injectedIds: [],
+                droppedForBudget,
+                tokenCost: 0,
+                budgetTokens,
+                relevanceFloor,
+                ingestModes: [],
+                embeddingBackend,
+                reason: 'single highest-scoring record exceeds budget',
+            },
+        };
+    }
+    const block = buildKnowledgeInjectionPrompt(kept.map((entry) => entry.injection));
+    return {
+        block,
+        record: {
+            turn,
+            query,
+            candidatesConsidered,
+            injectedIds: kept.map((entry) => entry.injection.id),
+            droppedForBudget,
+            tokenCost,
+            budgetTokens,
+            relevanceFloor,
+            ingestModes: kept.map((entry) => entry.injection.ingestMode),
+            embeddingBackend,
+        },
+    };
+}
+/**
+ * Push one entry onto a bounded ring, evicting the oldest entry once
+ * `retention` is exceeded. Pure and exported so it is independently
+ * unit-testable (and so orchestrator-runner.ts never has to hand-roll ring
+ * eviction inline).
+ */
+export function recordTurnInjection(existing, entry, retention = DEFAULT_TURN_INJECTION_RING_SIZE) {
+    const next = existing ? [...existing, entry] : [entry];
+    return next.length > retention ? next.slice(next.length - retention) : next;
+}

package/dist/platform/agents/wrfc-controller.d.ts

@@ -96,6 +96,29 @@ export declare class WrfcController {
      * Returns true if the chain was imported, false if refused.
      */
     importChain(chain: WrfcChain, force?: boolean): boolean;
+    /**
+     * Item d5 (Wave 6, wo-F): resurrection-safe zombie check for a chain about
+     * to be imported at rehydrate. A non-terminal chain whose ENTIRE roster
+     * (allAgentIds) is absent from THIS process's live AgentManager never
+     * survived the restart — no in-process execution is coming back to finish
+     * it, so it would otherwise show as "running" forever. If even ONE roster
+     * agent id IS live (e.g. re-imported mid-session, not at a real process
+     * restart), this returns false and the chain is left exactly as imported —
+     * reaping only ever fires when NOTHING could possibly still be driving it.
+     */
+    private isZombieChain;
+    /**
+     * Item d5: mark a reimported zombie chain terminal at import time so it
+     * presents as failed + prunable instead of stuck non-terminal forever.
+     * Deliberately does NOT call failChain()/cancelChain(): those assume a
+     * live in-memory execution (cancel running children, complete the owner
+     * agent record, re-check gates for siblings) that makes no sense for a
+     * chain whose entire roster is already confirmed dead — this is a direct,
+     * minimal field mutation plus the same state-changed/chain-failed events
+     * every other terminal transition emits, so consumers see one consistent
+     * "chain failed" signal regardless of which path produced it.
+     */
+    private reapZombieChain;
     dispose(): void;
     private transition;
     private applyWrfcAgentMetadata;

package/dist/platform/agents/wrfc-controller.d.ts.map

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

package/dist/platform/agents/wrfc-controller.js

@@ -296,7 +296,17 @@ export class WrfcController {
             });
             return false;
         }
+        // Insert into the chain map BEFORE reapZombieChain runs. reapZombieChain
+        // emits state-changed + chain-failed for a terminal transition, and every
+        // other terminal transition in this controller operates on a chain already
+        // present in this.chains — so a consumer that resolves the chain via
+        // getChain(id) in response to those events finds it, consistent with the
+        // rest of the lifecycle. (chain is a reference already held here, so
+        // setting first and then mutating it in reapZombieChain is equivalent.)
         this.chains.set(chain.id, chain);
+        if (!isChainTerminal(chain.state) && this.isZombieChain(chain)) {
+            this.reapZombieChain(chain);
+        }
         logger.info('WrfcController.importChain: chain imported', {
             chainId: chain.id,
             state: chain.state,
@@ -304,6 +314,51 @@ export class WrfcController {
         });
         return true;
     }
+    /**
+     * Item d5 (Wave 6, wo-F): resurrection-safe zombie check for a chain about
+     * to be imported at rehydrate. A non-terminal chain whose ENTIRE roster
+     * (allAgentIds) is absent from THIS process's live AgentManager never
+     * survived the restart — no in-process execution is coming back to finish
+     * it, so it would otherwise show as "running" forever. If even ONE roster
+     * agent id IS live (e.g. re-imported mid-session, not at a real process
+     * restart), this returns false and the chain is left exactly as imported —
+     * reaping only ever fires when NOTHING could possibly still be driving it.
+     */
+    isZombieChain(chain) {
+        if (chain.allAgentIds.length === 0)
+            return false;
+        return chain.allAgentIds.every((agentId) => this.agentManager.getStatus(agentId) === null);
+    }
+    /**
+     * Item d5: mark a reimported zombie chain terminal at import time so it
+     * presents as failed + prunable instead of stuck non-terminal forever.
+     * Deliberately does NOT call failChain()/cancelChain(): those assume a
+     * live in-memory execution (cancel running children, complete the owner
+     * agent record, re-check gates for siblings) that makes no sense for a
+     * chain whose entire roster is already confirmed dead — this is a direct,
+     * minimal field mutation plus the same state-changed/chain-failed events
+     * every other terminal transition emits, so consumers see one consistent
+     * "chain failed" signal regardless of which path produced it.
+     */
+    reapZombieChain(chain) {
+        const from = chain.state;
+        const reason = 'zombie chain reaped at rehydrate: no member agent survived the restart';
+        chain.state = 'failed';
+        chain.error = reason;
+        chain.failureKind = 'other';
+        chain.completedAt = Date.now();
+        emitWrfcStateChanged(this.runtimeBus, this.sessionId, chain.id, from, 'failed');
+        emitWorkflowChainFailed(this.runtimeBus, createWrfcWorkflowContext(this.sessionId, chain.id), {
+            chainId: chain.id,
+            reason,
+            failureKind: 'other',
+        });
+        logger.warn('WrfcController.importChain: reaped zombie chain — no member agent survived restart', {
+            chainId: chain.id,
+            priorState: from,
+            agentIds: chain.allAgentIds,
+        });
+    }
     dispose() {
         for (const unsub of this.unsubscribers)
             unsub();

package/dist/platform/config/manager.d.ts

@@ -103,6 +103,15 @@ export declare class ConfigManager {
      * The patch is shallow-merged into the existing category value.
      */
     mergeCategory<C extends keyof GoodVibesConfig>(category: C, patch: Partial<GoodVibesConfig[C]>): void;
+    /**
+     * Remove a key from an object-shaped category and auto-save.
+     *
+     * mergeCategory can only set keys (undefined patch values are skipped, and
+     * getCategory returns a clone, so delete-then-merge is a silent no-op) —
+     * clearing an override, e.g. a feature-flag entry back to its default,
+     * requires this explicit removal.
+     */
+    removeCategoryKey<C extends keyof GoodVibesConfig>(category: C, key: string): void;
     /**
      * Reset a specific key to its default, or reset all config.
      * Saves to disk after reset.

package/dist/platform/config/manager.d.ts.map

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

package/dist/platform/config/manager.js

@@ -314,6 +314,21 @@ export class ConfigManager {
         }
         this.save();
     }
+    /**
+     * Remove a key from an object-shaped category and auto-save.
+     *
+     * mergeCategory can only set keys (undefined patch values are skipped, and
+     * getCategory returns a clone, so delete-then-merge is a silent no-op) —
+     * clearing an override, e.g. a feature-flag entry back to its default,
+     * requires this explicit removal.
+     */
+    removeCategoryKey(category, key) {
+        const current = this.config[category];
+        if (!(key in current))
+            return;
+        delete current[key];
+        this.save();
+    }
     /**
      * Reset a specific key to its default, or reset all config.
      * Saves to disk after reset.

package/dist/platform/control-plane/approval-broker.d.ts

@@ -64,6 +64,7 @@ export declare class ApprovalBroker {
     resolveApproval(approvalId: string, input: {
         readonly approved: boolean;
         readonly remember?: boolean | undefined;
+        readonly modifiedArgs?: Record<string, unknown> | undefined;
         readonly actor: string;
         readonly actorSurface?: string | undefined;
         readonly note?: string | undefined;

package/dist/platform/control-plane/approval-broker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approval-broker.d.ts","sourceRoot":"","sources":["../../../src/platform/control-plane/approval-broker.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"approval-broker.d.ts","sourceRoot":"","sources":["../../../src/platform/control-plane/approval-broker.ts"],"names":[],"mappings":"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"}

package/dist/platform/control-plane/approval-broker.js

@@ -220,6 +220,7 @@ export class ApprovalBroker {
                 .then((decision) => this.resolveApproval(approval.id, {
                 approved: decision.approved,
                 remember: decision.remember,
+                modifiedArgs: decision.modifiedArgs,
                 actor: 'tui-local',
                 actorSurface: 'tui',
             }))
@@ -267,6 +268,7 @@ export class ApprovalBroker {
             decision: {
                 approved: input.approved,
                 ...(input.remember !== undefined ? { remember: input.remember } : {}),
+                ...(input.modifiedArgs !== undefined ? { modifiedArgs: input.modifiedArgs } : {}),
             },
             audit: [
                 ...approval.audit,

package/dist/platform/core/adaptive-planner.d.ts

@@ -9,6 +9,7 @@
  *           /plan explain
  *           /plan override <strategy>
  */
+import { type PlanProposal, type PlanProposalIssue, type RawDecomposition } from './plan-proposal.js';
 /**
  * The five supported execution strategies.
  *
@@ -52,6 +53,18 @@ export interface StrategyCandidate {
     score: number;
     reasonCode: StrategyReasonCode;
 }
+/**
+ * The outcome of the deterministic "does this task warrant decomposition?"
+ * gate. This is a semantic projection of the existing strategy selection —
+ * `decompose` is simply `selected !== 'single'` — so every existing reason
+ * code and the `/plan explain` output stay authoritative. No new scoring
+ * logic lives here.
+ */
+export interface DecompositionGate {
+    decompose: boolean;
+    strategy: ExecutionStrategy;
+    reasonCode: StrategyReasonCode;
+}
 /** The outcome of a planner selection pass. */
 export interface PlannerDecision {
     /** The strategy that was ultimately selected. */
@@ -86,6 +99,43 @@ export declare class AdaptivePlanner {
      * The decision is appended to the history log.
      */
     select(inputs: PlannerInputs): PlannerDecision;
+    /**
+     * Deterministic gate: does this task warrant decomposition into a
+     * multi-phase workstream, or is a single-item workstream the honest
+     * answer?
+     *
+     * This calls the existing `select()` pipeline — no new scoring logic — and
+     * projects the result: `decompose` is `selected !== 'single'`. Because it
+     * goes through `select()`, the decision is appended to the same audit
+     * history as every other planner call, and `/plan explain` / `/plan
+     * status` remain authoritative for it.
+     */
+    shouldDecompose(inputs: PlannerInputs): DecompositionGate;
+    /**
+     * Produce a typed `PlanProposal` for the given inputs.
+     *
+     * `AdaptivePlanner` never spawns a planning agent and never performs LLM
+     * decomposition itself — it only gates (via `shouldDecompose`) and
+     * validates/assembles (via `assemblePlanProposal`, in `plan-proposal.ts`).
+     * The raw decomposition, if any, is expected to come from a planning
+     * agent that the ORCHESTRATION ENGINE spawns and hands back here.
+     *
+     * - If the gate says decomposition is not warranted, or no raw
+     *   decomposition is available yet, this returns the honest single-item
+     *   fallback (`singleItemProposal`) — never a partially-assembled guess.
+     * - Otherwise it validates `raw` via `assemblePlanProposal`, which never
+     *   throws: malformed decompositions degrade to an honest partial result
+     *   plus a list of `issues`.
+     *
+     * Returns the `gate` alongside the proposal so callers (the engine, or the
+     * TUI) can show WHY a proposal was or wasn't decomposed, reusing
+     * `AdaptivePlanner.explainReasonCode`.
+     */
+    proposeWorkstream(inputs: PlannerInputs, raw?: RawDecomposition): {
+        proposal: PlanProposal;
+        gate: DecompositionGate;
+        issues: PlanProposalIssue[];
+    };
     /**
      * Set the operating mode for future calls to `select()`.
      *

package/dist/platform/core/adaptive-planner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adaptive-planner.d.ts","sourceRoot":"","sources":["../../../src/platform/core/adaptive-planner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEvF,yFAAyF;AACzF,eAAO,MAAM,gBAAgB,EAAE,iBAAiB,EAAyD,CAAC;AAE1G;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAE1B,oBAAoB,GACpB,4BAA4B,GAC5B,oBAAoB,GACpB,gBAAgB,GAChB,qBAAqB,GACrB,gBAAgB,GAChB,sBAAsB,GAEtB,eAAe,GACf,eAAe,GAEf,kBAAkB,CAAC;AAEvB,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB,8EAA8E;IAC9E,WAAW,EAAE,OAAO,CAAC;IAErB,8DAA8D;IAC9D,eAAe,EAAE,OAAO,CAAC;IAEzB,qEAAqE;IACrE,kBAAkB,EAAE,OAAO,CAAC;IAE5B,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,QAAQ,EAAE,iBAAiB,CAAC;IAE5B,6CAA6C;IAC7C,UAAU,EAAE,kBAAkB,CAAC;IAE/B,oDAAoD;IACpD,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAEhC,yEAAyE;IACzE,cAAc,EAAE,OAAO,CAAC;IAExB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAElB,iDAAiD;IACjD,MAAM,EAAE,aAAa,CAAC;CACvB;AAwGD,qBAAa,eAAe;IAC1B,mEAAmE;IACnE,OAAO,CAAC,gBAAgB,CAAkC;IAE1D,8CAA8C;IAC9C,OAAO,CAAC,IAAI,CAA6B;IAEzC,iEAAiE;IACjE,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAO;IAM1C;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,eAAe;IA+D9C;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAKtC,sCAAsC;IACtC,OAAO,IAAI,iBAAiB;IAI5B;;;;;;OAMG;IACH,QAAQ,CACN,QAAQ,EAAE,MAAM,GACf;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,QAAQ,EAAE,iBAAiB,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,UAAU,EAAE,kBAAkB,CAAA;KAAE;IAW5F,sCAAsC;IACtC,aAAa,IAAI,IAAI;IAKrB,mDAAmD;IACnD,WAAW,IAAI,OAAO;IAItB,oDAAoD;IACpD,WAAW,IAAI,iBAAiB,GAAG,IAAI;IAIvC;;;OAGG;IACH,OAAO,CAAC,UAAU,CAAC,EAAE,kBAAkB,GAAG,MAAM;IAShD,4DAA4D;IAC5D,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM;IAI1D,wDAAwD;IACxD,UAAU,CAAC,KAAK,SAAK,GAAG,eAAe,EAAE;IAIzC,gDAAgD;IAChD,SAAS,IAAI,eAAe,GAAG,IAAI;IAQnC;;;OAGG;IACH,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,0BAA0B;CA6BnC"}
+{"version":3,"file":"adaptive-planner.d.ts","sourceRoot":"","sources":["../../../src/platform/core/adaptive-planner.ts"],"names":[],"mappings":"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"}

package/dist/platform/core/adaptive-planner.js

@@ -10,6 +10,7 @@
  *           /plan override <strategy>
  */
 import { logger } from '../utils/logger.js';
+import { assemblePlanProposal, singleItemProposal, } from './plan-proposal.js';
 /** All valid strategy names (including 'auto'). Exported for use in command handlers. */
 export const VALID_STRATEGIES = ['auto', 'single', 'cohort', 'background', 'remote'];
 // ---------------------------------------------------------------------------
@@ -172,6 +173,54 @@ export class AdaptivePlanner {
         });
         return decision;
     }
+    /**
+     * Deterministic gate: does this task warrant decomposition into a
+     * multi-phase workstream, or is a single-item workstream the honest
+     * answer?
+     *
+     * This calls the existing `select()` pipeline — no new scoring logic — and
+     * projects the result: `decompose` is `selected !== 'single'`. Because it
+     * goes through `select()`, the decision is appended to the same audit
+     * history as every other planner call, and `/plan explain` / `/plan
+     * status` remain authoritative for it.
+     */
+    shouldDecompose(inputs) {
+        const decision = this.select(inputs);
+        return {
+            decompose: decision.selected !== 'single',
+            strategy: decision.selected,
+            reasonCode: decision.reasonCode,
+        };
+    }
+    /**
+     * Produce a typed `PlanProposal` for the given inputs.
+     *
+     * `AdaptivePlanner` never spawns a planning agent and never performs LLM
+     * decomposition itself — it only gates (via `shouldDecompose`) and
+     * validates/assembles (via `assemblePlanProposal`, in `plan-proposal.ts`).
+     * The raw decomposition, if any, is expected to come from a planning
+     * agent that the ORCHESTRATION ENGINE spawns and hands back here.
+     *
+     * - If the gate says decomposition is not warranted, or no raw
+     *   decomposition is available yet, this returns the honest single-item
+     *   fallback (`singleItemProposal`) — never a partially-assembled guess.
+     * - Otherwise it validates `raw` via `assemblePlanProposal`, which never
+     *   throws: malformed decompositions degrade to an honest partial result
+     *   plus a list of `issues`.
+     *
+     * Returns the `gate` alongside the proposal so callers (the engine, or the
+     * TUI) can show WHY a proposal was or wasn't decomposed, reusing
+     * `AdaptivePlanner.explainReasonCode`.
+     */
+    proposeWorkstream(inputs, raw) {
+        const gate = this.shouldDecompose(inputs);
+        const task = inputs.taskDescription ?? '';
+        if (gate.decompose && raw) {
+            const { proposal, issues } = assemblePlanProposal(task, gate.strategy, raw);
+            return { proposal, gate, issues };
+        }
+        return { proposal: singleItemProposal(task), gate, issues: [] };
+    }
     /**
      * Set the operating mode for future calls to `select()`.
      *