@spinabot/brigade 0.1.2 → 1.0.1

package/dist/workspace/bootstrap.js

@@ -0,0 +1,123 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { workspaceIdFromDir } from "../storage/facts-cache.js";
+import { ensureAgentInWorkspaceLiveMirror } from "../storage/workspace-live-mirror.js";
+import { tryLoadWorkspaceTemplate } from "./template-loader.js";
+import { markBootstrapSeeded } from "./state.js";
+import { fileExists } from "./fs-utils.js";
+import { ensureWorkspaceGitRepo } from "./git-init.js";
+// The 7 files a fresh brigade install drops into <agentDir>/workspace/.
+// MEMORY.md is intentionally absent — it materialises lazily on the first
+// dream cycle, not at onboard time.
+//
+// Content for each file lives on disk under templates/workspace/<name> so
+// users can edit a single source-of-truth without recompiling. The loader
+// resolves the templates dir lazily (package-root → cwd → fallback) and
+// caches the result for the process lifetime.
+export const WORKSPACE_FILE_NAMES = [
+    "AGENTS.md",
+    "BOOTSTRAP.md",
+    "IDENTITY.md",
+    "SOUL.md",
+    "TOOLS.md",
+    "HEARTBEAT.md",
+    "USER.md",
+];
+export async function bootstrapWorkspace(workspaceDir) {
+    await fs.mkdir(workspaceDir, { recursive: true });
+    // Brand-new probe: a workspace counts as "freshly created" only when
+    // none of the persona files, memory dir, or git repo are present yet.
+    // On a customised workspace we skip BOOTSTRAP.md (so re-onboard doesn't
+    // resurrect the first-run script) and skip the git init (the user's
+    // existing repo state is theirs).
+    const brandNewWorkspace = await isBrandNewWorkspace(workspaceDir);
+    // Create memory/ early so a partial failure in the persona-file loop
+    // still leaves a usable workspace skeleton; the dream cycle populates
+    // it lazily on first run.
+    await fs.mkdir(path.join(workspaceDir, "memory"), { recursive: true });
+    const created = [];
+    const preserved = [];
+    const missingTemplates = [];
+    for (const name of WORKSPACE_FILE_NAMES) {
+        // BOOTSTRAP.md is special: only seed it when the workspace is truly
+        // brand-new. A user who's already gone through the first-run flow
+        // (and deleted BOOTSTRAP.md) shouldn't see it reappear when re-running
+        // onboard for any other reason.
+        if (name === "BOOTSTRAP.md" && !brandNewWorkspace)
+            continue;
+        const filePath = path.join(workspaceDir, name);
+        const template = await tryLoadWorkspaceTemplate(name);
+        if (!template) {
+            missingTemplates.push(name);
+            continue;
+        }
+        // flag:"wx" creates the file only if it doesn't exist. EEXIST means a
+        // concurrent process (or a prior onboard run) wrote the file first —
+        // preserve their copy rather than racing into a clobber.
+        try {
+            await fs.writeFile(filePath, template.content, {
+                encoding: "utf-8",
+                flag: "wx",
+            });
+            created.push(filePath);
+        }
+        catch (err) {
+            if (err.code === "EEXIST") {
+                preserved.push(filePath);
+                continue;
+            }
+            throw err;
+        }
+    }
+    // Stamp the lifecycle marker if BOOTSTRAP.md is now on disk (whether
+    // we just wrote it or it was already there). The agent kernel uses this
+    // to decide whether the next turn is a first-run greeting or business
+    // as usual.
+    const bootstrapPath = path.join(workspaceDir, "BOOTSTRAP.md");
+    if (await fileExists(bootstrapPath)) {
+        await markBootstrapSeeded(workspaceDir);
+    }
+    // git init only on truly brand-new workspaces. The git-init helper
+    // additionally guards on `.git/` already existing, so this is doubly
+    // safe against clobbering an existing repo.
+    let gitInitialised = false;
+    if (brandNewWorkspace) {
+        const result = await ensureWorkspaceGitRepo(workspaceDir);
+        gitInitialised = result.initialised;
+    }
+    // Convex-mode durability: register this workspace with the LIVE mirror
+    // and push the just-seeded persona files immediately. The mirror's watch
+    // set was built at gateway boot from the config — an agent created
+    // MID-SESSION (manage_agent add / org init) wasn't in it, so its
+    // personas existed only on disk until the next boot and a wipe in that
+    // window lost them (skills, which dual-write, were durably mirrored;
+    // personas were not). No-op in filesystem mode / when the mirror isn't
+    // running; idempotent for already-watched agents.
+    ensureAgentInWorkspaceLiveMirror(workspaceIdFromDir(workspaceDir));
+    return {
+        workspaceDir,
+        created,
+        preserved,
+        missingTemplates,
+        gitInitialised,
+        brandNewWorkspace,
+    };
+}
+// A workspace is "brand new" iff none of the canonical persona files,
+// the memory dir, the git dir, or the lifecycle marker exist yet. Any
+// of those signals indicates the user has already worked in this
+// workspace and we shouldn't re-seed BOOTSTRAP.md or run `git init`.
+async function isBrandNewWorkspace(workspaceDir) {
+    const probes = [
+        ...WORKSPACE_FILE_NAMES.map((n) => path.join(workspaceDir, n)),
+        path.join(workspaceDir, "memory"),
+        path.join(workspaceDir, ".git"),
+        path.join(workspaceDir, ".brigade", "workspace-state.json"),
+    ];
+    for (const p of probes) {
+        if (await fileExists(p))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/workspace/bootstrap.js.map

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

package/dist/workspace/fs-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function fileExists(p: string): Promise<boolean>;
+//# sourceMappingURL=fs-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fs-utils.d.ts","sourceRoot":"","sources":["../../src/workspace/fs-utils.ts"],"names":[],"mappings":"AAMA,wBAAsB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO5D"}

package/dist/workspace/fs-utils.js

@@ -0,0 +1,14 @@
+import fs from "node:fs/promises";
+// Shared filesystem helpers for the workspace subsystem. Hoisted so
+// `bootstrap.ts` and `state.ts` aren't each shipping a private copy of
+// the same file-existence probe.
+export async function fileExists(p) {
+    try {
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=fs-utils.js.map

package/dist/workspace/fs-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-utils.js","sourceRoot":"","sources":["../../src/workspace/fs-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAElC,oEAAoE;AACpE,uEAAuE;AACvE,iCAAiC;AAEjC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,CAAS;IACxC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/workspace/git-init.d.ts

@@ -0,0 +1,5 @@
+export declare function ensureWorkspaceGitRepo(workspaceDir: string): Promise<{
+    initialised: boolean;
+    reason?: "already-init" | "git-not-available" | "init-failed";
+}>;
+//# sourceMappingURL=git-init.d.ts.map

package/dist/workspace/git-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-init.d.ts","sourceRoot":"","sources":["../../src/workspace/git-init.ts"],"names":[],"mappings":"AAoBA,wBAAsB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1E,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,GAAG,mBAAmB,GAAG,aAAa,CAAC;CAC/D,CAAC,CAqBD"}

package/dist/workspace/git-init.js

@@ -0,0 +1,71 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { spawn } from "node:child_process";
+import { fileExists } from "./fs-utils.js";
+// Initialise a git repo inside the workspace dir on first onboard so the
+// user gets persona-file change history for free. Bounded behaviour:
+//
+//   - Only runs when the workspace looks freshly created (no `.git/` yet).
+//   - Soft-fails if `git` isn't installed or `git init` exits non-zero —
+//     workspace seeding shouldn't break because the user's machine has
+//     no git binary, and the agent loop doesn't depend on git tracking.
+//   - Doesn't touch existing repos (early return on `.git/` presence).
+const GIT_PROBE_TIMEOUT_MS = 3_000;
+const GIT_INIT_TIMEOUT_MS = 10_000;
+let cachedGitAvailable;
+export async function ensureWorkspaceGitRepo(workspaceDir) {
+    if (await fileExists(path.join(workspaceDir, ".git"))) {
+        return { initialised: false, reason: "already-init" };
+    }
+    if (!(await isGitAvailable())) {
+        return { initialised: false, reason: "git-not-available" };
+    }
+    try {
+        await runWithTimeout("git", ["init"], { cwd: workspaceDir, timeoutMs: GIT_INIT_TIMEOUT_MS });
+    }
+    catch {
+        return { initialised: false, reason: "init-failed" };
+    }
+    // Drop a default .gitignore so the lifecycle marker dir doesn't get
+    // committed by accident — the workspace-state.json file is per-host
+    // state, not persona content.
+    await fs.writeFile(path.join(workspaceDir, ".gitignore"), [".brigade/", "memory/.dreams/", ""].join("\n"), "utf8");
+    return { initialised: true };
+}
+async function isGitAvailable() {
+    if (cachedGitAvailable !== undefined)
+        return cachedGitAvailable;
+    try {
+        await runWithTimeout("git", ["--version"], { timeoutMs: GIT_PROBE_TIMEOUT_MS });
+        cachedGitAvailable = true;
+    }
+    catch {
+        cachedGitAvailable = false;
+    }
+    return cachedGitAvailable;
+}
+async function runWithTimeout(command, args, options) {
+    await new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            cwd: options.cwd,
+            stdio: "ignore",
+            shell: false,
+        });
+        const timer = setTimeout(() => {
+            child.kill("SIGKILL");
+            reject(new Error(`${command} timed out after ${options.timeoutMs}ms`));
+        }, options.timeoutMs);
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+        child.on("exit", (code) => {
+            clearTimeout(timer);
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`${command} exited with code ${code}`));
+        });
+    });
+}
+//# sourceMappingURL=git-init.js.map

