anantham-v2 2.0.0-alpha.1

package/dist/event-state/projections/task-board-projection.js

@@ -0,0 +1,155 @@
+import { EventTypes } from "../../domain/event.js";
+export class TaskBoardProjection {
+    name = "TaskBoardProjection";
+    states = new Map();
+    initSessionBoard(sessionId) {
+        const board = {
+            sessionId,
+            queued: [],
+            claimed: [],
+            running: [],
+            blocked: [],
+            waiting_approval: [],
+            paused: [],
+            verifying: [],
+            completed: [],
+            failed: [],
+            cancelled: [],
+            allTasks: new Map(),
+        };
+        this.states.set(sessionId, board);
+        return board;
+    }
+    reset() {
+        this.states.clear();
+    }
+    handleEvent(event) {
+        if (!event.sessionId || !event.taskId)
+            return;
+        let board = this.states.get(event.sessionId);
+        if (!board) {
+            board = this.initSessionBoard(event.sessionId);
+        }
+        let task = board.allTasks.get(event.taskId);
+        if (!task) {
+            task = {
+                taskId: event.taskId,
+                sessionId: event.sessionId,
+                status: "unknown",
+                updatedAt: event.timestamp,
+            };
+            board.allTasks.set(event.taskId, task);
+        }
+        task.updatedAt = event.timestamp;
+        if (event.agentId)
+            task.assignedAgent = event.agentId;
+        switch (event.type) {
+            case EventTypes.TASK_CREATED:
+                task.status = "queued";
+                if (event.payload.objective)
+                    task.objective = String(event.payload.objective);
+                break;
+            case EventTypes.TASK_STARTED:
+                task.status = "running";
+                break;
+            case EventTypes.TASK_PAUSED:
+                task.status = "paused";
+                break;
+            case EventTypes.TASK_RESUMED:
+                task.status = "running";
+                break;
+            case EventTypes.TASK_COMPLETED:
+                task.status = "completed";
+                break;
+            case EventTypes.TASK_FAILED:
+                task.status = "failed";
+                break;
+            case EventTypes.TASK_CANCELLED:
+                task.status = "cancelled";
+                break;
+        }
+        // Refresh state buckets for the session board
+        this.refreshBuckets(board);
+    }
+    refreshBuckets(board) {
+        board.queued = [];
+        board.claimed = [];
+        board.running = [];
+        board.blocked = [];
+        board.waiting_approval = [];
+        board.paused = [];
+        board.verifying = [];
+        board.completed = [];
+        board.failed = [];
+        board.cancelled = [];
+        for (const item of board.allTasks.values()) {
+            switch (item.status) {
+                case "queued":
+                    board.queued.push({ ...item });
+                    break;
+                case "claimed":
+                    board.claimed.push({ ...item });
+                    break;
+                case "running":
+                    board.running.push({ ...item });
+                    break;
+                case "blocked":
+                    board.blocked.push({ ...item });
+                    break;
+                case "waiting_approval":
+                    board.waiting_approval.push({ ...item });
+                    break;
+                case "paused":
+                    board.paused.push({ ...item });
+                    break;
+                case "verifying":
+                    board.verifying.push({ ...item });
+                    break;
+                case "completed":
+                    board.completed.push({ ...item });
+                    break;
+                case "failed":
+                    board.failed.push({ ...item });
+                    break;
+                case "cancelled":
+                    board.cancelled.push({ ...item });
+                    break;
+            }
+        }
+    }
+    rebuild(events) {
+        this.reset();
+        for (const event of events) {
+            this.handleEvent(event);
+        }
+    }
+    getState(sessionId) {
+        const b = this.states.get(sessionId);
+        if (!b)
+            return undefined;
+        return {
+            sessionId: b.sessionId,
+            queued: [...b.queued],
+            claimed: [...b.claimed],
+            running: [...b.running],
+            blocked: [...b.blocked],
+            waiting_approval: [...b.waiting_approval],
+            paused: [...b.paused],
+            verifying: [...b.verifying],
+            completed: [...b.completed],
+            failed: [...b.failed],
+            cancelled: [...b.cancelled],
+            totalTasks: b.allTasks.size,
+        };
+    }
+    getAllStates() {
+        const res = {};
+        for (const key of this.states.keys()) {
+            const snap = this.getState(key);
+            if (snap)
+                res[key] = snap;
+        }
+        return res;
+    }
+}
+//# sourceMappingURL=task-board-projection.js.map

