@north-light/crouter 0.3.318 → 0.3.319

package/dist/commands/canvas-browse.js

@@ -1,70 +1 @@
-// `crtr canvas browse` — the interactive full-screen canvas navigator.
-//
-// A raw-mode TUI over the WHOLE canvas: tabs (All/Live/Dormant/Attention/Pinned), an
-// auto-collapsed tree, and `/` fuzzy search. Enter resumes the chosen node via
-// `crtr surface node focus` (the ONLY sanctioned open — reviveNode, never `pi --session`).
-// Owns the screen, so it returns void and writes nothing to stdout itself.
-// Outside a TTY it prints the static forest and exits 0 (see runBrowse).
-import { envProfileId } from '../shared/env.js';
-import { defineLeaf } from '../core/command.js';
-import { runBrowse } from '../core/canvas/browse/app.js';
-import { ApiCanvasSource, cliClient } from './api-client.js';
-import { getDefaultProfileId } from '../core/profiles/default-binding.js';
-export const browseLeaf = defineLeaf({
-    name: 'browse',
-    description: 'open the interactive canvas navigator (tabs/tree/search)',
-    whenToUse: 'you want to VIEW and NAVIGATE the whole canvas interactively — a full-screen TUI with tabs (All/Live/Dormant/Attention/Pinned), an expandable tree (children auto-collapsed; → to expand), `/` fuzzy search, `f` to pin, `y` to copy a node id, `m` to message and `R` to rename a node in place, and `?` for the full keymap; it opens on Live (active/idle) and Enter resumes the chosen node. Use this to find your way around a large canvas. Use `canvas dashboard` instead for a one-shot ASCII tree you can pipe, and `node inspect list` for a flat machine-readable roster',
-    help: {
-        name: 'canvas browse',
-        summary: 'interactive full-screen canvas navigator — tabs, an auto-collapsed tree, and `/` fuzzy search; Enter resumes the chosen node via `crtr surface node focus`. Outside a TTY it prints the static forest and exits',
-        params: [
-            {
-                kind: 'flag',
-                name: 'return-pane',
-                type: 'string',
-                required: false,
-                constraint: 'tmux pane id the chosen node REPLACES on Enter — that pane is respawned onto its viewer (set by the /resume popup, so resuming swaps the pane you invoked it from). Default: focus into this pane without replacing it.',
-            },
-            {
-                kind: 'flag',
-                name: 'cwd',
-                type: 'string',
-                required: false,
-                constraint: 'directory used when you toggle the optional cwd filter (c). The navigator opens with All dirs; /resume passes the launching node\'s cwd. Default: the invocation cwd.',
-            },
-            {
-                kind: 'flag',
-                name: 'profile-id',
-                type: 'string',
-                required: false,
-                constraint: 'Exact profile id for the initial profile filter (on by default; P toggles All profiles). Default: the launching node\'s profile via CRTR_PROFILE_ID, then this cwd\'s pinned default profile; absent means All profiles.',
-            },
-        ],
-        output: [],
-        outputKind: 'object',
-        effects: [
-            'Takes over the terminal in raw mode (alt-screen) until you quit (q/Esc) or pick a node.',
-            'On Enter: resumes the selected node via `crtr surface node focus` (reviveNode — the only sanctioned open).',
-            'Read-only on the canvas db; mutates nothing but the chosen node\'s placement on resume.',
-        ],
-    },
-    run: async (input) => {
-        const cwd = input['cwd'] ?? process.cwd();
-        const profileId = input['profileId'] ??
-            envProfileId() ??
-            getDefaultProfileId(cwd) ??
-            undefined;
-        const source = new ApiCanvasSource();
-        // The `x` close-out routes through the daemon API (browse `x` = finish the
-        // root to `done`); the callback keeps app.ts off the openDb-reaching
-        // runtime/close.js.
-        await runBrowse({
-            returnPane: input['returnPane'],
-            cwd,
-            profileId,
-            source,
-            viewedNodeIds: async () => new Set((await cliClient().listFocuses()).map((focus) => focus.node_id)),
-            closeNode: (id) => cliClient().closeNode(id, process.ppid > 0 ? { finish: true, caller_pid: process.ppid } : { finish: true }).then((r) => ({ closed: r.closed })),
-        });
-    },
-});
+var d=Object.defineProperty;var t=(e,n)=>d(e,"name",{value:n,configurable:!0});import{envProfileId as c}from"../shared/env.js";import{defineLeaf as l}from"../core/command.js";import{runBrowse as p}from"../core/canvas/browse/app.js";import{ApiCanvasSource as u,cliClient as o}from"./api-client.js";import{getDefaultProfileId as f}from"../core/profiles/default-binding.js";const b=l({name:"browse",description:"open the interactive canvas navigator (tabs/tree/search)",whenToUse:"you want to VIEW and NAVIGATE the whole canvas interactively \u2014 a full-screen TUI with tabs (All/Live/Dormant/Attention/Pinned), an expandable tree (children auto-collapsed; \u2192 to expand), `/` fuzzy search, `f` to pin, `y` to copy a node id, `m` to message and `R` to rename a node in place, and `?` for the full keymap; it opens on Live (active/idle) and Enter resumes the chosen node. Use this to find your way around a large canvas. Use `canvas dashboard` instead for a one-shot ASCII tree you can pipe, and `node inspect list` for a flat machine-readable roster",help:{name:"canvas browse",summary:"interactive full-screen canvas navigator \u2014 tabs, an auto-collapsed tree, and `/` fuzzy search; Enter resumes the chosen node via `crtr surface node focus`. Outside a TTY it prints the static forest and exits",params:[{kind:"flag",name:"return-pane",type:"string",required:!1,constraint:"tmux pane id the chosen node REPLACES on Enter \u2014 that pane is respawned onto its viewer (set by the /resume popup, so resuming swaps the pane you invoked it from). Default: focus into this pane without replacing it."},{kind:"flag",name:"cwd",type:"string",required:!1,constraint:"directory used when you toggle the optional cwd filter (c). The navigator opens with All dirs; /resume passes the launching node's cwd. Default: the invocation cwd."},{kind:"flag",name:"profile-id",type:"string",required:!1,constraint:"Exact profile id for the initial profile filter (on by default; P toggles All profiles). Default: the launching node's profile via CRTR_PROFILE_ID, then this cwd's pinned default profile; absent means All profiles."}],output:[],outputKind:"object",effects:["Takes over the terminal in raw mode (alt-screen) until you quit (q/Esc) or pick a node.","On Enter: resumes the selected node via `crtr surface node focus` (reviveNode \u2014 the only sanctioned open).","Read-only on the canvas db; mutates nothing but the chosen node's placement on resume."]},run:t(async e=>{const n=e.cwd??process.cwd(),s=e.profileId??c()??f(n)??void 0,r=new u;await p({returnPane:e.returnPane,cwd:n,profileId:s,source:r,viewedNodeIds:t(async()=>new Set((await o().listFocuses()).map(a=>a.node_id)),"viewedNodeIds"),closeNode:t(a=>o().closeNode(a,process.ppid>0?{finish:!0,caller_pid:process.ppid}:{finish:!0}).then(i=>({closed:i.closed})),"closeNode")})},"run")});export{b as browseLeaf};

