ridgeline 0.1.5

package/dist/state/handoff.js

@@ -0,0 +1,54 @@
+"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 });
+exports.ensureHandoffExists = exports.readHandoff = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const readHandoff = (buildDir) => {
+    const fp = path.join(buildDir, "handoff.md");
+    if (fs.existsSync(fp)) {
+        return fs.readFileSync(fp, "utf-8");
+    }
+    return "";
+};
+exports.readHandoff = readHandoff;
+const ensureHandoffExists = (buildDir) => {
+    const fp = path.join(buildDir, "handoff.md");
+    if (!fs.existsSync(fp)) {
+        fs.writeFileSync(fp, "");
+    }
+};
+exports.ensureHandoffExists = ensureHandoffExists;
+//# sourceMappingURL=handoff.js.map

package/dist/state/handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.js","sourceRoot":"","sources":["../../src/state/handoff.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAA6B;AAC7B,gDAAiC;AAE1B,MAAM,WAAW,GAAG,CAAC,QAAgB,EAAU,EAAE;IACtD,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;IAC5C,IAAI,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IACrC,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC,CAAA;AANY,QAAA,WAAW,eAMvB;AAEM,MAAM,mBAAmB,GAAG,CAAC,QAAgB,EAAQ,EAAE;IAC5D,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;IAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;QACvB,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;IAC1B,CAAC;AACH,CAAC,CAAA;AALY,QAAA,mBAAmB,uBAK/B"}

package/dist/state/snapshot.d.ts

@@ -0,0 +1 @@
+export declare const generateSnapshot: (projectDir: string, buildDir: string) => string;

package/dist/state/snapshot.js

