dorfl 0.1.2 → 0.2.0

package/dist/vendor/incur/agents.d.ts

@@ -0,0 +1,58 @@
+/** Agent configuration for skill installation. */
+export type Agent = {
+    /** Display name. */
+    name: string;
+    /** Absolute path to the global skills directory. */
+    globalSkillsDir: string;
+    /** Project-relative skills directory path. */
+    projectSkillsDir: string;
+    /** Whether this agent uses the canonical `.agents/skills` path. */
+    universal: boolean;
+    /** Checks if the agent is installed on the system. */
+    detect(): boolean;
+};
+/** All known agent definitions. */
+export declare const all: Agent[];
+/** Detects which agents are installed on the system. */
+export declare function detect(): Agent[];
+/**
+ * Installs skill directories to the canonical location and creates symlinks for
+ * detected non-universal agents.
+ *
+ * @param sourceDir - Directory containing skill subdirectories (each with a `SKILL.md`).
+ * @param options - Installation options.
+ * @returns Installed canonical paths.
+ */
+export declare function install(sourceDir: string, options?: install.Options): install.Result;
+export declare namespace install {
+    type Options = {
+        /** Override detected agents. */
+        agents?: Agent[] | undefined;
+        /** Working directory for project-local installs. */
+        cwd?: string | undefined;
+        /** Install globally. Defaults to `true`. */
+        global?: boolean | undefined;
+    };
+    type Result = {
+        /** Canonical install paths. */
+        paths: string[];
+        /** Per-agent install details (non-universal agents only). */
+        agents: AgentInstall[];
+    };
+    type AgentInstall = {
+        /** Agent display name. */
+        agent: string;
+        /** Installed path. */
+        path: string;
+        /** Whether it was symlinked or copied. */
+        mode: 'symlink' | 'copy';
+    };
+}
+/**
+ * Removes a skill by name from the canonical location and all detected agent directories.
+ */
+export declare function remove(skillName: string, options?: {
+    global?: boolean | undefined;
+    cwd?: string | undefined;
+}): void;
+//# sourceMappingURL=agents.d.ts.map

package/dist/vendor/incur/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/vendor/incur/agents.ts"],"names":[],"mappings":"AAwCA,kDAAkD;AAClD,MAAM,MAAM,KAAK,GAAG;IAClB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,oDAAoD;IACpD,eAAe,EAAE,MAAM,CAAA;IACvB,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,CAAA;IACxB,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAA;IAClB,sDAAsD;IACtD,MAAM,IAAI,OAAO,CAAA;CAClB,CAAA;AAOD,mCAAmC;AACnC,eAAO,MAAM,GAAG,EAAE,KAAK,EAuJtB,CAAA;AAED,wDAAwD;AACxD,wBAAgB,MAAM,IAAI,KAAK,EAAE,CAEhC;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,CAAC,OAAY,GAAG,OAAO,CAAC,MAAM,CAoDxF;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,KAAK,OAAO,GAAG;QACb,gCAAgC;QAChC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,SAAS,CAAA;QAC5B,oDAAoD;QACpD,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACxB,4CAA4C;QAC5C,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAC7B,CAAA;IACD,KAAK,MAAM,GAAG;QACZ,+BAA+B;QAC/B,KAAK,EAAE,MAAM,EAAE,CAAA;QACf,6DAA6D;QAC7D,MAAM,EAAE,YAAY,EAAE,CAAA;KACvB,CAAA;IACD,KAAK,YAAY,GAAG;QAClB,0BAA0B;QAC1B,KAAK,EAAE,MAAM,CAAA;QACb,sBAAsB;QACtB,IAAI,EAAE,MAAM,CAAA;QACZ,0CAA0C;QAC1C,IAAI,EAAE,SAAS,GAAG,MAAM,CAAA;KACzB,CAAA;CACF;AAED;;GAEG;AACH,wBAAgB,MAAM,CACpB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAO,QAczE"}

package/dist/vendor/incur/agents.js

