benjamin-docs 0.1.0

package/dist/src/init.js.map

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

package/dist/src/next.d.ts

@@ -0,0 +1,2 @@
+export declare function getNextPrompt(root: string): string;
+export declare function formatNextMessage(prompt: string): string;

package/dist/src/next.js

@@ -0,0 +1,65 @@
+import { CONFIG_DIR, MANIFEST_FILE } from "./constants.js";
+import { readGeneratedJson } from "./fsx.js";
+import { readConfig } from "./project-config.js";
+const METADATA_LABEL = "Metadata path";
+export function getNextPrompt(root) {
+    const config = readConfig(root);
+    const manifest = readGeneratedJson(root, `${CONFIG_DIR}/${MANIFEST_FILE}`, METADATA_LABEL);
+    const docsRoot = config.docsRoot;
+    if (config.focus === "feature") {
+        const feature = config.feature ?? findLatestFeature(manifest, docsRoot);
+        if (feature)
+            return featurePrompt(docsRoot, feature, config.mode === "codebase");
+    }
+    if (config.focus === "codebase" || config.mode === "codebase") {
+        return codebasePrompt(docsRoot);
+    }
+    return planningPrompt(docsRoot);
+}
+export function formatNextMessage(prompt) {
+    return ["Next, ask your agent:", "", prompt].join("\n");
+}
+function planningPrompt(docsRoot) {
+    return [
+        "Capture the current project plan with benjamin-docs.",
+        `Update ${docsRoot}/project/brief.md, ${docsRoot}/project/roadmap.md,`,
+        `${docsRoot}/project/open-questions.md, and ${docsRoot}/handoff/agent-brief.md.`,
+        "Use plain language. Summarize decisions, rejected options, risks, and next steps.",
+        "Mark uncertain items clearly.",
+    ].join("\n");
+}
+function codebasePrompt(docsRoot) {
+    return [
+        "Capture the current project baseline with benjamin-docs.",
+        "Read the existing codebase and any existing docs as context. Then update",
+        `${docsRoot}/project/brief.md, ${docsRoot}/project/roadmap.md,`,
+        `${docsRoot}/project/open-questions.md, ${docsRoot}/engineering/architecture.md,`,
+        `${docsRoot}/engineering/code-map.md, and ${docsRoot}/handoff/agent-brief.md.`,
+        "Keep project docs understandable for non-technical readers.",
+        "Mark uncertain items, call out risks, and add useful code anchors where relevant.",
+    ].join("\n");
+}
+function featurePrompt(docsRoot, feature, codebaseMode) {
+    const codebaseInstruction = codebaseMode
+        ? "First read the existing codebase and Benjamin docs."
+        : "First read the current Benjamin docs and any planning notes.";
+    return [
+        `Capture the ${feature} feature with benjamin-docs.`,
+        codebaseInstruction,
+        `Then update ${docsRoot}/project/roadmap.md, ${docsRoot}/project/open-questions.md,`,
+        `${docsRoot}/handoff/agent-brief.md, and the feature docs under`,
+        `${docsRoot}/features/${feature}/.`,
+        "Include decisions, rejected options, risks, implementation notes, and next steps.",
+        "Keep the brief and handoff understandable for non-technical readers.",
+        "Mark uncertain items clearly.",
+    ].join("\n");
+}
+function findLatestFeature(manifest, docsRoot) {
+    const prefix = `${docsRoot}/features/`;
+    const featurePaths = manifest.docs.filter((doc) => doc.startsWith(prefix) && doc !== `${docsRoot}/features/index.md`);
+    const latest = featurePaths.at(-1);
+    if (!latest)
+        return undefined;
+    return latest.slice(prefix.length).split("/", 1)[0];
+}
+//# sourceMappingURL=next.js.map

package/dist/src/next.js.map

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

package/dist/src/project-config.d.ts

