@braidhq/server 0.0.1 → 0.2.0

package/dist/infrastructure/source/FsSourceUnitObservationRepository.js

@@ -0,0 +1,88 @@
+import { mkdir, readdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import process from 'node:process';
+import { NotFoundError } from '@braidhq/core';
+import { SourceUnitObservation as SourceUnitObservationSchema } from '@braidhq/schema';
+import { sourceUnitObservationDir, sourceUnitObservationFilePath, sourceUnitObservationSourceDir } from '../_shared/paths.js';
+/**
+ * Filesystem-backed `SourceUnitObservationRepository`. Each entity maps to,
+ * `artifacts/source-unit-state/<sourceId>/<encoded-path>.json`, one file each,
+ * matching the file-per-entity pattern used by proposals / clarifications.
+ *
+ * The file body is exactly the `SourceUnitObservation` shape,
+ * with no wrapper or envelope.
+ * In a future SQLite or Postgres store,
+ * each file becomes one row keyed by `(workspaceId, sourceId, path)`.
+ */
+export class FsSourceUnitObservationRepository {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async find(workspaceId, sourceId, path) {
+        const root = await this.resolveRoot(workspaceId);
+        const file = sourceUnitObservationFilePath(root, sourceId, path);
+        try {
+            const raw = await readFile(file, 'utf-8');
+            return SourceUnitObservationSchema.parse(JSON.parse(raw));
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return null;
+            throw error;
+        }
+    }
+    async save(state) {
+        const root = await this.resolveRoot(state.workspaceId);
+        const file = sourceUnitObservationFilePath(root, state.sourceId, state.path);
+        await mkdir(sourceUnitObservationSourceDir(root, state.sourceId), { recursive: true });
+        const tmp = `${file}.tmp-${process.pid}-${Date.now()}`;
+        await writeFile(tmp, `${JSON.stringify(state, null, 2)}\n`, 'utf-8');
+        await rename(tmp, file);
+    }
+    async listByWorkspace(workspaceId) {
+        const root = await this.resolveRoot(workspaceId);
+        const baseDir = sourceUnitObservationDir(root);
+        const sourceDirs = await safeReaddir(baseDir);
+        const all = [];
+        for (const sourceDir of sourceDirs) {
+            if (!sourceDir.isDirectory())
+                continue;
+            all.push(...await readEntriesIn(join(baseDir, sourceDir.name)));
+        }
+        return all;
+    }
+    async listBySource(workspaceId, sourceId) {
+        const root = await this.resolveRoot(workspaceId);
+        return readEntriesIn(sourceUnitObservationSourceDir(root, sourceId));
+    }
+    async resolveRoot(workspaceId) {
+        const roots = await this.options.workspaceRoots();
+        const root = roots.get(workspaceId);
+        if (!root)
+            throw new NotFoundError(`Workspace "${workspaceId}" has no registered root path`);
+        return root;
+    }
+}
+async function safeReaddir(dir) {
+    try {
+        return await readdir(dir, { withFileTypes: true });
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return [];
+        throw error;
+    }
+}
+async function readEntriesIn(dir) {
+    const entries = await safeReaddir(dir);
+    const results = [];
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith('.json'))
+            continue;
+        const raw = await readFile(join(dir, entry.name), 'utf-8');
+        results.push(SourceUnitObservationSchema.parse(JSON.parse(raw)));
+    }
+    return results;
+}
+//# sourceMappingURL=FsSourceUnitObservationRepository.js.map

package/dist/infrastructure/source/FsSourceUnitObservationRepository.js.map

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

package/dist/infrastructure/source/intentScan.d.ts

@@ -0,0 +1,13 @@
+import type { Workspace } from '@braidhq/core';
+export interface IntentItem {
+    readonly value: string;
+    readonly label: string;
+    readonly sourceId: string;
+    readonly sourceName: string;
+}
+/**
+ * Shared by the Studio source picker and BatchService,
+ * so both see the same per-doc granularity.
+ */
+export declare function listIntentItems(workspace: Workspace): Promise<IntentItem[]>;
+//# sourceMappingURL=intentScan.d.ts.map

package/dist/infrastructure/source/intentScan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intentScan.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/source/intentScan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAM9C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAcjF"}

