@braidhq/server 0.0.1

package/dist/infrastructure/fs/FsStatusedJsonRepository.js

@@ -0,0 +1,79 @@
+import { rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { NotFoundError } from '@braidhq/core';
+import { listJsonFiles, moveFile, readJsonFile, writeJsonFile } from './jsonFileStore.js';
+export class FsStatusedJsonRepository {
+    config;
+    workspaceRoots;
+    constructor(config, workspaceRoots) {
+        this.config = config;
+        this.workspaceRoots = workspaceRoots;
+    }
+    async list(filter) {
+        const roots = await this.candidateRoots(filter?.workspaceId);
+        const statuses = filter?.statuses?.length ? filter.statuses : this.config.statuses;
+        const entities = [];
+        for (const root of roots.values()) {
+            for (const status of statuses) {
+                const files = await listJsonFiles(this.config.dirFor(root, status));
+                for (const file of files) {
+                    const data = await readJsonFile(file);
+                    entities.push(this.config.parse(data));
+                }
+            }
+        }
+        return entities;
+    }
+    async load(id) {
+        const found = await this.locate(id);
+        if (!found)
+            throw new NotFoundError(`${this.config.entityName} "${id}" not found`);
+        const data = await readJsonFile(found.path);
+        return this.config.parse(data);
+    }
+    async save(entity) {
+        const roots = await this.workspaceRoots();
+        const workspaceId = this.config.workspaceIdOf(entity);
+        const root = roots.get(workspaceId);
+        if (!root)
+            throw new NotFoundError(`Workspace "${workspaceId}" not registered`);
+        const id = this.config.idOf(entity);
+        const status = this.config.statusOf(entity);
+        const targetPath = join(this.config.dirFor(root, status), `${id}.json`);
+        const existing = await this.locate(id);
+        if (existing && existing.path !== targetPath)
+            await moveFile(existing.path, targetPath);
+        await writeJsonFile(targetPath, this.config.serialize(entity));
+    }
+    async remove(id) {
+        const found = await this.locate(id);
+        if (!found)
+            throw new NotFoundError(`${this.config.entityName} "${id}" not found`);
+        await rm(found.path);
+    }
+    async locate(id) {
+        const roots = await this.workspaceRoots();
+        for (const root of roots.values()) {
+            for (const status of this.config.statuses) {
+                const candidatePath = join(this.config.dirFor(root, status), `${id}.json`);
+                try {
+                    await readJsonFile(candidatePath);
+                    return { path: candidatePath, status };
+                }
+                catch (error) {
+                    if (error.code !== 'ENOENT')
+                        throw error;
+                }
+            }
+        }
+        return undefined;
+    }
+    async candidateRoots(workspaceId) {
+        const roots = await this.workspaceRoots();
+        if (!workspaceId)
+            return roots;
+        const root = roots.get(workspaceId);
+        return root ? new Map([[workspaceId, root]]) : new Map();
+    }
+}
+//# sourceMappingURL=FsStatusedJsonRepository.js.map

package/dist/infrastructure/fs/FsStatusedJsonRepository.js.map

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

package/dist/infrastructure/fs/FsWorkspaceRepository.d.ts

@@ -0,0 +1,21 @@
+import type { WorkspaceRegistryFile } from './WorkspaceRegistryFile.js';
+import { Workspace, type WorkspaceRepository } from '@braidhq/core';
+import { AbsolutePath } from '@braidhq/schema';
+export interface FsWorkspaceRepositoryDeps {
+    readonly registry: WorkspaceRegistryFile;
+}
+export declare class FsWorkspaceRepository implements WorkspaceRepository {
+    private readonly deps;
+    private readonly cache;
+    constructor(deps: FsWorkspaceRepositoryDeps);
+    list(): Promise<Workspace[]>;
+    load(rootPath: AbsolutePath): Promise<Workspace>;
+    save(workspace: Workspace): Promise<void>;
+    remove(rootPath: AbsolutePath): Promise<void>;
+    invalidate(rootPath: AbsolutePath): void;
+    private readFromDisk;
+    private assertDirectoryExists;
+    private readManifest;
+    private parseManifest;
+}
+//# sourceMappingURL=FsWorkspaceRepository.d.ts.map

package/dist/infrastructure/fs/FsWorkspaceRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FsWorkspaceRepository.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/fs/FsWorkspaceRepository.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAGvE,OAAO,EAAkC,SAAS,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnG,OAAO,EAAE,YAAY,EAAgC,MAAM,iBAAiB,CAAA;AAI5E,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAA;CACzC;AAED,qBAAa,qBAAsB,YAAW,mBAAmB;IAGnD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;gBAE9B,IAAI,EAAE,yBAAyB;IAEtD,IAAI,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAS5B,IAAI,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC;IAShD,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzC,MAAM,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD,UAAU,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;YAI1B,YAAY;YAeZ,qBAAqB;YAerB,YAAY;IAY1B,OAAO,CAAC,aAAa;CAOtB"}

package/dist/infrastructure/fs/FsWorkspaceRepository.js

@@ -0,0 +1,87 @@
+import { readFile, stat } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { NotFoundError, ValidationError, Workspace } from '@braidhq/core';
+import { AbsolutePath, ProductManifest, WorkspaceId } from '@braidhq/schema';
+import { parseMarkdownFrontmatter } from './frontmatter.js';
+import { workspaceProductManifestPath } from './paths.js';
+export class FsWorkspaceRepository {
+    deps;
+    cache = new Map();
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async list() {
+        const rootPaths = await this.deps.registry.list();
+        const workspaces = [];
+        for (const rootPath of rootPaths) {
+            workspaces.push(await this.load(rootPath));
+        }
+        return workspaces;
+    }
+    async load(rootPath) {
+        const cached = this.cache.get(rootPath);
+        if (cached)
+            return cached;
+        const workspace = await this.readFromDisk(rootPath);
+        this.cache.set(rootPath, workspace);
+        return workspace;
+    }
+    async save(workspace) {
+        await this.deps.registry.add(workspace.rootPath);
+        this.cache.set(workspace.rootPath, workspace);
+    }
+    async remove(rootPath) {
+        await this.deps.registry.remove(rootPath);
+        this.cache.delete(rootPath);
+    }
+    invalidate(rootPath) {
+        this.cache.delete(rootPath);
+    }
+    async readFromDisk(rootPath) {
+        await this.assertDirectoryExists(rootPath);
+        const manifestPath = workspaceProductManifestPath(rootPath);
+        const raw = await this.readManifest(manifestPath);
+        const { frontmatter } = parseMarkdownFrontmatter(raw);
+        const productManifest = this.parseManifest(frontmatter, manifestPath);
+        const data = {
+            id: WorkspaceId.parse(productManifest.name),
+            rootPath: AbsolutePath.parse(resolve(rootPath)),
+            productManifest,
+            pluginConfig: { plugins: [] },
+        };
+        return new Workspace(data);
+    }
+    async assertDirectoryExists(rootPath) {
+        try {
+            const stats = await stat(rootPath);
+            if (!stats.isDirectory()) {
+                throw new ValidationError(`Workspace path "${rootPath}" is not a directory`);
+            }
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new NotFoundError(`Workspace directory "${rootPath}" not found`);
+            }
+            throw error;
+        }
+    }
+    async readManifest(manifestPath) {
+        try {
+            return await readFile(manifestPath, 'utf-8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new NotFoundError(`PRODUCT.md not found at "${manifestPath}"`);
+            }
+            throw error;
+        }
+    }
+    parseManifest(raw, manifestPath) {
+        const parsed = ProductManifest.safeParse(raw);
+        if (!parsed.success) {
+            throw new ValidationError(`Invalid PRODUCT.md at "${manifestPath}": ${parsed.error.message}`);
+        }
+        return parsed.data;
+    }
+}
+//# sourceMappingURL=FsWorkspaceRepository.js.map