package/dist/workspace/git-init.js.map

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

package/dist/workspace/state.d.ts

@@ -0,0 +1,13 @@
+export interface WorkspaceState {
+    version: number;
+    bootstrapSeededAt?: string;
+    setupCompletedAt?: string;
+}
+export type BootstrapPhase = "unseeded" | "first-turn" | "in-progress" | "complete";
+export declare function resolveWorkspaceStatePath(workspaceDir: string): string;
+export declare function readWorkspaceState(workspaceDir: string): Promise<WorkspaceState>;
+export declare function writeWorkspaceState(workspaceDir: string, state: WorkspaceState): Promise<void>;
+export declare function evaluateBootstrapPhase(workspaceDir: string): Promise<BootstrapPhase>;
+export declare function markBootstrapSeeded(workspaceDir: string): Promise<void>;
+export declare function markSetupCompleted(workspaceDir: string): Promise<void>;
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/workspace/state.ts"],"names":[],"mappings":"AAiCA,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,YAAY,GAGZ,aAAa,GAIb,UAAU,CAAC;AAGf,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAsB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAUtF;AAED,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,IAAI,CAAC,CAmBf;AAKD,wBAAsB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAU1F;AAKD,wBAAsB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ7E;AAOD,wBAAsB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ5E"}

package/dist/workspace/state.js