package/dist/event-state/projections/task-board-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-board-projection.js","sourceRoot":"","sources":["../../../src/event-state/projections/task-board-projection.ts"],"names":[],"mappings":"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"}

package/dist/event-state/reconstruction/session-reconstruct.d.ts

@@ -0,0 +1,22 @@
+import type { HarnessEvent } from "../../domain/event.js";
+export interface ReconstructedSessionState {
+    sessionId: string;
+    projectId?: string;
+    name?: string;
+    branch?: string;
+    status: "created" | "active" | "paused" | "completed" | "deleted" | "unknown";
+    activeTaskId?: string;
+    tasksCount: number;
+    completedTasksCount: number;
+    failedTasksCount: number;
+    lastEventTimestamp?: string;
+    eventCount: number;
+    checkpointsCount: number;
+    forkedFromSessionId?: string;
+}
+/**
+ * Reconstructs a session's aggregate state from an immutable event stream using a pure reducer.
+ * PRD Part 1 Section 37-40 / Section 56 (Resume Algorithm).
+ */
+export declare function reconstructSessionState(sessionId: string, events: Readonly<HarnessEvent>[]): ReconstructedSessionState;
+//# sourceMappingURL=session-reconstruct.d.ts.map

package/dist/event-state/reconstruction/session-reconstruct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-reconstruct.d.ts","sourceRoot":"","sources":["../../../src/event-state/reconstruction/session-reconstruct.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,GAC/B,yBAAyB,CAyF3B"}

package/dist/event-state/reconstruction/session-reconstruct.js

@@ -0,0 +1,84 @@
+import { EventTypes } from "../../domain/event.js";
+/**
+ * Reconstructs a session's aggregate state from an immutable event stream using a pure reducer.
+ * PRD Part 1 Section 37-40 / Section 56 (Resume Algorithm).
+ */
+export function reconstructSessionState(sessionId, events) {
+    const state = {
+        sessionId,
+        status: "unknown",
+        tasksCount: 0,
+        completedTasksCount: 0,
+        failedTasksCount: 0,
+        eventCount: 0,
+        checkpointsCount: 0,
+    };
+    for (const event of events) {
+        if (event.sessionId && event.sessionId !== sessionId) {
+            continue;
+        }
+        state.eventCount++;
+        state.lastEventTimestamp = event.timestamp;
+        if (event.projectId && !state.projectId) {
+            state.projectId = event.projectId;
+        }
+        switch (event.type) {
+            case EventTypes.SESSION_CREATED:
+                state.status = "active";
+                if (event.payload.name)
+                    state.name = String(event.payload.name);
+                if (event.payload.branch)
+                    state.branch = String(event.payload.branch);
+                break;
+            case EventTypes.SESSION_RENAMED:
+                if (event.payload.name)
+                    state.name = String(event.payload.name);
+                break;
+            case EventTypes.SESSION_FORKED:
+                state.status = "active";
+                if (event.payload.parentSessionId) {
+                    state.forkedFromSessionId = String(event.payload.parentSessionId);
+                }
+                if (event.payload.branch)
+                    state.branch = String(event.payload.branch);
+                break;
+            case EventTypes.SESSION_PAUSED:
+                state.status = "paused";
+                break;
+            case EventTypes.SESSION_RESUMED:
+                state.status = "active";
+                break;
+            case EventTypes.SESSION_COMPLETED:
+                state.status = "completed";
+                break;
+            case EventTypes.SESSION_DELETED:
+                state.status = "deleted";
+                break;
+            case EventTypes.TASK_CREATED:
+                state.tasksCount++;
+                break;
+            case EventTypes.TASK_STARTED:
+                state.activeTaskId = event.taskId;
+                break;
+            case EventTypes.TASK_COMPLETED:
+                state.completedTasksCount++;
+                if (state.activeTaskId === event.taskId) {
+                    state.activeTaskId = undefined;
+                }
+                break;
+            case EventTypes.TASK_FAILED:
+                state.failedTasksCount++;
+                if (state.activeTaskId === event.taskId) {
+                    state.activeTaskId = undefined;
+                }
+                break;
+            case EventTypes.CHECKPOINT_CREATED:
+                state.checkpointsCount++;
+                break;
+            default:
+                break;
+        }
+    }
+    return state;
+}
+//# sourceMappingURL=session-reconstruct.js.map