package/dist/infrastructure/fs/FsWorkspaceRepository.js.map

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

package/dist/infrastructure/fs/WorkspaceRegistryFile.d.ts

@@ -0,0 +1,17 @@
+import type { AbsolutePath } from '@braidhq/schema';
+/**
+ * Persists the list of registered workspace rootPaths to a JSON file.
+ * Default location is `${BRAID_HOME}/workspaces.json` (set by the caller).
+ * Acts as the source of truth across server restarts — the in-memory
+ * `FsWorkspaceRepository` cache is rebuilt from this file on cold start.
+ */
+export declare class WorkspaceRegistryFile {
+    private readonly filePath;
+    constructor(filePath: string);
+    list(): Promise<AbsolutePath[]>;
+    add(rootPath: AbsolutePath): Promise<void>;
+    remove(rootPath: AbsolutePath): Promise<void>;
+    private read;
+    private write;
+}
+//# sourceMappingURL=WorkspaceRegistryFile.d.ts.map

package/dist/infrastructure/fs/WorkspaceRegistryFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceRegistryFile.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/fs/WorkspaceRegistryFile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAanD;;;;;GAKG;AACH,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAEvC,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAK/B,GAAG,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1C,MAAM,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;YAQrC,IAAI;YAgBJ,KAAK;CAIpB"}