@@ -0,0 +1,343 @@
+// ---------------------------------------------------------------------------
+// VENDORED FROM: https://github.com/wevm/incur
+//   Source:     src/internal/agents.ts
+//   License:    MIT (see ./LICENSE beside this file)
+//   Copyright:  (c) 2025-present weth, LLC
+//
+// This file is a VERBATIM copy of the upstream `src/internal/agents.ts` from
+// wevm/incur, preserved byte-close so future upstream updates are a mechanical
+// re-copy. Do NOT edit it in place — put all dorfl wrapper code OUTSIDE this
+// directory (see `../../install-skills.ts`). Only the block ABOVE this line is
+// dorfl-authored (attribution header). See `./README.md` for provenance and
+// the `docs/adr/skill-install-vendors-incur-agents-map.md` ADR for why we
+// vendor rather than depend.
+//
+// MIT permission notice (required by upstream license, kept in-file so the
+// attribution survives isolation from the sibling LICENSE):
+//
+//   Permission is hereby granted, free of charge, to any person obtaining a
+//   copy of this software and associated documentation files (the "Software"),
+//   to deal in the Software without restriction, including without limitation
+//   the rights to use, copy, modify, merge, publish, distribute, sublicense,
+//   and/or sell copies of the Software, and to permit persons to whom the
+//   Software is furnished to do so, subject to the following conditions:
+//
+//   The above copyright notice and this permission notice shall be included
+//   in all copies or substantial portions of the Software.
+//
+//   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+//   OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+//   MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+//   IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+//   CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+//   TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+//   SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+// ---------------------------------------------------------------------------
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+const home = os.homedir();
+const configHome = process.env.XDG_CONFIG_HOME || path.join(home, '.config');
+const claudeHome = process.env.CLAUDE_CONFIG_DIR?.trim() || path.join(home, '.claude');
+const codexHome = process.env.CODEX_HOME?.trim() || path.join(home, '.codex');
+/** All known agent definitions. */
+export const all = [
+    // Universal agents (project skillsDir = .agents/skills)
+    {
+        name: 'Amp',
+        globalSkillsDir: path.join(configHome, 'agents', 'skills'),
+        projectSkillsDir: '.agents/skills',
+        universal: true,
+        detect: () => fs.existsSync(path.join(configHome, 'amp')),
+    },
+    {
+        name: 'Cline',
+        globalSkillsDir: path.join(home, '.agents', 'skills'),
+        projectSkillsDir: '.agents/skills',
+        universal: true,
+        detect: () => fs.existsSync(path.join(home, '.cline')),
+    },
+    {
+        name: 'Codex',
+        globalSkillsDir: path.join(codexHome, 'skills'),
+        projectSkillsDir: '.agents/skills',
+        universal: true,
+        detect: () => fs.existsSync(codexHome),
+    },
+    {
+        name: 'Cursor',
+        globalSkillsDir: path.join(home, '.cursor', 'skills'),
+        projectSkillsDir: '.agents/skills',
+        universal: true,
+        detect: () => fs.existsSync(path.join(home, '.cursor')),
+    },
+    {
+        name: 'Gemini CLI',
+        globalSkillsDir: path.join(home, '.gemini', 'skills'),
+        projectSkillsDir: '.agents/skills',
+        universal: true,
+        detect: () => fs.existsSync(path.join(home, '.gemini')),
+    },
+    {
+        name: 'GitHub Copilot',
+        globalSkillsDir: path.join(home, '.copilot', 'skills'),
+        projectSkillsDir: '.agents/skills',
+        universal: true,
+        detect: () => fs.existsSync(path.join(home, '.copilot')),
+    },
+    {
+        name: 'Kimi CLI',
+        globalSkillsDir: path.join(configHome, 'agents', 'skills'),
+        projectSkillsDir: '.agents/skills',
+        universal: true,
+        detect: () => fs.existsSync(path.join(home, '.kimi')),
+    },
+    {
+        name: 'OpenCode',
+        globalSkillsDir: path.join(configHome, 'opencode', 'skills'),
+        projectSkillsDir: '.agents/skills',
+        universal: true,
+        detect: () => fs.existsSync(path.join(configHome, 'opencode')),
+    },
+    // Non-universal agents (need symlink from their skills dir to canonical)
+    {
+        name: 'Claude Code',
+        globalSkillsDir: path.join(claudeHome, 'skills'),
+        projectSkillsDir: '.claude/skills',
+        universal: false,
+        detect: () => fs.existsSync(claudeHome),
+    },
+    {
+        name: 'Windsurf',
+        globalSkillsDir: path.join(home, '.codeium', 'windsurf', 'skills'),
+        projectSkillsDir: '.windsurf/skills',
+        universal: false,
+        detect: () => fs.existsSync(path.join(home, '.codeium', 'windsurf')),
+    },
+    {
+        name: 'Continue',
+        globalSkillsDir: path.join(home, '.continue', 'skills'),
+        projectSkillsDir: '.continue/skills',
+        universal: false,
+        detect: () => fs.existsSync(path.join(home, '.continue')),
+    },
+    {
+        name: 'Roo',
+        globalSkillsDir: path.join(home, '.roo', 'skills'),
+        projectSkillsDir: '.roo/skills',
+        universal: false,
+        detect: () => fs.existsSync(path.join(home, '.roo')),
+    },
+    {
+        name: 'Kilo',
+        globalSkillsDir: path.join(home, '.kilocode', 'skills'),
+        projectSkillsDir: '.kilocode/skills',
+        universal: false,
+        detect: () => fs.existsSync(path.join(home, '.kilocode')),
+    },
+    {
+        name: 'Goose',
+        globalSkillsDir: path.join(configHome, 'goose', 'skills'),
+        projectSkillsDir: '.goose/skills',
+        universal: false,
+        detect: () => fs.existsSync(path.join(configHome, 'goose')),
+    },
+    {
+        name: 'Augment',
+        globalSkillsDir: path.join(home, '.augment', 'skills'),
+        projectSkillsDir: '.augment/skills',
+        universal: false,
+        detect: () => fs.existsSync(path.join(home, '.augment')),
+    },
+    {
+        name: 'Trae',
+        globalSkillsDir: path.join(home, '.trae', 'skills'),
+        projectSkillsDir: '.trae/skills',
+        universal: false,
+        detect: () => fs.existsSync(path.join(home, '.trae')),
+    },
+    {
+        name: 'Junie',
+        globalSkillsDir: path.join(home, '.junie', 'skills'),
+        projectSkillsDir: '.junie/skills',
+        universal: false,
+        detect: () => fs.existsSync(path.join(home, '.junie')),
+    },
+    {
+        name: 'Crush',
+        globalSkillsDir: path.join(configHome, 'crush', 'skills'),
+        projectSkillsDir: '.crush/skills',
+        universal: false,
+        detect: () => fs.existsSync(path.join(configHome, 'crush')),
+    },
+    {
+        name: 'Kiro CLI',
+        globalSkillsDir: path.join(home, '.kiro', 'skills'),
+        projectSkillsDir: '.kiro/skills',
+        universal: false,
+        detect: () => fs.existsSync(path.join(home, '.kiro')),
+    },
+    {
+        name: 'Qwen Code',
+        globalSkillsDir: path.join(home, '.qwen', 'skills'),
+        projectSkillsDir: '.qwen/skills',
+        universal: false,
+        detect: () => fs.existsSync(path.join(home, '.qwen')),
+    },
+    {
+        name: 'OpenHands',
+        globalSkillsDir: path.join(home, '.openhands', 'skills'),
+        projectSkillsDir: '.openhands/skills',
+        universal: false,
+        detect: () => fs.existsSync(path.join(home, '.openhands')),
+    },
+];
+/** Detects which agents are installed on the system. */
+export function detect() {
+    return all.filter((a) => a.detect());
+}
+/**
+ * Installs skill directories to the canonical location and creates symlinks for
+ * detected non-universal agents.
+ *
+ * @param sourceDir - Directory containing skill subdirectories (each with a `SKILL.md`).
+ * @param options - Installation options.
+ * @returns Installed canonical paths.
+ */
+export function install(sourceDir, options = {}) {
+    const isGlobal = options.global !== false;
+    const cwd = options.cwd || process.cwd();
+    const base = isGlobal ? home : cwd;
+    const canonicalBase = path.join(base, '.agents', 'skills');
+    const detected = options.agents ?? detect();
+    const paths = [];
+    const agents = [];
+    for (const skill of discoverSkills(sourceDir)) {
+        const canonicalDir = path.join(canonicalBase, skill.name);
+        // Copy to canonical location
+        rmForce(canonicalDir);
+        fs.mkdirSync(canonicalDir, { recursive: true });
+        if (skill.root)
+            fs.copyFileSync(path.join(skill.dir, 'SKILL.md'), path.join(canonicalDir, 'SKILL.md'));
+        else
+            fs.cpSync(skill.dir, canonicalDir, { recursive: true });
+        paths.push(canonicalDir);
+        // Create symlinks for non-universal agents
+        for (const agent of detected) {
+            if (agent.universal)
+                continue;
+            const agentSkillsDir = isGlobal
+                ? agent.globalSkillsDir
+                : path.join(cwd, agent.projectSkillsDir);
+            const agentDir = path.join(agentSkillsDir, skill.name);
+            // Skip if agent dir resolves to canonical (no symlink needed)
+            if (agentDir === canonicalDir)
+                continue;
+            try {
+                rmForce(agentDir);
+                fs.mkdirSync(path.dirname(agentDir), { recursive: true });
+                // Resolve through any existing symlinks in parent directories
+                const realLinkDir = resolveParent(path.dirname(agentDir));
+                const realTarget = resolveParent(canonicalDir);
+                const rel = path.relative(realLinkDir, realTarget);
+                fs.symlinkSync(rel, agentDir);
+                agents.push({ agent: agent.name, path: agentDir, mode: 'symlink' });
+            }
+            catch {
+                // Fallback to copy if symlink fails (e.g. Windows without permissions)
+                try {
+                    fs.cpSync(canonicalDir, agentDir, { recursive: true });
+                    agents.push({ agent: agent.name, path: agentDir, mode: 'copy' });
+                }
+                catch { }
+            }
+        }
+    }
+    return { paths, agents };
+}
+/**
+ * Removes a skill by name from the canonical location and all detected agent directories.
+ */
+export function remove(skillName, options = {}) {
+    const isGlobal = options.global !== false;
+    const cwd = options.cwd || process.cwd();
+    const base = isGlobal ? home : cwd;
+    const canonicalDir = path.join(base, '.agents', 'skills', skillName);
+    rmForce(canonicalDir);
+    for (const agent of detect()) {
+        if (agent.universal)
+            continue;
+        const agentSkillsDir = isGlobal ? agent.globalSkillsDir : path.join(cwd, agent.projectSkillsDir);
+        const agentDir = path.join(agentSkillsDir, skillName);
+        rmForce(agentDir);
+    }
+}
+/** Recursively discovers skill directories (those containing a `SKILL.md`). */
+function discoverSkills(rootDir) {
+    const results = [];
+    function visit(dir) {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const subDir = path.join(dir, entry.name);
+            const skillPath = path.join(subDir, 'SKILL.md');
+            if (fs.existsSync(skillPath)) {
+                const content = fs.readFileSync(skillPath, 'utf8');
+                const nameMatch = content.match(/^name:\s*(.+)$/m);
+                results.push({ name: sanitizeName(nameMatch?.[1] ?? entry.name), dir: subDir });
+            }
+            visit(subDir);
+        }
+    }
+    visit(rootDir);
+    // Root-level SKILL.md (e.g. depth=0)
+    const rootSkill = path.join(rootDir, 'SKILL.md');
+    if (fs.existsSync(rootSkill)) {
+        const content = fs.readFileSync(rootSkill, 'utf8');
+        const nameMatch = content.match(/^name:\s*(.+)$/m);
+        const name = sanitizeName(nameMatch?.[1] ?? 'skill');
+        if (!results.some((r) => r.name === name))
+            results.push({ name, dir: rootDir, root: true });
+    }
+    return results;
+}
+/** Sanitizes a skill name for use as a directory name. */
+function sanitizeName(name) {
+    return name.trim().replace(/[/\\]/g, '-').replace(/\.\./g, '').slice(0, 255);
+}
+/** Removes a file, directory, or symlink (including broken symlinks). */
+function rmForce(target) {
+    try {
+        const stat = fs.lstatSync(target);
+        if (stat.isSymbolicLink())
+            fs.unlinkSync(target);
+        else
+            fs.rmSync(target, { recursive: true, force: true });
+    }
+    catch { }
+}
+/** Resolves parent directories through symlinks. */
+function resolveParent(dir) {
+    try {
+        return fs.realpathSync(dir);
+    }
+    catch {
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return dir;
+        try {
+            return path.join(fs.realpathSync(parent), path.relative(parent, dir));
+        }
+        catch {
+            return dir;
+        }
+    }
+}
+//# sourceMappingURL=agents.js.map

