sidebar-md 0.1.0

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

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

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

@@ -0,0 +1,9 @@
+export declare const SIDEBAR_DIR = ".sidebar";
+export declare const CONFIG_FILE = "config.json";
+export declare const LOCAL_FILE = "local.json";
+export declare const CONFIG_REL = ".sidebar/config.json";
+export declare const LOCAL_REL = ".sidebar/local.json";
+export declare function configPath(cwd: string): string;
+export declare function localPath(cwd: string): string;
+export declare function sidebarDir(cwd: string): string;
+export declare function relFromCwd(cwd: string, abs: string): string;

package/dist/server/config/paths.js

@@ -0,0 +1,26 @@
+import { join, relative } from "node:path";
+export const SIDEBAR_DIR = ".sidebar";
+export const CONFIG_FILE = "config.json";
+export const LOCAL_FILE = "local.json";
+// Relative form used in user-visible error messages so they stay short and
+// portable: ".sidebar/local.json" reads the same on every platform.
+export const CONFIG_REL = `${SIDEBAR_DIR}/${CONFIG_FILE}`;
+export const LOCAL_REL = `${SIDEBAR_DIR}/${LOCAL_FILE}`;
+export function configPath(cwd) {
+    return join(cwd, SIDEBAR_DIR, CONFIG_FILE);
+}
+export function localPath(cwd) {
+    return join(cwd, SIDEBAR_DIR, LOCAL_FILE);
+}
+export function sidebarDir(cwd) {
+    return join(cwd, SIDEBAR_DIR);
+}
+// Relative form rooted at `cwd`. Used in error messages to make sure the
+// reader can act on the path without hunting through tmp prefixes.
+export function relFromCwd(cwd, abs) {
+    const r = relative(cwd, abs);
+    // Replace any platform separator with posix; the rest of the codebase uses
+    // posix in user-visible strings.
+    return r.split(/[\\/]/).join("/");
+}
+//# sourceMappingURL=paths.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/server/config/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AACtC,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;AACzC,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC;AAEvC,2EAA2E;AAC3E,oEAAoE;AACpE,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,WAAW,IAAI,WAAW,EAAE,CAAC;AAC1D,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,WAAW,IAAI,UAAU,EAAE,CAAC;AAExD,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AAChC,CAAC;AAED,yEAAyE;AACzE,mEAAmE;AACnE,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,GAAW;IACjD,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC7B,2EAA2E;IAC3E,iCAAiC;IACjC,OAAO,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC"}

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

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export declare const sidebarConfigSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    scope: z.ZodOptional<z.ZodString>;
+    rateLimit: z.ZodOptional<z.ZodObject<{
+        agentMentions: z.ZodOptional<z.ZodObject<{
+            maxOpen: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    verbs: z.ZodOptional<z.ZodObject<{
+        human: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            mode: z.ZodEnum<{
+                replace: "replace";
+                annotation: "annotation";
+            }>;
+        }, z.core.$strict>>>;
+        agent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{}, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const sidebarLocalSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    port: z.ZodOptional<z.ZodNumber>;
+    browser: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SidebarConfigFile = z.infer<typeof sidebarConfigSchema>;
+export type SidebarLocalFile = z.infer<typeof sidebarLocalSchema>;

package/dist/server/config/schema.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { VERB_NAME_PATTERN } from "../verbs/builtin.js";
+// .sidebar/config.json — committed, team-shared. Spec: Configuration /
+// `.sidebar/config.json`. Strict object schema: unknown keys reject.
+//
+// .sidebar/local.json — gitignored, per-machine. Spec: Configuration /
+// `.sidebar/local.json`. Strict object schema: unknown keys reject.
+//
+// Built-in-verb redefinition is enforced in load.ts after schema parsing so
+// the error message can name the offending verb in its dotted path; zod's
+// per-record-key refinement is awkward to thread cleanly here.
+const verbNameSchema = z
+    .string()
+    .regex(VERB_NAME_PATTERN, "verb name must match /^[a-z][a-z0-9-]*$/");
+const humanVerbBodySchema = z
+    .object({
+    mode: z.enum(["replace", "annotation"]),
+})
+    .strict();
+const agentVerbBodySchema = z.object({}).strict();
+const verbsSchema = z
+    .object({
+    human: z.record(verbNameSchema, humanVerbBodySchema).optional(),
+    agent: z.record(verbNameSchema, agentVerbBodySchema).optional(),
+})
+    .strict();
+export const sidebarConfigSchema = z
+    .object({
+    version: z.literal(1, {
+        message: "version must be 1 (V2 migration hook; other values rejected)",
+    }),
+    scope: z.string().min(1).optional(),
+    rateLimit: z
+        .object({
+        agentMentions: z
+            .object({
+            maxOpen: z.number().int().min(0).max(1000).optional(),
+        })
+            .strict()
+            .optional(),
+    })
+        .strict()
+        .optional(),
+    verbs: verbsSchema.optional(),
+})
+    .strict();
+export const sidebarLocalSchema = z
+    .object({
+    version: z.literal(1, {
+        message: "version must be 1 (V2 migration hook; other values rejected)",
+    }),
+    port: z.number().int().min(0).max(65_535).optional(),
+    browser: z.string().min(1).optional(),
+})
+    .strict();
+//# sourceMappingURL=schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/server/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,uEAAuE;AACvE,qEAAqE;AACrE,EAAE;AACF,uEAAuE;AACvE,oEAAoE;AACpE,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,+DAA+D;AAE/D,MAAM,cAAc,GAAG,CAAC;KACrB,MAAM,EAAE;KACR,KAAK,CAAC,iBAAiB,EAAE,0CAA0C,CAAC,CAAC;AAExE,MAAM,mBAAmB,GAAG,CAAC;KAC1B,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;CACxC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAElD,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC,QAAQ,EAAE;IAC/D,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC,QAAQ,EAAE;CAChE,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KACjC,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE;QACpB,OAAO,EAAE,8DAA8D;KACxE,CAAC;IACF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnC,SAAS,EAAE,CAAC;SACT,MAAM,CAAC;QACN,aAAa,EAAE,CAAC;aACb,MAAM,CAAC;YACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;SACtD,CAAC;aACD,MAAM,EAAE;aACR,QAAQ,EAAE;KACd,CAAC;SACD,MAAM,EAAE;SACR,QAAQ,EAAE;IACb,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE;CAC9B,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE;QACpB,OAAO,EAAE,8DAA8D;KACxE,CAAC;IACF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;IACpD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACtC,CAAC;KACD,MAAM,EAAE,CAAC"}

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

@@ -0,0 +1,29 @@
+import { CONFIG_REL, LOCAL_REL } from "./paths.js";
+import { type SidebarConfigFile, type SidebarLocalFile } from "./schema.js";
+export type GitignoreConsent = (info: {
+    gitignorePath: string;
+}) => Promise<boolean> | boolean;
+export type GitignoreAction = 
+/** No `.git/` directory at `cwd`; we don't manage gitignore in that case. */
+"absent"
+/** local.json is already ignored; no-op. */
+ | "already-ignored"
+/** Consent was granted and the line was appended (or .gitignore was created). */
+ | "appended"
+/** Consent callback returned false; we proceed without touching .gitignore. */
+ | "declined"
+/** No consent callback provided; we proceed without prompting. */
+ | "no-prompt";
+export type PersistLocalResult = {
+    /** True when local.json did not exist before this write. */
+    created: boolean;
+    gitignoreAction: GitignoreAction;
+};
+export type PersistConfigResult = {
+    created: boolean;
+};
+export declare function persistLocal(cwd: string, patch: Partial<Omit<SidebarLocalFile, "version">>, opts?: {
+    consent?: GitignoreConsent;
+}): Promise<PersistLocalResult>;
+export declare function persistConfig(cwd: string, patch: Partial<Omit<SidebarConfigFile, "version">>): Promise<PersistConfigResult>;
+export { CONFIG_REL, LOCAL_REL };

package/dist/server/config/write.js

@@ -0,0 +1,74 @@
+import { existsSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { appendLocalToGitignore, isLocalIgnored } from "./gitignore.js";
+import { CONFIG_REL, LOCAL_REL, configPath, localPath, sidebarDir } from "./paths.js";
+import { sidebarConfigSchema, sidebarLocalSchema, } from "./schema.js";
+export async function persistLocal(cwd, patch, opts = {}) {
+    const path = localPath(cwd);
+    const existed = existsSync(path);
+    const previous = existed
+        ? await readAndValidate(path, sidebarLocalSchema)
+        : null;
+    const next = {
+        version: 1,
+        ...(previous ?? {}),
+        ...patch,
+    };
+    // Re-validate the merged result so a writer cannot create a file the
+    // loader would reject. Catches e.g. callers slipping in a bad port.
+    const validated = sidebarLocalSchema.parse(next);
+    await mkdir(sidebarDir(cwd), { recursive: true });
+    await writeFile(path, `${JSON.stringify(validated, null, 2)}\n`, "utf8");
+    // gitignore offer only fires on creation, per the spec ("On creation of
+    // .sidebar/local.json, sidebar checks for a .git/ directory ...").
+    let gitignoreAction = "no-prompt";
+    if (!existed) {
+        gitignoreAction = await runGitignoreOffer(cwd, opts.consent);
+    }
+    else {
+        // For an update, "no-prompt" is the right answer regardless of the
+        // current ignore state — we don't re-offer.
+        gitignoreAction = "no-prompt";
+    }
+    return { created: !existed, gitignoreAction };
+}
+export async function persistConfig(cwd, patch) {
+    const path = configPath(cwd);
+    const existed = existsSync(path);
+    const previous = existed
+        ? await readAndValidate(path, sidebarConfigSchema)
+        : null;
+    const next = {
+        version: 1,
+        ...(previous ?? {}),
+        ...patch,
+    };
+    const validated = sidebarConfigSchema.parse(next);
+    await mkdir(sidebarDir(cwd), { recursive: true });
+    await writeFile(path, `${JSON.stringify(validated, null, 2)}\n`, "utf8");
+    return { created: !existed };
+}
+async function runGitignoreOffer(cwd, consent) {
+    if (!existsSync(`${cwd}/.git`))
+        return "absent";
+    if (isLocalIgnored(cwd))
+        return "already-ignored";
+    if (!consent)
+        return "no-prompt";
+    const ok = await consent({ gitignorePath: `${cwd}/.gitignore` });
+    if (!ok)
+        return "declined";
+    await appendLocalToGitignore(cwd);
+    return "appended";
+}
+// Read + validate a file we are about to merge into. This is the writer-side
+// equivalent of loadProjectConfig; using the same schema keeps writers from
+// "fixing" a previously invalid file silently.
+async function readAndValidate(path, schema) {
+    const raw = await readFile(path, "utf8");
+    return schema.parse(JSON.parse(raw));
+}
+// Re-export the file-paths constants for callers that want to surface the
+// path in their own UI text.
+export { CONFIG_REL, LOCAL_REL };
+//# sourceMappingURL=write.js.map

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

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

package/dist/server/connection-file.d.ts

@@ -0,0 +1,22 @@
+export type ConnectionInfo = {
+    version: 1;
+    url: string;
+    pid: number;
+    started_at: string;
+};
+export declare function connectionFilePath(cwd: string): string;
+export declare function writeConnectionFile(cwd: string, info: ConnectionInfo): Promise<void>;
+export declare function removeConnectionFile(cwd: string): Promise<void>;
+export type ConnectionProbe = {
+    kind: "absent";
+} | {
+    kind: "stale";
+    info: ConnectionInfo;
+} | {
+    kind: "malformed";
+} | {
+    kind: "alive";
+    info: ConnectionInfo;
+};
+export declare function probeConnectionFile(cwd: string): Promise<ConnectionProbe>;
+export declare function isPidAlive(pid: number): boolean;

package/dist/server/connection-file.js

@@ -0,0 +1,72 @@
+import { existsSync } from "node:fs";
+import { mkdir, readFile, unlink, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { log } from "./log.js";
+export function connectionFilePath(cwd) {
+    return join(cwd, ".sidebar", "connection.json");
+}
+export async function writeConnectionFile(cwd, info) {
+    await mkdir(join(cwd, ".sidebar"), { recursive: true });
+    // `writeFile` with the default flag is fine here: the file is process-local
+    // discovery, not configuration. A stale file is intentionally overwritten.
+    await writeFile(connectionFilePath(cwd), `${JSON.stringify(info, null, 2)}\n`, "utf8");
+}
+export async function removeConnectionFile(cwd) {
+    try {
+        await unlink(connectionFilePath(cwd));
+    }
+    catch (e) {
+        if (e.code !== "ENOENT") {
+            log.warn(`failed to remove connection.json: ${e.message}`);
+        }
+    }
+}
+export async function probeConnectionFile(cwd) {
+    const path = connectionFilePath(cwd);
+    if (!existsSync(path))
+        return { kind: "absent" };
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch {
+        return { kind: "absent" };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return { kind: "malformed" };
+    }
+    if (!isConnectionInfo(parsed))
+        return { kind: "malformed" };
+    if (isPidAlive(parsed.pid))
+        return { kind: "alive", info: parsed };
+    return { kind: "stale", info: parsed };
+}
+function isConnectionInfo(v) {
+    if (!v || typeof v !== "object")
+        return false;
+    const c = v;
+    return (c.version === 1 &&
+        typeof c.url === "string" &&
+        typeof c.pid === "number" &&
+        typeof c.started_at === "string");
+}
+// `process.kill(pid, 0)` does not send a signal; it only checks reachability.
+// Throws ESRCH for dead pids and EPERM if the caller lacks permission (in
+// which case the pid is still alive — treat that as "alive" so we never race
+// a foreign primary into a duplicate bind).
+export function isPidAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (e) {
+        return e.code === "EPERM";
+    }
+}
+//# sourceMappingURL=connection-file.js.map

package/dist/server/connection-file.js.map

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

package/dist/server/dirty-buffer.d.ts

@@ -0,0 +1,7 @@
+export type DirtyBufferTracker = {
+    setDirty: (path: string, isDirty: boolean) => void;
+    isDirty: (path: string) => boolean;
+    draftAgeSeconds: (path: string) => number;
+    clearAll: () => void;
+};
+export declare function createDirtyBufferTracker(now?: () => number): DirtyBufferTracker;

package/dist/server/dirty-buffer.js

@@ -0,0 +1,39 @@
+// Tracks the editor's dirty-buffer state per workspace file path.
+//
+// The CodeMirror editor in the browser holds the source of truth for buffer
+// state; it pushes a `dirty` notification over the WebSocket whenever the
+// dirty status of a path flips. The MCP `read_doc` tool reads from this
+// store to populate `is_draft` and `draft_age_seconds`.
+//
+// State is process-local and transient (Q15 / ADR-0005). Disconnect of the
+// last editor tab clears everything: a draft only exists while an editor is
+// holding it.
+export function createDirtyBufferTracker(now = Date.now) {
+    // Stores the timestamp at which the path went dirty. Removing the entry
+    // means the buffer is clean.
+    const dirtyAt = new Map();
+    return {
+        setDirty(path, isDirty) {
+            if (isDirty) {
+                if (!dirtyAt.has(path))
+                    dirtyAt.set(path, now());
+            }
+            else {
+                dirtyAt.delete(path);
+            }
+        },
+        isDirty(path) {
+            return dirtyAt.has(path);
+        },
+        draftAgeSeconds(path) {
+            const t = dirtyAt.get(path);
+            if (t === undefined)
+                return 0;
+            return Math.max(0, Math.floor((now() - t) / 1000));
+        },
+        clearAll() {
+            dirtyAt.clear();
+        },
+    };
+}
+//# sourceMappingURL=dirty-buffer.js.map

package/dist/server/dirty-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dirty-buffer.js","sourceRoot":"","sources":["../../src/server/dirty-buffer.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,wEAAwE;AACxE,wDAAwD;AACxD,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,cAAc;AASd,MAAM,UAAU,wBAAwB,CAAC,MAAoB,IAAI,CAAC,GAAG;IACnE,wEAAwE;IACxE,6BAA6B;IAC7B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,OAAO;QACL,QAAQ,CAAC,IAAI,EAAE,OAAO;YACpB,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;oBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;YACnD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QACD,OAAO,CAAC,IAAI;YACV,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,eAAe,CAAC,IAAI;YAClB,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,CAAC,KAAK,SAAS;gBAAE,OAAO,CAAC,CAAC;YAC9B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,QAAQ;YACN,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server/files.d.ts

@@ -0,0 +1,19 @@
+import type { Workspace } from "./workspace.js";
+export type ReadResult = {
+    content: string;
+    hash: string;
+};
+export declare function readWorkspaceFile(ws: Workspace, relPath: string): Promise<ReadResult>;
+export type SaveOutcome = {
+    kind: "saved";
+    hash: string;
+} | {
+    kind: "conflict";
+    diskHash: string;
+    content: string;
+};
+export declare function saveWorkspaceFile(ws: Workspace, relPath: string, content: string, baseHash: string): Promise<SaveOutcome>;
+export declare function createFile(ws: Workspace, parent: string, name: string): Promise<string>;
+export declare function createFolder(ws: Workspace, parent: string, name: string): Promise<string>;
+export declare function renamePath(ws: Workspace, from: string, to: string): Promise<void>;
+export declare function deletePath(ws: Workspace, relPath: string): Promise<void>;

package/dist/server/files.js

@@ -0,0 +1,112 @@
+import { mkdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
+import { dirname, posix } from "node:path";
+import { sha256 } from "./hash.js";
+export async function readWorkspaceFile(ws, relPath) {
+    const safe = assertSafeRel(relPath);
+    assertInScope(ws, safe);
+    const content = await readFile(ws.toAbs(safe), "utf8");
+    return { content, hash: sha256(content) };
+}
+export async function saveWorkspaceFile(ws, relPath, content, baseHash) {
+    const safe = assertSafeRel(relPath);
+    assertInScope(ws, safe);
+    const abs = ws.toAbs(safe);
+    try {
+        const onDisk = await readFile(abs, "utf8");
+        const diskHash = sha256(onDisk);
+        if (diskHash !== baseHash) {
+            return { kind: "conflict", diskHash, content: onDisk };
+        }
+    }
+    catch (e) {
+        if (e.code !== "ENOENT")
+            throw e;
+        // First save of a file the editor just created in-memory: only accept
+        // if the editor declared an empty base.
+        if (baseHash !== sha256("")) {
+            return { kind: "conflict", diskHash: sha256(""), content: "" };
+        }
+    }
+    await mkdir(dirname(abs), { recursive: true });
+    await writeFile(abs, content, "utf8");
+    return { kind: "saved", hash: sha256(content) };
+}
+export async function createFile(ws, parent, name) {
+    validateName(name);
+    if (!name.endsWith(".md")) {
+        throw new Error(`new file must end in .md (got ${name})`);
+    }
+    const rel = joinRel(parent, name);
+    assertInScope(ws, rel);
+    const abs = ws.toAbs(rel);
+    await mkdir(dirname(abs), { recursive: true });
+    await writeFile(abs, "", { encoding: "utf8", flag: "wx" });
+    return rel;
+}
+export async function createFolder(ws, parent, name) {
+    validateName(name);
+    const rel = joinRel(parent, name);
+    await mkdir(ws.toAbs(rel), { recursive: false });
+    return rel;
+}
+export async function renamePath(ws, from, to) {
+    const safeFrom = assertSafeRel(from);
+    const safeTo = assertSafeRel(to);
+    // node:fs/promises rename silently clobbers an existing destination on
+    // POSIX. Stat first and refuse rather than destroying the user's content.
+    // (A concurrent write between this stat and the rename below would surface
+    // via the editor's conflict modal on next save anyway, but for tree CRUD
+    // we want the clearer "destination already exists" failure.)
+    const toAbs = ws.toAbs(safeTo);
+    try {
+        await stat(toAbs);
+        throw new Error(`destination already exists: ${to}`);
+    }
+    catch (e) {
+        if (e.code !== "ENOENT")
+            throw e;
+    }
+    await mkdir(dirname(toAbs), { recursive: true });
+    await rename(ws.toAbs(safeFrom), toAbs);
+}
+export async function deletePath(ws, relPath) {
+    const safe = assertSafeRel(relPath);
+    await rm(ws.toAbs(safe), { recursive: true, force: false });
+}
+function assertSafeRel(rel) {
+    if (rel === "")
+        throw new Error("path is empty");
+    // The protocol declares POSIX paths. Backslashes are directory separators
+    // on Windows after we hand the string to node:path, so posix.normalize
+    // would let "sub\\..\\..\\outside.md" pass while the filesystem treats it
+    // as a parent-directory traversal. Reject up front.
+    if (rel.includes("\\"))
+        throw new Error(`path uses backslash separators: ${rel}`);
+    if (rel.includes("\0"))
+        throw new Error(`path contains NUL: ${rel}`);
+    const norm = posix.normalize(rel);
+    if (norm.startsWith("..") || norm.startsWith("/") || norm === ".") {
+        throw new Error(`path escapes workspace: ${rel}`);
+    }
+    return norm;
+}
+function assertInScope(ws, safeRel) {
+    if (!ws.matches(safeRel)) {
+        throw new Error(`path is outside workspace scope (${ws.scope}): ${safeRel}`);
+    }
+}
+function joinRel(parent, name) {
+    validateName(name);
+    if (!parent)
+        return name;
+    return assertSafeRel(posix.join(parent, name));
+}
+function validateName(name) {
+    if (!name || name.includes("/") || name.includes("\\") || name.includes("\0")) {
+        throw new Error(`invalid name: ${JSON.stringify(name)}`);
+    }
+    if (name === "." || name === "..") {
+        throw new Error(`invalid name: ${JSON.stringify(name)}`);
+    }
+}
+//# sourceMappingURL=files.js.map

package/dist/server/files.js.map

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

package/dist/server/hash.d.ts

@@ -0,0 +1 @@
+export declare function sha256(content: string): string;

package/dist/server/hash.js

@@ -0,0 +1,7 @@
+import { createHash } from "node:crypto";
+// Stable content hash used for optimistic concurrency on save and as the
+// `diskHash` value exposed to the editor.
+export function sha256(content) {
+    return createHash("sha256").update(content, "utf8").digest("hex");
+}
+//# sourceMappingURL=hash.js.map

package/dist/server/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/server/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,yEAAyE;AACzE,0CAA0C;AAC1C,MAAM,UAAU,MAAM,CAAC,OAAe;IACpC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC"}

package/dist/server/init.d.ts

@@ -0,0 +1,16 @@
+export declare const SUPPORTED_AGENTS: readonly ["claude-code"];
+export type SupportedAgent = (typeof SUPPORTED_AGENTS)[number];
+export declare function isSupportedAgent(name: string): name is SupportedAgent;
+export type InitOutcome = {
+    path: string;
+    /** "created" when the file was new, "updated" when an existing entry changed. */
+    action: "created" | "updated" | "unchanged";
+    /** The full set of mcpServers keys after the write. */
+    agents: string[];
+};
+export type SidebarEntry = {
+    command: string;
+    args: string[];
+};
+export declare function sidebarMcpEntry(): SidebarEntry;
+export declare function runInit(cwd: string, _agent: SupportedAgent): Promise<InitOutcome>;

package/dist/server/init.js

@@ -0,0 +1,53 @@
+import { existsSync } from "node:fs";
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+// `npx sidebar-md init [agent]` writes a project-local `.mcp.json` entry that
+// spawns `npx sidebar-md --stdio`. V1 supports the Claude Code / Compound
+// shared `.mcp.json` layout (one entry under `mcpServers`). See ADR-0007.
+//
+// Existing unrelated entries in `.mcp.json` are preserved. Re-running is
+// idempotent: the sidebar entry is overwritten rather than duplicated.
+export const SUPPORTED_AGENTS = ["claude-code"];
+export function isSupportedAgent(name) {
+    return SUPPORTED_AGENTS.includes(name);
+}
+export function sidebarMcpEntry() {
+    // `npx sidebar-md --stdio` is the locked invite shape (ADR-0007). Anyone
+    // wanting a different command (e.g. a globally installed `sidebar-md` bin)
+    // can edit the file by hand; sidebar's own init writes the npx form.
+    return { command: "npx", args: ["sidebar-md", "--stdio"] };
+}
+export async function runInit(cwd, _agent) {
+    // Slice 02 ships the Claude Code / Compound layout only. The agent
+    // parameter is reserved for V1.1 when Cursor and Aider variants land.
+    const path = join(cwd, ".mcp.json");
+    let existing = null;
+    if (existsSync(path)) {
+        const raw = await readFile(path, "utf8");
+        try {
+            const parsed = JSON.parse(raw);
+            if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+                existing = parsed;
+            }
+            else {
+                throw new Error(`.mcp.json is not a JSON object (got ${typeof parsed})`);
+            }
+        }
+        catch (e) {
+            throw new Error(`failed to parse existing .mcp.json: ${e.message}`);
+        }
+    }
+    const base = existing ?? {};
+    const servers = (base.mcpServers && typeof base.mcpServers === "object"
+        ? { ...base.mcpServers }
+        : {});
+    const before = JSON.stringify(servers["sidebar-md"] ?? null);
+    const entry = sidebarMcpEntry();
+    servers["sidebar-md"] = entry;
+    const after = JSON.stringify(servers["sidebar-md"]);
+    const next = { ...base, mcpServers: servers };
+    const action = existing === null ? "created" : before === after ? "unchanged" : "updated";
+    await writeFile(path, `${JSON.stringify(next, null, 2)}\n`, "utf8");
+    return { path, action, agents: Object.keys(servers).sort() };
+}
+//# sourceMappingURL=init.js.map