package/dist/infrastructure/fs/WorkspaceRegistryFile.js

@@ -0,0 +1,58 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { ValidationError } from '@braidhq/core';
+import { AbsolutePath as AbsolutePathSchema } from '@braidhq/schema';
+import { z } from 'zod';
+const RegistryContent = z.object({
+    workspaces: z.array(z.object({ rootPath: AbsolutePathSchema })).default([]),
+});
+/**
+ * Persists the list of registered workspace rootPaths to a JSON file.
+ * Default location is `${BRAID_HOME}/workspaces.json` (set by the caller).
+ * Acts as the source of truth across server restarts — the in-memory
+ * `FsWorkspaceRepository` cache is rebuilt from this file on cold start.
+ */
+export class WorkspaceRegistryFile {
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    async list() {
+        const content = await this.read();
+        return content.workspaces.map(entry => entry.rootPath);
+    }
+    async add(rootPath) {
+        const content = await this.read();
+        if (content.workspaces.some(entry => entry.rootPath === rootPath))
+            return;
+        content.workspaces.push({ rootPath });
+        await this.write(content);
+    }
+    async remove(rootPath) {
+        const content = await this.read();
+        const filtered = content.workspaces.filter(entry => entry.rootPath !== rootPath);
+        if (filtered.length === content.workspaces.length)
+            return;
+        await this.write({ workspaces: filtered });
+    }
+    async read() {
+        try {
+            const raw = await readFile(this.filePath, 'utf-8');
+            const parsed = RegistryContent.safeParse(JSON.parse(raw));
+            if (!parsed.success) {
+                throw new ValidationError(`Invalid workspace registry at "${this.filePath}": ${parsed.error.message}`);
+            }
+            return parsed.data;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return { workspaces: [] };
+            throw error;
+        }
+    }
+    async write(content) {
+        await mkdir(dirname(this.filePath), { recursive: true });
+        await writeFile(this.filePath, `${JSON.stringify(content, null, 2)}\n`, 'utf-8');
+    }
+}
+//# sourceMappingURL=WorkspaceRegistryFile.js.map

package/dist/infrastructure/fs/WorkspaceRegistryFile.js.map

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

package/dist/infrastructure/fs/frontmatter.d.ts

@@ -0,0 +1,13 @@
+export interface MarkdownDocument<T> {
+    readonly frontmatter: T;
+    readonly body: string;
+}
+/**
+ * Splits a markdown file into YAML frontmatter + body. Wraps the YAML
+ * between `---` delimiters on their own lines at the top of the file.
+ * Keys are normalised from kebab-case (YAML convention, used by Claude
+ * Code itself) to camelCase (TS convention) recursively so Zod schemas
+ * can declare fields naturally in TS.
+ */
+export declare function parseMarkdownFrontmatter<T>(content: string): MarkdownDocument<T>;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/infrastructure/fs/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/fs/frontmatter.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAmBhF"}

package/dist/infrastructure/fs/frontmatter.js