package/dist/event-state/reconstruction/session-reconstruct.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-reconstruct.js","sourceRoot":"","sources":["../../../src/event-state/reconstruction/session-reconstruct.ts"],"names":[],"mappings":"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"}

package/dist/event-state/reconstruction/task-reconstruct.d.ts

@@ -0,0 +1,27 @@
+import type { HarnessEvent } from "../../domain/event.js";
+import type { TaskStatus, TaskPriority } from "../../domain/task.js";
+export interface SteeringRecord {
+    instruction: string;
+    timestamp: string;
+    actor: string;
+}
+export interface ReconstructedTaskState {
+    taskId: string;
+    projectId?: string;
+    sessionId?: string;
+    objective?: string;
+    status: TaskStatus | "unknown";
+    priority?: TaskPriority;
+    assignedAgent?: string;
+    steeringHistory: SteeringRecord[];
+    failureReason?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    eventCount: number;
+}
+/**
+ * Reconstructs a task's aggregate state from an immutable event stream using a pure reducer.
+ * PRD Part 1 Section 100-105 (Task Model & Steering).
+ */
+export declare function reconstructTaskState(taskId: string, events: Readonly<HarnessEvent>[]): ReconstructedTaskState;
+//# sourceMappingURL=task-reconstruct.d.ts.map

package/dist/event-state/reconstruction/task-reconstruct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-reconstruct.d.ts","sourceRoot":"","sources":["../../../src/event-state/reconstruction/task-reconstruct.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAErE,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,GAC/B,sBAAsB,CAqExB"}

package/dist/event-state/reconstruction/task-reconstruct.js

@@ -0,0 +1,71 @@
+import { EventTypes } from "../../domain/event.js";
+/**
+ * Reconstructs a task's aggregate state from an immutable event stream using a pure reducer.
+ * PRD Part 1 Section 100-105 (Task Model & Steering).
+ */
+export function reconstructTaskState(taskId, events) {
+    const state = {
+        taskId,
+        status: "unknown",
+        steeringHistory: [],
+        eventCount: 0,
+    };
+    for (const event of events) {
+        if (event.taskId && event.taskId !== taskId) {
+            continue;
+        }
+        state.eventCount++;
+        state.updatedAt = event.timestamp;
+        if (event.projectId && !state.projectId)
+            state.projectId = event.projectId;
+        if (event.sessionId && !state.sessionId)
+            state.sessionId = event.sessionId;
+        switch (event.type) {
+            case EventTypes.TASK_CREATED:
+                state.status = "queued";
+                state.createdAt = event.timestamp;
+                if (event.payload.objective)
+                    state.objective = String(event.payload.objective);
+                if (event.payload.priority)
+                    state.priority = event.payload.priority;
+                if (event.payload.agentRole)
+                    state.assignedAgent = String(event.payload.agentRole);
+                break;
+            case EventTypes.TASK_STARTED:
+                state.status = "running";
+                if (event.agentId)
+                    state.assignedAgent = event.agentId;
+                break;
+            case EventTypes.TASK_PAUSED:
+                state.status = "paused";
+                break;
+            case EventTypes.TASK_RESUMED:
+                state.status = "running";
+                break;
+            case EventTypes.TASK_STEERED:
+                if (event.payload.instruction) {
+                    state.steeringHistory.push({
+                        instruction: String(event.payload.instruction),
+                        timestamp: event.timestamp,
+                        actor: event.actor,
+                    });
+                }
+                break;
+            case EventTypes.TASK_COMPLETED:
+                state.status = "completed";
+                break;
+            case EventTypes.TASK_FAILED:
+                state.status = "failed";
+                if (event.payload.error)
+                    state.failureReason = String(event.payload.error);
+                break;
+            case EventTypes.TASK_CANCELLED:
+                state.status = "cancelled";
+                break;
+            default:
+                break;
+        }
+    }
+    return state;
+}
+//# sourceMappingURL=task-reconstruct.js.map

package/dist/event-state/reconstruction/task-reconstruct.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-reconstruct.js","sourceRoot":"","sources":["../../../src/event-state/reconstruction/task-reconstruct.ts"],"names":[],"mappings":"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"}

