anantham-v2 2.0.0-alpha.1

package/dist/cli/index.js

@@ -0,0 +1,13 @@
+/**
+ * Anantham V2 — CLI & Interactive Session Subsystem
+ * PRD Part 2 Section 170–180 / P8.1
+ */
+export * from "./command-parser.js";
+export * from "./output-renderer.js";
+export * from "./error-handler.js";
+export * from "./session-controller.js";
+export * from "./signal-handler.js";
+export * from "./command-registry.js";
+export * from "./interactive-session-loop.js";
+export * from "./cli-application.js";
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC"}

package/dist/cli/interactive-session-loop.d.ts

@@ -0,0 +1,36 @@
+import { type Readable, type Writable } from "node:stream";
+import { CommandParser } from "./command-parser.js";
+import { CommandRegistry } from "./command-registry.js";
+import { OutputRenderer } from "./output-renderer.js";
+import { SessionController } from "./session-controller.js";
+import { CliErrorHandler } from "./error-handler.js";
+export interface InteractiveSessionLoopOptions {
+    parser: CommandParser;
+    registry: CommandRegistry;
+    renderer: OutputRenderer;
+    controller: SessionController;
+    errorHandler?: CliErrorHandler;
+    input?: Readable;
+    output?: Writable;
+    promptPrefix?: string;
+}
+/**
+ * Interactive CLI REPL Session Loop.
+ * PRD Part 2 Section 170–175.
+ */
+export declare class InteractiveSessionLoop {
+    private readonly parser;
+    private readonly registry;
+    private readonly renderer;
+    private readonly controller;
+    private readonly errorHandler;
+    private readonly input;
+    private readonly output;
+    private readonly promptPrefix;
+    private isRunning;
+    constructor(options: InteractiveSessionLoopOptions);
+    run(): Promise<void>;
+    stop(): void;
+    private buildPrompt;
+}
+//# sourceMappingURL=interactive-session-loop.d.ts.map

package/dist/cli/interactive-session-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-session-loop.d.ts","sourceRoot":"","sources":["../../src/cli/interactive-session-loop.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkB;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE,6BAA6B;IAWrC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IA4C1B,IAAI,IAAI,IAAI;IAInB,OAAO,CAAC,WAAW;CAMpB"}

package/dist/cli/interactive-session-loop.js

@@ -0,0 +1,77 @@
+import readline from "node:readline/promises";
+import { CliErrorHandler } from "./error-handler.js";
+/**
+ * Interactive CLI REPL Session Loop.
+ * PRD Part 2 Section 170–175.
+ */
+export class InteractiveSessionLoop {
+    parser;
+    registry;
+    renderer;
+    controller;
+    errorHandler;
+    input;
+    output;
+    promptPrefix;
+    isRunning = false;
+    constructor(options) {
+        this.parser = options.parser;
+        this.registry = options.registry;
+        this.renderer = options.renderer;
+        this.controller = options.controller;
+        this.errorHandler = options.errorHandler ?? new CliErrorHandler();
+        this.input = options.input ?? process.stdin;
+        this.output = options.output ?? process.stdout;
+        this.promptPrefix = options.promptPrefix ?? "anantham";
+    }
+    async run() {
+        const rl = readline.createInterface({
+            input: this.input,
+            output: this.output,
+            terminal: false,
+        });
+        this.isRunning = true;
+        try {
+            this.output.write(this.buildPrompt());
+            for await (const rawLine of rl) {
+                if (!this.isRunning)
+                    break;
+                const trimmed = rawLine.trim();
+                if (trimmed) {
+                    try {
+                        const parsed = this.parser.parse(trimmed);
+                        const result = await this.registry.execute(parsed);
+                        const rendered = this.renderer.renderResult(result);
+                        this.output.write(rendered + "\n");
+                        if (result.exitRequested) {
+                            this.isRunning = false;
+                            break;
+                        }
+                    }
+                    catch (err) {
+                        const errResult = this.errorHandler.handleError("repl", err);
+                        const rendered = this.renderer.renderResult(errResult);
+                        this.output.write(rendered + "\n");
+                    }
+                }
+                if (this.isRunning) {
+                    this.output.write(this.buildPrompt());
+                }
+            }
+        }
+        finally {
+            rl.close();
+            this.isRunning = false;
+        }
+    }
+    stop() {
+        this.isRunning = false;
+    }
+    buildPrompt() {
+        const ctx = this.controller.getContext();
+        const proj = ctx.activeProjectId ? ctx.activeProjectId : "-";
+        const sess = ctx.activeSessionId ? ctx.activeSessionId : "-";
+        return `${this.promptPrefix} [${proj}/${sess}] > `;
+    }
+}
+//# sourceMappingURL=interactive-session-loop.js.map

