@agent-workshop/adoc 0.1.0

package/LICENSE

@@ -0,0 +1,5 @@
+Copyright (C) 2026 adoc contributors
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,96 @@
+# adoc
+
+adoc is a place where you and a coding agent work on documents together. The documents are plain files in your
+repository, such as notes, TODO lists, task work orders, boards and drawings, and each kind comes from a **plugin**.
+
+- **The agent edits the files** with the `adoc` command line or its MCP tool, and commits them.
+- **You read them rendered in a web UI**, comment on a section or on selected text, edit them, or press their buttons.
+  Each of those reaches the agent as a **message**; in a herdr pane it arrives as a prompt, and the
+  web UI shows the agent's terminal beside the documents.
+
+adoc does not depend on one agent: any agent that can run a command or use MCP can work with it.
+
+## How it looks
+
+Select text in a document and comment on it; the comment carries the quote and its `file:line`.
+
+![Commenting on selected text](https://raw.githubusercontent.com/dirty49374/adoc/HEAD/samples/screenshots/comment.png)
+
+Send it, and it reaches the agent's herdr pane as a prompt. The web UI shows that terminal beside the documents.
+
+![The agent receives the comment and works](https://raw.githubusercontent.com/dirty49374/adoc/HEAD/samples/screenshots/agent-working.png)
+
+When the agent has edited the documents, the web UI marks what changed since you last looked.
+
+![Changed sections marked after the agent's edit](https://raw.githubusercontent.com/dirty49374/adoc/HEAD/samples/screenshots/changes.png)
+
+Plugins bring their own views and actions: a click on a TODO item asks the agent to do it, a board shows where work
+stands, and a sketch shows the agent what you mean.
+
+![Asking the agent to do a TODO item](https://raw.githubusercontent.com/dirty49374/adoc/HEAD/samples/screenshots/todo-request.png)
+
+| KANBAN | SKETCH |
+|---|---|
+| ![A KANBAN board](https://raw.githubusercontent.com/dirty49374/adoc/HEAD/samples/screenshots/kanban.png) | ![A SKETCH wireframe](https://raw.githubusercontent.com/dirty49374/adoc/HEAD/samples/screenshots/sketch.png) |
+
+The screenshots come from [`samples/`](https://github.com/dirty49374/adoc/blob/HEAD/samples/), a todo app team's workspace with Claude Code as its agent.
+
+## Requirements
+
+- Node.js 24 or later
+- git (recommended: the agent commits every change)
+- herdr 0.9.3 or later (recommended), for pushed messages and the terminal in the web UI
+
+## Install
+
+```sh
+npm install -g @agent-workshop/adoc
+```
+
+This installs the `adoc` command, the web UI and the five plugins of adoc: NOTE (shared notes), TODO (task lists), TASK
+(work orders), KANBAN (a board) and SKETCH (drawings).
+
+## Quick start
+
+```sh
+cd my-project               # a git repository
+adoc init                   # .adoc/adoc.yaml with the five plugins, and docs/
+adoc skill install          # teaches your agents adoc and each plugin (agent skills)
+adoc server run             # the web UI at http://127.0.0.1:7700
+```
+
+Then start your agent in a herdr pane and let it run `adoc agent claim`: your comments and actions in the web UI are
+pushed into that pane. Without herdr, set `agent.transport.kind: wait` in `.adoc/adoc.yaml`, and the agent takes its
+messages with `adoc message wait`.
+
+The agent learns the rest from its skills: `adoc skill view adoc` shows what it reads.
+
+## Configuration
+
+`.adoc/adoc.yaml` declares which plugins the workspace uses, as `KEY: <source>`, laid over your own
+`~/.config/adoc/adoc.yaml`. Paths are relative to the file:
+
+```yaml
+plugins:
+  NOTE: npm:@agent-workshop/adoc-plugin-note     # an npm package (the five come with adoc)
+  TASK: ./plugins/task                           # a folder, here .adoc/plugins/task
+  MIND: github:someone/adoc-plugins/mindmap#v1   # fetched by `adoc plugin install`
+watch:
+  - ../docs
+ui:
+  tabs: [NOTE, TASK, MIND]
+```
+
+A plugin is a folder with `index.ts` and `skill/SKILL.md`; `adoc skill view adoc-plugin-authoring` explains how to write
+one.
+
+## Security
+
+The server listens on `127.0.0.1` by default. With `server.host: 0.0.0.0` it accepts the internal network **without
+authentication**: anyone who reaches the port can read and edit the documents and control the agent's terminal.
+
+## License
+
+adoc is released under the [Zero-Clause BSD License](https://github.com/dirty49374/adoc/blob/HEAD/LICENSE). The bundled browser code and fonts keep their own
+licenses; see [THIRD_PARTY_NOTICES.md](https://github.com/dirty49374/adoc/blob/HEAD/THIRD_PARTY_NOTICES.md). To work on adoc itself, see
+[CONTRIBUTING.md](https://github.com/dirty49374/adoc/blob/HEAD/CONTRIBUTING.md).

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,49 @@
+# Third-party notices
+
+adoc's original code and documentation use the Zero-Clause BSD License (0BSD). That license does not replace the
+licenses of third-party components, and no third-party component is relicensed by this repository.
+
+## Browser distributions
+
+Two packages carry bundled browser code:
+
+- `@agent-workshop/adoc-webapp`: the web UI in `dist/`. Its build records the packages actually bundled in
+  `dist/licenses/packages.json` and copies their upstream LICENSE, COPYING, COPYRIGHT and NOTICE files beneath
+  `dist/licenses/`.
+- `@agent-workshop/adoc-plugin-sketch`: the drawing board in `client/`, with its inventory and license files in
+  `client/licenses/`.
+
+Keep these files when redistributing the built browser assets.
+
+The main browser dependencies are React, React DOM, React Router, Mermaid (with KaTeX), xterm.js and Lucide in the web
+UI, and Excalidraw with React and Radix UI in the drawing board. Most use MIT, ISC, BSD or Apache-2.0.
+
+- DOMPurify offers MPL-2.0 OR Apache-2.0; adoc uses the Apache-2.0 option.
+- Some packages are published without a license file although their manifest names one: Excalidraw, the Radix UI
+  primitives, react-remove-scroll-bar and fastdom (all MIT). The build includes the upstream texts kept in
+  `tooling/licenses/`.
+
+### Eclipse Layout Kernel / elkjs
+
+Mermaid bundles elkjs, a separately licensed layout engine, which adoc uses under EPL-2.0 without modifying it. Its
+license is included in the generated license inventory. Corresponding source is available from:
+
+- https://github.com/kieler/elkjs (select the release matching the inventory version)
+- https://github.com/eclipse/elk (the underlying Eclipse Layout Kernel)
+- https://www.eclipse.org/legal/epl-2.0/
+
+Recipients may obtain, modify and redistribute the EPL-covered source under EPL-2.0. adoc's 0BSD license applies to its
+independent code, not to ELK.
+
+## Fonts
+
+- The web UI serves Pretendard, D2Coding (both SIL Open Font License 1.1) and Symbols Nerd Font Mono; their license
+  files are next to them in `dist/assets/fonts/`.
+- The drawing board serves the fonts that Excalidraw ships in `client/fonts/` (Excalifont, Virgil, Nunito, Lilita One,
+  Comic Shanns, Cascadia Code, Liberation Sans, Assistant and Xiaolai); they are distributed under the terms that
+  Excalidraw states for them in https://github.com/excalidraw/excalidraw.
+
+## Installed runtime dependencies
+
+The packages that npm installs next to adoc, such as the MCP SDK, ws, yaml, zod, semver, commander, markdown-it and
+highlight.js, are not bundled: each keeps its own license in its own package.

package/dist/commands.d.ts

@@ -0,0 +1,9 @@
+import type { CommandContext, CommandDefinition } from './contracts.js';
+type Options = Record<string, unknown> & {
+    home?: string;
+};
+/** The _Skill_Check_ findings for the workspace of the command; none when there is no workspace. */
+export declare function skillWarnings(options: Options, context: CommandContext): Promise<string[]>;
+export declare const commands: readonly CommandDefinition[];
+export declare const groups: Record<string, string>;
+export {};

package/dist/commands.js

@@ -0,0 +1,383 @@
+import { mkdir, writeFile, access } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { AdocError, AdocServer, CONFIG_TEMPLATE, checkSkills, discoverHome, fetchGithubPlugins, formatCheck, installSkills, listSkills, readClaim, readConfig, resolveAgentPane, writeClaim, CLAIM_FILE, ServerClient, uninstallSkills, viewSkill, Workspace, } from '@agent-workshop/adoc-core';
+import { createMcpEndpoint, serveStdio } from './mcp.js';
+const WAIT_ROUND_MS = 60_000;
+const opened = new WeakMap();
+/** Opens the workspace once per command run; the command and the _Skill_Check_ after it share it. */
+function openWorkspace(options, context) {
+    let workspace = opened.get(context);
+    if (!workspace) {
+        workspace = discoverHome(context.cwd, options.home, context.env).then((home) => Workspace.open(home, context.env));
+        opened.set(context, workspace);
+    }
+    return workspace;
+}
+/** The _Skill_Check_ findings for the workspace of the command; none when there is no workspace. */
+export async function skillWarnings(options, context) {
+    let workspace;
+    try {
+        workspace = await openWorkspace(options, context);
+    }
+    catch {
+        return [];
+    }
+    return (await checkSkills(workspace, context.env.HOME)).map((entry) => entry.message);
+}
+async function client(options, context) {
+    const home = await discoverHome(context.cwd, options.home, context.env);
+    const server = await ServerClient.find(await readConfig(home, context.env), home.workspace);
+    await server.ensure();
+    return server;
+}
+function agentsOption(options) {
+    return Array.isArray(options.agent) ? options.agent.map(String) : undefined;
+}
+/** An ISO time as local `YYYY-MM-DD HH:MM`. */
+function localTime(iso) {
+    const t = new Date(iso);
+    const two = (n) => String(n).padStart(2, '0');
+    return `${t.getFullYear()}-${two(t.getMonth() + 1)}-${two(t.getDate())} ${two(t.getHours())}:${two(t.getMinutes())}`;
+}
+/** The options of the _Document_Find_Command_. */
+function findOptions(options) {
+    return { ...(typeof options.plugin === 'string' ? { pluginKey: options.plugin } : {}), archived: options.archived === true };
+}
+function table(rows) {
+    if (!rows.length)
+        return '';
+    const widths = rows[0].map((_, i) => Math.max(...rows.map((r) => (r[i] ?? '').length)));
+    return rows.map((r) => r.map((cell, i) => (i === r.length - 1 ? cell : cell.padEnd(widths[i]))).join('  ')).join('\n');
+}
+/** Runs until SIGINT, SIGTERM or the given promise settles. */
+async function foreground(stop) {
+    await new Promise((done) => {
+        const finish = () => {
+            process.off('SIGINT', finish);
+            process.off('SIGTERM', finish);
+            void stop().then(done, done);
+        };
+        process.on('SIGINT', finish);
+        process.on('SIGTERM', finish);
+    });
+}
+function messagesResult(body, empty) {
+    const data = body.messages.map(({ formatted: _formatted, ...fields }) => fields);
+    return { data, text: body.messages.length ? body.messages.map((m) => m.formatted).join('\n') : empty };
+}
+/** `adoc plugin install` and `adoc plugin update`: one line per GitHub source; fails when one could not be fetched. */
+async function fetchCommand(options, context, choice) {
+    const home = await discoverHome(context.cwd, options.home, context.env);
+    const outcomes = await fetchGithubPlugins(await readConfig(home, context.env), choice, context.env);
+    const text = outcomes.length
+        ? outcomes.map((o) => `${o.key} ${o.status}${o.commit ? ` ${o.commit.slice(0, 12)}` : ''}${o.reason ? `: ${o.reason}` : ''}`).join('\n')
+        : 'No GitHub plugin sources are declared.';
+    const failed = outcomes.filter((o) => o.status === 'refused' || o.status === 'failed');
+    if (failed.length)
+        throw new AdocError('plugin.fetch', text);
+    return { data: outcomes, text };
+}
+export const commands = [
+    {
+        name: 'init',
+        argument: '[directory]',
+        options: [],
+        summary: 'Create .adoc/adoc.yaml, declaring the five plugins of adoc, and a docs folder in a directory.',
+        behavior: 'Refuses when the directory already has an .adoc folder with adoc.yaml. Does not run git init; keep the workspace in a git repository so that the agent can commit.',
+        example: 'adoc init .',
+        localOnly: true,
+        async run(args, _options, context) {
+            const root = resolve(context.cwd, args[0] ?? '.');
+            const configPath = join(root, '.adoc', 'adoc.yaml');
+            try {
+                await access(configPath);
+                throw new AdocError('init.exists', `${configPath} already exists.`);
+            }
+            catch (error) {
+                if (error instanceof AdocError)
+                    throw error;
+            }
+            await mkdir(join(root, '.adoc'), { recursive: true });
+            await mkdir(join(root, 'docs'), { recursive: true });
+            await writeFile(configPath, CONFIG_TEMPLATE);
+            await writeFile(join(root, '.adoc', '.gitignore'), `${CLAIM_FILE}\n`);
+            return { data: { configPath }, text: `Initialized ${configPath} with the five plugins of adoc.\nNext: adoc skill install, then adoc server run.` };
+        },
+    },
+    {
+        name: 'server run',
+        options: [
+            ['--host <address>', 'override server.host'],
+            ['--port <port>', 'override server.port'],
+            ['--agent-pane <pane>', 'claim this herdr pane for the assigned agent before starting'],
+        ],
+        summary: 'Run the adoc server for this workspace in the foreground.',
+        behavior: 'Serves the web UI, the REST API, live events and MCP at /mcp; watches the watch paths; holds user messages until delivery. Refuses to start on a port in use. Prints the adoc check report at start. Ctrl-C stops it.',
+        example: 'adoc server run --port 7700',
+        localOnly: true,
+        async run(_args, options, context) {
+            const workspace = await openWorkspace(options, context);
+            if (typeof options.agentPane === 'string')
+                await writeClaim(workspace.home, await resolveAgentPane(context.env, { pane: options.agentPane }));
+            const serverOptions = { extensions: [createMcpEndpoint(context)], log: (line) => context.streams.stderr(line + '\n') };
+            if (typeof options.host === 'string')
+                serverOptions.host = options.host;
+            if (options.port !== undefined)
+                serverOptions.port = Number(options.port);
+            const server = new AdocServer(workspace, serverOptions);
+            await server.start();
+            await foreground(() => server.stop());
+        },
+    },
+    {
+        name: 'mcp run',
+        options: [
+            ['--with-server', 'also host the adoc server in this process'],
+            ['--port <port>', 'override server.port; requires --with-server'],
+        ],
+        summary: 'Serve the adoc MCP tool over stdio.',
+        behavior: 'Exposes one tool, adoc({cmd, stdin}), that runs any adoc command without the executable prefix. Standard output carries only MCP messages. With --with-server the adoc server runs in the same process and stops when stdio closes.',
+        example: 'adoc mcp run --with-server',
+        localOnly: true,
+        async run(_args, options, context) {
+            let server;
+            if (options.withServer) {
+                const workspace = await openWorkspace(options, context);
+                const serverOptions = { extensions: [createMcpEndpoint(context)], log: (line) => context.streams.stderr(line + '\n') };
+                if (options.port !== undefined)
+                    serverOptions.port = Number(options.port);
+                server = new AdocServer(workspace, serverOptions);
+                await server.start();
+            }
+            else if (options.port !== undefined) {
+                throw new AdocError('cli.option', '--port requires --with-server');
+            }
+            await serveStdio(context);
+            await server?.stop();
+        },
+    },
+    {
+        name: 'message wait',
+        options: [['--timeout <seconds>', 'return with no message after this many seconds']],
+        summary: 'Wait for user messages and receive every held message.',
+        behavior: 'Blocks until the adoc server holds at least one user message, then returns all held messages in creation order, each in the adoc message format, and the server forgets them. Without --timeout it waits indefinitely. Fails when no adoc server is running.',
+        example: 'adoc message wait --timeout 600',
+        async run(_args, options, context) {
+            const server = await client(options, context);
+            // Long-poll in rounds shorter than fetch's own response timeout, until messages arrive or --timeout ends.
+            const deadline = options.timeout !== undefined ? Date.now() + Number(options.timeout) * 1000 : Infinity;
+            for (;;) {
+                const round = Math.max(0, Math.min(WAIT_ROUND_MS, deadline - Date.now()));
+                const body = await server.get(`/api/messages/wait?timeout=${round}`);
+                if (body.messages.length || Date.now() >= deadline)
+                    return messagesResult(body, '(no messages)');
+            }
+        },
+    },
+    {
+        name: 'message list',
+        options: [],
+        summary: 'Show held user messages without delivering them.',
+        behavior: 'Lists the messages the adoc server still holds, in the adoc message format. Fails when no adoc server is running.',
+        example: 'adoc message list',
+        async run(_args, options, context) {
+            const server = await client(options, context);
+            return messagesResult(await server.get('/api/messages'), '(no held messages)');
+        },
+    },
+    {
+        name: 'plugin list',
+        options: [],
+        summary: 'List the plugins declared in adoc.yaml.',
+        behavior: 'Shows each plugin key in tab order, its number of documents (archived ones left out), its source and its description, or its load error.',
+        example: 'adoc plugin list',
+        async run(_args, options, context) {
+            const plugins = (await openWorkspace(options, context)).pluginInfos();
+            const rows = [['KEY', 'DOCUMENTS', 'SOURCE', 'DESCRIPTION'], ...plugins.map((p) => [p.key, String(p.documents), p.source, p.error ? `ERROR: ${p.error}` : p.description ?? ''])];
+            return { data: plugins, text: plugins.length ? table(rows) : 'No plugins are declared in adoc.yaml.' };
+        },
+    },
+    {
+        name: 'plugin install',
+        options: [],
+        summary: 'Fetch the GitHub plugin sources that are declared but not fetched yet.',
+        behavior: 'Fetches each github:<owner>/<repo>/<folder>#<ref> source into plugins/<key in lowercase>/ next to the config file that declares it, and records the commit in plugins-lock.json there. npm sources are installed with npm. Then run adoc skill install, and restart a running server.',
+        example: 'adoc plugin install',
+        localOnly: true,
+        async run(_args, options, context) {
+            return fetchCommand(options, context, { update: false });
+        },
+    },
+    {
+        name: 'plugin update',
+        argument: '[keys...]',
+        options: [],
+        summary: 'Fetch GitHub plugin sources again, all or the given plugin keys.',
+        behavior: 'Refuses a fetched folder whose files were changed; copy it to another folder to change a plugin. npm sources are updated with npm. Then run adoc skill update, and restart a running server.',
+        example: 'adoc plugin update SKETCH',
+        localOnly: true,
+        async run(args, options, context) {
+            return fetchCommand(options, context, { update: true, keys: args });
+        },
+    },
+    {
+        name: 'document list',
+        options: [
+            ['--plugin <key>', 'only documents of this plugin key, such as TASK'],
+            ['--archived', 'only archived documents (inside an _archive folder)'],
+        ],
+        summary: 'List documents, newest first, without archived ones.',
+        behavior: 'Shows the key, status, last update, title and path of every document, by last update, newest first. Archived documents (inside an _archive folder) are left out; --archived shows only them.',
+        example: 'adoc document list --plugin TASK',
+        async run(_args, options, context) {
+            const found = (await openWorkspace(options, context)).findDocuments(findOptions(options));
+            const rows = [['KEY', 'STATUS', 'UPDATED', 'TITLE', 'PATH'], ...found.map((d) => [d.key, d.summary?.status ?? 'ERROR', localTime(d.updatedAt), d.summary?.title ?? d.error ?? '', d.path])];
+            return { data: found, text: found.length ? table(rows) : `No ${options.archived ? 'archived ' : ''}documents.` };
+        },
+    },
+    {
+        name: 'document search',
+        argument: '<text>',
+        options: [
+            ['--plugin <key>', 'only documents of this plugin key, such as TASK'],
+            ['--archived', 'only archived documents (inside an _archive folder)'],
+        ],
+        summary: 'Find the lines of documents that contain a text, without archived documents.',
+        behavior: 'Prints every line of a document file that contains the text, case-insensitive, as path:line, key and line. Archived documents (inside an _archive folder) are left out; --archived searches only them.',
+        example: 'adoc document search "cursor paging"',
+        async run(args, options, context) {
+            const hits = (await openWorkspace(options, context)).searchDocuments(args[0], findOptions(options));
+            return { data: hits, text: hits.length ? hits.map((h) => `${h.path}:${h.line}  ${h.key}  ${h.text}`).join('\n') : `No ${options.archived ? 'archived ' : ''}document contains "${args[0]}".` };
+        },
+    },
+    {
+        name: 'skill list',
+        options: [],
+        summary: 'List the agent skills adoc can show or install.',
+        behavior: 'Lists the skill adoc (the assigned agent\'s workflow) and adoc-plugin-authoring in user scope, and the skill of every loaded plugin in the scope of that plugin, with its folder.',
+        example: 'adoc skill list',
+        async run(_args, options, context) {
+            const skills = await listSkills(await openWorkspace(options, context));
+            return { data: skills, text: table([['NAME', 'SCOPE', 'DESCRIPTION'], ...skills.map((s) => [s.name, s.scope, s.description])]) };
+        },
+    },
+    {
+        name: 'skill view',
+        argument: '<name>',
+        options: [],
+        summary: 'Show one agent skill by its name from adoc skill list.',
+        behavior: 'Prints the SKILL.md of the skill without its front matter. Plugin skills are named adoc-<plugin key in lowercase>, such as adoc-todo.',
+        example: 'adoc skill view adoc-todo',
+        async run(args, options, context) {
+            const { entry, body } = await viewSkill(await openWorkspace(options, context), args[0]);
+            return { data: { ...entry, body }, text: body };
+        },
+    },
+    ...['install', 'update'].map((verb) => ({
+        name: `skill ${verb}`,
+        options: [['--agent <names...>', 'the agents to install for, such as claude-code codex (default: what the skills CLI detects)']],
+        summary: verb === 'install' ? 'Install every agent skill for the agents.' : 'Install every agent skill again, replacing the installed copies.',
+        behavior: 'Runs the Vercel skills CLI (npx -y skills@1, or ADOC_SKILLS_CLI) as `skills add <folder>` for each skill listed by adoc skill list: user scope (--global) for adoc and adoc-plugin-authoring and for plugins outside the workspace, project scope for plugins inside it. Only the skill/ folder is installed, never plugin code.',
+        example: `adoc skill ${verb} --agent claude-code codex`,
+        localOnly: true,
+        async run(_args, options, context) {
+            const skills = await installSkills(await openWorkspace(options, context), { agents: agentsOption(options), env: context.env });
+            return { data: skills, text: `Installed ${skills.length} skills: ${skills.map((s) => `${s.name} (${s.scope})`).join(', ')}` };
+        },
+    })),
+    {
+        name: 'skill uninstall',
+        options: [['--agent <names...>', 'the agents to remove the skills from (default: what the skills CLI detects)']],
+        summary: 'Remove every agent skill of the workspace from the agents.',
+        behavior: 'Runs `skills remove <names>` of the Vercel skills CLI for the skills listed by adoc skill list, per scope.',
+        example: 'adoc skill uninstall',
+        localOnly: true,
+        async run(_args, options, context) {
+            const skills = await uninstallSkills(await openWorkspace(options, context), { agents: agentsOption(options), env: context.env });
+            return { data: skills, text: `Removed ${skills.map((s) => s.name).join(', ')}` };
+        },
+    },
+    {
+        name: 'ui list',
+        options: [],
+        summary: 'List the browser sessions of the adoc web UI, most recent first.',
+        behavior: 'Shows each browser tab connected to the adoc server: its session id, whether it is connected, its last access and the page it shows. Fails when no adoc server is running.',
+        example: 'adoc ui list',
+        async run(_args, options, context) {
+            const server = await client(options, context);
+            const { sessions } = await server.get('/api/ui/sessions');
+            const rows = [['SESSION', 'STATE', 'LAST ACCESS', 'LOCATION'], ...sessions.map((s) => [s.id, s.connected ? 'connected' : 'closed', s.lastAccess, s.location])];
+            return { data: sessions, text: sessions.length ? table(rows) : 'No browser session has connected yet.' };
+        },
+    },
+    {
+        name: 'ui open',
+        argument: '<target>',
+        options: [['--session <id>', 'the browser session to move (default: the connected session accessed last)']],
+        summary: 'Show a document, an anchor or a plugin in a browser session.',
+        behavior: 'Sends the browser session accessed most recently, or the one named by --session, to the target: a document key such as NOTE-261002-idea, a key with an anchor such as TASK-a#goal, or a plugin key such as TODO. Fails when no browser session is connected.',
+        example: 'adoc ui open NOTE-261002-note-plugin',
+        async run(args, options, context) {
+            const server = await client(options, context);
+            const body = { target: args[0] };
+            if (typeof options.session === 'string')
+                body.session = options.session;
+            const opened = await server.post('/api/ui/open', body);
+            return { data: opened, text: `Opened ${opened.location} in browser session ${opened.session}.` };
+        },
+    },
+    {
+        name: 'agent claim',
+        options: [
+            ['--pane <pane>', 'the herdr pane to claim, such as w2B:p1'],
+            ['--herdr-session <name>', 'look for the pane only in this herdr session'],
+        ],
+        summary: 'Make your herdr pane the assigned agent of this workspace.',
+        behavior: 'Finds your herdr pane: --pane if given; else the pane whose agent session is your session id (CLAUDE_CODE_SESSION_ID or CODEX_SESSION_ID); else HERDR_PANE_ID, unless you run under a shared agent daemon. Writes .adoc/claim.yaml; a running adoc server follows it at once, pushes user messages to that pane and shows its terminal. Claiming from another pane takes the role over.',
+        example: 'adoc agent claim',
+        async run(_args, options, context) {
+            const home = await discoverHome(context.cwd, options.home, context.env);
+            const resolveOptions = {};
+            if (typeof options.pane === 'string')
+                resolveOptions.pane = options.pane;
+            if (typeof options.herdrSession === 'string')
+                resolveOptions.herdrSession = options.herdrSession;
+            const resolved = await resolveAgentPane(context.env, resolveOptions);
+            const claim = await writeClaim(home, resolved);
+            return { data: { ...claim, via: resolved.via }, text: `Claimed herdr pane ${claim.pane} (${claim.herdrSession}${claim.agent ? `, ${claim.agent}` : ''}) as the assigned agent, found by ${resolved.via}.` };
+        },
+    },
+    {
+        name: 'agent show',
+        options: [],
+        summary: 'Show which herdr pane is the assigned agent.',
+        behavior: 'Prints the claim in .adoc/claim.yaml, or says that no agent has claimed the workspace.',
+        example: 'adoc agent show',
+        async run(_args, options, context) {
+            const claim = await readClaim(await discoverHome(context.cwd, options.home, context.env));
+            return { data: claim ?? null, text: claim ? `herdr pane ${claim.pane} (${claim.herdrSession}${claim.agent ? `, ${claim.agent}` : ''}), claimed ${claim.claimedAt}` : 'No agent has claimed this workspace; run adoc agent claim in the agent pane.' };
+        },
+    },
+    {
+        name: 'check',
+        options: [],
+        summary: 'Report every warning and error of the workspace.',
+        behavior: 'Reports plugins that fail to load, duplicate document keys, invalid local ids, files whose prefix is not a declared plugin key, documents that fail to parse and broken document references. Changes nothing. Exits with status 1 when it reports an error.',
+        example: 'adoc check',
+        async run(_args, options, context) {
+            const entries = (await openWorkspace(options, context)).check();
+            return { data: entries, text: formatCheck(entries), exitCode: entries.some((e) => e.level === 'error') ? 1 : 0 };
+        },
+    },
+];
+export const groups = {
+    server: 'Run the adoc server',
+    mcp: 'Serve the adoc MCP tool',
+    message: 'Receive user messages',
+    plugin: 'Inspect declared plugins',
+    document: 'Find documents',
+    skill: 'Show and install agent skills',
+    ui: 'Inspect and control browser sessions of the web UI',
+    agent: 'Claim and show the assigned agent',
+};
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

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

package/dist/contracts.d.ts

@@ -0,0 +1,38 @@
+export type OutputFormat = 'text' | 'markdown' | 'json' | 'yaml';
+export interface Streams {
+    stdout(text: string): void;
+    stderr(text: string): void;
+}
+/** What every command receives besides its arguments. */
+export interface CommandContext {
+    readonly cwd: string;
+    readonly env: NodeJS.ProcessEnv;
+    readonly streams: Streams;
+    /** True when the command runs through the _Adoc_MCP_Tool_. */
+    readonly mcp: boolean;
+    /** Reads what the command would read from standard input. */
+    stdin(): Promise<string>;
+}
+/** A finite command result: structured data for json/yaml, text for text/markdown. */
+export interface CommandResult {
+    data: unknown;
+    text: string;
+    markdown?: string;
+    exitCode?: number;
+}
+export type OptionSpec = readonly [flags: string, description: string];
+/** One `adoc <noun> <verb>` command. */
+export interface CommandDefinition {
+    readonly name: string;
+    readonly argument?: string;
+    readonly options: readonly OptionSpec[];
+    readonly summary: string;
+    readonly behavior: string;
+    readonly example: string;
+    /** Refused through MCP: process and installation commands. */
+    readonly localOnly?: boolean;
+    /** Returns a result, or nothing for a long-running command that has finished. */
+    run(args: string[], options: Record<string, unknown> & {
+        home?: string;
+    }, context: CommandContext): Promise<CommandResult | void>;
+}

package/dist/contracts.js

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

package/dist/contracts.js.map

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

package/dist/entry.d.ts

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

package/dist/entry.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import { readFileSync } from 'node:fs';
+import { runCommand } from './program.js';
+process.stdout.on('error', (error) => {
+    if (error.code === 'EPIPE')
+        process.exit(process.exitCode ?? 0);
+    throw error;
+});
+process.exitCode = await runCommand(process.argv.slice(2), {
+    cwd: process.cwd(),
+    env: process.env,
+    mcp: false,
+    streams: { stdout: (t) => process.stdout.write(t), stderr: (t) => process.stderr.write(t) },
+    stdin: async () => readFileSync(0, 'utf8'),
+});
+//# sourceMappingURL=entry.js.map

package/dist/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAA4B,EAAE,EAAE;IAC1D,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;IAChE,MAAM,KAAK,CAAC;AACd,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,QAAQ,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IACzD,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;IAClB,GAAG,EAAE,OAAO,CAAC,GAAG;IAChB,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IAC3F,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC;CAC3C,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { buildProgram, runCommand } from './program.js';
+export { commands, groups } from './commands.js';
+export { commandArguments, runCaptured, createMcpEndpoint, serveStdio } from './mcp.js';
+export type { CommandContext, CommandDefinition, CommandResult, OutputFormat, Streams } from './contracts.js';

package/dist/index.js

@@ -0,0 +1,4 @@
+export { buildProgram, runCommand } from './program.js';
+export { commands, groups } from './commands.js';
+export { commandArguments, runCaptured, createMcpEndpoint, serveStdio } from './mcp.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}

package/dist/mcp.d.ts

@@ -0,0 +1,14 @@
+import { type ServerExtension } from '@agent-workshop/adoc-core';
+import type { CommandContext } from './contracts.js';
+/** Splits `cmd` like a shell would, refusing operators, globs and comments. */
+export declare function commandArguments(cmd: string): string[];
+/** Runs a command through the same code as the terminal and captures its output. */
+export declare function runCaptured(cmd: string, stdin: string | undefined, base: Pick<CommandContext, 'cwd' | 'env'>): Promise<{
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}>;
+/** Serves the _Adoc_MCP_Tool_ over stdio until the client closes. */
+export declare function serveStdio(context: CommandContext): Promise<void>;
+/** The `/mcp` route of the _Adoc_Server_: stateless, one connection per request. */
+export declare function createMcpEndpoint(context: Pick<CommandContext, 'cwd' | 'env'>): ServerExtension;

package/dist/mcp.js

@@ -0,0 +1,95 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { parse } from 'shell-quote';
+import { z } from 'zod';
+import { AdocError, errorMessage } from '@agent-workshop/adoc-core';
+import { commands } from './commands.js';
+import { runCommand } from './program.js';
+import { VERSION } from './version.js';
+const toolInput = z.object({ cmd: z.string().min(1), stdin: z.string().optional() });
+/** The tool, described from the command definitions so that its list of commands always matches the CLI. */
+function tool() {
+    const names = commands.filter((command) => !command.localOnly).map((command) => command.name);
+    return {
+        name: 'adoc',
+        description: 'Run one adoc CLI command without the leading "adoc", for example {"cmd": "message wait --timeout 600"} or {"cmd": "skill view adoc-todo"}. ' +
+            `Commands: ${names.join(', ')}. The other commands and --home work only on the command line. Use stdin for text the command reads from standard input.`,
+        inputSchema: z.toJSONSchema(toolInput),
+    };
+}
+/** Splits `cmd` like a shell would, refusing operators, globs and comments. */
+export function commandArguments(cmd) {
+    if (!cmd.trim())
+        throw new AdocError('command.empty', 'Supply one adoc command, without the executable prefix.');
+    const words = parse(cmd, (name) => '$' + name);
+    if (words.some((word) => typeof word !== 'string'))
+        throw new AdocError('command.syntax', 'Supply one command; quote shell operators, globs and # characters.');
+    return words;
+}
+/** Runs a command through the same code as the terminal and captures its output. */
+export async function runCaptured(cmd, stdin, base) {
+    let stdout = '';
+    let stderr = '';
+    const context = {
+        cwd: base.cwd,
+        env: base.env,
+        mcp: true,
+        streams: { stdout: (t) => (stdout += t), stderr: (t) => (stderr += t) },
+        stdin: async () => stdin ?? '',
+    };
+    let exitCode;
+    try {
+        exitCode = await runCommand(commandArguments(cmd), context);
+    }
+    catch (error) {
+        stderr += `adoc: ${errorMessage(error)}\n`;
+        exitCode = 1;
+    }
+    return { stdout, stderr, exitCode };
+}
+function createConnection(base) {
+    const server = new Server({ name: 'adoc', version: VERSION }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: [tool()] }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        if (request.params.name !== 'adoc')
+            return { content: [{ type: 'text', text: `unknown tool ${request.params.name}` }], isError: true };
+        const input = toolInput.safeParse(request.params.arguments ?? {});
+        if (!input.success)
+            return { content: [{ type: 'text', text: 'adoc needs {"cmd": "<command without adoc>"}' }], isError: true };
+        const result = await runCaptured(input.data.cmd, input.data.stdin, base);
+        const text = result.stdout + (result.stderr ? `${result.stdout ? '\n' : ''}[stderr]\n${result.stderr}` : '');
+        return { content: [{ type: 'text', text: text || '(no output)' }], structuredContent: { ...result }, isError: result.exitCode !== 0 };
+    });
+    return server;
+}
+/** Serves the _Adoc_MCP_Tool_ over stdio until the client closes. */
+export async function serveStdio(context) {
+    const server = createConnection(context);
+    const transport = new StdioServerTransport();
+    const closed = new Promise((done) => {
+        transport.onclose = () => done();
+        process.stdin.once('end', () => done());
+    });
+    await server.connect(transport);
+    await closed;
+    await server.close().catch(() => undefined);
+}
+/** The `/mcp` route of the _Adoc_Server_: stateless, one connection per request. */
+export function createMcpEndpoint(context) {
+    return async (request, response) => {
+        if (request.url?.split('?')[0] !== '/mcp')
+            return false;
+        const server = createConnection(context);
+        const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined, enableJsonResponse: true });
+        response.once('close', () => {
+            void transport.close();
+            void server.close();
+        });
+        await server.connect(transport);
+        await transport.handleRequest(request, response);
+        return true;
+    };
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/program.d.ts

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+import type { CommandContext } from './contracts.js';
+/** Builds the `adoc` command line. `exitCode` receives the status of the command that ran. */
+export declare function buildProgram(context: CommandContext, exitCode: (code: number) => void): Command;
+/** Runs one command line with the given context and returns its exit status. */
+export declare function runCommand(argv: readonly string[], context: CommandContext): Promise<number>;

package/dist/program.js

@@ -0,0 +1,100 @@
+import { Command, CommanderError, Option } from 'commander';
+import { stringify } from 'yaml';
+import { AdocError, errorMessage } from '@agent-workshop/adoc-core';
+import { commands, groups, skillWarnings } from './commands.js';
+import { VERSION } from './version.js';
+function render(result, format) {
+    switch (format) {
+        case 'json':
+            return JSON.stringify(result.data, null, 2);
+        case 'yaml':
+            return stringify(result.data, { lineWidth: 0 }).trimEnd();
+        case 'markdown':
+            return result.markdown ?? result.text;
+        case 'text':
+            return result.text;
+    }
+}
+/** Builds the `adoc` command line. `exitCode` receives the status of the command that ran. */
+export function buildProgram(context, exitCode) {
+    const program = new Command('adoc')
+        .description('adoc: plugin-defined documents kept in git, edited by an agent, commented on from a web UI.')
+        .version(VERSION)
+        .option('--home <path>', 'the .adoc directory to use (default: ADOC_HOME, then the nearest .adoc upward)')
+        .addOption(new Option('--output <format>', 'result format').choices(['text', 'markdown', 'json', 'yaml']).default('text'))
+        .showHelpAfterError()
+        .allowExcessArguments(false);
+    const execute = async (definition, args, options) => {
+        try {
+            if (context.mcp && (definition.localOnly || options.home !== undefined)) {
+                throw new AdocError('command.mcp', `adoc ${definition.name} and --home are local-only; run them from a terminal. MCP uses the workspace it was started in.`);
+            }
+            const result = await definition.run(args, options, context);
+            if (result) {
+                const text = render(result, options.output ?? 'text');
+                if (text)
+                    context.streams.stdout(text.endsWith('\n') ? text : text + '\n');
+                exitCode(result.exitCode ?? 0);
+            }
+            else {
+                exitCode(0);
+            }
+        }
+        catch (error) {
+            context.streams.stderr(`adoc: ${errorMessage(error)}\n`);
+            exitCode(1);
+        }
+        // _Skill_Check_ after every command, also through MCP (whose result carries stderr).
+        for (const warning of await skillWarnings(options, context))
+            context.streams.stderr(`adoc: warning: ${warning}\n`);
+    };
+    for (const definition of commands) {
+        const parts = definition.name.split(' ');
+        const leaf = parts.pop();
+        let parent = program;
+        for (const part of parts) {
+            let group = parent.commands.find((c) => c.name() === part);
+            if (!group) {
+                const description = groups[part];
+                if (!description)
+                    throw new Error(`no group description for ${part}`);
+                group = parent.command(part).description(description).allowExcessArguments(false);
+                const created = group;
+                created.action(() => created.outputHelp());
+            }
+            parent = group;
+        }
+        const command = parent.command(leaf + (definition.argument ? ` ${definition.argument}` : '')).description(definition.summary).allowExcessArguments(false);
+        for (const [flags, description] of definition.options)
+            command.option(flags, description);
+        command.addHelpText('after', `\nBehavior: ${definition.behavior}\n\nExample:\n  ${definition.example}\n`);
+        command.action(async (...received) => {
+            const current = received.at(-1);
+            const args = received.slice(0, -2).filter((a) => typeof a === 'string');
+            await execute(definition, args, current.optsWithGlobals());
+        });
+    }
+    return program;
+}
+/** Runs one command line with the given context and returns its exit status. */
+export async function runCommand(argv, context) {
+    let status = 0;
+    const program = buildProgram(context, (code) => {
+        status = code;
+    });
+    const configure = (command) => {
+        command.exitOverride().configureOutput({ writeOut: (t) => context.streams.stdout(t), writeErr: (t) => context.streams.stderr(t) });
+        command.commands.forEach(configure);
+    };
+    configure(program);
+    try {
+        await program.parseAsync([...argv], { from: 'user' });
+    }
+    catch (error) {
+        if (error instanceof CommanderError)
+            return error.code === 'commander.helpDisplayed' || error.code === 'commander.version' || error.exitCode === 0 ? 0 : 1;
+        throw error;
+    }
+    return status;
+}
+//# sourceMappingURL=program.js.map

package/dist/program.js.map

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

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION: string;

package/dist/version.js

@@ -0,0 +1,3 @@
+import { createRequire } from 'node:module';
+export const VERSION = createRequire(import.meta.url)('../package.json').version;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,OAAO,GAAY,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAyB,CAAC,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@agent-workshop/adoc",
+  "version": "0.1.0",
+  "license": "0BSD",
+  "type": "module",
+  "description": "adoc: the command line and MCP tool for a user and an agent working on plugin-defined documents.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dirty49374/adoc.git",
+    "directory": "packages/cli"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "bin": {
+    "adoc": "./dist/entry.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.30.1",
+    "commander": "15.0.0",
+    "shell-quote": "1.10.0",
+    "yaml": "2.9.0",
+    "zod": "4.5.4",
+    "@agent-workshop/adoc-core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/shell-quote": "1.7.5",
+    "@agent-workshop/adoc-testing": "0.1.0"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -b && node build.mjs",
+    "check": "tsc -b && tsc -p test",
+    "test": "vitest run --testTimeout 20000"
+  }
+}