@north-light/cli 0.0.0 → 0.3.413

package/dist/core/keybindings/attach-control.d.ts

@@ -0,0 +1,49 @@
+export declare const ATTACH_CONTROL_BINDINGS: readonly [{
+    readonly menuId: "crtr.tmux.menu.attach.detach";
+    readonly actionId: "crtr.attach.detach";
+}, {
+    readonly menuId: "crtr.tmux.menu.attach.clear-or-detach";
+    readonly actionId: "crtr.attach.clear-or-detach";
+}, {
+    readonly menuId: "crtr.tmux.menu.attach.graph.toggle";
+    readonly actionId: "crtr.attach.graph.toggle";
+}, {
+    readonly menuId: "crtr.tmux.menu.attach.help.toggle";
+    readonly actionId: "crtr.attach.help.toggle";
+}, {
+    readonly menuId: "crtr.tmux.menu.attach.inbox.toggle";
+    readonly actionId: "crtr.attach.inbox.toggle";
+}, {
+    readonly menuId: "crtr.tmux.menu.attach.inbox-strip";
+    readonly actionId: "crtr.attach.inbox-strip";
+}, {
+    readonly menuId: "crtr.tmux.menu.attach.model-ladder.next";
+    readonly actionId: "crtr.attach.model-ladder.next";
+}, {
+    readonly menuId: "crtr.tmux.menu.attach.model-ladder.previous";
+    readonly actionId: "crtr.attach.model-ladder.previous";
+}, {
+    readonly menuId: "crtr.tmux.menu.attach.command.inspect";
+    readonly actionId: "crtr.attach.command.inspect";
+}, {
+    readonly menuId: "crtr.tmux.menu.attach.file-review";
+    readonly actionId: "crtr.attach.file-review";
+}, {
+    readonly menuId: "crtr.tmux.menu.attach.profile-files";
+    readonly actionId: "crtr.attach.profile-files";
+}, {
+    readonly menuId: "crtr.tmux.menu.attach.search";
+    readonly actionId: "crtr.attach.search";
+}, {
+    readonly menuId: "crtr.tmux.menu.attach.whip";
+    readonly actionId: "crtr.attach.whip";
+}];
+export type AttachBindingId = typeof ATTACH_CONTROL_BINDINGS[number]['actionId'];
+export type AttachMenuBindingId = typeof ATTACH_CONTROL_BINDINGS[number]['menuId'];
+export interface ExtractedAttachControlInput {
+    readonly actionId: AttachBindingId;
+    readonly remaining: string;
+}
+export declare function decodeAttachControlInput(data: string): AttachBindingId | undefined;
+export declare function encodeAttachControlInput(actionId: AttachBindingId): string;
+export declare function extractAttachControlInput(data: string): ExtractedAttachControlInput | undefined;

package/dist/core/keybindings/attach-control.js

@@ -0,0 +1 @@
+var u=Object.defineProperty;var c=(t,e)=>u(t,"name",{value:e,configurable:!0});const i=[{menuId:"crtr.tmux.menu.attach.detach",actionId:"crtr.attach.detach"},{menuId:"crtr.tmux.menu.attach.clear-or-detach",actionId:"crtr.attach.clear-or-detach"},{menuId:"crtr.tmux.menu.attach.graph.toggle",actionId:"crtr.attach.graph.toggle"},{menuId:"crtr.tmux.menu.attach.help.toggle",actionId:"crtr.attach.help.toggle"},{menuId:"crtr.tmux.menu.attach.inbox.toggle",actionId:"crtr.attach.inbox.toggle"},{menuId:"crtr.tmux.menu.attach.inbox-strip",actionId:"crtr.attach.inbox-strip"},{menuId:"crtr.tmux.menu.attach.model-ladder.next",actionId:"crtr.attach.model-ladder.next"},{menuId:"crtr.tmux.menu.attach.model-ladder.previous",actionId:"crtr.attach.model-ladder.previous"},{menuId:"crtr.tmux.menu.attach.command.inspect",actionId:"crtr.attach.command.inspect"},{menuId:"crtr.tmux.menu.attach.file-review",actionId:"crtr.attach.file-review"},{menuId:"crtr.tmux.menu.attach.profile-files",actionId:"crtr.attach.profile-files"},{menuId:"crtr.tmux.menu.attach.search",actionId:"crtr.attach.search"},{menuId:"crtr.tmux.menu.attach.whip",actionId:"crtr.attach.whip"}],r="\x1B_crtr;",a="\x1B\\",m=new Set(i.map(({actionId:t})=>t));function l(t){if(!t.startsWith(r)||!t.endsWith(a))return;const e=t.slice(r.length,-a.length);return m.has(e)?e:void 0}c(l,"decodeAttachControlInput");function h(t){return`${r}${t}${a}`}c(h,"encodeAttachControlInput");function x(t){let e;for(const{actionId:d}of i){const o=h(d),n=t.indexOf(o);n>=0&&(e===void 0||n<e.index)&&(e={actionId:d,encoded:o,index:n})}if(e!==void 0)return{actionId:e.actionId,remaining:t.slice(0,e.index)+t.slice(e.index+e.encoded.length)}}c(x,"extractAttachControlInput");export{i as ATTACH_CONTROL_BINDINGS,l as decodeAttachControlInput,h as encodeAttachControlInput,x as extractAttachControlInput};

package/dist/core/keybindings/background-bash.d.ts

@@ -0,0 +1,13 @@
+import type { BindingId } from './catalog.js';
+import type { BindingResolution } from './types.js';
+/** The Alt+C -> b gesture pair for the background-bash tmux menu item, e.g.
+ *  `Alt+C b`. Null when either the menu-open gesture or the background-bash
+ *  selector is disabled (no bindings) — there is no fallback rendering for a
+ *  disabled binding. Bindings default to the user's resolved config; callers
+ *  holding a live snapshot (e.g. the attach viewer) pass it so a `/reload`
+ *  rebind is honored. */
+export declare function backgroundBashShortcut(bindings?: BindingResolution<BindingId>): string | null;
+/** Footer hint for the background-bash gesture: "<shortcut> to background", or
+ *  null when disabled. No CLI fallback — the tmux gesture is the only way to
+ *  invoke this handoff. */
+export declare function backgroundBashHint(bindings?: BindingResolution<BindingId>): string | null;

package/dist/core/keybindings/background-bash.js

@@ -0,0 +1 @@
+var o=Object.defineProperty;var r=(e,t)=>o(e,"name",{value:t,configurable:!0});import{formatGesture as s}from"./match.js";import{resolveUserKeybindings as u}from"./resolve.js";const c="crtr.tmux.menu.open",a="crtr.tmux.menu.background-bash";function l(e){const t=e.split("+"),n=t.at(-1);return t.includes("shift")&&/[a-z]/.test(n)?n.toUpperCase():n==="space"?" ":n}r(l,"selectorLabel");function p(e=u()){const t=e.gestures(c),n=e.gestures(a);return t.length===0||n.length===0?null:`${t.map(s).join(" / ")} ${l(n[0])}`}r(p,"backgroundBashShortcut");function g(e){const t=p(e);return t!==null?`${t} to background`:null}r(g,"backgroundBashHint");export{g as backgroundBashHint,p as backgroundBashShortcut};

package/dist/core/keybindings/catalog.d.ts

@@ -0,0 +1,18 @@
+import type { BindingDefinition, SafetyRequirement } from './types.js';
+import type { AttachBindingId, AttachMenuBindingId } from './attach-control.js';
+type TmuxMenuAction = 'open' | 'attach' | 'show' | 'view-settings' | 'provider-options' | 'fold-tools' | 'metadata' | 'promote' | 'demote-mode' | 'resume' | 'fork' | 'demote' | 'make-resident' | 'detach' | 'close-subtree' | 'background-bash' | 'file-review' | 'pin' | 'reload-viewer' | 'recap' | 'context' | 'context-admin' | 'providers' | 'plugins' | 'analytics' | 'graph' | 'focus-manager' | 'copy-id' | 'issues';
+type TmuxMenuEntryAction = Exclude<TmuxMenuAction, 'open' | 'attach'> | `issue.${'idea' | 'bug'}`;
+type GraphAction = 'down' | 'up' | 'first' | 'last' | 'collapse-or-manager' | 'expand-or-child' | 'focus' | 'revive' | 'focus-manager' | 'close-subtree' | 'dismiss';
+type BrowseAction = 'quit' | 'down' | 'up' | 'first' | 'last' | 'expand-or-child' | 'collapse-or-parent' | 'toggle-fold' | 'tab-next' | 'tab-previous' | `tab.${1 | 2 | 3 | 4 | 5}` | 'close-subtree' | 'confirm-close' | 'sort' | 'scope' | 'profile' | 'residents' | 'preview' | 'report' | 'pin' | 'search' | 'revive-now' | 'focus' | 'focus-background' | 'yank-id';
+type ProfileMenuAction = 'up' | 'down' | 'select' | 'accept-default' | 'abort' | `slot.${1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9}` | 'create' | 'search-existing' | 'use-root' | 'set-default' | 'add-directory' | 'unpin' | 'manage';
+type SetupAction = 'cancel' | 'tab-next' | 'tab-previous' | 'open' | 'list-down' | 'list-up' | 'toggle' | 'details' | 'advance' | 'cell-previous' | 'cell-next';
+type SetupKeybindingAction = 'edit' | 'commit-edit' | 'cancel-edit' | 'unbind' | 'reset-row' | 'reset-all' | 'save' | 'discard' | 'page-up' | 'page-down' | 'filter' | 'filter-delete' | 'filter-clear';
+type SetupModelsAction = 'open' | 'commit' | 'cancel' | 'scope-next';
+export type BindingId = `crtr.tmux.menu.${TmuxMenuAction}` | `crtr.tmux.menu.issue.${'idea' | 'bug'}` | AttachMenuBindingId | `crtr.tmux.menu-global.${TmuxMenuEntryAction}` | `crtr.tmux.node.${'next' | 'previous'}` | 'crtr.tmux.inbox.toggle' | `crtr.attach.scroll.${'up' | 'down' | 'page-up' | 'page-down' | 'live'}` | 'crtr.attach.mouse.toggle' | 'crtr.attach.copy.message' | 'crtr.attach.help.toggle' | `crtr.attach.search.${'next' | 'previous' | 'edit' | 'close'}` | AttachBindingId | `crtr.graph.${GraphAction}` | `crtr.graph.confirm.${'accept' | 'cancel'}` | `crtr.inspector.${'force-quit' | 'down' | 'up' | 'section-next' | 'section-prev' | 'page-down' | 'page-up' | 'toggle-detail' | 'cancel-item' | 'open-log' | 'confirm' | 'dismiss' | 'retarget' | 'refresh' | 'quit'}` | `crtr.browse.${BrowseAction}` | `crtr.browse.search.${'cancel' | 'commit' | 'delete' | 'quit'}` | `crtr.profile.menu.${ProfileMenuAction}` | `crtr.profile.search.${'up' | 'down' | 'pick' | 'back' | 'delete' | 'abort'}` | `crtr.setup.${SetupAction}` | `crtr.setup.confirm.${'accept' | 'back'}` | `crtr.setup.keybindings.${SetupKeybindingAction}` | `crtr.setup.models.${SetupModelsAction}`;
+export declare const BINDING_CATALOG: readonly [BindingDefinition<"crtr.tmux.menu.open">, BindingDefinition<"crtr.tmux.menu.attach">, ...(BindingDefinition<BindingId> | BindingDefinition<"crtr.tmux.node.next"> | BindingDefinition<"crtr.tmux.node.previous"> | BindingDefinition<"crtr.tmux.inbox.toggle"> | BindingDefinition<"crtr.attach.scroll.up"> | BindingDefinition<"crtr.attach.scroll.down"> | BindingDefinition<"crtr.attach.scroll.page-up"> | BindingDefinition<"crtr.attach.scroll.page-down"> | BindingDefinition<"crtr.attach.scroll.live"> | BindingDefinition<"crtr.attach.mouse.toggle"> | BindingDefinition<"crtr.attach.copy.message"> | BindingDefinition<"crtr.attach.search.next"> | BindingDefinition<"crtr.attach.search.previous"> | BindingDefinition<"crtr.attach.search.edit"> | BindingDefinition<"crtr.attach.search.close"> | BindingDefinition<"crtr.graph.down"> | BindingDefinition<"crtr.graph.up"> | BindingDefinition<"crtr.graph.first"> | BindingDefinition<"crtr.graph.last"> | BindingDefinition<"crtr.graph.collapse-or-manager"> | BindingDefinition<"crtr.graph.expand-or-child"> | BindingDefinition<"crtr.graph.focus"> | BindingDefinition<"crtr.graph.revive"> | BindingDefinition<"crtr.graph.focus-manager"> | BindingDefinition<"crtr.graph.close-subtree"> | BindingDefinition<"crtr.graph.dismiss"> | BindingDefinition<"crtr.graph.confirm.accept"> | BindingDefinition<"crtr.graph.confirm.cancel"> | BindingDefinition<"crtr.inspector.force-quit"> | BindingDefinition<"crtr.inspector.down"> | BindingDefinition<"crtr.inspector.up"> | BindingDefinition<"crtr.inspector.section-next"> | BindingDefinition<"crtr.inspector.section-prev"> | BindingDefinition<"crtr.inspector.page-down"> | BindingDefinition<"crtr.inspector.page-up"> | BindingDefinition<"crtr.inspector.toggle-detail"> | BindingDefinition<"crtr.inspector.cancel-item"> | BindingDefinition<"crtr.inspector.open-log"> | BindingDefinition<"crtr.inspector.confirm"> | BindingDefinition<"crtr.inspector.dismiss"> | BindingDefinition<"crtr.inspector.retarget"> | BindingDefinition<"crtr.inspector.refresh"> | BindingDefinition<"crtr.inspector.quit"> | BindingDefinition<"crtr.browse.quit"> | BindingDefinition<"crtr.browse.down"> | BindingDefinition<"crtr.browse.up"> | BindingDefinition<"crtr.browse.first"> | BindingDefinition<"crtr.browse.last"> | BindingDefinition<"crtr.browse.expand-or-child"> | BindingDefinition<"crtr.browse.collapse-or-parent"> | BindingDefinition<"crtr.browse.toggle-fold"> | BindingDefinition<"crtr.browse.tab-next"> | BindingDefinition<"crtr.browse.tab-previous"> | BindingDefinition<"crtr.browse.tab.1" | "crtr.browse.tab.2" | "crtr.browse.tab.3" | "crtr.browse.tab.4" | "crtr.browse.tab.5"> | BindingDefinition<"crtr.browse.close-subtree"> | BindingDefinition<"crtr.browse.confirm-close"> | BindingDefinition<"crtr.browse.sort"> | BindingDefinition<"crtr.browse.scope"> | BindingDefinition<"crtr.browse.profile"> | BindingDefinition<"crtr.browse.residents"> | BindingDefinition<"crtr.browse.preview"> | BindingDefinition<"crtr.browse.report"> | BindingDefinition<"crtr.browse.pin"> | BindingDefinition<"crtr.browse.search"> | BindingDefinition<"crtr.browse.revive-now"> | BindingDefinition<"crtr.browse.focus"> | BindingDefinition<"crtr.browse.focus-background"> | BindingDefinition<"crtr.browse.yank-id"> | BindingDefinition<"crtr.browse.search.cancel"> | BindingDefinition<"crtr.browse.search.commit"> | BindingDefinition<"crtr.browse.search.delete"> | BindingDefinition<"crtr.browse.search.quit"> | BindingDefinition<"crtr.profile.menu.up"> | BindingDefinition<"crtr.profile.menu.down"> | BindingDefinition<"crtr.profile.menu.select"> | BindingDefinition<"crtr.profile.menu.accept-default"> | BindingDefinition<"crtr.profile.menu.abort"> | BindingDefinition<"crtr.profile.menu.slot.1" | "crtr.profile.menu.slot.2" | "crtr.profile.menu.slot.3" | "crtr.profile.menu.slot.4" | "crtr.profile.menu.slot.5" | "crtr.profile.menu.slot.6" | "crtr.profile.menu.slot.7" | "crtr.profile.menu.slot.8" | "crtr.profile.menu.slot.9">)[], BindingDefinition<"crtr.profile.menu.create">, BindingDefinition<"crtr.profile.menu.search-existing">, BindingDefinition<"crtr.profile.menu.use-root">, BindingDefinition<"crtr.profile.menu.set-default">, BindingDefinition<"crtr.profile.menu.add-directory">, BindingDefinition<"crtr.profile.menu.unpin">, BindingDefinition<"crtr.profile.menu.manage">, BindingDefinition<"crtr.profile.search.up">, BindingDefinition<"crtr.profile.search.down">, BindingDefinition<"crtr.profile.search.pick">, BindingDefinition<"crtr.profile.search.back">, BindingDefinition<"crtr.profile.search.delete">, BindingDefinition<"crtr.profile.search.abort">, BindingDefinition<"crtr.setup.cancel">, BindingDefinition<"crtr.setup.tab-next">, BindingDefinition<"crtr.setup.tab-previous">, BindingDefinition<"crtr.setup.open">, BindingDefinition<"crtr.setup.list-down">, BindingDefinition<"crtr.setup.list-up">, BindingDefinition<"crtr.setup.toggle">, BindingDefinition<"crtr.setup.details">, BindingDefinition<"crtr.setup.advance">, BindingDefinition<"crtr.setup.confirm.accept">, BindingDefinition<"crtr.setup.confirm.back">, BindingDefinition<"crtr.setup.keybindings.edit">, BindingDefinition<"crtr.setup.keybindings.commit-edit">, BindingDefinition<"crtr.setup.keybindings.cancel-edit">, BindingDefinition<"crtr.setup.keybindings.unbind">, BindingDefinition<"crtr.setup.keybindings.reset-row">, BindingDefinition<"crtr.setup.keybindings.reset-all">, BindingDefinition<"crtr.setup.keybindings.save">, BindingDefinition<"crtr.setup.keybindings.discard">, BindingDefinition<"crtr.setup.keybindings.page-up">, BindingDefinition<"crtr.setup.keybindings.page-down">, BindingDefinition<"crtr.setup.keybindings.filter">, BindingDefinition<"crtr.setup.keybindings.filter-delete">, BindingDefinition<"crtr.setup.keybindings.filter-clear">, BindingDefinition<"crtr.setup.cell-previous">, BindingDefinition<"crtr.setup.cell-next">, BindingDefinition<"crtr.setup.models.open">, BindingDefinition<"crtr.setup.models.scope-next">, BindingDefinition<"crtr.setup.models.commit">, BindingDefinition<"crtr.setup.models.cancel">];
+export declare const BINDING_IDS: ReadonlySet<string>;
+/** True for an action whose direct gesture is handled inside an attach viewer.
+ *  Tmux menu selectors and root shortcuts are chrome, not pane input. */
+export declare function isAttachPaneBinding(definition: BindingDefinition): boolean;
+export declare const SAFETY_REQUIREMENTS: readonly SafetyRequirement[];
+export {};