@@ -0,0 +1,6 @@
+import type { BenjaminDocsConfig } from "./types.js";
+export declare function defaultConfig(overrides?: Partial<BenjaminDocsConfig>): BenjaminDocsConfig;
+export declare function readConfig(root: string): BenjaminDocsConfig;
+export declare function normalizeConfig(config: BenjaminDocsConfig): BenjaminDocsConfig;
+export declare function assertSafeDocsRoot(docsRoot: string): void;
+export declare function isSafeDocsRoot(docsRoot: string): boolean;

package/dist/src/project-config.js

@@ -0,0 +1,41 @@
+import { isAbsolute, win32 } from "node:path";
+import { CONFIG_DIR, CONFIG_FILE, DEFAULT_DOCS_ROOT } from "./constants.js";
+import { readGeneratedJson } from "./fsx.js";
+const METADATA_LABEL = "Metadata path";
+export function defaultConfig(overrides = {}) {
+    return {
+        version: 1,
+        mode: "planning",
+        docsRoot: DEFAULT_DOCS_ROOT,
+        focus: "project",
+        ...overrides,
+    };
+}
+export function readConfig(root) {
+    return normalizeConfig(readGeneratedJson(root, `${CONFIG_DIR}/${CONFIG_FILE}`, METADATA_LABEL));
+}
+export function normalizeConfig(config) {
+    return {
+        version: config.version,
+        mode: config.mode,
+        docsRoot: config.docsRoot ?? DEFAULT_DOCS_ROOT,
+        focus: config.focus ?? defaultFocusForMode(config.mode),
+        feature: config.feature,
+    };
+}
+export function assertSafeDocsRoot(docsRoot) {
+    if (!isSafeDocsRoot(docsRoot)) {
+        throw new Error(`Invalid docs root: ${docsRoot}`);
+    }
+}
+export function isSafeDocsRoot(docsRoot) {
+    return (Boolean(docsRoot) &&
+        !docsRoot.includes("\\") &&
+        !isAbsolute(docsRoot) &&
+        !win32.isAbsolute(docsRoot) &&
+        !docsRoot.split("/").some((part) => part === "" || part === "." || part === ".."));
+}
+function defaultFocusForMode(mode) {
+    return mode === "codebase" ? "codebase" : "project";
+}
+//# sourceMappingURL=project-config.js.map

package/dist/src/project-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-config.js","sourceRoot":"","sources":["../../src/project-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG7C,MAAM,cAAc,GAAG,eAAe,CAAC;AAEvC,MAAM,UAAU,aAAa,CAAC,YAAyC,EAAE;IACvE,OAAO;QACL,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,iBAAiB;QAC3B,KAAK,EAAE,SAAS;QAChB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,eAAe,CAAC,iBAAiB,CAAqB,IAAI,EAAE,GAAG,UAAU,IAAI,WAAW,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;AACtH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAA0B;IACxD,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,iBAAiB;QAC9C,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC;QACvD,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,EAAE,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,OAAO,CACL,OAAO,CAAC,QAAQ,CAAC;QACjB,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;QACxB,CAAC,UAAU,CAAC,QAAQ,CAAC;QACrB,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;QAC3B,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC,CAClF,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAgC;IAC3D,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC"}

package/dist/src/scopes.d.ts

@@ -0,0 +1 @@
+export declare function createScope(root: string, kind: string, id: string): string[];

package/dist/src/scopes.js