@@ -0,0 +1,154 @@
+"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 });
+exports.generateSnapshot = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const EXCLUDED_DIRS = new Set([
+    "node_modules", "dist", "build", ".git", ".next", "__pycache__",
+    ".venv", "venv", "target", "vendor", ".ridgeline",
+]);
+const MAX_DEPTH = 3;
+const walkDir = (dir, prefix, depth) => {
+    if (depth > MAX_DEPTH)
+        return [];
+    const lines = [];
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return lines;
+    }
+    entries.sort((a, b) => a.name.localeCompare(b.name));
+    for (const entry of entries) {
+        if (entry.name.startsWith(".") && depth === 0 && entry.name !== ".github")
+            continue;
+        if (EXCLUDED_DIRS.has(entry.name))
+            continue;
+        if (entry.isDirectory()) {
+            lines.push(`${prefix}${entry.name}/`);
+            lines.push(...walkDir(path.join(dir, entry.name), prefix + "  ", depth + 1));
+        }
+        else {
+            lines.push(`${prefix}${entry.name}`);
+        }
+    }
+    return lines;
+};
+const readFileSafe = (filepath, maxLines) => {
+    try {
+        const content = fs.readFileSync(filepath, "utf-8");
+        const lines = content.split("\n");
+        if (lines.length > maxLines) {
+            return lines.slice(0, maxLines).join("\n") + `\n... (${lines.length - maxLines} more lines)`;
+        }
+        return content;
+    }
+    catch {
+        return null;
+    }
+};
+const CONFIG_FILES = [
+    "package.json", "tsconfig.json", "Cargo.toml", "pyproject.toml", "go.mod",
+    ".eslintrc.json", ".eslintrc.js", "eslint.config.js", "eslint.config.mjs",
+    "vite.config.ts", "vite.config.js", "next.config.js", "next.config.mjs",
+    "webpack.config.js", "tailwind.config.js", "tailwind.config.ts",
+];
+const countSourceFiles = (dir) => {
+    const counts = new Map();
+    try {
+        const output = (0, node_child_process_1.execSync)("git ls-files --cached --others --exclude-standard", { cwd: dir, encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
+        for (const file of output.split("\n").filter(Boolean)) {
+            const dirName = path.dirname(file);
+            counts.set(dirName, (counts.get(dirName) ?? 0) + 1);
+        }
+    }
+    catch {
+        // Not a git repo or no files
+    }
+    return counts;
+};
+const generateSnapshot = (projectDir, buildDir) => {
+    const sections = [];
+    // Directory tree
+    sections.push("## Directory Tree\n");
+    sections.push("```");
+    sections.push(...walkDir(projectDir, "", 0));
+    sections.push("```\n");
+    // Config files
+    sections.push("## Config Files\n");
+    for (const configFile of CONFIG_FILES) {
+        const fp = path.join(projectDir, configFile);
+        const content = readFileSafe(fp, 50);
+        if (content) {
+            sections.push(`### ${configFile}\n`);
+            sections.push("```");
+            sections.push(content);
+            sections.push("```\n");
+        }
+    }
+    // Source file counts
+    const fileCounts = countSourceFiles(projectDir);
+    if (fileCounts.size > 0) {
+        sections.push("## Source Files by Directory\n");
+        const sorted = [...fileCounts.entries()].sort((a, b) => a[0].localeCompare(b[0]));
+        for (const [dir, count] of sorted) {
+            sections.push(`- ${dir}: ${count} files`);
+        }
+        sections.push("");
+    }
+    // Test structure
+    const testDirs = ["test", "tests", "__tests__", "spec", "src/__tests__"];
+    const foundTests = [];
+    for (const td of testDirs) {
+        const fp = path.join(projectDir, td);
+        if (fs.existsSync(fp) && fs.statSync(fp).isDirectory()) {
+            foundTests.push(td);
+        }
+    }
+    if (foundTests.length > 0) {
+        sections.push("## Test Structure\n");
+        sections.push(`Test directories: ${foundTests.join(", ")}`);
+        sections.push("");
+    }
+    const snapshot = sections.join("\n");
+    const snapshotPath = path.join(buildDir, "snapshot.md");
+    fs.writeFileSync(snapshotPath, snapshot);
+    return snapshot;
+};
+exports.generateSnapshot = generateSnapshot;
+//# sourceMappingURL=snapshot.js.map

package/dist/state/snapshot.js.map

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

package/dist/state/stateManager.d.ts

@@ -0,0 +1,6 @@
+import { BuildState, PhaseState, PhaseInfo } from "../types";
+export declare const loadState: (buildDir: string) => BuildState | null;
+export declare const saveState: (buildDir: string, state: BuildState) => void;
+export declare const initState: (buildName: string, phases: PhaseInfo[]) => BuildState;
+export declare const updatePhaseStatus: (buildDir: string, state: BuildState, phaseId: string, update: Partial<PhaseState>) => void;
+export declare const getNextIncompletePhase: (state: BuildState, cwd?: string) => PhaseState | null;

package/dist/state/stateManager.js

@@ -0,0 +1,94 @@
+"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 });
+exports.getNextIncompletePhase = exports.updatePhaseStatus = exports.initState = exports.saveState = exports.loadState = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const git_1 = require("../git");
+const statePath = (buildDir) => path.join(buildDir, "state.json");
+const loadState = (buildDir) => {
+    const fp = statePath(buildDir);
+    if (fs.existsSync(fp)) {
+        return JSON.parse(fs.readFileSync(fp, "utf-8"));
+    }
+    return null;
+};
+exports.loadState = loadState;
+const saveState = (buildDir, state) => {
+    fs.writeFileSync(statePath(buildDir), JSON.stringify(state, null, 2) + "\n");
+};
+exports.saveState = saveState;
+const initState = (buildName, phases) => ({
+    buildName,
+    startedAt: new Date().toISOString(),
+    phases: phases.map((p) => ({
+        id: p.id,
+        status: "pending",
+        checkpointTag: `ridgeline/checkpoint/${buildName}/${p.id}`,
+        completionTag: null,
+        retries: 0,
+        duration: null,
+        completedAt: null,
+        failedAt: null,
+    })),
+});
+exports.initState = initState;
+const updatePhaseStatus = (buildDir, state, phaseId, update) => {
+    const phase = state.phases.find((p) => p.id === phaseId);
+    if (phase) {
+        Object.assign(phase, update);
+        (0, exports.saveState)(buildDir, state);
+    }
+};
+exports.updatePhaseStatus = updatePhaseStatus;
+const getNextIncompletePhase = (state, cwd) => {
+    for (const phase of state.phases) {
+        if (phase.status === "complete") {
+            // Verify the completion tag still exists
+            const completionTag = `ridgeline/phase/${state.buildName}/${phase.id}`;
+            if (!(0, git_1.tagExists)(completionTag, cwd)) {
+                // Tag was deleted — treat as incomplete
+                phase.status = "pending";
+                phase.completionTag = null;
+                return phase;
+            }
+            continue;
+        }
+        return phase;
+    }
+    return null;
+};
+exports.getNextIncompletePhase = getNextIncompletePhase;
+//# sourceMappingURL=stateManager.js.map

package/dist/state/stateManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateManager.js","sourceRoot":"","sources":["../../src/state/stateManager.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAA6B;AAC7B,gDAAiC;AAEjC,gCAAkC;AAElC,MAAM,SAAS,GAAG,CAAC,QAAgB,EAAU,EAAE,CAC7C,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;AAE5B,MAAM,SAAS,GAAG,CAAC,QAAgB,EAAqB,EAAE;IAC/D,MAAM,EAAE,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;IAC9B,IAAI,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAA;IACjD,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AANY,QAAA,SAAS,aAMrB;AAEM,MAAM,SAAS,GAAG,CAAC,QAAgB,EAAE,KAAiB,EAAQ,EAAE;IACrE,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;AAC9E,CAAC,CAAA;AAFY,QAAA,SAAS,aAErB;AAEM,MAAM,SAAS,GAAG,CAAC,SAAiB,EAAE,MAAmB,EAAc,EAAE,CAAC,CAAC;IAChF,SAAS;IACT,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IACnC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzB,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,MAAM,EAAE,SAAS;QACjB,aAAa,EAAE,wBAAwB,SAAS,IAAI,CAAC,CAAC,EAAE,EAAE;QAC1D,aAAa,EAAE,IAAI;QACnB,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;CACJ,CAAC,CAAA;AAbW,QAAA,SAAS,aAapB;AAEK,MAAM,iBAAiB,GAAG,CAC/B,QAAgB,EAChB,KAAiB,EACjB,OAAe,EACf,MAA2B,EACrB,EAAE;IACR,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAA;IACxD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QAC5B,IAAA,iBAAS,EAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;IAC5B,CAAC;AACH,CAAC,CAAA;AAXY,QAAA,iBAAiB,qBAW7B;AAEM,MAAM,sBAAsB,GAAG,CACpC,KAAiB,EACjB,GAAY,EACO,EAAE;IACrB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAChC,yCAAyC;YACzC,MAAM,aAAa,GAAG,mBAAmB,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,EAAE,EAAE,CAAA;YACtE,IAAI,CAAC,IAAA,eAAS,EAAC,aAAa,EAAE,GAAG,CAAC,EAAE,CAAC;gBACnC,wCAAwC;gBACxC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAA;gBACxB,KAAK,CAAC,aAAa,GAAG,IAAI,CAAA;gBAC1B,OAAO,KAAK,CAAA;YACd,CAAC;YACD,SAAQ;QACV,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAnBY,QAAA,sBAAsB,0BAmBlC"}

package/dist/types.d.ts

@@ -0,0 +1,87 @@
+export type RidgelineConfig = {
+    buildName: string;
+    buildDir: string;
+    constraintsPath: string;
+    tastePath: string | null;
+    snapshotPath: string;
+    handoffPath: string;
+    phasesDir: string;
+    model: string;
+    maxRetries: number;
+    timeoutMinutes: number;
+    verbose: boolean;
+    checkCommand: string | null;
+    maxBudgetUsd: number | null;
+};
+export type PhaseInfo = {
+    id: string;
+    index: number;
+    slug: string;
+    filename: string;
+    filepath: string;
+};
+export type PhaseState = {
+    id: string;
+    status: "pending" | "building" | "reviewing" | "complete" | "failed";
+    checkpointTag: string;
+    completionTag: string | null;
+    retries: number;
+    duration: number | null;
+    completedAt: string | null;
+    failedAt: string | null;
+};
+export type BuildState = {
+    buildName: string;
+    startedAt: string;
+    phases: PhaseState[];
+};
+export type ClaudeResult = {
+    success: boolean;
+    result: string;
+    durationMs: number;
+    costUsd: number;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadInputTokens: number;
+        cacheCreationInputTokens: number;
+    };
+    sessionId: string;
+};
+export type ReviewVerdict = {
+    passed: boolean;
+    summary: string;
+    criteriaResults: {
+        criterion: number;
+        passed: boolean;
+        notes: string;
+    }[];
+    issues: string[];
+    suggestions: string[];
+};
+export type BudgetEntry = {
+    phase: string;
+    role: "planner" | "builder" | "reviewer";
+    attempt: number;
+    costUsd: number;
+    inputTokens: number;
+    outputTokens: number;
+    durationMs: number;
+    timestamp: string;
+};
+export type BudgetState = {
+    entries: BudgetEntry[];
+    totalCostUsd: number;
+};
+export type TrajectoryEntry = {
+    timestamp: string;
+    type: "plan_start" | "plan_complete" | "build_start" | "build_complete" | "review_start" | "review_complete" | "phase_advance" | "phase_fail" | "budget_exceeded";
+    phaseId: string | null;
+    duration: number | null;
+    tokens: {
+        input: number;
+        output: number;
+    } | null;
+    costUsd: number | null;
+    summary: string;
+};

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "ridgeline",
+  "version": "0.1.5",
+  "description": "Build harness for long-horizon software execution",
+  "license": "MIT",
+  "bin": {
+    "ridgeline": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc && cp -r src/agents dist/agents",
+    "dev": "tsc --watch",
+    "lint": "npm run lint:code && npm run lint:markdown && npm run lint:agents",
+    "lint:code": "oxlint",
+    "lint:markdown": "markdownlint-cli2 '**/*.md'",
+    "lint:agents": "agnix",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "commander": "13.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.0.0",
+    "agnix": "0.17.0",
+    "markdownlint-cli2": "0.22.0",
+    "oxlint": "1.58.0",
+    "typescript": "5.9.3",
+    "vitest": "4.1.2"
+  }
+}