package/dist/core/keybindings/catalog.js

@@ -0,0 +1 @@
+var g=Object.defineProperty;var i=(t,n)=>g(t,"name",{value:n,configurable:!0});function f(t,n,s,c,p,l,d,u,m){return Object.freeze({id:t,group:n,name:s,description:c,defaults:Object.freeze([...p]),inputKind:l,contexts:Object.freeze([...d]),...u===void 0?{}:{safety:u},...m===void 0?{}:{pair:Object.freeze({...m})}})}i(f,"binding");const e=f;function r(t,n,s,c,p){const l=`crtr.tmux.menu.${t}`,d=`crtr.tmux.menu-global.${t}`;return[e(l,"Global tmux",n,s,c,"tmux-menu-selector",p,void 0,{field:"menu",pairedId:d}),e(d,"Global tmux",n,s,[],"tmux-global-action",["tmux.root"],void 0,{field:"global",pairedId:l})]}i(r,"menuEntry");function o(t,n,s,c,p,l){return[e(t,"Attach",s,c,p,"tmux-menu-selector",["tmux.menu.attach"],void 0,{field:"menu",pairedId:n}),e(n,"Attach",s,c,l,"host-global",a,void 0,{field:"direct",pairedId:t})]}i(o,"attachEntry");const a=["attach","graph","graph.confirm"],b=["setup.login","setup.list","setup.input","setup.keybindings","setup.keybindings.edit","setup.keybindings.filter","setup.models"],h=["setup.login","setup.list","setup.keybindings","setup.models"],w=Object.freeze([e("crtr.tmux.menu.open","Global tmux","Open crouter menu","Open the crouter action menu.",["alt+c"],"host-global",["tmux.root"]),e("crtr.tmux.menu.attach","Global tmux","Attach actions","Open the attach-viewer action submenu.",["a"],"tmux-menu-selector",["tmux.menu"]),...r("promote","Promote to orchestrator","Promote the focused node to orchestrator \u2014 it holds a roadmap and delegates.",["o"],["tmux.menu"]),...r("demote-mode","Demote to base node","Demote the focused orchestrator back to a base node \u2014 hands-on again in its own window, no roadmap to drive.",["shift+o"],["tmux.menu"]),...r("resume","Find node","Open the canvas navigator and go to the chosen node.",["/"],["tmux.menu"]),...r("fork","Fork node","Fork the focused node into an independent idle root.",["f"],["tmux.menu"]),...r("demote","Demote to terminal","Demote the focused node to terminal \u2014 it keeps running, owes a final up the spine, and reaps when done.",["d"],["tmux.menu"]),...r("make-resident","Make resident","Flip the focused node to resident \u2014 interactable, never forced to submit a final, and wakeable while attached or awaiting something live.",["shift+r"],["tmux.menu"]),...r("detach","Demote and close viewer","Demote the focused node and close its viewer; its broker keeps running off-screen.",["shift+d"],["tmux.menu"]),...r("close-subtree","Close subtree","Close the focused node and its subtree.",["x"],["tmux.menu"]),...r("background-bash","Background running bash","Hand the focused node\u2019s running bash command to its background job system.",["b"],["tmux.menu"]),...r("file-review","Review a file","Open a line-anchored review of a file named in the transcript.",["v"],["tmux.menu"]),...r("pin","Pin conversation","Pin or unpin this conversation in the canvas navigator.",["p"],["tmux.menu"]),...r("show","Inspect node","Open the focused node\u2019s inspection menu.",["i"],["tmux.menu"]),...r("view-settings","Display settings","Open the viewer display-settings menu.",["z"],["tmux.menu"]),...r("fold-tools","Fold finished tool calls","Fold every finished tool call in the transcript to its single call line.",["f"],["tmux.menu.view-settings"]),...r("metadata","Show metadata","Show the focused node\u2019s metadata dossier.",["m"],["tmux.menu.show"]),...r("context","Browse context","Browse the focused node context.",["c"],["tmux.menu.show"]),...r("providers","Open settings","Open the crouter settings panel.",[","],["tmux.menu"]),...r("provider-options","Provider options","Open provider options \u2014 how an authenticated provider serves your turns, including Codex fast mode.",["."],["tmux.menu"]),...r("plugins","Browse plugins","Open the crouter plugin browser.",["l"],["tmux.menu"]),...r("analytics","Analytics","Open the Analytics page: how agents worked in the last 24 hours or 7 days.",["shift+a"],["tmux.menu"]),...r("context-admin","Context surface","Open the context surface: which documents each event delivers, and the surfaces, gates, and caps that decide it.",["shift+c"],["tmux.menu"]),...r("graph","Canvas graph","Open the canvas graph.",["g"],["tmux.menu"]),...r("focus-manager","Go to manager","Focus this node\u2019s manager.",["h"],["tmux.menu"]),...r("copy-id","Copy node id","Copy the focused node id to the system clipboard.",["y"],["tmux.menu"]),...r("reload-viewer","Reload viewer","Respawn this pane\u2019s viewer onto the current runtime generation.",["r"],["tmux.menu"]),...r("recap","Generate recap","Generate the focused node\u2019s Goal and State recap and refresh its generated title.",["s"],["tmux.menu"]),...r("issues","Open create menu","Open the create submenu.",["c"],["tmux.menu"]),...r("issue.idea","Create idea","Create an idea issue.",["i"],["tmux.menu.issue"]),...r("issue.bug","Create bug","Create a bug issue.",["b"],["tmux.menu.issue"]),e("crtr.tmux.node.next","Global tmux","Next node","Focus the next canvas node.",["alt+]"],"host-global",["tmux.root"]),e("crtr.tmux.node.previous","Global tmux","Previous node","Focus the previous canvas node.",["alt+["],"host-global",["tmux.root"]),e("crtr.tmux.inbox.toggle","Global tmux","Toggle inbox","Open or close the human inbox in the focused viewer.",["alt+i"],"host-global",["tmux.root"]),...o("crtr.tmux.menu.attach.detach","crtr.attach.detach","Detach","Detach from the node.",["d"],["ctrl+d"]),...o("crtr.tmux.menu.attach.clear-or-detach","crtr.attach.clear-or-detach","Clear input (cancel agent on repeat)","Clear the input; press again within a second to cancel the running agent turn. Detach lives on its own binding.",["c"],["ctrl+c"]),...o("crtr.tmux.menu.attach.graph.toggle","crtr.attach.graph.toggle","Toggle graph","Open or close the graph overlay.",["g"],["alt+g"]),...o("crtr.tmux.menu.attach.help.toggle","crtr.attach.help.toggle","Help","Open the attach help overlay.",["?"],["alt+shift+k"]),...o("crtr.tmux.menu.attach.inbox.toggle","crtr.attach.inbox.toggle","Toggle inbox","Open or close the human inbox surface in this viewer.",["i"],[]),...o("crtr.tmux.menu.attach.inbox-strip","crtr.attach.inbox-strip","Pending requests","Jump to the pending human-request strip at the top of the pane.",["u"],["alt+u"]),...o("crtr.tmux.menu.attach.model-ladder.next","crtr.attach.model-ladder.next","Next model","Move to the next model ladder rung.",["]"],["alt+m"]),...o("crtr.tmux.menu.attach.model-ladder.previous","crtr.attach.model-ladder.previous","Previous model","Move to the previous model ladder rung.",["["],["alt+shift+m"]),...o("crtr.tmux.menu.attach.command.inspect","crtr.attach.command.inspect","Inspect loaded command","Open the loaded slash command\u2019s expanded prompt.",["h"],["alt+shift+h"]),...o("crtr.tmux.menu.attach.file-review","crtr.attach.file-review","Review a file","Open a line-anchored review of a file named in the transcript.",[],["alt+shift+r"]),...o("crtr.tmux.menu.attach.profile-files","crtr.attach.profile-files","Search profile files","Fuzzy-match path segments across the node family\u2019s working directories, their context directories (files), profile projects and the profile\u2019s own directory; Ctrl+Y copies a selected path.",["f"],["ctrl+f"]),...o("crtr.tmux.menu.attach.search","crtr.attach.search","Search transcript","Search the transcript as it is currently displayed \u2014 folded tool output is not searched until it is unfolded.",["/"],["alt+/"]),...o("crtr.tmux.menu.attach.whip","crtr.attach.whip","Whip agent","Interrupt the agent and send a playful command.",["w"],[]),e("crtr.attach.scroll.up","Attach","Scroll up","Scroll the transcript one line up.",["shift+up"],"terminal",a),e("crtr.attach.scroll.down","Attach","Scroll down","Scroll the transcript one line down.",["shift+down"],"terminal",a),e("crtr.attach.scroll.page-up","Attach","Scroll page up","Scroll the transcript one page up.",["pageup"],"terminal",a),e("crtr.attach.scroll.page-down","Attach","Scroll page down","Scroll the transcript one page down.",["pagedown"],"terminal",a),e("crtr.attach.scroll.live","Attach","Return to live","Return the transcript to the live bottom.",["shift+end"],"terminal",a),e("crtr.attach.mouse.toggle","Attach","Toggle mouse wheel scrolling","Toggle mouse wheel scrolling on or off.",["alt+shift+o"],"terminal",a),e("crtr.attach.copy.message","Attach","Copy visible message","Copy the newest message visible in the transcript viewport.",["alt+shift+y"],"terminal",a),e("crtr.attach.search.next","Attach","Next match","Move to the next transcript search match.",["n"],"terminal",["attach.search"]),e("crtr.attach.search.previous","Attach","Previous match","Move to the previous transcript search match.",["shift+n"],"terminal",["attach.search"]),e("crtr.attach.search.edit","Attach","Edit query","Return to editing the transcript search query.",["/"],"terminal",["attach.search"]),e("crtr.attach.search.close","Attach","Close search","Leave transcript search and clear its highlights.",["escape"],"terminal",["attach.search"],"dismiss-modal"),e("crtr.graph.down","GRAPH","Move down","Move to the next graph row.",["j","down"],"terminal",["graph"]),e("crtr.graph.up","GRAPH","Move up","Move to the previous graph row.",["k","up"],"terminal",["graph"]),e("crtr.graph.first","GRAPH","First row","Move to the first graph row.",["g"],"terminal",["graph"]),e("crtr.graph.last","GRAPH","Last row","Move to the last graph row.",["shift+g"],"terminal",["graph"]),e("crtr.graph.collapse-or-manager","GRAPH","Collapse or manager","Collapse a node or move to its manager.",["h","left"],"terminal",["graph"]),e("crtr.graph.expand-or-child","GRAPH","Expand or child","Expand a node or move to its child.",["l","right"],"terminal",["graph"]),e("crtr.graph.focus","GRAPH","Focus node","Focus the selected node.",["enter"],"terminal",["graph"]),e("crtr.graph.revive","GRAPH","Revive node","Revive and open the selected dormant node.",["r"],"terminal",["graph"]),e("crtr.graph.focus-manager","GRAPH","Focus manager","Focus the selected node manager.",["m"],"terminal",["graph"]),e("crtr.graph.close-subtree","GRAPH","Close subtree","Ask to close the selected subtree.",["x"],"terminal",["graph"]),e("crtr.graph.dismiss","GRAPH","Dismiss graph","Close the graph overlay.",["escape"],"terminal",["graph"],"dismiss-modal"),e("crtr.graph.confirm.accept","GRAPH","Confirm close","Confirm closing the selected subtree.",["y"],"terminal",["graph.confirm"]),e("crtr.graph.confirm.cancel","GRAPH","Cancel close","Cancel closing the selected subtree.",["n","escape"],"terminal",["graph.confirm"],"dismiss-modal"),e("crtr.inspector.force-quit","Inspector","Force quit Inspector","Immediately leave the Inspector.",["ctrl+c"],"host-global",["inspector"],"leave-screen"),e("crtr.inspector.down","Inspector","Move down","Move the Inspector selection or scroll cursor down.",["j","down"],"terminal",["inspector"]),e("crtr.inspector.up","Inspector","Move up","Move the Inspector selection or scroll cursor up.",["k","up"],"terminal",["inspector"]),e("crtr.inspector.section-next","Inspector","Next section","Move to the next Inspector section.",["tab"],"terminal",["inspector"]),e("crtr.inspector.section-prev","Inspector","Previous section","Move to the previous Inspector section.",["shift+tab"],"terminal",["inspector"]),e("crtr.inspector.page-down","Inspector","Page down","Scroll the Inspector detail body down.",["ctrl+d","pagedown"],"terminal",["inspector"]),e("crtr.inspector.page-up","Inspector","Page up","Scroll the Inspector detail body up.",["ctrl+u","pageup"],"terminal",["inspector"]),e("crtr.inspector.toggle-detail","Inspector","Toggle item detail","Expand or collapse the selected cron or background job.",["enter"],"terminal",["inspector"]),e("crtr.inspector.cancel-item","Inspector","Cancel selected item","Arm cancellation for the selected cron, or stopping for the selected background job.",["x"],"terminal",["inspector"]),e("crtr.inspector.open-log","Inspector","Open job log","Follow the selected background job\u2019s log in a new tmux window.",["o"],"terminal",["inspector"]),e("crtr.inspector.confirm","Inspector","Confirm action","Confirm the armed Inspector action.",["y"],"terminal",["inspector"]),e("crtr.inspector.dismiss","Inspector","Dismiss action","Dismiss an Inspector confirmation or banner.",["escape"],"terminal",["inspector"],"dismiss-modal"),e("crtr.inspector.retarget","Inspector","Retarget","Inspect the selected cron anchor or creator node.",["t"],"terminal",["inspector"]),e("crtr.inspector.refresh","Inspector","Refresh","Refresh the Inspector now.",["g","r"],"terminal",["inspector"]),e("crtr.inspector.quit","Inspector","Quit","Leave the Inspector.",["q"],"terminal",["inspector"],"leave-screen"),...v(),...x(),...k()]);function v(){const t="browse";return[e("crtr.browse.quit","Browse and pickers","Quit browse","Leave canvas browse.",["q","escape","ctrl+c"],"terminal",[t],"leave-screen"),e("crtr.browse.down","Browse and pickers","Move down","Move to the next row.",["j","down"],"terminal",[t]),e("crtr.browse.up","Browse and pickers","Move up","Move to the previous row.",["k","up"],"terminal",[t]),e("crtr.browse.first","Browse and pickers","First row","Move to the first row.",["g"],"terminal",[t]),e("crtr.browse.last","Browse and pickers","Last row","Move to the last row.",["shift+g"],"terminal",[t]),e("crtr.browse.expand-or-child","Browse and pickers","Expand or child","Expand a row or move to its child.",["l","right"],"terminal",[t]),e("crtr.browse.collapse-or-parent","Browse and pickers","Collapse or parent","Collapse a row or move to its parent.",["h","left"],"terminal",[t]),e("crtr.browse.toggle-fold","Browse and pickers","Toggle fold","Toggle the selected fold.",["space"],"terminal",[t]),e("crtr.browse.tab-next","Browse and pickers","Next tab","Select the next browse tab.",["tab","]"],"terminal",[t]),e("crtr.browse.tab-previous","Browse and pickers","Previous tab","Select the previous browse tab.",["shift+tab","["],"terminal",[t]),...[1,2,3,4,5].map(n=>e(`crtr.browse.tab.${n}`,"Browse and pickers",`Tab ${n}`,`Select browse tab ${n}.`,[`${n}`],"terminal",[t])),e("crtr.browse.close-subtree","Browse and pickers","Close subtree","Ask to close the selected subtree.",["x"],"terminal",[t]),e("crtr.browse.confirm-close","Browse and pickers","Confirm close","Confirm closing the selected subtree.",["y"],"terminal",["browse.confirm"]),e("crtr.browse.sort","Browse and pickers","Change sort","Change the browse sort.",["s"],"terminal",[t]),e("crtr.browse.scope","Browse and pickers","Change scope","Toggle the browse cwd scope.",["c"],"terminal",[t]),e("crtr.browse.profile","Browse and pickers","Toggle profile","Toggle the browse profile scope.",["shift+p"],"terminal",[t]),e("crtr.browse.residents","Browse and pickers","Toggle residents","Toggle resident display.",["r"],"terminal",[t]),e("crtr.browse.preview","Browse and pickers","Toggle preview","Toggle the preview panel.",["v"],"terminal",[t]),e("crtr.browse.report","Browse and pickers","Toggle report","Swap the preview panel between the conversation and the node's newest report.",["shift+v"],"terminal",[t]),e("crtr.browse.pin","Browse and pickers","Pin node","Star or unstar the selected node.",["p"],"terminal",[t]),e("crtr.browse.search","Browse and pickers","Search","Open browse search.",["/"],"terminal",[t]),e("crtr.browse.revive-now","Browse and pickers","Revive now","Revive the selected node now.",["shift+k"],"terminal",[t]),e("crtr.browse.focus","Browse and pickers","Focus node","Focus the selected node.",["enter","o"],"terminal",[t]),e("crtr.browse.focus-background","Browse and pickers","Focus node (keep browsing)","Focus the selected node without leaving the navigator.",["shift+o"],"terminal",[t]),e("crtr.browse.yank-id","Browse and pickers","Yank node id","Copy the selected node id to the system clipboard.",["y"],"terminal",[t]),e("crtr.browse.search.cancel","Browse and pickers","Cancel search","Cancel browse search.",["escape"],"terminal",["browse.search"],"dismiss-modal"),e("crtr.browse.search.commit","Browse and pickers","Commit search","Apply browse search.",["enter"],"terminal",["browse.search"]),e("crtr.browse.search.delete","Browse and pickers","Delete search text","Delete the previous search character.",["backspace"],"terminal",["browse.search"]),e("crtr.browse.search.quit","Browse and pickers","Quit browse","Leave canvas browse from search.",["ctrl+c"],"terminal",["browse.search"],"leave-screen")]}i(v,"browseBindings");function x(){const t="profile.menu",n="profile.search";return[e("crtr.profile.menu.up","Profiles","Move up","Move to the previous profile.",["k","up"],"terminal",[t]),e("crtr.profile.menu.down","Profiles","Move down","Move to the next profile.",["j","down"],"terminal",[t]),e("crtr.profile.menu.select","Profiles","Select profile","Select the highlighted profile.",["enter"],"terminal",[t]),e("crtr.profile.menu.accept-default","Profiles","Accept default","Accept the default profile.",["escape"],"terminal",[t],"leave-screen"),e("crtr.profile.menu.abort","Profiles","Abort","Leave profile selection.",["ctrl+c"],"terminal",[t],"leave-screen"),...[1,2,3,4,5,6,7,8,9].map(s=>e(`crtr.profile.menu.slot.${s}`,"Profiles",`Profile slot ${s}`,`Select profile slot ${s}.`,[`${s}`],"terminal",[t])),e("crtr.profile.menu.create","Profiles","Create profile","Create a profile.",["c"],"terminal",[t]),e("crtr.profile.menu.search-existing","Profiles","Search profiles","Search existing profiles.",["s"],"terminal",[t]),e("crtr.profile.menu.use-root","Profiles","Use root profile","Use the root profile.",["r"],"terminal",[t]),e("crtr.profile.menu.set-default","Profiles","Set default","Set the selected profile as default.",["d"],"terminal",[t]),e("crtr.profile.menu.add-directory","Profiles","Add directory","Add a directory to the profile.",["a"],"terminal",[t]),e("crtr.profile.menu.unpin","Profiles","Unpin directory","Unpin the selected directory.",["u"],"terminal",[t]),e("crtr.profile.menu.manage","Profiles","Manage profiles","Open the profiles settings page in a popup.",["v"],"terminal",[t]),e("crtr.profile.search.up","Profiles","Move up","Move to the previous search result.",["up","ctrl+p"],"terminal",[n]),e("crtr.profile.search.down","Profiles","Move down","Move to the next search result.",["down","ctrl+n"],"terminal",[n]),e("crtr.profile.search.pick","Profiles","Pick profile","Pick the highlighted profile.",["enter"],"terminal",[n]),e("crtr.profile.search.back","Profiles","Back","Return to profile selection.",["escape"],"terminal",[n],"leave-screen"),e("crtr.profile.search.delete","Profiles","Delete filter text","Delete the previous filter character.",["backspace"],"terminal",[n]),e("crtr.profile.search.abort","Profiles","Abort","Leave profile search.",["ctrl+c"],"terminal",[n],"leave-screen")]}i(x,"profileBindings");function k(){return[e("crtr.setup.cancel","Setup","Cancel setup","Leave the setup wizard.",["q","ctrl+c","ctrl+d"],"terminal",b,"leave-screen"),e("crtr.setup.tab-next","Setup","Next tab","Select the next setup tab.",["tab","right"],"terminal",h),e("crtr.setup.tab-previous","Setup","Previous tab","Select the previous setup tab.",["shift+tab","left"],"terminal",h),e("crtr.setup.open","Setup","Open","Open the selected setup item.",["enter"],"terminal",["setup.login"]),e("crtr.setup.list-down","Setup","Move down","Move to the next setup item.",["j","down"],"terminal",["setup.list","setup.models","setup.models.dimension-picker","setup.models.route-form"]),e("crtr.setup.list-up","Setup","Move up","Move to the previous setup item.",["k","up"],"terminal",["setup.list","setup.models","setup.models.dimension-picker","setup.models.route-form"]),e("crtr.setup.toggle","Setup","Toggle","Toggle the selected setup item.",["space"],"terminal",["setup.list","setup.keybindings"]),e("crtr.setup.details","Setup","Show details","Show details for the selected item.",["?"],"terminal",["setup.list"]),e("crtr.setup.advance","Setup","Advance","Advance the setup flow.",["enter"],"terminal",["setup.list"]),e("crtr.setup.confirm.accept","Setup","Confirm","Accept the setup confirmation.",["y","enter"],"terminal",["setup.confirm","setup.models.confirm"]),e("crtr.setup.confirm.back","Setup","Go back","Cancel the setup confirmation.",["n","escape","q"],"terminal",["setup.confirm","setup.models.confirm"],"dismiss-modal"),e("crtr.setup.keybindings.edit","Setup","Edit binding","Edit the selected binding.",["enter"],"terminal",["setup.keybindings"]),e("crtr.setup.keybindings.commit-edit","Setup","Commit edit","Commit the active binding edit.",["enter"],"terminal",["setup.keybindings.edit"]),e("crtr.setup.keybindings.cancel-edit","Setup","Cancel edit","Cancel the active binding edit.",["escape"],"terminal",["setup.keybindings.edit"],"dismiss-modal"),e("crtr.setup.keybindings.unbind","Setup","Unbind","Disable the selected binding.",["delete"],"terminal",["setup.keybindings"]),e("crtr.setup.keybindings.reset-row","Setup","Reset binding","Reset the selected binding.",["r"],"terminal",["setup.keybindings"]),e("crtr.setup.keybindings.reset-all","Setup","Reset all bindings","Reset all bindings to defaults.",["shift+r"],"terminal",["setup.keybindings"]),e("crtr.setup.keybindings.save","Setup","Save bindings","Save keybinding changes.",["s"],"terminal",["setup.keybindings"],"save-keybindings"),e("crtr.setup.keybindings.discard","Setup","Discard changes","Discard keybinding changes.",["escape"],"terminal",["setup.keybindings"],"leave-screen"),e("crtr.setup.keybindings.page-up","Setup","Page up","Move up one keybinding page.",["pageup"],"terminal",["setup.keybindings","setup.keybindings.edit"]),e("crtr.setup.keybindings.page-down","Setup","Page down","Move down one keybinding page.",["pagedown"],"terminal",["setup.keybindings","setup.keybindings.edit"]),e("crtr.setup.keybindings.filter","Setup","Filter bindings","Open the keybinding filter.",["/"],"terminal",["setup.keybindings"]),e("crtr.setup.keybindings.filter-delete","Setup","Delete filter text","Delete the previous filter character.",["backspace"],"terminal",["setup.keybindings.filter"]),e("crtr.setup.keybindings.filter-clear","Setup","Clear filter","Clear the keybinding filter.",["escape"],"terminal",["setup.keybindings.filter"],"dismiss-modal"),e("crtr.setup.cell-previous","Setup","Previous field","Select the previous field or setup table cell.",["h"],"terminal",["setup.models","setup.keybindings"]),e("crtr.setup.cell-next","Setup","Next field","Select the next field or setup table cell.",["l"],"terminal",["setup.models","setup.keybindings"]),e("crtr.setup.models.open","Setup","Edit model","Edit the selected model cell or route field.",["enter"],"terminal",["setup.models","setup.models.route-form"]),e("crtr.setup.models.scope-next","Setup","Next model config scope","Edit the next applicable user, profile, or project config.",["s"],"terminal",["setup.models"]),e("crtr.setup.models.commit","Setup","Commit pick","Commit the provider, strength, model, or thinking-level pick.",["enter"],"terminal",["setup.models.picker","setup.models.dimension-picker"]),e("crtr.setup.models.cancel","Setup","Cancel pick","Cancel the model picker or route form.",["escape"],"terminal",["setup.models.picker","setup.models.dimension-picker","setup.models.route-form"],"dismiss-modal")]}i(k,"setupBindings");const S=new Set(w.map(t=>t.id));function C(t){return t.contexts.includes("attach")&&(t.inputKind==="terminal"||t.inputKind==="host-global")}i(C,"isAttachPaneBinding");const P=Object.freeze([{context:"graph",capability:"dismiss-modal"},{context:"graph.confirm",capability:"dismiss-modal"},{context:"inspector",capability:"leave-screen"},{context:"inspector",capability:"dismiss-modal"},{context:"attach.search",capability:"dismiss-modal"},{context:"browse",capability:"leave-screen"},{context:"browse.search",capability:"dismiss-modal"},{context:"profile.menu",capability:"leave-screen"},{context:"profile.search",capability:"leave-screen"},{context:"setup.login",capability:"leave-screen"},{context:"setup.list",capability:"leave-screen"},{context:"setup.input",capability:"leave-screen"},{context:"setup.confirm",capability:"dismiss-modal"},{context:"setup.keybindings",capability:"leave-screen"},{context:"setup.keybindings",capability:"save-keybindings"},{context:"setup.keybindings.edit",capability:"dismiss-modal"},{context:"setup.keybindings.filter",capability:"dismiss-modal"},{context:"setup.models",capability:"leave-screen"},{context:"setup.models.picker",capability:"dismiss-modal"},{context:"setup.models.dimension-picker",capability:"dismiss-modal"},{context:"setup.models.route-form",capability:"dismiss-modal"},{context:"setup.models.confirm",capability:"dismiss-modal"}]);export{w as BINDING_CATALOG,S as BINDING_IDS,P as SAFETY_REQUIREMENTS,C as isAttachPaneBinding};

