ridgeline 0.1.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rob McLarty
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,137 @@
+# Ridgeline
+
+Build harness for long-horizon software execution using AI agents.
+
+Ridgeline decomposes large software ideas into phased builds using a
+three-agent system (planner, builder, reviewer) driven by the Claude CLI. It
+manages state through git checkpoints, tracks costs, and supports resumable
+execution when things go wrong.
+
+## How it works
+
+1. **Write a spec** -- describe what you want built in a markdown file along
+   with technical constraints and optional style preferences.
+2. **Plan** -- the planner agent reads your spec and produces numbered phase
+   files, each with its own scope and acceptance criteria.
+3. **Build** -- for each phase the builder agent implements the spec inside your
+   repo, then creates a git checkpoint.
+4. **Review** -- the reviewer agent checks the output against the acceptance
+   criteria and returns a structured verdict.
+5. **Retry or advance** -- failed phases are retried up to a configurable limit;
+   passing phases hand off context to the next one.
+
+## Install
+
+```sh
+npm install -g ridgeline
+```
+
+Ridgeline requires the [Claude CLI](https://docs.anthropic.com/en/docs/claude-code)
+to be installed and authenticated.
+
+## Quick start
+
+```sh
+# Scaffold a new build (interactive wizard)
+ridgeline init my-feature
+
+# Generate the phase plan
+ridgeline plan my-feature
+
+# Preview what will run
+ridgeline dry-run my-feature
+
+# Execute the full build
+ridgeline run my-feature
+
+# Resume after a failure
+ridgeline resume my-feature
+```
+
+## Commands
+
+### `ridgeline init [build-name]`
+
+Interactive wizard that creates the build directory under
+`.ridgeline/builds/<build-name>/` and collects your spec, constraints, and
+optional taste file.
+
+### `ridgeline plan [build-name]`
+
+Invokes the planner agent to decompose the spec into numbered phase files
+(`01-slug.md`, `02-slug.md`, ...) stored in the build's `phases/` directory.
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--model <name>` | `opus` | Model for the planner |
+| `--verbose` | off | Stream planner output to the terminal |
+| `--timeout <minutes>` | `30` | Max planning duration |
+| `--constraints <path>` | auto | Path to constraints file |
+| `--taste <path>` | auto | Path to taste file |
+
+### `ridgeline dry-run [build-name]`
+
+Displays the execution plan without invoking builders or reviewers. Accepts
+the same flags as `plan`.
+
+### `ridgeline run [build-name]`
+
+Executes the full build pipeline: build each phase, evaluate, retry on failure,
+and advance on success.
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--model <name>` | `opus` | Model for builder and reviewer |
+| `--verbose` | off | Stream output to the terminal |
+| `--timeout <minutes>` | `30` | Max duration per phase |
+| `--max-retries <n>` | `2` | Max reviewer retry loops per phase |
+| `--check <command>` | from constraints | Baseline check command |
+| `--max-budget-usd <n>` | none | Halt if cumulative cost exceeds this |
+| `--constraints <path>` | auto | Path to constraints file |
+| `--taste <path>` | auto | Path to taste file |
+
+### `ridgeline resume [build-name]`
+
+Loads existing state and resumes from the next incomplete phase. Accepts the
+same flags as `run`.
+
+## Build directory structure
+
+```text
+.ridgeline/builds/<build-name>/
+├── spec.md            # What to build
+├── constraints.md     # Technical constraints and check commands
+├── taste.md           # Optional coding style preferences
+├── phases/
+│   ├── 01-scaffold.md
+│   ├── 02-core.md
+│   └── ...
+├── state.json         # Phase statuses, retries, timestamps, git tags
+├── budget.json        # Per-invocation cost tracking
+├── trajectory.jsonl   # Event log (plan/build/eval start/complete)
+├── snapshot.md        # Summary of latest phase output
+└── handoff.md         # Context passed to the next phase
+```
+
+## Configuration resolution
+
+Constraint and taste files are resolved in order:
+
+1. CLI flag (`--constraints <path>`)
+2. Build-level (`.ridgeline/builds/<build-name>/constraints.md`)
+3. Project-level (`.ridgeline/constraints.md`)
+
+## Development
+
+```sh
+npm install
+npm run build       # Compile TypeScript and copy agent prompts
+npm run dev         # Watch mode
+npm test            # Run the test suite (vitest)
+npm run test:watch  # Watch mode
+npm run lint        # Run all linters (oxlint, markdownlint, agnix)
+```
+
+## License
+
+[MIT](LICENSE)

package/dist/__tests__/cli.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/cli.test.js

@@ -0,0 +1,151 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const setup_1 = require("../../test/setup");
+// Mock commander to prevent program.parse() from running on import
+vitest_1.vi.mock("commander", () => {
+    class MockCommand {
+        name() { return this; }
+        description() { return this; }
+        version() { return this; }
+        command() { return this; }
+        option() { return this; }
+        action() { return this; }
+        parse() { }
+    }
+    return { Command: MockCommand };
+});
+// Mock command modules to avoid side effects
+vitest_1.vi.mock("../commands/init", () => ({ runInit: vitest_1.vi.fn() }));
+vitest_1.vi.mock("../commands/plan", () => ({ runPlan: vitest_1.vi.fn() }));
+vitest_1.vi.mock("../commands/dryRun", () => ({ runDryRun: vitest_1.vi.fn() }));
+vitest_1.vi.mock("../commands/run", () => ({ runBuild: vitest_1.vi.fn() }));
+vitest_1.vi.mock("../commands/resume", () => ({ runResume: vitest_1.vi.fn() }));
+const cli_1 = require("../cli");
+(0, vitest_1.describe)("cli", () => {
+    (0, vitest_1.describe)("resolveFile", () => {
+        let tmpDir;
+        let buildDir;
+        let projectDir;
+        (0, vitest_1.beforeEach)(() => {
+            tmpDir = (0, setup_1.makeTempDir)();
+            buildDir = path.join(tmpDir, "build");
+            projectDir = path.join(tmpDir, "project");
+            fs.mkdirSync(buildDir, { recursive: true });
+            fs.mkdirSync(projectDir, { recursive: true });
+        });
+        (0, vitest_1.afterEach)(() => {
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        });
+        (0, vitest_1.it)("returns CLI flag path when it exists", () => {
+            const flagFile = path.join(tmpDir, "custom.md");
+            fs.writeFileSync(flagFile, "custom");
+            const result = (0, cli_1.resolveFile)(flagFile, buildDir, "test.md", projectDir);
+            (0, vitest_1.expect)(result).toBe(path.resolve(flagFile));
+        });
+        (0, vitest_1.it)("returns build-level file when no CLI flag", () => {
+            fs.writeFileSync(path.join(buildDir, "test.md"), "build");
+            const result = (0, cli_1.resolveFile)(undefined, buildDir, "test.md", projectDir);
+            (0, vitest_1.expect)(result).toBe(path.join(buildDir, "test.md"));
+        });
+        (0, vitest_1.it)("returns project-level file as fallback", () => {
+            fs.writeFileSync(path.join(projectDir, "test.md"), "project");
+            const result = (0, cli_1.resolveFile)(undefined, buildDir, "test.md", projectDir);
+            (0, vitest_1.expect)(result).toBe(path.join(projectDir, "test.md"));
+        });
+        (0, vitest_1.it)("returns null when file not found anywhere", () => {
+            const result = (0, cli_1.resolveFile)(undefined, buildDir, "missing.md", projectDir);
+            (0, vitest_1.expect)(result).toBeNull();
+        });
+        (0, vitest_1.it)("prefers CLI flag over build-level", () => {
+            const flagFile = path.join(tmpDir, "flag.md");
+            fs.writeFileSync(flagFile, "flag");
+            fs.writeFileSync(path.join(buildDir, "flag.md"), "build");
+            const result = (0, cli_1.resolveFile)(flagFile, buildDir, "flag.md", projectDir);
+            (0, vitest_1.expect)(result).toBe(path.resolve(flagFile));
+        });
+        (0, vitest_1.it)("prefers build-level over project-level", () => {
+            fs.writeFileSync(path.join(buildDir, "test.md"), "build");
+            fs.writeFileSync(path.join(projectDir, "test.md"), "project");
+            const result = (0, cli_1.resolveFile)(undefined, buildDir, "test.md", projectDir);
+            (0, vitest_1.expect)(result).toBe(path.join(buildDir, "test.md"));
+        });
+    });
+    (0, vitest_1.describe)("parseCheckCommand", () => {
+        let tmpDir;
+        (0, vitest_1.beforeEach)(() => {
+            tmpDir = (0, setup_1.makeTempDir)();
+        });
+        (0, vitest_1.afterEach)(() => {
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        });
+        (0, vitest_1.it)("extracts check command from constraints.md", () => {
+            const fp = path.join(tmpDir, "constraints.md");
+            fs.writeFileSync(fp, [
+                "# Constraints",
+                "",
+                "## Check Command",
+                "",
+                "```bash",
+                "npm run build && npm test",
+                "```",
+            ].join("\n"));
+            (0, vitest_1.expect)((0, cli_1.parseCheckCommand)(fp)).toBe("npm run build && npm test");
+        });
+        (0, vitest_1.it)("extracts check command without language tag", () => {
+            const fp = path.join(tmpDir, "constraints.md");
+            fs.writeFileSync(fp, [
+                "## Check Command",
+                "",
+                "```",
+                "make test",
+                "```",
+            ].join("\n"));
+            (0, vitest_1.expect)((0, cli_1.parseCheckCommand)(fp)).toBe("make test");
+        });
+        (0, vitest_1.it)("returns null when no check command section", () => {
+            const fp = path.join(tmpDir, "constraints.md");
+            fs.writeFileSync(fp, "# Constraints\n\nNo check command here.");
+            (0, vitest_1.expect)((0, cli_1.parseCheckCommand)(fp)).toBeNull();
+        });
+        (0, vitest_1.it)("returns null when file does not exist", () => {
+            (0, vitest_1.expect)((0, cli_1.parseCheckCommand)("/nonexistent/path.md")).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=cli.test.js.map

package/dist/__tests__/cli.test.js.map

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

package/dist/__tests__/git.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/git.test.js

@@ -0,0 +1,152 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const setup_1 = require("../../test/setup");
+const git_1 = require("../git");
+// Helper to create a temp git repo
+const initTempRepo = () => {
+    const dir = (0, setup_1.makeTempDir)();
+    (0, node_child_process_1.execSync)("git init", { cwd: dir, stdio: "pipe" });
+    (0, node_child_process_1.execSync)("git config user.email 'test@test.com'", { cwd: dir, stdio: "pipe" });
+    (0, node_child_process_1.execSync)("git config user.name 'Test'", { cwd: dir, stdio: "pipe" });
+    // Create initial commit so HEAD exists
+    fs.writeFileSync(path.join(dir, "init.txt"), "init");
+    (0, node_child_process_1.execSync)("git add -A && git commit -m 'init'", { cwd: dir, stdio: "pipe" });
+    return dir;
+};
+(0, vitest_1.describe)("git", () => {
+    let repoDir;
+    (0, vitest_1.beforeEach)(() => {
+        repoDir = initTempRepo();
+    });
+    (0, vitest_1.afterEach)(() => {
+        fs.rmSync(repoDir, { recursive: true, force: true });
+    });
+    (0, vitest_1.describe)("getCurrentSha", () => {
+        (0, vitest_1.it)("returns a 40-character hex string", () => {
+            const sha = (0, git_1.getCurrentSha)(repoDir);
+            (0, vitest_1.expect)(sha).toMatch(/^[0-9a-f]{40}$/);
+        });
+    });
+    (0, vitest_1.describe)("isWorkingTreeDirty", () => {
+        (0, vitest_1.it)("returns false for clean tree", () => {
+            (0, vitest_1.expect)((0, git_1.isWorkingTreeDirty)(repoDir)).toBe(false);
+        });
+        (0, vitest_1.it)("returns true when there are uncommitted changes", () => {
+            fs.writeFileSync(path.join(repoDir, "dirty.txt"), "dirty");
+            (0, vitest_1.expect)((0, git_1.isWorkingTreeDirty)(repoDir)).toBe(true);
+        });
+    });
+    (0, vitest_1.describe)("commitAll", () => {
+        (0, vitest_1.it)("stages and commits all changes", () => {
+            fs.writeFileSync(path.join(repoDir, "new.txt"), "new file");
+            (0, git_1.commitAll)("test commit", repoDir);
+            const log = (0, node_child_process_1.execSync)("git log --oneline", { cwd: repoDir, encoding: "utf-8" });
+            (0, vitest_1.expect)(log).toContain("test commit");
+            (0, vitest_1.expect)((0, git_1.isWorkingTreeDirty)(repoDir)).toBe(false);
+        });
+        (0, vitest_1.it)("does not throw when nothing to commit", () => {
+            (0, vitest_1.expect)(() => (0, git_1.commitAll)("empty commit", repoDir)).not.toThrow();
+        });
+    });
+    (0, vitest_1.describe)("createTag / tagExists / deleteTag", () => {
+        (0, vitest_1.it)("creates a tag that can be detected", () => {
+            (0, git_1.createTag)("test-tag", repoDir);
+            (0, vitest_1.expect)((0, git_1.tagExists)("test-tag", repoDir)).toBe(true);
+        });
+        (0, vitest_1.it)("returns false for nonexistent tag", () => {
+            (0, vitest_1.expect)((0, git_1.tagExists)("nonexistent", repoDir)).toBe(false);
+        });
+        (0, vitest_1.it)("deletes an existing tag", () => {
+            (0, git_1.createTag)("to-delete", repoDir);
+            (0, git_1.deleteTag)("to-delete", repoDir);
+            (0, vitest_1.expect)((0, git_1.tagExists)("to-delete", repoDir)).toBe(false);
+        });
+        (0, vitest_1.it)("does not throw when deleting nonexistent tag", () => {
+            (0, vitest_1.expect)(() => (0, git_1.deleteTag)("no-such-tag", repoDir)).not.toThrow();
+        });
+    });
+    (0, vitest_1.describe)("getDiff", () => {
+        (0, vitest_1.it)("returns diff between tag and HEAD", () => {
+            (0, git_1.createTag)("before-change", repoDir);
+            fs.writeFileSync(path.join(repoDir, "changed.txt"), "content");
+            (0, git_1.commitAll)("add changed file", repoDir);
+            const diff = (0, git_1.getDiff)("before-change", repoDir);
+            (0, vitest_1.expect)(diff).toContain("changed.txt");
+            (0, vitest_1.expect)(diff).toContain("content");
+        });
+        (0, vitest_1.it)("returns empty string when tag does not exist", () => {
+            (0, vitest_1.expect)((0, git_1.getDiff)("nonexistent-tag", repoDir)).toBe("");
+        });
+    });
+    (0, vitest_1.describe)("getChangedFileNames", () => {
+        (0, vitest_1.it)("returns list of changed files", () => {
+            (0, git_1.createTag)("baseline", repoDir);
+            fs.writeFileSync(path.join(repoDir, "a.txt"), "a");
+            fs.writeFileSync(path.join(repoDir, "b.txt"), "b");
+            (0, git_1.commitAll)("add files", repoDir);
+            const files = (0, git_1.getChangedFileNames)("baseline", repoDir);
+            (0, vitest_1.expect)(files).toContain("a.txt");
+            (0, vitest_1.expect)(files).toContain("b.txt");
+        });
+        (0, vitest_1.it)("returns empty array for nonexistent tag", () => {
+            (0, vitest_1.expect)((0, git_1.getChangedFileNames)("missing", repoDir)).toEqual([]);
+        });
+    });
+    (0, vitest_1.describe)("getChangedFileContents", () => {
+        (0, vitest_1.it)("returns map of filename to contents", () => {
+            (0, git_1.createTag)("snap", repoDir);
+            fs.writeFileSync(path.join(repoDir, "file.txt"), "hello world");
+            (0, git_1.commitAll)("add file", repoDir);
+            const contents = (0, git_1.getChangedFileContents)("snap", repoDir);
+            (0, vitest_1.expect)(contents.get("file.txt")).toBe("hello world");
+        });
+        (0, vitest_1.it)("handles deleted files gracefully", () => {
+            fs.writeFileSync(path.join(repoDir, "temp.txt"), "temp");
+            (0, git_1.commitAll)("add temp", repoDir);
+            (0, git_1.createTag)("before-delete", repoDir);
+            fs.unlinkSync(path.join(repoDir, "temp.txt"));
+            (0, git_1.commitAll)("delete temp", repoDir);
+            const contents = (0, git_1.getChangedFileContents)("before-delete", repoDir);
+            // temp.txt was deleted so it should not be in the map (readFileSync fails)
+            (0, vitest_1.expect)(contents.has("temp.txt")).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=git.test.js.map

package/dist/__tests__/git.test.js.map

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

package/dist/__tests__/logging.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/logging.test.js

@@ -0,0 +1,119 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const logging_1 = require("../logging");
+const setup_1 = require("../../test/setup");
+(0, vitest_1.describe)("logging", () => {
+    (0, vitest_1.describe)("logInfo", () => {
+        (0, vitest_1.it)("logs with [ridgeline] prefix", () => {
+            const spy = vitest_1.vi.spyOn(console, "log").mockImplementation(() => { });
+            (0, logging_1.logInfo)("hello");
+            (0, vitest_1.expect)(spy).toHaveBeenCalledWith("[ridgeline] hello");
+            spy.mockRestore();
+        });
+    });
+    (0, vitest_1.describe)("logError", () => {
+        (0, vitest_1.it)("logs with [ridgeline] ERROR: prefix to stderr", () => {
+            const spy = vitest_1.vi.spyOn(console, "error").mockImplementation(() => { });
+            (0, logging_1.logError)("something broke");
+            (0, vitest_1.expect)(spy).toHaveBeenCalledWith("[ridgeline] ERROR: something broke");
+            spy.mockRestore();
+        });
+    });
+    (0, vitest_1.describe)("logPhase", () => {
+        (0, vitest_1.it)("logs with phase id in brackets", () => {
+            const spy = vitest_1.vi.spyOn(console, "log").mockImplementation(() => { });
+            (0, logging_1.logPhase)("01-scaffold", "Building...");
+            (0, vitest_1.expect)(spy).toHaveBeenCalledWith("[ridgeline] [01-scaffold] Building...");
+            spy.mockRestore();
+        });
+    });
+    (0, vitest_1.describe)("logTrajectory", () => {
+        (0, vitest_1.it)("appends JSON line to trajectory.jsonl", () => {
+            const dir = (0, setup_1.makeTempDir)();
+            const entry = (0, logging_1.makeTrajectoryEntry)("build_start", "01-scaffold", "Build started");
+            (0, logging_1.logTrajectory)(dir, entry);
+            const content = fs.readFileSync(path.join(dir, "trajectory.jsonl"), "utf-8");
+            const parsed = JSON.parse(content.trim());
+            (0, vitest_1.expect)(parsed.type).toBe("build_start");
+            (0, vitest_1.expect)(parsed.phaseId).toBe("01-scaffold");
+            (0, vitest_1.expect)(parsed.summary).toBe("Build started");
+            fs.rmSync(dir, { recursive: true, force: true });
+        });
+        (0, vitest_1.it)("appends multiple entries on separate lines", () => {
+            const dir = (0, setup_1.makeTempDir)();
+            (0, logging_1.logTrajectory)(dir, (0, logging_1.makeTrajectoryEntry)("build_start", "01-scaffold", "Start"));
+            (0, logging_1.logTrajectory)(dir, (0, logging_1.makeTrajectoryEntry)("build_complete", "01-scaffold", "Done"));
+            const lines = fs.readFileSync(path.join(dir, "trajectory.jsonl"), "utf-8")
+                .trim()
+                .split("\n");
+            (0, vitest_1.expect)(lines).toHaveLength(2);
+            (0, vitest_1.expect)(JSON.parse(lines[0]).type).toBe("build_start");
+            (0, vitest_1.expect)(JSON.parse(lines[1]).type).toBe("build_complete");
+            fs.rmSync(dir, { recursive: true, force: true });
+        });
+    });
+    (0, vitest_1.describe)("makeTrajectoryEntry", () => {
+        (0, vitest_1.it)("creates entry with required fields", () => {
+            const entry = (0, logging_1.makeTrajectoryEntry)("plan_start", null, "Planning started");
+            (0, vitest_1.expect)(entry.type).toBe("plan_start");
+            (0, vitest_1.expect)(entry.phaseId).toBeNull();
+            (0, vitest_1.expect)(entry.summary).toBe("Planning started");
+            (0, vitest_1.expect)(entry.duration).toBeNull();
+            (0, vitest_1.expect)(entry.tokens).toBeNull();
+            (0, vitest_1.expect)(entry.costUsd).toBeNull();
+            (0, vitest_1.expect)(entry.timestamp).toBeDefined();
+        });
+        (0, vitest_1.it)("includes optional metrics when provided", () => {
+            const entry = (0, logging_1.makeTrajectoryEntry)("build_complete", "01-scaffold", "Done", {
+                duration: 5000,
+                tokens: { input: 100, output: 200 },
+                costUsd: 0.05,
+            });
+            (0, vitest_1.expect)(entry.duration).toBe(5000);
+            (0, vitest_1.expect)(entry.tokens).toEqual({ input: 100, output: 200 });
+            (0, vitest_1.expect)(entry.costUsd).toBe(0.05);
+        });
+        (0, vitest_1.it)("generates valid ISO timestamp", () => {
+            const entry = (0, logging_1.makeTrajectoryEntry)("plan_start", null, "test");
+            (0, vitest_1.expect)(() => new Date(entry.timestamp)).not.toThrow();
+            (0, vitest_1.expect)(new Date(entry.timestamp).toISOString()).toBe(entry.timestamp);
+        });
+    });
+});
+//# sourceMappingURL=logging.test.js.map

package/dist/__tests__/logging.test.js.map

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