agent-bober 0.1.0

package/dist/state/history.js

@@ -0,0 +1,162 @@
+import { readFile, writeFile, appendFile } from "node:fs/promises";
+import { join } from "node:path";
+import { z } from "zod";
+import { ensureDir } from "./helpers.js";
+// ── Constants ───────────────────────────────────────────────────────
+const BOBER_DIR = ".bober";
+const HISTORY_FILE = "history.jsonl";
+const PROGRESS_FILE = "progress.md";
+function historyPath(projectRoot) {
+    return join(projectRoot, BOBER_DIR, HISTORY_FILE);
+}
+function progressPath(projectRoot) {
+    return join(projectRoot, BOBER_DIR, PROGRESS_FILE);
+}
+// ── History Entry ───────────────────────────────────────────────────
+export const PhaseSchema = z.enum([
+    "init",
+    "planning",
+    "generating",
+    "evaluating",
+    "rework",
+    "complete",
+    "failed",
+]);
+export const HistoryEntrySchema = z.object({
+    timestamp: z.string().datetime(),
+    event: z.string().min(1),
+    phase: PhaseSchema,
+    sprintId: z.string().optional(),
+    details: z.record(z.string(), z.unknown()),
+});
+// ── History Operations ──────────────────────────────────────────────
+/**
+ * Append a history entry to the JSONL log file.
+ */
+export async function appendHistory(projectRoot, entry) {
+    const boberDir = join(projectRoot, BOBER_DIR);
+    await ensureDir(boberDir);
+    const validation = HistoryEntrySchema.safeParse(entry);
+    if (!validation.success) {
+        const issues = validation.error.issues
+            .map((i) => `  - ${i.path.join(".")}: ${i.message}`)
+            .join("\n");
+        throw new Error(`Invalid history entry:\n${issues}`);
+    }
+    const line = JSON.stringify(entry) + "\n";
+    await appendFile(historyPath(projectRoot), line, "utf-8");
+}
+/**
+ * Load all history entries from the JSONL log.
+ * Skips malformed lines.
+ */
+export async function loadHistory(projectRoot) {
+    let content;
+    try {
+        content = await readFile(historyPath(projectRoot), "utf-8");
+    }
+    catch {
+        // File doesn't exist yet
+        return [];
+    }
+    const lines = content.split("\n").filter((line) => line.trim().length > 0);
+    const entries = [];
+    for (const line of lines) {
+        try {
+            const parsed = JSON.parse(line);
+            const result = HistoryEntrySchema.safeParse(parsed);
+            if (result.success) {
+                entries.push(result.data);
+            }
+        }
+        catch {
+            // Skip malformed lines
+        }
+    }
+    return entries;
+}
+// ── Progress Markdown ───────────────────────────────────────────────
+/**
+ * Update the human-readable progress.md file with current state.
+ */
+export async function updateProgress(projectRoot, contracts, spec) {
+    const boberDir = join(projectRoot, BOBER_DIR);
+    await ensureDir(boberDir);
+    const lines = [];
+    lines.push("# Bober Progress");
+    lines.push("");
+    lines.push(`Last updated: ${new Date().toISOString()}`);
+    lines.push("");
+    // Plan summary
+    if (spec) {
+        lines.push("## Plan");
+        lines.push("");
+        lines.push(`**${spec.title}**`);
+        lines.push("");
+        lines.push(spec.description);
+        lines.push("");
+        lines.push(`- Features: ${spec.features.length}`);
+        lines.push(`- Tech stack: ${spec.techStack.join(", ") || "not specified"}`);
+        lines.push("");
+    }
+    // Sprint summary
+    lines.push("## Sprints");
+    lines.push("");
+    if (contracts.length === 0) {
+        lines.push("No sprints yet.");
+        lines.push("");
+    }
+    else {
+        const passed = contracts.filter((c) => c.status === "passed").length;
+        const failed = contracts.filter((c) => c.status === "failed").length;
+        const inProgress = contracts.filter((c) => c.status === "in-progress" || c.status === "evaluating").length;
+        const pending = contracts.filter((c) => c.status === "proposed" ||
+            c.status === "negotiating" ||
+            c.status === "agreed").length;
+        lines.push(`| Status | Count |`);
+        lines.push(`| --- | --- |`);
+        lines.push(`| Passed | ${passed} |`);
+        lines.push(`| Failed | ${failed} |`);
+        lines.push(`| In Progress | ${inProgress} |`);
+        lines.push(`| Pending | ${pending} |`);
+        lines.push(`| **Total** | **${contracts.length}** |`);
+        lines.push("");
+        // Individual sprint status
+        lines.push("### Sprint Details");
+        lines.push("");
+        for (const contract of contracts) {
+            const statusIcon = getStatusIcon(contract.status);
+            lines.push(`- ${statusIcon} **${contract.feature}** (${contract.id})`);
+            lines.push(`  - Status: ${contract.status}`);
+            const criteriaTotal = contract.successCriteria.length;
+            const criteriaPassed = contract.successCriteria.filter((c) => c.passed).length;
+            if (criteriaTotal > 0) {
+                lines.push(`  - Criteria: ${criteriaPassed}/${criteriaTotal} passed`);
+            }
+            if (contract.startedAt) {
+                lines.push(`  - Started: ${contract.startedAt}`);
+            }
+            if (contract.completedAt) {
+                lines.push(`  - Completed: ${contract.completedAt}`);
+            }
+        }
+        lines.push("");
+    }
+    await writeFile(progressPath(projectRoot), lines.join("\n"), "utf-8");
+}
+function getStatusIcon(status) {
+    switch (status) {
+        case "passed":
+            return "[PASS]";
+        case "failed":
+            return "[FAIL]";
+        case "in-progress":
+        case "evaluating":
+            return "[WIP]";
+        case "needs-rework":
+            return "[REWORK]";
+        default:
+            return "[PENDING]";
+    }
+}
+//# sourceMappingURL=history.js.map