@@ -0,0 +1,128 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { workspaceIdFromDir } from "../storage/facts-cache.js";
+import { tryGetRuntimeContext } from "../storage/runtime-context.js";
+import { enqueueWorkspaceMirrorOp } from "../storage/workspace-live-mirror.js";
+import { fileExists } from "./fs-utils.js";
+// Lifecycle markers for the agent's workspace.
+//
+// On a fresh onboard, brigade writes BOOTSTRAP.md as a one-shot greeting
+// hook. Without a marker file we'd have no way to tell whether the user is
+// running brigade for the first time (BOOTSTRAP.md should drive the
+// introduction) or the hundredth (BOOTSTRAP.md is leftover from onboard
+// and shouldn't keep rerunning the greeting).
+//
+// `<workspaceDir>/.brigade/workspace-state.json` carries two ISO-8601
+// timestamps that trace the bootstrap arc:
+//
+//   bootstrapSeededAt  — set when BOOTSTRAP.md was written (or on the
+//                        first onboard pass that *found* BOOTSTRAP.md
+//                        already present).
+//   setupCompletedAt   — set when the agent has consumed BOOTSTRAP.md
+//                        (file no longer exists) AND we previously saw
+//                        bootstrapSeededAt. Once set, further runs treat
+//                        the workspace as fully configured.
+const STATE_DIR = ".brigade";
+const STATE_FILE = "workspace-state.json";
+const STATE_VERSION = 1;
+const BOOTSTRAP_FILENAME = "BOOTSTRAP.md";
+// long-lived, no first-run hints injected.
+export function resolveWorkspaceStatePath(workspaceDir) {
+    return path.join(workspaceDir, STATE_DIR, STATE_FILE);
+}
+export async function readWorkspaceState(workspaceDir) {
+    const statePath = resolveWorkspaceStatePath(workspaceDir);
+    try {
+        const raw = await fs.readFile(statePath, "utf8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed?.version !== "number")
+            return { version: STATE_VERSION };
+        return parsed;
+    }
+    catch {
+        return { version: STATE_VERSION };
+    }
+}
+export async function writeWorkspaceState(workspaceDir, state) {
+    const statePath = resolveWorkspaceStatePath(workspaceDir);
+    await fs.mkdir(path.dirname(statePath), { recursive: true });
+    // PID + base36 timestamp in the tmp filename so two concurrent
+    // brigade processes (e.g. an interactive turn and a heartbeat tick)
+    // don't trip on each other's `.tmp` while one is mid-write. Without
+    // the suffix, both would write to `state.tmp` and the second renamer
+    // could rename a partial file written by the first.
+    const tmp = `${statePath}.tmp-${process.pid}-${Date.now().toString(36)}`;
+    try {
+        await fs.writeFile(tmp, `${JSON.stringify(state, null, 2)}\n`, "utf8");
+        await fs.rename(tmp, statePath);
+    }
+    catch (err) {
+        // Best-effort cleanup of the orphan tmp on any error before the
+        // rename — leaving stale `.tmp-…` files in the workspace would be
+        // visible noise on subsequent `ls` / git status.
+        await fs.rm(tmp, { force: true }).catch(() => undefined);
+        throw err;
+    }
+}
+// Decide which lifecycle bucket a workspace is in. Reads the state file +
+// probes BOOTSTRAP.md presence so a single call answers the assembler's
+// "should I inject first-run guidance?" question.
+export async function evaluateBootstrapPhase(workspaceDir) {
+    const state = await readWorkspaceState(workspaceDir);
+    const bootstrapPath = path.join(workspaceDir, BOOTSTRAP_FILENAME);
+    const bootstrapExists = await fileExists(bootstrapPath);
+    if (state.setupCompletedAt)
+        return "complete";
+    if (state.bootstrapSeededAt && bootstrapExists)
+        return "first-turn";
+    if (state.bootstrapSeededAt && !bootstrapExists)
+        return "complete";
+    if (!state.bootstrapSeededAt && bootstrapExists)
+        return "first-turn";
+    return "unseeded";
+}
+// Stamp `bootstrapSeededAt` if it isn't already set. Idempotent — safe to
+// call from bootstrap and from the agent kernel; whichever lands first
+// wins.
+export async function markBootstrapSeeded(workspaceDir) {
+    const state = await readWorkspaceState(workspaceDir);
+    if (state.bootstrapSeededAt)
+        return;
+    await writeWorkspaceState(workspaceDir, {
+        ...state,
+        bootstrapSeededAt: new Date().toISOString(),
+    });
+    mirrorLifecycleStamp(workspaceDir, "bootstrapSeeded");
+}
+// Stamp `setupCompletedAt` once BOOTSTRAP.md has been consumed. The agent
+// kernel calls this after a turn whose reply suggests the agent followed
+// the bootstrap script (typically the agent itself deletes BOOTSTRAP.md
+// at the end of its first reply, per the file's own instructions).
+// Idempotent.
+export async function markSetupCompleted(workspaceDir) {
+    const state = await readWorkspaceState(workspaceDir);
+    if (state.setupCompletedAt)
+        return;
+    await writeWorkspaceState(workspaceDir, {
+        ...state,
+        setupCompletedAt: new Date().toISOString(),
+    });
+    mirrorLifecycleStamp(workspaceDir, "setupCompleted");
+}
+// Convex mode: the lifecycle stamps used to reach the workspaceState table
+// only at the NEXT gateway boot (boot.ts mirror reconcile) — so a wipe in
+// between forgot that setup had completed and resurrected the first-run
+// flow. Dual-write the stamp onto the live-mirror flush chain immediately;
+// the disk file stays the local source of truth (workspace stays local by
+// design), Convex is the durable copy.
+function mirrorLifecycleStamp(workspaceDir, kind) {
+    const rctx = tryGetRuntimeContext();
+    if (rctx?.mode !== "convex")
+        return;
+    const store = rctx.store;
+    const agentId = workspaceIdFromDir(workspaceDir);
+    enqueueWorkspaceMirrorOp(() => kind === "bootstrapSeeded"
+        ? store.workspace.markBootstrapSeeded(agentId)
+        : store.workspace.markSetupCompleted(agentId));
+}
+//# sourceMappingURL=state.js.map

package/dist/workspace/state.js.map

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

package/dist/workspace/template-loader.d.ts

@@ -0,0 +1,15 @@
+export interface ResolveTemplateDirOptions {
+    cwd?: string;
+    argv1?: string;
+    moduleUrl?: string;
+}
+export declare function resolveWorkspaceTemplateDir(opts?: ResolveTemplateDirOptions): Promise<string>;
+export interface LoadedTemplate {
+    name: string;
+    content: string;
+    source: string;
+}
+export declare function loadWorkspaceTemplate(name: string): Promise<LoadedTemplate>;
+export declare function tryLoadWorkspaceTemplate(name: string): Promise<LoadedTemplate | undefined>;
+export declare function resetWorkspaceTemplateCache(): void;
+//# sourceMappingURL=template-loader.d.ts.map

package/dist/workspace/template-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-loader.d.ts","sourceRoot":"","sources":["../../src/workspace/template-loader.ts"],"names":[],"mappings":"AA8BA,MAAM,WAAW,yBAAyB;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,2BAA2B,CAC/C,IAAI,CAAC,EAAE,yBAAyB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAkCjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAuBjF;AA6BD,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAMrC;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAIlD"}

package/dist/workspace/template-loader.js

@@ -0,0 +1,214 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+// Lazy resolver + content cache for the persona-template directory shipped
+// alongside brigade. Templates live as plain markdown on disk so users (and
+// future tooling) can edit them without touching compiled code.
+//
+// Resolution order:
+//   1. <brigade-package-root>/templates/workspace/    — wins on installed copies
+//   2. <cwd>/templates/workspace/                     — wins when running from a clone
+//   3. baked fallback relative to this compiled module — safety net
+//
+// `cachedTemplateDir` short-circuits every subsequent call after the first
+// successful probe. `resolvingTemplateDir` ensures concurrent callers share
+// a single fs probe rather than racing.
+const FALLBACK_TEMPLATE_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../templates/workspace");
+let cachedTemplateDir;
+let resolvingTemplateDir;
+// Per-template promise cache. Keyed by filename so concurrent loads of the
+// same template share one fs hit. We cache the *promise* (not the resolved
+// value) so an in-flight read is awaited rather than restarted.
+const templateContentCache = new Map();
+export async function resolveWorkspaceTemplateDir(opts) {
+    if (cachedTemplateDir)
+        return cachedTemplateDir;
+    if (resolvingTemplateDir)
+        return resolvingTemplateDir;
+    resolvingTemplateDir = (async () => {
+        const moduleUrl = opts?.moduleUrl ?? import.meta.url;
+        const argv1 = opts?.argv1 ?? process.argv[1];
+        const cwd = opts?.cwd ?? process.cwd();
+        const packageRoot = await resolveBrigadePackageRoot({ moduleUrl, argv1, cwd });
+        const candidates = [];
+        if (packageRoot)
+            candidates.push(path.join(packageRoot, "templates", "workspace"));
+        if (cwd)
+            candidates.push(path.resolve(cwd, "templates", "workspace"));
+        candidates.push(FALLBACK_TEMPLATE_DIR);
+        for (const candidate of candidates) {
+            if (await pathExists(candidate)) {
+                cachedTemplateDir = candidate;
+                return candidate;
+            }
+        }
+        // No candidate resolved — first guess wins so error messages reference
+        // the most plausible install location.
+        cachedTemplateDir = candidates[0] ?? FALLBACK_TEMPLATE_DIR;
+        return cachedTemplateDir;
+    })();
+    // Don't clear `resolvingTemplateDir` after the await — the `cachedTemplateDir`
+    // short-circuit at the top of this function is what dedupes subsequent
+    // callers, and clearing the in-flight promise here was misleading rather
+    // than helpful (it suggested re-resolution after success, which would be
+    // wrong).
+    return resolvingTemplateDir;
+}
+// Returns the template content with any leading YAML frontmatter stripped.
+// Throws if the file is missing — callers that want soft-fail should use
+// tryLoadWorkspaceTemplate. Frontmatter strip matches the reference loader's
+// behavior so workspace seeding produces identical output bytes.
+export async function loadWorkspaceTemplate(name) {
+    const existing = templateContentCache.get(name);
+    if (existing) {
+        const dir = await resolveWorkspaceTemplateDir();
+        return { name, content: await existing, source: path.join(dir, name) };
+    }
+    const promise = (async () => {
+        const dir = await resolveWorkspaceTemplateDir();
+        const raw = await fs.readFile(path.join(dir, name), "utf8");
+        return stripFrontMatter(raw);
+    })();
+    templateContentCache.set(name, promise);
+    try {
+        const content = await promise;
+        const dir = await resolveWorkspaceTemplateDir();
+        return { name, content, source: path.join(dir, name) };
+    }
+    catch (err) {
+        templateContentCache.delete(name);
+        throw err;
+    }
+}
+// Strips a leading YAML frontmatter block (`---\n…\n---\n`) from a markdown
+// document. The frontmatter is metadata for tools that consume the source
+// templates and is not meant to land in the rendered workspace files.
+// Anything other than a frontmatter-starting `---` line at offset 0 is
+// returned unchanged.
+function stripFrontMatter(text) {
+    if (!text.startsWith("---"))
+        return text;
+    // Accept `---\n` or `---\r\n` as the opener.
+    const firstNewline = text.indexOf("\n");
+    if (firstNewline < 0)
+        return text;
+    const opener = text.slice(0, firstNewline).trim();
+    if (opener !== "---")
+        return text;
+    // Find the closing `---` on its own line. Use a multiline-aware search
+    // starting after the opener.
+    const closingPattern = /\r?\n---\s*(\r?\n|$)/;
+    const match = closingPattern.exec(text.slice(firstNewline));
+    if (!match || match.index === undefined)
+        return text;
+    // Skip past the closing newline so the returned content starts cleanly.
+    const closeStart = firstNewline + match.index + match[0].length;
+    return text.slice(closeStart);
+}
+// Soft-fail variant: returns undefined when the template is missing or
+// can't be read. Used by the onboard flow so a partially-customised
+// templates dir doesn't break workspace seeding.
+export async function tryLoadWorkspaceTemplate(name) {
+    try {
+        return await loadWorkspaceTemplate(name);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function resetWorkspaceTemplateCache() {
+    cachedTemplateDir = undefined;
+    resolvingTemplateDir = undefined;
+    templateContentCache.clear();
+}
+// Walks upwards from the candidate dirs looking for a package.json whose
+// `name` field equals "brigade". Bounded depth so a misconfigured cwd
+// can't burn cycles.
+//
+// Tries four entry points:
+//   1. dirname(moduleUrl) — wins when running from the installed package
+//   2. realpath(argv1) — handles nvm/Homebrew/pnpm bin shims that symlink
+//      `brigade` from a versioned cache; without realpath we'd walk up the
+//      shim's directory, never reaching the package root
+//   3. argv1 reconstructed from a `.bin/brigade` to `node_modules/brigade`
+//   4. cwd — last-resort fallback for misconfigured installs
+async function resolveBrigadePackageRoot(args) {
+    const moduleDir = path.dirname(fileURLToPath(args.moduleUrl));
+    const fromModule = await findPackageRoot(moduleDir);
+    if (fromModule)
+        return fromModule;
+    if (args.argv1) {
+        // Resolve symlinks first so nvm/Homebrew/pnpm bin shims point at the
+        // real package location instead of a cache dir that has no package.json.
+        const realArgv = await safeRealpath(args.argv1);
+        const argvDir = path.dirname(realArgv ?? path.resolve(args.argv1));
+        const fromArgv = await findPackageRoot(argvDir);
+        if (fromArgv)
+            return fromArgv;
+        // npm/pnpm install-time symlinks land at <prefix>/node_modules/.bin/brigade
+        // and the package itself lives at <prefix>/node_modules/brigade — try
+        // that reconstruction explicitly so the walk doesn't have to traverse
+        // through .bin/.
+        const reconstructed = reconstructFromBinDir(realArgv ?? args.argv1);
+        if (reconstructed) {
+            const fromReconstructed = await findPackageRoot(reconstructed);
+            if (fromReconstructed)
+                return fromReconstructed;
+        }
+    }
+    const fromCwd = await findPackageRoot(args.cwd);
+    if (fromCwd)
+        return fromCwd;
+    return undefined;
+}
+async function safeRealpath(p) {
+    try {
+        return await fs.realpath(path.resolve(p));
+    }
+    catch {
+        return undefined;
+    }
+}
+// Given a path like `<prefix>/node_modules/.bin/brigade`, return
+// `<prefix>/node_modules/brigade`. Returns undefined for paths that don't
+// match the .bin/ shape.
+function reconstructFromBinDir(argv1) {
+    const segments = path.resolve(argv1).split(path.sep);
+    const binIdx = segments.lastIndexOf(".bin");
+    if (binIdx < 1)
+        return undefined;
+    if (segments[binIdx - 1] !== "node_modules")
+        return undefined;
+    // Drop the trailing `.bin/<binname>` and append `brigade`.
+    return path.join(...segments.slice(0, binIdx), "brigade");
+}
+async function findPackageRoot(start) {
+    let cur = path.resolve(start);
+    for (let depth = 0; depth < 10; depth++) {
+        const pkgPath = path.join(cur, "package.json");
+        try {
+            const raw = await fs.readFile(pkgPath, "utf8");
+            const pkg = JSON.parse(raw);
+            if (pkg.name === "brigade")
+                return cur;
+        }
+        catch {
+            // Not a package.json, or not parseable, or doesn't match — keep walking.
+        }
+        const parent = path.dirname(cur);
+        if (parent === cur)
+            return undefined;
+        cur = parent;
+    }
+    return undefined;
+}
+async function pathExists(p) {
+    try {
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=template-loader.js.map

package/dist/workspace/template-loader.js.map

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