@pellux/goodvibes-sdk 0.18.13 → 0.18.15

package/dist/_internal/platform/runtime/ui-read-models-operations.js

@@ -0,0 +1,113 @@
+import { combineSubscriptions, createStoreBackedReadModel } from './ui-read-model-helpers.js';
+export function createOperationsReadModels(runtimeServices, options = {}) {
+    const { runtimeStore } = runtimeServices;
+    return {
+        automation: createStoreBackedReadModel(runtimeServices, () => {
+            const state = runtimeStore.getState();
+            const jobs = state.automation.jobIds
+                .map((id) => state.automation.jobs.get(id))
+                .filter((job) => job !== undefined)
+                .sort((a, b) => (b.nextRunAt ?? 0) - (a.nextRunAt ?? 0) || a.name.localeCompare(b.name));
+            const runs = state.automation.runIds
+                .map((id) => state.automation.runs.get(id))
+                .filter((run) => run !== undefined)
+                .sort((a, b) => b.queuedAt - a.queuedAt || a.id.localeCompare(b.id));
+            return {
+                jobs,
+                runs,
+                totalJobs: state.automation.totalJobs,
+                totalRuns: state.automation.totalRuns,
+                activeRunIds: state.automation.activeRunIds,
+                totalFailed: state.automation.totalFailed,
+                sourceCount: state.automation.sourceIds.length,
+                deliveryTotals: {
+                    succeeded: state.deliveries.totalSucceeded,
+                    failed: state.deliveries.totalFailed,
+                    deadLettered: state.deliveries.totalDeadLettered,
+                },
+            };
+        }),
+        routes: createStoreBackedReadModel(runtimeServices, () => {
+            const state = runtimeStore.getState().routes;
+            const bindings = state.bindingIds
+                .map((id) => state.bindings.get(id))
+                .filter((binding) => binding !== undefined)
+                .sort((a, b) => b.lastSeenAt - a.lastSeenAt || a.id.localeCompare(b.id));
+            return {
+                bindings,
+                bindingIdsBySurface: state.bindingIdsBySurface,
+                totalBindings: state.totalBindings,
+                activeBindingIds: state.activeBindingIds,
+                totalResolved: state.totalResolved,
+                totalFailures: state.totalFailures,
+            };
+        }),
+        watchers: createStoreBackedReadModel(runtimeServices, () => {
+            const state = runtimeStore.getState().watchers;
+            const watchers = state.watcherIds
+                .map((id) => state.watchers.get(id))
+                .filter((watcher) => watcher !== undefined)
+                .sort((a, b) => (b.lastHeartbeatAt ?? 0) - (a.lastHeartbeatAt ?? 0) || a.id.localeCompare(b.id));
+            return {
+                watchers,
+                totalWatchers: state.watcherIds.length,
+                activeWatcherIds: state.activeWatcherIds,
+                totalDegraded: state.totalDegraded,
+                totalLagged: state.totalLagged,
+            };
+        }),
+        orchestration: createStoreBackedReadModel(runtimeServices, () => {
+            const state = runtimeStore.getState().orchestration;
+            const graphs = [...state.graphs.values()].sort((a, b) => b.createdAt - a.createdAt);
+            return {
+                graphs,
+                totalGraphs: state.totalGraphs,
+                activeGraphIds: state.activeGraphIds,
+                totalCompletedGraphs: state.totalCompletedGraphs,
+                totalFailedGraphs: state.totalFailedGraphs,
+                recursionGuardTrips: state.recursionGuardTrips,
+            };
+        }),
+        communication: createStoreBackedReadModel(runtimeServices, () => {
+            const state = runtimeStore.getState().communication;
+            const records = state.recentRecordIds
+                .map((id) => state.records.get(id))
+                .filter((record) => record !== undefined)
+                .sort((a, b) => b.timestamp - a.timestamp);
+            return {
+                records,
+                totalSent: state.totalSent,
+                totalDelivered: state.totalDelivered,
+                totalBlocked: state.totalBlocked,
+            };
+        }),
+        controlPlane: {
+            getSnapshot() {
+                const state = runtimeStore.getState().controlPlane;
+                const clients = state.clientIds
+                    .map((id) => state.clients.get(id))
+                    .filter((client) => client !== undefined)
+                    .sort((a, b) => (b.lastSeenAt ?? 0) - (a.lastSeenAt ?? 0) || a.id.localeCompare(b.id));
+                return {
+                    connectionState: state.connectionState,
+                    activeClientIds: state.activeClientIds,
+                    requestCount: state.requestCount,
+                    errorCount: state.errorCount,
+                    host: state.host,
+                    port: state.port,
+                    clients,
+                    approvals: runtimeServices.approvalBroker.listApprovals(6),
+                    sessions: runtimeServices.sessionBroker.listSessions(6),
+                    recentEvents: options.getControlPlaneRecentEvents?.(6) ?? [],
+                };
+            },
+            subscribe(listener) {
+                const unsubs = [
+                    runtimeStore.subscribe(listener),
+                    runtimeServices.approvalBroker.subscribe(listener),
+                ];
+                return combineSubscriptions(...unsubs);
+            },
+        },
+    };
+}