package/dist/commands/canvas-config.js

@@ -1,192 +1,2 @@
-// `crtr canvas config` — register, list, inspect, and remove named remote
-// canvas targets (a preview endpoint + a relay token kept in the 0600
-// secrets store, never persisted to config.json or logged). `add` requires
-// `--relay-token -` (stdin-only) — a literal argv value is rejected with a
-// generic error (never echoing what was received, since it may be a real
-// secret) so the token can never land in shell history or process listings.
-// Selecting one for read commands is `crtr canvas use`, a sibling leaf, not a
-// child here.
-import { defineBranch, defineLeaf } from '../core/command.js';
-import { InputError, readStdinRaw } from '../core/io.js';
-import { readConfig, updateConfig } from '../core/config.js';
-import { readSecrets, setRelayToken, deleteRelayToken, fingerprint } from '../core/secrets.js';
-const SCOPE = 'user';
-/** Masks one target's token presence/fingerprint from an ALREADY-loaded
- *  `SecretsStore` — never re-reads/reparses `secrets.json` per target
- *  (`list`/`show` load it once and pass it in here). */
-function maskedTarget(name, target, secrets) {
-    const token = secrets.relayTokens[target.relayTokenRef];
-    return {
-        name,
-        previewEndpoint: target.previewEndpoint,
-        relayTokenRef: target.relayTokenRef,
-        ...(target.cpOrigin ? { cpOrigin: target.cpOrigin } : {}),
-        tokenStored: token !== undefined && token !== '',
-        ...(token !== undefined && token !== '' ? { fingerprint: fingerprint(token) } : {}),
-    };
-}
-// canvas config add
-const canvasConfigAdd = defineLeaf({
-    name: 'add',
-    description: 'register a remote canvas target (preview endpoint + relay token)',
-    whenToUse: 'wiring up a remote canvas so `node inspect` or `surface attach --canvas` can reach it \u2014 stores the preview endpoint in config.json and the raw relay token in the 0600 secrets store (never together, never persisted to config.json or logged). Re-running with the same name overwrites both.',
-    help: {
-        name: 'canvas config add',
-        summary: 'register (or overwrite) a named remote canvas target',
-        params: [
-            { kind: 'positional', name: 'name', required: true, constraint: 'Target name \u2014 the id every other `canvas config`/`canvas use`/`--canvas` reference uses.' },
-            { kind: 'flag', name: 'preview', type: 'string', required: true, constraint: 'The Blaxel preview endpoint base URL (e.g. https://<hash>.preview.bl.run).' },
-            { kind: 'flag', name: 'relay-token', type: 'string', required: true, constraint: 'Must be exactly `-` — the raw token is read from stdin, never argv (keeps it out of shell history). Any other value is rejected.' },
-            { kind: 'flag', name: 'cp', type: 'string', required: false, constraint: 'Optional control-plane origin, when this target has one distinct from the preview endpoint.' },
-        ],
-        output: [],
-        outputKind: 'object',
-        effects: ['Writes remoteCanvas.targets.<name> to config.json (previewEndpoint, relayTokenRef, cpOrigin).', 'Writes the raw token to the 0600 secrets store under relayTokenRef \u2014 never to config.json or stdout.'],
-    },
-    run: async (input) => {
-        const name = input['name'];
-        const previewEndpoint = input['preview'];
-        const rawFlag = input['relayToken'];
-        const cp = input['cp'];
-        if (rawFlag !== '-') {
-            throw new InputError({
-                error: 'invalid_relay_token_arg',
-                message: 'relay token must be piped on stdin — pass `--relay-token -`',
-                field: 'relay-token',
-                next: 'Re-run with `--relay-token -` and pipe the raw token on stdin (e.g. `echo "$TOKEN" | crtr canvas config add <name> --preview <url> --relay-token -`).',
-            });
-        }
-        const token = (await readStdinRaw()).trim();
-        if (token === '') {
-            throw new InputError({
-                error: 'empty_token',
-                message: 'relay token is empty',
-                field: 'relay-token',
-                next: 'Pass a non-empty token, or `--relay-token -` and pipe it on stdin.',
-            });
-        }
-        const target = { previewEndpoint, relayTokenRef: name, ...(cp ? { cpOrigin: cp } : {}) };
-        updateConfig(SCOPE, (cfg) => {
-            cfg.remoteCanvas.targets[name] = target;
-        });
-        setRelayToken(name, token, SCOPE);
-        return {};
-    },
-    render: () => 'Registered remote canvas target (token stored).',
-});
-// canvas config list
-const canvasConfigList = defineLeaf({
-    name: 'list',
-    description: 'list registered remote canvas targets',
-    whenToUse: 'checking which remote canvas targets exist before `canvas use`/`--canvas <name>` \u2014 never prints a raw token, only a non-reversible fingerprint.',
-    help: {
-        name: 'canvas config list',
-        summary: 'list every registered remote canvas target (masked \u2014 no raw tokens)',
-        output: [
-            {
-                name: 'targets',
-                type: 'object[]',
-                required: true,
-                constraint: 'Each: {name, previewEndpoint, relayTokenRef, cpOrigin?, tokenStored, fingerprint?}. fingerprint is a non-reversible sha256 prefix, present only when a token is stored.',
-            },
-        ],
-        outputKind: 'object',
-        effects: ['Read-only: reads config.json and the secrets-store token presence/fingerprint (never the raw token).'],
-    },
-    run: async () => {
-        const cfg = readConfig(SCOPE);
-        const secrets = readSecrets(SCOPE);
-        const targets = Object.entries(cfg.remoteCanvas.targets).map(([name, t]) => maskedTarget(name, t, secrets));
-        return { targets };
-    },
-    render: (r) => {
-        const targets = r['targets'];
-        if (targets.length === 0)
-            return 'No remote canvas targets configured.';
-        return targets
-            .map((t) => `${t['name']} — ${t['previewEndpoint']} (${t['tokenStored'] ? `token ${t['fingerprint']}` : 'no token stored'})`)
-            .join('\n');
-    },
-});
-// canvas config show
-const canvasConfigShow = defineLeaf({
-    name: 'show',
-    description: 'show one registered remote canvas target',
-    whenToUse: 'inspecting a single remote canvas target\u2019s config \u2014 masked the same way as `list`.',
-    help: {
-        name: 'canvas config show',
-        summary: 'show one remote canvas target (masked \u2014 no raw token)',
-        params: [
-            { kind: 'positional', name: 'name', required: true, constraint: 'Target name.' },
-        ],
-        output: [
-            { name: 'name', type: 'string', required: true, constraint: 'The target name.' },
-            { name: 'previewEndpoint', type: 'string', required: true, constraint: 'The stored preview endpoint.' },
-            { name: 'relayTokenRef', type: 'string', required: true, constraint: 'The secrets-store key holding the token.' },
-            { name: 'cpOrigin', type: 'string', required: false, constraint: 'The stored control-plane origin, when this target has one distinct from the preview endpoint.' },
-            { name: 'tokenStored', type: 'boolean', required: true, constraint: 'Whether a token is currently stored under relayTokenRef.' },
-        ],
-        outputKind: 'object',
-        effects: ['Read-only.'],
-    },
-    run: async (input) => {
-        const name = input['name'];
-        const cfg = readConfig(SCOPE);
-        const target = cfg.remoteCanvas.targets[name];
-        if (target === undefined) {
-            throw new InputError({
-                error: 'not_found',
-                message: `no remote canvas target named '${name}'`,
-                next: 'List configured targets with `crtr canvas config list`.',
-            });
-        }
-        return maskedTarget(name, target, readSecrets(SCOPE));
-    },
-    render: (r) => `${r['name']} — ${r['previewEndpoint']} (${r['tokenStored'] ? `token ${r['fingerprint']}` : 'no token stored'})`,
-});
-// canvas config remove
-const canvasConfigRemove = defineLeaf({
-    name: 'remove',
-    description: 'remove a registered remote canvas target and its stored token',
-    whenToUse: 'decommissioning a remote canvas target \u2014 drops it from config.json and deletes its raw token from the secrets store.',
-    help: {
-        name: 'canvas config remove',
-        summary: 'remove a remote canvas target and its stored token',
-        params: [
-            { kind: 'positional', name: 'name', required: true, constraint: 'Target name.' },
-        ],
-        output: [],
-        outputKind: 'object',
-        effects: ['Deletes remoteCanvas.targets.<name> from config.json.', 'Deletes the stored token under relayTokenRef from the secrets store.'],
-    },
-    run: async (input) => {
-        const name = input['name'];
-        const cfg = readConfig(SCOPE);
-        const target = cfg.remoteCanvas.targets[name];
-        if (target === undefined) {
-            throw new InputError({
-                error: 'not_found',
-                message: `no remote canvas target named '${name}'`,
-                next: 'List configured targets with `crtr canvas config list`.',
-            });
-        }
-        updateConfig(SCOPE, (c) => {
-            delete c.remoteCanvas.targets[name];
-        });
-        deleteRelayToken(target.relayTokenRef, SCOPE);
-        return {};
-    },
-    render: () => 'Removed remote canvas target.'
-});
-// Export — mounted under `crtr canvas`
-export const canvasConfigBranch = defineBranch({
-    name: 'config',
-    description: 'register/list/inspect/remove remote canvas targets',
-    whenToUse: 'setting up or auditing a remote canvas target (preview endpoint + relay token) before selecting one with `crtr canvas use`.',
-    help: {
-        name: 'canvas config',
-        summary: 'manage named remote canvas targets',
-        model: 'A remote canvas target is a preview endpoint + a relay token registered under a name. `add` registers one (token goes to the 0600 secrets store, never config.json); `list`/`show` display masked entries (fingerprint only, never the raw token); `remove` deletes both the config entry and the stored token. Select a target for read commands with `crtr canvas use <name>`, or back to local with `crtr canvas use --local`.',
-    },
-    children: [canvasConfigAdd, canvasConfigList, canvasConfigShow, canvasConfigRemove],
-});
+var v=Object.defineProperty;var a=(n,e)=>v(n,"name",{value:e,configurable:!0});import{defineBranch as h,defineLeaf as i}from"../core/command.js";import{InputError as c,readStdinRaw as k}from"../core/io.js";import{readConfig as d,updateConfig as m}from"../core/config.js";import{readSecrets as p,setRelayToken as w,deleteRelayToken as y,fingerprint as T}from"../core/secrets.js";const o="user";function f(n,e,r){const t=r.relayTokens[e.relayTokenRef];return{name:n,previewEndpoint:e.previewEndpoint,relayTokenRef:e.relayTokenRef,...e.cpOrigin?{cpOrigin:e.cpOrigin}:{},tokenStored:t!==void 0&&t!=="",...t!==void 0&&t!==""?{fingerprint:T(t)}:{}}}a(f,"maskedTarget");const R=i({name:"add",description:"register a remote canvas target (preview endpoint + relay token)",whenToUse:"wiring up a remote canvas so `node inspect` or `surface attach --canvas` can reach it \u2014 stores the preview endpoint in config.json and the raw relay token in the 0600 secrets store (never together, never persisted to config.json or logged). Re-running with the same name overwrites both.",help:{name:"canvas config add",summary:"register (or overwrite) a named remote canvas target",params:[{kind:"positional",name:"name",required:!0,constraint:"Target name \u2014 the id every other `canvas config`/`canvas use`/`--canvas` reference uses."},{kind:"flag",name:"preview",type:"string",required:!0,constraint:"The Blaxel preview endpoint base URL (e.g. https://<hash>.preview.bl.run)."},{kind:"flag",name:"relay-token",type:"string",required:!0,constraint:"Must be exactly `-` \u2014 the raw token is read from stdin, never argv (keeps it out of shell history). Any other value is rejected."},{kind:"flag",name:"cp",type:"string",required:!1,constraint:"Optional control-plane origin, when this target has one distinct from the preview endpoint."}],output:[],outputKind:"object",effects:["Writes remoteCanvas.targets.<name> to config.json (previewEndpoint, relayTokenRef, cpOrigin).","Writes the raw token to the 0600 secrets store under relayTokenRef \u2014 never to config.json or stdout."]},run:a(async n=>{const e=n.name,r=n.preview,t=n.relayToken,s=n.cp;if(t!=="-")throw new c({error:"invalid_relay_token_arg",message:"relay token must be piped on stdin \u2014 pass `--relay-token -`",field:"relay-token",next:'Re-run with `--relay-token -` and pipe the raw token on stdin (e.g. `echo "$TOKEN" | crtr canvas config add <name> --preview <url> --relay-token -`).'});const g=(await k()).trim();if(g==="")throw new c({error:"empty_token",message:"relay token is empty",field:"relay-token",next:"Pass a non-empty token, or `--relay-token -` and pipe it on stdin."});const u={previewEndpoint:r,relayTokenRef:e,...s?{cpOrigin:s}:{}};return m(o,l=>{l.remoteCanvas.targets[e]=u}),w(e,g,o),{}},"run"),render:a(()=>"Registered remote canvas target (token stored).","render")}),b=i({name:"list",description:"list registered remote canvas targets",whenToUse:"checking which remote canvas targets exist before `canvas use`/`--canvas <name>` \u2014 never prints a raw token, only a non-reversible fingerprint.",help:{name:"canvas config list",summary:"list every registered remote canvas target (masked \u2014 no raw tokens)",output:[{name:"targets",type:"object[]",required:!0,constraint:"Each: {name, previewEndpoint, relayTokenRef, cpOrigin?, tokenStored, fingerprint?}. fingerprint is a non-reversible sha256 prefix, present only when a token is stored."}],outputKind:"object",effects:["Read-only: reads config.json and the secrets-store token presence/fingerprint (never the raw token)."]},run:a(async()=>{const n=d(o),e=p(o);return{targets:Object.entries(n.remoteCanvas.targets).map(([t,s])=>f(t,s,e))}},"run"),render:a(n=>{const e=n.targets;return e.length===0?"No remote canvas targets configured.":e.map(r=>`${r.name} \u2014 ${r.previewEndpoint} (${r.tokenStored?`token ${r.fingerprint}`:"no token stored"})`).join(`
+`)},"render")}),j=i({name:"show",description:"show one registered remote canvas target",whenToUse:"inspecting a single remote canvas target\u2019s config \u2014 masked the same way as `list`.",help:{name:"canvas config show",summary:"show one remote canvas target (masked \u2014 no raw token)",params:[{kind:"positional",name:"name",required:!0,constraint:"Target name."}],output:[{name:"name",type:"string",required:!0,constraint:"The target name."},{name:"previewEndpoint",type:"string",required:!0,constraint:"The stored preview endpoint."},{name:"relayTokenRef",type:"string",required:!0,constraint:"The secrets-store key holding the token."},{name:"cpOrigin",type:"string",required:!1,constraint:"The stored control-plane origin, when this target has one distinct from the preview endpoint."},{name:"tokenStored",type:"boolean",required:!0,constraint:"Whether a token is currently stored under relayTokenRef."}],outputKind:"object",effects:["Read-only."]},run:a(async n=>{const e=n.name,t=d(o).remoteCanvas.targets[e];if(t===void 0)throw new c({error:"not_found",message:`no remote canvas target named '${e}'`,next:"List configured targets with `crtr canvas config list`."});return f(e,t,p(o))},"run"),render:a(n=>`${n.name} \u2014 ${n.previewEndpoint} (${n.tokenStored?`token ${n.fingerprint}`:"no token stored"})`,"render")}),C=i({name:"remove",description:"remove a registered remote canvas target and its stored token",whenToUse:"decommissioning a remote canvas target \u2014 drops it from config.json and deletes its raw token from the secrets store.",help:{name:"canvas config remove",summary:"remove a remote canvas target and its stored token",params:[{kind:"positional",name:"name",required:!0,constraint:"Target name."}],output:[],outputKind:"object",effects:["Deletes remoteCanvas.targets.<name> from config.json.","Deletes the stored token under relayTokenRef from the secrets store."]},run:a(async n=>{const e=n.name,t=d(o).remoteCanvas.targets[e];if(t===void 0)throw new c({error:"not_found",message:`no remote canvas target named '${e}'`,next:"List configured targets with `crtr canvas config list`."});return m(o,s=>{delete s.remoteCanvas.targets[e]}),y(t.relayTokenRef,o),{}},"run"),render:a(()=>"Removed remote canvas target.","render")}),x=h({name:"config",description:"register/list/inspect/remove remote canvas targets",whenToUse:"setting up or auditing a remote canvas target (preview endpoint + relay token) before selecting one with `crtr canvas use`.",help:{name:"canvas config",summary:"manage named remote canvas targets",model:"A remote canvas target is a preview endpoint + a relay token registered under a name. `add` registers one (token goes to the 0600 secrets store, never config.json); `list`/`show` display masked entries (fingerprint only, never the raw token); `remove` deletes both the config entry and the stored token. Select a target for read commands with `crtr canvas use <name>`, or back to local with `crtr canvas use --local`."},children:[R,b,j,C]});export{x as canvasConfigBranch};