package/dist/infrastructure/source/intentScan.js

@@ -0,0 +1,137 @@
+import { readdir } from 'node:fs/promises';
+import { isAbsolute, join } from 'node:path';
+const INTENT_FILE_EXTENSIONS = new Set(['.md', '.mdx', '.markdown', '.txt', '.rst']);
+/**
+ * Shared by the Studio source picker and BatchService,
+ * so both see the same per-doc granularity.
+ */
+export async function listIntentItems(workspace) {
+    const items = [];
+    for (const source of workspace.sources) {
+        if (source.role !== 'intent')
+            continue;
+        if (source.kind !== 'filesystem')
+            // MCP intent sources aren't directory-listable, future enhancement.
+            continue;
+        const absoluteRoot = isAbsolute(source.path)
+            ? source.path
+            : join(workspace.rootPath, source.path);
+        items.push(...await listIntentEntries(absoluteRoot, source.id, source.name));
+    }
+    return items;
+}
+async function listIntentEntries(root, sourceId, sourceName) {
+    const items = [];
+    let topEntries;
+    try {
+        topEntries = await readdir(root, { withFileTypes: true });
+    }
+    catch {
+        return items;
+    }
+    for (const entry of topEntries) {
+        if (entry.name.startsWith('.'))
+            continue;
+        if (entry.isDirectory()) {
+            const folder = join(root, entry.name);
+            // A flat directory of loose markdown files gives one unit per file,
+            // so downstream skills run per-document rather than over the bag all at once.
+            // Such layouts include a github loader's issues tree,
+            // or a hand-curated prd folder of onboarding docs.
+            // A directory with its own sub-structure stays a single unit,
+            // since that structure is the unit's own organisation.
+            const flatFiles = await listFlatDocumentFiles(folder);
+            if (flatFiles) {
+                for (const name of flatFiles) {
+                    items.push({
+                        value: `${entry.name}/${name}`,
+                        label: `${entry.name}/${stripExtension(name)}`,
+                        sourceId,
+                        sourceName,
+                    });
+                }
+                continue;
+            }
+            if (await containsDocument(folder, 4)) {
+                items.push({
+                    value: `${entry.name}/`,
+                    label: entry.name,
+                    sourceId,
+                    sourceName,
+                });
+            }
+            continue;
+        }
+        if (entry.isFile() && isIntentDocument(entry.name)) {
+            items.push({
+                value: entry.name,
+                label: stripExtension(entry.name),
+                sourceId,
+                sourceName,
+            });
+        }
+    }
+    return items.sort((a, b) => a.label.localeCompare(b.label));
+}
+// A flat document directory has every visible entry a markdown file,
+// with no subdirectories.
+// For one, returns the sorted list of filenames.
+// Returns `undefined` otherwise, so the caller falls back to treating,
+// the directory as a single unit.
+// "Visible" here excludes dotfiles,
+// so sync state like `.braid-github-cursor.json` doesn't disqualify it.
+async function listFlatDocumentFiles(dir) {
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return undefined;
+    }
+    const docs = [];
+    for (const entry of entries) {
+        if (entry.name.startsWith('.'))
+            continue;
+        if (entry.isDirectory())
+            return undefined;
+        if (!entry.isFile())
+            continue;
+        if (!isIntentDocument(entry.name))
+            return undefined;
+        docs.push(entry.name);
+    }
+    if (docs.length === 0)
+        return undefined;
+    return docs.sort((a, b) => a.localeCompare(b));
+}
+async function containsDocument(dir, maxDepth) {
+    if (maxDepth < 0)
+        return false;
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return false;
+    }
+    for (const entry of entries) {
+        if (entry.name.startsWith('.'))
+            continue;
+        if (entry.isFile() && isIntentDocument(entry.name))
+            return true;
+        if (entry.isDirectory() && await containsDocument(join(dir, entry.name), maxDepth - 1))
+            return true;
+    }
+    return false;
+}
+function isIntentDocument(filename) {
+    const dot = filename.lastIndexOf('.');
+    if (dot < 0)
+        return false;
+    return INTENT_FILE_EXTENSIONS.has(filename.slice(dot).toLowerCase());
+}
+function stripExtension(filename) {
+    const dot = filename.lastIndexOf('.');
+    return dot < 0 ? filename : filename.slice(0, dot);
+}
+//# sourceMappingURL=intentScan.js.map