package/dist/cli/interactive-session-loop.js.map

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

package/dist/cli/output-renderer.d.ts

@@ -0,0 +1,34 @@
+import { type CliOutputMode, type CommandExecutionResult } from "../domain/cli.js";
+export interface OutputRendererOptions {
+    mode?: CliOutputMode;
+    redactSecrets?: boolean;
+}
+/**
+ * Structured Output Renderer.
+ * PRD Part 2 Section 175.
+ */
+export declare class OutputRenderer {
+    private mode;
+    private readonly redactSecrets;
+    constructor(options?: OutputRendererOptions);
+    setMode(mode: CliOutputMode): void;
+    getMode(): CliOutputMode;
+    /**
+     * Render a command execution result.
+     */
+    renderResult(result: CommandExecutionResult): string;
+    /**
+     * Render arbitrary data according to current output mode.
+     */
+    renderData(data: unknown, title?: string): string;
+    /**
+     * Format human-readable text output.
+     */
+    private renderText;
+    private formatAsText;
+    /**
+     * Recursively redact secret fields.
+     */
+    private sanitize;
+}
+//# sourceMappingURL=output-renderer.d.ts.map

package/dist/cli/output-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-renderer.d.ts","sourceRoot":"","sources":["../../src/cli/output-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAEnF,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;gBAE5B,OAAO,GAAE,qBAA0B;IAKxC,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAIlC,OAAO,IAAI,aAAa;IAI/B;;OAEG;IACI,YAAY,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM;IAc3D;;OAEG;IACI,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAiBxD;;OAEG;IACH,OAAO,CAAC,UAAU;IAuBlB,OAAO,CAAC,YAAY;IAwBpB;;OAEG;IACH,OAAO,CAAC,QAAQ;CAwBjB"}

package/dist/cli/output-renderer.js

