@braidhq/server 0.1.0 → 0.2.0

package/dist/infrastructure/skill/subprocessEventStream.d.ts

@@ -0,0 +1,16 @@
+import type { SkillEvent } from '@braidhq/schema';
+import type { ChildProcess } from 'node:child_process';
+/**
+ * Maps one stdout line to zero or more SkillEvents.
+ * The agent binding owns this, since the line format is the agent's own.
+ */
+export type LineParser = (line: string, now: string) => SkillEvent[];
+/**
+ * Wires a child's stdout and stderr to a single SkillEvent callback.
+ * `parseLine` comes from the agent binding, so this stays format-agnostic.
+ * Returns `flush` so callers can drain the final un-terminated line on `close`.
+ */
+export declare function attachOutputBuffers(child: ChildProcess, parseLine: LineParser, onEvent: (event: SkillEvent) => void, now: () => string): {
+    flush: () => void;
+};
+//# sourceMappingURL=subprocessEventStream.d.ts.map

package/dist/infrastructure/skill/subprocessEventStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subprocessEventStream.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/skill/subprocessEventStream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAItD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,UAAU,EAAE,CAAA;AAEpE;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,EACpC,GAAG,EAAE,MAAM,MAAM,GAChB;IAAE,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CAsBvB"}

package/dist/infrastructure/skill/subprocessEventStream.js

@@ -0,0 +1,29 @@
+import { SkillEvent as SkillEventSchema } from '@braidhq/schema';
+import { LineBuffer } from './lineBuffer.js';
+/**
+ * Wires a child's stdout and stderr to a single SkillEvent callback.
+ * `parseLine` comes from the agent binding, so this stays format-agnostic.
+ * Returns `flush` so callers can drain the final un-terminated line on `close`.
+ */
+export function attachOutputBuffers(child, parseLine, onEvent, now) {
+    const stdout = new LineBuffer((line) => {
+        for (const event of parseLine(line, now()))
+            onEvent(event);
+    });
+    // stderr is wrapped verbatim into a `[stderr]` message event,
+    // so it shows up in the transcript alongside model output.
+    const stderr = new LineBuffer((line) => {
+        onEvent(SkillEventSchema.parse({ type: 'message', text: `[stderr] ${line}` }));
+    });
+    child.stdout?.setEncoding('utf-8');
+    child.stdout?.on('data', (chunk) => stdout.append(chunk));
+    child.stderr?.setEncoding('utf-8');
+    child.stderr?.on('data', (chunk) => stderr.append(chunk));
+    return {
+        flush: () => {
+            stdout.flush();
+            stderr.flush();
+        },
+    };
+}
+//# sourceMappingURL=subprocessEventStream.js.map

package/dist/infrastructure/skill/subprocessEventStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subprocessEventStream.js","sourceRoot":"","sources":["../../../src/infrastructure/skill/subprocessEventStream.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,IAAI,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAQ5C;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAmB,EACnB,SAAqB,EACrB,OAAoC,EACpC,GAAiB;IAEjB,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE;QACrC,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC;YACxC,OAAO,CAAC,KAAK,CAAC,CAAA;IAClB,CAAC,CAAC,CAAA;IACF,8DAA8D;IAC9D,2DAA2D;IAC3D,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE;QACrC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,IAAI,EAAE,EAAE,CAAC,CAAC,CAAA;IAChF,CAAC,CAAC,CAAA;IAEF,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IAClC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IACjE,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IAClC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IAEjE,OAAO;QACL,KAAK,EAAE,GAAG,EAAE;YACV,MAAM,CAAC,KAAK,EAAE,CAAA;YACd,MAAM,CAAC,KAAK,EAAE,CAAA;QAChB,CAAC;KACF,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,19 @@
+import type { SourceUnitDigest, Workspace } from '@braidhq/core';
+import type { SourceId, SourceUnitSha } from '@braidhq/schema';
+/**
+ * Filesystem-backed `SourceUnitDigest`. Resolves the unit's relative path,
+ * under its filesystem source root, then hashes.
+ *
+ * - regular file: the sha256 of the file bytes.
+ * - directory: a recursive walk hashes each file by content,
+ *   assembles a deterministic `<relpath>:<filehash>\n` manifest,
+ *   sorted by relpath, then returns the sha256 of that manifest.
+ *   Dot-prefixed entries are skipped, per the intent scanner's convention.
+ *
+ * The intent scanner's trailing-slash convention is accepted,
+ * so a file reads as `foo.md` and a folder as `foo/`.
+ */
+export declare class FsSourceUnitDigest implements SourceUnitDigest {
+    computeSha(workspace: Workspace, sourceId: SourceId, path: string): Promise<SourceUnitSha>;
+}
+//# sourceMappingURL=FsSourceUnitDigest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FsSourceUnitDigest.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/source/FsSourceUnitDigest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAK9D;;;;;;;;;;;;GAYG;AACH,qBAAa,kBAAmB,YAAW,gBAAgB;IACnD,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAejG"}

