@rafiqui987/markode 0.3.0 → 0.4.0

package/README.md

@@ -1,4 +1,4 @@
-# markode
+# <img src="docs/assets/logo.svg" alt="" width="32" height="32" align="top"> markode
 
 [![CI](https://github.com/rafiqui1987/markode/actions/workflows/ci.yml/badge.svg)](https://github.com/rafiqui1987/markode/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
@@ -369,6 +369,8 @@ missing description, a name that doesn't match its folder…).
 markode                     # set up the project if needed, then open the editor
 markode serve               # open the editor without the setup
 markode serve --port 5000 --no-open
+markode url [<doc.md>]      # the editor's link (or a doc's); starts it in the background if needed
+markode stop                # stop the editor started in the background
 markode init                # run the setup again: only adds modules (your defaults, if saved)
 markode init --profile full # no questions: viewer, agent or full
 markode init --yes          # no questions: your defaults, or viewer + AI agent
@@ -390,10 +392,11 @@ Installing it also makes the Claude Code hooks faster than running through `npx`
 
 The AI agent module installs the `markode` skill where the project's agents read skills
 (`.claude/skills/` for Claude Code, `.agents/skills/` for Codex, Copilot, Gemini and others). It tells
-the agent how to write Markdown that markode presents well, and gives it two commands:
+the agent how to write Markdown that markode presents well, and gives it three commands:
 
 | Command | What the agent does | When |
 |---|---|---|
+| `/markode` | Starts the editor in the background if it isn't running and gives you its link (`markode url`) | When you want to open markode |
 | `/markode sync` | Keeps the docs consistent: applies answered proposals, ticks phases from their tasks, checks the projects table and broken links (`markode check`) | Start and end of a session, after editing docs |
 | `/markode translate` | Translates what is behind; asks before changing any source file | Only when you ask |
 
@@ -404,6 +407,11 @@ enough. In the main doc it writes only between its markers:
 - `markode:workflow`: how the project plans its work (the markode method, OpenSpec or Spec Kit);
 - `markode:proposals`: how the agent writes proposals and answers comments.
 
+**Links to docs.** When the agent points you to a doc (a proposal it wrote, a doc it changed), it gives
+a link you can click in the terminal: `http://localhost:4319/open?path=docs/proposals/003-auth.md`. The
+markode tab you already have open shows that doc, and the tab the click opened closes itself, so you
+keep a single markode tab. With no markode tab open, the link opens the editor on that doc.
+
 When the agent writes a proposal, it runs `markode wait <proposal>` in the background: it waits
 without using tokens until you press "Done, send my answer", then hands the agent your choices, open
 questions and comments. If no session was open, the next one applies the answer first.
@@ -426,6 +434,7 @@ module, in projects that use Claude Code, markode adds three hooks to `.claude/s
 Without a global install the command is `npx -y --prefer-offline @rafiqui987/markode`.
 
 ```bash
+markode url [<doc.md>]                                # link to the editor or a doc (starts it if needed)
 markode check [--json]                                # what /markode sync fixes
 markode wait <proposal.md>                            # wait for the user's answer, then print it
 markode changes [--json]                              # the user's edits and comments since last told

package/dist/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 // src/cli/index.ts
-import fs20 from "fs";
-import path20 from "path";
+import fs21 from "fs";
+import path21 from "path";
 
 // src/core/changes.ts
 import crypto from "crypto";
@@ -1832,12 +1832,69 @@ function keepLanguage(root2, rel) {
   return detected;
 }
 
-// src/core/wait.ts
+// src/core/server.ts
+import { spawn } from "child_process";
 import fs17 from "fs";
 import path17 from "path";
+var serverFile = (root2) => path17.join(stateDir(root2), "server.json");
+var isAlive = (pid) => {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+};
+function recordServer(root2, port) {
+  const file = serverFile(root2);
+  fs17.mkdirSync(path17.dirname(file), { recursive: true });
+  assertInside(file);
+  fs17.writeFileSync(file, JSON.stringify({ port, pid: process.pid }));
+  process.once("exit", () => {
+    if (runningServer(root2)?.pid === process.pid) fs17.rmSync(file, { force: true });
+  });
+  for (const sig of ["SIGINT", "SIGTERM", "SIGHUP"]) process.once(sig, () => process.exit(130));
+}
+function runningServer(root2) {
+  try {
+    const s = JSON.parse(fs17.readFileSync(serverFile(root2), "utf8"));
+    return Number.isInteger(s.port) && Number.isInteger(s.pid) && isAlive(s.pid) ? { port: s.port, pid: s.pid } : null;
+  } catch {
+    return null;
+  }
+}
+async function responds(port) {
+  try {
+    return (await fetch(`http://127.0.0.1:${port}/api/info`, { signal: AbortSignal.timeout(1e3) })).ok;
+  } catch {
+    return false;
+  }
+}
+async function ensureServer(root2, cli2, port) {
+  const running = runningServer(root2);
+  if (running && await responds(running.port)) return running;
+  const child = spawn(process.execPath, [...process.execArgv, cli2, "serve", "--no-open", "--port", String(port)], {
+    cwd: root2,
+    env: { ...process.env, MARKODE_ROOT: root2 },
+    detached: true,
+    stdio: "ignore"
+  });
+  child.unref();
+  for (let i = 0; i < 100; i++) {
+    await new Promise((r) => setTimeout(r, 100));
+    const s = runningServer(root2);
+    if (s && s.pid === child.pid && await responds(s.port)) return s;
+  }
+  throw new Error("The editor did not start; run `markode serve` to see why.");
+}
+var editorUrl = (port, doc) => `http://localhost:${port}/${doc ? `open?path=${encodeURIComponent(doc).replace(/%2F/g, "/")}` : ""}`;
+
+// src/core/wait.ts
+import fs18 from "fs";
+import path18 from "path";
 import YAML5 from "yaml";
-var waitsDir = (root2) => path17.join(stateDir(root2), "waits");
-var pidFile = (root2, rel) => path17.join(waitsDir(root2), `${encodeURIComponent(rel)}.pid`);
+var waitsDir = (root2) => path18.join(stateDir(root2), "waits");
+var pidFile = (root2, rel) => path18.join(waitsDir(root2), `${encodeURIComponent(rel)}.pid`);
 var frontmatter2 = (text3) => {
   try {
     return YAML5.parse(/^---\r?\n([\s\S]*?)\r?\n---/.exec(text3)?.[1] ?? "", { logLevel: "error" }) ?? {};
@@ -1845,7 +1902,7 @@ var frontmatter2 = (text3) => {
     return {};
   }
 };
-var isAlive = (pid) => {
+var isAlive2 = (pid) => {
   try {
     process.kill(pid, 0);
     return true;
@@ -1856,27 +1913,27 @@ var isAlive = (pid) => {
 function waitingOn(root2) {
   let names2 = [];
   try {
-    names2 = fs17.readdirSync(waitsDir(root2)).filter((f) => f.endsWith(".pid"));
+    names2 = fs18.readdirSync(waitsDir(root2)).filter((f) => f.endsWith(".pid"));
   } catch {
   }
   return names2.flatMap((f) => {
-    const pid = Number(fs17.readFileSync(path17.join(waitsDir(root2), f), "utf8"));
-    return isAlive(pid) ? [decodeURIComponent(f.slice(0, -4))] : [];
+    const pid = Number(fs18.readFileSync(path18.join(waitsDir(root2), f), "utf8"));
+    return isAlive2(pid) ? [decodeURIComponent(f.slice(0, -4))] : [];
   });
 }
 function waitForAnswer(root2, rel) {
-  const abs = path17.join(root2, rel);
-  fs17.mkdirSync(waitsDir(root2), { recursive: true });
+  const abs = path18.join(root2, rel);
+  fs18.mkdirSync(waitsDir(root2), { recursive: true });
   assertInside(pidFile(root2, rel));
-  fs17.writeFileSync(pidFile(root2, rel), String(process.pid));
-  const cleanup = () => fs17.rmSync(pidFile(root2, rel), { force: true });
+  fs18.writeFileSync(pidFile(root2, rel), String(process.pid));
+  const cleanup = () => fs18.rmSync(pidFile(root2, rel), { force: true });
   process.once("exit", cleanup);
   for (const sig of ["SIGINT", "SIGTERM", "SIGHUP"]) process.once(sig, () => process.exit(130));
   return new Promise((resolve) => {
     const poll = () => {
       let text3;
       try {
-        text3 = fs17.readFileSync(abs, "utf8");
+        text3 = fs18.readFileSync(abs, "utf8");
       } catch {
         return resolve("gone");
       }
@@ -1890,7 +1947,7 @@ function waitForAnswer(root2, rel) {
 }
 var COMMENT = /^\s*<!-- (comment|reply) by (.+?), (\d{4}-\d{2}-\d{2})(?:, on "((?:[^"\\]|\\.)*)")?:\s?([\s\S]*?)\s*-->\s*$/;
 function answerSummary(root2, rel) {
-  const text3 = fs17.readFileSync(path17.join(root2, rel), "utf8");
+  const text3 = fs18.readFileSync(path18.join(root2, rel), "utf8");
   const fm = frontmatter2(text3);
   const body = text3.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/, "");
   const lines = body.split("\n");
@@ -1964,9 +2021,10 @@ function answerSummary(root2, rel) {
 }
 
 // src/server/index.ts
-import fs18 from "fs";
+import crypto3 from "crypto";
+import fs19 from "fs";
 import http from "http";
-import path18 from "path";
+import path19 from "path";
 import { watch } from "chokidar";
 import open from "open";
 import pc from "picocolors";
@@ -2034,7 +2092,7 @@ async function startServer({ root: root2, port, open: openBrowser }) {
     if (typeof rel !== "string" || !rel.trim()) throw new HttpError(400, "Expected a path");
     const abs = safeResolve(root2, rel);
     if (abs === root2) throw new HttpError(400, "Refusing to delete the project root");
-    if (!fs18.existsSync(abs)) throw new HttpError(404, "Not found");
+    if (!fs19.existsSync(abs)) throw new HttpError(404, "Not found");
     return abs;
   };
   const translationFile = (lang, rel) => {
@@ -2046,7 +2104,7 @@ async function startServer({ root: root2, port, open: openBrowser }) {
     "GET /api/info": () => {
       const c = config();
       return {
-        name: path18.basename(root2),
+        name: path19.basename(root2),
         mainDoc: c.mainDoc ?? null,
         sourceLang: sourceLang(),
         langs: langs().filter((l) => l !== sourceLang()),
@@ -2073,7 +2131,7 @@ async function startServer({ root: root2, port, open: openBrowser }) {
       }
       if (isLang(body.sourceLang) && body.sourceLang !== sourceLang()) {
         if (!c.mainDoc) throw new HttpError(400, "No main document configured; run `markode init`");
-        applyRulesToFile(path18.join(root2, c.mainDoc), void 0, body.sourceLang);
+        applyRulesToFile(path19.join(root2, c.mainDoc), void 0, body.sourceLang);
       }
       writeConfig(root2, c);
       return { ...c, langs: c.langs.filter((l) => l !== sourceLang()) };
@@ -2094,20 +2152,20 @@ async function startServer({ root: root2, port, open: openBrowser }) {
     "GET /api/waiting": () => ({ paths: waitingOn(root2) }),
     "GET /api/settings": () => readSettings(),
     "PUT /api/settings": (_, body) => writeSettings(body),
-    "GET /api/tree": (url2) => {
-      const l = viewLang(url2.searchParams.get("lang"));
+    "GET /api/tree": (url3) => {
+      const l = viewLang(url3.searchParams.get("lang"));
       const sync2 = l ? Object.fromEntries(allStatuses(root2, l).map((e) => [e.path, e.status])) : {};
       const foreign = featureState(root2).translations ? Object.fromEntries(foreignFiles(root2, sourceLang()).map((f) => [f.path, f.detected])) : {};
       return { tree: scanTree(root2), git: gitStatuses(root2), sync: sync2, foreign };
     },
     "POST /api/keep-language": (_, body) => ({ lang: keepLanguage(root2, mdPath(body.path)) }),
-    "GET /api/file": (url2) => {
-      const rel = mdPath(url2.searchParams.get("path"));
-      const l = viewLang(url2.searchParams.get("lang"));
-      const source = fs18.readFileSync(safeResolve(root2, rel), "utf8");
+    "GET /api/file": (url3) => {
+      const rel = mdPath(url3.searchParams.get("path"));
+      const l = viewLang(url3.searchParams.get("lang"));
+      const source = fs19.readFileSync(safeResolve(root2, rel), "utf8");
       if (l) {
         const tPath = translationFile(l, rel);
-        if (fs18.existsSync(tPath)) return { path: rel, content: fs18.readFileSync(tPath, "utf8"), target: "translation", status: fileStatus(root2, l, rel) };
+        if (fs19.existsSync(tPath)) return { path: rel, content: fs19.readFileSync(tPath, "utf8"), target: "translation", status: fileStatus(root2, l, rel) };
         return { path: rel, content: source, target: "source", status: "missing" };
       }
       return { path: rel, content: source, target: "source", status: null };
@@ -2116,19 +2174,19 @@ async function startServer({ root: root2, port, open: openBrowser }) {
       const rel = mdPath(body.path);
       const l = viewLang(body.lang);
       const file = body.target === "translation" && l ? translationFile(l, rel) : safeResolve(root2, rel);
-      fs18.mkdirSync(path18.dirname(file), { recursive: true });
+      fs19.mkdirSync(path19.dirname(file), { recursive: true });
       const content = String(body.content ?? "");
-      if (!l && featureState(root2).agent) logSave(root2, rel, fs18.existsSync(file) ? fs18.readFileSync(file, "utf8") : "", content);
-      fs18.writeFileSync(file, content);
+      if (!l && featureState(root2).agent) logSave(root2, rel, fs19.existsSync(file) ? fs19.readFileSync(file, "utf8") : "", content);
+      fs19.writeFileSync(file, content);
       return { ok: true, status: l ? fileStatus(root2, l, rel) : null };
     },
     "POST /api/file": (_, body) => {
       const rel = mdPath(body.path);
       const file = safeResolve(root2, rel);
-      if (fs18.existsSync(file)) throw new HttpError(409, "File already exists");
-      fs18.mkdirSync(path18.dirname(file), { recursive: true });
-      const title = path18.basename(rel, ".md").replace(/^\d+[-_]/, "").replace(/[-_]/g, " ");
-      fs18.writeFileSync(file, `# ${title.charAt(0).toUpperCase() + title.slice(1)}
+      if (fs19.existsSync(file)) throw new HttpError(409, "File already exists");
+      fs19.mkdirSync(path19.dirname(file), { recursive: true });
+      const title = path19.basename(rel, ".md").replace(/^\d+[-_]/, "").replace(/[-_]/g, " ");
+      fs19.writeFileSync(file, `# ${title.charAt(0).toUpperCase() + title.slice(1)}
 
 `);
       return { ok: true, path: rel };
@@ -2138,20 +2196,20 @@ async function startServer({ root: root2, port, open: openBrowser }) {
       if (typeof body.path !== "string" || !body.path.trim()) throw new HttpError(400, "Expected a path");
       const dir = safeResolve(root2, body.path);
       if (dir === root2) throw new HttpError(400, "Expected a path");
-      if (fs18.existsSync(dir)) throw new HttpError(409, "A file or folder with that name already exists");
-      fs18.mkdirSync(dir, { recursive: true });
-      return { ok: true, path: toPosix(path18.relative(root2, dir)) };
+      if (fs19.existsSync(dir)) throw new HttpError(409, "A file or folder with that name already exists");
+      fs19.mkdirSync(dir, { recursive: true });
+      return { ok: true, path: toPosix(path19.relative(root2, dir)) };
     },
-    "GET /api/delete-preview": (url2) => {
-      const abs = deletable(url2.searchParams.get("path"));
-      if (!fs18.statSync(abs).isDirectory()) return { kind: "file", files: 1, md: 1 };
-      const files = fs18.readdirSync(abs, { recursive: true, withFileTypes: true }).filter((e) => e.isFile());
+    "GET /api/delete-preview": (url3) => {
+      const abs = deletable(url3.searchParams.get("path"));
+      if (!fs19.statSync(abs).isDirectory()) return { kind: "file", files: 1, md: 1 };
+      const files = fs19.readdirSync(abs, { recursive: true, withFileTypes: true }).filter((e) => e.isFile());
       return { kind: "dir", files: files.length, md: files.filter((e) => e.name.toLowerCase().endsWith(".md")).length };
     },
-    "DELETE /api/path": (url2) => {
-      const rel = toPosix(path18.relative(root2, deletable(url2.searchParams.get("path"))));
-      fs18.rmSync(safeResolve(root2, rel), { recursive: true });
-      for (const l of config().langs) fs18.rmSync(translationFile(l, rel), { recursive: true, force: true });
+    "DELETE /api/path": (url3) => {
+      const rel = toPosix(path19.relative(root2, deletable(url3.searchParams.get("path"))));
+      fs19.rmSync(safeResolve(root2, rel), { recursive: true });
+      for (const l of config().langs) fs19.rmSync(translationFile(l, rel), { recursive: true, force: true });
       return { ok: true };
     },
     "POST /api/ignore": (_, body) => {
@@ -2160,7 +2218,7 @@ async function startServer({ root: root2, port, open: openBrowser }) {
       setIgnored(root2, body.path, body.kind === "dir" ? "dir" : "file", !!body.ignored);
       return { ok: true };
     },
-    "GET /api/diff": (url2) => ({ diff: gitDiff(root2, mdPath(url2.searchParams.get("path"))) }),
+    "GET /api/diff": (url3) => ({ diff: gitDiff(root2, mdPath(url3.searchParams.get("path"))) }),
     "GET /api/dashboard": () => {
       const sdd = summarizeSdd(root2);
       const shown = sddPrefixes(sdd);
@@ -2168,12 +2226,12 @@ async function startServer({ root: root2, port, open: openBrowser }) {
     },
     "GET /api/rules": () => {
       const mainDoc = readConfig(root2)?.mainDoc;
-      const text3 = mainDoc && fs18.existsSync(path18.join(root2, mainDoc)) ? fs18.readFileSync(path18.join(root2, mainDoc), "utf8") : "";
+      const text3 = mainDoc && fs19.existsSync(path19.join(root2, mainDoc)) ? fs19.readFileSync(path19.join(root2, mainDoc), "utf8") : "";
       return { rules: listRules(), applied: appliedRuleIds(text3), mainDoc: mainDoc ?? null };
     },
     "PUT /api/rules": (_, body) => saveRule(body),
-    "DELETE /api/rules": (url2) => {
-      deleteRule(url2.searchParams.get("id") ?? "");
+    "DELETE /api/rules": (url3) => {
+      deleteRule(url3.searchParams.get("id") ?? "");
       return { ok: true };
     },
     // Global skills: reads and writes are limited to SKILL.md of discovered skill folders.
@@ -2182,14 +2240,14 @@ async function startServer({ root: root2, port, open: openBrowser }) {
       if (typeof body.name !== "string" || !Array.isArray(body.tags)) throw new HttpError(400, "Expected name and tags");
       return { tags: setSkillTags(body.name, body.tags.map(String)) };
     },
-    "GET /api/skills/file": (url2) => {
-      const skill = getSkill(root2, url2.searchParams.get("key"));
-      return { path: skill.key, content: fs18.readFileSync(path18.join(skill.key, "SKILL.md"), "utf8"), target: "source", status: null };
+    "GET /api/skills/file": (url3) => {
+      const skill = getSkill(root2, url3.searchParams.get("key"));
+      return { path: skill.key, content: fs19.readFileSync(path19.join(skill.key, "SKILL.md"), "utf8"), target: "source", status: null };
     },
     "PUT /api/skills/file": (_, body) => {
       const skill = getSkill(root2, body.key);
       if (skill.managed) throw new HttpError(403, "This skill is managed by the app that installed it");
-      fs18.writeFileSync(path18.join(skill.key, "SKILL.md"), String(body.content ?? ""));
+      fs19.writeFileSync(path19.join(skill.key, "SKILL.md"), String(body.content ?? ""));
       return { ok: true, status: null };
     },
     "POST /api/skills/install": (_, body) => {
@@ -2202,7 +2260,7 @@ async function startServer({ root: root2, port, open: openBrowser }) {
     "POST /api/rules/apply": (_, body) => {
       const mainDoc = readConfig(root2)?.mainDoc;
       if (!mainDoc) throw new HttpError(400, "No main document configured; run `markode init`");
-      applyRulesToFile(path18.join(root2, mainDoc), body.ids ?? []);
+      applyRulesToFile(path19.join(root2, mainDoc), body.ids ?? []);
       return { ok: true };
     }
   };
@@ -2213,11 +2271,11 @@ async function startServer({ root: root2, port, open: openBrowser }) {
       res.writeHead(403).end("Forbidden");
       return;
     }
-    const url2 = new URL(req.url ?? "/", "http://localhost");
-    const route = routes[`${req.method} ${url2.pathname}`];
+    const url3 = new URL(req.url ?? "/", "http://localhost");
+    const route = routes[`${req.method} ${url3.pathname}`];
     if (route) {
       try {
-        const result = await route(url2, req.method === "GET" || req.method === "DELETE" ? {} : await readBody(req));
+        const result = await route(url3, req.method === "GET" || req.method === "DELETE" ? {} : await readBody(req));
         res.writeHead(200, { "content-type": "application/json" }).end(JSON.stringify(result));
       } catch (err) {
         const status = err instanceof HttpError ? err.status : err.code === "ENOENT" ? 404 : 500;
@@ -2225,8 +2283,9 @@ async function startServer({ root: root2, port, open: openBrowser }) {
       }
       return;
     }
-    if (req.method === "GET" && url2.pathname === "/api/asset") return serveAsset(url2.searchParams.get("path") ?? "", res);
-    serveStatic(url2.pathname, res);
+    if (req.method === "GET" && url3.pathname === "/api/asset") return serveAsset(url3.searchParams.get("path") ?? "", res);
+    if (req.method === "GET" && url3.pathname === "/open") return openDoc(url3.searchParams.get("path") ?? "", res);
+    serveStatic(url3.pathname, res);
   });
   function serveAsset(rel, res) {
     let file;
@@ -2236,13 +2295,33 @@ async function startServer({ root: root2, port, open: openBrowser }) {
       res.writeHead(404).end();
       return;
     }
-    const type = IMAGE_MIME[path18.extname(file).toLowerCase()];
-    if (!type || !fs18.existsSync(file) || !fs18.statSync(file).isFile()) {
+    const type = IMAGE_MIME[path19.extname(file).toLowerCase()];
+    if (!type || !fs19.existsSync(file) || !fs19.statSync(file).isFile()) {
       res.writeHead(404).end();
       return;
     }
     res.writeHead(200, { "content-type": type, "cache-control": "no-cache", "content-security-policy": "sandbox; frame-ancestors 'none'" });
-    fs18.createReadStream(file).pipe(res);
+    fs19.createReadStream(file).pipe(res);
+  }
+  function openDoc(rel, res) {
+    let doc;
+    try {
+      doc = mdPath(rel);
+    } catch {
+      res.writeHead(400).end("Expected a .md path");
+      return;
+    }
+    const hash2 = `/#/${encodeURI(doc)}`;
+    if (!wss.clients.size) {
+      res.writeHead(302, { location: hash2 }).end();
+      return;
+    }
+    broadcast({ type: "open", path: doc });
+    const text3 = OPENED_TEXT[readSettings().uiLang] ?? OPENED_TEXT.en;
+    const page = `<!doctype html><meta charset="utf-8"><title>markode</title><body style="font:15px system-ui;padding:2rem;color-scheme:light dark">
+<p>${text3.shown}</p><p><a href="${hash2}">${text3.here}</a></p><script>window.close()</script>`;
+    res.writeHead(200, { "content-type": "text/html; charset=utf-8", "cache-control": "no-store", "content-security-policy": "frame-ancestors 'none'; script-src 'sha256-" + CLOSE_HASH + "'" });
+    res.end(page);
   }
   const actualPort = await listen(server, port);
   const wss = new WebSocketServer({ server, path: "/ws", verifyClient: ({ req }) => isLocalRequest(req) });
@@ -2256,27 +2335,34 @@ async function startServer({ root: root2, port, open: openBrowser }) {
     // Unreadable folders (e.g. caches owned by another user) are skipped instead of failing.
     ignorePermissionErrors: true,
     ignored: (p3, stats) => {
-      const rel = toPosix(path18.relative(root2, p3));
+      const rel = toPosix(path19.relative(root2, p3));
       if (rel === ".markode") return false;
       if (rel.startsWith(".markode/")) return !rel.startsWith(".markode/i18n") && rel !== ".markode/state.json" && rel !== ".markode/config.json";
       return skips(rel, stats ? stats.isDirectory() : void 0);
     }
   }).on("error", (err) => console.warn(pc.yellow(`  file watcher: ${err.message}`))).on("all", (event, file) => {
-    const abs = path18.resolve(file);
+    const abs = path19.resolve(file);
     if (!abs.endsWith(".md") && !abs.endsWith(".json") && !abs.endsWith(".markodeignore") && event !== "addDir" && event !== "unlinkDir") return;
-    let rel = toPosix(path18.relative(root2, abs));
-    const i18n = toPosix(path18.relative(root2, path18.join(stateDir(root2), "i18n")));
+    let rel = toPosix(path19.relative(root2, abs));
+    const i18n = toPosix(path19.relative(root2, path19.join(stateDir(root2), "i18n")));
     if (rel.startsWith(i18n + "/")) rel = rel.split("/").slice(3).join("/");
     broadcast({ type: "fs", event, path: rel });
   });
-  const url = `http://localhost:${actualPort}`;
+  recordServer(root2, actualPort);
+  const url2 = `http://localhost:${actualPort}`;
   console.log(`
-  ${pc.bold("markode")} ${pc.dim("\u2192")} ${pc.cyan(url)}  ${pc.dim(root2)}
+  ${pc.bold("markode")} ${pc.dim("\u2192")} ${pc.cyan(url2)}  ${pc.dim(root2)}
 `);
-  if (!fs18.existsSync(WEB_DIR)) console.log(pc.yellow("  Web UI not built: run `pnpm build`, or `pnpm dev` and open http://localhost:4320\n"));
-  else if (openBrowser) open(url).catch(() => {
+  if (!fs19.existsSync(WEB_DIR)) console.log(pc.yellow("  Web UI not built: run `pnpm build`, or `pnpm dev` and open http://localhost:4320\n"));
+  else if (openBrowser) open(url2).catch(() => {
   });
 }
+var OPENED_TEXT = {
+  en: { shown: "Opened in your markode tab. You can close this one.", here: "Open it here instead" },
+  es: { shown: "Abierto en tu pesta\xF1a de markode. Puedes cerrar esta.", here: "Abrirlo aqu\xED" },
+  fr: { shown: "Ouvert dans ton onglet markode. Tu peux fermer celui-ci.", here: "L\u2019ouvrir ici" }
+};
+var CLOSE_HASH = crypto3.createHash("sha256").update("window.close()").digest("base64");
 function listen(server, port) {
   return new Promise((resolve, reject) => {
     server.once("error", (err) => {
@@ -2287,19 +2373,19 @@ function listen(server, port) {
   });
 }
 function serveStatic(pathname, res) {
-  let file = path18.join(WEB_DIR, path18.normalize(pathname).replace(/^(\.\.[/\\])+/, ""));
-  if (!file.startsWith(WEB_DIR) || !fs18.existsSync(file) || fs18.statSync(file).isDirectory()) file = path18.join(WEB_DIR, "index.html");
-  if (!fs18.existsSync(file)) {
+  let file = path19.join(WEB_DIR, path19.normalize(pathname).replace(/^(\.\.[/\\])+/, ""));
+  if (!file.startsWith(WEB_DIR) || !fs19.existsSync(file) || fs19.statSync(file).isDirectory()) file = path19.join(WEB_DIR, "index.html");
+  if (!fs19.existsSync(file)) {
     res.writeHead(404).end("Web UI not built. Run `pnpm build`.");
     return;
   }
-  res.writeHead(200, { "content-type": MIME[path18.extname(file)] ?? "application/octet-stream", "content-security-policy": "frame-ancestors 'none'" });
-  fs18.createReadStream(file).pipe(res);
+  res.writeHead(200, { "content-type": MIME[path19.extname(file)] ?? "application/octet-stream", "content-security-policy": "frame-ancestors 'none'" });
+  fs19.createReadStream(file).pipe(res);
 }
 
 // src/cli/init.ts
-import fs19 from "fs";
-import path19 from "path";
+import fs20 from "fs";
+import path20 from "path";
 import * as p from "@clack/prompts";
 import pc2 from "picocolors";
 function check(value) {
@@ -2310,12 +2396,12 @@ function check(value) {
   return value;
 }
 async function offerClaudeLink(root2, d) {
-  if (fs19.existsSync(path19.join(root2, "CLAUDE.md"))) return;
+  if (fs20.existsSync(path20.join(root2, "CLAUDE.md"))) return;
   const link2 = d ? d.mainDoc === "CLAUDE.md" : check(await p.confirm({ message: "Claude Code reads CLAUDE.md, not AGENTS.md. Add a CLAUDE.md that imports AGENTS.md?", initialValue: true }));
   if (link2 && linkAgentsDoc(root2)) p.log.success("Created CLAUDE.md (imports AGENTS.md)");
 }
 async function chooseMainDoc(root2, d) {
-  const existing = MAIN_DOCS.filter((d2) => fs19.existsSync(path19.join(root2, d2)) && !isPointer(fs19.readFileSync(path19.join(root2, d2), "utf8"), d2));
+  const existing = MAIN_DOCS.filter((d2) => fs20.existsSync(path20.join(root2, d2)) && !isPointer(fs20.readFileSync(path20.join(root2, d2), "utf8"), d2));
   if (d) {
     if (existing.length === 1 && existing[0] === "AGENTS.md") await offerClaudeLink(root2, d);
     if (existing.length) return existing.includes(d.mainDoc) ? d.mainDoc : existing[0];
@@ -2432,7 +2518,7 @@ async function chooseAreas(root2) {
   return areas;
 }
 async function chooseKind(root2, dir) {
-  const guess = guessKind(path19.join(root2, dir));
+  const guess = guessKind(path20.join(root2, dir));
   if (!guess.unclear) return guess.kind;
   const where = dir ? `${dir}/` : "this project";
   const seen = guess.signals.length ? `found: ${guess.signals.join(", ")}` : "no code yet";
@@ -2445,7 +2531,7 @@ async function chooseKind(root2, dir) {
   );
 }
 async function askProfile(root2, dir, kind) {
-  const base = detectProfile(path19.join(root2, dir), kind);
+  const base = detectProfile(path20.join(root2, dir), kind);
   if (kind === "app") return base;
   const where = dir ? ` (${dir}/)` : "";
   if (kind === "library") return { kind, published: check(await p.confirm({ message: `Is the library${where} published (npm, PyPI\u2026)?`, initialValue: base.published })) };
@@ -2522,7 +2608,7 @@ async function chooseWorkflow(root2, mainDoc, previous, quiet) {
       const profile = areas.length ? void 0 : await askProfile(root2, "", await chooseKind(root2, ""));
       const created = scaffoldMethod(root2, mainDoc, areas);
       installMethodSkills(root2);
-      applyWorkflowToFile(path19.join(root2, mainDoc), "markode", methodSection(areas, root2, { profile, contracts, existing }));
+      applyWorkflowToFile(path20.join(root2, mainDoc), "markode", methodSection(areas, root2, { profile, contracts, existing }));
       const big = !areas.length && flattenFiles(scanTree(root2)).length > 40;
       const layout = areas.length ? "structured" : !big ? "general" : check(await p.select({ message: PROPOSALS_QUESTION, options: PROPOSAL_OPTIONS }));
       activateProposals(root2, layout, mainDoc);
@@ -2587,10 +2673,10 @@ async function runInit(root2, plan2) {
   let workflow = previous?.workflow ?? "none";
   if (has2("agent")) {
     mainDoc = await chooseMainDoc(root2, d);
-    const mainFile = path19.join(root2, mainDoc);
+    const mainFile = path20.join(root2, mainDoc);
     if (has2("dashboard")) workflow = await chooseWorkflow(root2, mainDoc, previous?.workflow, d);
     if (workflow === "openspec" || workflow === "speckit") applyWorkflowToFile(mainFile, workflow);
-    const mainText = fs19.readFileSync(mainFile, "utf8");
+    const mainText = fs20.readFileSync(mainFile, "utf8");
     const sourceLang = d ? SOURCE_LANG_MARK.test(mainText) ? sourceLangOf(mainText) : detectedLang : check(await p.select({ message: SOURCE_LANG_QUESTION, options: LANG_OPTIONS, initialValue: SOURCE_LANG_MARK.test(mainText) ? sourceLangOf(mainText) : detectedLang }));
     const rules = listRules();
     const applied = appliedRuleIds(mainText);
@@ -2605,7 +2691,7 @@ async function runInit(root2, plan2) {
           required: false
         })
       );
-      for (const dir of targets) applyRulesToFile(contentDoc(path19.join(root2, dir)), selected, sourceLang);
+      for (const dir of targets) applyRulesToFile(contentDoc(path20.join(root2, dir)), selected, sourceLang);
     }
     installAgentSkill(root2);
     const proposals = proposalsState(root2);
@@ -2752,6 +2838,8 @@ Usage
   markode features        list the modules and whether they are on in this project
   markode features <module> on|off   turn a module on or off (same as Settings \u2192 Features)
   markode serve           open the editor without running init
+  markode url [<doc.md>]  the editor's link (or a doc's), starting it in the background if it isn't running
+  markode stop            stop the editor running in the background for this project
   markode translate       choose languages to review the docs in (or: markode --translate)
   markode check [--json]  what /markode sync fixes: answered proposals, phases vs tasks, projects table, broken links
   markode wait <proposal> wait until the user answers a proposal in markode, then print the answer
@@ -2785,9 +2873,9 @@ var option = (name) => {
 var command = args[0] && !args[0].startsWith("-") ? args[0] : "start";
 var root = process.env.MARKODE_ROOT ?? process.cwd();
 async function main() {
-  if (fs20.existsSync(root)) setProjectRoot(root);
+  if (fs21.existsSync(root)) setProjectRoot(root);
   if (flag("--help") || flag("-h")) return console.log(HELP);
-  if (flag("--version") || flag("-v")) return console.log(JSON.parse(fs20.readFileSync(path20.join(PKG_ROOT, "package.json"), "utf8")).version);
+  if (flag("--version") || flag("-v")) return console.log(JSON.parse(fs21.readFileSync(path21.join(PKG_ROOT, "package.json"), "utf8")).version);
   const translation = flag("--status") || flag("--mark") || flag("--keep");
   if ((command === "sync" || command === "translate") && translation) return sync();
   if (command === "translate" || flag("--translate")) return runTranslate(root);
@@ -2795,6 +2883,8 @@ async function main() {
   if (command === "wait") return wait();
   if (command === "link") return link();
   if (command === "changes") return changes();
+  if (command === "url") return url();
+  if (command === "stop") return stop();
   if (command === "features") return features();
   if (command === "setup") {
     await runSetup(false, flag("--custom"));
@@ -2880,6 +2970,22 @@ function link() {
   if (flag("--dry-run")) return console.log(missing.map((m) => `would create ${m.path} \u2192 ${m.pointsTo}`).join("\n"));
   for (const p3 of linkMainDocs(root)) console.log(`created ${p3}`);
 }
+async function url() {
+  const doc = args[1] && !args[1].startsWith("-") ? args[1] : void 0;
+  if (doc && (!doc.toLowerCase().endsWith(".md") || !fs21.existsSync(path21.join(root, doc)))) {
+    console.error(`Usage: markode url [<doc.md>] (relative to ${root})`);
+    process.exitCode = 1;
+    return;
+  }
+  const { port } = await ensureServer(root, process.argv[1], Number(option("--port") ?? 4319));
+  console.log(editorUrl(port, doc));
+}
+function stop() {
+  const running = runningServer(root);
+  if (!running) return console.log("The editor is not running for this project.");
+  process.kill(running.pid);
+  console.log(`Stopped the editor on port ${running.port}.`);
+}
 function changes() {
   if (flag("--start")) return startSession(root);
   const list = takeChanges(root);
@@ -2894,7 +3000,7 @@ function changes() {
 }
 async function wait() {
   const rel = args[1];
-  if (!rel || !fs20.existsSync(path20.join(root, rel))) {
+  if (!rel || !fs21.existsSync(path21.join(root, rel))) {
     console.error(`Usage: markode wait <proposal.md> (relative to ${root})`);
     process.exitCode = 1;
     return;

package/dist/web/assets/{abnfDiagram-WEYOIA3C-uyv195L6.js → abnfDiagram-WEYOIA3C-B-3Lcktj.js}

@@ -1 +1 @@
-import{m as e,t}from"./mermaid-parser.core-CRHYFOhU.js";import{n}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import{m as r}from"./src-DWy4o1sh.js";import"./chunk-DSNLSHJZ-6EnWiUHw.js";import{n as i,r as a,t as o}from"./chunk-2E7WHVMD-CQSFul1o.js";import{t as s}from"./chunk-JWPE2WC7-DVXcaiue.js";import"./mermaid.core-C-ITLWC9.js";var c=e().RailroadAbnf.parser.LangiumParser,l=n(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=n(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=n(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=n(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=n(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=n(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=n(e=>{s(e,o),e.title&&o.setTitle(e.title),e.rules.map(e=>o.addRule(m(e)))},`populateDb`),g={parser:{parse:n(e=>{o.clear(),r.debug(`[ABNF Parser] Starting Langium parse`);let n=c.parse(e);if(n.lexerErrors.length>0||n.parserErrors.length>0)throw new t(n);let i=n.value;r.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),r.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:o}},db:o,renderer:a,styles:i};export{g as diagram};
+import{m as e,t}from"./mermaid-parser.core-C1XIxySl.js";import{n}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import{m as r}from"./src-okGi814h.js";import"./chunk-DSNLSHJZ-C0Wri32R.js";import{n as i,r as a,t as o}from"./chunk-2E7WHVMD-B2TT-9T2.js";import{t as s}from"./chunk-JWPE2WC7-DVXcaiue.js";import"./mermaid.core-C-385ykR.js";var c=e().RailroadAbnf.parser.LangiumParser,l=n(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=n(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=n(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=n(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=n(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=n(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=n(e=>{s(e,o),e.title&&o.setTitle(e.title),e.rules.map(e=>o.addRule(m(e)))},`populateDb`),g={parser:{parse:n(e=>{o.clear(),r.debug(`[ABNF Parser] Starting Langium parse`);let n=c.parse(e);if(n.lexerErrors.length>0||n.parserErrors.length>0)throw new t(n);let i=n.value;r.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),r.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:o}},db:o,renderer:a,styles:i};export{g as diagram};