package/dist/_internal/platform/runtime/ui-read-models.d.ts

@@ -0,0 +1,13 @@
+export type { UiReadModel } from '@pellux/goodvibes-sdk/platform/runtime/ui-read-models-base';
+export type { UiCoreReadModels, UiProvidersSnapshot, UiSessionSnapshot, UiAgentsSnapshot, UiTasksSnapshot, } from './ui-read-models-core.js';
+export type { UiOperationsReadModels, UiAutomationSnapshot, UiRoutesSnapshot, UiWatchersSnapshot, UiOrchestrationSnapshot, UiCommunicationSnapshot, UiControlPlaneSnapshot, } from './ui-read-models-operations.js';
+export type { UiObservabilityReadModels, UiRemoteSnapshot, UiIntelligenceSnapshot, UiMarketplaceSnapshot, UiCockpitSnapshot, UiSecuritySnapshot, UiHealthSnapshot, UiMcpServerSnapshot, UiMcpSnapshot, UiLocalAuthSnapshot, UiSettingsSnapshot, UiContinuitySnapshot, UiWorktreeSnapshot, } from './ui-read-models-observability.js';
+export type { UiObservabilityReadModelOptions } from './ui-read-models-observability-options.js';
+import type { RuntimeServices } from './services.js';
+import { type UiCoreReadModels } from './ui-read-models-core.js';
+import { type UiOperationsReadModels, type UiOperationsReadModelOptions } from './ui-read-models-operations.js';
+import { type UiObservabilityReadModels, type UiObservabilityReadModelOptions } from './ui-read-models-observability.js';
+export type UiReadModelOptions = UiOperationsReadModelOptions & UiObservabilityReadModelOptions;
+export type UiReadModels = UiCoreReadModels & UiOperationsReadModels & UiObservabilityReadModels;
+export declare function createUiReadModels(runtimeServices: RuntimeServices, options?: UiReadModelOptions): UiReadModels;
+//# sourceMappingURL=ui-read-models.d.ts.map

package/dist/_internal/platform/runtime/ui-read-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-read-models.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/runtime/ui-read-models.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,MAAM,4DAA4D,CAAC;AAC9F,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,yBAAyB,EACzB,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAC3C,YAAY,EAAE,+BAA+B,EAAE,MAAM,2CAA2C,CAAC;AAEjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,EAClC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,+BAA+B,EACrC,MAAM,mCAAmC,CAAC;AAE3C,MAAM,MAAM,kBAAkB,GAAG,4BAA4B,GAAG,+BAA+B,CAAC;AAEhG,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG,sBAAsB,GAAG,yBAAyB,CAAC;AAEjG,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE,kBAAuB,GAC/B,YAAY,CAMd"}

package/dist/_internal/platform/runtime/ui-read-models.js