package/dist/vendor/incur/agents.js.map

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

package/dist/verify-workflow-template.js

@@ -92,7 +92,7 @@ jobs:
   ${VERIFY_CHECK_CONTEXT}:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           fetch-depth: 0
       - uses: ./.github/actions/dorfl-setup

package/dist/watch-session.d.ts

@@ -17,9 +17,10 @@ export declare function boundaryLine(label: string, color: boolean): string;
  *   - a `{type:"message", message:{role:"assistant", content}}` record → for each
  *     `content[]` part: a `text` part yields its text (parts concatenated into
  *     ONE line, like the old `jq` `.content[]` select); a `toolCall` part yields
- *     `▶ <name>` (cyan; `name` OR `toolName`, defaulting to `tool`); a `thinking`
- *     part (and anything else) is skipped. A plain-string `content` yields one
- *     text line.
+ *     `▶ <name> <detail>` (cyan; `name` OR `toolName`, defaulting to `tool`;
+ *     `<detail>` is the per-tool argument summary, truncated to 64 chars with a
+ *     `…`); a `thinking` part (and anything else) is skipped. A plain-string
+ *     `content` yields one text line.
  *   - everything else (`session`/`model_change`/`thinking_level_change`, user
  *     messages, tool results, blank/malformed lines) → `[]` (skipped).
  *
