@ebay-dt/bonfire-context 0.1.0-alpha.4

package/dist/paths.js

@@ -0,0 +1,191 @@
+import { lstatSync } from "node:fs";
+import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+export const DEFAULT_PROTOTYPE_ROOT = join("src", "app", "(prototypes)");
+export const PROTOTYPE_METADATA_FILE = "metadata.json";
+const CONTEXT_DIRECTORY = "context";
+const ROOT_INSTRUCTIONS_FILE = "ROOT.md";
+const PROTOTYPE_INSTRUCTIONS_FILE = "PROTOTYPE.md";
+const MCP_FILE = "mcp.json";
+const SETTINGS_FILE = "settings.json";
+const SKILLS_DIRECTORY = "skills";
+export class ContextPathError extends Error {
+    path;
+    constructor(path, message) {
+        super(`Invalid context path at ${path}: ${message}`);
+        this.name = "ContextPathError";
+        this.path = path;
+    }
+}
+function requirePath(value, label) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new ContextPathError(label, "must be a nonempty path");
+    }
+    return value;
+}
+function resolveRepositoryRoot(value) {
+    return resolve(requirePath(value, "repositoryRoot"));
+}
+function resolveChildPath(root, value, label, defaultPath) {
+    const path = value === undefined ? defaultPath : requirePath(value, label);
+    return isAbsolute(path) ? resolve(path) : resolve(root, path);
+}
+function isContained(root, candidate, allowRoot = false) {
+    const pathFromRoot = relative(root, candidate);
+    return ((allowRoot && pathFromRoot.length === 0) ||
+        (pathFromRoot.length > 0 &&
+            pathFromRoot !== ".." &&
+            !pathFromRoot.startsWith(`..${sep}`) &&
+            !isAbsolute(pathFromRoot)));
+}
+function assertContained(root, candidate, label, allowRoot = false) {
+    if (!isContained(root, candidate, allowRoot)) {
+        throw new ContextPathError(label, `must be contained within ${root}`);
+    }
+}
+function assertDirectory(path, label, allowMissing) {
+    let stats;
+    try {
+        stats = lstatSync(path);
+    }
+    catch (error) {
+        if (allowMissing &&
+            error !== null &&
+            typeof error === "object" &&
+            "code" in error &&
+            error.code === "ENOENT") {
+            return;
+        }
+        throw new ContextPathError(label, "could not be inspected");
+    }
+    if (stats.isSymbolicLink()) {
+        throw new ContextPathError(label, "must not be a symbolic link");
+    }
+    if (!stats.isDirectory()) {
+        throw new ContextPathError(label, "must be a directory");
+    }
+}
+function assertNoSymlinkSegments(path, label) {
+    let current = path;
+    while (true) {
+        let stats;
+        try {
+            stats = lstatSync(current);
+        }
+        catch (error) {
+            if (error !== null &&
+                typeof error === "object" &&
+                "code" in error &&
+                error.code === "ENOENT") {
+                const parent = dirname(current);
+                if (parent === current)
+                    return;
+                current = parent;
+                continue;
+            }
+            throw new ContextPathError(label, "could not be inspected");
+        }
+        if (stats.isSymbolicLink()) {
+            throw new ContextPathError(label, "must not pass through a symbolic link");
+        }
+        return;
+    }
+}
+function assertSafeFilePath(path, label) {
+    assertNoSymlinkSegments(path, label);
+}
+export function assertSafeGeneratedPath(path, label) {
+    assertSafeFilePath(path, label);
+}
+function assertSafeDirectoryPath(path, label) {
+    assertNoSymlinkSegments(path, label);
+    assertDirectory(path, label, true);
+}
+function buildSources(contextRoot) {
+    return {
+        rootInstructions: join(contextRoot, ROOT_INSTRUCTIONS_FILE),
+        prototypeInstructions: join(contextRoot, PROTOTYPE_INSTRUCTIONS_FILE),
+        mcp: join(contextRoot, MCP_FILE),
+        settings: join(contextRoot, SETTINGS_FILE),
+        skills: join(contextRoot, SKILLS_DIRECTORY),
+    };
+}
+function buildRootOutputs(repositoryRoot) {
+    return {
+        agents: join(repositoryRoot, "AGENTS.md"),
+        claude: join(repositoryRoot, "CLAUDE.md"),
+        mcp: join(repositoryRoot, ".mcp.json"),
+        settings: join(repositoryRoot, ".claude", "settings.json"),
+        skills: join(repositoryRoot, ".claude", "skills"),
+    };
+}
+function buildPrototypeOutputs(prototypePath) {
+    return {
+        agents: join(prototypePath, "AGENTS.md"),
+        claude: join(prototypePath, "CLAUDE.md"),
+        settings: join(prototypePath, ".claude", "settings.json"),
+    };
+}
+export function resolveContextPaths(options) {
+    const repositoryRoot = resolveRepositoryRoot(options?.repositoryRoot);
+    const prototypeRoot = resolveChildPath(repositoryRoot, options?.prototypeRoot, "prototypeRoot", DEFAULT_PROTOTYPE_ROOT);
+    assertContained(repositoryRoot, prototypeRoot, "prototypeRoot");
+    const contextRoot = join(repositoryRoot, CONTEXT_DIRECTORY);
+    const sources = buildSources(contextRoot);
+    const rootOutputs = buildRootOutputs(repositoryRoot);
+    for (const [label, path] of Object.entries(sources)) {
+        assertContained(contextRoot, path, `sources.${label}`, true);
+    }
+    for (const [label, path] of Object.entries(rootOutputs)) {
+        assertContained(repositoryRoot, path, `rootOutputs.${label}`, true);
+    }
+    return {
+        repositoryRoot,
+        prototypeRoot,
+        contextRoot,
+        sources,
+        rootOutputs,
+    };
+}
+export function resolvePrototypeContextPaths(options) {
+    const paths = resolveContextPaths(options);
+    const prototypePath = resolveChildPath(paths.prototypeRoot, options?.prototypePath, "prototypePath", paths.prototypeRoot);
+    assertContained(paths.prototypeRoot, prototypePath, "prototypePath");
+    const prototypeMetadata = join(prototypePath, PROTOTYPE_METADATA_FILE);
+    return {
+        ...paths,
+        prototypePath,
+        prototypeMetadata,
+        prototypeOutputs: buildPrototypeOutputs(prototypePath),
+    };
+}
+/**
+ * Validate the filesystem boundaries before reading or writing context.
+ * Missing roots are allowed so callers can produce a useful source/filesystem
+ * error later, but existing roots, parents, and managed targets may not be
+ * symbolic links.
+ */
+export function assertSafeContextPaths(paths) {
+    assertSafeDirectoryPath(paths.repositoryRoot, "repositoryRoot");
+    assertSafeDirectoryPath(paths.prototypeRoot, "prototypeRoot");
+    assertSafeDirectoryPath(paths.contextRoot, "contextRoot");
+    for (const [label, path] of Object.entries(paths.sources)) {
+        assertSafeFilePath(path, `sources.${label}`);
+    }
+    for (const [label, path] of Object.entries(paths.rootOutputs)) {
+        if (label === "skills") {
+            assertSafeDirectoryPath(path, `rootOutputs.${label}`);
+        }
+        else {
+            assertSafeFilePath(path, `rootOutputs.${label}`);
+        }
+    }
+}
+export function assertSafePrototypeContextPaths(paths) {
+    assertSafeContextPaths(paths);
+    assertSafeDirectoryPath(paths.prototypePath, "prototypePath");
+    assertSafeFilePath(paths.prototypeMetadata, "prototypeMetadata");
+    for (const [label, path] of Object.entries(paths.prototypeOutputs)) {
+        assertSafeFilePath(path, `prototypeOutputs.${label}`);
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"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","sourcesContent":["import { lstatSync } from \"node:fs\";\nimport { dirname, isAbsolute, join, relative, resolve, sep } from \"node:path\";\n\nexport const DEFAULT_PROTOTYPE_ROOT = join(\"src\", \"app\", \"(prototypes)\");\nexport const PROTOTYPE_METADATA_FILE = \"metadata.json\";\n\nconst CONTEXT_DIRECTORY = \"context\";\nconst ROOT_INSTRUCTIONS_FILE = \"ROOT.md\";\nconst PROTOTYPE_INSTRUCTIONS_FILE = \"PROTOTYPE.md\";\nconst MCP_FILE = \"mcp.json\";\nconst SETTINGS_FILE = \"settings.json\";\nconst SKILLS_DIRECTORY = \"skills\";\n\nexport type ContextPathOptions = Readonly<{\n  repositoryRoot: string;\n  prototypeRoot?: string;\n}>;\n\nexport type PrototypeContextPathOptions = Readonly<{\n  repositoryRoot: string;\n  prototypeRoot?: string;\n  prototypePath: string;\n}>;\n\nexport type ContextSources = Readonly<{\n  rootInstructions: string;\n  prototypeInstructions: string;\n  mcp: string;\n  settings: string;\n  skills: string;\n}>;\n\nexport type RootContextOutputs = Readonly<{\n  agents: string;\n  claude: string;\n  mcp: string;\n  settings: string;\n  skills: string;\n}>;\n\nexport type PrototypeContextOutputs = Readonly<{\n  agents: string;\n  claude: string;\n  settings: string;\n}>;\n\nexport type ResolvedContextPaths = Readonly<{\n  repositoryRoot: string;\n  prototypeRoot: string;\n  contextRoot: string;\n  sources: ContextSources;\n  rootOutputs: RootContextOutputs;\n}>;\n\nexport type ResolvedPrototypeContextPaths = Readonly<\n  ResolvedContextPaths & {\n    prototypePath: string;\n    prototypeMetadata: string;\n    prototypeOutputs: PrototypeContextOutputs;\n  }\n>;\n\nexport class ContextPathError extends Error {\n  readonly path: string;\n\n  constructor(path: string, message: string) {\n    super(`Invalid context path at ${path}: ${message}`);\n    this.name = \"ContextPathError\";\n    this.path = path;\n  }\n}\n\nfunction requirePath(value: unknown, label: string) {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new ContextPathError(label, \"must be a nonempty path\");\n  }\n  return value;\n}\n\nfunction resolveRepositoryRoot(value: unknown) {\n  return resolve(requirePath(value, \"repositoryRoot\"));\n}\n\nfunction resolveChildPath(\n  root: string,\n  value: string | undefined,\n  label: string,\n  defaultPath: string,\n) {\n  const path = value === undefined ? defaultPath : requirePath(value, label);\n  return isAbsolute(path) ? resolve(path) : resolve(root, path);\n}\n\nfunction isContained(root: string, candidate: string, allowRoot = false) {\n  const pathFromRoot = relative(root, candidate);\n  return (\n    (allowRoot && pathFromRoot.length === 0) ||\n    (pathFromRoot.length > 0 &&\n      pathFromRoot !== \"..\" &&\n      !pathFromRoot.startsWith(`..${sep}`) &&\n      !isAbsolute(pathFromRoot))\n  );\n}\n\nfunction assertContained(\n  root: string,\n  candidate: string,\n  label: string,\n  allowRoot = false,\n) {\n  if (!isContained(root, candidate, allowRoot)) {\n    throw new ContextPathError(label, `must be contained within ${root}`);\n  }\n}\n\nfunction assertDirectory(path: string, label: string, allowMissing: boolean) {\n  let stats;\n  try {\n    stats = lstatSync(path);\n  } catch (error) {\n    if (\n      allowMissing &&\n      error !== null &&\n      typeof error === \"object\" &&\n      \"code\" in error &&\n      error.code === \"ENOENT\"\n    ) {\n      return;\n    }\n    throw new ContextPathError(label, \"could not be inspected\");\n  }\n\n  if (stats.isSymbolicLink()) {\n    throw new ContextPathError(label, \"must not be a symbolic link\");\n  }\n  if (!stats.isDirectory()) {\n    throw new ContextPathError(label, \"must be a directory\");\n  }\n}\n\nfunction assertNoSymlinkSegments(path: string, label: string) {\n  let current = path;\n  while (true) {\n    let stats;\n    try {\n      stats = lstatSync(current);\n    } catch (error) {\n      if (\n        error !== null &&\n        typeof error === \"object\" &&\n        \"code\" in error &&\n        error.code === \"ENOENT\"\n      ) {\n        const parent = dirname(current);\n        if (parent === current) return;\n        current = parent;\n        continue;\n      }\n      throw new ContextPathError(label, \"could not be inspected\");\n    }\n\n    if (stats.isSymbolicLink()) {\n      throw new ContextPathError(\n        label,\n        \"must not pass through a symbolic link\",\n      );\n    }\n    return;\n  }\n}\n\nfunction assertSafeFilePath(path: string, label: string) {\n  assertNoSymlinkSegments(path, label);\n}\n\nexport function assertSafeGeneratedPath(path: string, label: string) {\n  assertSafeFilePath(path, label);\n}\n\nfunction assertSafeDirectoryPath(path: string, label: string) {\n  assertNoSymlinkSegments(path, label);\n  assertDirectory(path, label, true);\n}\n\nfunction buildSources(contextRoot: string): ContextSources {\n  return {\n    rootInstructions: join(contextRoot, ROOT_INSTRUCTIONS_FILE),\n    prototypeInstructions: join(contextRoot, PROTOTYPE_INSTRUCTIONS_FILE),\n    mcp: join(contextRoot, MCP_FILE),\n    settings: join(contextRoot, SETTINGS_FILE),\n    skills: join(contextRoot, SKILLS_DIRECTORY),\n  };\n}\n\nfunction buildRootOutputs(repositoryRoot: string): RootContextOutputs {\n  return {\n    agents: join(repositoryRoot, \"AGENTS.md\"),\n    claude: join(repositoryRoot, \"CLAUDE.md\"),\n    mcp: join(repositoryRoot, \".mcp.json\"),\n    settings: join(repositoryRoot, \".claude\", \"settings.json\"),\n    skills: join(repositoryRoot, \".claude\", \"skills\"),\n  };\n}\n\nfunction buildPrototypeOutputs(prototypePath: string): PrototypeContextOutputs {\n  return {\n    agents: join(prototypePath, \"AGENTS.md\"),\n    claude: join(prototypePath, \"CLAUDE.md\"),\n    settings: join(prototypePath, \".claude\", \"settings.json\"),\n  };\n}\n\nexport function resolveContextPaths(\n  options: ContextPathOptions,\n): ResolvedContextPaths {\n  const repositoryRoot = resolveRepositoryRoot(options?.repositoryRoot);\n  const prototypeRoot = resolveChildPath(\n    repositoryRoot,\n    options?.prototypeRoot,\n    \"prototypeRoot\",\n    DEFAULT_PROTOTYPE_ROOT,\n  );\n  assertContained(repositoryRoot, prototypeRoot, \"prototypeRoot\");\n\n  const contextRoot = join(repositoryRoot, CONTEXT_DIRECTORY);\n  const sources = buildSources(contextRoot);\n  const rootOutputs = buildRootOutputs(repositoryRoot);\n\n  for (const [label, path] of Object.entries(sources)) {\n    assertContained(contextRoot, path, `sources.${label}`, true);\n  }\n  for (const [label, path] of Object.entries(rootOutputs)) {\n    assertContained(repositoryRoot, path, `rootOutputs.${label}`, true);\n  }\n\n  return {\n    repositoryRoot,\n    prototypeRoot,\n    contextRoot,\n    sources,\n    rootOutputs,\n  };\n}\n\nexport function resolvePrototypeContextPaths(\n  options: PrototypeContextPathOptions,\n): ResolvedPrototypeContextPaths {\n  const paths = resolveContextPaths(options);\n  const prototypePath = resolveChildPath(\n    paths.prototypeRoot,\n    options?.prototypePath,\n    \"prototypePath\",\n    paths.prototypeRoot,\n  );\n  assertContained(paths.prototypeRoot, prototypePath, \"prototypePath\");\n  const prototypeMetadata = join(prototypePath, PROTOTYPE_METADATA_FILE);\n\n  return {\n    ...paths,\n    prototypePath,\n    prototypeMetadata,\n    prototypeOutputs: buildPrototypeOutputs(prototypePath),\n  };\n}\n\n/**\n * Validate the filesystem boundaries before reading or writing context.\n * Missing roots are allowed so callers can produce a useful source/filesystem\n * error later, but existing roots, parents, and managed targets may not be\n * symbolic links.\n */\nexport function assertSafeContextPaths(paths: ResolvedContextPaths) {\n  assertSafeDirectoryPath(paths.repositoryRoot, \"repositoryRoot\");\n  assertSafeDirectoryPath(paths.prototypeRoot, \"prototypeRoot\");\n  assertSafeDirectoryPath(paths.contextRoot, \"contextRoot\");\n\n  for (const [label, path] of Object.entries(paths.sources)) {\n    assertSafeFilePath(path, `sources.${label}`);\n  }\n  for (const [label, path] of Object.entries(paths.rootOutputs)) {\n    if (label === \"skills\") {\n      assertSafeDirectoryPath(path, `rootOutputs.${label}`);\n    } else {\n      assertSafeFilePath(path, `rootOutputs.${label}`);\n    }\n  }\n}\n\nexport function assertSafePrototypeContextPaths(\n  paths: ResolvedPrototypeContextPaths,\n) {\n  assertSafeContextPaths(paths);\n  assertSafeDirectoryPath(paths.prototypePath, \"prototypePath\");\n  assertSafeFilePath(paths.prototypeMetadata, \"prototypeMetadata\");\n  for (const [label, path] of Object.entries(paths.prototypeOutputs)) {\n    assertSafeFilePath(path, `prototypeOutputs.${label}`);\n  }\n}\n"]}

package/dist/prototype-project.d.ts

@@ -0,0 +1,7 @@
+import type { ContextProjectionResult } from "./types.js";
+export type ProjectPrototypeContextOptions = Readonly<{
+    repositoryRoot: string;
+    prototypePath: string;
+}>;
+export declare function projectPrototypeContext(options: ProjectPrototypeContextOptions): Promise<ContextProjectionResult>;
+//# sourceMappingURL=prototype-project.d.ts.map

package/dist/prototype-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prototype-project.d.ts","sourceRoot":"","sources":["../src/prototype-project.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAI1D,MAAM,MAAM,8BAA8B,GAAG,QAAQ,CAAC;IACpD,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC,CAAC;AAaH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,uBAAuB,CAAC,CAgDlC","sourcesContent":["import { relative } from \"node:path\";\nimport {\n  assertSafePrototypeContextPaths,\n  resolvePrototypeContextPaths,\n  type ResolvedPrototypeContextPaths,\n} from \"./paths.js\";\nimport {\n  atomicWrite,\n  assertWritableTarget,\n  removeManagedFile,\n} from \"./internal/filesystem.js\";\nimport type { ContextProjectionResult } from \"./types.js\";\nimport { renderPrototypeMarkdown } from \"./render.js\";\nimport { renderOptionalSettings } from \"./template.js\";\n\nexport type ProjectPrototypeContextOptions = Readonly<{\n  repositoryRoot: string;\n  prototypePath: string;\n}>;\n\nasync function preflightTargets(paths: ResolvedPrototypeContextPaths) {\n  await Promise.all([\n    assertWritableTarget(paths.prototypeOutputs.agents, \"AGENTS.md\"),\n    assertWritableTarget(paths.prototypeOutputs.claude, \"CLAUDE.md\"),\n    assertWritableTarget(\n      paths.prototypeOutputs.settings,\n      \".claude/settings.json\",\n    ),\n  ]);\n}\n\nexport async function projectPrototypeContext(\n  options: ProjectPrototypeContextOptions,\n): Promise<ContextProjectionResult> {\n  const paths = resolvePrototypeContextPaths(options);\n  assertSafePrototypeContextPaths(paths);\n  await preflightTargets(paths);\n\n  const [markdown, settings] = await Promise.all([\n    renderPrototypeMarkdown(paths),\n    renderOptionalSettings(paths),\n  ]);\n\n  const written: string[] = [];\n  const removed: string[] = [];\n  await atomicWrite(\n    paths.prototypeOutputs.agents,\n    markdown.agents,\n    \"AGENTS.md\",\n  );\n  written.push(relative(paths.repositoryRoot, paths.prototypeOutputs.agents));\n  await atomicWrite(\n    paths.prototypeOutputs.claude,\n    markdown.claude,\n    \"CLAUDE.md\",\n  );\n  written.push(relative(paths.repositoryRoot, paths.prototypeOutputs.claude));\n\n  if (settings === undefined) {\n    if (\n      await removeManagedFile(\n        paths.prototypeOutputs.settings,\n        \".claude/settings.json\",\n      )\n    ) {\n      removed.push(\n        relative(paths.repositoryRoot, paths.prototypeOutputs.settings),\n      );\n    }\n  } else {\n    await atomicWrite(\n      paths.prototypeOutputs.settings,\n      settings,\n      \".claude/settings.json\",\n    );\n    written.push(\n      relative(paths.repositoryRoot, paths.prototypeOutputs.settings),\n    );\n  }\n\n  return { written, removed };\n}\n"]}