package/dist/event-state/session-tree/session-tree-manager.d.ts

@@ -0,0 +1,47 @@
+import type { Session } from "../../domain/session.js";
+import { type HarnessEvent } from "../../domain/event.js";
+import type { SessionRepository } from "../../persistence/repositories/session-repository.js";
+import type { EventStore } from "../event-store.js";
+export interface ForkSessionOptions {
+    newSessionId: string;
+    name?: string;
+    branch: string;
+    mode?: "interactive" | "autonomous" | "supervised" | "headless";
+    permissions?: Record<string, boolean | string>;
+    modelProfile?: string;
+    keyPoolProfile?: string;
+}
+export interface SessionTreeNode {
+    session: Session;
+    children: SessionTreeNode[];
+}
+/**
+ * SessionTreeManager manages session hierarchies, branching, ancestry tracing, and forking.
+ * PRD Part 1 Section 35 & 36 (Session Tree / Forking).
+ */
+export declare class SessionTreeManager {
+    private readonly sessionRepo;
+    private readonly eventStore;
+    constructor(sessionRepo: SessionRepository, eventStore: EventStore);
+    /**
+     * Forks an existing session into a new branch without mutating the parent session.
+     * Section 7: "Do not silently mutate the parent branch when creating a child branch."
+     */
+    forkSession(sourceSessionId: string, options: ForkSessionOptions): {
+        newSession: Session;
+        forkEvent: Readonly<HarnessEvent>;
+    };
+    /**
+     * Traces lineage of a session back to its root ancestor.
+     */
+    getSessionAncestry(sessionId: string): Session[];
+    /**
+     * Returns a hierarchical tree representation of all sessions within a project.
+     */
+    getSessionTree(projectId: string): SessionTreeNode[];
+    /**
+     * Lists all active distinct branches for a project.
+     */
+    listBranches(projectId: string): string[];
+}
+//# sourceMappingURL=session-tree-manager.d.ts.map

package/dist/event-state/session-tree/session-tree-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tree-manager.d.ts","sourceRoot":"","sources":["../../../src/event-state/session-tree/session-tree-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sDAAsD,CAAC;AAC9F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,aAAa,GAAG,YAAY,GAAG,YAAY,GAAG,UAAU,CAAC;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;gBAE5B,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU;IAKlE;;;OAGG;IACI,WAAW,CAChB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,kBAAkB,GAC1B;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAA;KAAE;IAiD7D;;OAEG;IACI,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE;IAqBvD;;OAEG;IACI,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,EAAE;IAyB3D;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE;CAQjD"}

package/dist/event-state/session-tree/session-tree-manager.js