@@ -0,0 +1,127 @@
+/**
+ * Structured Output Renderer.
+ * PRD Part 2 Section 175.
+ */
+export class OutputRenderer {
+    mode;
+    redactSecrets;
+    constructor(options = {}) {
+        this.mode = options.mode ?? "text";
+        this.redactSecrets = options.redactSecrets ?? true;
+    }
+    setMode(mode) {
+        this.mode = mode;
+    }
+    getMode() {
+        return this.mode;
+    }
+    /**
+     * Render a command execution result.
+     */
+    renderResult(result) {
+        const sanitizedResult = this.redactSecrets ? this.sanitize(result) : result;
+        switch (this.mode) {
+            case "json":
+                return JSON.stringify(sanitizedResult, null, 2);
+            case "jsonl":
+                return JSON.stringify(sanitizedResult);
+            case "text":
+            default:
+                return this.renderText(sanitizedResult);
+        }
+    }
+    /**
+     * Render arbitrary data according to current output mode.
+     */
+    renderData(data, title) {
+        const sanitized = this.redactSecrets ? this.sanitize(data) : data;
+        switch (this.mode) {
+            case "json":
+                return JSON.stringify(sanitized, null, 2);
+            case "jsonl":
+                return JSON.stringify(sanitized);
+            case "text":
+            default:
+                if (title) {
+                    return `=== ${title} ===\n` + this.formatAsText(sanitized);
+                }
+                return this.formatAsText(sanitized);
+        }
+    }
+    /**
+     * Format human-readable text output.
+     */
+    renderText(result) {
+        const lines = [];
+        if (result.success) {
+            if (result.message) {
+                lines.push(`✔ ${result.message}`);
+            }
+            else {
+                lines.push(`✔ Command /${result.commandName} succeeded.`);
+            }
+            if (result.data !== undefined && result.data !== null) {
+                lines.push(this.formatAsText(result.data));
+            }
+        }
+        else {
+            lines.push(`✖ Command /${result.commandName} failed: ${result.error || "Unknown error"}`);
+            if (result.classification) {
+                lines.push(`  Classification: ${result.classification}`);
+            }
+        }
+        return lines.join("\n");
+    }
+    formatAsText(data) {
+        if (typeof data === "string")
+            return data;
+        if (typeof data === "number" || typeof data === "boolean")
+            return String(data);
+        if (data === null || data === undefined)
+            return "";
+        if (Array.isArray(data)) {
+            if (data.length === 0)
+                return "(empty list)";
+            return data
+                .map((item, idx) => {
+                if (typeof item === "object" && item !== null) {
+                    return `[${idx + 1}] ` + JSON.stringify(item);
+                }
+                return `• ${String(item)}`;
+            })
+                .join("\n");
+        }
+        if (typeof data === "object") {
+            return JSON.stringify(data, null, 2);
+        }
+        return String(data);
+    }
+    /**
+     * Recursively redact secret fields.
+     */
+    sanitize(val) {
+        if (val === null || val === undefined)
+            return val;
+        if (typeof val !== "object")
+            return val;
+        if (Array.isArray(val)) {
+            return val.map((item) => this.sanitize(item));
+        }
+        const sanitizedObj = {};
+        const secretKeyPatterns = [/token/i, /secret/i, /key/i, /auth/i, /password/i, /credential/i];
+        for (const [k, v] of Object.entries(val)) {
+            const isSecretKey = secretKeyPatterns.some((p) => p.test(k));
+            if (isSecretKey && typeof v === "string" && v.length > 0) {
+                sanitizedObj[k] = "[REDACTED]";
+            }
+            else if (typeof v === "object" && v !== null) {
+                sanitizedObj[k] = this.sanitize(v);
+            }
+            else {
+                sanitizedObj[k] = v;
+            }
+        }
+        return sanitizedObj;
+    }
+}
+//# sourceMappingURL=output-renderer.js.map

package/dist/cli/output-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-renderer.js","sourceRoot":"","sources":["../../src/cli/output-renderer.ts"],"names":[],"mappings":"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"}

package/dist/cli/session-controller.d.ts

@@ -0,0 +1,32 @@
+import { type CliContext, type CliOutputMode } from "../domain/cli.js";
+import { type Session } from "../domain/session.js";
+import { type Project } from "../domain/project.js";
+import { ProjectRepository } from "../persistence/repositories/project-repository.js";
+import { SessionRepository } from "../persistence/repositories/session-repository.js";
+export interface SessionControllerOptions {
+    projectRepo: ProjectRepository;
+    sessionRepo: SessionRepository;
+    initialProjectId?: string;
+    initialSessionId?: string;
+    outputMode?: CliOutputMode;
+}
+/**
+ * CLI Session Controller & Project Boundary Enforcer.
+ * PRD Part 1 Section 10–20 & PRD Part 2 Section 170.
+ */
+export declare class SessionController {
+    private readonly projectRepo;
+    private readonly sessionRepo;
+    private context;
+    constructor(options: SessionControllerOptions);
+    getContext(): CliContext;
+    setOutputMode(mode: CliOutputMode): void;
+    setActiveProject(projectId: string): Project;
+    setActiveSession(sessionId: string): Session;
+    createSession(name: string, modelProfile?: string): Session;
+    ensureActiveProject(): string;
+    ensureActiveSession(): string;
+    listProjects(): Project[];
+    listSessions(projectId?: string): Session[];
+}
+//# sourceMappingURL=session-controller.d.ts.map

