sidebar-md 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sidrit Trandafili
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,205 @@
+# sidebar-md
+
+A local-first markdown editor with a co-author seat for your MCP-speaking agent.
+
+`sidebar-md` runs as a single local process. It opens a CodeMirror-based editor in your browser and exposes a local [Model Context Protocol](https://modelcontextprotocol.io) server in the same process. Any MCP-speaking agent (Claude Code, Codex, Aider, Compound, anything that speaks MCP) can join your workspace on invite and collaborate on the markdown files you're reading.
+
+Files stay on your disk. The agent stays in your terminal. Sidebar is the connective tissue between them.
+
+```
+npx sidebar-md
+```
+
+## What this gives you
+
+A browser-based markdown editor scoped to your project's `docs/` folder (configurable). Live preview, syntax highlighting, manual save. Standard editor things.
+
+A right-side **status drawer** that shows everything happening in your workspace: pending mentions, in-progress agent claims, connected agents, and the last 50 lifecycle events.
+
+A **Cmd-K** popover on any text selection that lets you write three kinds of co-authoring markers directly into the file:
+
+1. **Mentions**. A scoped, lifecycle-tracked ask aimed at an invited agent. Verbs like `rephrase`, `expand`, `factcheck`, `question`. The agent picks them up via MCP, claims them, and either replaces the text inline (action verbs) or leaves a note alongside it (query verbs).
+2. **Notes**. A persistent side annotation. Pure information, no lifecycle. Either you or an agent can leave them.
+3. **Suggestions**. A proposed replacement for a region. The agent or you can propose; only the human can accept or reject. Accept replaces the prose verbatim.
+
+All three are HTML comments on disk. Any other markdown tool sees them as comments. Sidebar renders them as gutter pills, side cards, and verb bubbles.
+
+An MCP tool surface the agent uses to participate: `list_docs`, `read_doc`, `list_pending_mentions`, `mark_in_progress`, `resolve_mention`, `list_annotations`, `add_annotation`, `update_annotation`, `remove_annotation`, `list_recent_changes`. The full surface is documented in [docs/qa/README.md](docs/qa/README.md) and [docs/specs/sidebar-v1-draft.md](docs/specs/sidebar-v1-draft.md).
+
+A skill scaffolder (`npx sidebar-md scaffold-skill`) that drops an agent-facing instruction file into `.claude/skills/sidebar-collaboration/SKILL.md` (or any path you point it at). The skill teaches the agent how to behave around mention lifecycle, optimistic concurrency, and the dirty-buffer signal.
+
+## Why this exists
+
+Co-authoring with an agent on a long document is friction-heavy. You either babysit a chat (and lose context with every restart) or you let the agent rewrite blindly (and chase regressions). Sidebar puts the human and the agent on the same surface, with the file as the source of truth and HTML-comment markers as the lifecycle handles.
+
+The permission model is deliberate. The agent reads freely. The agent edits prose only in two places: inside a **mention** you placed authorizing the edit, or via a **suggestion** that you accept. Anywhere else, the agent can only leave notes. No silent rewrites.
+
+## Quick start
+
+You need Node 20 or later.
+
+### Standalone editor
+
+In any project with a `docs/` folder:
+
+```
+npx sidebar-md
+```
+
+A browser tab opens at `http://127.0.0.1:5180`. The file tree on the left lists every markdown file under `docs/`. Click a file to open it.
+
+If `docs/` does not exist, sidebar offers three options: create it for you, accept a different glob, or quit. It does not silently scan your whole project.
+
+### Invite an MCP agent (one-time per project)
+
+```
+npx sidebar-md init claude-code
+```
+
+That writes a project-local `.mcp.json` entry pointing your agent's MCP client at sidebar over stdio. The next time you start your agent in the project, it spawns sidebar automatically and joins the workspace. No copy-paste, no MCP-config hunting.
+
+`init` is idempotent. Re-running updates the sidebar entry and leaves unrelated entries in `.mcp.json` alone. V1 supports the Claude Code and Compound shared `.mcp.json` layout. Cursor, Codex, and Aider variants land in V1.1.
+
+### Scaffold the agent skill (optional but recommended)
+
+```
+npx sidebar-md scaffold-skill
+```
+
+Writes `.claude/skills/sidebar-collaboration/SKILL.md` with the full mention round-trip protocol, verb tables, multi-agent etiquette, and conflict-handling rules. Claude Code and Compound auto-discover the skill on next start. For other agents, pass `--into <path>` to target a different location.
+
+## How co-authoring works in 90 seconds
+
+1. You open a markdown file and select a paragraph you want help with.
+2. You press **Cmd-K** (or Ctrl-K on Linux/Windows). A small popover appears anchored to the selection.
+3. You pick a mode: `mention`, `note`, or `suggestion`. Default is `mention`.
+4. For `mention`, you type a verb (`rephrase`, `expand`, ...). Built-in verbs autocomplete. You can add a freeform instruction.
+5. Submit. Sidebar writes a `<!-- @sidebar mention id="m-a3f9" verb="rephrase": tighten this paragraph -->target<!-- @sidebar end id="m-a3f9" -->` pair around your selection.
+6. The agent, connected over MCP, sees the mention via `list_pending_mentions`. It claims it with `mark_in_progress`, reads the surrounding doc with `read_doc`, does the work, and calls `resolve_mention` with the new content and a `base_hash` confirming it operated on the version it claimed.
+7. If you edited the region while the agent was working, the `base_hash` mismatches and sidebar refuses the write. The agent re-reads via `get_mention` and retries on the new content. No silent overwrites.
+
+The whole thing happens with the file on disk as the source of truth. If you close sidebar mid-flight, the markers stay put. Re-open later, and the lifecycle picks up where it left off.
+
+## A typical session
+
+A short, real-feeling slice of what the surface looks like end to end:
+
+```
+$ cd my-project
+$ npx sidebar-md init claude-code
+sidebar init: wrote new ./.mcp.json
+  agent:         claude-code
+  mcpServers:    sidebar-md
+
+Start claude-code in this project; it will spawn sidebar via stdio.
+
+$ claude
+# Claude Code spawns sidebar over stdio. A browser tab opens
+# automatically. The agent says hello in the terminal.
+
+# You select a paragraph in the editor, press Cmd-K, pick `rephrase`,
+# and type "tighten this". A marker pair is written to disk:
+
+<!-- @sidebar mention id="m-a3f9" verb="rephrase": tighten this -->
+Your selected paragraph here.
+<!-- @sidebar end id="m-a3f9" -->
+
+# You watch the status drawer. The mention moves Pending -> In progress
+# (with "claude-code" as the claimer). Seconds later, the marker pair
+# disappears and the paragraph is replaced with the tightened version.
+
+# You spot something you want to flag for later. Select another region,
+# Cmd-K, pick `note`, type "double-check this stat". The annotation
+# shows up as a side card on the right. Stays there forever, no
+# lifecycle.
+
+# You write a `suggestion` on a third region. The agent (or you) types
+# the proposed replacement. The side card has Accept and Reject
+# buttons. Accept replaces the prose verbatim.
+```
+
+## Configuration
+
+Sidebar reads `.sidebar/config.json` (committed, team-shared) and `.sidebar/local.json` (gitignored, per-machine) from the project root. Neither file is created automatically. They appear lazily the first time you do something that needs persistence.
+
+### `.sidebar/config.json`
+
+```json
+{
+  "version": 1,
+  "scope": "notes/**/*.md",
+  "rateLimit": { "agentMentions": { "maxOpen": 5 } },
+  "verbs": {
+    "human": {
+      "tighten": { "mode": "replace" },
+      "audit":   { "mode": "annotation" }
+    },
+    "agent": {
+      "estimate": {}
+    }
+  }
+}
+```
+
+- `scope` overrides the default `docs/**/*.md` workspace glob.
+- `rateLimit.agentMentions.maxOpen` caps concurrent agent-origin mentions.
+- `verbs.human` extends Cmd-K's verb autocomplete with custom verbs in either `replace` mode (agent rewrites the region) or `annotation` mode (agent leaves a note).
+- `verbs.agent` extends the whitelist of verbs agents can use when they originate a mention.
+
+### `.sidebar/local.json`
+
+```json
+{ "version": 1, "port": 5180, "browser": "default" }
+```
+
+- `port` pins the HTTP port. CLI flag `--port` takes precedence per boot.
+- `browser` accepts `"default"`, `"none"`, or any name the [`open`](https://www.npmjs.com/package/open) package understands (`"chrome"`, `"firefox"`, ...).
+
+Sidebar refuses to start on invalid JSON, unknown top-level keys, a `version` other than `1`, an unknown verb mode, or a port that's already in use when you set it explicitly. No silent fallbacks.
+
+### CLI flags
+
+```
+npx sidebar-md [--scope "<glob>"] [--port <N>] [--browser <name>] [--verbose|--quiet]
+npx sidebar-md init [agent] [--yes]
+npx sidebar-md scaffold-skill [--into <path>]
+```
+
+## How sidebar is built
+
+One Node 20 process, written in strict TypeScript. The editor is a React 18 SPA built with Vite. The HTTP layer uses `node:http` plus `ws`. The MCP server uses the official `@modelcontextprotocol/sdk` over both stdio (the dominant agent-spawning path) and Streamable HTTP (standalone mode and additional-agent attach). State for transient runtime data (in-progress claims, dirty buffers, recent changes) lives in process memory. Persistent shared state lives in the markdown files themselves as HTML comments. There's no database, no sidecar files (aside from the optional `.sidebar/` config dir).
+
+The full architecture, decision history, and acceptance criteria are documented in:
+
+- [docs/index.md](docs/index.md): docs landing page.
+- [docs/qa/README.md](docs/qa/README.md): living capabilities catalogue, written from a user's perspective.
+- [docs/specs/sidebar-v1-draft.md](docs/specs/sidebar-v1-draft.md): the V1 design document. Every behavior in QA traces back to a section here.
+- [docs/decisions/](docs/decisions/): architecture decision records.
+
+## What sidebar does not do
+
+These are deliberate, not gaps to fill later:
+
+- No global config in `~/.sidebar/`. All configuration is project-scoped.
+- No file logging. Logs go to stderr only.
+- No telemetry. No phone-home, no crash reporter, no analytics.
+- No daemon mode. Sidebar runs in the foreground. Ctrl-C cleanly shuts it down.
+- No auto-update. Run `npx sidebar-md@latest` or `npm i -g sidebar-md` to upgrade.
+- No file delete or out-of-glob writes by the agent.
+- No agent-to-agent direct messaging. Sidebar mediates human-to-agent and agent-to-human only.
+
+## Status
+
+V1 is the current target. Slices 1 through 5 are merged (editor shell, MCP server over stdio plus HTTP, `init` and `.mcp.json` write, `.sidebar/` config, human-origin mentions, annotations). Slices 6 through 11 (agent-origin mentions with rate limiting, conflict modal, scaffold-skill, multi-agent identity, file tree CRUD, runtime polish) land in subsequent releases.
+
+The codebase is small and the slice boundaries are documented. Contributions welcome via GitHub issues and PRs.
+
+## Requirements
+
+- Node 20 LTS or later.
+- A POSIX-y filesystem (macOS, Linux, WSL). Native Windows is untested in V1.
+- An MCP-speaking agent if you want the collaboration features. Sidebar runs perfectly well as a standalone markdown editor without one.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

package/dist/server/annotation-ops.d.ts

@@ -0,0 +1,104 @@
+import { type Annotation } from "../shared/markers.js";
+import type { Workspace } from "./workspace.js";
+export type FileAnnotation = Annotation & {
+    /** Workspace-relative POSIX path of the file the marker lives in. */
+    file: string;
+    /** ISO timestamp the annotation was first observed at runtime. */
+    created_at: string;
+};
+export type AnnotationCreatedAtMap = Map<string, string>;
+/** Walk every file in scope (or one specific file) and return annotations. */
+export declare function listAnnotations(ws: Workspace, firstSeenAt: AnnotationCreatedAtMap, options?: {
+    path?: string;
+    now?: () => Date;
+}): Promise<FileAnnotation[]>;
+export declare function findAnnotation(ws: Workspace, id: string, firstSeenAt: AnnotationCreatedAtMap): Promise<FileAnnotation | null>;
+export type TargetAnchor = {
+    start: number;
+    end: number;
+};
+export type AddAnnotationInput = {
+    path: string;
+    target_anchor: TargetAnchor;
+    type: "note" | "suggestion";
+    content: string;
+    author: string;
+};
+export type AddAnnotationResult = {
+    annotation: {
+        id: string;
+        file: string;
+        type: "note" | "suggestion";
+        author: string;
+        content: string;
+        target_content: string;
+        target_anchor: TargetAnchor;
+    };
+    newContent: string;
+};
+/**
+ * Wrap the target region in a begin/end annotation pair and write the file.
+ * Markers occupy full lines; if the cut isn't at a line boundary we splice
+ * newlines the same way createMention does (slice 4 contract).
+ */
+export declare function addAnnotation(ws: Workspace, input: AddAnnotationInput): Promise<AddAnnotationResult>;
+export type UpdateAnnotationResult = {
+    kind: "ok";
+    file: string;
+    type: "note" | "suggestion";
+    author: string;
+} | {
+    kind: "not-found";
+} | {
+    kind: "forbidden";
+    author: string;
+};
+/**
+ * Replace the begin marker's content payload in place. The author scope is
+ * enforced by the caller (the MCP tool checks `author === agentName`); we
+ * also surface the on-disk author so the caller can render the rejection
+ * message.
+ */
+export declare function updateAnnotation(ws: Workspace, id: string, content: string, options: {
+    requireAuthor?: string;
+    firstSeenAt: AnnotationCreatedAtMap;
+}): Promise<UpdateAnnotationResult>;
+export type RemoveAnnotationResult = {
+    kind: "ok";
+    file: string;
+    type: "note" | "suggestion";
+    author: string;
+} | {
+    kind: "not-found";
+} | {
+    kind: "forbidden";
+    author: string;
+};
+/**
+ * Strip the begin/end pair; leave the target prose in place. This is the
+ * `note` lifecycle's only mutation (the `reject` action for a suggestion is
+ * the same operation).
+ */
+export declare function removeAnnotation(ws: Workspace, id: string, options: {
+    requireAuthor?: string;
+    firstSeenAt: AnnotationCreatedAtMap;
+}): Promise<RemoveAnnotationResult>;
+export type AcceptSuggestionResult = {
+    kind: "ok";
+    file: string;
+    author: string;
+    replacement: string;
+} | {
+    kind: "not-found";
+} | {
+    kind: "not-suggestion";
+};
+/**
+ * Swap the target region for the suggestion's content and remove the
+ * begin/end pair. Used by the editor's side-card Accept button (and only by
+ * the editor; the agent never accepts its own suggestion).
+ *
+ * The replacement is applied verbatim: no further markdown transformation,
+ * no escaping, no fence rewrites. That contract is explicit in the spec.
+ */
+export declare function acceptSuggestion(ws: Workspace, id: string, firstSeenAt: AnnotationCreatedAtMap): Promise<AcceptSuggestionResult>;

package/dist/server/annotation-ops.js

@@ -0,0 +1,166 @@
+import { readFile, writeFile } from "node:fs/promises";
+import fastGlob from "fast-glob";
+import { decodeAnnotationContent, formatAnnotationBegin, formatAnnotationEnd, parseMarkers, } from "../shared/markers.js";
+import { generateNoteId, generateSuggestionId } from "./marker-ids.js";
+const SCAN_IGNORE = ["**/.git/**", "**/node_modules/**", "**/dist/**", "**/.sidebar/**"];
+/** Walk every file in scope (or one specific file) and return annotations. */
+export async function listAnnotations(ws, firstSeenAt, options = {}) {
+    const now = options.now ?? (() => new Date());
+    let files;
+    if (options.path) {
+        if (!ws.matches(options.path))
+            return [];
+        files = [options.path];
+    }
+    else {
+        files = await fastGlob(ws.innerGlob, {
+            cwd: ws.root,
+            onlyFiles: true,
+            dot: false,
+            followSymbolicLinks: false,
+            ignore: SCAN_IGNORE,
+        });
+        files.sort();
+    }
+    const out = [];
+    for (const rel of files) {
+        let text;
+        try {
+            text = await readFile(ws.toAbs(rel), "utf8");
+        }
+        catch {
+            continue;
+        }
+        const parsed = parseMarkers(text);
+        for (const a of parsed.annotations) {
+            let createdAt = firstSeenAt.get(a.id);
+            if (!createdAt) {
+                createdAt = now().toISOString();
+                firstSeenAt.set(a.id, createdAt);
+            }
+            out.push({ ...a, file: rel, created_at: createdAt });
+        }
+    }
+    return out;
+}
+export async function findAnnotation(ws, id, firstSeenAt) {
+    const list = await listAnnotations(ws, firstSeenAt);
+    return list.find((a) => a.id === id) ?? null;
+}
+/**
+ * Wrap the target region in a begin/end annotation pair and write the file.
+ * Markers occupy full lines; if the cut isn't at a line boundary we splice
+ * newlines the same way createMention does (slice 4 contract).
+ */
+export async function addAnnotation(ws, input) {
+    const abs = ws.toAbs(input.path);
+    const original = await readFile(abs, "utf8");
+    const { start, end } = input.target_anchor;
+    if (start < 0 || end > original.length || start > end) {
+        throw new Error(`addAnnotation: invalid target_anchor [${start}, ${end}] for file length ${original.length}`);
+    }
+    const before = original.slice(0, start);
+    const target = original.slice(start, end);
+    const after = original.slice(end);
+    const beginPrefix = before.length > 0 && !before.endsWith("\n") ? "\n" : "";
+    const endSuffix = after.length > 0 && !after.startsWith("\n") ? "\n" : "";
+    const normalizedTarget = target.length === 0 || target.endsWith("\n") ? target : `${target}\n`;
+    const id = input.type === "note" ? generateNoteId() : generateSuggestionId();
+    const begin = formatAnnotationBegin({
+        type: input.type,
+        id,
+        author: input.author,
+        instruction: input.content,
+    });
+    const endMarker = formatAnnotationEnd(id);
+    const newContent = `${before}${beginPrefix}${begin}\n${normalizedTarget}${endMarker}${endSuffix}${after}`;
+    await writeFile(abs, newContent, "utf8");
+    return {
+        annotation: {
+            id,
+            file: input.path,
+            type: input.type,
+            author: input.author,
+            content: input.content,
+            target_content: normalizedTarget,
+            target_anchor: input.target_anchor,
+        },
+        newContent,
+    };
+}
+/**
+ * Replace the begin marker's content payload in place. The author scope is
+ * enforced by the caller (the MCP tool checks `author === agentName`); we
+ * also surface the on-disk author so the caller can render the rejection
+ * message.
+ */
+export async function updateAnnotation(ws, id, content, options) {
+    const target = await findAnnotation(ws, id, options.firstSeenAt);
+    if (!target)
+        return { kind: "not-found" };
+    if (options.requireAuthor !== undefined && target.author !== options.requireAuthor) {
+        return { kind: "forbidden", author: target.author };
+    }
+    const abs = ws.toAbs(target.file);
+    const original = await readFile(abs, "utf8");
+    const beginLine = formatAnnotationBegin({
+        type: target.type,
+        id,
+        author: target.author,
+        instruction: content,
+    });
+    const newContent = original.slice(0, target.beginLineStart) +
+        `${beginLine}\n` +
+        original.slice(target.beginLineEnd);
+    await writeFile(abs, newContent, "utf8");
+    return { kind: "ok", file: target.file, type: target.type, author: target.author };
+}
+/**
+ * Strip the begin/end pair; leave the target prose in place. This is the
+ * `note` lifecycle's only mutation (the `reject` action for a suggestion is
+ * the same operation).
+ */
+export async function removeAnnotation(ws, id, options) {
+    const target = await findAnnotation(ws, id, options.firstSeenAt);
+    if (!target)
+        return { kind: "not-found" };
+    if (options.requireAuthor !== undefined && target.author !== options.requireAuthor) {
+        return { kind: "forbidden", author: target.author };
+    }
+    const abs = ws.toAbs(target.file);
+    const original = await readFile(abs, "utf8");
+    const newContent = original.slice(0, target.beginLineStart) +
+        target.targetContent +
+        original.slice(target.endLineEnd);
+    await writeFile(abs, newContent, "utf8");
+    options.firstSeenAt.delete(id);
+    return { kind: "ok", file: target.file, type: target.type, author: target.author };
+}
+/**
+ * Swap the target region for the suggestion's content and remove the
+ * begin/end pair. Used by the editor's side-card Accept button (and only by
+ * the editor; the agent never accepts its own suggestion).
+ *
+ * The replacement is applied verbatim: no further markdown transformation,
+ * no escaping, no fence rewrites. That contract is explicit in the spec.
+ */
+export async function acceptSuggestion(ws, id, firstSeenAt) {
+    const target = await findAnnotation(ws, id, firstSeenAt);
+    if (!target)
+        return { kind: "not-found" };
+    if (target.type !== "suggestion")
+        return { kind: "not-suggestion" };
+    const abs = ws.toAbs(target.file);
+    const original = await readFile(abs, "utf8");
+    // The decoded content is the proposed replacement (markdown source). It
+    // replaces the entire begin/end pair plus the target region between them.
+    const replacement = ensureTrailingNewline(decodeAnnotationContent(target.instruction));
+    const newContent = original.slice(0, target.beginLineStart) + replacement + original.slice(target.endLineEnd);
+    await writeFile(abs, newContent, "utf8");
+    firstSeenAt.delete(id);
+    return { kind: "ok", file: target.file, author: target.author, replacement };
+}
+function ensureTrailingNewline(s) {
+    return s.endsWith("\n") ? s : `${s}\n`;
+}
+//# sourceMappingURL=annotation-ops.js.map

package/dist/server/annotation-ops.js.map

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

package/dist/server/args.d.ts

@@ -0,0 +1,20 @@
+export type Subcommand = "serve" | "stdio" | "init";
+export type ParsedArgs = {
+    subcommand: Subcommand;
+    /** Set when subcommand is `init`. */
+    initAgent: string | undefined;
+    /** Set when subcommand is `init` and the user passed `--yes`. */
+    yes: boolean;
+    port: number | undefined;
+    scope: string | undefined;
+    /** Undefined when --browser was not passed; resolves from local.json or
+     * the "default" fallback at the call site. */
+    browser: string | undefined;
+    verbose: boolean;
+    quiet: boolean;
+    helpRequested: boolean;
+};
+export declare class ArgsError extends Error {
+}
+export declare function parseArgs(argv: string[]): ParsedArgs;
+export declare function helpText(): string;

package/dist/server/args.js

@@ -0,0 +1,118 @@
+export class ArgsError extends Error {
+}
+export function parseArgs(argv) {
+    const out = {
+        subcommand: "serve",
+        initAgent: undefined,
+        yes: false,
+        port: undefined,
+        scope: undefined,
+        browser: undefined,
+        verbose: false,
+        quiet: false,
+        helpRequested: false,
+    };
+    // Subcommand detection: first non-flag positional argument selects the
+    // subcommand. `--stdio` is a flag, not a positional, so we handle it
+    // alongside other flags. Slice 01 only had `serve`; slice 02 adds
+    // `init` (and the `--stdio` invite hook).
+    let i = 0;
+    const first = argv[0];
+    if (first === "init") {
+        out.subcommand = "init";
+        i = 1;
+        // `init <agent>` is also accepted: read the next positional as the
+        // agent name.
+        if (argv[i] !== undefined && !argv[i].startsWith("--")) {
+            out.initAgent = argv[i];
+            i += 1;
+        }
+    }
+    for (; i < argv.length; i++) {
+        const a = argv[i];
+        switch (a) {
+            case "--port":
+            case "-p": {
+                const v = argv[++i];
+                // parseInt silently coerces "123abc" -> 123 and "1.5" -> 1, both of
+                // which can land the user on a port they did not ask for. Match
+                // strict decimal-digit form first.
+                if (!v || !/^\d+$/.test(v)) {
+                    throw new ArgsError(`--port expects a non-negative integer (got ${v ?? "<missing>"})`);
+                }
+                const n = Number.parseInt(v, 10);
+                if (n > 65_535) {
+                    throw new ArgsError(`--port out of range 0-65535 (got ${n})`);
+                }
+                out.port = n;
+                break;
+            }
+            case "--scope": {
+                const v = argv[++i];
+                if (!v)
+                    throw new ArgsError("--scope expects a glob");
+                out.scope = v;
+                break;
+            }
+            case "--browser": {
+                const v = argv[++i];
+                if (!v)
+                    throw new ArgsError("--browser expects a value (default, none, chrome, ...)");
+                out.browser = v;
+                break;
+            }
+            case "--stdio":
+                if (out.subcommand !== "serve") {
+                    throw new ArgsError("--stdio cannot be combined with a subcommand");
+                }
+                out.subcommand = "stdio";
+                break;
+            case "--yes":
+            case "-y":
+                out.yes = true;
+                break;
+            case "--verbose":
+                out.verbose = true;
+                break;
+            case "--quiet":
+                out.quiet = true;
+                break;
+            case "--help":
+            case "-h":
+                out.helpRequested = true;
+                break;
+            default:
+                if (a.startsWith("--")) {
+                    throw new ArgsError(`unknown flag: ${a}`);
+                }
+                throw new ArgsError(`unexpected argument: ${a}`);
+        }
+    }
+    return out;
+}
+export function helpText() {
+    return [
+        "Usage: sidebar [subcommand] [options]",
+        "",
+        "Local-first markdown editor and MCP server for human-agent doc collaboration.",
+        "",
+        "Subcommands:",
+        "  (default)         Run sidebar standalone (HTTP MCP + editor).",
+        "  init [agent]      Write a project-local .mcp.json that spawns sidebar via",
+        "                    stdio. Defaults to claude-code when no agent is named.",
+        "                    Pass --yes to skip the interactive prompt.",
+        "  --stdio           Internal: spawned by an MCP client. Becomes primary or",
+        "                    proxy depending on .sidebar/connection.json.",
+        "",
+        "Options:",
+        "  --port <N>        Bind a specific HTTP port. --port 0 picks any free port.",
+        "                    Without --port, sidebar tries 5180-5189 in order.",
+        "  --scope <glob>    Override the default workspace glob (docs/**/*.md).",
+        "  --browser <name>  default | none | <app-name>. `none` skips browser launch.",
+        "  --verbose         Raise log level to DEBUG.",
+        "  --quiet           Lower log level to WARN.",
+        "  -h, --help        Show this help.",
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=args.js.map

package/dist/server/args.js.map

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

package/dist/server/author.d.ts

@@ -0,0 +1 @@
+export declare function resolveHumanAuthor(cwd: string, env?: Record<string, string | undefined>): string;