package/dist/state/history.js.map

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

package/dist/state/index.d.ts

@@ -0,0 +1,8 @@
+export { saveContract, loadContract, listContracts, updateContract, } from "./sprint-state.js";
+export { saveSpec, loadSpec, loadLatestSpec, listSpecs, } from "./plan-state.js";
+export { PhaseSchema, HistoryEntrySchema, type Phase, type HistoryEntry, appendHistory, loadHistory, updateProgress, } from "./history.js";
+/**
+ * Ensure the `.bober/` directory and all required subdirectories exist.
+ */
+export declare function ensureBoberDir(projectRoot: string): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,SAAS,GACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAEL,WAAW,EACX,kBAAkB,EAElB,KAAK,KAAK,EACV,KAAK,YAAY,EAEjB,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,cAAc,CAAC;AAKtB;;GAEG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOvE"}

package/dist/state/index.js

@@ -0,0 +1,22 @@
+import { join } from "node:path";
+import { ensureDir } from "./helpers.js";
+export { saveContract, loadContract, listContracts, updateContract, } from "./sprint-state.js";
+export { saveSpec, loadSpec, loadLatestSpec, listSpecs, } from "./plan-state.js";
+export { 
+// Zod schemas
+PhaseSchema, HistoryEntrySchema, 
+// Functions
+appendHistory, loadHistory, updateProgress, } from "./history.js";
+const BOBER_DIR = ".bober";
+const SUBDIRS = ["contracts", "specs"];
+/**
+ * Ensure the `.bober/` directory and all required subdirectories exist.
+ */
+export async function ensureBoberDir(projectRoot) {
+    const boberRoot = join(projectRoot, BOBER_DIR);
+    await ensureDir(boberRoot);
+    for (const sub of SUBDIRS) {
+        await ensureDir(join(boberRoot, sub));
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,SAAS,GACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO;AACL,cAAc;AACd,WAAW,EACX,kBAAkB;AAIlB,YAAY;AACZ,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,MAAM,SAAS,GAAG,QAAQ,CAAC;AAC3B,MAAM,OAAO,GAAG,CAAC,WAAW,EAAE,OAAO,CAAU,CAAC;AAEhD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAAmB;IACtD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC/C,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IAE3B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;IACxC,CAAC;AACH,CAAC"}

package/dist/state/plan-state.d.ts

@@ -0,0 +1,21 @@
+import { type PlanSpec } from "../contracts/spec.js";
+/**
+ * Save a plan spec to disk.
+ * Overwrites any existing spec with the same id.
+ */
+export declare function saveSpec(projectRoot: string, spec: PlanSpec): Promise<void>;
+/**
+ * Load a plan spec by id.
+ * Throws if not found or invalid.
+ */
+export declare function loadSpec(projectRoot: string, id: string): Promise<PlanSpec>;
+/**
+ * Load the most recently created spec (by `createdAt` field).
+ * Returns null if no specs exist.
+ */
+export declare function loadLatestSpec(projectRoot: string): Promise<PlanSpec | null>;
+/**
+ * List all saved specs, sorted by filename.
+ */
+export declare function listSpecs(projectRoot: string): Promise<PlanSpec[]>;
+//# sourceMappingURL=plan-state.d.ts.map

package/dist/state/plan-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-state.d.ts","sourceRoot":"","sources":["../../src/state/plan-state.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAcrE;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,QAAQ,CAAC,CAgCnB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAc1B;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAgCrB"}

package/dist/state/plan-state.js

@@ -0,0 +1,108 @@
+import { readFile, writeFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { PlanSpecSchema } from "../contracts/spec.js";
+import { ensureDir } from "./helpers.js";
+const SPECS_DIR = ".bober/specs";
+function specsDir(projectRoot) {
+    return join(projectRoot, SPECS_DIR);
+}
+function specPath(projectRoot, id) {
+    const safeId = id.replace(/[^a-zA-Z0-9_-]/g, "_");
+    return join(specsDir(projectRoot), `${safeId}.json`);
+}
+/**
+ * Save a plan spec to disk.
+ * Overwrites any existing spec with the same id.
+ */
+export async function saveSpec(projectRoot, spec) {
+    await ensureDir(specsDir(projectRoot));
+    const validation = PlanSpecSchema.safeParse(spec);
+    if (!validation.success) {
+        const issues = validation.error.issues
+            .map((i) => `  - ${i.path.join(".")}: ${i.message}`)
+            .join("\n");
+        throw new Error(`Invalid spec:\n${issues}`);
+    }
+    const filePath = specPath(projectRoot, spec.id);
+    await writeFile(filePath, JSON.stringify(spec, null, 2), "utf-8");
+}
+/**
+ * Load a plan spec by id.
+ * Throws if not found or invalid.
+ */
+export async function loadSpec(projectRoot, id) {
+    const filePath = specPath(projectRoot, id);
+    let content;
+    try {
+        content = await readFile(filePath, "utf-8");
+    }
+    catch (err) {
+        throw new Error(`Spec "${id}" not found: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch (err) {
+        throw new Error(`Invalid JSON in spec file for "${id}": ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+    }
+    const result = PlanSpecSchema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `  - ${i.path.join(".")}: ${i.message}`)
+            .join("\n");
+        throw new Error(`Spec "${id}" failed validation:\n${issues}`);
+    }
+    return result.data;
+}
+/**
+ * Load the most recently created spec (by `createdAt` field).
+ * Returns null if no specs exist.
+ */
+export async function loadLatestSpec(projectRoot) {
+    const specs = await listSpecs(projectRoot);
+    if (specs.length === 0) {
+        return null;
+    }
+    // Sort by createdAt descending and return the newest
+    specs.sort((a, b) => {
+        const dateA = new Date(a.createdAt).getTime();
+        const dateB = new Date(b.createdAt).getTime();
+        return dateB - dateA;
+    });
+    return specs[0];
+}
+/**
+ * List all saved specs, sorted by filename.
+ */
+export async function listSpecs(projectRoot) {
+    const dir = specsDir(projectRoot);
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        // Directory doesn't exist yet
+        return [];
+    }
+    const jsonFiles = entries
+        .filter((f) => f.endsWith(".json"))
+        .sort();
+    const specs = [];
+    for (const file of jsonFiles) {
+        const filePath = join(dir, file);
+        try {
+            const content = await readFile(filePath, "utf-8");
+            const parsed = JSON.parse(content);
+            const result = PlanSpecSchema.safeParse(parsed);
+            if (result.success) {
+                specs.push(result.data);
+            }
+        }
+        catch {
+            // Skip malformed files
+        }
+    }
+    return specs;
+}
+//# sourceMappingURL=plan-state.js.map

package/dist/state/plan-state.js.map

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

package/dist/state/sprint-state.d.ts

@@ -0,0 +1,20 @@
+import { type SprintContract } from "../contracts/sprint-contract.js";
+/**
+ * Save a sprint contract to disk.
+ * Overwrites any existing contract with the same id.
+ */
+export declare function saveContract(projectRoot: string, contract: SprintContract): Promise<void>;
+/**
+ * Load a sprint contract by id.
+ * Throws if not found or invalid.
+ */
+export declare function loadContract(projectRoot: string, id: string): Promise<SprintContract>;
+/**
+ * List all saved contracts, sorted by filename.
+ */
+export declare function listContracts(projectRoot: string): Promise<SprintContract[]>;
+/**
+ * Update an existing contract (save with the same id).
+ */
+export declare function updateContract(projectRoot: string, contract: SprintContract): Promise<void>;
+//# sourceMappingURL=sprint-state.d.ts.map

package/dist/state/sprint-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprint-state.d.ts","sourceRoot":"","sources":["../../src/state/sprint-state.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,iCAAiC,CAAC;AAezC;;;GAGG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,cAAc,CAAC,CAgCzB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,EAAE,CAAC,CAgC3B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/state/sprint-state.js

@@ -0,0 +1,98 @@
+import { readFile, writeFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { SprintContractSchema, } from "../contracts/sprint-contract.js";
+import { ensureDir } from "./helpers.js";
+const CONTRACTS_DIR = ".bober/contracts";
+function contractsDir(projectRoot) {
+    return join(projectRoot, CONTRACTS_DIR);
+}
+function contractPath(projectRoot, id) {
+    // Sanitize the id to be a safe filename
+    const safeId = id.replace(/[^a-zA-Z0-9_-]/g, "_");
+    return join(contractsDir(projectRoot), `${safeId}.json`);
+}
+/**
+ * Save a sprint contract to disk.
+ * Overwrites any existing contract with the same id.
+ */
+export async function saveContract(projectRoot, contract) {
+    await ensureDir(contractsDir(projectRoot));
+    const validation = SprintContractSchema.safeParse(contract);
+    if (!validation.success) {
+        const issues = validation.error.issues
+            .map((i) => `  - ${i.path.join(".")}: ${i.message}`)
+            .join("\n");
+        throw new Error(`Invalid contract:\n${issues}`);
+    }
+    const filePath = contractPath(projectRoot, contract.id);
+    await writeFile(filePath, JSON.stringify(contract, null, 2), "utf-8");
+}
+/**
+ * Load a sprint contract by id.
+ * Throws if not found or invalid.
+ */
+export async function loadContract(projectRoot, id) {
+    const filePath = contractPath(projectRoot, id);
+    let content;
+    try {
+        content = await readFile(filePath, "utf-8");
+    }
+    catch (err) {
+        throw new Error(`Contract "${id}" not found: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch (err) {
+        throw new Error(`Invalid JSON in contract file for "${id}": ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+    }
+    const result = SprintContractSchema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `  - ${i.path.join(".")}: ${i.message}`)
+            .join("\n");
+        throw new Error(`Contract "${id}" failed validation:\n${issues}`);
+    }
+    return result.data;
+}
+/**
+ * List all saved contracts, sorted by filename.
+ */
+export async function listContracts(projectRoot) {
+    const dir = contractsDir(projectRoot);
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        // Directory doesn't exist yet — no contracts
+        return [];
+    }
+    const jsonFiles = entries
+        .filter((f) => f.endsWith(".json"))
+        .sort();
+    const contracts = [];
+    for (const file of jsonFiles) {
+        const filePath = join(dir, file);
+        try {
+            const content = await readFile(filePath, "utf-8");
+            const parsed = JSON.parse(content);
+            const result = SprintContractSchema.safeParse(parsed);
+            if (result.success) {
+                contracts.push(result.data);
+            }
+        }
+        catch {
+            // Skip malformed files
+        }
+    }
+    return contracts;
+}
+/**
+ * Update an existing contract (save with the same id).
+ */
+export async function updateContract(projectRoot, contract) {
+    await saveContract(projectRoot, contract);
+}
+//# sourceMappingURL=sprint-state.js.map

