mythos-router 1.1.9 → 1.2.0

package/CHANGELOG.md

@@ -7,6 +7,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [1.2.0] — 2026-04-23
+
+### Added
+- **SWDEngine v1 API** — Transactional filesystem execution kernel with `Plan → Snapshot → Execute → Verify → Rollback` lifecycle. Single entry point: `engine.run(actions)`.
+- **ChatUI Abstraction** — Decoupled chat session logic from the terminal via a `ChatUI` interface. `ChatSession` is now a pure orchestrator, fully testable and reusable outside the CLI.
+- **TerminalUI Implementation** — CLI-specific `ChatUI` adapter wrapping the Spinner and ANSI output.
+- **SWD Lifecycle Hooks** — Extensibility layer (`onAction`, `onVerify`, `onRollback`) allowing consumers to inject logging, telemetry, or custom UI into the engine.
+- **Rollback Auditability** — `SWDRunResult.rollbackErrors` field captures and reports rollback failures instead of silently swallowing them.
+- **`swd-cli.ts`** — Separated SWD terminal presentation (verification output, dry-run preview, verbose traces) from the pure execution kernel.
+- **Git Sandbox** — `ChatSession.setupSandbox()` for automated `mythos/` branch creation with nested-sandboxing protection.
+
+### Changed
+- **SWD Kernel is now I/O-free** — `swd.ts` contains zero `console.log` calls. All presentation lives in `swd-cli.ts`.
+- **`validateApiKey()` throws instead of `process.exit(1)`** — library-safe error handling.
+- **SDK exports (`index.ts`) fully updated** — removed dead symbols (`runSWD`, `parseFileActions`, `snapshotFiles`), added `SWDEngine`, `parseActions`, `SessionBudget`, `ChatUI`, and all v1 types.
+
+### Fixed
+- **🔴 Snapshot memoization bug** — `InternalSessionContext.getSnapshot('after')` was returning stale cached state on multi-action same-file scenarios. After snapshots now always re-read disk state.
+- **🔴 Broken `index.ts` exports** — SDK entry point was referencing pre-refactor symbols that no longer existed.
+
+---
+
 ## [1.1.9] — 2026-04-22
 
 ### Added

package/README.md

@@ -220,24 +220,32 @@ Data is stored locally in `~/.mythos-router/metrics.json`.
 `mythos-router` exposes its Strict Write Discipline engine for programmatic use:
 
 ```typescript
-import { runSWD, snapshotFiles } from 'mythos-router';
+import { SWDEngine, parseActions } from 'mythos-router';
 
-// 1. Snapshot the target directory before your agent executes
-const beforeState = snapshotFiles(['./src/components']);
+// 1. Create an engine instance with your preferred options
+const engine = new SWDEngine({
+  strict: true,
+  enableRollback: true,
+  onAction: (action) => console.log(`Executing: ${action.operation} ${action.path}`),
+  onVerify: (result) => console.log(`${result.status}: ${result.detail}`),
+});
 
 // 2. Let your agent generate code (must output [FILE_ACTION] blocks)
-const agentOutput = await myAgent.generateCode(); 
+const agentOutput = await myAgent.generateCode();
 
-// 3. Route through the Strict Write Discipline engine
-const result = runSWD(agentOutput, beforeState);
+// 3. Parse the agent's output and route through the SWD engine
+const actions = parseActions(agentOutput);
+const result = await engine.run(actions);
 
-if (result.verified) {
+if (result.success) {
   console.log('✅ Agent execution verified securely');
 } else {
-  console.log('❌ Agent hallucinated a write. Stopping execution.');
+  console.log('❌ Agent hallucinated a write. Rolled back:', result.rolledBack);
+  console.log('Errors:', result.errors);
 }
 ```
 
+
 ---
 
 ## Architecture
@@ -246,15 +254,19 @@ if (result.verified) {
 mythos-router/
 ├── src/
 │   ├── cli.ts           # Commander.js entry point
-│   ├── config.ts        # System prompt + constants + budget defaults
-│   ├── client.ts        # Anthropic SDK (adaptive thinking)
-│   ├── budget.ts        # Session budget limiter (token cap, turn cap)
-│   ├── swd.ts           # Strict Write Discipline + dry-run preview
-│   ├── memory.ts        # MEMORY.md self-healing manager (dry-run aware)
+│   ├── config.ts        # System prompt + constants + budget defaults + validation
+│   ├── client.ts        # Anthropic SDK (adaptive thinking, streaming)
+│   ├── budget.ts        # Session budget limiter (token cap, turn cap, progress bar)
+│   ├── swd.ts           # SWD execution kernel (engine, types, parsing, snapshots)
+│   ├── swd-cli.ts       # SWD terminal presentation (verification output, dry-run)
+│   ├── memory.ts        # MEMORY.md self-healing manager (SQLite FTS5 index)
 │   ├── metrics.ts       # Global metrics store (persistent budget tracking)
-│   ├── utils.ts         # Terminal formatting, badges, prompts (zero-dep)
+│   ├── diff.ts          # Myers' diff algorithm (zero-dependency)
+│   ├── git.ts           # Git operations (branching, committing)
+│   ├── utils.ts         # Terminal formatting, badges, prompts (zero-dep ANSI)
+│   ├── index.ts         # Public SDK exports
 │   └── commands/
-│       ├── chat.ts      # Interactive REPL (budget + dry-run + verbose)
+│       ├── chat.ts      # Interactive REPL (ChatSession + ChatUI abstraction)
 │       ├── verify.ts    # Codebase ↔ Memory scanner (dry-run aware)
 │       ├── dream.ts     # Memory compression (dry-run aware)
 │       └── stats.ts     # Budget analytics reporter

package/dist/cli.js

@@ -14,7 +14,7 @@ program
     .name('mythos')
     .description('Capybara-tier CLI router — Claude Opus 4.7 with Adaptive Thinking, ' +
     'Strict Write Discipline, and Self-Healing Memory.')
-    .version('1.1.9');
+    .version('1.2.0');
 // ── mythos chat ──────────────────────────────────────────────
 program
     .command('chat')

package/dist/commands/chat.d.ts

@@ -1,3 +1,14 @@
+export interface ChatUI {
+    startLoading(msg: string): void;
+    updateLoading(msg: string): void;
+    stopLoading(msg?: string): void;
+    write(text: string): void;
+    log(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+    success(msg: string): void;
+    divider(): void;
+}
 interface ChatOptions {
     effort?: string;
     maxTokens?: string;

package/dist/commands/chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/commands/chat.ts"],"names":[],"mappings":"AAiDA,UAAU,WAAW;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAGD,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAwWrE"}
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/commands/chat.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,MAAM;IACrB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,IAAI,IAAI,CAAC;CACjB;AA2PD,UAAU,WAAW;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA2CrE"}