agent-bober 0.8.1 → 0.10.0

package/dist/state/architect-state.js

@@ -0,0 +1,96 @@
+import { readFile, writeFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { ensureDir } from "./helpers.js";
+const ARCHITECTURE_DIR = ".bober/architecture";
+function architectureDir(projectRoot) {
+    return join(projectRoot, ARCHITECTURE_DIR);
+}
+function architecturePath(projectRoot, id) {
+    const safeId = id.replace(/[^a-zA-Z0-9_-]/g, "_");
+    return join(architectureDir(projectRoot), `${safeId}-architecture.md`);
+}
+function adrPath(projectRoot, id, adrNumber) {
+    const safeId = id.replace(/[^a-zA-Z0-9_-]/g, "_");
+    return join(architectureDir(projectRoot), `${safeId}-adr-${adrNumber}.md`);
+}
+/**
+ * Save an architecture document to disk.
+ * Overwrites any existing document with the same id.
+ */
+export async function saveArchitecture(projectRoot, id, content) {
+    await ensureDir(architectureDir(projectRoot));
+    const filePath = architecturePath(projectRoot, id);
+    await writeFile(filePath, content, "utf-8");
+}
+/**
+ * Read an architecture document by id.
+ * Throws if not found.
+ */
+export async function readArchitecture(projectRoot, id) {
+    const filePath = architecturePath(projectRoot, id);
+    try {
+        return await readFile(filePath, "utf-8");
+    }
+    catch (err) {
+        throw new Error(`Architecture document "${id}" not found: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+    }
+}
+/**
+ * Save an individual ADR file for an architecture.
+ * ADRs are saved as separate files: <id>-adr-<N>.md
+ */
+export async function saveADR(projectRoot, id, adrNumber, content) {
+    await ensureDir(architectureDir(projectRoot));
+    const filePath = adrPath(projectRoot, id, adrNumber);
+    await writeFile(filePath, content, "utf-8");
+}
+/**
+ * Read all ADR files for an architecture, sorted by ADR number.
+ * Returns an empty array if none exist.
+ */
+export async function readADRs(projectRoot, id) {
+    const dir = architectureDir(projectRoot);
+    const safeId = id.replace(/[^a-zA-Z0-9_-]/g, "_");
+    const prefix = `${safeId}-adr-`;
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        // Directory doesn't exist yet
+        return [];
+    }
+    const adrFiles = entries
+        .filter((f) => f.startsWith(prefix) && f.endsWith(".md"))
+        .sort((a, b) => {
+        // Sort numerically by ADR number
+        const numA = parseInt(a.slice(prefix.length, -3), 10);
+        const numB = parseInt(b.slice(prefix.length, -3), 10);
+        return numA - numB;
+    });
+    const adrs = [];
+    for (const file of adrFiles) {
+        const content = await readFile(join(dir, file), "utf-8");
+        adrs.push(content);
+    }
+    return adrs;
+}
+/**
+ * List all saved architecture IDs, sorted by filename.
+ */
+export async function listArchitectures(projectRoot) {
+    const dir = architectureDir(projectRoot);
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        // Directory doesn't exist yet
+        return [];
+    }
+    return entries
+        .filter((f) => f.endsWith("-architecture.md"))
+        .sort()
+        .map((f) => f.slice(0, -"-architecture.md".length));
+}
+//# sourceMappingURL=architect-state.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * Save a design discussion document to disk as a markdown file.
+ * Overwrites any existing document with the same specId.
+ *
+ * The content should be a complete markdown document with sections:
+ * - Current State
+ * - Desired End State
+ * - Patterns to Follow
+ * - Resolved Design Decisions
+ * - Open Questions
+ */
+export declare function saveDesign(projectRoot: string, specId: string, content: string): Promise<void>;
+/**
+ * Read a design discussion document by specId.
+ * Returns the raw markdown content.
+ * Throws if not found.
+ */
+export declare function readDesign(projectRoot: string, specId: string): Promise<string>;
+//# sourceMappingURL=design-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"design-state.d.ts","sourceRoot":"","sources":["../../src/state/design-state.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAWjB"}

package/dist/state/design-state.js

@@ -0,0 +1,42 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { ensureDir } from "./helpers.js";
+const DESIGNS_DIR = ".bober/designs";
+function designsDir(projectRoot) {
+    return join(projectRoot, DESIGNS_DIR);
+}
+function designPath(projectRoot, specId) {
+    const safeId = specId.replace(/[^a-zA-Z0-9_-]/g, "_");
+    return join(designsDir(projectRoot), `${safeId}-design.md`);
+}
+/**
+ * Save a design discussion document to disk as a markdown file.
+ * Overwrites any existing document with the same specId.
+ *
+ * The content should be a complete markdown document with sections:
+ * - Current State
+ * - Desired End State
+ * - Patterns to Follow
+ * - Resolved Design Decisions
+ * - Open Questions
+ */
+export async function saveDesign(projectRoot, specId, content) {
+    await ensureDir(designsDir(projectRoot));
+    const filePath = designPath(projectRoot, specId);
+    await writeFile(filePath, content, "utf-8");
+}
+/**
+ * Read a design discussion document by specId.
+ * Returns the raw markdown content.
+ * Throws if not found.
+ */
+export async function readDesign(projectRoot, specId) {
+    const filePath = designPath(projectRoot, specId);
+    try {
+        return await readFile(filePath, "utf-8");
+    }
+    catch (err) {
+        throw new Error(`Design document for spec "${specId}" not found at ${filePath}: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+    }
+}
+//# sourceMappingURL=design-state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"design-state.js","sourceRoot":"","sources":["../../src/state/design-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,WAAW,GAAG,gBAAgB,CAAC;AAErC,SAAS,UAAU,CAAC,WAAmB;IACrC,OAAO,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,UAAU,CAAC,WAAmB,EAAE,MAAc;IACrD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,GAAG,MAAM,YAAY,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,WAAmB,EACnB,MAAc,EACd,OAAe;IAEf,MAAM,SAAS,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IAEzC,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,WAAmB,EACnB,MAAc;IAEd,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAEjD,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,6BAA6B,MAAM,kBAAkB,QAAQ,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EACpH,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/state/index.d.ts

@@ -1,8 +1,13 @@
 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";
+export { saveResearch, readResearch, listResearch, } from "./research-state.js";
+export { saveDesign, readDesign, } from "./design-state.js";
+export { saveOutline, readOutline, } from "./outline-state.js";
+export { saveArchitecture, readArchitecture, saveADR, readADRs, listArchitectures, } from "./architect-state.js";
 /**
- * Ensure the `.bober/` directory and all required subdirectories exist.
+ * Ensure the `.bober/` directory and all required subdirectories exist,
+ * including the `research/` subdirectory for research documents.
  */
 export declare function ensureBoberDir(projectRoot: string): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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;AAEtB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,UAAU,EACV,UAAU,GACX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,QAAQ,EACR,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAK9B;;;GAGG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOvE"}

package/dist/state/index.js

@@ -7,10 +7,15 @@ export {
 PhaseSchema, HistoryEntrySchema, 
 // Functions
 appendHistory, loadHistory, updateProgress, } from "./history.js";
+export { saveResearch, readResearch, listResearch, } from "./research-state.js";
+export { saveDesign, readDesign, } from "./design-state.js";
+export { saveOutline, readOutline, } from "./outline-state.js";
+export { saveArchitecture, readArchitecture, saveADR, readADRs, listArchitectures, } from "./architect-state.js";
 const BOBER_DIR = ".bober";
-const SUBDIRS = ["contracts", "specs"];
+const SUBDIRS = ["contracts", "specs", "research", "designs", "outlines", "architecture"];
 /**
- * Ensure the `.bober/` directory and all required subdirectories exist.
+ * Ensure the `.bober/` directory and all required subdirectories exist,
+ * including the `research/` subdirectory for research documents.
  */
 export async function ensureBoberDir(projectRoot) {
     const boberRoot = join(projectRoot, BOBER_DIR);

package/dist/state/index.js.map

@@ -1 +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"}
+{"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,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,UAAU,EACV,UAAU,GACX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,QAAQ,EACR,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,SAAS,GAAG,QAAQ,CAAC;AAC3B,MAAM,OAAO,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,CAAU,CAAC;AAEnG;;;GAGG;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/outline-state.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Save a structure outline document to disk as a markdown file.
+ * Overwrites any existing outline with the same specId.
+ *
+ * The content should be a complete markdown document with sections per phase:
+ * - Phase title
+ * - Key Changes (types, signatures, interfaces)
+ * - Files affected
+ * - Test Checkpoint (how to verify independently)
+ * - Depends On (prior phases)
+ */
+export declare function saveOutline(projectRoot: string, specId: string, content: string): Promise<void>;
+/**
+ * Read a structure outline document by specId.
+ * Returns the raw markdown content.
+ * Throws if not found.
+ */
+export declare function readOutline(projectRoot: string, specId: string): Promise<string>;
+//# sourceMappingURL=outline-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"outline-state.d.ts","sourceRoot":"","sources":["../../src/state/outline-state.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAWjB"}

package/dist/state/outline-state.js

@@ -0,0 +1,42 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { ensureDir } from "./helpers.js";
+const OUTLINES_DIR = ".bober/outlines";
+function outlinesDir(projectRoot) {
+    return join(projectRoot, OUTLINES_DIR);
+}
+function outlinePath(projectRoot, specId) {
+    const safeId = specId.replace(/[^a-zA-Z0-9_-]/g, "_");
+    return join(outlinesDir(projectRoot), `${safeId}-outline.md`);
+}
+/**
+ * Save a structure outline document to disk as a markdown file.
+ * Overwrites any existing outline with the same specId.
+ *
+ * The content should be a complete markdown document with sections per phase:
+ * - Phase title
+ * - Key Changes (types, signatures, interfaces)
+ * - Files affected
+ * - Test Checkpoint (how to verify independently)
+ * - Depends On (prior phases)
+ */
+export async function saveOutline(projectRoot, specId, content) {
+    await ensureDir(outlinesDir(projectRoot));
+    const filePath = outlinePath(projectRoot, specId);
+    await writeFile(filePath, content, "utf-8");
+}
+/**
+ * Read a structure outline document by specId.
+ * Returns the raw markdown content.
+ * Throws if not found.
+ */
+export async function readOutline(projectRoot, specId) {
+    const filePath = outlinePath(projectRoot, specId);
+    try {
+        return await readFile(filePath, "utf-8");
+    }
+    catch (err) {
+        throw new Error(`Structure outline for spec "${specId}" not found at ${filePath}: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+    }
+}
+//# sourceMappingURL=outline-state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"outline-state.js","sourceRoot":"","sources":["../../src/state/outline-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,YAAY,GAAG,iBAAiB,CAAC;AAEvC,SAAS,WAAW,CAAC,WAAmB;IACtC,OAAO,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,WAAW,CAAC,WAAmB,EAAE,MAAc;IACtD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,GAAG,MAAM,aAAa,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,WAAmB,EACnB,MAAc,EACd,OAAe;IAEf,MAAM,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC;IAE1C,MAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAClD,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,WAAmB,EACnB,MAAc;IAEd,MAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAElD,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,+BAA+B,MAAM,kBAAkB,QAAQ,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EACtH,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { ResearchDoc } from "../orchestrator/research-agent.js";
+/**
+ * Save a research document to disk as a markdown file.
+ * Overwrites any existing document with the same id.
+ */
+export declare function saveResearch(projectRoot: string, doc: ResearchDoc): Promise<void>;
+/**
+ * Read a research document by id.
+ * Throws if not found.
+ */
+export declare function readResearch(projectRoot: string, id: string): Promise<ResearchDoc>;
+/**
+ * List all saved research document IDs, sorted by filename.
+ */
+export declare function listResearch(projectRoot: string): Promise<string[]>;
+//# sourceMappingURL=research-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"research-state.d.ts","sourceRoot":"","sources":["../../src/state/research-state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAoB,MAAM,mCAAmC,CAAC;AAmIvF;;;GAGG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,WAAW,CAAC,CActB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAezE"}

package/dist/state/research-state.js

@@ -0,0 +1,161 @@
+import { readFile, writeFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { ensureDir } from "./helpers.js";
+const RESEARCH_DIR = ".bober/research";
+function researchDir(projectRoot) {
+    return join(projectRoot, RESEARCH_DIR);
+}
+function researchPath(projectRoot, id) {
+    const safeId = id.replace(/[^a-zA-Z0-9_-]/g, "_");
+    return join(researchDir(projectRoot), `${safeId}.md`);
+}
+/**
+ * Serialize a ResearchDoc to markdown format for storage.
+ */
+function serializeToMarkdown(doc) {
+    const questionsList = doc.questions
+        .map((q, i) => `${i + 1}. ${q}`)
+        .join("\n");
+    return `# Research Document
+
+**Research ID:** ${doc.id}
+**Generated:** ${doc.timestamp}
+**Questions Explored:** ${doc.questionsAnswered}/${doc.questions.length}
+**Files Explored:** ${doc.filesExplored.length}
+
+---
+
+## Architecture Overview
+
+${doc.sections.architectureOverview}
+
+## Existing Patterns
+
+${doc.sections.existingPatterns}
+
+## Key Files
+
+${doc.sections.keyFiles}
+
+## Integration Points
+
+${doc.sections.integrationPoints}
+
+## Test Coverage
+
+${doc.sections.testCoverage}
+
+## Risk Areas
+
+${doc.sections.riskAreas}
+
+---
+
+## Exploration Questions
+
+${questionsList}
+
+---
+
+## Files Explored
+
+${doc.filesExplored.map((f) => `- ${f}`).join("\n") || "None recorded."}
+
+---
+
+*Generated by bober.research — factual findings only, no implementation recommendations.*
+`;
+}
+/**
+ * Parse a markdown research document back into a ResearchDoc.
+ * Used by readResearch() to reconstruct the structured type.
+ */
+function parseMarkdown(content, id) {
+    const extractSection = (heading) => {
+        const pattern = new RegExp(`## ${heading}\\n\\n([\\s\\S]*?)(?=\\n## |\\n---\\n|$)`);
+        const match = pattern.exec(content);
+        return match ? match[1].trim() : "";
+    };
+    const sections = {
+        architectureOverview: extractSection("Architecture Overview"),
+        existingPatterns: extractSection("Existing Patterns"),
+        keyFiles: extractSection("Key Files"),
+        integrationPoints: extractSection("Integration Points"),
+        testCoverage: extractSection("Test Coverage"),
+        riskAreas: extractSection("Risk Areas"),
+    };
+    // Extract metadata from the header block
+    const generatedMatch = /\*\*Generated:\*\* (.+)/.exec(content);
+    const timestamp = generatedMatch ? generatedMatch[1].trim() : new Date().toISOString();
+    // Extract exploration questions
+    const questionsSection = extractSection("Exploration Questions");
+    const questions = questionsSection
+        .split("\n")
+        .filter((line) => /^\d+\.\s/.test(line))
+        .map((line) => line.replace(/^\d+\.\s+/, "").trim())
+        .filter(Boolean);
+    // Extract files explored
+    const filesSection = extractSection("Files Explored");
+    const filesExplored = filesSection
+        .split("\n")
+        .filter((line) => line.startsWith("- "))
+        .map((line) => line.slice(2).trim())
+        .filter(Boolean);
+    const questionsAnsweredMatch = /\*\*Questions Explored:\*\* (\d+)\//.exec(content);
+    const questionsAnswered = questionsAnsweredMatch
+        ? parseInt(questionsAnsweredMatch[1], 10)
+        : questions.length;
+    return {
+        id,
+        timestamp,
+        questions,
+        findings: content,
+        sections,
+        filesExplored,
+        questionsAnswered,
+    };
+}
+/**
+ * Save a research document to disk as a markdown file.
+ * Overwrites any existing document with the same id.
+ */
+export async function saveResearch(projectRoot, doc) {
+    await ensureDir(researchDir(projectRoot));
+    const filePath = researchPath(projectRoot, doc.id);
+    const markdown = serializeToMarkdown(doc);
+    await writeFile(filePath, markdown, "utf-8");
+}
+/**
+ * Read a research document by id.
+ * Throws if not found.
+ */
+export async function readResearch(projectRoot, id) {
+    const filePath = researchPath(projectRoot, id);
+    let content;
+    try {
+        content = await readFile(filePath, "utf-8");
+    }
+    catch (err) {
+        throw new Error(`Research document "${id}" not found: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+    }
+    return parseMarkdown(content, id);
+}
+/**
+ * List all saved research document IDs, sorted by filename.
+ */
+export async function listResearch(projectRoot) {
+    const dir = researchDir(projectRoot);
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        // Directory doesn't exist yet
+        return [];
+    }
+    return entries
+        .filter((f) => f.endsWith(".md"))
+        .sort()
+        .map((f) => f.slice(0, -3)); // strip .md extension
+}
+//# sourceMappingURL=research-state.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-bober",
-  "version": "0.8.1",
+  "version": "0.10.0",
   "description": "Generator-Evaluator multi-agent harness for building applications autonomously with any LLM. Supports Claude, GPT, Gemini, Ollama. Includes MCP server for Cursor/Windsurf.",
   "type": "module",
   "main": "dist/index.js",