@@ -0,0 +1,10 @@
+import { createCoreReadModels } from './ui-read-models-core.js';
+import { createOperationsReadModels, } from './ui-read-models-operations.js';
+import { createObservabilityReadModels, } from './ui-read-models-observability.js';
+export function createUiReadModels(runtimeServices, options = {}) {
+    return {
+        ...createCoreReadModels(runtimeServices),
+        ...createOperationsReadModels(runtimeServices, options),
+        ...createObservabilityReadModels(runtimeServices, options),
+    };
+}

package/dist/_internal/platform/runtime/ui-service-queries.d.ts

@@ -0,0 +1,69 @@
+import type { ServiceConfig, ServiceConnectionTestResult, ServiceInspection } from '../config/service-registry.js';
+import type { PendingSubscriptionLogin, ProviderSubscription } from '@pellux/goodvibes-sdk/platform/config/subscriptions';
+import type { LocalAuthSnapshot } from '@pellux/goodvibes-sdk/platform/security/user-auth';
+import type { SessionInfo } from '../sessions/manager.js';
+import type { Tool } from '@pellux/goodvibes-sdk/platform/types/tools';
+import type { ModelDefinition } from '../providers/registry.js';
+import type { ProviderApi, ProviderRuntimeSnapshot } from '../providers/provider-api.js';
+import type { ExecutionPlan } from '@pellux/goodvibes-sdk/platform/core/execution-plan';
+import type { PlannerDecision, ExecutionStrategy } from '@pellux/goodvibes-sdk/platform/core/adaptive-planner';
+export interface EnvironmentVariableQuery {
+    hasEnvironmentVariable(name: string): boolean;
+}
+export interface ServiceInspectionQuery {
+    getAll(): Record<string, ServiceConfig>;
+    inspect(name: string): Promise<ServiceInspection | null>;
+    testConnection(name: string): Promise<ServiceConnectionTestResult>;
+}
+export interface SubscriptionAccessQuery {
+    list(): ProviderSubscription[];
+    listPending(): PendingSubscriptionLogin[];
+    get(provider: string): ProviderSubscription | null;
+    getPending(provider: string): PendingSubscriptionLogin | null;
+    getAccessToken(provider: string): string | null;
+    logout(provider: string): void;
+}
+export interface LocalAuthInspectionQuery {
+    inspect(): LocalAuthSnapshot;
+}
+export interface SessionBrowserQuery {
+    list(): SessionInfo[];
+    search(query: string): Array<{
+        session: SessionInfo;
+        matchCount: number;
+        snippets: string[];
+    }>;
+    delete(name: string): void;
+}
+export interface SessionMemoryQuery {
+    list(): readonly unknown[];
+}
+export interface ToolCatalogQuery {
+    list(): Tool[];
+}
+export interface ProviderModelCatalogQuery {
+    listModels(): ModelDefinition[];
+}
+export interface ProviderAccountInspectionQuery {
+    readonly providerModels: ProviderModelCatalogQuery;
+    readonly services: Pick<ServiceInspectionQuery, 'getAll' | 'inspect'>;
+    readonly subscriptions: Pick<SubscriptionAccessQuery, 'list' | 'listPending' | 'get' | 'getPending'>;
+    readonly environment: EnvironmentVariableQuery;
+}
+export interface ProviderRuntimeInspectionQuery {
+    listProviderIds(): readonly string[];
+    inspectAll(): Promise<readonly ProviderRuntimeSnapshot[]>;
+    inspect(providerId: string): Promise<ProviderRuntimeSnapshot | null>;
+}
+export interface PlanDashboardQuery {
+    getActive(): ExecutionPlan | null;
+}
+export interface OpsStrategyQuery {
+    getLatest(): PlannerDecision | null;
+    getMode(): ExecutionStrategy;
+    getOverride(): ExecutionStrategy | null;
+    getHistory(limit?: number): PlannerDecision[];
+}
+export declare function createEnvironmentVariableQuery(environment: Readonly<Record<string, string | undefined>>): EnvironmentVariableQuery;
+export declare function createProviderRuntimeInspectionQuery(providers: Pick<ProviderApi, 'listProviderIds' | 'queryRuntimeMetadata'>): ProviderRuntimeInspectionQuery;
+//# sourceMappingURL=ui-service-queries.d.ts.map