package/dist/cli/session-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-controller.d.ts","sourceRoot":"","sources":["../../src/cli/session-controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAoB,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAEtF,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,aAAa,CAAC;CAC5B;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,OAAO,CAAa;gBAEhB,OAAO,EAAE,wBAAwB;IActC,UAAU,IAAI,UAAU;IAIxB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAIxC,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAkB5C,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAkB5C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,SAAY,GAAG,OAAO;IAyB9D,mBAAmB,IAAI,MAAM;IAO7B,mBAAmB,IAAI,MAAM;IAO7B,YAAY,IAAI,OAAO,EAAE;IAIzB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE;CAOnD"}

package/dist/cli/session-controller.js

@@ -0,0 +1,102 @@
+import { randomUUID } from "node:crypto";
+import { CliContextSchema } from "../domain/cli.js";
+/**
+ * CLI Session Controller & Project Boundary Enforcer.
+ * PRD Part 1 Section 10–20 & PRD Part 2 Section 170.
+ */
+export class SessionController {
+    projectRepo;
+    sessionRepo;
+    context;
+    constructor(options) {
+        this.projectRepo = options.projectRepo;
+        this.sessionRepo = options.sessionRepo;
+        this.context = CliContextSchema.parse({
+            activeProjectId: options.initialProjectId,
+            activeSessionId: options.initialSessionId,
+            outputMode: options.outputMode ?? "text",
+            correlationId: `cli_corr_${randomUUID()}`,
+            user: "operator",
+            metadata: {},
+        });
+    }
+    getContext() {
+        return { ...this.context };
+    }
+    setOutputMode(mode) {
+        this.context.outputMode = mode;
+    }
+    setActiveProject(projectId) {
+        const project = this.projectRepo.findById(projectId);
+        if (!project) {
+            throw new Error(`Project "${projectId}" not found.`);
+        }
+        this.context.activeProjectId = project.id;
+        // Clear session if it belonged to another project
+        if (this.context.activeSessionId) {
+            const activeSession = this.sessionRepo.findById(this.context.activeSessionId);
+            if (activeSession && activeSession.projectId !== project.id) {
+                this.context.activeSessionId = undefined;
+            }
+        }
+        return project;
+    }
+    setActiveSession(sessionId) {
+        const session = this.sessionRepo.findById(sessionId);
+        if (!session) {
+            throw new Error(`Session "${sessionId}" not found.`);
+        }
+        // Enforce Project Tenant Boundary
+        if (this.context.activeProjectId && session.projectId !== this.context.activeProjectId) {
+            throw new Error(`Project boundary violation: Session "${sessionId}" belongs to project "${session.projectId}", but active project is "${this.context.activeProjectId}".`);
+        }
+        this.context.activeProjectId = session.projectId;
+        this.context.activeSessionId = session.id;
+        return session;
+    }
+    createSession(name, modelProfile = "default") {
+        const projectId = this.ensureActiveProject();
+        const now = new Date().toISOString();
+        const sessionId = `sess_${randomUUID()}`;
+        const session = {
+            id: sessionId,
+            projectId,
+            name,
+            branch: "main",
+            status: "active",
+            modelProfile,
+            keyPoolProfile: "default",
+            mode: "interactive",
+            permissions: {},
+            createdAt: now,
+            updatedAt: now,
+            metadata: {},
+        };
+        this.sessionRepo.save(session);
+        this.context.activeSessionId = session.id;
+        return session;
+    }
+    ensureActiveProject() {
+        if (!this.context.activeProjectId) {
+            throw new Error("No active project selected. Use '/project select <id>' or '/project create <name>' first.");
+        }
+        return this.context.activeProjectId;
+    }
+    ensureActiveSession() {
+        if (!this.context.activeSessionId) {
+            throw new Error("No active session selected. Use '/session select <id>' or '/session create <name>' first.");
+        }
+        return this.context.activeSessionId;
+    }
+    listProjects() {
+        return this.projectRepo.list();
+    }
+    listSessions(projectId) {
+        const targetProject = projectId || this.context.activeProjectId;
+        if (targetProject) {
+            return this.sessionRepo.listByProject(targetProject);
+        }
+        return [];
+    }
+}
+//# sourceMappingURL=session-controller.js.map