package/dist/core/keybindings/inbox.d.ts

@@ -0,0 +1,18 @@
+import type { BindingId } from './catalog.js';
+import type { BindingResolution } from './types.js';
+/** The single source of truth for how every pending-interaction surface names
+ *  the inbox shortcut. Resolves the live `crtr.tmux.inbox.toggle` gestures and
+ *  returns the formatted label(s) — joined with ' / ' when multiple, matching
+ *  crouter's `formatBinding` convention — or null when the binding is disabled.
+ *  Bindings default to the user's resolved config so a bare call reflects
+ *  current state; callers holding a live snapshot (e.g. the attach viewer) pass
+ *  it so a `/reload` rebind is honored. */
+export declare function inboxShortcut(bindings?: BindingResolution<BindingId>): string | null;
+/** The shortcut belongs to surfaces that actually own the key — the viewer
+ *  footer and the settings surface. Agent-facing command output never names it:
+ *  an agent repeats the gesture back to a human who may be reading on a screen
+ *  where it means nothing.
+ *
+ *  Closed-inbox footer affordance: "<shortcut> inbox", or the CLI fallback
+ *  `crtr human list` when the binding is disabled. */
+export declare function inboxOpenHint(bindings?: BindingResolution<BindingId>): string;

package/dist/core/keybindings/inbox.js