package/dist/_internal/platform/runtime/ui-service-queries.d.ts.map

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

package/dist/_internal/platform/runtime/ui-service-queries.js

@@ -0,0 +1,22 @@
+export function createEnvironmentVariableQuery(environment) {
+    return {
+        hasEnvironmentVariable(name) {
+            return Boolean(environment[name]);
+        },
+    };
+}
+export function createProviderRuntimeInspectionQuery(providers) {
+    return {
+        listProviderIds() {
+            return providers.listProviderIds();
+        },
+        async inspectAll() {
+            const result = await providers.queryRuntimeMetadata({ scope: 'all' });
+            return result.scope === 'all' ? result.snapshots : [];
+        },
+        async inspect(providerId) {
+            const result = await providers.queryRuntimeMetadata({ scope: 'provider', providerId });
+            return result.scope === 'provider' ? result.snapshot : null;
+        },
+    };
+}

package/dist/_internal/platform/runtime/ui-services.d.ts

@@ -0,0 +1,92 @@
+import type { RuntimeServices } from './services.js';
+import type { RemoteRunnerRegistry } from './remote/runner-registry.js';
+import type { RemoteSupervisor } from './remote/supervisor.js';
+import { type UiRuntimeEvents } from './ui-events.js';
+import { type UiReadModels, type UiReadModelOptions } from './ui-read-models.js';
+import type { ForensicsRegistry } from './forensics/index.js';
+import type { ControlPlaneRecentEvent } from '../control-plane/index.js';
+import type { ApprovalBroker } from '../control-plane/approval-broker.js';
+import type { SharedSessionBroker } from '../control-plane/session-broker.js';
+import type { ShellPathService } from '@pellux/goodvibes-sdk/platform/runtime/shell-paths';
+import type { SecretsManager } from '../config/secrets.js';
+export interface UiEnvironmentServices {
+    readonly workingDirectory: string;
+    readonly homeDirectory: string;
+    readonly shellPaths: ShellPathService;
+}
+export interface UiShellServices {
+    readonly keybindingsManager: RuntimeServices['keybindingsManager'];
+    readonly panelManager: RuntimeServices['panelManager'];
+    readonly processManager: RuntimeServices['processManager'];
+    readonly profileManager: RuntimeServices['profileManager'];
+    readonly bookmarkManager: RuntimeServices['bookmarkManager'];
+}
+export interface UiAgentServices {
+    readonly agentManager: RuntimeServices['agentManager'];
+    readonly agentMessageBus: RuntimeServices['agentMessageBus'];
+    readonly wrfcController: RuntimeServices['wrfcController'];
+}
+export interface UiProviderServices {
+    readonly providerRegistry: RuntimeServices['providerRegistry'];
+    readonly favoritesStore: RuntimeServices['favoritesStore'];
+    readonly benchmarkStore: RuntimeServices['benchmarkStore'];
+}
+export interface UiSessionServices {
+    readonly sessionManager: RuntimeServices['sessionManager'];
+    readonly sessionBroker: SharedSessionBroker;
+    readonly sessionOrchestration: RuntimeServices['sessionOrchestration'];
+    readonly sessionMemoryStore: RuntimeServices['sessionMemoryStore'];
+}
+export interface UiPlatformServices {
+    readonly configManager: RuntimeServices['configManager'];
+    readonly localUserAuthManager: RuntimeServices['localUserAuthManager'];
+    readonly mcpRegistry: RuntimeServices['mcpRegistry'];
+    readonly serviceRegistry: RuntimeServices['serviceRegistry'];
+    readonly subscriptionManager: RuntimeServices['subscriptionManager'];
+    readonly secretsManager: SecretsManager;
+    readonly tokenAuditor: RuntimeServices['tokenAuditor'];
+    readonly replayEngine: RuntimeServices['replayEngine'];
+    readonly webhookNotifier: RuntimeServices['webhookNotifier'];
+    readonly policyRuntimeState: RuntimeServices['policyRuntimeState'];
+}
+export interface UiPlanningServices {
+    readonly planManager: RuntimeServices['planManager'];
+    readonly adaptivePlanner: RuntimeServices['adaptivePlanner'];
+}
+export interface UiCoordinationServices {
+    readonly approvalBroker: ApprovalBroker;
+}
+export interface UiRuntimeSharedServices {
+    readonly environment: UiEnvironmentServices;
+    readonly shell: UiShellServices;
+    readonly agents: UiAgentServices;
+    readonly providers: UiProviderServices;
+    readonly sessions: UiSessionServices;
+    readonly platform: UiPlatformServices;
+    readonly planning: UiPlanningServices;
+    readonly coordination: UiCoordinationServices;
+    readonly runtime: {
+        readonly distributedRuntime: RuntimeServices['distributedRuntime'];
+        readonly remoteRunnerRegistry: RuntimeServices['remoteRunnerRegistry'] & RemoteRunnerRegistry;
+        readonly remoteSupervisor: RuntimeServices['remoteSupervisor'] & RemoteSupervisor;
+    };
+}
+export interface UiRuntimeServices {
+    readonly environment: UiEnvironmentServices;
+    readonly shell: UiShellServices;
+    readonly agents: UiAgentServices;
+    readonly providers: UiProviderServices;
+    readonly sessions: UiSessionServices;
+    readonly platform: UiPlatformServices;
+    readonly planning: UiPlanningServices;
+    readonly coordination: UiCoordinationServices;
+    readonly runtime: UiRuntimeSharedServices['runtime'];
+    readonly events: UiRuntimeEvents;
+    readonly readModels: UiReadModels;
+}
+export interface UiRuntimeServicesOptions extends UiReadModelOptions {
+    readonly forensicsRegistry?: ForensicsRegistry;
+    readonly getControlPlaneRecentEvents?: (limit: number) => readonly ControlPlaneRecentEvent[];
+}
+export declare function createUiRuntimeServices(runtimeServices: RuntimeServices, options?: UiRuntimeServicesOptions): UiRuntimeServices;
+//# sourceMappingURL=ui-services.d.ts.map