package/dist/commands/canvas-history/grep.js

@@ -1,85 +1,7 @@
-import { defineLeaf } from '../../core/command.js';
-import { usage } from '../../core/errors.js';
-import { cliClient, rethrowAsCliError } from '../api-client.js';
-import { applyFilters, filterParams, parseFilters } from './shared.js';
-export const grepLeaf = defineLeaf({
-    name: 'grep',
-    description: 'exact regex line search across the cwd\'s node history',
-    whenToUse: 'you know the exact string or pattern you\'re looking for — an error message, a literal identifier, a code fragment — and want every matching body LINE across every node that ran in this cwd, not a relevance ranking. The pattern is required (an ECMAScript regex, case-insensitive). Narrow with --type/--kind/--status/--since, scope elsewhere with --cwd/--all-cwds/--under/--node. Want ranked/browse search instead? Use `canvas history search` — a distinct leaf, not a flag here. Use `canvas history read <ref>` to read a hit\'s full body, `node inspect artifacts <node-id>` to list one node\'s artifacts, and `node lifecycle revive <id>` to reopen a node you found.',
-    help: {
-        name: 'canvas history grep',
-        summary: 'required-pattern regex line search over the per-cwd episodic record (reports + context docs + meta; transcripts and inbox opt-in)',
-        params: [
-            { kind: 'positional', name: 'pattern', required: true, constraint: 'An ECMAScript regex, matched case-insensitively against each body line. One hit per matching line.' },
-            ...filterParams,
-            { kind: 'flag', name: 'limit', type: 'int', required: false, default: 20, constraint: 'Page size. Default 20, hard max 100.' },
-            { kind: 'flag', name: 'cursor', type: 'string', required: false, constraint: 'Opaque token from a prior next_cursor; omit on the first call.' },
-        ],
-        output: [
-            { name: 'hits', type: 'object[]', required: true, constraint: '{ref, node, ts, line, text} per matching body line, sorted by ref then line. ref is the <node-id>:<relpath> handle passed verbatim to `canvas history read`.' },
-            { name: 'next_cursor', type: 'string|null', required: true, constraint: 'Token for the next page; null is the only end-of-list signal.' },
-            { name: 'total', type: 'int', required: true, constraint: 'Total matching lines (exact).' },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'Concrete next commands.' },
-        ],
-        outputKind: 'object',
-        effects: ['None. Read-only.'],
-    },
-    run: async (input) => {
-        const pattern = (input['pattern'] ?? '').trim();
-        const limit = Math.min(100, Math.max(1, input['limit'] ?? 20));
-        const cursor = input['cursor'];
-        if (pattern === '')
-            throw usage('pattern is required — the regex to match against body lines.');
-        try {
-            const validate = new RegExp(pattern);
-            void validate;
-        }
-        catch {
-            throw usage(`invalid regex pattern: ${pattern}`);
-        }
-        // Filter flag validation stays client-side (pure); the corpus scan +
-        // regex match + pagination run server-side in crtrd (`POST
-        // /v1/canvas/history/grep`) — buildCorpus reaches canvas.db and loadBody
-        // closures cannot cross the wire.
-        const f = parseFilters(input);
-        const q = { pattern, limit };
-        applyFilters(q, f);
-        if (cursor !== undefined)
-            q.cursor = cursor;
-        try {
-            const res = await cliClient().historyGrep(q);
-            return {
-                hits: res.hits,
-                next_cursor: res.next_cursor,
-                total: res.total,
-                follow_up: 'Read a hit with `crtr canvas history read <ref>`; narrow with `crtr canvas history grep -h`.',
-            };
-        }
-        catch (err) {
-            rethrowAsCliError(err);
-        }
-    },
-    render: (r) => renderGrep(r),
-});
-function renderGrep(r) {
-    const hits = r['hits'];
-    const total = r['total'];
-    const nextCursor = r['next_cursor'];
-    const parts = [];
-    if (hits.length === 0) {
-        parts.push('0 hits.');
-    }
-    else {
-        parts.push(`${hits.length} of ${total} hits:`);
-        const cols = Object.keys(hits[0]);
-        const head = `| ${cols.join(' | ')} |`;
-        const sep = `| ${cols.map(() => '---').join(' | ')} |`;
-        const body = hits
-            .map((h) => `| ${cols.map((c) => String(h[c] ?? '').replace(/\|/g, '\\|').replace(/\n/g, ' ')).join(' | ')} |`)
-            .join('\n');
-        parts.push(`${head}\n${sep}\n${body}`);
-    }
-    parts.push(`- next_cursor: ${nextCursor ?? 'null'}\n- total: ${total}`);
-    parts.push(String(r['follow_up']));
-    return parts.join('\n\n');
-}
+var u=Object.defineProperty;var s=(e,t)=>u(e,"name",{value:t,configurable:!0});import{defineLeaf as f}from"../../core/command.js";import{usage as c}from"../../core/errors.js";import{cliClient as m,rethrowAsCliError as g}from"../api-client.js";import{applyFilters as y,filterParams as x,parseFilters as w}from"./shared.js";const j=f({name:"grep",description:"exact regex line search across the cwd's node history",whenToUse:"you know the exact string or pattern you're looking for \u2014 an error message, a literal identifier, a code fragment \u2014 and want every matching body LINE across every node that ran in this cwd, not a relevance ranking. The pattern is required (an ECMAScript regex, case-insensitive). Narrow with --type/--kind/--status/--since, scope elsewhere with --cwd/--all-cwds/--under/--node. Want ranked/browse search instead? Use `canvas history search` \u2014 a distinct leaf, not a flag here. Use `canvas history read <ref>` to read a hit's full body, `node inspect artifacts <node-id>` to list one node's artifacts, and `node lifecycle revive <id>` to reopen a node you found.",help:{name:"canvas history grep",summary:"required-pattern regex line search over the per-cwd episodic record (reports + context docs + meta; transcripts and inbox opt-in)",params:[{kind:"positional",name:"pattern",required:!0,constraint:"An ECMAScript regex, matched case-insensitively against each body line. One hit per matching line."},...x,{kind:"flag",name:"limit",type:"int",required:!1,default:20,constraint:"Page size. Default 20, hard max 100."},{kind:"flag",name:"cursor",type:"string",required:!1,constraint:"Opaque token from a prior next_cursor; omit on the first call."}],output:[{name:"hits",type:"object[]",required:!0,constraint:"{ref, node, ts, line, text} per matching body line, sorted by ref then line. ref is the <node-id>:<relpath> handle passed verbatim to `canvas history read`."},{name:"next_cursor",type:"string|null",required:!0,constraint:"Token for the next page; null is the only end-of-list signal."},{name:"total",type:"int",required:!0,constraint:"Total matching lines (exact)."},{name:"follow_up",type:"string",required:!0,constraint:"Concrete next commands."}],outputKind:"object",effects:["None. Read-only."]},run:s(async e=>{const t=(e.pattern??"").trim(),o=Math.min(100,Math.max(1,e.limit??20)),i=e.cursor;if(t==="")throw c("pattern is required \u2014 the regex to match against body lines.");try{const r=new RegExp(t)}catch{throw c(`invalid regex pattern: ${t}`)}const n=w(e),a={pattern:t,limit:o};y(a,n),i!==void 0&&(a.cursor=i);try{const r=await m().historyGrep(a);return{hits:r.hits,next_cursor:r.next_cursor,total:r.total,follow_up:"Read a hit with `crtr canvas history read <ref>`; narrow with `crtr canvas history grep -h`."}}catch(r){g(r)}},"run"),render:s(e=>v(e),"render")});function v(e){const t=e.hits,o=e.total,i=e.next_cursor,n=[];if(t.length===0)n.push("0 hits.");else{n.push(`${t.length} of ${o} hits:`);const a=Object.keys(t[0]),r=`| ${a.join(" | ")} |`,l=`| ${a.map(()=>"---").join(" | ")} |`,d=t.map(h=>`| ${a.map(p=>String(h[p]??"").replace(/\|/g,"\\|").replace(/\n/g," ")).join(" | ")} |`).join(`
+`);n.push(`${r}
+${l}
+${d}`)}return n.push(`- next_cursor: ${i??"null"}
+- total: ${o}`),n.push(String(e.follow_up)),n.join(`
+
+`)}s(v,"renderGrep");export{j as grepLeaf};