package/dist/prototype-project.js

@@ -0,0 +1,38 @@
+import { relative } from "node:path";
+import { assertSafePrototypeContextPaths, resolvePrototypeContextPaths, } from "./paths.js";
+import { atomicWrite, assertWritableTarget, removeManagedFile, } from "./internal/filesystem.js";
+import { renderPrototypeMarkdown } from "./render.js";
+import { renderOptionalSettings } from "./template.js";
+async function preflightTargets(paths) {
+    await Promise.all([
+        assertWritableTarget(paths.prototypeOutputs.agents, "AGENTS.md"),
+        assertWritableTarget(paths.prototypeOutputs.claude, "CLAUDE.md"),
+        assertWritableTarget(paths.prototypeOutputs.settings, ".claude/settings.json"),
+    ]);
+}
+export async function projectPrototypeContext(options) {
+    const paths = resolvePrototypeContextPaths(options);
+    assertSafePrototypeContextPaths(paths);
+    await preflightTargets(paths);
+    const [markdown, settings] = await Promise.all([
+        renderPrototypeMarkdown(paths),
+        renderOptionalSettings(paths),
+    ]);
+    const written = [];
+    const removed = [];
+    await atomicWrite(paths.prototypeOutputs.agents, markdown.agents, "AGENTS.md");
+    written.push(relative(paths.repositoryRoot, paths.prototypeOutputs.agents));
+    await atomicWrite(paths.prototypeOutputs.claude, markdown.claude, "CLAUDE.md");
+    written.push(relative(paths.repositoryRoot, paths.prototypeOutputs.claude));
+    if (settings === undefined) {
+        if (await removeManagedFile(paths.prototypeOutputs.settings, ".claude/settings.json")) {
+            removed.push(relative(paths.repositoryRoot, paths.prototypeOutputs.settings));
+        }
+    }
+    else {
+        await atomicWrite(paths.prototypeOutputs.settings, settings, ".claude/settings.json");
+        written.push(relative(paths.repositoryRoot, paths.prototypeOutputs.settings));
+    }
+    return { written, removed };
+}
+//# sourceMappingURL=prototype-project.js.map