package/dist/cli/session-controller.js.map

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

package/dist/cli/signal-handler.d.ts

@@ -0,0 +1,19 @@
+export type CancellationCallback = (reason: string) => Promise<void> | void;
+/**
+ * CLI Signal & Cancellation Handler.
+ * Manages SIGINT/SIGTERM process signals and coordinates graceful runtime cancellation.
+ * PRD Part 2 Section 176.
+ */
+export declare class SignalHandler {
+    private cancellationCallbacks;
+    private isCancelling;
+    private sigintCount;
+    private attached;
+    registerCancellationCallback(cb: CancellationCallback): () => void;
+    attach(): void;
+    detach(): void;
+    triggerCancellation(reason?: string): Promise<void>;
+    private handleSigint;
+    private handleSigterm;
+}
+//# sourceMappingURL=signal-handler.d.ts.map

package/dist/cli/signal-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-handler.d.ts","sourceRoot":"","sources":["../../src/cli/signal-handler.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE5E;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,qBAAqB,CAAwC;IACrE,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAS;IAElB,4BAA4B,CAAC,EAAE,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAOlE,MAAM,IAAI,IAAI;IAQd,MAAM,IAAI,IAAI;IAQR,mBAAmB,CAAC,MAAM,SAA2B,GAAG,OAAO,CAAC,IAAI,CAAC;IAelF,OAAO,CAAC,YAAY,CASlB;IAEF,OAAO,CAAC,aAAa,CAInB;CACH"}

package/dist/cli/signal-handler.js

@@ -0,0 +1,62 @@
+/**
+ * CLI Signal & Cancellation Handler.
+ * Manages SIGINT/SIGTERM process signals and coordinates graceful runtime cancellation.
+ * PRD Part 2 Section 176.
+ */
+export class SignalHandler {
+    cancellationCallbacks = new Set();
+    isCancelling = false;
+    sigintCount = 0;
+    attached = false;
+    registerCancellationCallback(cb) {
+        this.cancellationCallbacks.add(cb);
+        return () => {
+            this.cancellationCallbacks.delete(cb);
+        };
+    }
+    attach() {
+        if (this.attached)
+            return;
+        this.attached = true;
+        process.on("SIGINT", this.handleSigint);
+        process.on("SIGTERM", this.handleSigterm);
+    }
+    detach() {
+        if (!this.attached)
+            return;
+        this.attached = false;
+        process.removeListener("SIGINT", this.handleSigint);
+        process.removeListener("SIGTERM", this.handleSigterm);
+    }
+    async triggerCancellation(reason = "SIGINT signal received") {
+        if (this.isCancelling)
+            return;
+        this.isCancelling = true;
+        for (const cb of this.cancellationCallbacks) {
+            try {
+                await cb(reason);
+            }
+            catch {
+                // Suppress cancellation callback errors to ensure all handlers run
+            }
+        }
+        this.isCancelling = false;
+    }
+    handleSigint = async () => {
+        this.sigintCount++;
+        if (this.sigintCount === 1) {
+            console.log("\n[Anantham] Cancellation requested (Ctrl+C). Press again to force exit.");
+            await this.triggerCancellation("User interrupted (SIGINT)");
+        }
+        else {
+            console.log("\n[Anantham] Forcing immediate shutdown.");
+            process.exit(130);
+        }
+    };
+    handleSigterm = async () => {
+        console.log("\n[Anantham] Terminating (SIGTERM).");
+        await this.triggerCancellation("Process terminated (SIGTERM)");
+        process.exit(143);
+    };
+}
+//# sourceMappingURL=signal-handler.js.map