@@ -0,0 +1,52 @@
+import { CONFIG_DIR, MANIFEST_FILE, SCOPES_FILE } from "./constants.js";
+import { readGeneratedJson, writeGeneratedJson, writeGeneratedTextIfMissing } from "./fsx.js";
+import { readConfig } from "./project-config.js";
+import { featureDocs } from "./templates.js";
+const SLUG_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const METADATA_LABEL = "Metadata path";
+export function createScope(root, kind, id) {
+    if (kind !== "feature") {
+        throw new Error("V1 scope creation supports feature scopes");
+    }
+    if (!SLUG_PATTERN.test(id)) {
+        throw new Error(`Invalid feature slug: ${id}`);
+    }
+    const scopesPath = `${CONFIG_DIR}/${SCOPES_FILE}`;
+    const scopes = readGeneratedJson(root, scopesPath, METADATA_LABEL);
+    const manifestPath = `${CONFIG_DIR}/${MANIFEST_FILE}`;
+    const manifest = readGeneratedJson(root, manifestPath, METADATA_LABEL);
+    const config = readConfig(root);
+    if (scopes.scopes.some((scope) => scope.id === id)) {
+        throw new Error(`Scope already exists: ${id}`);
+    }
+    const written = [];
+    const docs = featureDocs(id, config.docsRoot);
+    for (const file of docs) {
+        if (writeGeneratedTextIfMissing(root, file.path, file.content)) {
+            written.push(file.path);
+        }
+    }
+    const record = {
+        id,
+        kind: "feature",
+        title: titleFromSlug(id),
+        path: `${config.docsRoot}/features/${id}`,
+        status: "draft",
+    };
+    scopes.scopes.push(record);
+    writeGeneratedJson(root, scopesPath, scopes, METADATA_LABEL);
+    for (const file of docs) {
+        if (!manifest.docs.includes(file.path))
+            manifest.docs.push(file.path);
+    }
+    writeGeneratedJson(root, manifestPath, manifest, METADATA_LABEL);
+    return written;
+}
+function titleFromSlug(slug) {
+    return slug
+        .split("-")
+        .filter(Boolean)
+        .map((part) => `${part.slice(0, 1).toUpperCase()}${part.slice(1)}`)
+        .join(" ");
+}
+//# sourceMappingURL=scopes.js.map

package/dist/src/scopes.js.map

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

package/dist/src/status.d.ts

@@ -0,0 +1 @@
+export declare function getStatus(root: string): string;

package/dist/src/status.js