package/dist/prototype-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prototype-project.js","sourceRoot":"","sources":["../src/prototype-project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EACL,+BAA+B,EAC/B,4BAA4B,GAE7B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAOvD,KAAK,UAAU,gBAAgB,CAAC,KAAoC;IAClE,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,oBAAoB,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC;QAChE,oBAAoB,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC;QAChE,oBAAoB,CAClB,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAC/B,uBAAuB,CACxB;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAuC;IAEvC,MAAM,KAAK,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;IACpD,+BAA+B,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAE9B,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC7C,uBAAuB,CAAC,KAAK,CAAC;QAC9B,sBAAsB,CAAC,KAAK,CAAC;KAC9B,CAAC,CAAC;IAEH,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,WAAW,CACf,KAAK,CAAC,gBAAgB,CAAC,MAAM,EAC7B,QAAQ,CAAC,MAAM,EACf,WAAW,CACZ,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5E,MAAM,WAAW,CACf,KAAK,CAAC,gBAAgB,CAAC,MAAM,EAC7B,QAAQ,CAAC,MAAM,EACf,WAAW,CACZ,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IAE5E,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,IACE,MAAM,iBAAiB,CACrB,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAC/B,uBAAuB,CACxB,EACD,CAAC;YACD,OAAO,CAAC,IAAI,CACV,QAAQ,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAChE,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,WAAW,CACf,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAC/B,QAAQ,EACR,uBAAuB,CACxB,CAAC;QACF,OAAO,CAAC,IAAI,CACV,QAAQ,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAChE,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC","sourcesContent":["import { relative } from \"node:path\";\nimport {\n  assertSafePrototypeContextPaths,\n  resolvePrototypeContextPaths,\n  type ResolvedPrototypeContextPaths,\n} from \"./paths.js\";\nimport {\n  atomicWrite,\n  assertWritableTarget,\n  removeManagedFile,\n} from \"./internal/filesystem.js\";\nimport type { ContextProjectionResult } from \"./types.js\";\nimport { renderPrototypeMarkdown } from \"./render.js\";\nimport { renderOptionalSettings } from \"./template.js\";\n\nexport type ProjectPrototypeContextOptions = Readonly<{\n  repositoryRoot: string;\n  prototypePath: string;\n}>;\n\nasync function preflightTargets(paths: ResolvedPrototypeContextPaths) {\n  await Promise.all([\n    assertWritableTarget(paths.prototypeOutputs.agents, \"AGENTS.md\"),\n    assertWritableTarget(paths.prototypeOutputs.claude, \"CLAUDE.md\"),\n    assertWritableTarget(\n      paths.prototypeOutputs.settings,\n      \".claude/settings.json\",\n    ),\n  ]);\n}\n\nexport async function projectPrototypeContext(\n  options: ProjectPrototypeContextOptions,\n): Promise<ContextProjectionResult> {\n  const paths = resolvePrototypeContextPaths(options);\n  assertSafePrototypeContextPaths(paths);\n  await preflightTargets(paths);\n\n  const [markdown, settings] = await Promise.all([\n    renderPrototypeMarkdown(paths),\n    renderOptionalSettings(paths),\n  ]);\n\n  const written: string[] = [];\n  const removed: string[] = [];\n  await atomicWrite(\n    paths.prototypeOutputs.agents,\n    markdown.agents,\n    \"AGENTS.md\",\n  );\n  written.push(relative(paths.repositoryRoot, paths.prototypeOutputs.agents));\n  await atomicWrite(\n    paths.prototypeOutputs.claude,\n    markdown.claude,\n    \"CLAUDE.md\",\n  );\n  written.push(relative(paths.repositoryRoot, paths.prototypeOutputs.claude));\n\n  if (settings === undefined) {\n    if (\n      await removeManagedFile(\n        paths.prototypeOutputs.settings,\n        \".claude/settings.json\",\n      )\n    ) {\n      removed.push(\n        relative(paths.repositoryRoot, paths.prototypeOutputs.settings),\n      );\n    }\n  } else {\n    await atomicWrite(\n      paths.prototypeOutputs.settings,\n      settings,\n      \".claude/settings.json\",\n    );\n    written.push(\n      relative(paths.repositoryRoot, paths.prototypeOutputs.settings),\n    );\n  }\n\n  return { written, removed };\n}\n"]}

