sidebar-md 0.1.0

package/dist/server/author.js

@@ -0,0 +1,45 @@
+import { execFileSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { sanitizeAttribute } from "../shared/markers.js";
+// Resolve the `author` attribute written into a human-origin marker.
+//
+// Spec: Identity and Multi-Agent / Human identity in markers.
+// Resolution order, evaluated per write:
+//
+//   1. `git config user.name` if `.git/` exists in the workspace root and
+//      the value is non-empty.
+//   2. `$USER` from the environment.
+//   3. Literal `human`.
+//
+// Control characters are stripped, `"` is replaced with `'` so the value
+// never breaks the HTML comment's quoted attribute. Empty after sanitization
+// falls back to the next candidate, ultimately to `human`.
+const FALLBACK = "human";
+export function resolveHumanAuthor(cwd, env = process.env) {
+    const gitName = readGitUserName(cwd);
+    const gitSan = sanitizeAttribute(gitName).trim();
+    if (gitSan)
+        return gitSan;
+    const userEnv = env.USER ?? "";
+    const userSan = sanitizeAttribute(userEnv).trim();
+    if (userSan)
+        return userSan;
+    return FALLBACK;
+}
+function readGitUserName(cwd) {
+    if (!existsSync(join(cwd, ".git")))
+        return "";
+    try {
+        const out = execFileSync("git", ["config", "user.name"], {
+            cwd,
+            stdio: ["ignore", "pipe", "ignore"],
+            encoding: "utf8",
+        });
+        return out.trim();
+    }
+    catch {
+        return "";
+    }
+}
+//# sourceMappingURL=author.js.map

package/dist/server/author.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"author.js","sourceRoot":"","sources":["../../src/server/author.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,qEAAqE;AACrE,EAAE;AACF,8DAA8D;AAC9D,yCAAyC;AACzC,EAAE;AACF,0EAA0E;AAC1E,+BAA+B;AAC/B,qCAAqC;AACrC,wBAAwB;AACxB,EAAE;AACF,yEAAyE;AACzE,6EAA6E;AAC7E,2DAA2D;AAE3D,MAAM,QAAQ,GAAG,OAAO,CAAC;AAEzB,MAAM,UAAU,kBAAkB,CAChC,GAAW,EACX,MAA0C,OAAO,CAAC,GAAG;IAErD,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE;YACvD,GAAG;YACH,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;YACnC,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/server/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/server/cli.js

@@ -0,0 +1,364 @@
+#!/usr/bin/env node
+import { existsSync } from "node:fs";
+import { mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { argv, env, exit, cwd as procCwd, stdin, stdout } from "node:process";
+import { createInterface } from "node:readline/promises";
+import { fileURLToPath } from "node:url";
+import open from "open";
+import { ArgsError, helpText, parseArgs } from "./args.js";
+import { ConfigLoadError, LOCAL_REL, gitignoreState, loadProjectConfig, } from "./config/index.js";
+import { probeConnectionFile } from "./connection-file.js";
+import { SUPPORTED_AGENTS, isSupportedAgent, runInit } from "./init.js";
+import { log, setLogLevel } from "./log.js";
+import { assertNodeVersion } from "./runtime-check.js";
+import { startServer } from "./server.js";
+import { bootStdio } from "./stdio.js";
+import { buildVerbCatalog } from "./verbs/index.js";
+import { createWorkspace, defaultScope, defaultScopeDirExists, isDefaultScope, } from "./workspace.js";
+const PORT_FALLBACK_START = 5180;
+const PORT_FALLBACK_END = 5189;
+async function main() {
+    try {
+        assertNodeVersion(process.version);
+    }
+    catch (e) {
+        process.stderr.write(`${e.message}\n`);
+        exit(2);
+    }
+    let args;
+    try {
+        args = parseArgs(argv.slice(2));
+    }
+    catch (e) {
+        if (e instanceof ArgsError) {
+            process.stderr.write(`${e.message}\n\n${helpText()}`);
+            exit(2);
+        }
+        throw e;
+    }
+    if (args.helpRequested) {
+        process.stdout.write(helpText());
+        return;
+    }
+    if (args.verbose)
+        setLogLevel("DEBUG");
+    else if (args.quiet)
+        setLogLevel("WARN");
+    // `init` writes a .mcp.json; it does not need the .sidebar/ config layer.
+    // Everything else passes through the loader so an invalid file refuses
+    // boot per the Q9 "no silent fallback" stance.
+    if (args.subcommand === "init") {
+        await runInitCommand(args);
+        return;
+    }
+    const cwd = procCwd();
+    let loaded;
+    try {
+        loaded = await loadProjectConfig(cwd);
+    }
+    catch (e) {
+        if (e instanceof ConfigLoadError) {
+            process.stderr.write(`${e.message}\n`);
+            exit(8);
+        }
+        throw e;
+    }
+    warnUnignoredLocal(cwd, loaded.local);
+    const settings = resolveSettings(args, loaded);
+    switch (args.subcommand) {
+        case "stdio":
+            await runStdioCommand(settings);
+            return;
+        case "serve":
+            await runServeCommand(settings);
+            return;
+    }
+}
+function resolveSettings(args, loaded) {
+    const cfg = loaded.config;
+    const loc = loaded.local;
+    const scope = args.scope ?? cfg?.scope ?? defaultScope();
+    const scopeFromDisk = args.scope !== undefined || cfg?.scope !== undefined;
+    const port = args.port ?? loc?.port;
+    const portExplicit = args.port !== undefined || loc?.port !== undefined;
+    const browser = args.browser ?? loc?.browser ?? "default";
+    return { scope, scopeFromDisk, port, portExplicit, browser, config: cfg };
+}
+function warnUnignoredLocal(cwd, local) {
+    if (!local)
+        return;
+    if (gitignoreState(cwd) === "unignored") {
+        // Spec: Configuration / Gitignore behavior. Single-line stderr nag; no
+        // persistent dismissal flag.
+        process.stderr.write(`warning: ${LOCAL_REL} exists in this project but is not gitignored. ` +
+            `Add it to .gitignore (per-machine state should not be committed).\n`);
+    }
+}
+async function runInitCommand(args) {
+    const cwd = procCwd();
+    let agentName = args.initAgent;
+    if (!agentName) {
+        if (args.yes || !stdin.isTTY) {
+            // Non-interactive default: V1 ships claude-code (spec: Invocation
+            // modes / V1 supports Claude Code and Compound's shared .mcp.json).
+            agentName = "claude-code";
+        }
+        else {
+            agentName = await promptForAgent();
+        }
+    }
+    if (!isSupportedAgent(agentName)) {
+        process.stderr.write(`unsupported agent: ${agentName}. ` +
+            `Supported in V1: ${SUPPORTED_AGENTS.join(", ")}. ` +
+            `Cursor, Codex, and Aider variants land in V1.1.\n`);
+        exit(2);
+    }
+    let outcome;
+    try {
+        outcome = await runInit(cwd, agentName);
+    }
+    catch (e) {
+        process.stderr.write(`init failed: ${e.message}\n`);
+        exit(6);
+    }
+    const verb = outcome.action === "created"
+        ? "wrote new"
+        : outcome.action === "updated"
+            ? "updated"
+            : "left unchanged";
+    process.stdout.write(`sidebar init: ${verb} ${outcome.path}\n` +
+        `  agent:         ${agentName}\n` +
+        `  mcpServers:    ${outcome.agents.join(", ")}\n` +
+        `\n` +
+        `Start ${agentName} in this project; it will spawn sidebar via stdio.\n`);
+}
+async function promptForAgent() {
+    const rl = createInterface({ input: stdin, output: stdout });
+    try {
+        stdout.write(`\nWhich MCP-speaking agent should sidebar wire up?\n\n` +
+            SUPPORTED_AGENTS.map((a, i) => `  [${i + 1}] ${a}`).join("\n") +
+            `\n\nEnter a number or the agent name (default: claude-code): `);
+        const ans = (await rl.question("")).trim();
+        if (!ans)
+            return "claude-code";
+        const idx = Number.parseInt(ans, 10);
+        if (!Number.isNaN(idx) && idx >= 1 && idx <= SUPPORTED_AGENTS.length) {
+            return SUPPORTED_AGENTS[idx - 1];
+        }
+        return ans;
+    }
+    finally {
+        rl.close();
+    }
+}
+async function runStdioCommand(settings) {
+    const cwd = procCwd();
+    const workspace = await prepareWorkspaceOrExit(settings, cwd, { promptOnMissing: false });
+    const staticRoot = resolveStaticRoot();
+    const verbCatalog = buildVerbCatalog(settings.config);
+    const boot = await bootStdio({
+        cwd,
+        startPrimary: async () => {
+            const handle = await bindServer(workspace, settings, staticRoot, verbCatalog);
+            process.stderr.write(`sidebar primary listening at ${handle.url}\n`);
+            process.stderr.write(`  workspace: ${workspace.root}\n`);
+            process.stderr.write(`  scope:     ${workspace.scope}\n`);
+            // Only the primary opens a browser; proxies share the primary tab.
+            await maybeLaunchBrowser(settings.browser, handle.url);
+            return handle;
+        },
+    });
+    installStdioShutdown(boot.shutdown);
+    await boot.done;
+}
+async function runServeCommand(settings) {
+    const cwd = procCwd();
+    // ADR-0007 / spec: Invocation modes. Standalone must refuse to start while
+    // a primary is already alive for this project.
+    const probe = await probeConnectionFile(cwd);
+    if (probe.kind === "alive") {
+        process.stderr.write(`primary sidebar already running at ${probe.info.url} (pid ${probe.info.pid}).\n` +
+            `Attach via that URL or stop the running primary first.\n`);
+        exit(7);
+    }
+    if (probe.kind === "stale" || probe.kind === "malformed") {
+        log.warn(`removing stale .sidebar/connection.json (probe: ${probe.kind})`);
+        // Don't block the user behind a manual cleanup; the file is per-project
+        // discovery, not configuration.
+        const { removeConnectionFile } = await import("./connection-file.js");
+        await removeConnectionFile(cwd);
+    }
+    const workspace = await prepareWorkspaceOrExit(settings, cwd, { promptOnMissing: true });
+    const staticRoot = resolveStaticRoot();
+    const verbCatalog = buildVerbCatalog(settings.config);
+    const handle = await bindServer(workspace, settings, staticRoot, verbCatalog);
+    process.stderr.write(`sidebar listening at ${handle.url}\n`);
+    process.stderr.write(`  workspace: ${workspace.root}\n`);
+    process.stderr.write(`  scope:     ${workspace.scope}\n`);
+    await maybeLaunchBrowser(settings.browser, handle.url);
+    installShutdown(handle);
+}
+// Bind the HTTP server honouring the precedence rules: an explicit port
+// (CLI or local.json) refuses on collision; an absent port walks the
+// 5180-5189 fallback range.
+async function bindServer(workspace, settings, staticRoot, verbCatalog) {
+    if (settings.portExplicit && settings.port !== undefined) {
+        try {
+            return await startServer({ workspace, port: settings.port, staticRoot, verbCatalog });
+        }
+        catch (e) {
+            const code = e.code;
+            if (code === "EADDRINUSE") {
+                process.stderr.write(`port ${settings.port} is already in use (EADDRINUSE). ` +
+                    `Pick a different --port, or use --port 0.\n`);
+                exit(4);
+            }
+            throw e;
+        }
+    }
+    return tryFallback(workspace, staticRoot, verbCatalog);
+}
+async function prepareWorkspaceOrExit(settings, cwd, opts) {
+    let scope = settings.scope;
+    // The docs/ prompt only fires for the *default* scope. A scope coming from
+    // either CLI or config.json is the user's explicit choice; we don't second-
+    // guess it.
+    if (!settings.scopeFromDisk && isDefaultScope(scope) && !defaultScopeDirExists(cwd)) {
+        if (!opts.promptOnMissing) {
+            // --stdio is non-interactive (the user's agent is on the other end of
+            // stdio). Refuse rather than silently fall back.
+            process.stderr.write(`docs/ not found at ${cwd}.\n` +
+                `Sidebar's --stdio mode is non-interactive. ` +
+                `Re-run \`npx sidebar-md\` interactively to create docs/, or wire ` +
+                `\`--scope "<glob>"\` into your .mcp.json entry.\n`);
+            exit(5);
+        }
+        const decision = await promptDocsMissing(cwd);
+        if (decision.kind === "quit") {
+            exit(0);
+        }
+        else if (decision.kind === "create") {
+            await mkdir(join(cwd, "docs"), { recursive: true });
+        }
+        else {
+            scope = decision.scope;
+        }
+    }
+    return createWorkspace(cwd, scope);
+}
+async function tryFallback(workspace, staticRoot, verbCatalog) {
+    for (let p = PORT_FALLBACK_START; p <= PORT_FALLBACK_END; p++) {
+        try {
+            return await startServer({ workspace, port: p, staticRoot, verbCatalog });
+        }
+        catch (e) {
+            if (e.code !== "EADDRINUSE")
+                throw e;
+            log.debug(`port ${p} busy, trying next`);
+        }
+    }
+    process.stderr.write(`no free port in ${PORT_FALLBACK_START}-${PORT_FALLBACK_END}. Use --port <N> or --port 0.\n`);
+    exit(3);
+}
+async function maybeLaunchBrowser(browser, url) {
+    if (browser === "none")
+        return;
+    const override = env.SIDEBAR_OPEN;
+    if (override === "noop")
+        return;
+    if (override === "fail") {
+        log.warn("SIDEBAR_OPEN=fail: skipping browser launch (test harness)");
+        return;
+    }
+    try {
+        if (browser === "default") {
+            await open(url);
+        }
+        else {
+            await open(url, { app: { name: browser } });
+        }
+    }
+    catch (e) {
+        log.warn(`browser launch failed: ${e.message}`);
+    }
+}
+function installShutdown(handle) {
+    let shuttingDown = false;
+    const shutdown = async (sig) => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        process.stderr.write(`received ${sig}, shutting down\n`);
+        try {
+            await handle.close();
+        }
+        catch (e) {
+            process.stderr.write(`shutdown error: ${e.message}\n`);
+        }
+        exit(0);
+    };
+    process.on("SIGINT", () => void shutdown("SIGINT"));
+    process.on("SIGTERM", () => void shutdown("SIGTERM"));
+}
+function installStdioShutdown(stop) {
+    let shuttingDown = false;
+    const shutdown = async (sig) => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        process.stderr.write(`received ${sig}, shutting down stdio\n`);
+        try {
+            await stop();
+        }
+        catch (e) {
+            process.stderr.write(`stdio shutdown error: ${e.message}\n`);
+        }
+        exit(0);
+    };
+    process.on("SIGINT", () => void shutdown("SIGINT"));
+    process.on("SIGTERM", () => void shutdown("SIGTERM"));
+}
+async function promptDocsMissing(cwd) {
+    if (!stdin.isTTY) {
+        process.stderr.write(`docs/ not found at ${cwd}.\n` +
+            `Sidebar uses docs/**/*.md as its default workspace scope.\n` +
+            `Re-run with --scope "<glob>" or create docs/ and try again.\n`);
+        exit(5);
+    }
+    const rl = createInterface({ input: stdin, output: stdout });
+    try {
+        stdout.write(`\ndocs/ not found at ${cwd}.\n` +
+            `Sidebar uses docs/**/*.md as its default workspace scope.\n\n` +
+            `  [c] create docs/ here\n` +
+            `  [s] use a different scope glob\n` +
+            `  [q] quit\n\n`);
+        for (;;) {
+            const ans = (await rl.question("choice [c/s/q]: ")).trim().toLowerCase();
+            if (ans === "c" || ans === "create")
+                return { kind: "create" };
+            if (ans === "q" || ans === "quit")
+                return { kind: "quit" };
+            if (ans === "s" || ans === "scope") {
+                const scope = (await rl.question("scope glob: ")).trim();
+                if (scope)
+                    return { kind: "scope", scope };
+            }
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+function resolveStaticRoot() {
+    // After `npm run build`, the SPA is at dist/static. When running from
+    // source via tsx, the directory may not exist yet; the server handles
+    // that case by returning a friendly 503.
+    const path = fileURLToPath(new URL("../../dist/static", import.meta.url));
+    return existsSync(path) ? path : null;
+}
+main().catch((e) => {
+    process.stderr.write(`fatal: ${e.message}\n`);
+    exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/server/cli.js.map

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

package/dist/server/config/gitignore.d.ts

@@ -0,0 +1,10 @@
+export type GitignoreState = "absent" | "ignored" | "unignored";
+/** Returns "absent" when there is no .git/ directory at `cwd`. */
+export declare function gitignoreState(cwd: string): GitignoreState;
+export declare function isLocalIgnored(cwd: string): boolean;
+/**
+ * Append the local.json entry to .gitignore, preserving existing entries.
+ * Creates .gitignore if it doesn't exist. No-ops if the entry is already
+ * present (defensive double-add guard, in case the caller skipped the check).
+ */
+export declare function appendLocalToGitignore(cwd: string): Promise<void>;

package/dist/server/config/gitignore.js

@@ -0,0 +1,53 @@
+import { existsSync, readFileSync } from "node:fs";
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { LOCAL_REL } from "./paths.js";
+/** Returns "absent" when there is no .git/ directory at `cwd`. */
+export function gitignoreState(cwd) {
+    if (!existsSync(join(cwd, ".git")))
+        return "absent";
+    return isLocalIgnored(cwd) ? "ignored" : "unignored";
+}
+export function isLocalIgnored(cwd) {
+    const path = join(cwd, ".gitignore");
+    if (!existsSync(path))
+        return false;
+    let body;
+    try {
+        body = readFileSync(path, "utf8");
+    }
+    catch {
+        return false;
+    }
+    return matchesLocalLine(body);
+}
+function matchesLocalLine(body) {
+    for (const raw of body.split(/\r?\n/)) {
+        const line = raw.trim();
+        if (!line || line.startsWith("#"))
+            continue;
+        if (line === LOCAL_REL)
+            return true;
+        // Allow a leading slash form (".sidebar/local.json" vs "/.sidebar/...").
+        if (line === `/${LOCAL_REL}`)
+            return true;
+    }
+    return false;
+}
+/**
+ * Append the local.json entry to .gitignore, preserving existing entries.
+ * Creates .gitignore if it doesn't exist. No-ops if the entry is already
+ * present (defensive double-add guard, in case the caller skipped the check).
+ */
+export async function appendLocalToGitignore(cwd) {
+    const path = join(cwd, ".gitignore");
+    let body = "";
+    if (existsSync(path)) {
+        body = await readFile(path, "utf8");
+        if (matchesLocalLine(body))
+            return;
+    }
+    const sep = body.length === 0 || body.endsWith("\n") ? "" : "\n";
+    await writeFile(path, `${body}${sep}${LOCAL_REL}\n`, "utf8");
+}
+//# sourceMappingURL=gitignore.js.map

package/dist/server/config/gitignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.js","sourceRoot":"","sources":["../../../src/server/config/gitignore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAQvC,kEAAkE;AAClE,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAAE,OAAO,QAAQ,CAAC;IACpD,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACrC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5C,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACpC,yEAAyE;QACzE,IAAI,IAAI,KAAK,IAAI,SAAS,EAAE;YAAE,OAAO,IAAI,CAAC;IAC5C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,GAAW;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACrC,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpC,IAAI,gBAAgB,CAAC,IAAI,CAAC;YAAE,OAAO;IACrC,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACjE,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,GAAG,GAAG,GAAG,SAAS,IAAI,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC"}

package/dist/server/config/index.d.ts

@@ -0,0 +1,5 @@
+export { ConfigLoadError, type LoadConfigResult, loadProjectConfig, } from "./load.js";
+export { CONFIG_REL, LOCAL_REL, configPath, localPath, sidebarDir, } from "./paths.js";
+export type { SidebarConfigFile, SidebarLocalFile } from "./schema.js";
+export { type GitignoreAction, type GitignoreConsent, type PersistConfigResult, type PersistLocalResult, persistConfig, persistLocal, } from "./write.js";
+export { type GitignoreState, appendLocalToGitignore, gitignoreState, isLocalIgnored, } from "./gitignore.js";

package/dist/server/config/index.js

@@ -0,0 +1,5 @@
+export { ConfigLoadError, loadProjectConfig, } from "./load.js";
+export { CONFIG_REL, LOCAL_REL, configPath, localPath, sidebarDir, } from "./paths.js";
+export { persistConfig, persistLocal, } from "./write.js";
+export { appendLocalToGitignore, gitignoreState, isLocalIgnored, } from "./gitignore.js";
+//# sourceMappingURL=index.js.map

package/dist/server/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAEf,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,UAAU,EACV,SAAS,EACT,UAAU,EACV,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EAKL,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAEL,sBAAsB,EACtB,cAAc,EACd,cAAc,GACf,MAAM,gBAAgB,CAAC"}

package/dist/server/config/load.d.ts

@@ -0,0 +1,21 @@
+import { type SidebarConfigFile, type SidebarLocalFile } from "./schema.js";
+export declare class ConfigLoadError extends Error {
+    /** Relative path of the offending file (".sidebar/config.json"). */
+    readonly file: string;
+    /** Dotted field path (e.g. "verbs.human.rephrase"); empty for whole-file errors. */
+    readonly fieldPath: string;
+    /** Human-readable explanation. */
+    readonly reason: string;
+    constructor(
+    /** Relative path of the offending file (".sidebar/config.json"). */
+    file: string, 
+    /** Dotted field path (e.g. "verbs.human.rephrase"); empty for whole-file errors. */
+    fieldPath: string, 
+    /** Human-readable explanation. */
+    reason: string);
+}
+export type LoadConfigResult = {
+    config: SidebarConfigFile | null;
+    local: SidebarLocalFile | null;
+};
+export declare function loadProjectConfig(cwd: string): Promise<LoadConfigResult>;

package/dist/server/config/load.js

@@ -0,0 +1,106 @@
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { BUILTIN_AGENT_VERB_NAMES, BUILTIN_HUMAN_VERB_NAMES } from "../verbs/builtin.js";
+import { CONFIG_REL, LOCAL_REL, configPath, localPath } from "./paths.js";
+import { sidebarConfigSchema, sidebarLocalSchema, } from "./schema.js";
+// ConfigLoadError carries enough context for the CLI to print a one-line
+// "<file>: <field>: <reason>" message. The Q9 stance is firm: no silent
+// fallback. If we get a load error, sidebar refuses to start.
+export class ConfigLoadError extends Error {
+    file;
+    fieldPath;
+    reason;
+    constructor(
+    /** Relative path of the offending file (".sidebar/config.json"). */
+    file, 
+    /** Dotted field path (e.g. "verbs.human.rephrase"); empty for whole-file errors. */
+    fieldPath, 
+    /** Human-readable explanation. */
+    reason) {
+        super(fieldPath ? `${file}: ${fieldPath}: ${reason}` : `${file}: ${reason}`);
+        this.file = file;
+        this.fieldPath = fieldPath;
+        this.reason = reason;
+        this.name = "ConfigLoadError";
+    }
+}
+export async function loadProjectConfig(cwd) {
+    const config = await loadOne(configPath(cwd), CONFIG_REL, sidebarConfigSchema);
+    if (config)
+        assertNoBuiltinVerbRedefinition(config);
+    const local = await loadOne(localPath(cwd), LOCAL_REL, sidebarLocalSchema);
+    return { config, local };
+}
+// Spec: Configuration -- "Redefining a built-in verb is a load error."
+// We run this after schema parsing so the error path can name the specific
+// verb the user wrote (e.g. "verbs.human.rephrase") rather than the parent
+// record.
+function assertNoBuiltinVerbRedefinition(config) {
+    const human = config.verbs?.human;
+    if (human) {
+        for (const name of Object.keys(human)) {
+            if (BUILTIN_HUMAN_VERB_NAMES.has(name)) {
+                throw new ConfigLoadError(CONFIG_REL, `verbs.human.${name}`, `cannot redefine built-in human verb '${name}'`);
+            }
+        }
+    }
+    const agent = config.verbs?.agent;
+    if (agent) {
+        for (const name of Object.keys(agent)) {
+            if (BUILTIN_AGENT_VERB_NAMES.has(name)) {
+                throw new ConfigLoadError(CONFIG_REL, `verbs.agent.${name}`, `cannot redefine built-in agent verb '${name}'`);
+            }
+        }
+    }
+}
+async function loadOne(absPath, relName, schema) {
+    if (!existsSync(absPath))
+        return null;
+    let raw;
+    try {
+        raw = await readFile(absPath, "utf8");
+    }
+    catch (e) {
+        // Race: file existed at existsSync, gone (or unreadable) now. Surface as
+        // a load error rather than silently treating it as absent.
+        throw new ConfigLoadError(relName, "", `failed to read: ${e.message}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (e) {
+        throw new ConfigLoadError(relName, "", `invalid JSON (${e.message})`);
+    }
+    const result = schema.safeParse(parsed);
+    if (!result.success) {
+        throw zodToLoadError(relName, result.error);
+    }
+    return result.data;
+}
+function zodToLoadError(file, err) {
+    // Pick the most actionable issue. Zod returns one per offending field; for
+    // strict-mode unknown keys it returns `unrecognized_keys` with `keys` on
+    // the issue. Surface the first one with a normalized path.
+    const issue = err.issues[0];
+    if (!issue)
+        return new ConfigLoadError(file, "", err.message);
+    let path = issue.path.map((p) => String(p)).join(".");
+    let reason = issue.message;
+    if (issue.code === "unrecognized_keys") {
+        const keys = issue.keys ?? [];
+        if (keys.length > 0) {
+            // Surface the offending key in the dotted path so error messages name
+            // the field the user actually wrote.
+            path = path ? `${path}.${keys[0]}` : keys[0];
+            reason = `unknown key '${keys[0]}'`;
+        }
+    }
+    if (issue.code === "invalid_value" && path === "version") {
+        // Zod literal mismatch is the V2 migration hook; the default message
+        // ("Invalid input: expected 1") reads poorly. Override.
+        reason = "version must be 1 (V2 migration hook; other values rejected)";
+    }
+    return new ConfigLoadError(file, path, reason);
+}
+//# sourceMappingURL=load.js.map