package/dist/commands/canvas-history/read.js

@@ -1,50 +1,3 @@
-import { defineLeaf } from '../../core/command.js';
-import { usage } from '../../core/errors.js';
-import { cliClient, rethrowAsCliError } from '../api-client.js';
-export const readLeaf = defineLeaf({
-    name: 'read',
-    description: 'read one search hit\'s full body by its ref',
-    whenToUse: 'you picked a hit from `canvas history search` (or `node inspect artifacts`) and want its full content — pass the `<node-id>:<relpath>` ref verbatim. Strips frontmatter by default; add --frontmatter to keep the YAML header.',
-    help: {
-        name: 'canvas history read',
-        summary: 'resolve a <node-id>:<relpath> ref to its full artifact body',
-        params: [
-            { kind: 'positional', name: 'ref', required: true, constraint: 'The <node-id>:<relpath> handle from `canvas history search` (e.g. mq186ky0-c754531c:reports/20260607T075536-final.md, or <node-id>:meta for a node\'s identity). <node-id>:session addresses a node\'s whole conversation; <node-id>:session/<index> one message in it.' },
-            { kind: 'flag', name: 'frontmatter', type: 'bool', required: false, constraint: 'Include the artifact\'s YAML frontmatter. Stripped by default.' },
-            { kind: 'flag', name: 'format', type: 'enum', choices: ['rendered', 'raw'], required: false, default: 'rendered', constraint: 'raw returns the verbatim bytes behind the ref — the session .jsonl for a bare session ref, the single persisted jsonl entry for one message, the unparsed file for a report or doc. Use it when the rendered view may be hiding what you are chasing.' },
-        ],
-        output: [
-            { name: 'ref', type: 'string', required: true, constraint: 'Echo of the resolved ref.' },
-            { name: 'node', type: 'string', required: true, constraint: 'Node name + id.' },
-            { name: 'source', type: 'string', required: true, constraint: 'report | doc | roadmap | meta | inbox | transcript (+ report-kind for reports).' },
-            { name: 'ts', type: 'string', required: true, constraint: 'Artifact timestamp.' },
-            { name: 'content', type: 'string', required: true, constraint: 'Full body. Frontmatter stripped unless --frontmatter.' },
-        ],
-        outputKind: 'object',
-        effects: ['None. Read-only.'],
-    },
-    run: async (input) => {
-        const ref = input['ref'].trim();
-        const includeFrontmatter = input['frontmatter'] === true;
-        const format = input['format'] ?? 'rendered';
-        // Fast local shape check; ref resolution (+ its usage/not-found errors) runs
-        // server-side in crtrd (`GET /v1/canvas/history/read`).
-        if (!ref.includes(':')) {
-            throw usage(`ref must be <node-id>:<relpath>; received: ${ref}`, {
-                received: ref,
-                next: 'Get a valid ref from `crtr canvas history search` or `crtr node inspect artifacts <node-id>`.',
-            });
-        }
-        try {
-            const res = await cliClient().historyRead({ ref, frontmatter: includeFrontmatter, format });
-            return { ref: res.ref, node: res.node, source: res.source, ts: res.ts, content: res.content };
-        }
-        catch (err) {
-            rethrowAsCliError(err);
-        }
-    },
-    render: (r) => {
-        const head = `${r['node']}  |  source: ${r['source']}  |  ts: ${r['ts']}  |  ref: ${r['ref']}`;
-        return `${head}\n\n${String(r['content']).trim()}`;
-    },
-});
+var s=Object.defineProperty;var n=(e,r)=>s(e,"name",{value:r,configurable:!0});import{defineLeaf as i}from"../../core/command.js";import{usage as d}from"../../core/errors.js";import{cliClient as c,rethrowAsCliError as f}from"../api-client.js";const p=i({name:"read",description:"read one search hit's full body by its ref",whenToUse:"you picked a hit from `canvas history search` (or `node inspect artifacts`) and want its full content \u2014 pass the `<node-id>:<relpath>` ref verbatim. Strips frontmatter by default; add --frontmatter to keep the YAML header.",help:{name:"canvas history read",summary:"resolve a <node-id>:<relpath> ref to its full artifact body",params:[{kind:"positional",name:"ref",required:!0,constraint:"The <node-id>:<relpath> handle from `canvas history search` (e.g. mq186ky0-c754531c:reports/20260607T075536-final.md, or <node-id>:meta for a node's identity). <node-id>:session addresses a node's whole conversation; <node-id>:session/<index> one message in it."},{kind:"flag",name:"frontmatter",type:"bool",required:!1,constraint:"Include the artifact's YAML frontmatter. Stripped by default."},{kind:"flag",name:"format",type:"enum",choices:["rendered","raw"],required:!1,default:"rendered",constraint:"raw returns the verbatim bytes behind the ref \u2014 the session .jsonl for a bare session ref, the single persisted jsonl entry for one message, the unparsed file for a report or doc. Use it when the rendered view may be hiding what you are chasing."}],output:[{name:"ref",type:"string",required:!0,constraint:"Echo of the resolved ref."},{name:"node",type:"string",required:!0,constraint:"Node name + id."},{name:"source",type:"string",required:!0,constraint:"report | doc | roadmap | meta | inbox | transcript (+ report-kind for reports)."},{name:"ts",type:"string",required:!0,constraint:"Artifact timestamp."},{name:"content",type:"string",required:!0,constraint:"Full body. Frontmatter stripped unless --frontmatter."}],outputKind:"object",effects:["None. Read-only."]},run:n(async e=>{const r=e.ref.trim(),o=e.frontmatter===!0,a=e.format??"rendered";if(!r.includes(":"))throw d(`ref must be <node-id>:<relpath>; received: ${r}`,{received:r,next:"Get a valid ref from `crtr canvas history search` or `crtr node inspect artifacts <node-id>`."});try{const t=await c().historyRead({ref:r,frontmatter:o,format:a});return{ref:t.ref,node:t.node,source:t.source,ts:t.ts,content:t.content}}catch(t){f(t)}},"run"),render:n(e=>`${`${e.node}  |  source: ${e.source}  |  ts: ${e.ts}  |  ref: ${e.ref}`}
+
+${String(e.content).trim()}`,"render")});export{p as readLeaf};