@@ -0,0 +1,38 @@
+import { existsSync } from "node:fs";
+import { CONFIG_DIR, CONFIG_FILE, MANIFEST_FILE, SCOPES_FILE } from "./constants.js";
+import { readJson, rootPath } from "./fsx.js";
+import { normalizeConfig } from "./project-config.js";
+export function getStatus(root) {
+    const configPath = rootPath(root, CONFIG_DIR, CONFIG_FILE);
+    const manifestPath = rootPath(root, CONFIG_DIR, MANIFEST_FILE);
+    const scopesPath = rootPath(root, CONFIG_DIR, SCOPES_FILE);
+    if (!existsSync(configPath) || !existsSync(manifestPath) || !existsSync(scopesPath)) {
+        throw new Error("benjamin-docs is not initialized. Run benjamin-docs init first.");
+    }
+    let config;
+    let manifest;
+    let scopes;
+    try {
+        config = normalizeConfig(readJson(configPath));
+        manifest = readJson(manifestPath);
+        scopes = readJson(scopesPath);
+    }
+    catch (error) {
+        throw new Error(`Cannot read benjamin-docs status metadata: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if ((config.mode !== "planning" && config.mode !== "codebase") ||
+        typeof config.docsRoot !== "string" ||
+        !Array.isArray(manifest.docs) ||
+        !Array.isArray(scopes.scopes)) {
+        throw new Error("Cannot read benjamin-docs status metadata: expected config, manifest, and scopes metadata.");
+    }
+    return [
+        "benjamin-docs status",
+        `mode: ${config.mode}`,
+        `focus: ${config.focus}`,
+        `docsRoot: ${config.docsRoot}`,
+        `docs: ${manifest.docs.length}`,
+        `scopes: ${scopes.scopes.length}`,
+    ].join("\n");
+}
+//# sourceMappingURL=status.js.map

package/dist/src/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAE3D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpF,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IAED,IAAI,MAA0B,CAAC;IAC/B,IAAI,QAAsB,CAAC;IAC3B,IAAI,MAAkB,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAqB,UAAU,CAAC,CAAC,CAAC;QACnE,QAAQ,GAAG,QAAQ,CAAe,YAAY,CAAC,CAAC;QAChD,MAAM,GAAG,QAAQ,CAAa,UAAU,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,8CAA8C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1H,CAAC;IAED,IACE,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC;QAC1D,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;QACnC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC7B,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAC7B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,4FAA4F,CAAC,CAAC;IAChH,CAAC;IAED,OAAO;QACL,sBAAsB;QACtB,SAAS,MAAM,CAAC,IAAI,EAAE;QACtB,UAAU,MAAM,CAAC,KAAK,EAAE;QACxB,aAAa,MAAM,CAAC,QAAQ,EAAE;QAC9B,SAAS,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE;QAC/B,WAAW,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE;KAClC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/src/templates.d.ts

@@ -0,0 +1,19 @@
+import type { DocFrontmatter } from "./types.js";
+export declare function today(): string;
+export declare function doc(title: string, scope: DocFrontmatter["scope"], scopeId: string, audience: DocFrontmatter["audience"], body: string): string;
+export declare function workspaceDocs(docsRoot: string): Array<{
+    path: string;
+    content: string;
+}>;
+export declare const starterDocs: Array<{
+    path: string;
+    content: string;
+}>;
+export declare function codebaseDocs(docsRoot: string): Array<{
+    path: string;
+    content: string;
+}>;
+export declare function featureDocs(slug: string, docsRoot?: string): Array<{
+    path: string;
+    content: string;
+}>;

package/dist/src/templates.js

@@ -0,0 +1,82 @@
+import { DEFAULT_DOCS_ROOT } from "./constants.js";
+import { serializeMarkdown } from "./frontmatter.js";
+export function today() {
+    return new Date().toISOString().slice(0, 10);
+}
+export function doc(title, scope, scopeId, audience, body) {
+    return serializeMarkdown({
+        title,
+        scope,
+        scope_id: scopeId,
+        audience,
+        status: "draft",
+        visibility: "private",
+        updated: today(),
+        source: "manual",
+    }, body);
+}
+export function workspaceDocs(docsRoot) {
+    return [
+        {
+            path: `${docsRoot}/project/brief.md`,
+            content: doc("Project Brief", "project", "project", ["developer", "designer", "business", "agent"], "# Project Brief\n\nCapture what this project is, who it serves, and why it matters.\n"),
+        },
+        {
+            path: `${docsRoot}/project/roadmap.md`,
+            content: doc("Roadmap", "project", "project", ["developer", "business", "agent"], "# Roadmap\n\nCapture the current MVP, near-term next steps, and deferred ideas.\n"),
+        },
+        {
+            path: `${docsRoot}/project/open-questions.md`,
+            content: doc("Open Questions", "project", "project", ["developer", "designer", "business", "agent"], "# Open Questions\n\nTrack decisions that are not settled yet.\n"),
+        },
+        {
+            path: `${docsRoot}/handoff/human-brief.md`,
+            content: doc("Human Brief", "handoff", "human-brief", ["developer", "designer", "business", "advisor"], "# Human Brief\n\nUse this for a concise handoff to another person.\n"),
+        },
+        {
+            path: `${docsRoot}/handoff/agent-brief.md`,
+            content: doc("Agent Brief", "handoff", "agent-brief", ["agent"], "# Agent Brief\n\nUse this to orient future AI agents quickly.\n"),
+        },
+        {
+            path: `${docsRoot}/engineering/architecture.md`,
+            content: doc("Architecture", "project", "project", ["developer", "agent"], "# Architecture\n\nCapture the planned or current system shape, major boundaries, and important constraints.\n"),
+        },
+        {
+            path: `${docsRoot}/engineering/code-map.md`,
+            content: doc("Code Map", "project", "project", ["developer", "agent"], "# Code Map\n\nCapture important files, modules, routes, schemas, and tests when code exists.\n"),
+        },
+        {
+            path: `${docsRoot}/features/index.md`,
+            content: doc("Features Index", "project", "project", ["developer", "designer", "agent", "business"], "# Features Index\n\nTrack feature scopes that are planned, in progress, shipped, or deferred.\n"),
+        },
+        {
+            path: `${docsRoot}/releases/changelog.md`,
+            content: doc("Changelog", "release", "release", ["developer", "business", "public"], "# Changelog\n\nTrack notable changes.\n"),
+        },
+    ];
+}
+export const starterDocs = workspaceDocs(DEFAULT_DOCS_ROOT);
+export function codebaseDocs(docsRoot) {
+    return workspaceDocs(docsRoot).filter((item) => item.path.startsWith(`${docsRoot}/engineering/`) || item.path.startsWith(`${docsRoot}/releases/`));
+}
+export function featureDocs(slug, docsRoot = DEFAULT_DOCS_ROOT) {
+    return [
+        {
+            path: `${docsRoot}/features/${slug}/brief.md`,
+            content: doc(`${slug} Brief`, "feature", slug, ["developer", "designer", "agent"], `# ${slug} Brief\n\nCapture what this feature is meant to accomplish.\n`),
+        },
+        {
+            path: `${docsRoot}/features/${slug}/plan.md`,
+            content: doc(`${slug} Plan`, "feature", slug, ["developer", "agent"], `# ${slug} Plan\n\nCapture the implementation or execution plan.\n`),
+        },
+        {
+            path: `${docsRoot}/features/${slug}/decisions.md`,
+            content: doc(`${slug} Decisions`, "feature", slug, ["developer", "agent"], `# ${slug} Decisions\n\nCapture durable decisions, rejected options, and reasoning.\n`),
+        },
+        {
+            path: `${docsRoot}/features/${slug}/handoff.md`,
+            content: doc(`${slug} Handoff`, "feature", slug, ["developer", "agent"], `# ${slug} Handoff\n\nCapture status, open questions, and next actions for this feature.\n`),
+        },
+    ];
+}
+//# sourceMappingURL=templates.js.map