package/dist/_internal/platform/runtime/ui-services.d.ts.map

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

package/dist/_internal/platform/runtime/ui-services.js

@@ -0,0 +1,60 @@
+import { createUiRuntimeEvents } from './ui-events.js';
+import { createUiReadModels } from './ui-read-models.js';
+export function createUiRuntimeServices(runtimeServices, options = {}) {
+    return {
+        environment: {
+            workingDirectory: runtimeServices.workingDirectory,
+            homeDirectory: runtimeServices.homeDirectory,
+            shellPaths: runtimeServices.shellPaths,
+        },
+        shell: {
+            keybindingsManager: runtimeServices.keybindingsManager,
+            panelManager: runtimeServices.panelManager,
+            processManager: runtimeServices.processManager,
+            profileManager: runtimeServices.profileManager,
+            bookmarkManager: runtimeServices.bookmarkManager,
+        },
+        agents: {
+            agentManager: runtimeServices.agentManager,
+            agentMessageBus: runtimeServices.agentMessageBus,
+            wrfcController: runtimeServices.wrfcController,
+        },
+        providers: {
+            providerRegistry: runtimeServices.providerRegistry,
+            favoritesStore: runtimeServices.favoritesStore,
+            benchmarkStore: runtimeServices.benchmarkStore,
+        },
+        sessions: {
+            sessionManager: runtimeServices.sessionManager,
+            sessionBroker: runtimeServices.sessionBroker,
+            sessionOrchestration: runtimeServices.sessionOrchestration,
+            sessionMemoryStore: runtimeServices.sessionMemoryStore,
+        },
+        platform: {
+            configManager: runtimeServices.configManager,
+            localUserAuthManager: runtimeServices.localUserAuthManager,
+            mcpRegistry: runtimeServices.mcpRegistry,
+            serviceRegistry: runtimeServices.serviceRegistry,
+            subscriptionManager: runtimeServices.subscriptionManager,
+            secretsManager: runtimeServices.secretsManager,
+            tokenAuditor: runtimeServices.tokenAuditor,
+            replayEngine: runtimeServices.replayEngine,
+            webhookNotifier: runtimeServices.webhookNotifier,
+            policyRuntimeState: runtimeServices.policyRuntimeState,
+        },
+        planning: {
+            planManager: runtimeServices.planManager,
+            adaptivePlanner: runtimeServices.adaptivePlanner,
+        },
+        coordination: {
+            approvalBroker: runtimeServices.approvalBroker,
+        },
+        runtime: {
+            distributedRuntime: runtimeServices.distributedRuntime,
+            remoteRunnerRegistry: runtimeServices.remoteRunnerRegistry,
+            remoteSupervisor: runtimeServices.remoteSupervisor,
+        },
+        events: createUiRuntimeEvents(runtimeServices.runtimeBus),
+        readModels: createUiReadModels(runtimeServices, options),
+    };
+}