package/dist/infrastructure/source/intentScan.js.map

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

package/dist/infrastructure/users/UserDirectoryFromRegistry.d.ts

@@ -0,0 +1,14 @@
+import type { UserAuthor, UserDirectory } from '@braidhq/core';
+import type { UserId } from '@braidhq/schema';
+import type { UserRegistryFile } from './UserRegistryFile.js';
+/**
+ * Adapt the file-backed user roster to the core `UserDirectory` port.
+ * Returns `null` for unknown ids (such as bootstrap or `braid-skill`),
+ * so the git layer falls back to its synthetic author for those rows.
+ */
+export declare class UserDirectoryFromRegistry implements UserDirectory {
+    private readonly registry;
+    constructor(registry: UserRegistryFile);
+    resolve(userId: UserId): Promise<UserAuthor | null>;
+}
+//# sourceMappingURL=UserDirectoryFromRegistry.d.ts.map

package/dist/infrastructure/users/UserDirectoryFromRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserDirectoryFromRegistry.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/users/UserDirectoryFromRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE7D;;;;GAIG;AACH,qBAAa,yBAA0B,YAAW,aAAa;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,gBAAgB;IAEjD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CAS1D"}

package/dist/infrastructure/users/UserDirectoryFromRegistry.js

@@ -0,0 +1,21 @@
+/**
+ * Adapt the file-backed user roster to the core `UserDirectory` port.
+ * Returns `null` for unknown ids (such as bootstrap or `braid-skill`),
+ * so the git layer falls back to its synthetic author for those rows.
+ */
+export class UserDirectoryFromRegistry {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    async resolve(userId) {
+        const user = await this.registry.get(userId);
+        if (!user)
+            return null;
+        return {
+            displayName: user.displayName,
+            ...(user.email ? { email: user.email } : {}),
+        };
+    }
+}
+//# sourceMappingURL=UserDirectoryFromRegistry.js.map

package/dist/infrastructure/users/UserDirectoryFromRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserDirectoryFromRegistry.js","sourceRoot":"","sources":["../../../src/infrastructure/users/UserDirectoryFromRegistry.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,OAAO,yBAAyB;IACP;IAA7B,YAA6B,QAA0B;QAA1B,aAAQ,GAAR,QAAQ,CAAkB;IAAG,CAAC;IAE3D,KAAK,CAAC,OAAO,CAAC,MAAc;QAC1B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAC5C,IAAI,CAAC,IAAI;YACP,OAAO,IAAI,CAAA;QACb,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7C,CAAA;IACH,CAAC;CACF"}

package/dist/infrastructure/users/UserRegistryFile.d.ts

@@ -0,0 +1,22 @@
+import type { UserId as UserIdType, UserUpdate as UserPatchType, User as UserType } from '@braidhq/schema';
+/**
+ * Persists the user registry to a JSON file at `${BRAID_HOME}/users.json`.
+ * Source of truth across server restarts, in-memory data is a derivation.
+ *
+ * Auth and ACL are server-side concerns, never part of a workspace's git history.
+ * Keep this file under `~/.braid/`, not inside any workspace dir.
+ */
+export declare class UserRegistryFile {
+    private readonly filePath;
+    constructor(filePath: string);
+    list(): Promise<UserType[]>;
+    get(id: UserIdType): Promise<UserType | undefined>;
+    getByGoogleSub(sub: string): Promise<UserType | undefined>;
+    getByEmail(email: string): Promise<UserType | undefined>;
+    create(user: UserType): Promise<UserType>;
+    update(id: UserIdType, patch: UserPatchType): Promise<UserType>;
+    delete(id: UserIdType): Promise<void>;
+    private read;
+    private write;
+}
+//# sourceMappingURL=UserRegistryFile.d.ts.map

package/dist/infrastructure/users/UserRegistryFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserRegistryFile.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/users/UserRegistryFile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,UAAU,IAAI,aAAa,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAa1G;;;;;;GAMG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAEvC,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAK3B,GAAG,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAKlD,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAK1D,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAMxD,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAWzC,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC;IAkB/D,MAAM,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;YAQ7B,IAAI;YAeJ,KAAK;CAIpB"}