package/dist/registry.d.ts

@@ -0,0 +1,36 @@
+export declare const CONTEXT_REGISTRY_SCHEMA_VERSION: 1;
+export declare const CONTEXT_REGISTRY_FILE = "registry.json";
+export type ContextRegistryLocationOptions = Readonly<{
+    homeDirectory?: string;
+}>;
+export type ContextRegistryPaths = Readonly<{
+    directory: string;
+    registry: string;
+}>;
+export type ContextRegistrySkill = Readonly<{
+    sourcePath: string;
+    contentHash: string;
+}>;
+export type ContextRegistryMcpServer = Readonly<{
+    sourcePath: string;
+    normalizedDefinitionHash: string;
+}>;
+export type ContextRegistryApp = Readonly<{
+    repositoryRoot: string;
+    skills: Readonly<Record<string, ContextRegistrySkill>>;
+    mcp: Readonly<Record<string, ContextRegistryMcpServer>>;
+}>;
+export type ContextRegistry = Readonly<{
+    schemaVersion: typeof CONTEXT_REGISTRY_SCHEMA_VERSION;
+    apps: Readonly<Record<string, ContextRegistryApp>>;
+}>;
+export declare class ContextRegistryError extends Error {
+    readonly path: string;
+    constructor(path: string, message: string);
+}
+export declare function validateContextAppId(value: unknown): string;
+export declare function createEmptyContextRegistry(): ContextRegistry;
+export declare function resolveContextRegistryPaths(options?: ContextRegistryLocationOptions): ContextRegistryPaths;
+export declare function readContextRegistry(options?: ContextRegistryLocationOptions): Promise<ContextRegistry>;
+export declare function writeContextRegistry(registry: ContextRegistry, options?: ContextRegistryLocationOptions): Promise<void>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,+BAA+B,EAAG,CAAU,CAAC;AAC1D,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AAKrD,MAAM,MAAM,8BAA8B,GAAG,QAAQ,CAAC;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB,EAAE,MAAM,CAAC;CAClC,CAAC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;IACvD,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAAC;CACzD,CAAC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,aAAa,EAAE,OAAO,+BAA+B,CAAC;IACtD,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;CACpD,CAAC,CAAC;AAEH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAIxC;CACF;AA4BD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,UAElD;AA8GD,wBAAgB,0BAA0B,IAAI,eAAe,CAK5D;AAED,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,8BAAmC,GAC3C,oBAAoB,CAItB;AA4BD,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,eAAe,CAAC,CAoB1B;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAuBf","sourcesContent":["import { chmod, lstat, mkdir, readFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { isAbsolute, join, resolve } from \"node:path\";\nimport { atomicWrite, isNotFound } from \"./internal/filesystem.js\";\n\nexport const CONTEXT_REGISTRY_SCHEMA_VERSION = 1 as const;\nexport const CONTEXT_REGISTRY_FILE = \"registry.json\";\n\nconst APP_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/u;\nconst SHA256_PATTERN = /^[a-f0-9]{64}$/u;\n\nexport type ContextRegistryLocationOptions = Readonly<{\n  homeDirectory?: string;\n}>;\n\nexport type ContextRegistryPaths = Readonly<{\n  directory: string;\n  registry: string;\n}>;\n\nexport type ContextRegistrySkill = Readonly<{\n  sourcePath: string;\n  contentHash: string;\n}>;\n\nexport type ContextRegistryMcpServer = Readonly<{\n  sourcePath: string;\n  normalizedDefinitionHash: string;\n}>;\n\nexport type ContextRegistryApp = Readonly<{\n  repositoryRoot: string;\n  skills: Readonly<Record<string, ContextRegistrySkill>>;\n  mcp: Readonly<Record<string, ContextRegistryMcpServer>>;\n}>;\n\nexport type ContextRegistry = Readonly<{\n  schemaVersion: typeof CONTEXT_REGISTRY_SCHEMA_VERSION;\n  apps: Readonly<Record<string, ContextRegistryApp>>;\n}>;\n\nexport class ContextRegistryError extends Error {\n  readonly path: string;\n\n  constructor(path: string, message: string) {\n    super(`Invalid context registry at ${path}: ${message}`);\n    this.name = \"ContextRegistryError\";\n    this.path = path;\n  }\n}\n\nfunction requireNonEmptyString(value: unknown, path: string) {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new ContextRegistryError(path, \"must be a nonempty string\");\n  }\n  return value;\n}\n\nfunction requireAbsolutePath(value: unknown, path: string) {\n  const result = requireNonEmptyString(value, path);\n  if (!isAbsolute(result)) {\n    throw new ContextRegistryError(path, \"must be an absolute path\");\n  }\n  return resolve(result);\n}\n\nfunction requireAppId(value: unknown, path: string) {\n  const appId = requireNonEmptyString(value, path);\n  if (!APP_ID_PATTERN.test(appId)) {\n    throw new ContextRegistryError(\n      path,\n      \"must contain only letters, numbers, dots, underscores, and hyphens\",\n    );\n  }\n  return appId;\n}\n\nexport function validateContextAppId(value: unknown) {\n  return requireAppId(value, \"appId\");\n}\n\nfunction requireHash(value: unknown, path: string) {\n  const hash = requireNonEmptyString(value, path);\n  if (!SHA256_PATTERN.test(hash)) {\n    throw new ContextRegistryError(path, \"must be a lowercase SHA-256 hash\");\n  }\n  return hash;\n}\n\nfunction requireRecord(value: unknown, path: string) {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    throw new ContextRegistryError(path, \"must be an object\");\n  }\n  return value as Record<string, unknown>;\n}\n\nfunction normalizeSkills(\n  value: unknown,\n  path: string,\n): Record<string, ContextRegistrySkill> {\n  const record = requireRecord(value, path);\n  return Object.fromEntries(\n    Object.entries(record)\n      .sort(([left], [right]) => left.localeCompare(right))\n      .map(([name, entry]) => {\n        const skillName = requireNonEmptyString(name, `${path}.${name}`);\n        const skill = requireRecord(entry, `${path}.${skillName}`);\n        return [\n          skillName,\n          {\n            sourcePath: requireAbsolutePath(\n              skill.sourcePath,\n              `${path}.${skillName}.sourcePath`,\n            ),\n            contentHash: requireHash(\n              skill.contentHash,\n              `${path}.${skillName}.contentHash`,\n            ),\n          },\n        ];\n      }),\n  );\n}\n\nfunction normalizeMcp(\n  value: unknown,\n  path: string,\n): Record<string, ContextRegistryMcpServer> {\n  const record = requireRecord(value, path);\n  return Object.fromEntries(\n    Object.entries(record)\n      .sort(([left], [right]) => left.localeCompare(right))\n      .map(([name, entry]) => {\n        const serverName = requireNonEmptyString(name, `${path}.${name}`);\n        const server = requireRecord(entry, `${path}.${serverName}`);\n        return [\n          serverName,\n          {\n            sourcePath: requireAbsolutePath(\n              server.sourcePath,\n              `${path}.${serverName}.sourcePath`,\n            ),\n            normalizedDefinitionHash: requireHash(\n              server.normalizedDefinitionHash,\n              `${path}.${serverName}.normalizedDefinitionHash`,\n            ),\n          },\n        ];\n      }),\n  );\n}\n\nfunction normalizeRegistry(value: unknown, path: string): ContextRegistry {\n  const registry = requireRecord(value, path);\n  if (registry.schemaVersion !== CONTEXT_REGISTRY_SCHEMA_VERSION) {\n    throw new ContextRegistryError(\n      `${path}.schemaVersion`,\n      `must be ${CONTEXT_REGISTRY_SCHEMA_VERSION}`,\n    );\n  }\n\n  const apps = requireRecord(registry.apps, `${path}.apps`);\n  return {\n    schemaVersion: CONTEXT_REGISTRY_SCHEMA_VERSION,\n    apps: Object.fromEntries(\n      Object.entries(apps)\n        .sort(([left], [right]) => left.localeCompare(right))\n        .map(([key, value]) => {\n          const appId = requireAppId(key, `${path}.apps`);\n          const app = requireRecord(value, `${path}.apps.${appId}`);\n          return [\n            appId,\n            {\n              repositoryRoot: requireAbsolutePath(\n                app.repositoryRoot,\n                `${path}.apps.${appId}.repositoryRoot`,\n              ),\n              skills: normalizeSkills(\n                app.skills,\n                `${path}.apps.${appId}.skills`,\n              ),\n              mcp: normalizeMcp(app.mcp, `${path}.apps.${appId}.mcp`),\n            },\n          ];\n        }),\n    ),\n  };\n}\n\nexport function createEmptyContextRegistry(): ContextRegistry {\n  return {\n    schemaVersion: CONTEXT_REGISTRY_SCHEMA_VERSION,\n    apps: {},\n  };\n}\n\nexport function resolveContextRegistryPaths(\n  options: ContextRegistryLocationOptions = {},\n): ContextRegistryPaths {\n  const homeDirectory = resolve(options.homeDirectory ?? homedir());\n  const directory = join(homeDirectory, \".bonfire\", \"context\");\n  return { directory, registry: join(directory, CONTEXT_REGISTRY_FILE) };\n}\n\nasync function assertRegistryDirectory(path: string, allowMissing: boolean) {\n  try {\n    const stats = await lstat(path);\n    if (stats.isSymbolicLink() || !stats.isDirectory()) {\n      throw new ContextRegistryError(path, \"must be a regular directory\");\n    }\n  } catch (error) {\n    if (error instanceof ContextRegistryError) throw error;\n    if (allowMissing && isNotFound(error)) return;\n    throw new ContextRegistryError(path, \"could not be inspected safely\");\n  }\n}\n\nasync function assertRegistryFile(path: string, allowMissing: boolean) {\n  try {\n    const stats = await lstat(path);\n    if (stats.isSymbolicLink() || !stats.isFile()) {\n      throw new ContextRegistryError(path, \"must be a regular file\");\n    }\n  } catch (error) {\n    if (error instanceof ContextRegistryError) throw error;\n    if (allowMissing && isNotFound(error)) return;\n    throw new ContextRegistryError(path, \"could not be inspected safely\");\n  }\n}\n\nexport async function readContextRegistry(\n  options: ContextRegistryLocationOptions = {},\n): Promise<ContextRegistry> {\n  const paths = resolveContextRegistryPaths(options);\n  await assertRegistryDirectory(paths.directory, true);\n  await assertRegistryFile(paths.registry, true);\n\n  let source: string;\n  try {\n    source = await readFile(paths.registry, \"utf8\");\n  } catch (error) {\n    if (isNotFound(error)) return createEmptyContextRegistry();\n    throw new ContextRegistryError(paths.registry, \"could not be read safely\");\n  }\n\n  let value: unknown;\n  try {\n    value = JSON.parse(source);\n  } catch {\n    throw new ContextRegistryError(paths.registry, \"must contain valid JSON\");\n  }\n  return normalizeRegistry(value, paths.registry);\n}\n\nexport async function writeContextRegistry(\n  registry: ContextRegistry,\n  options: ContextRegistryLocationOptions = {},\n): Promise<void> {\n  const paths = resolveContextRegistryPaths(options);\n  const normalized = normalizeRegistry(registry, paths.registry);\n\n  try {\n    await mkdir(paths.directory, { recursive: true, mode: 0o700 });\n    await assertRegistryDirectory(paths.directory, false);\n    await chmod(paths.directory, 0o700);\n    await atomicWrite(\n      paths.registry,\n      `${JSON.stringify(normalized, null, 2)}\\n`,\n      paths.registry,\n      0o600,\n    );\n    await assertRegistryFile(paths.registry, false);\n    await chmod(paths.registry, 0o600);\n  } catch (error) {\n    if (error instanceof ContextRegistryError) throw error;\n    throw new ContextRegistryError(\n      paths.registry,\n      \"could not be written safely\",\n    );\n  }\n}\n"]}