package/dist/_internal/platform/runtime/worktree/registry.d.ts

@@ -0,0 +1,59 @@
+export type ManagedWorktreeState = 'active' | 'paused' | 'kept' | 'discard' | 'cleanup-pending';
+export type ManagedWorktreeKind = 'agent' | 'orchestrator' | 'manual';
+export interface ManagedWorktreeMeta {
+    readonly path: string;
+    readonly kind: ManagedWorktreeKind;
+    readonly state: ManagedWorktreeState;
+    readonly ownerId?: string;
+    readonly sessionId?: string;
+    readonly taskId?: string;
+    readonly updatedAt: number;
+}
+export interface WorktreeStatusRecord extends ManagedWorktreeMeta {
+    readonly branch: string;
+    readonly head: string;
+}
+export interface WorktreeOwnershipSummary {
+    readonly total: number;
+    readonly active: number;
+    readonly paused: number;
+    readonly kept: number;
+    readonly discard: number;
+    readonly cleanupPending: number;
+    readonly sessionAttached: number;
+    readonly taskAttached: number;
+    readonly agentOwned: number;
+    readonly orchestratorOwned: number;
+    readonly manualOwned: number;
+}
+export interface WorktreeAttachmentReview {
+    readonly targetKind: 'session' | 'task';
+    readonly targetId: string;
+    readonly total: number;
+    readonly active: number;
+    readonly paused: number;
+    readonly kept: number;
+    readonly discard: number;
+    readonly cleanupPending: number;
+    readonly records: readonly ManagedWorktreeMeta[];
+}
+export interface WorktreeRegistryPaths {
+    readonly workingDirectory: string;
+}
+export declare function listPersistedWorktreeMeta(options: WorktreeRegistryPaths): ManagedWorktreeMeta[];
+export declare function getPersistedWorktreeMeta(path: string, options: WorktreeRegistryPaths): ManagedWorktreeMeta | null;
+export declare function reviewWorktreeAttachments(targetKind: 'session' | 'task', targetId: string, options: WorktreeRegistryPaths): WorktreeAttachmentReview;
+export declare function summarizeWorktreeOwnership(records: readonly ManagedWorktreeMeta[]): WorktreeOwnershipSummary;
+export declare class WorktreeRegistry {
+    private readonly git;
+    private readonly workingDirectory;
+    constructor(workingDirectory: string);
+    list(): Promise<WorktreeStatusRecord[]>;
+    attach(path: string, target: {
+        sessionId?: string;
+        taskId?: string;
+    }): void;
+    setState(path: string, state: ManagedWorktreeState): void;
+    cleanup(path: string): Promise<void>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/_internal/platform/runtime/worktree/registry.d.ts.map

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

package/dist/_internal/platform/runtime/worktree/registry.js

@@ -0,0 +1,179 @@
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { GitService } from '../../git/service.js';
+function getStorePath(workingDirectory) {
+    return join(workingDirectory, '.goodvibes', 'goodvibes', 'worktrees.json');
+}
+function defaultStore() {
+    return { version: 1, records: {} };
+}
+function normalizePath(path, workingDirectory) {
+    return resolve(workingDirectory, path);
+}
+function readStore(workingDirectory) {
+    try {
+        return JSON.parse(readFileSync(getStorePath(workingDirectory), 'utf-8'));
+    }
+    catch {
+        return defaultStore();
+    }
+}
+export function listPersistedWorktreeMeta(options) {
+    return Object.values(readStore(options.workingDirectory).records).sort((a, b) => a.path.localeCompare(b.path));
+}
+export function getPersistedWorktreeMeta(path, options) {
+    const normalized = normalizePath(path, options.workingDirectory);
+    return readStore(options.workingDirectory).records[normalized] ?? null;
+}
+export function reviewWorktreeAttachments(targetKind, targetId, options) {
+    const records = listPersistedWorktreeMeta(options).filter((record) => (targetKind === 'session' ? record.sessionId === targetId : record.taskId === targetId));
+    return records.reduce((summary, record) => ({
+        ...summary,
+        total: summary.total + 1,
+        active: summary.active + (record.state === 'active' ? 1 : 0),
+        paused: summary.paused + (record.state === 'paused' ? 1 : 0),
+        kept: summary.kept + (record.state === 'kept' ? 1 : 0),
+        discard: summary.discard + (record.state === 'discard' ? 1 : 0),
+        cleanupPending: summary.cleanupPending + (record.state === 'cleanup-pending' ? 1 : 0),
+        records: [...summary.records, record],
+    }), {
+        targetKind,
+        targetId,
+        total: 0,
+        active: 0,
+        paused: 0,
+        kept: 0,
+        discard: 0,
+        cleanupPending: 0,
+        records: [],
+    });
+}
+export function summarizeWorktreeOwnership(records) {
+    return records.reduce((summary, record) => ({
+        total: summary.total + 1,
+        active: summary.active + (record.state === 'active' ? 1 : 0),
+        paused: summary.paused + (record.state === 'paused' ? 1 : 0),
+        kept: summary.kept + (record.state === 'kept' ? 1 : 0),
+        discard: summary.discard + (record.state === 'discard' ? 1 : 0),
+        cleanupPending: summary.cleanupPending + (record.state === 'cleanup-pending' ? 1 : 0),
+        sessionAttached: summary.sessionAttached + (record.sessionId ? 1 : 0),
+        taskAttached: summary.taskAttached + (record.taskId ? 1 : 0),
+        agentOwned: summary.agentOwned + (record.kind === 'agent' ? 1 : 0),
+        orchestratorOwned: summary.orchestratorOwned + (record.kind === 'orchestrator' ? 1 : 0),
+        manualOwned: summary.manualOwned + (record.kind === 'manual' ? 1 : 0),
+    }), {
+        total: 0,
+        active: 0,
+        paused: 0,
+        kept: 0,
+        discard: 0,
+        cleanupPending: 0,
+        sessionAttached: 0,
+        taskAttached: 0,
+        agentOwned: 0,
+        orchestratorOwned: 0,
+        manualOwned: 0,
+    });
+}
+function writeStore(store, workingDirectory) {
+    const storePath = getStorePath(workingDirectory);
+    mkdirSync(dirname(storePath), { recursive: true });
+    writeFileSync(storePath, `${JSON.stringify(store, null, 2)}\n`, 'utf-8');
+}
+function classifyWorktreePath(path, workingDirectory) {
+    const normalized = normalizePath(path, workingDirectory);
+    const agentMatch = normalized.match(/[/\\]\.goodvibes[/\\]\.worktrees[/\\]agent-([^/\\]+)$/);
+    if (agentMatch) {
+        return { kind: 'agent', ownerId: agentMatch[1] };
+    }
+    if (normalized.includes(`${join('.goodvibes', '.worktrees')}`)) {
+        return { kind: 'orchestrator' };
+    }
+    return { kind: 'manual' };
+}
+export class WorktreeRegistry {
+    git;
+    workingDirectory;
+    constructor(workingDirectory) {
+        this.workingDirectory = workingDirectory;
+        this.git = new GitService(workingDirectory);
+    }
+    async list() {
+        const store = readStore(this.workingDirectory);
+        const listed = await this.git.worktreeList();
+        const present = new Set(listed.map((entry) => normalizePath(entry.path, this.workingDirectory)));
+        const records = listed.map((entry) => {
+            const path = normalizePath(entry.path, this.workingDirectory);
+            const meta = store.records[path];
+            const classified = classifyWorktreePath(path, this.workingDirectory);
+            return {
+                path,
+                branch: entry.branch,
+                head: entry.head,
+                kind: meta?.kind ?? classified.kind,
+                state: meta?.state ?? 'active',
+                ...(meta?.ownerId ?? classified.ownerId ? { ownerId: meta?.ownerId ?? classified.ownerId } : {}),
+                ...(meta?.sessionId ? { sessionId: meta.sessionId } : {}),
+                ...(meta?.taskId ? { taskId: meta.taskId } : {}),
+                updatedAt: meta?.updatedAt ?? Date.now(),
+            };
+        });
+        const nextRecords = {};
+        for (const record of records) {
+            nextRecords[record.path] = {
+                path: record.path,
+                kind: record.kind,
+                state: record.state,
+                ...(record.ownerId ? { ownerId: record.ownerId } : {}),
+                ...(record.sessionId ? { sessionId: record.sessionId } : {}),
+                ...(record.taskId ? { taskId: record.taskId } : {}),
+                updatedAt: record.updatedAt,
+            };
+        }
+        for (const [path, meta] of Object.entries(store.records)) {
+            if (!present.has(path) && meta.state === 'kept')
+                nextRecords[path] = meta;
+        }
+        writeStore({ version: 1, records: nextRecords }, this.workingDirectory);
+        return records.sort((a, b) => a.path.localeCompare(b.path));
+    }
+    attach(path, target) {
+        const store = readStore(this.workingDirectory);
+        const normalized = normalizePath(path, this.workingDirectory);
+        const existing = store.records[normalized];
+        const classified = classifyWorktreePath(normalized, this.workingDirectory);
+        store.records[normalized] = {
+            path: normalized,
+            kind: existing?.kind ?? classified.kind,
+            state: existing?.state ?? 'active',
+            ...(existing?.ownerId ?? classified.ownerId ? { ownerId: existing?.ownerId ?? classified.ownerId } : {}),
+            ...(target.sessionId ? { sessionId: target.sessionId } : {}),
+            ...(target.taskId ? { taskId: target.taskId } : {}),
+            updatedAt: Date.now(),
+        };
+        writeStore(store, this.workingDirectory);
+    }
+    setState(path, state) {
+        const store = readStore(this.workingDirectory);
+        const normalized = normalizePath(path, this.workingDirectory);
+        const existing = store.records[normalized];
+        const classified = classifyWorktreePath(normalized, this.workingDirectory);
+        store.records[normalized] = {
+            path: normalized,
+            kind: existing?.kind ?? classified.kind,
+            state,
+            ...(existing?.ownerId ?? classified.ownerId ? { ownerId: existing?.ownerId ?? classified.ownerId } : {}),
+            ...(existing?.sessionId ? { sessionId: existing.sessionId } : {}),
+            ...(existing?.taskId ? { taskId: existing.taskId } : {}),
+            updatedAt: Date.now(),
+        };
+        writeStore(store, this.workingDirectory);
+    }
+    async cleanup(path) {
+        const normalized = isAbsolute(path) ? path : normalizePath(path, this.workingDirectory);
+        await this.git.worktreeRemove(normalized);
+        const store = readStore(this.workingDirectory);
+        delete store.records[normalized];
+        writeStore(store, this.workingDirectory);
+    }
+}