@@ -0,0 +1,46 @@
+import { parse as parseYaml } from 'yaml';
+const FRONTMATTER_DELIMITER = '---';
+/**
+ * Splits a markdown file into YAML frontmatter + body. Wraps the YAML
+ * between `---` delimiters on their own lines at the top of the file.
+ * Keys are normalised from kebab-case (YAML convention, used by Claude
+ * Code itself) to camelCase (TS convention) recursively so Zod schemas
+ * can declare fields naturally in TS.
+ */
+export function parseMarkdownFrontmatter(content) {
+    const lines = content.split('\n');
+    if (lines[0]?.trim() !== FRONTMATTER_DELIMITER) {
+        throw new Error('Frontmatter must start with "---" on the first line');
+    }
+    let closingIndex = -1;
+    for (let index = 1; index < lines.length; index += 1) {
+        if (lines[index]?.trim() === FRONTMATTER_DELIMITER) {
+            closingIndex = index;
+            break;
+        }
+    }
+    if (closingIndex === -1) {
+        throw new Error('Unterminated YAML frontmatter (missing closing "---")');
+    }
+    const yamlSource = lines.slice(1, closingIndex).join('\n');
+    const body = lines.slice(closingIndex + 1).join('\n');
+    const raw = parseYaml(yamlSource);
+    return { frontmatter: normaliseKeys(raw), body };
+}
+function kebabToCamelCase(key) {
+    return key.replace(/-([a-z])/g, (_, char) => char.toUpperCase());
+}
+function normaliseKeys(value) {
+    if (Array.isArray(value)) {
+        return value.map(normaliseKeys);
+    }
+    if (value !== null && typeof value === 'object') {
+        const result = {};
+        for (const [key, nested] of Object.entries(value)) {
+            result[kebabToCamelCase(key)] = normaliseKeys(nested);
+        }
+        return result;
+    }
+    return value;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/infrastructure/fs/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../../src/infrastructure/fs/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAA;AAEzC,MAAM,qBAAqB,GAAG,KAAK,CAAA;AAOnC;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAI,OAAe;IACzD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACjC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,qBAAqB,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAA;IACxE,CAAC;IACD,IAAI,YAAY,GAAG,CAAC,CAAC,CAAA;IACrB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,qBAAqB,EAAE,CAAC;YACnD,YAAY,GAAG,KAAK,CAAA;YACpB,MAAK;QACP,CAAC;IACH,CAAC;IACD,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAA;IAC1E,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrD,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,CAAY,CAAA;IAC5C,OAAO,EAAE,WAAW,EAAE,aAAa,CAAC,GAAG,CAAM,EAAE,IAAI,EAAE,CAAA;AACvD,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW;IACnC,OAAO,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;AAC1E,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACjC,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,MAAM,GAA4B,EAAE,CAAA;QAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;QACvD,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/infrastructure/fs/jsonFileStore.d.ts

@@ -0,0 +1,5 @@
+export declare function readJsonFile<T>(filePath: string): Promise<T>;
+export declare function writeJsonFile<T>(filePath: string, content: T): Promise<void>;
+export declare function moveFile(fromPath: string, toPath: string): Promise<void>;
+export declare function listJsonFiles(directory: string): Promise<string[]>;
+//# sourceMappingURL=jsonFileStore.d.ts.map

package/dist/infrastructure/fs/jsonFileStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonFileStore.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/fs/jsonFileStore.ts"],"names":[],"mappings":"AAGA,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAGlE;AAED,wBAAsB,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlF;AAED,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG9E;AAED,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAaxE"}

package/dist/infrastructure/fs/jsonFileStore.js

@@ -0,0 +1,29 @@
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+export async function readJsonFile(filePath) {
+    const raw = await readFile(filePath, 'utf-8');
+    return JSON.parse(raw);
+}
+export async function writeJsonFile(filePath, content) {
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeFile(filePath, `${JSON.stringify(content, null, 2)}\n`, 'utf-8');
+}
+export async function moveFile(fromPath, toPath) {
+    await mkdir(dirname(toPath), { recursive: true });
+    await rename(fromPath, toPath);
+}
+export async function listJsonFiles(directory) {
+    const { readdir } = await import('node:fs/promises');
+    try {
+        const entries = await readdir(directory, { withFileTypes: true });
+        return entries
+            .filter(entry => entry.isFile() && entry.name.endsWith('.json'))
+            .map(entry => join(directory, entry.name));
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return [];
+        throw error;
+    }
+}
+//# sourceMappingURL=jsonFileStore.js.map

package/dist/infrastructure/fs/jsonFileStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonFileStore.js","sourceRoot":"","sources":["../../../src/infrastructure/fs/jsonFileStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEzC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,QAAgB;IACpD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAA;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAI,QAAgB,EAAE,OAAU;IACjE,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACnD,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AAC7E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB,EAAE,MAAc;IAC7D,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACjD,MAAM,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAAiB;IACnD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;IACpD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;QACjE,OAAO,OAAO;aACX,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;aAC/D,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IAC9C,CAAC;IACD,OAAO,KAAK,EAAE,CAAC;QACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YACpD,OAAO,EAAE,CAAA;QACX,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/infrastructure/fs/paths.d.ts

@@ -0,0 +1,22 @@
+import type { AbsolutePath, ClarifyStatus, ProposalStatus, WorkspaceId } from '@braidhq/schema';
+export declare const PROPOSAL_STATUSES: readonly ProposalStatus[];
+export declare const CLARIFY_STATUSES: readonly ClarifyStatus[];
+export declare function workspaceArtifactsDir(workspaceRoot: AbsolutePath): string;
+export declare function proposalsDir(workspaceRoot: AbsolutePath, status: ProposalStatus): string;
+export declare function clarifyDir(workspaceRoot: AbsolutePath, status: ClarifyStatus): string;
+export declare function decisionsDir(workspaceRoot: AbsolutePath): string;
+export declare function viewsDir(workspaceRoot: AbsolutePath, kind: string): string;
+export declare function runsDir(workspaceRoot: AbsolutePath): string;
+export declare function runIndexPath(workspaceRoot: AbsolutePath): string;
+export declare function runEventsPath(workspaceRoot: AbsolutePath, runId: string): string;
+export declare function sessionsDir(workspaceRoot: AbsolutePath): string;
+export declare function sessionDirPath(workspaceRoot: AbsolutePath, runId: string): string;
+export declare function workspaceSkillsDir(workspaceRoot: AbsolutePath): string;
+export declare function workspaceSkillExtensionsDir(workspaceRoot: AbsolutePath): string;
+export declare function workspaceProductManifestPath(workspaceRoot: AbsolutePath): string;
+export interface WorkspaceLayout {
+    readonly root: AbsolutePath;
+    readonly workspaceId: WorkspaceId;
+    readonly manifestPath: string;
+}
+//# sourceMappingURL=paths.d.ts.map

package/dist/infrastructure/fs/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/fs/paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAG/F,eAAO,MAAM,iBAAiB,EAAE,SAAS,cAAc,EAAuC,CAAA;AAC9F,eAAO,MAAM,gBAAgB,EAAE,SAAS,aAAa,EAAkD,CAAA;AAEvG,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,YAAY,GAAG,MAAM,CAEzE;AAED,wBAAgB,YAAY,CAAC,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,CAExF;AAED,wBAAgB,UAAU,CAAC,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAErF;AAED,wBAAgB,YAAY,CAAC,aAAa,EAAE,YAAY,GAAG,MAAM,CAEhE;AAED,wBAAgB,QAAQ,CAAC,aAAa,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,wBAAgB,OAAO,CAAC,aAAa,EAAE,YAAY,GAAG,MAAM,CAE3D;AAED,wBAAgB,YAAY,CAAC,aAAa,EAAE,YAAY,GAAG,MAAM,CAEhE;AAED,wBAAgB,aAAa,CAAC,aAAa,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhF;AAKD,wBAAgB,WAAW,CAAC,aAAa,EAAE,YAAY,GAAG,MAAM,CAE/D;AAED,wBAAgB,cAAc,CAAC,aAAa,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,YAAY,GAAG,MAAM,CAEtE;AAED,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,YAAY,GAAG,MAAM,CAE/E;AAED,wBAAgB,4BAA4B,CAAC,aAAa,EAAE,YAAY,GAAG,MAAM,CAEhF;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B"}

package/dist/infrastructure/fs/paths.js

@@ -0,0 +1,46 @@
+import { join } from 'node:path';
+export const PROPOSAL_STATUSES = ['pending', 'applied', 'rejected'];
+export const CLARIFY_STATUSES = ['pending', 'answered', 'applied', 'skipped'];
+export function workspaceArtifactsDir(workspaceRoot) {
+    return join(workspaceRoot, 'artifacts');
+}
+export function proposalsDir(workspaceRoot, status) {
+    return join(workspaceArtifactsDir(workspaceRoot), 'proposals', status);
+}
+export function clarifyDir(workspaceRoot, status) {
+    return join(workspaceArtifactsDir(workspaceRoot), 'clarify', status);
+}
+export function decisionsDir(workspaceRoot) {
+    return join(workspaceArtifactsDir(workspaceRoot), 'decisions');
+}
+export function viewsDir(workspaceRoot, kind) {
+    return join(workspaceArtifactsDir(workspaceRoot), 'views', kind);
+}
+export function runsDir(workspaceRoot) {
+    return join(workspaceArtifactsDir(workspaceRoot), 'runs');
+}
+export function runIndexPath(workspaceRoot) {
+    return join(runsDir(workspaceRoot), 'index.jsonl');
+}
+export function runEventsPath(workspaceRoot, runId) {
+    return join(runsDir(workspaceRoot), `${runId}.jsonl`);
+}
+// claude stores conversation memory keyed by cwd, so resume must spawn from
+// the same dir as the first turn. Putting it inside the workspace (not /tmp)
+// keeps the path derivable from runId and lets it survive a server restart.
+export function sessionsDir(workspaceRoot) {
+    return join(workspaceRoot, '.braid-sessions');
+}
+export function sessionDirPath(workspaceRoot, runId) {
+    return join(sessionsDir(workspaceRoot), runId);
+}
+export function workspaceSkillsDir(workspaceRoot) {
+    return join(workspaceRoot, 'skills');
+}
+export function workspaceSkillExtensionsDir(workspaceRoot) {
+    return join(workspaceRoot, 'skill-extensions');
+}
+export function workspaceProductManifestPath(workspaceRoot) {
+    return join(workspaceRoot, 'PRODUCT.md');
+}
+//# sourceMappingURL=paths.js.map

package/dist/infrastructure/fs/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/infrastructure/fs/paths.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,MAAM,CAAC,MAAM,iBAAiB,GAA8B,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;AAC9F,MAAM,CAAC,MAAM,gBAAgB,GAA6B,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAA;AAEvG,MAAM,UAAU,qBAAqB,CAAC,aAA2B;IAC/D,OAAO,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,aAA2B,EAAE,MAAsB;IAC9E,OAAO,IAAI,CAAC,qBAAqB,CAAC,aAAa,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,CAAA;AACxE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,aAA2B,EAAE,MAAqB;IAC3E,OAAO,IAAI,CAAC,qBAAqB,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,CAAA;AACtE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,aAA2B;IACtD,OAAO,IAAI,CAAC,qBAAqB,CAAC,aAAa,CAAC,EAAE,WAAW,CAAC,CAAA;AAChE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,aAA2B,EAAE,IAAY;IAChE,OAAO,IAAI,CAAC,qBAAqB,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;AAClE,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,aAA2B;IACjD,OAAO,IAAI,CAAC,qBAAqB,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,CAAA;AAC3D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,aAA2B;IACtD,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC,CAAA;AACpD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,aAA2B,EAAE,KAAa;IACtE,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,GAAG,KAAK,QAAQ,CAAC,CAAA;AACvD,CAAC;AAED,4EAA4E;AAC5E,6EAA6E;AAC7E,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,aAA2B;IACrD,OAAO,IAAI,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAA;AAC/C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,aAA2B,EAAE,KAAa;IACvE,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC,CAAA;AAChD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,aAA2B;IAC5D,OAAO,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAA;AACtC,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,aAA2B;IACrE,OAAO,IAAI,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAA;AAChD,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,aAA2B;IACtE,OAAO,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAA;AAC1C,CAAC"}

package/dist/infrastructure/fs/productManifestWriter.d.ts

@@ -0,0 +1,22 @@
+import type { ProductManifest, ProductManifestDraft } from '@braidhq/schema';
+/**
+ * Take a user-provided `ProductManifestDraft` and fill in the structural
+ * blocks (agent / storage / channels) so the result is a valid, complete
+ * `ProductManifest` Zod will accept. Throws if the user's input itself is
+ * inconsistent.
+ */
+export declare function fillManifestDefaults(draft: ProductManifestDraft): ProductManifest;
+/**
+ * Render a `ProductManifest` as YAML-frontmatter markdown and write it
+ * to `<workspaceRoot>/PRODUCT.md`. The parent directory is created if
+ * missing; an existing PRODUCT.md is overwritten.
+ */
+export declare function writeProductManifest(workspaceRoot: string, manifest: ProductManifest, bodyTitle?: string): Promise<string>;
+/**
+ * Replace the YAML frontmatter of an existing PRODUCT.md while preserving the
+ * markdown body underneath. Used by workspace mutation endpoints so user-written
+ * prose (e.g. project notes added below the frontmatter) survives a manifest
+ * update. The file must exist; throws otherwise.
+ */
+export declare function updateProductManifest(workspaceRoot: string, manifest: ProductManifest): Promise<string>;
+//# sourceMappingURL=productManifestWriter.d.ts.map

package/dist/infrastructure/fs/productManifestWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"productManifestWriter.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/fs/productManifestWriter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAMV,eAAe,EACf,oBAAoB,EAGrB,MAAM,iBAAiB,CAAA;AA8BxB;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,oBAAoB,GAAG,eAAe,CAcjF;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAShI;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ7G"}

