@pellux/goodvibes-sdk 0.37.1 → 0.38.0

package/dist/platform/runtime/fleet/types.d.ts

@@ -0,0 +1,199 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+/**
+ * Fleet types — the normalized process-tree contract for the live process
+ * registry (W2.1). One queryable + subscribable aggregation surface that
+ * enumerates every live/completed runtime process (agents incl. WRFC roles,
+ * WRFC chains + subtasks, workflow-tool FSMs/triggers/schedules, watchers,
+ * background processes) as flat `ProcessNode` records with parentId edges.
+ *
+ * Consumers (the TUI fleet tree, Wave-3 session tabs, Wave-4 orchestration
+ * nesting) build the tree from the flat list — this keeps the registry cheap
+ * and lets each surface reorder/filter independently.
+ */
+/** The source family a ProcessNode was adapted from. */
+export type ProcessKind = 'agent' | 'wrfc-chain' | 'wrfc-subtask' | 'workflow' | 'trigger' | 'schedule' | 'watcher' | 'background-process' | 'workstream' | 'phase' | 'work-item' | 'code-index';
+/**
+ * Derived fine-grained process state.
+ *
+ * Superset of the coarse manager statuses: `idle` and `queued` exist because
+ * ScheduleEntry-between-runs and pending agents need honest states rather
+ * than being force-fit into an active state.
+ *
+ * `interrupted` (Wave-3 verb formalization) is a distinct TERMINAL outcome
+ * from `killed`: both come from AgentManager.cancel(), but a graceful
+ * interrupt request and a hard kill are display-distinguishable via
+ * AgentRecord.terminationKind. There is no resume path — `cancel()` is
+ * terminal in the current SDK, so 'interrupted' does NOT mean "process still
+ * alive"; it means "the operator asked nicely" vs. "the operator killed it".
+ *
+ * `paused` (Wave 6, wo-F item d2) is NOT terminal and NOT the same as
+ * `killed`: a disabled trigger/schedule/automation-job still exists and can
+ * be re-armed via `ProcessRegistry.resume()` — collapsing it into `killed`
+ * (the pre-Wave-6 behavior) was dishonest, since `killed` implies the
+ * process is gone for good. See ProcessCapabilities.resumable.
+ */
+export type ProcessState = 'thinking' | 'executing-tool' | 'awaiting-approval' | 'streaming' | 'stalled' | 'retrying' | 'done' | 'failed' | 'killed' | 'interrupted' | 'idle' | 'queued' | 'paused';
+/** Token/call usage aggregated onto a node. Mirrors AgentRecord.usage + toolCallCount. */
+export interface ProcessUsage {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheReadTokens: number;
+    readonly cacheWriteTokens: number;
+    readonly reasoningTokens?: number | undefined;
+    readonly llmCallCount: number;
+    readonly turnCount: number;
+    readonly toolCallCount: number;
+}
+/** The most recent observable activity on a node (tool call, output line, or phase label). */
+export interface ProcessActivity {
+    readonly kind: 'tool' | 'output-line' | 'phase';
+    readonly text: string;
+    readonly toolName?: string | undefined;
+    /** Epoch ms when this activity was observed. Stable per activity (not per query). */
+    readonly at: number;
+}
+/** Which control operations the registry can dispatch for this node. */
+export interface ProcessCapabilities {
+    readonly interruptible: boolean;
+    readonly killable: boolean;
+    readonly pausable: boolean;
+    /**
+     * Wave 6 (wo-F item d2): whether `ProcessRegistry.resume()` can re-arm
+     * this node. True only for a node currently in the `paused` state whose
+     * source manager exposes an `enable` control (trigger, schedule,
+     * automation job) — false for every other kind/state, including a
+     * `killed` node (kill is one-way; there is no un-kill).
+     */
+    readonly resumable: boolean;
+    /**
+     * Wave-3: whether `ProcessRegistry.steer()` can queue a message for this
+     * node. True only for a live in-process agent (or a wrfc-subtask with a
+     * live member agent) AND only when the registry was constructed with a
+     * `messageBus` dep — false everywhere when that dep is absent (graceful
+     * degrade, no crash). Terminal nodes and non-conversational kinds
+     * (wrfc-chain, workflow, trigger, schedule, watcher, background-process)
+     * are never steerable.
+     */
+    readonly steerable: boolean;
+}
+/** Wave-3 tab attach point: session/agent identity for transcript drill-downs. */
+export interface ProcessSessionRef {
+    readonly sessionId?: string | undefined;
+    readonly agentId?: string | undefined;
+}
+/**
+ * Whether `costUsd` is a real reading.
+ * - 'priced'    — every contributing usage record resolved to catalog pricing.
+ * - 'unpriced'  — no pricing available; `costUsd` is null, never a fabricated zero.
+ * - 'estimated' — partial: some contributors priced, some not (aggregate nodes only).
+ */
+export type ProcessCostState = 'priced' | 'unpriced' | 'estimated';
+/** One normalized process in the fleet. Flat record; `parentId` expresses the tree. */
+export interface ProcessNode {
+    readonly id: string;
+    readonly kind: ProcessKind;
+    readonly parentId?: string | undefined;
+    readonly label: string;
+    readonly task?: string | undefined;
+    readonly state: ProcessState;
+    readonly startedAt?: number | undefined;
+    readonly completedAt?: number | undefined;
+    /** (completedAt ?? now) - startedAt when startedAt is known, else 0. */
+    readonly elapsedMs: number;
+    readonly usage?: ProcessUsage | undefined;
+    readonly model?: string | undefined;
+    readonly provider?: string | undefined;
+    readonly costUsd?: number | null | undefined;
+    readonly costState: ProcessCostState;
+    readonly currentActivity?: ProcessActivity | undefined;
+    readonly capabilities: ProcessCapabilities;
+    readonly sessionRef?: ProcessSessionRef | undefined;
+    /** Opaque source record (AgentRecord, WrfcChain, …) for drill-downs. */
+    readonly raw?: unknown;
+}
+/** A point-in-time capture of the whole fleet. */
+export interface FleetSnapshot {
+    readonly capturedAt: number;
+    readonly nodes: readonly ProcessNode[];
+}
+/** Optional narrowing for `query()`. Omitted fields mean "no constraint". */
+export interface FleetQueryFilter {
+    readonly kinds?: readonly ProcessKind[] | undefined;
+    readonly states?: readonly ProcessState[] | undefined;
+}
+/** Options for `ProcessRegistry.kill()`. */
+export interface ProcessKillOptions {
+    /** Also kill all killable descendant nodes (children first). Default false. */
+    readonly cascade?: boolean | undefined;
+}
+/**
+ * Result of `ProcessRegistry.steer()`.
+ *
+ * `queued: true` means the message was accepted onto the target's inbox —
+ * NOT that the agent has seen it yet. Consumption (drained at the target's
+ * next turn boundary) is a separate, later, honest signal: a
+ * `COMMUNICATION_CONSUMED` runtime-bus event on the `communication` domain
+ * carrying the same `messageId`.
+ */
+export type SteerResult = {
+    readonly queued: true;
+    readonly messageId: string;
+} | {
+    readonly queued: false;
+    readonly reason: string;
+};
+/**
+ * The live process registry surface.
+ *
+ * `query()` is a cheap idempotent aggregate-on-read over the already-composed
+ * managers (no owned store state). `subscribe()` is an in-registry callback
+ * fed by a coalesced tick — it is NOT a runtime-bus event contract.
+ */
+export interface ProcessRegistry {
+    /** Snapshot the fleet now. Cheap O(n) in-memory scans; safe to call per render tick. */
+    query(filter?: FleetQueryFilter): FleetSnapshot;
+    /** Find one node by id, or null. */
+    getNode(id: string): ProcessNode | null;
+    /**
+     * Be notified with a fresh snapshot whenever the fleet materially changes
+     * (coalesced ~tick granularity; unchanged ticks are silent).
+     * Returns an unsubscribe function.
+     */
+    subscribe(listener: (snapshot: FleetSnapshot) => void): () => void;
+    /**
+     * Graceful interruption where the source supports one:
+     * agents → AgentManager.cancel; triggers/schedules → disable (pause).
+     * Returns true when an owning control accepted the request.
+     */
+    interrupt(id: string): boolean;
+    /**
+     * Wave 6 (wo-F item d2): re-arm a `paused` node — triggers/schedules via
+     * their manager's `enable()`, the inverse of `interrupt()`'s disable.
+     * Honest refusal (returns false, no throw) for a node that is not
+     * resumable: not found, not currently `paused`, or a kind whose source
+     * manager exposes no `enable` control (e.g. an agent — there is no
+     * resume path once cancelled, see ProcessState's `paused` doc).
+     */
+    resume(id: string): boolean;
+    /**
+     * Hard stop. Dispatches to the owning manager's control fn
+     * (agent → cancel, background process → stop, watcher → stopWatcher,
+     * workflow → cancel, trigger/schedule → remove). WRFC chain kill is
+     * DERIVED, not native: it cascades AgentManager.cancel over the chain's
+     * member agents. Returns the node ids that were actually acted on.
+     */
+    kill(id: string, opts?: ProcessKillOptions): readonly string[];
+    /**
+     * Queue a human message for a live in-process agent (or the current live
+     * member agent of a wrfc-subtask), delivered at the target's next turn
+     * boundary (next tool round / turn top) — never mid-token. Honest refusal
+     * (`queued: false`) for anything that cannot take mid-run input: terminal
+     * nodes, non-agent kinds, the wrfc-chain coordinator itself (steer its
+     * member subtask instead), and any target when the registry has no
+     * `messageBus` dep configured.
+     */
+    steer(id: string, text: string): SteerResult;
+    /** Stop the tick, detach runtime-bus taps, drop all listeners. Idempotent. */
+    dispose(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/platform/runtime/fleet/types.d.ts.map

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

package/dist/platform/runtime/fleet/types.js

@@ -0,0 +1,2 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+export {};

package/dist/platform/runtime/runtime-knowledge-api.d.ts

@@ -1,6 +1,6 @@
 import { type KnowledgeApi } from '../knowledge/knowledge-api.js';
 import type { RuntimeServices } from './services.js';
-export interface RuntimeKnowledgeApiServices extends Pick<RuntimeServices, 'knowledgeService' | 'memoryRegistry'> {
+export interface RuntimeKnowledgeApiServices extends Pick<RuntimeServices, 'knowledgeService' | 'memoryRegistry' | 'codeIndexStore'> {
 }
 export declare function createRuntimeKnowledgeApi(runtimeServices: RuntimeKnowledgeApiServices): KnowledgeApi;
 //# sourceMappingURL=runtime-knowledge-api.d.ts.map

package/dist/platform/runtime/runtime-knowledge-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-knowledge-api.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/runtime-knowledge-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsD,KAAK,YAAY,EAAE,MAAM,+BAA+B,CAAC;AACtH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,WAAW,2BACf,SAAQ,IAAI,CAAC,eAAe,EAAE,kBAAkB,GAAG,gBAAgB,CAAC;CAAG;AAEzE,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,2BAA2B,GAC3C,YAAY,CAKd"}
+{"version":3,"file":"runtime-knowledge-api.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/runtime-knowledge-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsD,KAAK,YAAY,EAAE,MAAM,+BAA+B,CAAC;AACtH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,WAAW,2BACf,SAAQ,IAAI,CAAC,eAAe,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;CAAG;AAE5F,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,2BAA2B,GAC3C,YAAY,CAMd"}

package/dist/platform/runtime/runtime-knowledge-api.js

@@ -2,6 +2,7 @@ import { createKnowledgeApi } from '../knowledge/knowledge-api.js';
 export function createRuntimeKnowledgeApi(runtimeServices) {
     const options = {
         memoryRegistry: runtimeServices.memoryRegistry,
+        codeIndexStore: runtimeServices.codeIndexStore,
     };
     return createKnowledgeApi(runtimeServices.knowledgeService, options);
 }

package/dist/platform/runtime/services.d.ts

@@ -22,6 +22,7 @@ import { FileUndoManager } from '../state/file-undo.js';
 import { WorkspaceCheckpointManager } from '../workspace/checkpoint/index.js';
 import { MemoryRegistry } from '../state/memory-registry.js';
 import { MemoryStore } from '../state/memory-store.js';
+import { CodeIndexStore } from '../state/code-index-store.js';
 import type { RuntimeEventBus } from './events/index.js';
 import type { DomainDispatch, RuntimeStore } from './store/index.js';
 import { DistributedRuntimeManager } from './remote/distributed-runtime-manager.js';
@@ -65,6 +66,8 @@ import type { FeatureFlagManager } from './feature-flags/index.js';
 import { PolicyRuntimeState } from './permissions/policy-runtime.js';
 import { type KeybindingsManagerLike, type PanelManagerLike } from './host-ui.js';
 import { type WorkflowServices } from '../tools/workflow/index.js';
+import { type ProcessRegistry } from './fleet/index.js';
+import { type OrchestrationEngine } from '../orchestration/index.js';
 export interface RuntimeServicesOptions {
     readonly runtimeBus: RuntimeEventBus;
     readonly runtimeStore: RuntimeStore;
@@ -76,6 +79,16 @@ export interface RuntimeServicesOptions {
     readonly homeDirectory: string;
     readonly panelManager?: PanelManagerLike | undefined;
     readonly keybindingsManager?: KeybindingsManagerLike | undefined;
+    /**
+     * Opt-in: kick off the repo source-tree code index's initial build
+     * (Wave-5 wo802, W5.3 Stage A) right after construction. Fire-and-forget —
+     * never awaited here, never blocks this call. Defaults to false/undefined
+     * so constructing RuntimeServices never surprises a caller (including the
+     * many test fixtures that build RuntimeServices against a real directory)
+     * with an unrequested full source-tree walk. A real product entry point
+     * (an interactive session bootstrap) should pass `true`.
+     */
+    readonly autoStartCodeIndex?: boolean | undefined;
 }
 export interface RuntimeServices {
     readonly workingDirectory: string;
@@ -105,6 +118,18 @@ export interface RuntimeServices {
     readonly projectPlanningService: ProjectPlanningService;
     readonly memoryStore: MemoryStore;
     readonly memoryRegistry: MemoryRegistry;
+    /**
+     * Repo source-tree code index (Wave-5 wo802, W5.3 Stage A). Constructed and
+     * schema-initialized eagerly like memoryStore, but the actual walk/chunk/
+     * embed build is NOT auto-triggered here — call `.scheduleBuild()` from an
+     * explicit call site (a `/codebase reindex` command, a session-start hook,
+     * etc.) once one exists. Auto-triggering from every RuntimeServices
+     * construction would run a full source-tree walk against whatever
+     * workingDirectory a caller passes in — including the hundreds of existing
+     * tests that build RuntimeServices fixtures — which is both slow and
+     * surprising for embedders that never asked for it.
+     */
+    readonly codeIndexStore: CodeIndexStore;
     readonly serviceRegistry: ServiceRegistry;
     readonly secretsManager: SecretsManager;
     readonly subscriptionManager: SubscriptionManager;
@@ -157,7 +182,28 @@ export interface RuntimeServices {
     readonly agentMessageBus: AgentMessageBus;
     readonly agentOrchestrator: AgentOrchestrator;
     readonly wrfcController: WrfcController;
+    /**
+     * Orchestration engine (Wave 4, wo701) — ships ALONGSIDE wrfcController,
+     * stage 1 of the 3-stage migration (see platform/orchestration/
+     * controller-compat.ts). WrfcController is unchanged; this is a new,
+     * opt-in surface for callers that want the pipeline/capacity-matching
+     * scheduler instead of WrfcController's pairwise engineer<->reviewer
+     * chain. Not auto-started — callers call orchestrationEngine.start(id)
+     * (or resumeAllFromDisk()) once they have a workstream to run.
+     */
+    readonly orchestrationEngine: OrchestrationEngine;
     readonly processManager: ProcessManager;
+    /**
+     * Live process registry (W2.1): queryable + subscribable fleet aggregation
+     * over agentManager/wrfcController/processManager/watcherRegistry/workflow.
+     * LIFECYCLE NOTE: RuntimeServices has no shutdown/dispose seam today, so
+     * nothing calls processRegistry.dispose() here — the registry's coalesced
+     * tick is timer.unref()'d and only runs while subscribers exist, so an
+     * undisposed registry cannot pin the event loop. Hosts that tear down a
+     * runtime (tests, embedders) should call processRegistry.dispose()
+     * themselves; when a RuntimeServices-wide dispose seam lands, wire this in.
+     */
+    readonly processRegistry: ProcessRegistry;
     readonly modeManager: ModeManager;
     readonly fileUndoManager: FileUndoManager;
     readonly workspaceCheckpointManager: WorkspaceCheckpointManager;

package/dist/platform/runtime/services.d.ts.map

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

package/dist/platform/runtime/services.js

@@ -27,6 +27,7 @@ import { FileUndoManager } from '../state/file-undo.js';
 import { WorkspaceCheckpointManager } from '../workspace/checkpoint/index.js';
 import { MemoryRegistry } from '../state/memory-registry.js';
 import { MemoryStore } from '../state/memory-store.js';
+import { CodeIndexStore } from '../state/code-index-store.js';
 import { createDomainDispatch } from './store/index.js';
 import { DistributedRuntimeManager } from './remote/distributed-runtime-manager.js';
 import { RemoteRunnerRegistry, RemoteSupervisor } from './remote/index.js';
@@ -72,6 +73,8 @@ import { PolicyRuntimeState } from './permissions/policy-runtime.js';
 import { requireSurfaceRoot } from './surface-root.js';
 import { createNoopKeybindingsManager, createNoopPanelManager, } from './host-ui.js';
 import { createWorkflowServices, } from '../tools/workflow/index.js';
+import { createProcessRegistry } from './fleet/index.js';
+import { createOrchestrationEngine } from '../orchestration/index.js';
 export function bindProviderOptimizerFeatureFlag(featureFlags, providerOptimizer) {
     providerOptimizer.setEnabled(featureFlags.isEnabled('provider-optimizer'));
     return featureFlags.subscribe((flagId, state) => {
@@ -172,6 +175,20 @@ export function createRuntimeServices(options) {
         executor: agentOrchestrator,
         configManager,
     });
+    // Wave-3 Part C6 bridge: AgentOrchestrator is constructed before
+    // AgentManager exists, so the conversation-snapshot sink is wired here via
+    // setConversationSink rather than as a constructor dependency (same
+    // ordering constraint as setRuntimeBus above).
+    agentOrchestrator.setConversationSink({
+        register: (agentId, source) => agentManager.registerConversationSource(agentId, source),
+        release: (agentId) => agentManager.releaseConversationSource(agentId),
+    });
+    // Wave-4 cooperative cancellation bridge (wo701): same ordering constraint
+    // and setter pattern as setConversationSink above — AgentOrchestrator is
+    // constructed before AgentManager exists.
+    agentOrchestrator.setCancellationSource({
+        get: (agentId) => agentManager.getCancellationSignal(agentId),
+    });
     agentManager.setRuntimeBus(options.runtimeBus);
     const wrfcController = new WrfcController(options.runtimeBus, agentMessageBus, {
         agentManager,
@@ -211,6 +228,16 @@ export function createRuntimeServices(options) {
         embeddingRegistry: memoryEmbeddingRegistry,
     });
     const memoryRegistry = new MemoryRegistry(memoryStore);
+    // Repo source-tree code index (Wave-5 wo802, W5.3 Stage A) — shares
+    // memoryEmbeddingRegistry so code + memory embeddings use one provider and
+    // one dimensionality. Schema init only; build is not auto-triggered here
+    // (see the RuntimeServices.codeIndexStore doc comment).
+    const codeIndexDbPath = join(workingDirectory, '.goodvibes', surfaceRoot, 'code-index.sqlite');
+    const codeIndexStore = new CodeIndexStore(workingDirectory, codeIndexDbPath, memoryEmbeddingRegistry);
+    codeIndexStore.init();
+    if (options.autoStartCodeIndex) {
+        codeIndexStore.scheduleBuild();
+    }
     const deliveryManager = new AutomationDeliveryManager({
         configManager,
         secretsManager,
@@ -435,6 +462,50 @@ export function createRuntimeServices(options) {
         sandboxSessionRegistry,
         workflowServices: workflow,
     });
+    // Honest-unpriced: only price models the catalog actually knows; an
+    // unknown model yields null (costState 'unpriced'), never a fabricated $0.
+    // SHARED between the fleet registry and the orchestration engine — the
+    // single cost source of truth so budget checks and fleet cost totals can
+    // never double-count against each other.
+    const priceUsage = (model, usage) => {
+        if (!model)
+            return null;
+        const catalogModels = providerRegistry.getRawCatalogModels();
+        const known = catalogModels.some((entry) => model === entry.id || model.startsWith(entry.id) || model.includes(entry.id));
+        if (!known && !model.endsWith(':free'))
+            return null;
+        const pricing = providerRegistry.getCostFromCatalog(model);
+        return (usage.inputTokens * pricing.input + usage.outputTokens * pricing.output) / 1_000_000;
+    };
+    // Orchestration engine (Wave 4, wo701) — ships alongside wrfcController,
+    // untouched by this change. See the RuntimeServices interface comment.
+    const orchestrationEngine = createOrchestrationEngine({
+        agentManager,
+        configManager,
+        runtimeBus: options.runtimeBus,
+        projectRoot: workingDirectory,
+        priceUsage,
+    });
+    // Live process registry (W2.1) — narrow structural deps only, constructed
+    // after every source manager exists. See the RuntimeServices interface
+    // comment for the dispose story (no RuntimeServices-wide shutdown seam yet).
+    const processRegistry = createProcessRegistry({
+        agentManager,
+        wrfcController,
+        orchestrationEngine,
+        processManager,
+        watcherRegistry,
+        workflow: {
+            workflowManager: workflow.workflowManager,
+            triggerManager: workflow.triggerManager,
+            scheduleManager: workflow.scheduleManager,
+        },
+        approvalBroker,
+        sessionBroker,
+        runtimeBus: options.runtimeBus,
+        priceUsage,
+        codeIndexService: codeIndexStore,
+    });
     return {
         workingDirectory,
         homeDirectory,
@@ -463,6 +534,7 @@ export function createRuntimeServices(options) {
         projectPlanningService,
         memoryStore,
         memoryRegistry,
+        codeIndexStore,
         serviceRegistry,
         secretsManager,
         subscriptionManager,
@@ -515,7 +587,9 @@ export function createRuntimeServices(options) {
         agentMessageBus,
         agentOrchestrator,
         wrfcController,
+        orchestrationEngine,
         processManager,
+        processRegistry,
         modeManager,
         fileUndoManager,
         workspaceCheckpointManager,
@@ -524,6 +598,10 @@ export function createRuntimeServices(options) {
             // Step 1: Re-root MemoryStore — close existing SQLite/vector handles, reopen at new path.
             const newMemoryDbPath = join(newWorkingDir, '.goodvibes', surfaceRoot, 'memory.sqlite');
             await memoryStore.reroot(newMemoryDbPath);
+            // Step 1b: Re-root the code index alongside memory — otherwise it keeps
+            // pointing at the old tree after a workspace swap (Wave-5 wo802 risk #7).
+            const newCodeIndexDbPath = join(newWorkingDir, '.goodvibes', surfaceRoot, 'code-index.sqlite');
+            await codeIndexStore.reroot(newWorkingDir, newCodeIndexDbPath);
             // Step 2: Re-root ProjectIndex — flush current path, reset, load from new directory.
             await projectIndex.reroot(newWorkingDir);
             // Step 3: Subsystems that cannot be live-rerooted emit a warn log.

package/dist/platform/state/code-index-chunking.d.ts

@@ -0,0 +1,49 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+import type { SymbolInfo } from '../intelligence/tree-sitter/queries.js';
+/** One chunk of source: either a top-level tree-sitter symbol or a fixed-size line window. */
+export interface CodeChunk {
+    readonly chunkId: string;
+    readonly path: string;
+    readonly lang: string;
+    readonly symbol: string;
+    readonly kind: string;
+    readonly startLine: number;
+    readonly endLine: number;
+    readonly contentHash: string;
+    readonly mtimeMs: number;
+    readonly fileHash: string;
+}
+/** How a file's chunks were produced. 'window' means "never silently dropped" fell back to fixed-size windows. */
+export type CodeChunkMode = 'symbols' | 'window' | 'empty' | 'unchanged';
+/** A chunk plus the exact text its embedding is computed from. */
+export interface DraftChunk {
+    readonly chunk: CodeChunk;
+    readonly embedText: string;
+}
+/** The minimal tree-sitter surface chunking needs (structural, so tests can fake it). */
+export interface ChunkingIntelligence {
+    detectLanguage(filePath: string): string | null;
+    getSymbols(filePath: string, content: string): Promise<SymbolInfo[]>;
+}
+export declare const DEFAULT_WINDOW_LINES = 60;
+export declare const DEFAULT_WINDOW_OVERLAP_LINES = 10;
+export declare function sha256(text: string): string;
+export interface ChunkFileInput {
+    readonly intelligence: ChunkingIntelligence;
+    readonly absPath: string;
+    readonly relPath: string;
+    readonly content: string;
+    readonly fileHash: string;
+    readonly mtimeMs: number;
+    readonly windowLines?: number | undefined;
+    readonly windowOverlapLines?: number | undefined;
+}
+/**
+ * Chunk one file's content. The caller is responsible for having initialized
+ * the intelligence facade (tree-sitter grammars) before calling.
+ */
+export declare function chunkFileContent(input: ChunkFileInput): Promise<{
+    drafts: DraftChunk[];
+    mode: CodeChunkMode;
+}>;
+//# sourceMappingURL=code-index-chunking.d.ts.map

package/dist/platform/state/code-index-chunking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-index-chunking.d.ts","sourceRoot":"","sources":["../../../src/platform/state/code-index-chunking.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAsBrF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAEzE,8FAA8F;AAC9F,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,kHAAkH;AAClH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAC;AAEzE,kEAAkE;AAClE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,yFAAyF;AACzF,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAChD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;CACtE;AAED,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAI/C,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClD;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC;IAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC,CA+BxD"}

package/dist/platform/state/code-index-chunking.js

@@ -0,0 +1,111 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+/**
+ * Code-index chunking — pure content → chunk transformation for CodeIndexStore
+ * (Wave-5, W5.3 Stage A; extracted from code-index-store.ts to keep that file
+ * within the 800-line source discipline).
+ *
+ * Everything here is side-effect-free with respect to the store: given file
+ * content plus a tree-sitter surface (ChunkingIntelligence), produce DraftChunk
+ * lists deterministically. The store owns storage, embedding, and lifecycle.
+ *
+ * Chunking contract (unchanged from the original in-store implementation):
+ *  - Files with top-level tree-sitter symbols chunk one-per-symbol ('symbols').
+ *  - Unsupported languages, parse failures, and symbol-less files fall back to
+ *    fixed-size line windows ('window') — a non-empty file is never silently
+ *    dropped.
+ *  - Whitespace-only content yields zero chunks ('empty').
+ *  - chunk_id is a deterministic function of path + line span + content hash,
+ *    so identical trees always chunk identically.
+ */
+import { createHash } from 'node:crypto';
+export const DEFAULT_WINDOW_LINES = 60;
+export const DEFAULT_WINDOW_OVERLAP_LINES = 10;
+/** Languages extractSymbols() actually understands (tree-sitter/queries.ts extractSymbols). Everything else always falls back to windowed chunking. */
+const SYMBOL_SUPPORTED_LANGS = new Set(['typescript', 'tsx', 'javascript', 'python']);
+export function sha256(text) {
+    return createHash('sha256').update(text).digest('hex');
+}
+/**
+ * Chunk one file's content. The caller is responsible for having initialized
+ * the intelligence facade (tree-sitter grammars) before calling.
+ */
+export async function chunkFileContent(input) {
+    const { intelligence, absPath, relPath, content, fileHash, mtimeMs } = input;
+    if (!content.trim())
+        return { drafts: [], mode: 'empty' };
+    const lang = intelligence.detectLanguage(absPath) ?? 'unknown';
+    let symbols = [];
+    if (SYMBOL_SUPPORTED_LANGS.has(lang)) {
+        symbols = await intelligence.getSymbols(absPath, content);
+    }
+    const topLevel = symbols.filter((symbol) => !symbol.container);
+    if (topLevel.length > 0) {
+        const lines = content.split('\n');
+        const drafts = topLevel.map((symbol) => makeSymbolChunk(relPath, lang, symbol, lines, fileHash, mtimeMs));
+        return { drafts, mode: 'symbols' };
+    }
+    // Unsupported language, parse failure, or a supported-language file with
+    // zero top-level declarations (e.g. a pure re-export barrel) — the index
+    // must never silently drop a non-empty file, so it falls back to windows.
+    const drafts = makeWindowChunks(relPath, lang, content, fileHash, mtimeMs, input.windowLines, input.windowOverlapLines);
+    return { drafts, mode: 'window' };
+}
+function makeSymbolChunk(relPath, lang, symbol, lines, fileHash, mtimeMs) {
+    const startLine = symbol.line;
+    const endLine = Math.max(symbol.endLine, symbol.line);
+    const slice = lines.slice(Math.max(0, startLine - 1), endLine).join('\n');
+    const embedText = `${lang} ${symbol.kind} ${symbol.name}\n${slice}`;
+    const contentHash = sha256(embedText);
+    const chunkId = sha256(`${relPath}:${startLine}-${endLine}:${contentHash}`);
+    return {
+        embedText,
+        chunk: {
+            chunkId,
+            path: relPath,
+            lang,
+            symbol: symbol.name,
+            kind: symbol.kind,
+            startLine,
+            endLine,
+            contentHash,
+            mtimeMs,
+            fileHash,
+        },
+    };
+}
+function makeWindowChunks(relPath, lang, content, fileHash, mtimeMs, windowLinesOption, windowOverlapOption) {
+    const lines = content.split('\n');
+    const windowSize = Math.max(1, windowLinesOption ?? DEFAULT_WINDOW_LINES);
+    const overlap = Math.max(0, Math.min(windowSize - 1, windowOverlapOption ?? DEFAULT_WINDOW_OVERLAP_LINES));
+    const step = Math.max(1, windowSize - overlap);
+    const drafts = [];
+    for (let start = 0; start < lines.length; start += step) {
+        const end = Math.min(lines.length, start + windowSize);
+        const slice = lines.slice(start, end).join('\n');
+        if (slice.trim()) {
+            const startLine = start + 1;
+            const endLine = end;
+            const embedText = `${lang} window ${relPath}\n${slice}`;
+            const contentHash = sha256(embedText);
+            const chunkId = sha256(`${relPath}:${startLine}-${endLine}:${contentHash}`);
+            drafts.push({
+                embedText,
+                chunk: {
+                    chunkId,
+                    path: relPath,
+                    lang,
+                    symbol: '',
+                    kind: 'window',
+                    startLine,
+                    endLine,
+                    contentHash,
+                    mtimeMs,
+                    fileHash,
+                },
+            });
+        }
+        if (end >= lines.length)
+            break;
+    }
+    return drafts;
+}