package/dist/infrastructure/users/UserRegistryFile.js

@@ -0,0 +1,89 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { NotFoundError, ValidationError } from '@braidhq/core';
+import { User } from '@braidhq/schema';
+import { z } from 'zod';
+const RegistryContent = z.object({
+    users: z.array(User).default([]),
+});
+/**
+ * Persists the user registry to a JSON file at `${BRAID_HOME}/users.json`.
+ * Source of truth across server restarts, in-memory data is a derivation.
+ *
+ * Auth and ACL are server-side concerns, never part of a workspace's git history.
+ * Keep this file under `~/.braid/`, not inside any workspace dir.
+ */
+export class UserRegistryFile {
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    async list() {
+        const content = await this.read();
+        return content.users;
+    }
+    async get(id) {
+        const content = await this.read();
+        return content.users.find(u => u.id === id);
+    }
+    async getByGoogleSub(sub) {
+        const content = await this.read();
+        return content.users.find(u => u.googleSub === sub);
+    }
+    async getByEmail(email) {
+        const content = await this.read();
+        const lowered = email.toLowerCase();
+        return content.users.find(u => u.email?.toLowerCase() === lowered);
+    }
+    async create(user) {
+        const content = await this.read();
+        if (content.users.some(existing => existing.id === user.id))
+            throw new ValidationError(`User "${user.id}" already exists`);
+        if (user.googleSub && content.users.some(existing => existing.googleSub === user.googleSub))
+            throw new ValidationError(`User with googleSub "${user.googleSub}" already exists`);
+        content.users.push(user);
+        await this.write(content);
+        return user;
+    }
+    async update(id, patch) {
+        const content = await this.read();
+        const idx = content.users.findIndex(u => u.id === id);
+        if (idx < 0)
+            throw new NotFoundError(`User "${id}" not found`);
+        const current = content.users[idx];
+        // Drop undefined keys, so `{ displayName: undefined }` doesn't blow away the existing displayName.
+        // Zod's `.partial()` widens every field to optional,
+        // but the persisted User schema still requires the non-optional fields.
+        const defined = Object.fromEntries(Object.entries(patch).filter(([, v]) => v !== undefined));
+        const merged = { ...current, ...defined };
+        content.users[idx] = merged;
+        await this.write(content);
+        return merged;
+    }
+    async delete(id) {
+        const content = await this.read();
+        const filtered = content.users.filter(u => u.id !== id);
+        if (filtered.length === content.users.length)
+            return;
+        await this.write({ users: 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 user registry at "${this.filePath}": ${parsed.error.message}`);
+            return parsed.data;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return { users: [] };
+            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=UserRegistryFile.js.map

package/dist/infrastructure/users/UserRegistryFile.js.map

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

package/dist/infrastructure/users/ensureWorkspaceOwners.d.ts

@@ -0,0 +1,12 @@
+import type { UserId } from '@braidhq/schema';
+import type { WorkspaceRegistryFile } from '../workspace/WorkspaceRegistryFile.js';
+/**
+ * Give every ownerless workspace a default owner.
+ * A workspace registered before the member model has an empty `members[]`.
+ * Single-tenant seeds `defaultOwner` so the install keeps working untouched.
+ * Multi-tenant passes null, where an ownerless workspace is a fault,
+ * every workspace there is created with an explicit owner, so this throws.
+ * Idempotent, workspaces that already have members are left alone.
+ */
+export declare function ensureWorkspaceOwners(registry: WorkspaceRegistryFile, defaultOwner: UserId | null): Promise<void>;
+//# sourceMappingURL=ensureWorkspaceOwners.d.ts.map

package/dist/infrastructure/users/ensureWorkspaceOwners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureWorkspaceOwners.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/users/ensureWorkspaceOwners.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAA;AAElF;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,qBAAqB,EAC/B,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/infrastructure/users/ensureWorkspaceOwners.js

@@ -0,0 +1,25 @@
+/**
+ * Give every ownerless workspace a default owner.
+ * A workspace registered before the member model has an empty `members[]`.
+ * Single-tenant seeds `defaultOwner` so the install keeps working untouched.
+ * Multi-tenant passes null, where an ownerless workspace is a fault,
+ * every workspace there is created with an explicit owner, so this throws.
+ * Idempotent, workspaces that already have members are left alone.
+ */
+export async function ensureWorkspaceOwners(registry, defaultOwner) {
+    const rootPaths = await registry.list();
+    const now = new Date().toISOString();
+    for (const rootPath of rootPaths) {
+        const members = await registry.listMembers(rootPath);
+        if (members.length > 0)
+            continue;
+        if (defaultOwner === null)
+            throw new Error(`Workspace at ${rootPath} has no owner, a multi-tenant server requires an explicit owner.`);
+        await registry.addMember(rootPath, {
+            userId: defaultOwner,
+            role: 'owner',
+            joinedAt: now,
+        });
+    }
+}
+//# sourceMappingURL=ensureWorkspaceOwners.js.map

package/dist/infrastructure/users/ensureWorkspaceOwners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureWorkspaceOwners.js","sourceRoot":"","sources":["../../../src/infrastructure/users/ensureWorkspaceOwners.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAA+B,EAC/B,YAA2B;IAE3B,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IACvC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAe,CAAA;IACjD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;QACpD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YACpB,SAAQ;QACV,IAAI,YAAY,KAAK,IAAI;YACvB,MAAM,IAAI,KAAK,CAAC,gBAAgB,QAAQ,kEAAkE,CAAC,CAAA;QAC7G,MAAM,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE;YACjC,MAAM,EAAE,YAAY;YACpB,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,GAAG;SACd,CAAC,CAAA;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"FsWorkspaceRepository.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/workspace/FsWorkspaceRepository.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAGvE,OAAO,EAAgD,SAAS,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACjH,OAAO,EAAE,YAAY,EAAgC,MAAM,iBAAiB,CAAA;AAM5E,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;IAOtD,IAAI,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAc5B,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;YAcZ,qBAAqB;YAerB,YAAY;IAY1B,OAAO,CAAC,aAAa;CAOtB"}

package/dist/infrastructure/{fs → workspace}/FsWorkspaceRepository.js

@@ -1,20 +1,31 @@
 import { readFile, stat } from 'node:fs/promises';
 import { resolve } from 'node:path';
-import { NotFoundError, ValidationError, Workspace } from '@braidhq/core';
+import { createLogger, NotFoundError, ValidationError, Workspace } from '@braidhq/core';
 import { AbsolutePath, ProductManifest, WorkspaceId } from '@braidhq/schema';
-import { parseMarkdownFrontmatter } from './frontmatter.js';
-import { workspaceProductManifestPath } from './paths.js';
+import { parseMarkdownFrontmatter } from '../_shared/frontmatter.js';
+import { workspaceProductManifestPath } from '../_shared/paths.js';
+const log = createLogger('server').child({ mod: 'workspace-repo' });
 export class FsWorkspaceRepository {
     deps;
     cache = new Map();
     constructor(deps) {
         this.deps = deps;
     }
+    // One unreadable rootPath, a deleted dir or a broken PRODUCT.md,
+    // must not starve the rest.
+    // The asymmetry with `load()` is deliberate.
+    // Aggregate views recover,
+    // whereas a single-entity lookup must tell present apart from absent.
     async list() {
         const rootPaths = await this.deps.registry.list();
         const workspaces = [];
         for (const rootPath of rootPaths) {
-            workspaces.push(await this.load(rootPath));
+            try {
+                workspaces.push(await this.load(rootPath));
+            }
+            catch (err) {
+                log.warn({ err, rootPath }, 'skipping unreadable registry entry');
+            }
         }
         return workspaces;
     }
@@ -47,7 +58,6 @@ export class FsWorkspaceRepository {
             id: WorkspaceId.parse(productManifest.name),
             rootPath: AbsolutePath.parse(resolve(rootPath)),
             productManifest,
-            pluginConfig: { plugins: [] },
         };
         return new Workspace(data);
     }

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

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

package/dist/infrastructure/workspace/WorkspaceDiscovery.d.ts

@@ -0,0 +1,18 @@
+import type { WorkspaceService } from '@braidhq/core';
+import type { AbsolutePath } from '@braidhq/schema';
+/**
+ * Walk `<workspacesRoot>/*` and register with the WorkspaceService,
+ * every subdirectory that owns a `PRODUCT.md`.
+ * It is idempotent,
+ * an already-registered workspace is a no-op against the FS registry.
+ * We run it on server boot,
+ * so CLI-created or hand-copied workspaces surface in Studio,
+ * without any explicit `register` step.
+ *
+ * A per-entry error, a corrupt PRODUCT.md or bad permissions,
+ * is logged and skipped.
+ * The server must still come up,
+ * so the user can fix the outlier and re-boot.
+ */
+export declare function discoverCanonicalWorkspaces(workspacesRoot: AbsolutePath, workspaceService: WorkspaceService): Promise<void>;
+//# sourceMappingURL=WorkspaceDiscovery.d.ts.map

package/dist/infrastructure/workspace/WorkspaceDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceDiscovery.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/workspace/WorkspaceDiscovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAKnD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,2BAA2B,CAC/C,cAAc,EAAE,YAAY,EAC5B,gBAAgB,EAAE,gBAAgB,GACjC,OAAO,CAAC,IAAI,CAAC,CAgCf"}

package/dist/infrastructure/workspace/WorkspaceDiscovery.js

@@ -0,0 +1,50 @@
+import { readdir, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { createLogger } from '@braidhq/core';
+/**
+ * Walk `<workspacesRoot>/*` and register with the WorkspaceService,
+ * every subdirectory that owns a `PRODUCT.md`.
+ * It is idempotent,
+ * an already-registered workspace is a no-op against the FS registry.
+ * We run it on server boot,
+ * so CLI-created or hand-copied workspaces surface in Studio,
+ * without any explicit `register` step.
+ *
+ * A per-entry error, a corrupt PRODUCT.md or bad permissions,
+ * is logged and skipped.
+ * The server must still come up,
+ * so the user can fix the outlier and re-boot.
+ */
+export async function discoverCanonicalWorkspaces(workspacesRoot, workspaceService) {
+    const log = createLogger('server').child({ mod: 'workspace-discovery' });
+    let entries;
+    try {
+        entries = await readdir(workspacesRoot);
+    }
+    catch (err) {
+        // ENOENT on first boot is expected,
+        // the dir is created lazily by the first scaffold.
+        // Any other error, such as bad permissions, we log and continue.
+        // The server still boots.
+        if (err.code !== 'ENOENT')
+            log.warn({ err, workspacesRoot }, 'failed to read workspaces root');
+        return;
+    }
+    for (const entry of entries) {
+        const rootPath = join(workspacesRoot, entry);
+        try {
+            const dirStat = await stat(rootPath);
+            if (!dirStat.isDirectory())
+                continue;
+            const manifestStat = await stat(join(rootPath, 'PRODUCT.md')).catch(() => undefined);
+            if (!manifestStat?.isFile())
+                continue;
+            const workspace = await workspaceService.load(rootPath);
+            await workspaceService.save(workspace);
+        }
+        catch (err) {
+            log.warn({ err, rootPath }, 'skipping unreadable workspace dir');
+        }
+    }
+}
+//# sourceMappingURL=WorkspaceDiscovery.js.map

package/dist/infrastructure/workspace/WorkspaceDiscovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceDiscovery.js","sourceRoot":"","sources":["../../../src/infrastructure/workspace/WorkspaceDiscovery.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAE5C;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,cAA4B,EAC5B,gBAAkC;IAElC,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,qBAAqB,EAAE,CAAC,CAAA;IACxE,IAAI,OAAiB,CAAA;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,CAAA;IACzC,CAAC;IACD,OAAO,GAAG,EAAE,CAAC;QACX,oCAAoC;QACpC,mDAAmD;QACnD,iEAAiE;QACjE,0BAA0B;QAC1B,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAClD,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,EAAE,gCAAgC,CAAC,CAAA;QACrE,OAAM;IACR,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,KAAK,CAAiB,CAAA;QAC5D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAA;YACpC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE;gBACxB,SAAQ;YACV,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;YACpF,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE;gBACzB,SAAQ;YACV,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACvD,MAAM,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACxC,CAAC;QACD,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,mCAAmC,CAAC,CAAA;QAClE,CAAC;IACH,CAAC;AACH,CAAC"}