@akanjs/cli 3.0.0-beta.14 → 3.0.0-beta.16

package/{devTui-4ted58a6.js → devTui-gy6mendg.js}

@@ -1,10 +1,10 @@
 // @bun
 import {
-  openBrowser,
-  plainTextOf,
-  HOST_SOURCE,
-  DevLogBuffer
-} from "./index-sg1bgdhe.js";
+  stripAnsi
+} from "./index-7md2g9vw.js";
+import {
+  openBrowser
+} from "./index-ns128c4q.js";
 import {
   writeClipboard
 } from "./index-p6pbz9n5.js";
@@ -156,6 +156,8 @@ var DevTuiApp = ({ actions }) => {
       actions.copyLines();
     else if (input === "Y")
       actions.copyPath();
+    else if (input === "s")
+      actions.copyShareUrl();
     else if (input === "o")
       actions.openSelected();
     else if (input === "r")
@@ -216,12 +218,95 @@ var DevTuiApp = ({ actions }) => {
       }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV(Text, {
         dimColor: true,
         wrap: "truncate",
-        children: `Tab next \xB7 1-9 app \xB7 \u2191\u2193 scroll (shift page) \xB7 G follow${snapshot.following ? "" : " (paused)"} \xB7 / grep${snapshot.grep ? ` (${snapshot.grep})` : ""} \xB7 e errors${snapshot.errorsOnly ? " on" : ""} \xB7 c clear \xB7 y copy \xB7 Y path \xB7 o open \xB7 r restart \xB7 q quit`
+        children: `${snapshot.hasShare ? "s share \xB7 " : ""}Tab next \xB7 1-9 app \xB7 \u2191\u2193 scroll (shift page) \xB7 G follow${snapshot.following ? "" : " (paused)"} \xB7 / grep${snapshot.grep ? ` (${snapshot.grep})` : ""} \xB7 e errors${snapshot.errorsOnly ? " on" : ""} \xB7 c clear \xB7 y copy \xB7 Y path \xB7 o open \xB7 r restart \xB7 q quit`
       }, undefined, false, undefined, this)
     ]
   }, undefined, true, undefined, this);
 };
 