package/dist/src/templates.js.map

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

package/dist/src/types.d.ts

@@ -0,0 +1,51 @@
+import type { KNOWN_AUDIENCES, KNOWN_FOCUS_TYPES, KNOWN_SCOPES, KNOWN_SOURCES, KNOWN_STATUSES, KNOWN_VISIBILITIES } from "./constants.js";
+export type ScopeKind = (typeof KNOWN_SCOPES)[number];
+export type FocusType = (typeof KNOWN_FOCUS_TYPES)[number];
+export type Audience = (typeof KNOWN_AUDIENCES)[number];
+export type DocStatus = (typeof KNOWN_STATUSES)[number];
+export type Visibility = (typeof KNOWN_VISIBILITIES)[number];
+export type DocSource = (typeof KNOWN_SOURCES)[number];
+export interface DocFrontmatter {
+    title: string;
+    scope: ScopeKind;
+    scope_id: string;
+    audience: Audience[];
+    status: DocStatus;
+    visibility: Visibility;
+    updated: string;
+    source: DocSource;
+}
+export interface ParsedMarkdown {
+    frontmatter: DocFrontmatter;
+    body: string;
+}
+export interface BenjaminDocsConfig {
+    version: 1;
+    mode: "planning" | "codebase";
+    docsRoot: string;
+    focus: FocusType;
+    feature?: string;
+}
+export interface ScopeRecord {
+    id: string;
+    kind: ScopeKind;
+    title: string;
+    path: string;
+    status: DocStatus;
+}
+export interface ScopesFile {
+    version: 1;
+    scopes: ScopeRecord[];
+}
+export interface AnchorRecord {
+    file: string;
+    docs: string[];
+}
+export interface AnchorsFile {
+    version: 1;
+    anchors: Record<string, AnchorRecord>;
+}
+export interface ManifestFile {
+    version: 1;
+    docs: string[];
+}

package/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/dist/src/validate.d.ts

@@ -0,0 +1,5 @@
+export interface ValidationResult {
+    errors: string[];
+    warnings: string[];
+}
+export declare function validateProject(root: string): ValidationResult;