package/dist/infrastructure/{fs → source}/FsSourceUnitDigest.js

@@ -2,17 +2,17 @@ import { createHash } from 'node:crypto';
 import { readdir, readFile, stat } from 'node:fs/promises';
 import { isAbsolute, join, relative } from 'node:path';
 /**
- * Filesystem-backed `SourceUnitDigest`. Resolves the unit's relative
- * path under its filesystem source root, then either:
+ * Filesystem-backed `SourceUnitDigest`. Resolves the unit's relative path,
+ * under its filesystem source root, then hashes.
  *
- * - regular file: sha256 of file bytes
- * - directory: recursive walk; hash each file by content; build a
- *   deterministic `<relpath>:<filehash>\n` manifest sorted by relpath;
- *   sha256 the manifest. Dot-prefixed entries are skipped (mirrors the
- *   intent scanner's convention).
+ * - regular file: the sha256 of the file bytes.
+ * - directory: a recursive walk hashes each file by content,
+ *   assembles a deterministic `<relpath>:<filehash>\n` manifest,
+ *   sorted by relpath, then returns the sha256 of that manifest.
+ *   Dot-prefixed entries are skipped, per the intent scanner's convention.
  *
- * Trailing-slash convention from the intent scanner (file = `foo.md`,
- * folder = `foo/`) is accepted.
+ * The intent scanner's trailing-slash convention is accepted,
+ * so a file reads as `foo.md` and a folder as `foo/`.
  */
 export class FsSourceUnitDigest {
     async computeSha(workspace, sourceId, path) {

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

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

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

@@ -0,0 +1,31 @@
+import type { SourceUnitObservationRepository } from '@braidhq/core';
+import type { AbsolutePath, SourceId, SourceUnitObservation, WorkspaceId } from '@braidhq/schema';
+export interface FsSourceUnitObservationRepositoryOptions {
+    /**
+     * Lookup of `workspaceId` to `workspaceRoot`, shared by the repos,
+     * so this one takes no `WorkspaceService` dependency of its own.
+     * `composeFs.ts` builds the closure once, then hands the same one,
+     * to every fs repo.
+     */
+    readonly workspaceRoots: () => Promise<ReadonlyMap<WorkspaceId, AbsolutePath>>;
+}
+/**
+ * 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 declare class FsSourceUnitObservationRepository implements SourceUnitObservationRepository {
+    private readonly options;
+    constructor(options: FsSourceUnitObservationRepositoryOptions);
+    find(workspaceId: WorkspaceId, sourceId: SourceId, path: string): Promise<SourceUnitObservation | null>;
+    save(state: SourceUnitObservation): Promise<void>;
+    listByWorkspace(workspaceId: WorkspaceId): Promise<readonly SourceUnitObservation[]>;
+    listBySource(workspaceId: WorkspaceId, sourceId: SourceId): Promise<readonly SourceUnitObservation[]>;
+    private resolveRoot;
+}
+//# sourceMappingURL=FsSourceUnitObservationRepository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FsSourceUnitObservationRepository.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/source/FsSourceUnitObservationRepository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,eAAe,CAAA;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AASjG,MAAM,WAAW,wCAAwC;IACvD;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAA;CAC/E;AAED;;;;;;;;;GASG;AACH,qBAAa,iCAAkC,YAAW,+BAA+B;IAC3E,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,wCAAwC;IAExE,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAcvG,IAAI,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IASjD,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,qBAAqB,EAAE,CAAC;IAapF,YAAY,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,qBAAqB,EAAE,CAAC;YAK7F,WAAW;CAO1B"}

package/dist/infrastructure/{fs/FsSourceUnitStateRepository.js → source/FsSourceUnitObservationRepository.js}

@@ -2,28 +2,29 @@ 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 { SourceUnitState as SourceUnitStateSchema } from '@braidhq/schema';
-import { sourceUnitStateDir, sourceUnitStateFilePath, sourceUnitStateSourceDir } from './paths.js';
+import { SourceUnitObservation as SourceUnitObservationSchema } from '@braidhq/schema';
+import { sourceUnitObservationDir, sourceUnitObservationFilePath, sourceUnitObservationSourceDir } from '../_shared/paths.js';
 /**
- * Filesystem-backed `SourceUnitStateRepository`. One JSON file per
- * entity at `artifacts/source-unit-state/<sourceId>/<encoded-path>.json`,
- * matching the file-per-entity pattern used by proposals / clarify.
+ * 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 `SourceUnitState` shape; no wrapper or
- * envelope. A future SQLite or Postgres impl maps each file to one row
- * with composite PK `(workspaceId, sourceId, path)`.
+ * 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 FsSourceUnitStateRepository {
+export class FsSourceUnitObservationRepository {
     options;
     constructor(options) {
         this.options = options;
     }
     async find(workspaceId, sourceId, path) {
         const root = await this.resolveRoot(workspaceId);
-        const file = sourceUnitStateFilePath(root, sourceId, path);
+        const file = sourceUnitObservationFilePath(root, sourceId, path);
         try {
             const raw = await readFile(file, 'utf-8');
-            return SourceUnitStateSchema.parse(JSON.parse(raw));
+            return SourceUnitObservationSchema.parse(JSON.parse(raw));
         }
         catch (error) {
             if (error.code === 'ENOENT')
@@ -33,15 +34,15 @@ export class FsSourceUnitStateRepository {
     }
     async save(state) {
         const root = await this.resolveRoot(state.workspaceId);
-        const file = sourceUnitStateFilePath(root, state.sourceId, state.path);
-        await mkdir(sourceUnitStateSourceDir(root, state.sourceId), { recursive: true });
+        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 = sourceUnitStateDir(root);
+        const baseDir = sourceUnitObservationDir(root);
         const sourceDirs = await safeReaddir(baseDir);
         const all = [];
         for (const sourceDir of sourceDirs) {
@@ -53,7 +54,7 @@ export class FsSourceUnitStateRepository {
     }
     async listBySource(workspaceId, sourceId) {
         const root = await this.resolveRoot(workspaceId);
-        return readEntriesIn(sourceUnitStateSourceDir(root, sourceId));
+        return readEntriesIn(sourceUnitObservationSourceDir(root, sourceId));
     }
     async resolveRoot(workspaceId) {
         const roots = await this.options.workspaceRoots();
@@ -80,8 +81,8 @@ async function readEntriesIn(dir) {
         if (!entry.isFile() || !entry.name.endsWith('.json'))
             continue;
         const raw = await readFile(join(dir, entry.name), 'utf-8');
-        results.push(SourceUnitStateSchema.parse(JSON.parse(raw)));
+        results.push(SourceUnitObservationSchema.parse(JSON.parse(raw)));
     }
     return results;
 }
-//# sourceMappingURL=FsSourceUnitStateRepository.js.map
+//# 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/{fs → source}/intentScan.d.ts

@@ -5,5 +5,9 @@ export interface IntentItem {
     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/{fs → source}/intentScan.js

@@ -1,14 +1,17 @@
 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.
+/**
+ * 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.
+            // MCP intent sources aren't directory-listable, future enhancement.
             continue;
         const absoluteRoot = isAbsolute(source.path)
             ? source.path
@@ -31,11 +34,12 @@ async function listIntentEntries(root, sourceId, sourceName) {
             continue;
         if (entry.isDirectory()) {
             const folder = join(root, entry.name);
-            // Flat directories of loose markdown files (the github source-loader's
-            // `issues/<num>.md` layout, hand-curated `prd/onboarding.md`, ...) expand
-            // into one unit per file so downstream skills run per-document, not over
-            // the whole bag at once. Directories with their own sub-structure stay as
-            // a single unit because that structure is the unit's own organisation.
+            // 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) {
@@ -69,15 +73,13 @@ async function listIntentEntries(root, sourceId, sourceName) {
     }
     return items.sort((a, b) => a.label.localeCompare(b.label));
 }
-/**
- * If `dir` is a "flat document directory" (every visible entry is a markdown
- * file, no subdirectories), returns the sorted list of those filenames.
- * Returns `undefined` otherwise so the caller falls back to treating the
- * directory as a single unit.
- *
- * "Visible" excludes dotfiles, so loader-managed sync state like
- * `.braid-github-cursor.json` does not disqualify a directory.
- */
+// 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 {

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

@@ -3,8 +3,8 @@ 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 (bootstrap / `braid-skill` etc.) so
- * the git layer falls back to its synthetic author for those rows.
+ * 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;

package/dist/infrastructure/users/UserDirectoryFromRegistry.js

@@ -1,7 +1,7 @@
 /**
  * Adapt the file-backed user roster to the core `UserDirectory` port.
- * Returns `null` for unknown ids (bootstrap / `braid-skill` etc.) so
- * the git layer falls back to its synthetic author for those rows.
+ * 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;

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

@@ -1,11 +1,10 @@
-import type { UserId as UserIdType, UserPatch as UserPatchType, User as UserType } from '@braidhq/schema';
+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.
+ * Source of truth across server restarts, in-memory data is a derivation.
  *
- * Auth and ACL are server-side concerns and never enter a workspace's
- * git history — keep this file under `~/.braid/`, not inside any
- * workspace directory.
+ * 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;

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

@@ -1 +1 @@
-{"version":3,"file":"UserRegistryFile.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/users/UserRegistryFile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,SAAS,IAAI,aAAa,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAazG;;;;;;;GAOG;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;IAmB/D,MAAM,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;YAQ7B,IAAI;YAeJ,KAAK;CAIpB"}
+{"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

@@ -8,11 +8,10 @@ const RegistryContent = z.object({
 });
 /**
  * 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.
+ * Source of truth across server restarts, in-memory data is a derivation.
  *
- * Auth and ACL are server-side concerns and never enter a workspace's
- * git history — keep this file under `~/.braid/`, not inside any
- * workspace directory.
+ * 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;
@@ -52,10 +51,9 @@ export class UserRegistryFile {
         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 to be present.
+        // 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;

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

@@ -1 +1 @@
-{"version":3,"file":"UserRegistryFile.js","sourceRoot":"","sources":["../../../src/infrastructure/users/UserRegistryFile.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACjC,CAAC,CAAA;AAIF;;;;;;;GAOG;AACH,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAEjD,KAAK,CAAC,IAAI;QACR,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QACjC,OAAO,OAAO,CAAC,KAAK,CAAA;IACtB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAc;QACtB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QACjC,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;IAC7C,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,GAAW;QAC9B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QACjC,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,CAAA;IACrD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAa;QAC5B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QACjC,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,EAAE,CAAA;QACnC,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,OAAO,CAAC,CAAA;IACpE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAc;QACzB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QACjC,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,eAAe,CAAC,SAAS,IAAI,CAAC,EAAE,kBAAkB,CAAC,CAAA;QAC/D,IAAI,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,CAAC;YACzF,MAAM,IAAI,eAAe,CAAC,wBAAwB,IAAI,CAAC,SAAS,kBAAkB,CAAC,CAAA;QACrF,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACxB,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAc,EAAE,KAAoB;QAC/C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QACjC,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;QACrD,IAAI,GAAG,GAAG,CAAC;YACT,MAAM,IAAI,aAAa,CAAC,SAAS,EAAE,aAAa,CAAC,CAAA;QACnD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAE,CAAA;QACnC,mEAAmE;QACnE,iEAAiE;QACjE,kEAAkE;QAClE,yCAAyC;QACzC,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAChC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CACpC,CAAA;QACtB,MAAM,MAAM,GAAa,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,CAAA;QACnD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAAA;QAC3B,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACzB,OAAO,MAAM,CAAA;IACf,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAc;QACzB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;QACvD,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,MAAM;YAC1C,OAAM;QACR,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;IACvC,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YAClD,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;YACzD,IAAI,CAAC,MAAM,CAAC,OAAO;gBACjB,MAAM,IAAI,eAAe,CAAC,6BAA6B,IAAI,CAAC,QAAQ,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;YACnG,OAAO,MAAM,CAAC,IAAI,CAAA;QACpB,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBACpD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;YACtB,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,OAAwB;QAC1C,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACxD,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAClF,CAAC;CACF"}
+{"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

@@ -1,9 +1,12 @@
-import type { WorkspaceRegistryFile } from '../fs/WorkspaceRegistryFile.js';
+import type { UserId } from '@braidhq/schema';
+import type { WorkspaceRegistryFile } from '../workspace/WorkspaceRegistryFile.js';
 /**
- * Phase C migration: workspaces registered before members existed have
- * empty `members[]`. Seed each one with `local-user` as owner so the
- * single-tenant install keeps working with no manual steps. Idempotent
- * — workspaces that already have members are left alone.
+ * 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): Promise<void>;
+export declare function ensureWorkspaceOwners(registry: WorkspaceRegistryFile, defaultOwner: UserId | null): Promise<void>;
 //# sourceMappingURL=ensureWorkspaceOwners.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ensureWorkspaceOwners.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/users/ensureWorkspaceOwners.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AAG3E;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAa1F"}
+{"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

@@ -1,19 +1,22 @@
-import { LOCAL_USER_ID } from './ensureLocalUser.js';
 /**
- * Phase C migration: workspaces registered before members existed have
- * empty `members[]`. Seed each one with `local-user` as owner so the
- * single-tenant install keeps working with no manual steps. Idempotent
- * — workspaces that already have members are left alone.
+ * 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) {
+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: LOCAL_USER_ID,
+            userId: defaultOwner,
             role: 'owner',
             joinedAt: now,
         });

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

@@ -1 +1 @@
-{"version":3,"file":"ensureWorkspaceOwners.js","sourceRoot":"","sources":["../../../src/infrastructure/users/ensureWorkspaceOwners.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,QAA+B;IACzE,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,MAAM,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE;YACjC,MAAM,EAAE,aAAa;YACrB,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,GAAG;SACd,CAAC,CAAA;IACJ,CAAC;AACH,CAAC"}
+{"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

@@ -2,8 +2,8 @@ import { readFile, stat } from 'node:fs/promises';
 import { resolve } from 'node:path';
 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;
@@ -11,10 +11,11 @@ export class FsWorkspaceRepository {
     constructor(deps) {
         this.deps = deps;
     }
-    // One unreadable rootPath (deleted dir, broken PRODUCT.md, ...)
-    // must not starve the rest. The asymmetry with `load()` is intentional:
-    // aggregate views recover, single-entity lookups distinguish present
-    // from absent.
+    // 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 = [];

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"}