@@ -0,0 +1 @@
+var o=Object.defineProperty;var r=(n,t)=>o(n,"name",{value:t,configurable:!0});import{formatGesture as e}from"./match.js";import{resolveUserKeybindings as i}from"./resolve.js";const s="crtr.tmux.inbox.toggle";function u(n=i()){const t=n.gestures(s);return t.length>0?t.map(e).join(" / "):null}r(u,"inboxShortcut");function x(n){const t=u(n);return t!==null?`${t} inbox`:"crtr human list"}r(x,"inboxOpenHint");export{x as inboxOpenHint,u as inboxShortcut};

package/dist/core/keybindings/index.d.ts

@@ -0,0 +1,8 @@
+export { BINDING_CATALOG, BINDING_IDS, SAFETY_REQUIREMENTS, isAttachPaneBinding, type BindingId, } from './catalog.js';
+export { GestureSyntaxError, KeybindingValidationError, normalizeGesture, normalizeSparseOverrides, normalizeStroke, resolveKeybindings, resolveUserKeybindingSettings, resolveUserKeybindings, splitGestureExpression, type UserKeybindingSettings, } from './resolve.js';
+export { canonicalTerminalStroke, formatBinding, formatGesture, formatMovePair, formatStroke, matchesPiTuiInput, matchesTerminalInput, normalizeShiftedMeta, type PiTuiMatcher, type RawTerminalInput, } from './match.js';
+export { inboxOpenHint, inboxShortcut, } from './inbox.js';
+export { backgroundBashHint, backgroundBashShortcut, } from './background-bash.js';
+export { ATTACH_CONTROL_BINDINGS, decodeAttachControlInput, encodeAttachControlInput, extractAttachControlInput, type AttachBindingId, type AttachMenuBindingId, type ExtractedAttachControlInput, } from './attach-control.js';
+export { KeybindingConcurrentEditError, persistUserKeybindings, type PersistedKeybindings, type PersistKeybindingsOptions, } from './persistence.js';
+export type { BindingDefinition, BindingInputKind, BindingPair, BindingResolution, BindingSafetyCapability, EffectiveBinding, KeybindingDiagnostic, KeybindingDiagnosticCode, SafetyRequirement, SparseKeybindingOverrides, } from './types.js';

package/dist/core/keybindings/index.js

@@ -0,0 +1 @@
+import{BINDING_CATALOG as t,BINDING_IDS as o,SAFETY_REQUIREMENTS as n,isAttachPaneBinding as i}from"./catalog.js";import{GestureSyntaxError as s,KeybindingValidationError as m,normalizeGesture as d,normalizeSparseOverrides as p,normalizeStroke as c,resolveKeybindings as l,resolveUserKeybindingSettings as u,resolveUserKeybindings as I,splitGestureExpression as S}from"./resolve.js";import{canonicalTerminalStroke as x,formatBinding as g,formatGesture as h,formatMovePair as b,formatStroke as A,matchesPiTuiInput as E,matchesTerminalInput as T,normalizeShiftedMeta as G}from"./match.js";import{inboxOpenHint as y,inboxShortcut as B}from"./inbox.js";import{backgroundBashHint as K,backgroundBashShortcut as k}from"./background-bash.js";import{ATTACH_CONTROL_BINDINGS as O,decodeAttachControlInput as _,encodeAttachControlInput as z,extractAttachControlInput as D}from"./attach-control.js";import{KeybindingConcurrentEditError as H,persistUserKeybindings as M}from"./persistence.js";export{O as ATTACH_CONTROL_BINDINGS,t as BINDING_CATALOG,o as BINDING_IDS,s as GestureSyntaxError,H as KeybindingConcurrentEditError,m as KeybindingValidationError,n as SAFETY_REQUIREMENTS,K as backgroundBashHint,k as backgroundBashShortcut,x as canonicalTerminalStroke,_ as decodeAttachControlInput,z as encodeAttachControlInput,D as extractAttachControlInput,g as formatBinding,h as formatGesture,b as formatMovePair,A as formatStroke,y as inboxOpenHint,B as inboxShortcut,i as isAttachPaneBinding,E as matchesPiTuiInput,T as matchesTerminalInput,d as normalizeGesture,G as normalizeShiftedMeta,p as normalizeSparseOverrides,c as normalizeStroke,M as persistUserKeybindings,l as resolveKeybindings,u as resolveUserKeybindingSettings,I as resolveUserKeybindings,S as splitGestureExpression};

package/dist/core/keybindings/match.d.ts

@@ -0,0 +1,44 @@
+import type { BindingId } from './catalog.js';
+import type { BindingResolution } from './types.js';
+export declare function formatStroke(stroke: string): string;
+export declare function formatGesture(gesture: string): string;
+/** A vertical-move pair for a footer, e.g. `↑↓/jk`. Arrows lead whenever both
+ *  bindings carry them, so a hint never reads as vim-only while the arrow keys
+ *  work; a rebound pair falls back to each binding's first gesture. */
+export declare function formatMovePair(bindingSet: BindingResolution<BindingId>, down: BindingId, up: BindingId): string;
+export declare function formatBinding(bindingSet: BindingResolution<BindingId>, id: BindingId): string;
+export interface RawTerminalInput {
+    readonly input?: string;
+    readonly upArrow?: boolean;
+    readonly downArrow?: boolean;
+    readonly leftArrow?: boolean;
+    readonly rightArrow?: boolean;
+    readonly return?: boolean;
+    readonly escape?: boolean;
+    readonly ctrl?: boolean;
+    readonly meta?: boolean;
+    readonly shift?: boolean;
+    readonly tab?: boolean;
+    readonly shiftTab?: boolean;
+    readonly backspace?: boolean;
+    readonly delete?: boolean;
+    readonly pageUp?: boolean;
+    readonly pageDown?: boolean;
+    readonly home?: boolean;
+    readonly end?: boolean;
+}
+export declare function canonicalTerminalStroke(raw: RawTerminalInput): string | null;
+export declare function matchesTerminalInput(bindingSet: BindingResolution<BindingId>, id: BindingId, raw: RawTerminalInput): boolean;
+export type PiTuiMatcher<Input> = (input: Input, gesture: string) => boolean;
+/** Rewrite the two Alt+Shift+<letter> encodings pi-tui does not recognize into
+ * the canonical shift+alt CSI-u sequence it does.
+ *
+ * A terminal that sends Option as a meta prefix emits Alt+Shift+M as the legacy
+ * two-byte `ESC M`, and tmux re-encodes that as CSI-u carrying the UPPERCASE
+ * codepoint with only the alt bit set (`ESC [ 77 ; 3 u`). pi-tui matches
+ * `alt+shift+m` against `ESC [ 109 ; 4 u` / `ESC [ 77 ; 4 u` and rejects both
+ * unshifted forms, so every Alt+Shift chord would be dead on those terminals.
+ * An uppercase letter cannot be typed without Shift, so restoring the bit adds
+ * nothing the keyboard did not already carry. Anything else passes through. */
+export declare function normalizeShiftedMeta(data: string): string;
+export declare function matchesPiTuiInput<Input>(bindingSet: BindingResolution<BindingId>, id: BindingId, input: Input, matchesKey: PiTuiMatcher<Input>): boolean;

package/dist/core/keybindings/match.js