package/dist/infrastructure/fs/productManifestWriter.js

@@ -0,0 +1,75 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { OntologyId, ProductManifest as ProductManifestSchema } from '@braidhq/schema';
+import { stringify as stringifyYaml } from 'yaml';
+import { parseMarkdownFrontmatter } from './frontmatter.js';
+const FRONTMATTER_DELIMITER = '---';
+const DEFAULT_AGENT_BINDING = {
+    id: 'claude-default',
+    kind: 'claude-code',
+    model: 'opus',
+    effort: 'high',
+    extraArgs: [],
+    env: {},
+};
+const DEFAULT_AGENTS = {
+    default: 'claude-default',
+    tasks: {},
+};
+const DEFAULT_STORAGE = {
+    kind: 'kuzu',
+    config: {},
+};
+const DEFAULT_CHANNELS = [];
+/**
+ * Take a user-provided `ProductManifestDraft` and fill in the structural
+ * blocks (agent / storage / channels) so the result is a valid, complete
+ * `ProductManifest` Zod will accept. Throws if the user's input itself is
+ * inconsistent.
+ */
+export function fillManifestDefaults(draft) {
+    const manifest = {
+        name: draft.name,
+        version: draft.version ?? '0.1.0',
+        ...(draft.description ? { description: draft.description } : {}),
+        ontologyId: draft.ontologyId ?? OntologyId.parse('ddd'),
+        sources: draft.sources,
+        mcpServers: draft.mcpServers,
+        agents: draft.agents ?? DEFAULT_AGENTS,
+        agentBindings: draft.agentBindings ?? [DEFAULT_AGENT_BINDING],
+        storage: draft.storage ?? DEFAULT_STORAGE,
+        channels: draft.channels ?? [...DEFAULT_CHANNELS],
+    };
+    return ProductManifestSchema.parse(manifest);
+}
+/**
+ * Render a `ProductManifest` as YAML-frontmatter markdown and write it
+ * to `<workspaceRoot>/PRODUCT.md`. The parent directory is created if
+ * missing; an existing PRODUCT.md is overwritten.
+ */
+export async function writeProductManifest(workspaceRoot, manifest, bodyTitle) {
+    await mkdir(workspaceRoot, { recursive: true });
+    const yaml = stringifyYaml(manifest, { sortMapEntries: false }).trimEnd();
+    const heading = bodyTitle ?? manifest.name;
+    const body = `\n# ${heading}\n`;
+    const content = `${FRONTMATTER_DELIMITER}\n${yaml}\n${FRONTMATTER_DELIMITER}\n${body}`;
+    const path = join(workspaceRoot, 'PRODUCT.md');
+    await writeFile(path, content, 'utf-8');
+    return path;
+}
+/**
+ * Replace the YAML frontmatter of an existing PRODUCT.md while preserving the
+ * markdown body underneath. Used by workspace mutation endpoints so user-written
+ * prose (e.g. project notes added below the frontmatter) survives a manifest
+ * update. The file must exist; throws otherwise.
+ */
+export async function updateProductManifest(workspaceRoot, manifest) {
+    const path = join(workspaceRoot, 'PRODUCT.md');
+    const existing = await readFile(path, 'utf-8');
+    const { body } = parseMarkdownFrontmatter(existing);
+    const yaml = stringifyYaml(manifest, { sortMapEntries: false }).trimEnd();
+    const content = `${FRONTMATTER_DELIMITER}\n${yaml}\n${FRONTMATTER_DELIMITER}\n${body}`;
+    await writeFile(path, content, 'utf-8');
+    return path;
+}
+//# sourceMappingURL=productManifestWriter.js.map

package/dist/infrastructure/fs/productManifestWriter.js.map

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