package/dist/commands/canvas-history/search.js

@@ -1,99 +1,10 @@
-import { defineLeaf } from '../../core/command.js';
-import { cliClient, rethrowAsCliError } from '../api-client.js';
-import { applyFilters, filterParams, parseFilters } from './shared.js';
-const SORTS = ['relevance', 'recency', 'oldest'];
-export const searchLeaf = defineLeaf({
-    name: 'search',
-    description: 'ranked content search across the cwd\'s node history',
-    whenToUse: 'you want to find past work by what it SAYS — a design, a final report, a roadmap, a finding — across every node that ran in this cwd, ranked by relevance. Omit the query to browse the record by recency ("what happened here lately"). Narrow with --type/--kind/--status/--since, scope elsewhere with --cwd/--all-cwds/--under/--node. Need an exact regex over bodies instead of ranking? Use `canvas history grep` — a distinct leaf, not a flag here. Use `canvas history read <ref>` to read a hit in full, `node inspect artifacts <node-id>` to list one node\'s artifacts, and `node lifecycle revive <id>` to reopen a node you found.',
-    help: {
-        name: 'canvas history search',
-        summary: 'ranked/filtered/sorted content search over the per-cwd episodic record (reports + context docs + meta; transcripts and inbox opt-in)',
-        params: [
-            { kind: 'positional', name: 'query', required: false, constraint: 'Whitespace-separated terms, matched case-insensitively and weighted across node name/description, report titles, and doc headings (and full bodies with --body); artifacts matching more/stronger fields rank higher. Omit to browse by recency (no relevance ranking; --sort still applies).' },
-            ...filterParams,
-            { kind: 'flag', name: 'body', type: 'bool', required: false, constraint: 'Also weigh full body text in the ranking (default weighs name/title/heading only).' },
-            { kind: 'flag', name: 'sort', type: 'enum', choices: SORTS, required: false, constraint: 'relevance (default with a query) ranks by score; recency (default without a query) / oldest order by artifact timestamp.' },
-            { kind: 'flag', name: 'snippet-lines', type: 'int', required: false, default: 1, constraint: 'Context lines per hit. Default 1.' },
-            { kind: 'flag', name: 'full', type: 'bool', required: false, constraint: 'Inline each hit\'s full body. Off by default; pair with a small --limit.' },
-            { kind: 'flag', name: 'limit', type: 'int', required: false, default: 20, constraint: 'Page size. Default 20, hard max 100.' },
-            { kind: 'flag', name: 'cursor', type: 'string', required: false, constraint: 'Opaque token from a prior next_cursor; omit on the first call.' },
-        ],
-        output: [
-            { name: 'hits', type: 'object[]', required: true, constraint: 'Ranked/sorted hits, each: {ref, node, kind, source, ts, score?, snippet}. ref is the <node-id>:<relpath> handle passed verbatim to `canvas history read`.' },
-            { name: 'next_cursor', type: 'string|null', required: true, constraint: 'Token for the next page; null is the only end-of-list signal.' },
-            { name: 'total', type: 'int', required: true, constraint: 'Total matching artifacts (exact).' },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'Concrete next commands.' },
-        ],
-        outputKind: 'object',
-        effects: ['None. Read-only.'],
-    },
-    run: async (input) => {
-        const query = (input['query'] ?? '').trim();
-        const weighBody = input['body'] === true;
-        const full = input['full'] === true;
-        const snippetLines = Math.max(1, input['snippetLines'] ?? 1);
-        const limit = Math.min(100, Math.max(1, input['limit'] ?? 20));
-        const cursor = input['cursor'];
-        // Filter flag validation stays client-side (pure); the corpus scan +
-        // ranking + pagination run server-side in crtrd (`POST
-        // /v1/canvas/history/search`) — buildCorpus reaches canvas.db and
-        // loadBody closures cannot cross the wire.
-        const f = parseFilters(input);
-        const terms = query.toLowerCase().split(/\s+/).filter((t) => t.length > 0);
-        const sortMode = input['sort'] ?? (terms.length > 0 ? 'relevance' : 'recency');
-        const q = { snippet_lines: snippetLines, limit, sort: sortMode };
-        if (query !== '')
-            q.query = query;
-        applyFilters(q, f);
-        if (weighBody)
-            q.weigh_body = true;
-        if (full)
-            q.full = true;
-        if (cursor !== undefined)
-            q.cursor = cursor;
-        try {
-            const res = await cliClient().historySearch(q);
-            return {
-                hits: res.hits,
-                next_cursor: res.next_cursor,
-                total: res.total,
-                follow_up: 'Read a hit with `crtr canvas history read <ref>`; narrow with `crtr canvas history search -h`.',
-            };
-        }
-        catch (err) {
-            rethrowAsCliError(err);
-        }
-    },
-    render: (r) => renderSearch(r),
-});
-function renderSearch(r) {
-    const hits = r['hits'];
-    const total = r['total'];
-    const nextCursor = r['next_cursor'];
-    const full = hits.length > 0 && Object.prototype.hasOwnProperty.call(hits[0], 'body');
-    const parts = [];
-    if (hits.length === 0) {
-        parts.push('0 hits.');
-    }
-    else if (full) {
-        parts.push(`${hits.length} of ${total} hits:`);
-        for (const h of hits) {
-            const head = `### ${h['ref']}\n- node: ${h['node']}  |  kind: ${h['kind']}  |  source: ${h['source']}  |  ts: ${h['ts']}`;
-            parts.push(`${head}\n\n${String(h['body'] ?? '').trim()}`);
-        }
-    }
-    else {
-        parts.push(`${hits.length} of ${total} hits:`);
-        const cols = Object.keys(hits[0]).filter((c) => c !== 'body');
-        const head = `| ${cols.join(' | ')} |`;
-        const sep = `| ${cols.map(() => '---').join(' | ')} |`;
-        const body = hits
-            .map((h) => `| ${cols.map((c) => String(h[c] ?? '').replace(/\|/g, '\\|').replace(/\n/g, ' ')).join(' | ')} |`)
-            .join('\n');
-        parts.push(`${head}\n${sep}\n${body}`);
-    }
-    parts.push(`- next_cursor: ${nextCursor ?? 'null'}\n- total: ${total}`);
-    parts.push(String(r['follow_up']));
-    return parts.join('\n\n');
-}
+var u=Object.defineProperty;var c=(e,t)=>u(e,"name",{value:t,configurable:!0});import{defineLeaf as p}from"../../core/command.js";import{cliClient as y,rethrowAsCliError as m}from"../api-client.js";import{applyFilters as g,filterParams as w,parseFilters as b}from"./shared.js";const k=["relevance","recency","oldest"],j=p({name:"search",description:"ranked content search across the cwd's node history",whenToUse:'you want to find past work by what it SAYS \u2014 a design, a final report, a roadmap, a finding \u2014 across every node that ran in this cwd, ranked by relevance. Omit the query to browse the record by recency ("what happened here lately"). Narrow with --type/--kind/--status/--since, scope elsewhere with --cwd/--all-cwds/--under/--node. Need an exact regex over bodies instead of ranking? Use `canvas history grep` \u2014 a distinct leaf, not a flag here. Use `canvas history read <ref>` to read a hit in full, `node inspect artifacts <node-id>` to list one node\'s artifacts, and `node lifecycle revive <id>` to reopen a node you found.',help:{name:"canvas history search",summary:"ranked/filtered/sorted content search over the per-cwd episodic record (reports + context docs + meta; transcripts and inbox opt-in)",params:[{kind:"positional",name:"query",required:!1,constraint:"Whitespace-separated terms, matched case-insensitively and weighted across node name/description, report titles, and doc headings (and full bodies with --body); artifacts matching more/stronger fields rank higher. Omit to browse by recency (no relevance ranking; --sort still applies)."},...w,{kind:"flag",name:"body",type:"bool",required:!1,constraint:"Also weigh full body text in the ranking (default weighs name/title/heading only)."},{kind:"flag",name:"sort",type:"enum",choices:k,required:!1,constraint:"relevance (default with a query) ranks by score; recency (default without a query) / oldest order by artifact timestamp."},{kind:"flag",name:"snippet-lines",type:"int",required:!1,default:1,constraint:"Context lines per hit. Default 1."},{kind:"flag",name:"full",type:"bool",required:!1,constraint:"Inline each hit's full body. Off by default; pair with a small --limit."},{kind:"flag",name:"limit",type:"int",required:!1,default:20,constraint:"Page size. Default 20, hard max 100."},{kind:"flag",name:"cursor",type:"string",required:!1,constraint:"Opaque token from a prior next_cursor; omit on the first call."}],output:[{name:"hits",type:"object[]",required:!0,constraint:"Ranked/sorted hits, each: {ref, node, kind, source, ts, score?, snippet}. ref is the <node-id>:<relpath> handle passed verbatim to `canvas history read`."},{name:"next_cursor",type:"string|null",required:!0,constraint:"Token for the next page; null is the only end-of-list signal."},{name:"total",type:"int",required:!0,constraint:"Total matching artifacts (exact)."},{name:"follow_up",type:"string",required:!0,constraint:"Concrete next commands."}],outputKind:"object",effects:["None. Read-only."]},run:c(async e=>{const t=(e.query??"").trim(),a=e.body===!0,l=e.full===!0,d=Math.max(1,e.snippetLines??1),n=Math.min(100,Math.max(1,e.limit??20)),r=e.cursor,i=b(e),h=t.toLowerCase().split(/\s+/).filter(o=>o.length>0),f=e.sort??(h.length>0?"relevance":"recency"),s={snippet_lines:d,limit:n,sort:f};t!==""&&(s.query=t),g(s,i),a&&(s.weigh_body=!0),l&&(s.full=!0),r!==void 0&&(s.cursor=r);try{const o=await y().historySearch(s);return{hits:o.hits,next_cursor:o.next_cursor,total:o.total,follow_up:"Read a hit with `crtr canvas history read <ref>`; narrow with `crtr canvas history search -h`."}}catch(o){m(o)}},"run"),render:c(e=>q(e),"render")});function q(e){const t=e.hits,a=e.total,l=e.next_cursor,d=t.length>0&&Object.prototype.hasOwnProperty.call(t[0],"body"),n=[];if(t.length===0)n.push("0 hits.");else if(d){n.push(`${t.length} of ${a} hits:`);for(const r of t){const i=`### ${r.ref}
+- node: ${r.node}  |  kind: ${r.kind}  |  source: ${r.source}  |  ts: ${r.ts}`;n.push(`${i}
+
+${String(r.body??"").trim()}`)}}else{n.push(`${t.length} of ${a} hits:`);const r=Object.keys(t[0]).filter(s=>s!=="body"),i=`| ${r.join(" | ")} |`,h=`| ${r.map(()=>"---").join(" | ")} |`,f=t.map(s=>`| ${r.map(o=>String(s[o]??"").replace(/\|/g,"\\|").replace(/\n/g," ")).join(" | ")} |`).join(`
+`);n.push(`${i}
+${h}
+${f}`)}return n.push(`- next_cursor: ${l??"null"}
+- total: ${a}`),n.push(String(e.follow_up)),n.join(`
+
+`)}c(q,"renderSearch");export{j as searchLeaf};