package/dist/cli/signal-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-handler.js","sourceRoot":"","sources":["../../src/cli/signal-handler.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,aAAa;IAChB,qBAAqB,GAA8B,IAAI,GAAG,EAAE,CAAC;IAC7D,YAAY,GAAG,KAAK,CAAC;IACrB,WAAW,GAAG,CAAC,CAAC;IAChB,QAAQ,GAAG,KAAK,CAAC;IAElB,4BAA4B,CAAC,EAAwB;QAC1D,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxC,CAAC,CAAC;IACJ,CAAC;IAEM,MAAM;QACX,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAErB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACxC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IAC5C,CAAC;IAEM,MAAM;QACX,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC3B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QAEtB,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACpD,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IACxD,CAAC;IAEM,KAAK,CAAC,mBAAmB,CAAC,MAAM,GAAG,wBAAwB;QAChE,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAC9B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAEzB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC5C,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC;YACnB,CAAC;YAAC,MAAM,CAAC;gBACP,mEAAmE;YACrE,CAAC;QACH,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC5B,CAAC;IAEO,YAAY,GAAG,KAAK,IAAI,EAAE;QAChC,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,IAAI,CAAC,WAAW,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,0EAA0E,CAAC,CAAC;YACxF,MAAM,IAAI,CAAC,mBAAmB,CAAC,2BAA2B,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;YACxD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,CAAC;IAEM,aAAa,GAAG,KAAK,IAAI,EAAE;QACjC,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;QACnD,MAAM,IAAI,CAAC,mBAAmB,CAAC,8BAA8B,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC,CAAC;CACH"}

package/dist/compaction/compaction-engine.d.ts

@@ -0,0 +1,50 @@
+import type { ContextPlan } from "../domain/context.js";
+import type { EventStore } from "../event-state/event-store.js";
+import { type CompactionPreview, type CompactionResult } from "./compaction-types.js";
+export interface CompactionOptions {
+    customObjective?: string;
+    customConstraints?: string[];
+    maxOutputTokens?: number;
+}
+export interface ExecuteCompactionParams {
+    sessionId: string;
+    projectId: string;
+    currentPlan: ContextPlan;
+    options?: CompactionOptions;
+    actorId?: string;
+}
+export interface AutoCompactParams {
+    sessionId: string;
+    projectId: string;
+    currentPlan: ContextPlan;
+    thresholdTokens: number;
+    options?: CompactionOptions;
+}
+export declare class CompactionEngine {
+    private readonly eventStore;
+    private readonly undoSnapshots;
+    constructor(eventStore: EventStore);
+    /**
+     * Generates a non-destructive preview of what compaction will achieve without mutating state.
+     * PRD Part 1 Section 80.
+     */
+    preview(currentPlan: ContextPlan, _options?: CompactionOptions): CompactionPreview;
+    /**
+     * Executes deterministic session compaction.
+     * Emits an immutable 'context.compacted' event to EventStore and returns a compacted ContextPlan.
+     * PRD Part 1 Sections 79-82.
+     */
+    compact(params: ExecuteCompactionParams): Promise<CompactionResult>;
+    /**
+     * Restores the previous ContextPlan prior to compaction.
+     * Critical: Authoritative event history in EventStore remains completely untouched.
+     * PRD Part 1 Section 81.
+     */
+    undo(sessionId: string): Promise<ContextPlan>;
+    /**
+     * Automatically triggers compaction if the current ContextPlan exceeds the configured token threshold.
+     * PRD Part 1 Section 82.
+     */
+    autoCompact(params: AutoCompactParams): Promise<CompactionResult | null>;
+}
+//# sourceMappingURL=compaction-engine.d.ts.map

package/dist/compaction/compaction-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-engine.d.ts","sourceRoot":"","sources":["../../src/compaction/compaction-engine.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAEtB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,iBAAiB;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuC;gBAEzD,UAAU,EAAE,UAAU;IAIlC;;;OAGG;IACI,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,iBAAiB;IA6CzF;;;;OAIG;IACU,OAAO,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgIhF;;;;OAIG;IACU,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAU1D;;;OAGG;IACU,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;CAoBtF"}