package/dist/registry.js

@@ -0,0 +1,189 @@
+import { chmod, lstat, mkdir, readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { isAbsolute, join, resolve } from "node:path";
+import { atomicWrite, isNotFound } from "./internal/filesystem.js";
+export const CONTEXT_REGISTRY_SCHEMA_VERSION = 1;
+export const CONTEXT_REGISTRY_FILE = "registry.json";
+const APP_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/u;
+const SHA256_PATTERN = /^[a-f0-9]{64}$/u;
+export class ContextRegistryError extends Error {
+    path;
+    constructor(path, message) {
+        super(`Invalid context registry at ${path}: ${message}`);
+        this.name = "ContextRegistryError";
+        this.path = path;
+    }
+}
+function requireNonEmptyString(value, path) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new ContextRegistryError(path, "must be a nonempty string");
+    }
+    return value;
+}
+function requireAbsolutePath(value, path) {
+    const result = requireNonEmptyString(value, path);
+    if (!isAbsolute(result)) {
+        throw new ContextRegistryError(path, "must be an absolute path");
+    }
+    return resolve(result);
+}
+function requireAppId(value, path) {
+    const appId = requireNonEmptyString(value, path);
+    if (!APP_ID_PATTERN.test(appId)) {
+        throw new ContextRegistryError(path, "must contain only letters, numbers, dots, underscores, and hyphens");
+    }
+    return appId;
+}
+export function validateContextAppId(value) {
+    return requireAppId(value, "appId");
+}
+function requireHash(value, path) {
+    const hash = requireNonEmptyString(value, path);
+    if (!SHA256_PATTERN.test(hash)) {
+        throw new ContextRegistryError(path, "must be a lowercase SHA-256 hash");
+    }
+    return hash;
+}
+function requireRecord(value, path) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new ContextRegistryError(path, "must be an object");
+    }
+    return value;
+}
+function normalizeSkills(value, path) {
+    const record = requireRecord(value, path);
+    return Object.fromEntries(Object.entries(record)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([name, entry]) => {
+        const skillName = requireNonEmptyString(name, `${path}.${name}`);
+        const skill = requireRecord(entry, `${path}.${skillName}`);
+        return [
+            skillName,
+            {
+                sourcePath: requireAbsolutePath(skill.sourcePath, `${path}.${skillName}.sourcePath`),
+                contentHash: requireHash(skill.contentHash, `${path}.${skillName}.contentHash`),
+            },
+        ];
+    }));
+}
+function normalizeMcp(value, path) {
+    const record = requireRecord(value, path);
+    return Object.fromEntries(Object.entries(record)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([name, entry]) => {
+        const serverName = requireNonEmptyString(name, `${path}.${name}`);
+        const server = requireRecord(entry, `${path}.${serverName}`);
+        return [
+            serverName,
+            {
+                sourcePath: requireAbsolutePath(server.sourcePath, `${path}.${serverName}.sourcePath`),
+                normalizedDefinitionHash: requireHash(server.normalizedDefinitionHash, `${path}.${serverName}.normalizedDefinitionHash`),
+            },
+        ];
+    }));
+}
+function normalizeRegistry(value, path) {
+    const registry = requireRecord(value, path);
+    if (registry.schemaVersion !== CONTEXT_REGISTRY_SCHEMA_VERSION) {
+        throw new ContextRegistryError(`${path}.schemaVersion`, `must be ${CONTEXT_REGISTRY_SCHEMA_VERSION}`);
+    }
+    const apps = requireRecord(registry.apps, `${path}.apps`);
+    return {
+        schemaVersion: CONTEXT_REGISTRY_SCHEMA_VERSION,
+        apps: Object.fromEntries(Object.entries(apps)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, value]) => {
+            const appId = requireAppId(key, `${path}.apps`);
+            const app = requireRecord(value, `${path}.apps.${appId}`);
+            return [
+                appId,
+                {
+                    repositoryRoot: requireAbsolutePath(app.repositoryRoot, `${path}.apps.${appId}.repositoryRoot`),
+                    skills: normalizeSkills(app.skills, `${path}.apps.${appId}.skills`),
+                    mcp: normalizeMcp(app.mcp, `${path}.apps.${appId}.mcp`),
+                },
+            ];
+        })),
+    };
+}
+export function createEmptyContextRegistry() {
+    return {
+        schemaVersion: CONTEXT_REGISTRY_SCHEMA_VERSION,
+        apps: {},
+    };
+}
+export function resolveContextRegistryPaths(options = {}) {
+    const homeDirectory = resolve(options.homeDirectory ?? homedir());
+    const directory = join(homeDirectory, ".bonfire", "context");
+    return { directory, registry: join(directory, CONTEXT_REGISTRY_FILE) };
+}
+async function assertRegistryDirectory(path, allowMissing) {
+    try {
+        const stats = await lstat(path);
+        if (stats.isSymbolicLink() || !stats.isDirectory()) {
+            throw new ContextRegistryError(path, "must be a regular directory");
+        }
+    }
+    catch (error) {
+        if (error instanceof ContextRegistryError)
+            throw error;
+        if (allowMissing && isNotFound(error))
+            return;
+        throw new ContextRegistryError(path, "could not be inspected safely");
+    }
+}
+async function assertRegistryFile(path, allowMissing) {
+    try {
+        const stats = await lstat(path);
+        if (stats.isSymbolicLink() || !stats.isFile()) {
+            throw new ContextRegistryError(path, "must be a regular file");
+        }
+    }
+    catch (error) {
+        if (error instanceof ContextRegistryError)
+            throw error;
+        if (allowMissing && isNotFound(error))
+            return;
+        throw new ContextRegistryError(path, "could not be inspected safely");
+    }
+}
+export async function readContextRegistry(options = {}) {
+    const paths = resolveContextRegistryPaths(options);
+    await assertRegistryDirectory(paths.directory, true);
+    await assertRegistryFile(paths.registry, true);
+    let source;
+    try {
+        source = await readFile(paths.registry, "utf8");
+    }
+    catch (error) {
+        if (isNotFound(error))
+            return createEmptyContextRegistry();
+        throw new ContextRegistryError(paths.registry, "could not be read safely");
+    }
+    let value;
+    try {
+        value = JSON.parse(source);
+    }
+    catch {
+        throw new ContextRegistryError(paths.registry, "must contain valid JSON");
+    }
+    return normalizeRegistry(value, paths.registry);
+}
+export async function writeContextRegistry(registry, options = {}) {
+    const paths = resolveContextRegistryPaths(options);
+    const normalized = normalizeRegistry(registry, paths.registry);
+    try {
+        await mkdir(paths.directory, { recursive: true, mode: 0o700 });
+        await assertRegistryDirectory(paths.directory, false);
+        await chmod(paths.directory, 0o700);
+        await atomicWrite(paths.registry, `${JSON.stringify(normalized, null, 2)}\n`, paths.registry, 0o600);
+        await assertRegistryFile(paths.registry, false);
+        await chmod(paths.registry, 0o600);
+    }
+    catch (error) {
+        if (error instanceof ContextRegistryError)
+            throw error;
+        throw new ContextRegistryError(paths.registry, "could not be written safely");
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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","sourcesContent":["import { chmod, lstat, mkdir, readFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { isAbsolute, join, resolve } from \"node:path\";\nimport { atomicWrite, isNotFound } from \"./internal/filesystem.js\";\n\nexport const CONTEXT_REGISTRY_SCHEMA_VERSION = 1 as const;\nexport const CONTEXT_REGISTRY_FILE = \"registry.json\";\n\nconst APP_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/u;\nconst SHA256_PATTERN = /^[a-f0-9]{64}$/u;\n\nexport type ContextRegistryLocationOptions = Readonly<{\n  homeDirectory?: string;\n}>;\n\nexport type ContextRegistryPaths = Readonly<{\n  directory: string;\n  registry: string;\n}>;\n\nexport type ContextRegistrySkill = Readonly<{\n  sourcePath: string;\n  contentHash: string;\n}>;\n\nexport type ContextRegistryMcpServer = Readonly<{\n  sourcePath: string;\n  normalizedDefinitionHash: string;\n}>;\n\nexport type ContextRegistryApp = Readonly<{\n  repositoryRoot: string;\n  skills: Readonly<Record<string, ContextRegistrySkill>>;\n  mcp: Readonly<Record<string, ContextRegistryMcpServer>>;\n}>;\n\nexport type ContextRegistry = Readonly<{\n  schemaVersion: typeof CONTEXT_REGISTRY_SCHEMA_VERSION;\n  apps: Readonly<Record<string, ContextRegistryApp>>;\n}>;\n\nexport class ContextRegistryError extends Error {\n  readonly path: string;\n\n  constructor(path: string, message: string) {\n    super(`Invalid context registry at ${path}: ${message}`);\n    this.name = \"ContextRegistryError\";\n    this.path = path;\n  }\n}\n\nfunction requireNonEmptyString(value: unknown, path: string) {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new ContextRegistryError(path, \"must be a nonempty string\");\n  }\n  return value;\n}\n\nfunction requireAbsolutePath(value: unknown, path: string) {\n  const result = requireNonEmptyString(value, path);\n  if (!isAbsolute(result)) {\n    throw new ContextRegistryError(path, \"must be an absolute path\");\n  }\n  return resolve(result);\n}\n\nfunction requireAppId(value: unknown, path: string) {\n  const appId = requireNonEmptyString(value, path);\n  if (!APP_ID_PATTERN.test(appId)) {\n    throw new ContextRegistryError(\n      path,\n      \"must contain only letters, numbers, dots, underscores, and hyphens\",\n    );\n  }\n  return appId;\n}\n\nexport function validateContextAppId(value: unknown) {\n  return requireAppId(value, \"appId\");\n}\n\nfunction requireHash(value: unknown, path: string) {\n  const hash = requireNonEmptyString(value, path);\n  if (!SHA256_PATTERN.test(hash)) {\n    throw new ContextRegistryError(path, \"must be a lowercase SHA-256 hash\");\n  }\n  return hash;\n}\n\nfunction requireRecord(value: unknown, path: string) {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    throw new ContextRegistryError(path, \"must be an object\");\n  }\n  return value as Record<string, unknown>;\n}\n\nfunction normalizeSkills(\n  value: unknown,\n  path: string,\n): Record<string, ContextRegistrySkill> {\n  const record = requireRecord(value, path);\n  return Object.fromEntries(\n    Object.entries(record)\n      .sort(([left], [right]) => left.localeCompare(right))\n      .map(([name, entry]) => {\n        const skillName = requireNonEmptyString(name, `${path}.${name}`);\n        const skill = requireRecord(entry, `${path}.${skillName}`);\n        return [\n          skillName,\n          {\n            sourcePath: requireAbsolutePath(\n              skill.sourcePath,\n              `${path}.${skillName}.sourcePath`,\n            ),\n            contentHash: requireHash(\n              skill.contentHash,\n              `${path}.${skillName}.contentHash`,\n            ),\n          },\n        ];\n      }),\n  );\n}\n\nfunction normalizeMcp(\n  value: unknown,\n  path: string,\n): Record<string, ContextRegistryMcpServer> {\n  const record = requireRecord(value, path);\n  return Object.fromEntries(\n    Object.entries(record)\n      .sort(([left], [right]) => left.localeCompare(right))\n      .map(([name, entry]) => {\n        const serverName = requireNonEmptyString(name, `${path}.${name}`);\n        const server = requireRecord(entry, `${path}.${serverName}`);\n        return [\n          serverName,\n          {\n            sourcePath: requireAbsolutePath(\n              server.sourcePath,\n              `${path}.${serverName}.sourcePath`,\n            ),\n            normalizedDefinitionHash: requireHash(\n              server.normalizedDefinitionHash,\n              `${path}.${serverName}.normalizedDefinitionHash`,\n            ),\n          },\n        ];\n      }),\n  );\n}\n\nfunction normalizeRegistry(value: unknown, path: string): ContextRegistry {\n  const registry = requireRecord(value, path);\n  if (registry.schemaVersion !== CONTEXT_REGISTRY_SCHEMA_VERSION) {\n    throw new ContextRegistryError(\n      `${path}.schemaVersion`,\n      `must be ${CONTEXT_REGISTRY_SCHEMA_VERSION}`,\n    );\n  }\n\n  const apps = requireRecord(registry.apps, `${path}.apps`);\n  return {\n    schemaVersion: CONTEXT_REGISTRY_SCHEMA_VERSION,\n    apps: Object.fromEntries(\n      Object.entries(apps)\n        .sort(([left], [right]) => left.localeCompare(right))\n        .map(([key, value]) => {\n          const appId = requireAppId(key, `${path}.apps`);\n          const app = requireRecord(value, `${path}.apps.${appId}`);\n          return [\n            appId,\n            {\n              repositoryRoot: requireAbsolutePath(\n                app.repositoryRoot,\n                `${path}.apps.${appId}.repositoryRoot`,\n              ),\n              skills: normalizeSkills(\n                app.skills,\n                `${path}.apps.${appId}.skills`,\n              ),\n              mcp: normalizeMcp(app.mcp, `${path}.apps.${appId}.mcp`),\n            },\n          ];\n        }),\n    ),\n  };\n}\n\nexport function createEmptyContextRegistry(): ContextRegistry {\n  return {\n    schemaVersion: CONTEXT_REGISTRY_SCHEMA_VERSION,\n    apps: {},\n  };\n}\n\nexport function resolveContextRegistryPaths(\n  options: ContextRegistryLocationOptions = {},\n): ContextRegistryPaths {\n  const homeDirectory = resolve(options.homeDirectory ?? homedir());\n  const directory = join(homeDirectory, \".bonfire\", \"context\");\n  return { directory, registry: join(directory, CONTEXT_REGISTRY_FILE) };\n}\n\nasync function assertRegistryDirectory(path: string, allowMissing: boolean) {\n  try {\n    const stats = await lstat(path);\n    if (stats.isSymbolicLink() || !stats.isDirectory()) {\n      throw new ContextRegistryError(path, \"must be a regular directory\");\n    }\n  } catch (error) {\n    if (error instanceof ContextRegistryError) throw error;\n    if (allowMissing && isNotFound(error)) return;\n    throw new ContextRegistryError(path, \"could not be inspected safely\");\n  }\n}\n\nasync function assertRegistryFile(path: string, allowMissing: boolean) {\n  try {\n    const stats = await lstat(path);\n    if (stats.isSymbolicLink() || !stats.isFile()) {\n      throw new ContextRegistryError(path, \"must be a regular file\");\n    }\n  } catch (error) {\n    if (error instanceof ContextRegistryError) throw error;\n    if (allowMissing && isNotFound(error)) return;\n    throw new ContextRegistryError(path, \"could not be inspected safely\");\n  }\n}\n\nexport async function readContextRegistry(\n  options: ContextRegistryLocationOptions = {},\n): Promise<ContextRegistry> {\n  const paths = resolveContextRegistryPaths(options);\n  await assertRegistryDirectory(paths.directory, true);\n  await assertRegistryFile(paths.registry, true);\n\n  let source: string;\n  try {\n    source = await readFile(paths.registry, \"utf8\");\n  } catch (error) {\n    if (isNotFound(error)) return createEmptyContextRegistry();\n    throw new ContextRegistryError(paths.registry, \"could not be read safely\");\n  }\n\n  let value: unknown;\n  try {\n    value = JSON.parse(source);\n  } catch {\n    throw new ContextRegistryError(paths.registry, \"must contain valid JSON\");\n  }\n  return normalizeRegistry(value, paths.registry);\n}\n\nexport async function writeContextRegistry(\n  registry: ContextRegistry,\n  options: ContextRegistryLocationOptions = {},\n): Promise<void> {\n  const paths = resolveContextRegistryPaths(options);\n  const normalized = normalizeRegistry(registry, paths.registry);\n\n  try {\n    await mkdir(paths.directory, { recursive: true, mode: 0o700 });\n    await assertRegistryDirectory(paths.directory, false);\n    await chmod(paths.directory, 0o700);\n    await atomicWrite(\n      paths.registry,\n      `${JSON.stringify(normalized, null, 2)}\\n`,\n      paths.registry,\n      0o600,\n    );\n    await assertRegistryFile(paths.registry, false);\n    await chmod(paths.registry, 0o600);\n  } catch (error) {\n    if (error instanceof ContextRegistryError) throw error;\n    throw new ContextRegistryError(\n      paths.registry,\n      \"could not be written safely\",\n    );\n  }\n}\n"]}

package/dist/render.d.ts

@@ -0,0 +1,15 @@
+import { type ResolvedContextPaths, type ResolvedPrototypeContextPaths } from "./paths.js";
+export declare const GENERATED_CLAUDE_CONTENT = "<!--\n  This file is generated. Do not edit it directly.\n-->\n\n@AGENTS.md\n";
+export type MarkdownProjection = Readonly<{
+    agents: string;
+    claude: string;
+}>;
+export declare class ContextRenderError extends Error {
+    readonly source: string;
+    constructor(source: string, message: string);
+}
+export declare function renderMarkdownSource(source: string, sourceLabel: string): string;
+export declare function renderClaudeBridge(): string;
+export declare function renderRootMarkdown(paths: ResolvedContextPaths): Promise<MarkdownProjection>;
+export declare function renderPrototypeMarkdown(paths: ResolvedPrototypeContextPaths): Promise<MarkdownProjection>;
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,6BAA6B,EACnC,MAAM,YAAY,CAAC;AAKpB,eAAO,MAAM,wBAAwB,kFAKpC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YAAY,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAI1C;CACF;AAeD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,UAEvE;AAED,wBAAgB,kBAAkB,WAEjC;AAiBD,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAW7B;AAED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,kBAAkB,CAAC,CAW7B","sourcesContent":["import { lstat, readFile } from \"node:fs/promises\";\nimport {\n  assertSafeContextPaths,\n  assertSafePrototypeContextPaths,\n  type ResolvedContextPaths,\n  type ResolvedPrototypeContextPaths,\n} from \"./paths.js\";\n\nconst ROOT_SOURCE_LABEL = \"context/ROOT.md\";\nconst PROTOTYPE_SOURCE_LABEL = \"context/PROTOTYPE.md\";\n\nexport const GENERATED_CLAUDE_CONTENT = `<!--\n  This file is generated. Do not edit it directly.\n-->\n\n@AGENTS.md\n`;\n\nexport type MarkdownProjection = Readonly<{\n  agents: string;\n  claude: string;\n}>;\n\nexport class ContextRenderError extends Error {\n  readonly source: string;\n\n  constructor(source: string, message: string) {\n    super(`Unable to render ${source}: ${message}`);\n    this.name = \"ContextRenderError\";\n    this.source = source;\n  }\n}\n\nfunction generatedNotice(source: string) {\n  return `<!--\n  This file is generated from ${source}.\n  Do not edit it directly. Run \\`bonfire context sync\\` after changing the source.\n-->\n\n`;\n}\n\nfunction ensureFinalNewline(source: string) {\n  return source.endsWith(\"\\n\") ? source : `${source}\\n`;\n}\n\nexport function renderMarkdownSource(source: string, sourceLabel: string) {\n  return `${generatedNotice(sourceLabel)}${ensureFinalNewline(source)}`;\n}\n\nexport function renderClaudeBridge() {\n  return GENERATED_CLAUDE_CONTENT;\n}\n\nasync function readRequiredMarkdown(path: string, sourceLabel: string) {\n  try {\n    const stats = await lstat(path);\n    if (!stats.isFile() || stats.isSymbolicLink()) {\n      throw new Error(\"not a regular file\");\n    }\n    return await readFile(path, \"utf8\");\n  } catch {\n    throw new ContextRenderError(\n      sourceLabel,\n      \"the required source is missing or unreadable\",\n    );\n  }\n}\n\nexport async function renderRootMarkdown(\n  paths: ResolvedContextPaths,\n): Promise<MarkdownProjection> {\n  assertSafeContextPaths(paths);\n  const source = await readRequiredMarkdown(\n    paths.sources.rootInstructions,\n    ROOT_SOURCE_LABEL,\n  );\n\n  return {\n    agents: renderMarkdownSource(source, ROOT_SOURCE_LABEL),\n    claude: renderClaudeBridge(),\n  };\n}\n\nexport async function renderPrototypeMarkdown(\n  paths: ResolvedPrototypeContextPaths,\n): Promise<MarkdownProjection> {\n  assertSafePrototypeContextPaths(paths);\n  const source = await readRequiredMarkdown(\n    paths.sources.prototypeInstructions,\n    PROTOTYPE_SOURCE_LABEL,\n  );\n\n  return {\n    agents: renderMarkdownSource(source, PROTOTYPE_SOURCE_LABEL),\n    claude: renderClaudeBridge(),\n  };\n}\n"]}