@@ -0,0 +1,116 @@
+import { EventTypes } from "../../domain/event.js";
+/**
+ * SessionTreeManager manages session hierarchies, branching, ancestry tracing, and forking.
+ * PRD Part 1 Section 35 & 36 (Session Tree / Forking).
+ */
+export class SessionTreeManager {
+    sessionRepo;
+    eventStore;
+    constructor(sessionRepo, eventStore) {
+        this.sessionRepo = sessionRepo;
+        this.eventStore = eventStore;
+    }
+    /**
+     * Forks an existing session into a new branch without mutating the parent session.
+     * Section 7: "Do not silently mutate the parent branch when creating a child branch."
+     */
+    forkSession(sourceSessionId, options) {
+        const parentSession = this.sessionRepo.findById(sourceSessionId);
+        if (!parentSession) {
+            throw new Error(`Cannot fork from non-existent session '${sourceSessionId}'.`);
+        }
+        const now = new Date().toISOString();
+        const forkedSession = {
+            id: options.newSessionId,
+            projectId: parentSession.projectId,
+            name: options.name ?? `${parentSession.name} (fork - ${options.branch})`,
+            branch: options.branch,
+            parentSessionId: sourceSessionId,
+            status: "active",
+            modelProfile: options.modelProfile ?? parentSession.modelProfile,
+            keyPoolProfile: options.keyPoolProfile ?? parentSession.keyPoolProfile,
+            mode: options.mode ?? parentSession.mode,
+            permissions: options.permissions ?? { ...parentSession.permissions },
+            createdAt: now,
+            updatedAt: now,
+        };
+        // Save forked session to repository
+        this.sessionRepo.save(forkedSession);
+        // Commit fork event to authoritative event log
+        const forkEvent = {
+            id: `evt_fork_${options.newSessionId}_${Date.now()}`,
+            schemaVersion: 1,
+            projectId: parentSession.projectId,
+            sessionId: options.newSessionId,
+            type: EventTypes.SESSION_FORKED,
+            actor: "system",
+            timestamp: now,
+            payload: {
+                parentSessionId: sourceSessionId,
+                branch: options.branch,
+                parentBranch: parentSession.branch,
+            },
+        };
+        const committedForkEvent = this.eventStore.append(forkEvent);
+        return {
+            newSession: forkedSession,
+            forkEvent: committedForkEvent,
+        };
+    }
+    /**
+     * Traces lineage of a session back to its root ancestor.
+     */
+    getSessionAncestry(sessionId) {
+        const ancestry = [];
+        let currentId = sessionId;
+        const visited = new Set();
+        while (currentId) {
+            if (visited.has(currentId)) {
+                throw new Error(`Cyclic parent session reference detected for session '${currentId}'.`);
+            }
+            visited.add(currentId);
+            const session = this.sessionRepo.findById(currentId);
+            if (!session)
+                break;
+            ancestry.push(session);
+            currentId = session.parentSessionId;
+        }
+        return ancestry;
+    }
+    /**
+     * Returns a hierarchical tree representation of all sessions within a project.
+     */
+    getSessionTree(projectId) {
+        const allSessions = this.sessionRepo.listByProject(projectId);
+        const nodeMap = new Map();
+        for (const session of allSessions) {
+            nodeMap.set(session.id, { session, children: [] });
+        }
+        const roots = [];
+        for (const session of allSessions) {
+            const node = nodeMap.get(session.id);
+            if (!node)
+                continue;
+            if (session.parentSessionId && nodeMap.has(session.parentSessionId)) {
+                const parentNode = nodeMap.get(session.parentSessionId);
+                parentNode?.children.push(node);
+            }
+            else {
+                roots.push(node);
+            }
+        }
+        return roots;
+    }
+    /**
+     * Lists all active distinct branches for a project.
+     */
+    listBranches(projectId) {
+        const sessions = this.sessionRepo.listByProject(projectId);
+        const branches = new Set();
+        for (const s of sessions) {
+            branches.add(s.branch);
+        }
+        return Array.from(branches);
+    }
+}
+//# sourceMappingURL=session-tree-manager.js.map

package/dist/event-state/session-tree/session-tree-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tree-manager.js","sourceRoot":"","sources":["../../../src/event-state/session-tree/session-tree-manager.ts"],"names":[],"mappings":"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"}

package/dist/execution/change-set-calculator.d.ts

@@ -0,0 +1,23 @@
+import { type ChangeSetMetadata } from "../domain/workspace.js";
+export interface SymbolModification {
+    file: string;
+    symbol: string;
+    kind: "class" | "interface" | "type" | "function" | "const" | "migration" | "unknown";
+}
+/**
+ * Deterministic Change-Set Calculator.
+ * Computes exact file mutations, cryptographic hashes, diff patches,
+ * and contract/symbol modifications from an isolated worktree.
+ * PRD Part 2 Section 54.
+ */
+export declare class ChangeSetCalculator {
+    /**
+     * Calculate change-set metadata between base commit and worktree HEAD.
+     */
+    calculate(workspaceId: string, worktreePath: string, baseCommit: string, targetCommit?: string): Promise<ChangeSetMetadata>;
+    /**
+     * Extract modified symbols from key architectural files (domain, migrations, public index).
+     */
+    private extractSymbols;
+}
+//# sourceMappingURL=change-set-calculator.d.ts.map

package/dist/execution/change-set-calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-set-calculator.d.ts","sourceRoot":"","sources":["../../src/execution/change-set-calculator.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,wBAAwB,CAAC;AAIhC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;CACvF;AAED;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC9B;;OAEG;IACU,SAAS,CACpB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,YAAY,GAAE,MAAmB,GAChC,OAAO,CAAC,iBAAiB,CAAC;IAoG7B;;OAEG;IACH,OAAO,CAAC,cAAc;CA0CvB"}