@@ -0,0 +1 @@
+var g=Object.defineProperty;var s=(e,t)=>g(e,"name",{value:t,configurable:!0});import{normalizeStroke as m}from"./resolve.js";const b={enter:"Enter",escape:"Esc",tab:"Tab",backspace:"Backspace",delete:"Delete",space:"Space",up:"Up",down:"Down",left:"Left",right:"Right",pageup:"PageUp",pagedown:"PageDown",home:"Home",end:"End"};function x(e){let t,n;if(e==="+")t="+",n=[];else if(e.endsWith("++"))t="+",n=e.slice(0,-2).split("+");else{const i=e.split("+");t=i.pop(),n=i}const o=n.map(i=>i[0].toUpperCase()+i.slice(1));return o.push(b[t]??(t.length===1&&n.length>0?t.toUpperCase():t)),o.join("+")}s(x,"formatStroke");function a(e){return e.split(" > ").map(x).join(" then ")}s(a,"formatGesture");function U(e,t,n){const o=s(u=>e.gestures(u).filter(l=>!l.includes(" > ")),"single"),i=o(t),r=o(n),h=i.includes("down")&&r.includes("up"),p=s(u=>u.find(l=>l!=="down"&&l!=="up"&&!l.includes("+")&&l.length===1),"letter"),c=p(i),f=p(r);if(h)return c!==void 0&&f!==void 0?`\u2191\u2193/${c}${f}`:"\u2191\u2193";const d=s(u=>{const l=e.gestures(u);return l.length===0?"disabled":a(l[0].split(" > ").pop())},"first");return`${d(t)}/${d(n)}`}s(U,"formatMovePair");function D(e,t){const n=e.gestures(t);return n.length===0?"Disabled":n.map(a).join(" / ")}s(D,"formatBinding");function k(e){let t=null;if(e.upArrow)t="up";else if(e.downArrow)t="down";else if(e.leftArrow)t="left";else if(e.rightArrow)t="right";else if(e.return)t="enter";else if(e.escape)t="escape";else{if(e.shiftTab)return"shift+tab";e.tab?t="tab":e.backspace?t="backspace":e.delete?t="delete":e.pageUp?t="pageup":e.pageDown?t="pagedown":e.home?t="home":e.end?t="end":e.input?.length===1&&(t=e.input===" "?"space":e.input)}if(t===null)return null;const n=[];e.ctrl&&n.push("ctrl"),e.meta&&n.push("alt"),e.shift&&n.push("shift");try{return m([...n,t].join("+"))}catch{return null}}s(k,"canonicalTerminalStroke");function E(e,t,n){const o=k(n);return o!==null&&e.gestures(t).includes(o)}s(E,"matchesTerminalInput");function S(e){if(e.length===2&&e[0]==="\x1B"&&/[A-Z]/.test(e[1]))return`\x1B[${e.charCodeAt(1)};4u`;const t=/^\x1b\[(\d+);3u$/.exec(e);if(t!==null){const n=Number(t[1]);if(n>=65&&n<=90)return`\x1B[${n};4u`}return e}s(S,"normalizeShiftedMeta");function T(e,t,n,o){return e.gestures(t).some(i=>!i.includes(" > ")&&o(n,i))}s(T,"matchesPiTuiInput");export{k as canonicalTerminalStroke,D as formatBinding,a as formatGesture,U as formatMovePair,x as formatStroke,T as matchesPiTuiInput,E as matchesTerminalInput,S as normalizeShiftedMeta};

package/dist/core/keybindings/persistence.d.ts

@@ -0,0 +1,18 @@
+import type { BindingId } from './catalog.js';
+import type { SparseKeybindingOverrides } from './types.js';
+export declare class KeybindingConcurrentEditError extends Error {
+    readonly latestKeybindings: unknown;
+    readonly latestTmuxPassthrough: unknown;
+    constructor(latestKeybindings: unknown, latestTmuxPassthrough: unknown);
+}
+export interface PersistKeybindingsOptions {
+    readonly expectedKeybindings?: unknown;
+    readonly tmuxPassthrough?: unknown;
+    readonly expectedTmuxPassthrough?: unknown;
+}
+export interface PersistedKeybindings {
+    readonly path: string;
+    readonly overrides: SparseKeybindingOverrides<BindingId>;
+    readonly tmuxPassthrough: readonly BindingId[];
+}
+export declare function persistUserKeybindings(prospectiveOverrides: unknown, options?: PersistKeybindingsOptions): PersistedKeybindings;

package/dist/core/keybindings/persistence.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var i=(n,e)=>c(n,"name",{value:e,configurable:!0});import{isDeepStrictEqual as a}from"node:util";import{configPath as m,normalizeTmuxPassthrough as g,updateRawConfigAtomically as x}from"../config.js";import{normalizeSparseOverrides as b}from"./resolve.js";class l extends Error{static{i(this,"KeybindingConcurrentEditError")}latestKeybindings;latestTmuxPassthrough;constructor(e,t){super("keybindings changed on disk; reload before saving"),this.name="KeybindingConcurrentEditError",this.latestKeybindings=e,this.latestTmuxPassthrough=t}}function O(n,e={}){const t=b(n),d=Object.hasOwn(e,"tmuxPassthrough"),u=g(e.tmuxPassthrough);let h=[];const o=m("user");if(o===null)throw new Error("user config path is unavailable");return x("user",r=>{if(Object.hasOwn(e,"expectedKeybindings")&&!a(r.keybindings,e.expectedKeybindings)||Object.hasOwn(e,"expectedTmuxPassthrough")&&!a(r.tmux_passthrough,e.expectedTmuxPassthrough))throw new l(r.keybindings,r.tmux_passthrough);const s={...r};return delete s.canvasNav,Object.keys(t).length===0?delete s.keybindings:s.keybindings=t,d&&(u.length===0?delete s.tmux_passthrough:s.tmux_passthrough=u),h=g(s.tmux_passthrough),s}),Object.freeze({path:o,overrides:Object.freeze({...t}),tmuxPassthrough:Object.freeze([...h])})}i(O,"persistUserKeybindings");export{l as KeybindingConcurrentEditError,O as persistUserKeybindings};

package/dist/core/keybindings/resolve.d.ts

@@ -0,0 +1,28 @@
+import type { BindingId } from './catalog.js';
+import type { BindingDefinition, BindingResolution, KeybindingDiagnostic, SparseKeybindingOverrides } from './types.js';
+export declare class GestureSyntaxError extends Error {
+    constructor(message: string);
+}
+export declare function normalizeStroke(raw: string): string;
+/**
+ * Split a binding expression into its gesture list. A comma separates gestures
+ * only when it stands between two non-empty gestures; a comma with nothing on
+ * one side is the comma KEY itself, so `,` is bindable and `, , c` reads as the
+ * comma key plus `c`. This mirrors the sequence separator `>`, which is only a
+ * separator when surrounded by strokes.
+ */
+export declare function splitGestureExpression(expression: string): string[];
+export declare function normalizeGesture(raw: string, definition?: Pick<BindingDefinition, 'inputKind'>): string;
+export declare function resolveKeybindings(rawOverrides?: unknown): BindingResolution<BindingId>;
+export interface UserKeybindingSettings {
+    readonly bindings: BindingResolution<BindingId>;
+    readonly tmuxPassthrough: readonly BindingId[];
+}
+/** Resolve keybindings and tmux passthrough from one immutable user-config snapshot. */
+export declare function resolveUserKeybindingSettings(): UserKeybindingSettings;
+export declare function resolveUserKeybindings(): BindingResolution<BindingId>;
+export declare function normalizeSparseOverrides(rawOverrides: unknown): SparseKeybindingOverrides<BindingId>;
+export declare class KeybindingValidationError extends Error {
+    readonly diagnostics: readonly KeybindingDiagnostic[];
+    constructor(diagnostics: readonly KeybindingDiagnostic[]);
+}

package/dist/core/keybindings/resolve.js

@@ -0,0 +1 @@
+var E=Object.defineProperty;var a=(n,e)=>E(n,"name",{value:e,configurable:!0});import{isDeepStrictEqual as v}from"node:util";import{BINDING_CATALOG as b,BINDING_IDS as z,SAFETY_REQUIREMENTS as $}from"./catalog.js";import{normalizeTmuxPassthrough as j,readRawScopeConfig as I}from"../config.js";const O=["ctrl","alt","shift"],C=new Set(["ctrl","alt","shift","meta"]),A=new Set(["enter","escape","tab","backspace","delete","space","up","down","left","right","pageup","pagedown","home","end"]),K={return:"enter",esc:"escape"};class l extends Error{static{a(this,"GestureSyntaxError")}constructor(e){super(e),this.name="GestureSyntaxError"}}function q(n){const e=n.match(/^((?:[CMS]-)+)(.+)$/i);return e===null?n:`${e[1].split("-").filter(Boolean).map(t=>t.toUpperCase()==="C"?"ctrl":t.toUpperCase()==="M"?"alt":"shift").join("+")}+${e[2]}`}a(q,"tmuxNotation");function R(n){const e=q(n.trim());if(e==="")throw new l("a stroke cannot be empty");let r,t;if(e==="+")r="+",t=[];else if(e.endsWith("++"))r="+",t=e.slice(0,-2).split("+");else{const o=e.split("+");if(o.some(f=>f===""))throw new l(`invalid stroke "${n}"`);r=o.pop(),t=o}const i=t.map(o=>o.toLowerCase());if(i.some(o=>!C.has(o)))throw new l(`unsupported modifier in "${n}"`);const c=i.map(o=>o==="meta"?"alt":o);if(new Set(c).size!==c.length)throw new l(`duplicate modifier in "${n}"`);let u=K[r.toLowerCase()]??r;if(u.length===1&&u>="A"&&u<="Z"?(u=u.toLowerCase(),c.includes("shift")||c.push("shift")):u.length!==1&&(u=u.toLowerCase()),!(u.length===1&&u.charCodeAt(0)>=32&&u.charCodeAt(0)<=126)&&!A.has(u))throw new l(`unsupported key "${r}"`);return[...O.filter(o=>c.includes(o)),u].join("+")}a(R,"normalizeStroke");function Q(n){const e=[];let r="";for(let t=0;t<n.length;t+=1){const i=n[t];if(i!==","){r+=i;continue}r.trim()!==""&&n.slice(t+1).trim()!==""?(e.push(r),r=""):r+=i}return e.push(r),e}a(Q,"splitGestureExpression");function w(n,e){const r=n.trim().split(/\s+>\s+/);if(r.length>2)throw new l("a gesture may contain at most two strokes");const t=r.map(R);if(t.length===2&&e?.inputKind!=="tmux-sequence")throw new l("two-stroke sequences are supported only by tmux sequence actions");if(e?.inputKind==="tmux-sequence"&&t.length!==2)throw new l("this action requires a two-stroke tmux sequence");if(e?.inputKind==="tmux-menu-selector"){if(t.length!==1)throw new l("a menu selector must be one stroke");const c=t[0].split("+"),u=c.at(-1),s=c.slice(0,-1);if(u.length!==1&&u!=="space"||s.some(o=>o!=="shift"))throw new l("a menu selector must be one printable character")}if(e?.inputKind==="tmux-global-action"){if(t.length!==1)throw new l("a global menu shortcut must be one stroke");const i=t[0].split("+").slice(0,-1);if(!i.includes("ctrl")&&!i.includes("alt"))throw new l("a global menu shortcut must include Ctrl or Alt")}return t.join(" > ")}a(w,"normalizeGesture");function M(n,e){if(!Array.isArray(n))throw new l("the override must be an array of gesture strings");const r=[];for(const t of n){if(typeof t!="string")throw new l("every override entry must be a gesture string");const i=w(t,e);r.includes(i)||r.push(i)}return Object.freeze(r)}a(M,"normalizeList");function N(n,e){return n.contexts.some(r=>e.contexts.includes(r))}a(N,"contextsOverlap");function g(n){return n.contexts.includes("tmux.root")}a(g,"isTmuxRoot");function y(n){return!g(n)&&n.inputKind!=="tmux-menu-selector"&&n.inputKind!=="tmux-sequence"}a(y,"isInPane");function d(n){return n.split(" > ")[0]}a(d,"firstStroke");function _(n,e,r,t){const i=e.includes(" > "),c=t.includes(" > ");if(N(n,r))return i&&c?e===t:i||c?d(e)===d(t):e===t;const u=g(n),s=g(r);return!u&&!s?!1:u&&s&&i&&c?e===t:u&&s?d(e)===d(t):u&&y(r)?d(e)===t:s&&y(n)?e===d(t):!1}a(_,"gesturesConflict");function h(n){return Object.freeze(n.defaults.map(e=>w(e,n)))}a(h,"defaultGestures");class D{static{a(this,"FrozenBindingMap")}#e;constructor(e){this.#e=new Map(e)}get size(){return this.#e.size}get(e){return this.#e.get(e)}has(e){return this.#e.has(e)}entries(){return this.#e.entries()}keys(){return this.#e.keys()}values(){return this.#e.values()}forEach(e,r){for(const[t,i]of this.#e)e.call(r,i,t,this)}[Symbol.iterator](){return this.#e[Symbol.iterator]()}}function p(n,e,r,t,i){return Object.freeze({severity:"error",code:n,message:e,offendingValue:r,...t?{bindingId:t}:{},...i?{relatedBindingIds:Object.freeze([...i])}:{}})}a(p,"diagnostic");function L(n){const e=[];for(let r=0;r<n.length;r+=1){const t=n[r];for(let i=r+1;i<n.length;i+=1){const c=n[i];for(const u of t.gestures){const s=c.gestures.find(o=>_(t.definition,u,c.definition,o));if(s!==void 0){e.push([t,c,u.includes(" > ")?u:s]);break}}}}return e}a(L,"collisionPairs");function U(n,e,r){return n.some(t=>t.definition.safety===r&&t.gestures.length>0&&t.definition.contexts.includes(e))}a(U,"requirementSatisfied");function x(n,e){for(;;){const r=new Set;for(const[t,i,c]of L(n)){if(t.source==="user"&&r.add(t),i.source==="user"&&r.add(i),t.source==="default"&&i.source==="default")throw new Error(`keybinding catalog default collision: ${t.definition.id} / ${i.definition.id} (${c})`);e.push(p("collision",`${t.definition.id} and ${i.definition.id} both claim ${c} in overlapping contexts`,c,t.source==="user"?t.definition.id:i.definition.id,[t.definition.id,i.definition.id]))}if(r.size===0)return;for(const t of r)t.gestures=h(t.definition),t.source="default"}}a(x,"rejectCollidingUserOverrides");function k(n=void 0){const e=[];let r={};n!==void 0&&(n===null||typeof n!="object"||Array.isArray(n)?e.push(p("invalid-keybindings","keybindings must be an object keyed by catalog binding ID",n)):r=n);for(const[s,o]of Object.entries(r))z.has(s)||e.push(p("unknown-binding",`unknown keybinding ID: ${s}`,o,s));const t=b.map(s=>{const o=h(s);if(!Object.hasOwn(r,s.id))return{definition:s,gestures:o,source:"default"};const f=r[s.id];try{return{definition:s,gestures:M(f,s),source:"user",rawOverride:f}}catch(m){const S=m instanceof Error?m.message:String(m);return e.push(p("invalid-override",`${s.id}: ${S}`,f,s.id)),{definition:s,gestures:o,source:"default"}}});x(t,e);for(const s of $){if(U(t,s.context,s.capability))continue;const o=t.filter(f=>f.source==="user"&&f.definition.safety===s.capability&&f.definition.contexts.includes(s.context));e.push(p("unreachable",`${s.context} must retain an enabled ${s.capability} binding`,o.map(f=>f.rawOverride),o[0]?.definition.id,o.map(f=>f.definition.id)));for(const f of o)f.gestures=h(f.definition),f.source="default"}x(t,e);const i=t.map(s=>{const o=Object.freeze({definition:s.definition,gestures:s.gestures,source:s.source});return[s.definition.id,o]}),c=new D(i),u={bindings:c,diagnostics:Object.freeze(e),get(s){const o=c.get(s);if(o===void 0)throw new Error(`unknown crouter keybinding ID: ${s}`);return o},gestures(s){return this.get(s).gestures}};return Object.freeze(u)}a(k,"resolveKeybindings");function P(){const n=I("user");return Object.freeze({bindings:k(n?.keybindings),tmuxPassthrough:Object.freeze(j(n?.tmux_passthrough))})}a(P,"resolveUserKeybindingSettings");function W(){return P().bindings}a(W,"resolveUserKeybindings");function Z(n){const e=k(n);if(e.diagnostics.length>0)throw new T(e.diagnostics);const r={};for(const t of b){const i=e.get(t.id),c=h(t);i.source==="user"&&!v(i.gestures,c)&&(r[t.id]=[...i.gestures])}return r}a(Z,"normalizeSparseOverrides");class T extends Error{static{a(this,"KeybindingValidationError")}diagnostics;constructor(e){super(e[0]?.message??"invalid keybindings"),this.name="KeybindingValidationError",this.diagnostics=e}}export{l as GestureSyntaxError,T as KeybindingValidationError,w as normalizeGesture,Z as normalizeSparseOverrides,R as normalizeStroke,k as resolveKeybindings,P as resolveUserKeybindingSettings,W as resolveUserKeybindings,Q as splitGestureExpression};

package/dist/core/keybindings/types.d.ts

@@ -0,0 +1,42 @@
+export type BindingInputKind = 'terminal' | 'tmux-sequence' | 'tmux-menu-selector' | 'tmux-global-action' | 'host-global';
+export interface BindingPair {
+    readonly field: 'menu' | 'global' | 'direct';
+    readonly pairedId: string;
+}
+export type BindingSafetyCapability = 'dismiss-modal' | 'leave-screen' | 'save-keybindings';
+export interface BindingDefinition<Id extends string = string> {
+    readonly id: Id;
+    readonly group: string;
+    readonly name: string;
+    readonly description: string;
+    readonly defaults: readonly string[];
+    readonly inputKind: BindingInputKind;
+    readonly contexts: readonly string[];
+    readonly safety?: BindingSafetyCapability;
+    readonly pair?: BindingPair;
+}
+export interface EffectiveBinding<Id extends string = string> {
+    readonly definition: BindingDefinition<Id>;
+    readonly gestures: readonly string[];
+    readonly source: 'default' | 'user';
+}
+export type KeybindingDiagnosticCode = 'invalid-keybindings' | 'unknown-binding' | 'invalid-override' | 'collision' | 'unreachable';
+export interface KeybindingDiagnostic {
+    readonly severity: 'error';
+    readonly code: KeybindingDiagnosticCode;
+    readonly bindingId?: string;
+    readonly relatedBindingIds?: readonly string[];
+    readonly offendingValue: unknown;
+    readonly message: string;
+}
+export interface SafetyRequirement {
+    readonly context: string;
+    readonly capability: BindingSafetyCapability;
+}
+export interface BindingResolution<Id extends string = string> {
+    readonly bindings: ReadonlyMap<Id, EffectiveBinding<Id>>;
+    readonly diagnostics: readonly KeybindingDiagnostic[];
+    get(id: Id): EffectiveBinding<Id>;
+    gestures(id: Id): readonly string[];
+}
+export type SparseKeybindingOverrides<Id extends string = string> = Partial<Record<Id, string[]>>;

package/dist/core/layout-migrate/index.d.ts

@@ -0,0 +1,38 @@
+import { OldToNewPathMap } from './paths.js';
+export { OldToNewPathMap, oldToNewPathMap } from './paths.js';
+export interface LayoutMigration {
+    map: OldToNewPathMap;
+    moved: number;
+    /** Exactly the filesystem operations that changed a source path. */
+    changes: string[];
+    /** One line per leftover the migration resolved itself (a dry run lists what it would do). */
+    resolutions: string[];
+    /** Old stored path prefix → new path, rewritten as text in migrated markdown bodies. */
+    bodyPaths: Array<[string, string]>;
+    /** Credential sources that did not exist; legitimate when the old volume never held one. */
+    absentCredentials: string[];
+    dryRun: boolean;
+}
+export declare function isJunkFile(name: string): boolean;
+/** Where a leftover the new layout has no place for is kept: `runtime/set-aside/<kind>/<name>`, never overwriting. */
+export declare function setAsidePath(migration: LayoutMigration, kind: string, name: string): string;
+/** Move a leftover aside (a rename; never a copy). */
+export declare function setAside(from: string, kind: string, migration: LayoutMigration, name?: string): string;
+/**
+ * What to do with a destination that already exists before a move. A file is
+ * renamed atomically, so a file present at both paths was never written by
+ * this migration: an identical copy drops the source, an empty file is
+ * removed, and anything else is kept aside under `runtime/set-aside/replaced/`.
+ */
+export type Claim = {
+    action: 'merge' | 'drop-source' | 'remove-destination' | 'set-aside-destination';
+    line?: string;
+};
+export declare function claim(from: string, to: string, migration: LayoutMigration, wholeDirectory?: boolean): Claim;
+/** Rename within the volume; merge an existing directory on interrupted runs, never overwrite a file. */
+export declare function movePath(from: string, to: string, migration: LayoutMigration, wholeDirectory?: boolean): void;
+/** Dry-run lines for a move: the claims the real run would make, without touching anything. */
+export declare function previewMove(from: string, to: string, migration: LayoutMigration, wholeDirectory?: boolean): void;
+export declare function sameFile(from: string, to: string): boolean;
+export declare function daemonAnswers(socketPath: string): Promise<boolean>;
+export declare function migrateLayout(dryRun: boolean): Promise<LayoutMigration | null>;

package/dist/core/layout-migrate/index.js

@@ -0,0 +1,4 @@
+var X=Object.defineProperty;var l=(t,e)=>X(t,"name",{value:e,configurable:!0});import{DatabaseSync as _}from"node:sqlite";import{randomUUID as N}from"node:crypto";import{symlinkSync as Z,chmodSync as j,chownSync as M,closeSync as $,cpSync as ee,existsSync as d,fsyncSync as R,lchownSync as te,lstatSync as f,mkdirSync as w,openSync as k,readFileSync as y,readlinkSync as D,readSync as U,readdirSync as h,renameSync as b,rmSync as L,rmdirSync as g,unlinkSync as A,writeSync as q}from"node:fs";import{request as ne}from"node:http";import{basename as T,dirname as m,isAbsolute as re,join as c,relative as S,resolve as oe}from"node:path";import{LAYOUT_VERSION as C}from"../layout.js";import{InputError as O}from"../io.js";import{oldToNewPathMap as se}from"./paths.js";import{conversations as ie,memoryAndProfiles as ce,previewStores as ae,profileFolders as ue,repairMovedRepositories as le,worktrees as de}from"./stores.js";import{storedPaths as fe}from"./stored-paths.js";import{OldToNewPathMap as Ce,oldToNewPathMap as Oe}from"./paths.js";const pe=new Set([".DS_Store","Thumbs.db","desktop.ini"]);function he(t){return pe.has(t)||t.startsWith("._")}l(he,"isJunkFile");function F(t,e,n){const o=c(t.map.old.root,"runtime","set-aside",e);let r=c(o,n);for(let i=2;d(r);i++)r=c(o,`${n}.${i}`);return r}l(F,"setAsidePath");function I(t,e,n,o=T(t)){const r=F(n,e,o);return w(m(r),{recursive:!0}),b(t,r),n.moved++,n.changes.push(`${t} -> ${r} (set aside)`),r}l(I,"setAside");function me(t){const e=f(t);return e.isDirectory()?h(t).length===0:e.isFile()&&e.size===0}l(me,"empty");function W(t,e,n,o=!1){const r=f(t),i=f(e);if(r.isDirectory()&&i.isDirectory()&&!o)return{action:"merge"};if(r.isFile()&&i.isFile()&&Q(t,e))return{action:"drop-source"};if(me(e))return{action:"remove-destination",line:`stray-destination: removed empty ${i.isDirectory()?"folder":"file"} ${e} that predates the migration`};const s=F(n,"replaced",S(n.map.old.root,e));return{action:"set-aside-destination",line:`stray-destination: ${e} predates the migration; moved it to ${s} and put ${t} in its place`}}l(W,"claim");function E(t,e,n,o=!1){if(d(t)&&t!==e){if(d(e)){const r=W(t,e,n,o);if(r.line&&n.resolutions.push(r.line),r.action==="merge"){for(const i of h(t))E(c(t,i),c(e,i),n);g(t);return}if(r.action==="drop-source"){L(t,{recursive:!0}),n.changes.push(`${t} (identical to ${e}; removed)`);return}r.action==="remove-destination"?(L(e,{recursive:!0}),n.changes.push(`${e} (removed)`)):I(e,"replaced",n,S(n.map.old.root,e))}w(m(e),{recursive:!0}),b(t,e),n.moved++,n.changes.push(`${t} -> ${e}`)}}l(E,"movePath");function z(t,e,n,o=!1){if(!d(t)||t===e||!d(e))return;const r=W(t,e,n,o);if(r.line&&n.resolutions.push(r.line),r.action==="merge")for(const i of h(t))z(c(t,i),c(e,i),n)}l(z,"previewMove");function B(t){const{map:e}=t,n=c(e.old.canvas,"nodes"),o=c(e.old.canvas,"canvas.db"),r=c(e.old.root,"runtime","canvas.db"),i=d(o)?o:d(r)&&f(r).size>0?r:"";if(!i){if(d(n))throw new Error("old node records exist without canvas.db");return null}const s=new _(i,{readOnly:t.dryRun||i!==o});try{if(i===o&&!t.dryRun&&s.prepare("PRAGMA wal_checkpoint(TRUNCATE)").get().busy!==0)throw new Error("old canvas WAL is busy; stop every database user before migrating");return new Map(s.prepare("SELECT node_id, grantee FROM nodes").all().map(a=>{const u=a.grantee==="user:local"?"terminal":a.grantee.startsWith("app:")?a.grantee.slice(4):"";if(!u)throw new Error(`node ${a.node_id} has no app assignment`);return[a.node_id,u]}))}finally{s.close()}}l(B,"canvasNodeApps");function J(t,e){const n=c(t.map.old.canvas,"nodes");if(!d(n))return[];const o=[];for(const r of h(n)){const i=c(n,r),s=f(i).isDirectory();e.has(r)&&s||o.push({path:i,remove:!s&&he(r)})}return o}l(J,"orphanNodeEntries");function G(t,e){return t.remove?`node-leftover: deleted ${t.path} (not a node record)`:`node-leftover: ${t.path} has no node row; moved to ${F(e,"nodes",T(t.path))}`}l(G,"orphanLine");function ye(t){const{map:e}=t,n=c(e.old.canvas,"nodes"),o=B(t);if(o){for(const[r,i]of o)e.node(r,i);if(d(n)){for(const r of J(t,o)){if(t.resolutions.push(G(r,t)),r.remove){A(r.path),t.changes.push(`${r.path} (removed)`);continue}const i=I(r.path,"nodes",t),s=c(e.old.targetRoot,S(e.old.root,i));for(const a of new Set([e.old.storedCanvas,e.old.storedScope,c(e.old.storedScope,"canvas")]))e.add(c(a,"nodes",T(r.path)),s)}for(const[r,i]of o){const s=c(n,r);if(d(s)){for(const a of["context","reports","attachments"])E(c(s,a),c(e.old.root,"apps",i,"nodes",r,a),t);for(const a of h(s))["worktree","view.sock","broker-launch.json","system-prompt.md","situational-context.md","injected-docs.json"].includes(a)||E(c(s,a),c(e.old.root,"runtime","nodes",r,a),t);h(s).length===0&&g(s)}}h(n).length===0&&g(n)}}}l(ye,"records");const H=["auth.json","anthropic-credentials.json","openai-codex-credentials.json","openai-credentials.json","crouter-operations.db"];function ve(t,e,n){if(!d(t))return;if(!f(t).isFile())throw new Error(`credential source is not a regular file: ${t}`);const o=y(t);if(d(e)){(!f(e).isFile()||!y(e).equals(o))&&n.resolutions.push(`credential: kept the existing ${e}; the older ${t} differs and stays where it is`);return}w(m(e),{recursive:!0});const r=c(m(e),`.${N()}.tmp`);try{const i=k(r,"wx",384);try{for(let s=0;s<o.length;)s+=q(i,o,s,o.length-s);R(i)}finally{$(i)}if(b(r,e),!y(e).equals(o))throw new Error(`credential verification failed: ${e}`)}finally{d(r)&&A(r)}n.moved++,n.changes.push(`${t} -> ${e} (source retained)`)}l(ve,"copyCredential");function K(t){if(!d(t))return;const e=new _(t);try{if(e.prepare("PRAGMA wal_checkpoint(TRUNCATE)").get().busy!==0)throw new Error(`SQLite WAL is busy: ${t}`)}finally{e.close()}}l(K,"checkpointDb");function Q(t,e){if(f(t).size!==f(e).size)return!1;const n=k(t,"r"),o=k(e,"r"),r=Buffer.allocUnsafe(64*1024),i=Buffer.allocUnsafe(r.length);try{for(;;){const s=U(n,r,0,r.length,null);if(s===0)return!0;let a=0;for(;a<s;){const u=U(o,i,a,s-a,null);if(u===0)return!1;a+=u}if(!r.subarray(0,s).equals(i.subarray(0,s)))return!1}}finally{$(n),$(o)}}l(Q,"sameFile");function P(t,e,n=!1){let o;try{o=f(e)}catch(u){if(u.code==="ENOENT")return!1;throw u}const r=f(t);if(r.isSymbolicLink())return o.isSymbolicLink()&&D(t)===D(e);if(r.isFile())return o.isFile()&&Q(t,e);if(!r.isDirectory()||!o.isDirectory())return!1;const i=h(t).filter(u=>!n||u!==".git"),s=h(e).filter(u=>!n||u!==".git"),a=new Set(s);return i.length===s.length&&i.every(u=>a.has(u)&&P(c(t,u),c(e,u),n))}l(P,"sameTree");function we(t,e,n){if(!d(t))return;if(!f(t).isDirectory())throw new Error(`hosted work is not a directory: ${t}`);if(d(e)){if(P(t,e,!0))return;if(!f(e).isDirectory()||h(e).length!==0){n.resolutions.push(`hosted-work: kept the existing ${e}; the old ${t} differs and stays where it is`);return}g(e)}w(m(e),{recursive:!0});const o=c(m(e),`.work-${N()}.migrating`);try{if(ee(t,o,{recursive:!0,verbatimSymlinks:!0,preserveTimestamps:!0}),!P(t,o))throw new Error(`hosted work copy verification failed: ${t}`);b(o,e),n.moved++,n.changes.push(`${t} -> ${e} (source retained)`)}finally{d(o)&&L(o,{recursive:!0,force:!0})}}l(we,"copyHostedWork");function V(t){const{old:e}=t.map,n=c(e.root,"runtime"),o=c(n,"scope"),r=[];for(const i of["canvas.db","canvas.db-wal","canvas.db-shm","on-disk-migrations.json","requests","reviews","plugins","marketplaces","crtrd.log","crtrd.err","cache"])r.push([c(e.canvas,i),c(n,i)]);for(const i of["prompts","personas","config.json","profile-defaults.json","operations.db","operations.db-wal","operations.db-shm"])r.push([c(e.scope,i),c(o,i)]);for(const i of["support","prompt-reviews","plugins","marketplaces"])r.push([c(e.scope,i),c(n,i)]);return r.push([c(e.canvas,"secrets"),c(n,"secrets")]),r}l(V,"topLevelMoves");function be(t){const{old:e}=t.map,n=c(e.root,"runtime");K(c(e.scope,"operations.db"));for(const[o,r]of V(t)){const i=ge(o);E(o,r,t,!0),$e(i,o,r,t)}K(c(e.agent,"crouter-operations.db"));for(const o of H)ve(c(e.agent,o),c(n,"secrets",o),t);process.platform==="linux"&&we(e.work,c(e.root,"user","files"),t)}l(be,"topLevel");function ge(t){if(!d(t)||!f(t).isDirectory())return[];const e=[];for(const n of h(t)){const o=c(t,n);if(!f(o).isSymbolicLink())continue;const r=D(o);re(r)||e.push({name:n,target:r})}return e}l(ge,"relativeLinks");function $e(t,e,n,o){if(!(t.length===0||!d(n)))for(const{name:r,target:i}of t){const s=c(n,r);if(!ke(s))continue;const a=o.map.mapPath(oe(e,i)),u=S(n,a);u!==i&&(A(s),Z(u,s),o.changes.push(`${s}: link ${i} -> ${u}`))}}l($e,"retargetLinks");function ke(t){try{return f(t),!0}catch{return!1}}l(ke,"lstatExists");function Se(t){if(process.platform!=="linux")return;if(process.getuid?.()!==0)throw new Error("Linux layout migration requires root for the ownership pass");const e=y("/etc/passwd","utf8").split(`
+`).find(s=>s.startsWith("crtrd:")),n=y("/etc/group","utf8").split(`
+`).find(s=>s.startsWith("crtr-data:"));if(!e||!n)throw new Error("layout migration requires crtrd user and crtr-data group");const o=Number(e.split(":")[2]),r=Number(n.split(":")[2]);if(!Number.isInteger(o)||!Number.isInteger(r))throw new Error("invalid migration user or group");const i=l((s,a)=>{if(!d(s))return;const u=f(s);if(u.isSymbolicLink()){te(s,o,a?r:u.gid);return}if(M(s,o,a?r:u.gid),u.isDirectory()){j(s,a?1528:448);for(const v of h(s))i(c(s,v),a)}else a&&j(s,u.mode&73?504:432)},"walk");i(c(t,"runtime"),!1),i(c(t,"user"),!0),i(c(t,"apps"),!0)}l(Se,"ownership");function Ee(t){return new Promise(e=>{const n=ne({socketPath:t,path:"/healthz",method:"GET",timeout:1e3},o=>{o.resume(),e(!0)});n.on("timeout",()=>n.destroy(new Error("daemon probe timed out"))),n.on("error",o=>{o.code==="ENOENT"||o.code==="ECONNREFUSED"?e(!1):e(!0)}),n.end()})}l(Ee,"daemonAnswers");async function Re(t){const e=se(),n=e.old,o=c(n.root,"runtime","layout");if(d(o)){if(y(o,"utf8").trim()!==C)throw new Error("unsupported runtime layout version");return null}const r=new Set([c(n.canvas,"crtrd.sock"),c(n.scope,"crtrd.sock"),process.platform==="linux"?"/run/crtr/api.sock":c(n.root,"runtime","api.sock")]);for(const p of r)if(await Ee(p))throw new O({error:"daemon_running",message:`cannot migrate while a daemon answers on ${p}`,next:"Stop the daemon that owns this volume, then run `crtr sys migrate` again."});if(process.platform==="linux"&&!d(n.agent))throw new O({error:"credential_volume_missing",message:`the old credential volume is not mounted at ${n.agent}`,next:`Mount the old provider-auth volume at ${n.agent}, then run \`crtr sys migrate\` again.`});const i=H.map(p=>c(n.agent,p)).filter(p=>!d(p)),s={map:e,moved:0,changes:[],resolutions:[],bodyPaths:[],absentCredentials:i,dryRun:t};if(t){const p=B(s);if(p)for(const x of J(s,p))s.resolutions.push(G(x,s));for(const[x,Y]of V(s))z(x,Y,s,!0);return ae(s),s}ue(s);const a=[ye,de,be,le,ce,ie,fe];for(const p of a)p(s);n.canvas!==n.root&&d(n.canvas)&&h(n.canvas).length===0&&g(n.canvas),Se(n.root),w(m(o),{recursive:!0});const u=`${o}.${N()}.tmp`,v=k(u,"wx",384);try{if(process.platform==="linux"){const p=f(m(o));M(u,p.uid,p.gid)}q(v,`${C}
+`),R(v)}finally{$(v)}return b(u,o),s}l(Re,"migrateLayout");export{Ce as OldToNewPathMap,W as claim,Ee as daemonAnswers,he as isJunkFile,Re as migrateLayout,E as movePath,Oe as oldToNewPathMap,z as previewMove,Q as sameFile,I as setAside,F as setAsidePath};

package/dist/core/layout-migrate/loose-keys.d.ts

@@ -0,0 +1,2 @@
+/** Idempotent post-layout migration. Reports paths only; never key contents. */
+export declare function migrateLooseKeys(dryRun?: boolean): string[];

package/dist/core/layout-migrate/loose-keys.js

@@ -0,0 +1 @@
+var u=Object.defineProperty;var c=(t,i)=>u(t,"name",{value:i,configurable:!0});import{existsSync as p,mkdirSync as f,readFileSync as d,renameSync as l}from"node:fs";import{join as m}from"node:path";import{layoutRoot as y}from"../layout.js";import{listAppEnvNames as A,setAppEnvVar as E}from"../profiles/app-env-store.js";function $(t=!1){if(process.platform!=="darwin")return[];const i=y(),a=m(i,"runtime","set-aside","loose-keys"),o=[];for(const n of["exa.key","composio.key","secrets.json"]){const e=m(i,n);if(!p(e))continue;const s=m(a,n);if(n==="exa.key"&&!A("app:terminal").includes("EXA_API_KEY")){const r=d(e,"utf8").trim();if(!r||r.includes("\0")){o.push(`${e}: invalid or empty; left untouched`);continue}t||E("app:terminal","EXA_API_KEY",r),o.push(`${e}: imported EXA_API_KEY into app:terminal`)}if(p(s)){o.push(`${e}: destination already exists; left untouched`);continue}t||(f(a,{recursive:!0,mode:448}),l(e,s)),o.push(`${e}: moved to ${s}`)}return o}c($,"migrateLooseKeys");export{$ as migrateLooseKeys};

package/dist/core/layout-migrate/paths.d.ts

@@ -0,0 +1,30 @@
+export interface OldLayout {
+    root: string;
+    targetRoot: string;
+    canvas: string;
+    scope: string;
+    agent: string;
+    storedCanvas: string;
+    storedScope: string;
+    storedAgent: string;
+    work: string;
+}
+/** Sources are physical paths; stored prefixes are paths seen by the old daemon. */
+export declare function oldLayout(): OldLayout;
+export declare class OldToNewPathMap {
+    readonly old: OldLayout;
+    private readonly entries;
+    private readonly retired;
+    /** Stored paths inside a removed folder with no new location; left unchanged. */
+    readonly dangling: Set<string>;
+    constructor(old: OldLayout);
+    add(from: string, to: string): void;
+    /** A path whose planned destination changed: a worktree folder set aside instead of moving into its node. */
+    redirect(from: string, to: string): void;
+    /** A removed folder: the folder itself maps to `to`, and a stored path inside it with no finer entry is refused. */
+    retire(from: string, to: string): void;
+    node(nodeId: string, app: string): void;
+    /** Rewrites only approved old prefixes; later steps register profile and session paths. */
+    mapPath(path: string): string;
+}
+export declare function oldToNewPathMap(): OldToNewPathMap;

package/dist/core/layout-migrate/paths.js

@@ -0,0 +1 @@
+var f=Object.defineProperty;var d=(i,t)=>f(i,"name",{value:t,configurable:!0});import{existsSync as g}from"node:fs";import{homedir as u}from"node:os";import{isAbsolute as a,join as s,relative as l,resolve as h,sep as m}from"node:path";import{layoutRoot as w}from"../layout.js";function v(){const i=w(),t=process.platform==="linux",e=t&&i==="/"?"/volume":i,r=t?"/home/agent/.crouter":e,o=g(s(e,"canvas"))?s(e,"canvas"):e,n=t?"/home/agent/.pi/agent":h(process.env.PI_CODING_AGENT_DIR||s(u(),".pi","agent"));return{root:e,targetRoot:i,canvas:o,scope:e,agent:n,storedCanvas:o===e?r:s(r,"canvas"),storedScope:r,storedAgent:n,work:"/home/crtr/work"}}d(v,"oldLayout");class b{static{d(this,"OldToNewPathMap")}old;entries=new Map;retired=new Map;dangling=new Set;constructor(t){this.old=t;const e=s(t.targetRoot,"runtime"),r=s(e,"scope");for(const o of new Set([t.storedCanvas,t.storedScope,s(t.storedScope,"canvas")]))for(const n of["canvas.db","canvas.db-wal","canvas.db-shm","requests","reviews","plugins","marketplaces","secrets","crtrd.log","crtrd.err","cache"])this.add(s(o,n),s(e,n));for(const o of["prompts","personas","config.json","profile-defaults.json","operations.db","operations.db-wal","operations.db-shm"])this.add(s(t.storedScope,o),s(r,o));for(const o of["support","prompt-reviews","plugins","marketplaces"])this.add(s(t.storedScope,o),s(e,o));this.add(s(t.storedScope,"memory"),s(t.targetRoot,"user","memory")),this.add(t.storedScope,r),this.add(t.work,s(t.targetRoot,"user","files"));for(const o of["auth.json","anthropic-credentials.json","openai-codex-credentials.json","openai-credentials.json","crouter-operations.db"])this.add(s(t.storedAgent,o),s(e,"secrets",o));for(const o of new Set([t.storedCanvas,t.storedScope,s(t.storedScope,"canvas")]))this.add(s(o,"secrets","runtime-client.json"),s(e,"secrets","runtime-client.json"))}add(t,e){if(!a(t)||!a(e))throw new Error("migration paths must be absolute");const r=this.entries.get(t);if(r&&r!==e)throw new Error(`conflicting migration path: ${t}`);this.entries.set(t,e)}redirect(t,e){if(!a(t)||!a(e))throw new Error("migration paths must be absolute");this.entries.set(t,e)}retire(t,e){if(!a(t)||!a(e))throw new Error("migration paths must be absolute");const r=this.retired.get(t);if(r&&r!==e)throw new Error(`conflicting migration path: ${t}`);this.retired.set(t,e)}node(t,e){if(!/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/.test(t)||!/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/.test(e))throw new Error("unsafe migration node or app id");const r=s(this.old.targetRoot,"runtime","nodes",t),o=s(this.old.targetRoot,"apps",e,"nodes",t);for(const n of new Set([this.old.storedCanvas,this.old.storedScope,s(this.old.storedScope,"canvas")])){const p=s(n,"nodes",t);for(const c of["job","messages","meta.json","inbox.jsonl","passive.jsonl","transcript.jsonl","session.ptr"])this.add(s(p,c),s(r,c));for(const c of["context","reports","attachments","worktree"])this.add(s(p,c),s(o,c));this.add(s(p,"context","memory"),s(this.old.targetRoot,"apps",e,"memory","nodes",t))}}mapPath(t){if(!a(t))return t;const e=this.retired.get(t);if(e)return e;let r="";for(const o of this.entries.keys())(t===o||t.startsWith(o+m))&&o.length>r.length&&(r=o);for(const o of this.retired.keys())if(t.startsWith(o+m)&&o.length>r.length)return this.dangling.add(t),t;return r?h(this.entries.get(r),l(r,t)):t}}function R(){return new b(v())}d(R,"oldToNewPathMap");export{b as OldToNewPathMap,v as oldLayout,R as oldToNewPathMap};

package/dist/core/layout-migrate/stored-paths.d.ts

@@ -0,0 +1,9 @@
+import type { LayoutMigration } from './index.js';
+export declare function storedPaths(migration: LayoutMigration): void;
+/**
+ * Markdown links a moved profile folder by its old absolute path (or its `~/`
+ * spelling); point each at the new location. Scans the documents the canvas
+ * import reads: user and app memory, profile files, and node context. A dry
+ * run scans the same documents at their old locations and writes nothing.
+ */
+export declare function rewriteBodyPaths(migration: LayoutMigration): void;

package/dist/core/layout-migrate/stored-paths.js

@@ -0,0 +1,11 @@
+var P=Object.defineProperty;var y=(e,c)=>P(e,"name",{value:c,configurable:!0});import{DatabaseSync as S}from"node:sqlite";import{closeSync as F,existsSync as m,fsyncSync as C,lstatSync as D,openSync as B,readFileSync as $,readdirSync as g,renameSync as J,unlinkSync as x,writeFileSync as q}from"node:fs";import{basename as L,dirname as N,join as a,relative as v,resolve as H,sep as A}from"node:path";import{homedir as G}from"node:os";function M(e,c){return typeof e=="string"?c.map.mapPath(e):Array.isArray(e)?e.map(r=>M(r,c)):e!==null&&typeof e=="object"?Object.fromEntries(Object.entries(e).map(([r,i])=>[r,M(i,c)])):e}y(M,"mappedJson");function b(e,c){const r=JSON.parse(e),i=M(r,c);return JSON.stringify(i)===JSON.stringify(r)?e:JSON.stringify(i)}y(b,"rewriteJson");function O(e,c){return e.prepare("SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = ?").get(c)!==void 0}y(O,"tableExists");function T(e,c,r){if(!m(e))return;const i=new S(e);try{i.exec("BEGIN IMMEDIATE");try{for(const[f,p]of Object.entries(c)){if(!O(i,f))continue;const u=new Set(i.prepare(`PRAGMA table_info("${f}")`).all().map(o=>o.name)),d=[...(p.paths??[]).filter(o=>u.has(o)),...(p.json??[]).filter(o=>u.has(o))];if(d.length===0)continue;const s=i.prepare(`SELECT rowid AS migration_rowid, ${d.map(o=>`"${o}"`).join(", ")} FROM "${f}"`).all();for(const o of s){const l=[];for(const n of d){const t=o[n];if(typeof t!="string")continue;const h=(p.json??[]).includes(n)?b(t,r):r.map.mapPath(t);h!==t&&l.push([n,h])}l.length&&(i.prepare(`UPDATE "${f}" SET ${l.map(([n])=>`"${n}" = ?`).join(", ")} WHERE rowid = ?`).run(...l.map(([,n])=>n),o.migration_rowid),r.moved+=l.length,r.changes.push(`${e}:${f}:${String(o.migration_rowid)} (${l.map(([n])=>n).join(", ")})`))}}i.exec("COMMIT")}catch(f){throw i.exec("ROLLBACK"),f}}finally{i.close()}}y(T,"rewriteDb");const k={nodes:{paths:["cwd","fork_source_file","pi_session_file"],json:["launch_config_json","review_binding_json","metadata_json","outcome_detail_json"]},sessions:{paths:["transcript_path","fork_source_path"]},worktrees:{paths:["path","repo_root"],json:["sweep_observed_json","abandoned_json","land_intent_json","disposal_json"]},crons:{paths:["cwd"],json:["env_json","sink"]},human_action_deliveries:{paths:["cwd"],json:["argv_json","completion_json","last_failure_json"]},deliveries:{json:["adapter_json"]},reviews:{paths:["origin_session_file","review_dir","branch_file","output_path","file","presentation_dir"],json:["result_json","specification_json"]},human_requests:{paths:["request_dir","file","presentation_dir"],json:["specification_json","action_json","progress_json","feedback_json","result_json"]},run_events:{json:["body_json"]},webhook_deliveries:{json:["payload_json","document_json","last_failure_json","argv_json"]}},W={scope_owners:{paths:["root"]},profiles:{paths:["home"]},profile_projects:{paths:["path"]},profile_defaults:{paths:["directory"]},scope_bookkeeping:{paths:["active_canvas"]},scope_settings:{json:["raw_json"]}};function E(e,c,r){if(!m(e))return;const i=$(e,"utf8"),f=r(i);if(f===i)return;const p=D(e);if(!p.isFile())throw new Error(`migration path is not a regular file: ${e}`);const u=`${e}.migration-tmp`;if(m(u))throw new Error(`migration temporary file already exists: ${u}`);try{q(u,f,{flag:"wx",mode:p.mode});const d=B(u,"r");try{C(d)}finally{F(d)}J(u,e)}finally{m(u)&&x(u)}c.moved++,c.changes.push(`${e} (stored paths)`)}y(E,"rewriteFile");function _(e,c){if(m(e))for(const r of g(e,{withFileTypes:!0})){const i=a(e,r.name);r.isDirectory()?_(i,c):r.isFile()&&c(i)}}y(_,"walk");function U(e,c,r){const{map:i}=e,{old:f}=i,p=new Map,u=new Set,d=new Set;_(c,n=>{if(!n.includes("/conversations/")||!n.endsWith(".jsonl"))return;const t=L(n);p.has(t)?u.add(t):p.set(t,a(f.targetRoot,v(f.root,n)))});const s=y(n=>{if(typeof n=="string"){if(!n.startsWith(f.storedAgent+A+"sessions"+A)||d.has(n)||i.mapPath(n)!==n)return;const t=L(n);if(u.has(t)||!p.has(t)){d.has(n)||e.resolutions.push(`lost-transcript: ${n} is referenced but ${u.has(t)?"matches more than one moved transcript":"exists nowhere"}; left the reference unchanged`),d.add(n);return}i.add(n,p.get(t))}else if(Array.isArray(n))for(const t of n)s(t);else if(n!==null&&typeof n=="object")for(const t of Object.values(n))s(t)},"reference"),o=y(n=>{if(n.endsWith("/meta.json")||n.endsWith(".json")&&(n.includes("/tickets/")||n.includes("/requests/")))s(JSON.parse($(n,"utf8")));else if(n.endsWith(".jsonl")&&n.includes("/conversations/")){const t=$(n,"utf8");s(JSON.parse(t.slice(0,t.indexOf(`
+`)<0?void 0:t.indexOf(`
+`))))}else if(n.endsWith(".md")&&n.includes("/memory/")){const t=$(n,"utf8");if(!t.startsWith(`---
+`))return;const h=t.indexOf(`
+---`,4);if(h<0)return;for(const j of t.slice(0,h).split(`
+`)){const w=j.match(/^\s*session_file:\s*["']?([^"'\n]+)["']?$/);w&&s(w[1])}}},"inspect");_(c,o),_(a(f.root,"user","memory"),o),_(a(r,"nodes"),o),_(a(r,"tickets"),o),_(a(r,"requests"),o);const l=a(r,"canvas.db");if(m(l)){const n=new S(l,{readOnly:!0});try{for(const[t,h]of Object.entries(k)){if(!O(n,t))continue;const j=new Set(n.prepare(`PRAGMA table_info("${t}")`).all().map(w=>w.name));for(const w of[...h.paths??[],...h.json??[]].filter(R=>j.has(R)))for(const R of n.prepare(`SELECT "${w}" AS value FROM "${t}" WHERE "${w}" LIKE ?`).all(`%${f.storedAgent}/sessions/%`))(h.json??[]).includes(w)?s(JSON.parse(R.value)):s(R.value)}}finally{n.close()}}}y(U,"recoverSessionMappings");function se(e){const{root:c}=e.map.old,r=a(c,"runtime"),i=a(c,"apps");U(e,i,r),T(a(r,"canvas.db"),k,e),T(a(r,"scope","operations.db"),W,e);const f=new Set,p=a(r,"canvas.db");if(m(p)){const s=new S(p,{readOnly:!0});try{if(O(s,"nodes")&&s.prepare("PRAGMA table_info(nodes)").all().some(o=>o.name==="cwd"))for(const o of s.prepare("SELECT cwd FROM nodes").all())f.add(o.cwd)}finally{s.close()}}const u=a(r,"scope","operations.db");if(m(u)){const s=new S(u,{readOnly:!0});try{if(O(s,"profile_projects"))for(const o of s.prepare("SELECT path FROM profile_projects").all())f.add(o.path)}finally{s.close()}}for(const s of f){const o=e.map.old.targetRoot;let l=s.startsWith(o+"/")?H(c,v(o,s)):s;for(;l!==N(l);)T(a(l,".crouter","operations.db"),W,e),l=N(l)}_(a(i),s=>{s.endsWith("/.crouter/operations.db")&&T(s,W,e),s.endsWith("/meta.json")&&E(s,e,o=>b(o,e)),s.endsWith(".md")&&s.includes("/memory/")&&I(s,e),s.endsWith(".jsonl")&&s.includes("/conversations/")&&X(s,e)}),_(a(c,"user","memory"),s=>{s.endsWith(".md")&&I(s,e)}),Y(e);for(const s of e.map.dangling)e.resolutions.push(`dangling-path: ${s} names a file the new layout drops; left the stored path unchanged`);_(a(c,"user","files"),s=>{s.endsWith("/.crouter/operations.db")&&T(s,W,e)}),_(a(r,"nodes"),s=>{s.endsWith("/meta.json")&&E(s,e,o=>b(o,e)),s.endsWith("/session.ptr")&&x(s)}),_(a(r,"tickets"),s=>{s.endsWith(".json")&&E(s,e,o=>b(o,e))}),_(a(r,"requests"),s=>{s.endsWith(".json")&&E(s,e,o=>b(o,e))});const d=a(r,"canvas.db");if(m(d)){const s=new S(d);try{s.exec("DROP TABLE IF EXISTS layout_header_rewrites")}finally{s.close()}}}y(se,"storedPaths");function I(e,c){E(e,c,r=>{if(!r.startsWith(`---
+`))return r;const i=r.indexOf(`
+---`,4);return i<0?r:r.slice(0,i).replace(/^(\s*session_file:\s*)([^\n]+)$/gm,(p,u,d)=>{const s=d.match(/^(["'])(.*)\1$/),o=s?s[2]:d.trim(),l=c.map.mapPath(o);return l===o?p:`${u}${s?s[1]:""}${l}${s?s[1]:""}`})+r.slice(i)})}y(I,"rewriteMemory");function X(e,c){const r=a(c.map.old.root,"runtime","canvas.db");if(!m(r)){E(e,c,f=>{const p=f.indexOf(`
+`),u=p<0?f:f.slice(0,p);return b(u,c)+(p<0?"":f.slice(p))});return}const i=new S(r);try{i.exec("CREATE TABLE IF NOT EXISTS layout_header_rewrites (path TEXT PRIMARY KEY, old_header TEXT NOT NULL, new_header TEXT NOT NULL)");const f=i.prepare("SELECT old_header, new_header FROM layout_header_rewrites WHERE path = ?").get(e),p=$(e,"utf8"),u=p.indexOf(`
+`),d=u<0?p:p.slice(0,u),s=f?.new_header??b(d,c);if(f&&d!==f.old_header&&d!==s)throw new Error(`conversation header changed during migration: ${e}`);if(!f&&s!==d){const o=a(c.map.old.targetRoot,v(c.map.old.root,e)),l=Buffer.byteLength(s)-Buffer.byteLength(d);i.exec("BEGIN IMMEDIATE");try{i.prepare("INSERT INTO layout_header_rewrites (path, old_header, new_header) VALUES (?, ?, ?)").run(e,d,s),l!==0&&O(i,"sessions")&&i.prepare("UPDATE sessions SET event_offset = event_offset + ? WHERE transcript_path = ? AND event_offset > 0").run(l,o),i.exec("COMMIT")}catch(n){throw i.exec("ROLLBACK"),n}}d!==s&&E(e,c,o=>{const l=o.indexOf(`
+`);if((l<0?o:o.slice(0,l))!==d)throw new Error(`conversation header changed during migration: ${e}`);return s+(l<0?"":o.slice(l))}),(f||s!==d)&&i.prepare("DELETE FROM layout_header_rewrites WHERE path = ?").run(e)}finally{i.close()}}y(X,"rewriteHeader");function K(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}y(K,"escape");function Y(e){const c=e.bodyPaths;if(c.length===0)return;const r=G(),i=[];for(const[t,h]of c)i.push([t,h]),t.startsWith(r+A)&&i.push([`~${t.slice(r.length)}`,h.startsWith(r+A)?`~${h.slice(r.length)}`:h]);i.sort((t,h)=>h[0].length-t[0].length);const f=new RegExp(`(${i.map(([t])=>K(t)).join("|")})(?![A-Za-z0-9_-])`,"g"),p=new Map(i),{root:u,scope:d,canvas:s}=e.map.old,o=y(t=>{if(!t.endsWith(".md"))return;if(e.dryRun){const j=$(t,"utf8").match(f)?.length??0;j&&e.resolutions.push(`profile-extra-link: rewrote ${j} link(s) to moved profile files in ${t}`);return}let h=0;E(t,e,j=>j.replace(f,w=>(h++,p.get(w)))),h&&e.resolutions.push(`profile-extra-link: rewrote ${h} link(s) to moved profile files in ${t}`)},"visit"),l=y(t=>{if(m(t))for(const h of g(t))_(a(t,h,"context"),o)},"nodeContexts");if(e.dryRun){_(a(d,"memory"),o),_(a(d,"profiles"),o),l(a(s,"nodes"));return}_(a(u,"user","memory"),o);const n=a(u,"apps");if(m(n))for(const t of g(n))_(a(n,t,"memory"),o),_(a(n,t,"files","profiles"),o),l(a(n,t,"nodes"))}y(Y,"rewriteBodyPaths");export{Y as rewriteBodyPaths,se as storedPaths};