package/dist/state/sprint-state.js.map

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

package/dist/utils/fs.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Async check whether a file exists and is readable.
+ */
+export declare function fileExists(path: string): Promise<boolean>;
+/**
+ * Read a JSON file and parse it with an optional type parameter.
+ *
+ * Throws if the file does not exist or contains invalid JSON.
+ */
+export declare function readJson<T = unknown>(path: string): Promise<T>;
+/**
+ * Write data as pretty-printed JSON to the given path.
+ *
+ * Parent directories are created automatically.
+ */
+export declare function writeJson(path: string, data: unknown): Promise<void>;
+/**
+ * Create a directory (and any missing parents) if it does not already exist.
+ */
+export declare function ensureDir(path: string): Promise<void>;
+/**
+ * Walk up the directory tree from `startDir` looking for a project root.
+ *
+ * A directory is considered a project root if it contains
+ * `bober.config.json` or `package.json`.
+ *
+ * @param startDir Starting directory (defaults to `process.cwd()`).
+ * @returns Absolute path to the project root, or `null` if none found.
+ */
+export declare function findProjectRoot(startDir?: string): Promise<string | null>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/utils/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAGpE;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3D;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmBxB"}

package/dist/utils/fs.js

@@ -0,0 +1,67 @@
+import { access, readFile, writeFile, mkdir } from "node:fs/promises";
+import { constants } from "node:fs";
+import { join, dirname, resolve } from "node:path";
+// ── File-System Helpers ────────────────────────────────────────────
+/**
+ * Async check whether a file exists and is readable.
+ */
+export async function fileExists(path) {
+    try {
+        await access(path, constants.R_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read a JSON file and parse it with an optional type parameter.
+ *
+ * Throws if the file does not exist or contains invalid JSON.
+ */
+export async function readJson(path) {
+    const raw = await readFile(path, "utf-8");
+    return JSON.parse(raw);
+}
+/**
+ * Write data as pretty-printed JSON to the given path.
+ *
+ * Parent directories are created automatically.
+ */
+export async function writeJson(path, data) {
+    await ensureDir(dirname(path));
+    await writeFile(path, JSON.stringify(data, null, 2) + "\n", "utf-8");
+}
+/**
+ * Create a directory (and any missing parents) if it does not already exist.
+ */
+export async function ensureDir(path) {
+    await mkdir(path, { recursive: true });
+}
+/**
+ * Walk up the directory tree from `startDir` looking for a project root.
+ *
+ * A directory is considered a project root if it contains
+ * `bober.config.json` or `package.json`.
+ *
+ * @param startDir Starting directory (defaults to `process.cwd()`).
+ * @returns Absolute path to the project root, or `null` if none found.
+ */
+export async function findProjectRoot(startDir) {
+    let dir = resolve(startDir ?? process.cwd());
+    const markers = ["bober.config.json", "package.json"];
+    for (;;) {
+        for (const marker of markers) {
+            if (await fileExists(join(dir, marker))) {
+                return dir;
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            // Reached filesystem root without finding a marker.
+            return null;
+        }
+        dir = parent;
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEnD,sEAAsE;AAEtE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAc,IAAY;IACtD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAY,EACZ,IAAa;IAEb,MAAM,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/B,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAiB;IAEjB,IAAI,GAAG,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAE7C,MAAM,OAAO,GAAG,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAC;IAEtD,SAAS,CAAC;QACR,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;gBACxC,OAAO,GAAG,CAAC;YACb,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,oDAAoD;YACpD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/utils/git.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Get the name of the currently checked-out branch.
+ */
+export declare function getCurrentBranch(cwd: string): Promise<string>;
+/**
+ * Create a new branch and check it out.
+ */
+export declare function createBranch(cwd: string, name: string): Promise<void>;
+/**
+ * Stage all changes and create a commit.
+ *
+ * @returns The short hash of the new commit.
+ */
+export declare function commitAll(cwd: string, message: string): Promise<string>;
+/**
+ * Get a list of files changed since a given ref (defaults to HEAD).
+ *
+ * Returns relative paths as reported by git.
+ */
+export declare function getChangedFiles(cwd: string, since?: string): Promise<string[]>;
+/**
+ * Get the unified diff since a given ref (defaults to HEAD).
+ */
+export declare function getDiff(cwd: string, since?: string): Promise<string>;
+/**
+ * Check whether the working tree has uncommitted changes (staged or unstaged).
+ */
+export declare function hasUncommittedChanges(cwd: string): Promise<boolean>;
+/**
+ * Stash any current changes, run the provided function, then restore.
+ *
+ * If the stash is empty (nothing to save) the restore step is skipped.
+ */
+export declare function stashAndRestore<T>(cwd: string, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=git.d.ts.map

package/dist/utils/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKnE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAWnB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMzE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAcZ"}