@@ -38,6 +39,13 @@ export declare function formatWatchEvent(line: string, color: boolean): string[]
  * message:{role:"assistant", content[]}}` records, takes the LAST one carrying
  * non-empty `text`, and returns its concatenated text.
  *
+ * Kept as a PURE `string → string | undefined` function on purpose: the pi
+ * adapter reads the session file and passes the JSONL text in, but a future
+ * stream/HTTP-shaped harness (opencode-style) can accumulate its own event
+ * stream into the same JSONL-shaped text and reuse this reader unchanged — the
+ * file shape does NOT leak through the `LaunchResult.output` seam (Option C).
+ * See `work/notes/findings/pi-harness-channels.md` (task `pi-harness-polish`).
+ *
  * Returns `undefined` when the log has no assistant text at all — an absent log,
  * a malformed/short log, or a run whose only assistant turn was tool-calls (no
  * `text` part). A tool-only assistant turn is NOT a final answer, so a LATER

package/dist/watch-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watch-session.d.ts","sourceRoot":"","sources":["../src/watch-session.ts"],"names":[],"mappings":"AAuEA,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAElE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAyBvE;AAgED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA8BnE;AAED,MAAM,WAAW,oBAAoB;IACpC;;;;;;;OAOG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,KAAK,EAAE,OAAO,CAAC;IACf,0EAA0E;IAC1E,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAID;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyB;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAAS;gBAEpB,OAAO,EAAE,oBAAoB;IAOzC,0EAA0E;IAC1E,KAAK,IAAI,IAAI;IAWb;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B,sEAAsE;YACxD,IAAI;IAclB,8EAA8E;YAChE,KAAK;IA0BnB,iFAAiF;IACjF,OAAO,CAAC,UAAU;CAalB"}
+{"version":3,"file":"watch-session.d.ts","sourceRoot":"","sources":["../src/watch-session.ts"],"names":[],"mappings":"AA0JA,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAElE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAyBvE;AAoED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA8BnE;AAED,MAAM,WAAW,oBAAoB;IACpC;;;;;;;OAOG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,KAAK,EAAE,OAAO,CAAC;IACf,0EAA0E;IAC1E,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAID;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyB;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAAS;gBAEpB,OAAO,EAAE,oBAAoB;IAOzC,0EAA0E;IAC1E,KAAK,IAAI,IAAI;IAWb;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B,sEAAsE;YACxD,IAAI;IAclB,8EAA8E;YAChE,KAAK;IA0BnB,iFAAiF;IACjF,OAAO,CAAC,UAAU;CAalB"}

package/dist/watch-session.js

@@ -12,6 +12,16 @@ import { open } from 'node:fs/promises';
  * `--mode json` STREAM `ar-run.sh` piped. The tailer is pointed at that EXACT
  * path (no newest-by-mtime dir guessing), so the stale-sibling race is gone.
  *
+ * Studied (task `pi-harness-polish`, finding
+ * `work/notes/findings/pi-harness-channels.md`, pinned against pi 0.73.1 +
+ * session format v3): tailing the session file is deliberately the CHOSEN
+ * channel for `--watch`, not just what was easiest to reuse. `--mode json`'s
+ * STDOUT event vocabulary would be lower-latency but it is unversioned, would
+ * fork a second parser away from pi-remote's `session-pool.ts` reference walk
+ * this classifier mirrors, and the vocabulary-drift risk that already bit
+ * `do --watch` once applies MORE to it than to the versioned+migrated session
+ * file. Revisit only if pi's session format changes.
+ *
  * A session-log record is `{"type":"message", "message":{role, content[]}}` (or a
  * `session`/`model_change`/`thinking_level_change` preamble record). The earlier
  * classifier matched the STREAM vocabulary (`tool_start`/`message_end`/`agent_end`),
@@ -20,8 +30,10 @@ import { open } from 'node:fs/promises';
  * surfaces the same high-signal level `ar-run.sh --watch` gave, read off the
  * SESSION-LOG shape:
  *
- *   - an `assistant` `message` → its `content[]` `text` parts, then `▶ <name>`
- *     (cyan) per `content[]` `toolCall` part;
+ *   - an `assistant` `message` → its `content[]` `text` parts, then
+ *     `▶ <name> <detail>` (cyan) per `content[]` `toolCall` part, where
+ *     `<detail>` is the high-signal argument for that tool (a `read`'s path, a
+ *     `bash`'s command, …), truncated to 64 chars with a trailing `…`;
  *   - `✓ agent finished` (green) on PROCESS EXIT — the session log has no
  *     `agent_end` event, so the tailer emits it once on `stop()`;
  *   - everything else (`session`/`model_change`/user messages/tool results/…) →
@@ -46,6 +58,69 @@ const RESET = '\u001b[0m';
 function paint(text, color, code) {
     return color ? `${code}${text}${RESET}` : text;
 }
+/**
+ * The max width of a tool-call DETAIL string (the `read <path>` / `bash <cmd>`
+ * argument summary appended after the tool name). A longer detail is truncated
+ * to this many characters with a trailing `…`, so a giant `bash` heredoc or a
+ * long path never floods the live view with one enormous line.
+ */
+const MAX_DETAIL_LENGTH = 64;
+/** Truncate `text` to {@link MAX_DETAIL_LENGTH} chars, appending `…` when cut. */
+function truncateDetail(text) {
+    // Collapse any embedded newlines/tabs to single spaces first: a multi-line
+    // `bash` command must stay ONE line in the tail view.
+    const oneLine = text.replace(/\s+/g, ' ').trim();
+    if (oneLine.length <= MAX_DETAIL_LENGTH) {
+        return oneLine;
+    }
+    return `${oneLine.slice(0, MAX_DETAIL_LENGTH)}…`;
+}
+/**
+ * The FIRST non-empty string among `keys` in a tool-call's arguments object, or
+ * `undefined` when the args are absent / none of the keys carry a string. The
+ * args live under `arguments` (pi's canonical key) OR `args` (the variant seen
+ * in some session records), mirroring the `name || toolName` defensiveness used
+ * for the tool name itself.
+ */
+function firstArgString(part, keys) {
+    const rawArgs = (typeof part.arguments === 'object' && part.arguments) ||
+        (typeof part.args === 'object' && part.args) ||
+        undefined;
+    if (!rawArgs || rawArgs === null) {
+        return undefined;
+    }
+    const args = rawArgs;
+    for (const key of keys) {
+        const value = args[key];
+        if (typeof value === 'string' && value !== '') {
+            return value;
+        }
+    }
+    return undefined;
+}
+/**
+ * The high-signal ARGUMENT to show after a tool name, chosen per tool so the
+ * `▶ <name>` marker reads like the agent's actual action (`▶ read work/x.md`,
+ * `▶ bash pnpm -r build`). The mapping mirrors this harness's own tool set
+ * (read/edit/write/grep/find/ls take a `path`; bash a `command`; grep a
+ * `pattern`; find/ls a `pattern`/`path`); any unmapped tool falls back to a
+ * generic `path`/`command`/`pattern`/`query` probe so a new tool still shows
+ * *something* useful. Returns `''` when no informative arg is present.
+ */
+function toolCallDetail(name, part) {
+    const byTool = {
+        read: ['path'],
+        edit: ['path'],
+        write: ['path'],
+        ls: ['path'],
+        find: ['pattern', 'path'],
+        grep: ['pattern', 'path'],
+        bash: ['command'],
+    };
+    const keys = byTool[name] ?? ['path', 'command', 'pattern', 'query', 'file'];
+    const detail = firstArgString(part, keys);
+    return detail === undefined ? '' : truncateDetail(detail);
+}
 /** The green `✓ agent finished` line, emitted on PROCESS EXIT (not a log event). */
 export function finishedLine(color) {
     return paint('✓ agent finished', color, GREEN);
@@ -69,9 +144,10 @@ export function boundaryLine(label, color) {
  *   - a `{type:"message", message:{role:"assistant", content}}` record → for each
  *     `content[]` part: a `text` part yields its text (parts concatenated into
  *     ONE line, like the old `jq` `.content[]` select); a `toolCall` part yields
- *     `▶ <name>` (cyan; `name` OR `toolName`, defaulting to `tool`); a `thinking`
- *     part (and anything else) is skipped. A plain-string `content` yields one
- *     text line.
+ *     `▶ <name> <detail>` (cyan; `name` OR `toolName`, defaulting to `tool`;
+ *     `<detail>` is the per-tool argument summary, truncated to 64 chars with a
+ *     `…`); a `thinking` part (and anything else) is skipped. A plain-string
+ *     `content` yields one text line.
  *   - everything else (`session`/`model_change`/`thinking_level_change`, user
  *     messages, tool results, blank/malformed lines) → `[]` (skipped).
  *
@@ -113,7 +189,9 @@ export function formatWatchEvent(line, color) {
  * pi-remote's `session-pool.ts` reference parser. The `text` parts are
  * concatenated into a SINGLE leading line (so a multi-part assistant turn reads
  * as one sentence, as `ar-run.sh --watch` showed it); each `toolCall` part adds a
- * `▶ <name>` line after it. A plain-string content yields the single text line.
+ * `▶ <name> <detail>` line after it (`<detail>` = the tool's high-signal
+ * argument, truncated to 64 chars). A plain-string content yields the single
+ * text line.
  * `thinking` parts and any other block type are skipped.
  */
 function assistantLines(content, color) {
@@ -134,7 +212,9 @@ function assistantLines(content, color) {
             const name = (typeof p.name === 'string' && p.name !== '' && p.name) ||
                 (typeof p.toolName === 'string' && p.toolName !== '' && p.toolName) ||
                 'tool';
-            lines.push(paint(`▶ ${name}`, color, CYAN));
+            const detail = toolCallDetail(name, p);
+            const label = detail === '' ? name : `${name} ${detail}`;
+            lines.push(paint(`▶ ${label}`, color, CYAN));
         }
         // `text` is collected by assistantContentText; `thinking` and any other
         // block type are skipped.
@@ -175,6 +255,13 @@ function assistantContentText(content) {
  * message:{role:"assistant", content[]}}` records, takes the LAST one carrying
  * non-empty `text`, and returns its concatenated text.
  *
+ * Kept as a PURE `string → string | undefined` function on purpose: the pi
+ * adapter reads the session file and passes the JSONL text in, but a future
+ * stream/HTTP-shaped harness (opencode-style) can accumulate its own event
+ * stream into the same JSONL-shaped text and reuse this reader unchanged — the
+ * file shape does NOT leak through the `LaunchResult.output` seam (Option C).
+ * See `work/notes/findings/pi-harness-channels.md` (task `pi-harness-polish`).
+ *
  * Returns `undefined` when the log has no assistant text at all — an absent log,
  * a malformed/short log, or a run whose only assistant turn was tool-calls (no
  * `text` part). A tool-only assistant turn is NOT a final answer, so a LATER