+// pkgs/@akanjs/cli/application/devLogBuffer.ts
+var plainTextOf = (lines, { withApp = false } = {}) => {
+  const width = withApp ? lines.reduce((max, line) => Math.max(max, line.app.length), 0) : 0;
+  return lines.map((line) => `${withApp ? `${line.app.padEnd(width)} \u2502 ` : ""}${stripAnsi(line.text)}`).join(`
+`);
+};
+var HOST_SOURCE = "host";
+var childPrefix = /^\[child:(\d+) ([a-z-]+)\] \[(?:stdout|stderr)\] /;
+var sourceOf = (text) => {
+  const match = childPrefix.exec(text);
+  return match ? `#${match[1]} ${match[2]}` : HOST_SOURCE;
+};
+
+class DevLogBuffer {
+  static defaultLimit = 5000;
+  #limit;
+  #lines = [];
+  #partial = new Map;
+  #sources = new Map;
+  #seq = 0;
+  constructor({ limit = DevLogBuffer.defaultLimit } = {}) {
+    this.#limit = Math.max(1, limit);
+  }
+  get size() {
+    return this.#lines.length;
+  }
+  sourcesOf(app) {
+    return [...this.#sources.get(app) ?? []];
+  }
+  push(app, kind, chunk) {
+    const key = `${app}:${kind}`;
+    const parts = `${this.#partial.get(key) ?? ""}${chunk}`.split(`
+`);
+    this.#partial.set(key, parts.pop() ?? "");
+    return this.#append(app, kind, parts);
+  }
+  flushPartials() {
+    const flushed = [];
+    for (const [key, remainder] of [...this.#partial]) {
+      this.#partial.set(key, "");
+      if (!remainder)
+        continue;
+      const split = key.lastIndexOf(":");
+      const app = key.slice(0, split);
+      const kind = key.slice(split + 1) === "stderr" ? "stderr" : "stdout";
+      flushed.push(...this.#append(app, kind, [remainder]));
+    }
+    return flushed;
+  }
+  select({ app = null, source = null, grep, errorsOnly = false } = {}) {
+    const needle = grep?.trim().toLowerCase();
+    return this.#lines.filter((line) => {
+      if (app !== null && line.app !== app)
+        return false;
+      if (source !== null && line.source !== source)
+        return false;
+      if (errorsOnly && line.kind !== "stderr")
+        return false;
+      if (needle && !stripAnsi(line.text).toLowerCase().includes(needle))
+        return false;
+      return true;
+    });
+  }
+  clear(app = null) {
+    const kept = app === null ? [] : this.#lines.filter((line) => line.app !== app);
+    this.#lines.length = 0;
+    this.#lines.push(...kept);
+  }
+  #append(app, kind, texts) {
+    const known = this.#sources.get(app) ?? new Set;
+    this.#sources.set(app, known);
+    const added = texts.map((text) => {
+      const source = sourceOf(text);
+      known.add(source);
+      return { seq: ++this.#seq, app, source, kind, text };
+    });
+    this.#lines.push(...added);
+    if (this.#lines.length > this.#limit)
+      this.#lines.splice(0, this.#lines.length - this.#limit);
+    return added;
+  }
+}
+
 // pkgs/@akanjs/cli/application/devLogWindow.ts
 var windowOf = (lines, rows, anchor) => {
   const height = Math.max(1, Math.trunc(rows));
@@ -293,6 +378,7 @@ class DevTui {
         clear: this.#clear,
         copyLines: this.#copyLines,
         copyPath: this.#copyPath,
+        copyShareUrl: this.#copyShareUrl,
         openSelected: this.#openSelected,
         restartSelected: this.#restartSelected,
         quit: this.#quit
@@ -328,7 +414,7 @@ class DevTui {
       process.stdout.write(`${line.app} \u2502 ${line.text}
 `);
     for (const status of this.#statuses)
-      process.stdout.write(`${status.name} ${status.url} \u2014 ${status.state}
+      process.stdout.write(`${status.name} ${status.url}${status.shareUrl ? ` \xB7 ${status.shareUrl}` : ""} \u2014 ${status.state}
 `);
     const log = this.#supervisor.sessionLog;
     for (const name of log.appNames)
@@ -388,7 +474,7 @@ class DevTui {
     this.#cachedSnapshot = {
       rows,
       selected: this.#indexOfTarget(rows),
-      title: status ? `${status.name}${this.#target.source ? ` \xB7 ${this.#target.source}` : ""} \xB7 ${status.url} \xB7 ${status.state}${status.detail ? ` (${status.detail})` : ""}` : "all apps",
+      title: status ? `${status.name}${this.#target.source ? ` \xB7 ${this.#target.source}` : ""}${status.shareUrl ? ` \xB7 \u25C8 ${status.shareUrl}` : ""} \xB7 ${status.url} \xB7 ${status.state}${status.detail ? ` (${status.detail})` : ""}` : this.#mergedTitle(),
       lines: view.lines,
       above: view.above,
       below: view.below,
@@ -399,6 +485,7 @@ class DevTui {
       errorsOnly: this.#errorsOnly,
       editingGrep: this.#editingGrep,
       notice: this.#notice,
+      hasShare: this.#statuses.some((candidate) => !!candidate.shareUrl),
       readyCount: this.#statuses.filter((candidate) => candidate.state === "ready").length,
       appCount: this.#statuses.length,
       logRows,
@@ -500,6 +587,25 @@ class DevTui {
     const app = this.#target.app;
     return (app ? [app] : log.appNames).map((name) => log.relativePathOf(name));
   }
+  #copyShareUrl = () => {
+    const urls = this.#shareUrls();
+    if (urls.length === 0) {
+      this.#setNotice("no public share \u2014 start with --share");
+      return;
+    }
+    writeClipboard(urls.join(`
+`)).then((copied) => {
+      this.#setNotice(copied ? `copied ${urls.join(" \xB7 ")}` : urls.join(" \xB7 "));
+    });
+  };
+  #shareUrls() {
+    const app = this.#target.app;
+    return this.#statuses.filter((status) => app === null || status.name === app).map((status) => status.shareUrl).filter((url) => !!url);
+  }
+  #mergedTitle() {
+    const urls = this.#shareUrls();
+    return urls.length === 0 ? "all apps" : `all apps \xB7 \u25C8 ${urls.join(" \xB7 ")}`;
+  }
   #setNotice(text) {
     this.#notice = text;
     if (this.#noticeTimer)

package/{devTuiView-1dj2yq7t.js → devTuiView-y1548wy6.js}

@@ -1,7 +1,7 @@
 // @bun
 // pkgs/@akanjs/cli/application/devTuiView.ts
 var createDevTuiView = async (supervisor) => {
-  const { DevTui } = await import("./devTui-4ted58a6.js");
+  const { DevTui } = await import("./devTui-gy6mendg.js");
   return new DevTui(supervisor);
 };
 export {

package/{guideline.command-cyw8c0m0.js → guideline.command-rpc2emw8.js}

@@ -2,13 +2,13 @@
 import {
   script,
   command
-} from "./index-b3ae16mg.js";
+} from "./index-6na0sd2b.js";
 import"./index-q0y2jq9j.js";
-import"./index-5nyznra1.js";
+import"./index-p4p9t45x.js";
 import"./index-6wwzs1bc.js";
 import {
-  Prompter
-} from "./index-h7yw2z9n.js";
+  Prompter2
+} from "./index-twq9p2sp.js";
 
 // pkgs/@akanjs/cli/guideline/guideline.script.ts
 import { Logger } from "akanjs/common";
@@ -16,7 +16,7 @@ import { Logger } from "akanjs/common";
 class GuidelineScript extends script("guideline") {
   async guideline(action, name = null, format = "markdown") {
     if (action === "list") {
-      const guidelines = await Prompter.listGuidelines();
+      const guidelines = await Prompter2.listGuidelines();
       Logger.rawLog(format === "json" ? JSON.stringify({ guidelines }, null, 2) : guidelines.join(`
 `));
       return;
@@ -24,7 +24,7 @@ class GuidelineScript extends script("guideline") {
     if (action === "show") {
       if (!name)
         throw new Error("Guideline name is required. Example: akan guideline show framework");
-      const [instruction, guideJson] = await Promise.all([Prompter.getInstruction(name), Prompter.getGuideJson(name)]);
+      const [instruction, guideJson] = await Promise.all([Prompter2.getInstruction(name), Prompter2.getGuideJson(name)]);
       Logger.rawLog(format === "json" ? JSON.stringify({ name, instruction, guideJson }, null, 2) : instruction);
       return;
     }

package/guidelines/agentRule/agentRule.instruction.md

@@ -46,7 +46,7 @@ apps and libs never import it directly (`no-import-external-library`) — everyt
   already titles, and `defaultDraft` opens the composer with text in it without sending it. A panel driven by a
   controlled `open` with **no** `onOpenChange` draws no close button at all rather than an inert one. Then the
   slots: `AgentLauncher`, `AgentSteps`, `AgentBubble`, `AgentComposer`, `AgentApproval`,
-  `AgentQuestion`, `AgentQueued`, `AgentMenu`, `AgentMarkdown` and `AgentCode` each replace one part in `_overrides.tsx`, and
+  `AgentQuestion`, `AgentToolCard`, `AgentQueued`, `AgentMenu`, `AgentMarkdown` and `AgentCode` each replace one part in `_overrides.tsx`, and
   `akanjs/ui` exports every default beside them (`DefaultBubble`, `DefaultComposer`, …) so a skin composes the
   one it is replacing. **`AgentSteps` is one agent turn** — the messages between the user message that opened it
   and the next one, with `isRunning` saying whether more are still coming — which is the grain a chat needs to
@@ -216,6 +216,15 @@ apps and libs never import it directly (`no-import-external-library`) — everyt
   is called from components the composer cannot see; writing the token is the composer's half, and `refer` warns
   rather than staging silently when no chat is mounted on that session — the case where a card sits outside the
   `<Agent.Zone>` its chat is inside.
+- **The composer draws a pointer as the name it points at, never as the token.** Where `reference` sources are
+  declared the input is a Lexical editor rather than a textarea, and each pointer is one atomic node — a backspace
+  takes the whole thing rather than a character of a label that would then name nothing. Nothing above it changes:
+  the node's text content *is* the `@[…](mention:…)` token, so the draft string the chat reads, the `@` query, the
+  chips, the wire and the server's framing all see what they always saw, and every offset the chat hands over is
+  an offset into that string. It is its own chunk behind the chat's, fetched only where a source was declared, and
+  `mentions={false}` keeps the plain textarea — for an app that overrides `AgentComposer`, or one that would
+  rather see the tokens it is sending. An override that draws its own textarea keeps working: it fills the
+  `inputRef` it is handed, and the chat reads the caret off that when no editor filled `handleRef`.
 - **`attach` and `voice` both carry functions, so a server layout cannot pass either.** A closure does not cross
   the RSC boundary — `non-scalar-props-restricted` says so on `page/**` — so an app that wants either mounts the
   chat from a small client component in the app's own `ui/` that calls the hook.
@@ -287,6 +296,14 @@ apps and libs never import it directly (`no-import-external-library`) — everyt
   `data-akan-action` like a store setter does. A `remove*` name defaults to a confirm gate. Reach a store action
   from the body — `.exec((id) => st.do.removeX(id))` — which is how an agent gets CRUD; `st.do` on its own
   reaches nobody.
+- **`.card()` is the other way the chain ends, for an answer that is the user's to give.** Where `.exec()` runs a
+  function, `.card(({ submit, cancel }, ...args) => <Form …/>)` parks the call in the chat and renders the app's own
+  component there; what `submit` is handed is what the model reads back, and `cancel` is the refusal it reads
+  instead. A name and a phone number, a date somebody has to look up, a signature — a model that fills those in
+  has answered its own question, and every other shape of "ask the user" is `askUser`. The declared arguments are
+  checked **before** the card is parked, so a bad one reaches the model as a refusal rather than throwing inside
+  the render; `confirm` is not read at all, because the card in front of the user is already the asking. The frame
+  draws its own way out even when the card does not, and the turn is never parked on something with no exit.
 - **The second argument is how the call behaves, never what it is.** `{ settle, confirm, guard }`:
   `settle: false` marks a read that returns what is already there and skips the wait; every other tool is waited
   out before its effect on the screen is reported, because a write may still be landing when `exec` resolves. A
@@ -685,7 +702,10 @@ apps and libs never import it directly (`no-import-external-library`) — everyt
   is among them. The loop parks on the question exactly as it parks on an approval, a dismissal is the tool's
   error result rather than a silent empty answer, and the settled exchange renders as question-and-answer instead
   of a tool row. **Never re-implement it per screen** — a `st.tool("askAboutX")` that opens a modal is the same
-  thing with a worse transcript — and a hook tool named `askUser` shadows it like any other built-in.
+  thing with a worse transcript — and a hook tool named `askUser` shadows it like any other built-in. The line
+  between it and a `.card()` tool is what the answer *is*: a sentence or a pick off a list is `askUser` and belongs
+  to the conversation, while a shape the model must not invent — fields, a form, a signature — is a card the screen
+  declares, because only the screen knows what filling it in looks like.
 
 ## What The Page Draws
 - **The page shows the agent's work, not just the transcript.** A chat panel is closed as often as it is open, and

package/guidelines/conventions/conventions.instruction.md

@@ -946,7 +946,9 @@ when two shapes disagree.
   selected one's log beside it. `Tab` walks every row and `1`-`9` jump to that app (the rail shows each
   app's digit), `↑↓` scroll (shift for a page, `G` back to following),
   `/` greps, `e` shows stderr only, `c` clears, `y` copies, `Y` copies the log path, `o` opens the browser,
-  `r` restarts that app, `q` quits.
+  `r` restarts that app, `q` quits. Under `--share`, `s` copies the public URL — the selected app's, or every
+  app's from the merged row — and the header carries it ahead of the local one, because the line `--share`
+  printed before the view took the terminal is gone by its first repaint.
   **`--plain` prints prefixed interleaved lines instead**, and a pipe, a redirect or an unsized terminal
   downgrades to that on its own.
 - **A supervised session writes `local/apps/<app>/runtime/dev.log`, and that path is how a log gets handed over.**

package/incrementalBuilder.proc.js

@@ -3,7 +3,7 @@ import {
   CodegenLock,
   WorkspaceExecutor,
   AppExecutor
-} from "./index-5nyznra1.js";
+} from "./index-p4p9t45x.js";
 import"./index-q0y2jq9j.js";
 import"./index-6wwzs1bc.js";
 import {

package/{index-t8gvwcrx.js → index-018dszb3.js}

@@ -2,13 +2,13 @@
 import {
   runner,
   script
-} from "./index-b3ae16mg.js";
+} from "./index-6na0sd2b.js";
 import {
   FileSys
 } from "./index-q0y2jq9j.js";
 import {
   PkgExecutor
-} from "./index-5nyznra1.js";
+} from "./index-p4p9t45x.js";
 import {
   TypeScriptDependencyScanner2
 } from "./index-kcxmv48c.js";
@@ -153,7 +153,12 @@ class PackageRunner extends runner("package") {
     const scanner = await TypeScriptDependencyScanner2.from(pkg);
     const { npmDeps, npmDevDeps, missingDeps } = await scanner.getPackageBuildDependencies(pkg.name);
     const packageRuntimeDependencies = {
-      "@akanjs/devkit": ["tailwind-scrollbar"]
+      "@akanjs/devkit": [
+        "tailwind-scrollbar",
+        "@earendil-works/pi-agent-core",
+        "@earendil-works/pi-ai",
+        "@earendil-works/pi-tui"
+      ]
     };
     const packageRuntimeDevDependencies = { akanjs: ["@biomejs/biome", "@types/bun"] };
     if (pkg.name === "@akanjs/cli") {
@@ -174,7 +179,11 @@ class PackageRunner extends runner("package") {
     const optionalPeerDeps = new Set(Object.entries(pkgJson.peerDependenciesMeta ?? {}).filter(([, meta]) => meta.optional).map(([dep]) => dep));
     const packageRuntimeDeps = [...new Set([...npmDeps, ...forcedRuntimeDeps])].filter((dep) => !optionalPeerDeps.has(dep) && !bundledRuntimeDeps.has(dep));
     const packageRuntimeDevDeps = [...new Set([...npmDevDeps, ...forcedRuntimeDevDeps])].filter((dep) => !optionalPeerDeps.has(dep) && !bundledRuntimeDeps.has(dep));
-    const rootDeps = { ...rootPackageJson.dependencies, ...rootPackageJson.devDependencies };
+    const rootDeps = {
+      ...rootPackageJson.overrides,
+      ...rootPackageJson.dependencies,
+      ...rootPackageJson.devDependencies
+    };
     const missingForcedDeps = forcedRuntimeDeps.filter((dep) => !rootDeps[dep]);
     const missingForcedDevDeps = forcedRuntimeDevDeps.filter((dep) => !rootDeps[dep]);
     const requiredMissingDeps = missingDeps.filter((dep) => !optionalPeerDeps.has(dep));

package/{index-8pkvrcv1.js → index-2pm1j01n.js}

@@ -20,13 +20,13 @@ import {
   renderWorkflowApply,
   renderWorkflowValidation,
   renderWorkflowRunArtifact
-} from "./index-jwjaf9fy.js";
+} from "./index-qhtj9y6j.js";
 import {
   AkanContextAnalyzer
-} from "./index-15r9a10e.js";
+} from "./index-v17gj504.js";
 import {
   runner
-} from "./index-b3ae16mg.js";
+} from "./index-6na0sd2b.js";
 
 // pkgs/@akanjs/cli/workflow/workflow.runner.ts
 import { mkdir, readFile, writeFile } from "fs/promises";

package/{index-7f4dsf9v.js → index-3cymrzsb.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   CommandExecutionError
-} from "./index-5nyznra1.js";
+} from "./index-p4p9t45x.js";
 import {
   resolveMobilePath,
   targetHtmlFilename

package/{index-1nwxbr2y.js → index-3mg4h788.js}

@@ -2,10 +2,10 @@
 import {
   runner,
   script
-} from "./index-b3ae16mg.js";
+} from "./index-6na0sd2b.js";
 import {
   LibExecutor
-} from "./index-5nyznra1.js";
+} from "./index-p4p9t45x.js";
 import {
   LibSource,
   formatLibStatuses

package/{index-em4swemt.js → index-4cvpzkq6.js}

@@ -5,13 +5,13 @@ import {
   writeGeneratedSyncState,
   createRepairReport,
   renderRepairReport
-} from "./index-jwjaf9fy.js";
+} from "./index-qhtj9y6j.js";
 import {
   AkanContextAnalyzer
-} from "./index-15r9a10e.js";
+} from "./index-v17gj504.js";
 import {
   runner
-} from "./index-b3ae16mg.js";
+} from "./index-6na0sd2b.js";
 
 // pkgs/@akanjs/cli/repair/repair.runner.ts
 var commandForShell = (command) => command.startsWith("akan ") ? `bun run ${command}` : command;

package/index-4n4821gp.js

@@ -0,0 +1,69 @@
+// @bun
+import {
+  jsonText
+} from "./index-qhtj9y6j.js";
+import {
+  akanMcpInstallTargets
+} from "./index-v17gj504.js";
+import {
+  script
+} from "./index-6na0sd2b.js";
+import {
+  ContextRunner2
+} from "./index-g9zghs4h.js";
+
+// pkgs/@akanjs/cli/context/context.script.ts
+import { Logger } from "akanjs/common";
+var resolveMcpInstallTargets = (target) => {
+  if (!target || target === "all")
+    return [...akanMcpInstallTargets];
+  if (akanMcpInstallTargets.includes(target))
+    return [target];
+  throw new Error(`Unknown MCP install target: ${target}. Use cursor, claude, codex, or all.`);
+};
+var mcpTargetLabels = {
+  cursor: "Cursor",
+  claude: "Claude Code",
+  codex: "Codex"
+};
+
+class ContextScript extends script("context", [ContextRunner2]) {
+  async context(workspace, options = {}) {
+    Logger.rawLog(await this.contextRunner.getContext(workspace, options));
+  }
+  async doctor(workspace, options = {}) {
+    Logger.rawLog(await this.contextRunner.doctor(workspace, options));
+  }
+  async mcpInstall(workspace, target, { force = false, mode = "apply" } = {}) {
+    const targets = resolveMcpInstallTargets(target);
+    const written = [];
+    for (const t of targets) {
+      const configPath = await this.contextRunner.installMcp(workspace, t, { force, mode });
+      written.push(`${mcpTargetLabels[t]}: ${configPath}`);
+    }
+    Logger.rawLog(`Akan MCP server installed (${mode} mode):
+${written.map((line) => `- ${line}`).join(`
+`)}`);
+  }
+  async mcp(workspace, { mode = "apply" } = {}) {
+    await this.contextRunner.runMcp(workspace, { mode });
+  }
+  async mcpCall(workspace, tool, {
+    mode = "readonly",
+    args = null,
+    format = "json"
+  } = {}) {
+    let parsedArgs = {};
+    if (args) {
+      const parsed = JSON.parse(args);
+      if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error("MCP call args must be a JSON object.");
+      }
+      parsedArgs = parsed;
+    }
+    const result = await this.contextRunner.callMcpTool(workspace, tool, parsedArgs, { mode });
+    Logger.rawLog(format === "json" ? jsonText(result) : String(result));
+  }
+}
+
+export { ContextScript };