@north-light/cli 0.0.0 → 0.3.413

package/dist/commands/sys/setup-core.d.ts

@@ -0,0 +1,121 @@
+import { type BindingId, type BindingResolution, type KeybindingDiagnostic, type SparseKeybindingOverrides } from '../../core/keybindings/index.js';
+import { type PluginEnvDeclaration } from '../../core/plugin-env.js';
+import { type TerminalConfigEdit } from './terminal-option.js';
+export declare const OFFICIAL_MARKETPLACE_NAME = "crouter-official-marketplace";
+export declare const OFFICIAL_MARKETPLACE_URL = "https://github.com/crouton-labs/crouter-official-marketplace.git";
+export declare const OFFICIAL_MARKETPLACE_REF = "main";
+export type SetupPackageId = 'official-marketplace' | 'crtr-extensions' | 'oauth-adapter' | 'capture-plugin' | 'exa-search-plugin' | 'dev-plugin';
+/** `nerd-font` is not a command on PATH like the other two — it is an installed
+ *  font face, detected by fontconfig/font-directory scan. The viewer renders
+ *  every tool and command icon with Nerd Font codepoints, so without it a fresh
+ *  machine shows tofu boxes. */
+export type SetupTool = 'tmux' | 'nvim' | 'nerd-font';
+/** `marketplace-source` clones and registers a marketplace repo
+ *  (`installSource` is its git URL); `marketplace-plugin` installs one plugin
+ *  from a registered marketplace (`installSource` is a `<marketplace>/<plugin>`
+ *  ref). Neither runs the bundled pi CLI, and neither happens anywhere but
+ *  setup: an install that never runs setup — a crouter cloud guest image, CI —
+ *  fetches no catalog and carries no command whose external binary it lacks. */
+export type SetupPackageSourceKind = 'local-path' | 'npm' | 'marketplace-source' | 'marketplace-plugin';
+export type SetupPackageIdentity = string;
+export type PackageManager = 'brew' | 'apt-get' | 'dnf' | 'pacman' | 'manual';
+export interface SetupPackageManifestEntry {
+    id: SetupPackageId;
+    name: string;
+    sourceKind: SetupPackageSourceKind;
+    installSource: string;
+    shortDescription: string;
+    longDescription: string;
+}
+export interface SetupSystemInstallPlan {
+    tool: SetupTool;
+    installed: boolean;
+    command: string | null;
+    hint: string;
+    autoInstall: boolean;
+}
+export interface SetupPluginEnvField {
+    name: string;
+    plugin: string;
+    declaration: PluginEnvDeclaration;
+}
+/** Read declarations without installing or registering a marketplace until confirmation. */
+export declare function setupPluginEnvFields(packages: readonly SetupPackageManifestEntry[]): SetupPluginEnvField[];
+export interface SetupSubmission {
+    packages: SetupPackageManifestEntry[];
+    installedPackageIds: Set<SetupPackageId>;
+    systemDeps: SetupSystemInstallPlan[];
+    pluginEnv: Map<string, string>;
+    /** A terminal-config write the person explicitly ticked in the Option key step. */
+    terminalEdit?: TerminalConfigEdit;
+}
+export interface SetupExecutionSummary {
+    installed: string[];
+    skipped: string[];
+}
+export interface SetupInitialState {
+    manifest: SetupPackageManifestEntry[];
+    installedPackageIds: Set<SetupPackageId>;
+    systemPlans: SetupSystemInstallPlan[];
+}
+export interface KeybindingEditResult {
+    readonly ok: boolean;
+    readonly diagnostics: readonly KeybindingDiagnostic[];
+}
+/** Transactional sparse keybinding draft used by the full-screen setup tab. */
+export declare class SetupKeybindingsDraft {
+    private expected;
+    private baseline;
+    private current;
+    private baselineInvalidRoot;
+    private invalidRoot;
+    private resolutionCache;
+    private expectedPassthrough;
+    private baselinePassthrough;
+    private currentPassthrough;
+    constructor(rawKeybindings: unknown, rawTmuxPassthrough?: unknown);
+    get dirty(): boolean;
+    overrides(): Record<string, unknown>;
+    expectedKeybindings(): unknown;
+    tmuxPassthrough(): readonly BindingId[];
+    expectedTmuxPassthrough(): unknown;
+    usesTmuxPassthrough(id: BindingId): boolean;
+    toggleTmuxPassthrough(id: BindingId): void;
+    resolution(): BindingResolution<BindingId>;
+    /** True while the persisted `keybindings` root is a non-object (e.g. a string):
+     *  edits cannot be layered onto an invalid root, so the tab must reset-all first. */
+    hasInvalidRoot(): boolean;
+    expression(id: BindingId): string;
+    edit(id: BindingId, expression: string): KeybindingEditResult;
+    unbind(id: BindingId): KeybindingEditResult;
+    resetRow(id: BindingId): void;
+    resetAll(): void;
+    discard(): void;
+    markSaved(overrides: SparseKeybindingOverrides<BindingId>, tmuxPassthrough?: readonly BindingId[]): void;
+}
+export declare function buildSetupManifest(resolveBuiltinPackageDir?: (name: string) => string): SetupPackageManifestEntry[];
+/** One-line description of what installing an entry will actually run — the
+ *  wizard's confirm step and the non-TTY dump both show it. */
+export declare function packagePlanAction(entry: SetupPackageManifestEntry): string;
+export declare function normalizePackageIdentity(source: string, settingsDir: string, homeDir: string): SetupPackageIdentity;
+export declare function detectInstalledSetupPackageIds(settingsJson: unknown, manifest?: SetupPackageManifestEntry[], settingsPath?: string, homeDir?: string): Set<SetupPackageId>;
+export declare function detectCommandOnPath(command: string): boolean;
+export declare function detectPackageManager(platform?: NodeJS.Platform, commandExists?: (command: string) => boolean): PackageManager;
+export declare function buildSystemInstallPlan(tool: SetupTool, packageManager: PackageManager, commandExists?: (command: string) => boolean): SetupSystemInstallPlan;
+export declare function resolveSettingsPath(homeDir?: string): string;
+export declare function buildSetupInitialState(opts?: {
+    manifest?: SetupPackageManifestEntry[];
+    settingsPath?: string;
+    homeDir?: string;
+    packageManager?: PackageManager;
+    commandExists?: (command: string) => boolean;
+}): SetupInitialState;
+export declare function renderSetupStaticInstructions(state: SetupInitialState): string;
+/** Refresh crouter-owned tmux bindings. Setup must never fail because tmux is unavailable. */
+export declare function reconcileInboxFrontDoor(): Promise<void>;
+export declare function formatSetupExecutionSummary(summary: SetupExecutionSummary): string;
+/** The non-interactive first command reconciles only crouter-owned packages.
+ * Individual failures are reported by the CLI but never prevent later work or
+ * writing the once-per-machine marker. */
+export declare function reconcileFirstRun(onFailure: (item: string, error: unknown) => void, commandExists?: (command: string) => boolean): Promise<string>;
+export declare function executeSetupSubmission(submission: SetupSubmission, commandExists?: (command: string) => boolean): Promise<SetupExecutionSummary>;

package/dist/commands/sys/setup-core.js

@@ -0,0 +1,9 @@
+var re=Object.defineProperty;var a=(e,t)=>re(e,"name",{value:t,configurable:!0});import{spawn as ie,spawnSync as se}from"node:child_process";import{homedir as w,tmpdir as ae}from"node:os";import{mkdtempSync as oe,rmSync as ce}from"node:fs";import{piAgentDir as P}from"../../core/runtime/package-health.js";import{basename as le,dirname as _,join as m,relative as ue,resolve as de}from"node:path";import{isDeepStrictEqual as x}from"node:util";import{BINDING_CATALOG as pe,normalizeGesture as fe,splitGestureExpression as he,inboxShortcut as me,resolveKeybindings as S}from"../../core/keybindings/index.js";import{runtimeManifest as ge}from"./shared.js";import{atomicWriteJson as ke,readJsonIfExists as ve,readJsonOrNull as L}from"../../core/fs-utils.js";import{resolveBundledPiCliPath as xe}from"../../core/runtime/pi-cli.js";import{crtrVersion as we}from"../../shared/crtr-version.js";import{installTmuxBindings as be}from"../../core/runtime/tmux-chrome.js";import{normalizeTmuxPassthrough as ye}from"../../core/config.js";import{detectNerdFont as Ie,nerdFontInstallCommand as Pe,createCurlPercentReader as Se,NERD_FONT_MANUAL_LINUX_COMMAND as Ce,NERD_FONT_SELECT_HINT as Ee}from"../../core/runtime/nerd-font.js";import{startProgressBar as Ae}from"../../core/runtime/progress-bar.js";import{ensureRenderer as $e,isRendererReady as K}from"../../core/termrender/termrender.js";import{installFromMarketplace as Re,isMarketplaceRelativeSource as De}from"../pkg/plugin-manage.js";import{requiredPluginEnv as Me}from"../../core/plugin-env.js";import{readPluginManifest as Te}from"../../core/manifest.js";import{addMarketplace as j}from"../pkg/market-manage.js";import{clone as Ne}from"../../core/git.js";import{readMarketplaceManifest as Oe}from"../../core/manifest.js";import{findPluginByName as F,findMarketplaceByName as C}from"../../core/resolver.js";import{expandTilde as _e}from"../../core/fs-utils.js";import{applyTerminalEdit as Le}from"./terminal-option.js";const E="crouter-official-marketplace",A="https://github.com/crouton-labs/crouter-official-marketplace.git",$="main";function It(e){const t=[],n=new Set,r=new Map;try{for(const o of e){if(o.sourceKind!=="marketplace-plugin")continue;const[l,c]=o.installSource.split("/");if(!l||!c)continue;const u=F(c,"user")?.manifest;let d=C(l,"user");if(!d&&!u&&l===E)try{let i=r.get(l);i||(i=oe(m(ae(),"crtr-setup-market-")),r.set(l,i),Ne(A,m(i,"checkout"),{ref:$,depth:1}));const p=m(i,"checkout"),v=Oe(p);v&&(d={root:p,manifest:v})}catch{}const h=d?.manifest.plugins.find(i=>i.name===c)?.source,f=h&&De(h)?Te(m(d.root,h))??u:u;if(f)for(const i of Me(f.env))n.has(i)||(n.add(i),t.push({name:i,plugin:c,declaration:f.env[i]}))}}finally{for(const o of r.values())ce(o,{recursive:!0,force:!0})}return t}a(It,"setupPluginEnvFields");function G(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}a(G,"isKeybindingsObject");function g(e){return G(e)?Object.fromEntries(Object.entries(e).map(([t,n])=>[t,Array.isArray(n)?[...n]:n])):{}}a(g,"cloneKeybindings");class Pt{static{a(this,"SetupKeybindingsDraft")}expected;baseline;current;baselineInvalidRoot;invalidRoot;resolutionCache;expectedPassthrough;baselinePassthrough;currentPassthrough;constructor(t,n=void 0){this.expected=t,this.baseline=g(t),this.current=g(t),this.baselineInvalidRoot=t!==void 0&&!G(t)?t:void 0,this.invalidRoot=this.baselineInvalidRoot,this.expectedPassthrough=n,this.baselinePassthrough=ye(n),this.currentPassthrough=[...this.baselinePassthrough]}get dirty(){return!x(this.current,this.baseline)||!x(this.invalidRoot,this.baselineInvalidRoot)||!x(this.currentPassthrough,this.baselinePassthrough)}overrides(){return g(this.current)}expectedKeybindings(){return this.expected}tmuxPassthrough(){return[...this.currentPassthrough]}expectedTmuxPassthrough(){return this.expectedPassthrough}usesTmuxPassthrough(t){return this.currentPassthrough.includes(t)}toggleTmuxPassthrough(t){this.currentPassthrough=this.currentPassthrough.includes(t)?this.currentPassthrough.filter(n=>n!==t):[...this.currentPassthrough,t]}resolution(){return this.resolutionCache===void 0&&(this.resolutionCache=S(this.invalidRoot===void 0?this.current:this.invalidRoot)),this.resolutionCache}hasInvalidRoot(){return this.invalidRoot!==void 0}expression(t){return this.resolution().gestures(t).join(", ")}edit(t,n){if(this.invalidRoot!==void 0)return{ok:!1,diagnostics:[{severity:"error",code:"invalid-keybindings",offendingValue:this.invalidRoot,message:"Reset all before editing: the saved keybindings root is invalid."}]};const r=pe.find(f=>f.id===t);let o;try{o=n.trim()===""?[]:he(n).map(f=>fe(f.trim(),r))}catch(f){return{ok:!1,diagnostics:[{severity:"error",code:"invalid-override",bindingId:t,offendingValue:n,message:f instanceof Error?f.message:String(f)}]}}const l=[...new Set(o)],c={...this.current};delete c[t];const u=[...S(c).gestures(t)],s=x(l,u)?c:{...this.current,[t]:l},d=S(s),h=d.diagnostics.filter(f=>f.bindingId===t||f.relatedBindingIds?.includes(t));return h.length>0?{ok:!1,diagnostics:h}:(this.current=s,this.resolutionCache=void 0,{ok:!0,diagnostics:d.diagnostics})}unbind(t){return this.edit(t,"")}resetRow(t){delete this.current[t],this.resolutionCache=void 0}resetAll(){this.current={},this.currentPassthrough=[],this.invalidRoot=void 0,this.resolutionCache=void 0}discard(){this.current=g(this.baseline),this.currentPassthrough=[...this.baselinePassthrough],this.invalidRoot=this.baselineInvalidRoot,this.resolutionCache=void 0}markSaved(t,n=[]){this.expected=Object.keys(t).length===0?void 0:g(t),this.baseline=g(t),this.current=g(t),this.expectedPassthrough=n.length===0?void 0:[...n],this.baselinePassthrough=[...n],this.currentPassthrough=[...n],this.baselineInvalidRoot=void 0,this.invalidRoot=void 0,this.resolutionCache=void 0}}const Ke={"official-marketplace":{name:E,shortDescription:"the official crtr plugin catalog \u2014 registered as a source so its plugins are installable by ref.",longDescription:"Shallow-clones github.com/crouton-labs/crouter-official-marketplace into the user scope and registers it, which is what makes `crtr pkg plugin install crouter-official-marketplace/<name>` resolve and what fills `crtr pkg market browse`. Registering the source installs no plugin by itself. Uncheck it on a machine that should reach no external catalog \u2014 a plugin selected below still registers the marketplace it comes from, because its ref cannot resolve otherwise."},"crtr-extensions":{name:"pi-crtr-extensions",shortDescription:"crtr companion extensions \u2014 command palette, help gating, subscription/OAuth rotation, nested context.",longDescription:"Bundles the extensions built for crtr: a crtr slash-command palette, crtr/crouter help gating, surfacing of Claude Code marketplace plugin commands, nested AGENTS.md/CLAUDE.md loading, OAuth login + rotation across multiple Claude subscriptions (provider-rotation), and system-prompt trimming. The OAuth/rotation piece is what lets crtr authenticate your Claude account."},"oauth-adapter":{name:"pi-claude-oauth-adapter",shortDescription:"Anthropic OAuth / Claude Code credential compatibility for pi.",longDescription:"Third-party adapter (minzique/dotfiles-agents) letting pi authenticate with Claude using Claude Code OAuth credentials. Installed from npm, pinned to 0.2.2."},"capture-plugin":{name:"capture",shortDescription:"crtr plugin mounting `crtr capture` \u2014 browser automation and UI measurement over CDP.",longDescription:"Installs the `capture` plugin from the official crtr marketplace. It mounts `crtr capture` as a transparent passthrough to the external Capture CLI (`npm install -g @crouton-kit/capture`) for CDP screenshots, rendered-geometry measurement, HAR, accessibility trees, and JS execution against a live page. Uncheck it on a machine where agents never drive a browser \u2014 the command then costs nothing in their root prompt."},"exa-search-plugin":{name:"exa-search",shortDescription:"crtr plugin mounting `crtr exa-search` \u2014 public-web discovery, grounded answers, and content extraction.",longDescription:"Installs the `exa-search` plugin from the official crtr marketplace. It mounts `crtr exa-search` and calls Exa directly with EXA_API_KEY, collected during install or set through `crtr sys env set --name EXA_API_KEY` in the app env store. Uncheck it on a machine whose agents get web search from somewhere else, such as a crouter cloud home where the platform serves `crtr search` from its own plugin."},"dev-plugin":{name:"dev",shortDescription:"crtr plugin mounting the development workflow \u2014 repository setup, worktrees, pull requests, and a dev track in the tutorial.",longDescription:"Installs the dev plugin from the official crtr marketplace. It adds the /dev: workflow commands (init, spec, design, plan, pr-loop), mounts crtr dev for a repository's own lifecycle commands and Grove instances, and contributes the crtr sys tutorial dev track. Uncheck it on a machine whose agents do not work in source repositories."}},R={"official-marketplace":{kind:"marketplace-source",source:A},"crtr-extensions":{kind:"local-path",source:U("pi-crtr-extensions")},"oauth-adapter":{kind:"npm",source:"npm:pi-claude-oauth-adapter@0.2.2"},"capture-plugin":{kind:"marketplace-plugin",source:"crouter-official-marketplace/capture"},"exa-search-plugin":{kind:"marketplace-plugin",source:"crouter-official-marketplace/exa-search"},"dev-plugin":{kind:"marketplace-plugin",source:"crouter-official-marketplace/dev"}},B=["extensions/*.ts","extensions/*/index.ts","!extensions/**/*.d.ts"],je={"official-marketplace":[],"crtr-extensions":["pi-crtr-extensions"],"oauth-adapter":[],"capture-plugin":[],"exa-search-plugin":[],"dev-plugin":[]};function U(e){return m(ge.runtimeHome(),"selected","dist","builtin-pi-packages",e)}a(U,"selectedPiPackageDir");function D(e=U){return["official-marketplace","crtr-extensions","oauth-adapter","capture-plugin","exa-search-plugin","dev-plugin"].map(t=>{const n=Ke[t],r=R[t].kind==="local-path"?e(n.name):R[t].source;return{id:t,name:n.name,sourceKind:R[t].kind,installSource:r,shortDescription:n.shortDescription,longDescription:n.longDescription}})}a(D,"buildSetupManifest");function St(e){switch(e.sourceKind){case"marketplace-source":return`clone + register ${e.installSource}`;case"marketplace-plugin":return`crtr pkg plugin install ${e.installSource}`;default:return`pi install ${e.installSource}`}}a(St,"packagePlanAction");function Fe(e){if(!e.startsWith("npm:"))return null;const t=e.slice(4),n=t.startsWith("@")?t.indexOf("@",1):t.lastIndexOf("@");return n>0?t.slice(0,n):t}a(Fe,"npmPackageName");function b(e,t,n){const r=Fe(e);if(r!==null)return`npm:${r}`;const o=_e(e,n);return de(t,o)}a(b,"normalizePackageIdentity");function y(e){return`package:${e}`}a(y,"packageNameIdentity");function Y(e){return e.startsWith("npm:")?[]:[y(le(e))]}a(Y,"localPackageNameIdentities");function Ge(e,t,n){const r=[b(e.installSource,t,n)];if(e.sourceKind==="local-path"){r.push(y(e.name));for(const o of je[e.id])r.push(y(o))}return r}a(Ge,"manifestIdentities");function z(e,t=D(),n=m(P(),"settings.json"),r=w()){const o=_(n),l=new Set,c=new Map;for(const s of t)for(const d of Ge(s,o,r))c.set(d,s.id);const u=e&&typeof e=="object"?e.packages:void 0;if(!Array.isArray(u))return l;for(const s of u){const d=typeof s=="string"?s:s&&typeof s=="object"&&typeof s.source=="string"?s.source:null;if(d===null)continue;const h=[b(d,o,r),...Y(d)];for(const f of h){const i=c.get(f);if(i==="crtr-extensions"){const p=t.find(v=>v.id===i);if(b(d,o,r)!==b(p.installSource,o,r)||!s||typeof s!="object"||!x(s.extensions,B))continue}i!==void 0&&l.add(i)}}return l}a(z,"detectInstalledSetupPackageIds");function k(e){return se("sh",["-lc",`command -v ${e} >/dev/null 2>&1`],{stdio:"ignore"}).status===0}a(k,"detectCommandOnPath");function Be(e=process.platform,t=k){switch(e){case"darwin":return t("brew")?"brew":"manual";case"linux":return t("apt-get")?"apt-get":t("dnf")?"dnf":t("pacman")?"pacman":"manual";default:return"manual"}}a(Be,"detectPackageManager");function Ue(e,t,n=k){if(e==="nerd-font"?Ie().installed:n(e))return{tool:e,installed:!0,command:null,hint:"already installed",autoInstall:!1};if(e==="nerd-font"){const l=Pe(t);return{tool:e,installed:!1,command:l.command,hint:`${l.hint} \u2014 ${Ee}`,autoInstall:l.autoInstall}}const o=e==="nvim"?"neovim":"tmux";switch(t){case"brew":return{tool:e,installed:!1,command:`brew install ${o}`,hint:"Homebrew install",autoInstall:!0};case"apt-get":return{tool:e,installed:!1,command:`sudo apt-get update && sudo apt-get install -y ${o}`,hint:"apt-get install",autoInstall:!0};case"dnf":return{tool:e,installed:!1,command:`sudo dnf install -y ${o}`,hint:"dnf install",autoInstall:!0};case"pacman":return{tool:e,installed:!1,command:`sudo pacman -S --noconfirm ${o}`,hint:"pacman install",autoInstall:!0};default:return{tool:e,installed:!1,command:null,hint:`manual install required for ${e}`,autoInstall:!1}}}a(Ue,"buildSystemInstallPlan");function M(e=w()){return m(e===w()?P():m(e,".pi","agent"),"settings.json")}a(M,"resolveSettingsPath");function Ct(e={}){const t=e.homeDir??w(),n=e.settingsPath??M(t),r=e.manifest??D(),o=ve(n),l=z(o,r,n,t);for(const d of V(r))l.add(d);const c=e.commandExists??k,u=e.packageManager??Be(process.platform,c),s=["tmux","nvim","nerd-font"].map(d=>Ue(d,u,c));return{manifest:r,installedPackageIds:l,systemPlans:s}}a(Ct,"buildSetupInitialState");function Et(e){const t=e.manifest.map(r=>{const o=e.installedPackageIds.has(r.id)?"installed":"not installed";return`- ${r.name} \u2014 ${r.shortDescription} (${o})`}),n=e.systemPlans.map(r=>r.installed?`- ${r.tool}: \u2713 installed`:r.command?`- ${r.tool}: ${r.command}`:`- ${r.tool}: ${r.hint}`);return["crtr sys setup (non-interactive)","","Provider login: open the wizard in a TTY and use the Providers tab (same flow as /login) to authenticate a model provider.","","Packages:",...t,"","System deps:",...n,"",`Inbox: the inbox-toggle key (${me()??"disabled"}) is a crouter keybinding \u2014 view or rebind it in \`crtr sys settings\`; it is installed on the same tmux server as every other crouter binding.`,"Run `crtr sys setup` in a TTY to open the wizard."].join(`
+`)+`
+`}a(Et,"renderSetupStaticInstructions");class I extends Error{static{a(this,"SetupCommandError")}output;constructor(t,n){super(t),this.output=n}}function At(e){return`${e.stdout?.toString()??""}${e.stderr?.toString()??""}`}a(At,"commandOutput");function q(e,t,n,r=process.env){return new Promise((o,l)=>{const c=ie(e,t,{stdio:["ignore","pipe","pipe"],env:r});let u="";c.stdout.setEncoding("utf8"),c.stderr.setEncoding("utf8"),c.stdout.on("data",s=>{u+=s}),c.stderr.on("data",s=>{u+=s,n?.(s)}),c.on("error",s=>l(new I(`${e} failed: ${s.message}`,u))),c.on("close",s=>{s===0?o():l(new I(`${e} failed with status ${s??"unknown"}`,u))})})}a(q,"runCapturedCommand");function T(e,t){return q("sh",["-lc",e],t)}a(T,"runShellCommand");function Ye(e,t=xe()){return q(process.execPath,[t,"install",e],void 0,{...process.env,PI_CODING_AGENT_DIR:P()})}a(Ye,"installPiPackage");async function W(){k("capture")||await T("npm install -g @crouton-kit/capture")}a(W,"installCaptureCliIfMissing");function H(e){return e instanceof I?e.output:void 0}a(H,"capturedFailureOutput");function ze(e){const n=H(e)?.split(/\r?\n/).find(r=>r.trim()!=="");return n!==void 0?n.trim():e instanceof Error?e.message:String(e)}a(ze,"firstFailureLine");function qe(e){const t=H(e);t===void 0||t.length===0||process.stderr.write(t.endsWith(`
+`)?t:`${t}
+`)}a(qe,"printCapturedFailure");class We{static{a(this,"SetupProgress")}interactive;bar=null;constructor(t=!!process.stdout.isTTY){this.interactive=t}start(t){return this.interactive?(this.bar=Ae(`Installing ${t}\u2026`),this.bar):null}async clear(){await this.bar?.stop(),this.bar=null}async succeed(t){await this.clear(),this.interactive&&process.stdout.write(`\r\x1B[2K\u2713 ${t}
+`)}async fail(t,n){await this.clear(),this.interactive&&process.stdout.write(`\r\x1B[2K\u2717 ${t} \u2014 ${ze(n)}
+`),qe(n)}async run(t,n){const r=this.start(t);try{const o=await n(r);return await this.succeed(t),o}catch(o){throw await this.fail(t,o),o}}}function X(e,t){return K()?"current":(e?.(),$e(t),K()?"provisioned":"unavailable")}a(X,"ensureManagedRenderer");async function He(){try{be()}catch{}}a(He,"reconcileInboxFrontDoor");function J(e,t){return t.length===0?[`${e}: none`]:[`${e}:`,...t.map(n=>`  - ${n}`)]}a(J,"summarySection");function $t(e){return["crtr sys setup complete",...J("installed",e.installed),...J("skipped",e.skipped),"New to crouter? Ask for the tutorial in your first conversation, or run /tutorial any time."].join(`
+`)+`
+`}a($t,"formatSetupExecutionSummary");function V(e,t){const n=[];for(const r of e)try{r.sourceKind==="marketplace-source"?C(r.name,t)!==null&&n.push(r.id):r.sourceKind==="marketplace-plugin"&&F(r.name,t)!==null&&n.push(r.id)}catch{}return n}a(V,"detectInstalledMarketplaceEntries");function Xe(e,t="user"){if(C(e,t)!==null)return null;if(e!==E)throw new Error(`marketplace not registered: ${e}`);return j({url:A,ref:$,scope:t}),e}a(Xe,"ensureMarketplaceRegistered");function Je(e){const t=M(),n=L(t);if(!n||typeof n!="object"||Array.isArray(n))throw new Error(`invalid pi settings: ${t}`);const r=n.packages;if(!Array.isArray(r))throw new Error(`invalid pi packages: ${t}`);const o=a(u=>{const s=typeof u=="string"?u:u&&typeof u=="object"?u.source:void 0;return typeof s=="string"&&Y(s).includes(y("pi-crtr-extensions"))},"isCrtrExtensions"),l=r.findIndex(o),c=r.filter(u=>!o(u));c.splice(l<0?c.length:l,0,{source:ue(_(t),e),extensions:B}),ke(t,{...n,packages:c})}a(Je,"configureCrtrExtensions");const Q="git is not installed \u2014 install it (Debian/Ubuntu: apt-get install git), then run `crtr sys setup`";function Z(e){return e.sourceKind==="marketplace-source"||e.sourceKind==="marketplace-plugin"}a(Z,"isMarketplaceEntry");async function ee(e){if(e.sourceKind==="marketplace-source")return j({url:e.installSource,ref:$,scope:"user"}),[e.name];if(e.sourceKind==="marketplace-plugin"){const[t,n]=e.installSource.split("/"),r=Xe(t);return await Re({marketplace:t,plugin:n},"user"),e.id==="capture-plugin"&&await W(),r===null?[e.name]:[r,e.name]}return await Ye(e.installSource),e.id==="crtr-extensions"&&Je(e.installSource),[e.name]}a(ee,"installSetupPackage");async function Rt(e,t=k){const n=D(),r=z(L(M()),n);for(const s of V(n,"user"))r.add(s);const o=new Map(n.map(s=>[s.id,s])),l=process.stdin.isTTY&&process.stdout.isTTY?["crtr-extensions","official-marketplace","oauth-adapter","capture-plugin","exa-search-plugin"]:["crtr-extensions","official-marketplace","capture-plugin","exa-search-plugin"];let c,u=!1;for(const s of l){const d=o.get(s);if(!r.has(s)){if(Z(d)&&(c??=!t("git"),c)){u||e("marketplace packages",new Error(Q)),u=!0;continue}try{await ee(d)}catch(h){e(d.name,h)}}}try{X(void 0,()=>{})==="unavailable"&&e("termrender renderer",new Error("unavailable \u2014 install uv"))}catch(s){e("termrender renderer",s)}return we()}a(Rt,"reconcileFirstRun");async function Dt(e,t=k){const n=[],r=[],o=[],l=[],c=new We;let u,s=!1;for(const i of e.packages){if(e.installedPackageIds.has(i.id)){if(r.push(`${i.name} (already installed)`),i.id==="capture-plugin"&&!k("capture"))try{await c.run("Capture CLI",()=>W()),n.push("Capture CLI")}catch(p){r.push(`Capture CLI (${p instanceof Error?p.message:String(p)})`)}continue}if(Z(i)&&(u??=!t("git"),u)){s||r.push(`marketplace packages (${Q})`),s=!0;continue}try{n.push(...await c.run(i.name,()=>ee(i)))}catch(p){if(i.sourceKind!=="marketplace-source"&&i.sourceKind!=="marketplace-plugin")throw p;r.push(`${i.name} (${p instanceof Error?p.message:String(p)})`)}}for(const i of e.systemDeps){if(i.installed){l.push(`${i.tool} (already installed)`);continue}if(!i.autoInstall||!i.command){l.push(`${i.tool} (${i.hint})`);continue}const p=i.command,v=p===Ce;await c.run(i.tool,N=>{if(!v||N===null)return T(p);const te=Se();return T(p,ne=>{const O=te(ne);O!==null&&N.setFraction(O/100)})}),o.push(i.tool)}const d=[];let h=!1,f;try{f=X(()=>{h=!0,c.start("termrender renderer")},i=>d.push(i))}catch(i){throw h&&await c.fail("termrender renderer",i),i}switch(f){case"provisioned":h&&await c.succeed("termrender renderer"),n.push("termrender renderer");break;case"current":r.push("termrender renderer (current)");break;case"unavailable":{const i=new I("unavailable \u2014 install uv",d.join(""));h&&await c.fail("termrender renderer",i),r.push("termrender renderer (unavailable \u2014 install uv)");break}}if(e.terminalEdit!==void 0){const i=`Option as Alt (${e.terminalEdit.path})`,p=Le(e.terminalEdit);p.ok?n.push(`${i} \u2014 ${e.terminalEdit.reload}`):r.push(`${i} (${p.message})`)}return await He(),{installed:[...n,...o],skipped:[...r,...l]}}a(Dt,"executeSetupSubmission");export{E as OFFICIAL_MARKETPLACE_NAME,$ as OFFICIAL_MARKETPLACE_REF,A as OFFICIAL_MARKETPLACE_URL,Pt as SetupKeybindingsDraft,Ct as buildSetupInitialState,D as buildSetupManifest,Ue as buildSystemInstallPlan,k as detectCommandOnPath,z as detectInstalledSetupPackageIds,Be as detectPackageManager,Dt as executeSetupSubmission,$t as formatSetupExecutionSummary,b as normalizePackageIdentity,St as packagePlanAction,Rt as reconcileFirstRun,He as reconcileInboxFrontDoor,Et as renderSetupStaticInstructions,M as resolveSettingsPath,It as setupPluginEnvFields};

package/dist/commands/sys/setup-settings-runner.d.ts

@@ -0,0 +1,13 @@
+import { ModelRegistry, ModelRuntime } from '@earendil-works/pi-coding-agent';
+import type { BindingId, BindingResolution } from '../../core/keybindings/index.js';
+import { type TuiPageContext, type TuiPageControl, type TuiPageSurface } from '../../core/tui/page-host.js';
+/** Setup and settings both edit pi's model configuration, so their host adds
+ * the model runtime to the shared page context. Every other page concern —
+ * theme, keybindings, terminal lifecycle — belongs to `runTuiPage`. */
+type SetupSettingsProcessContext = TuiPageContext & {
+    agentDir: string;
+    runtime: ModelRuntime;
+    registry: ModelRegistry;
+};
+export declare function runSetupSettingsProcess<Result>(createSurface: (context: SetupSettingsProcessContext, control: TuiPageControl<Result>) => TuiPageSurface, interceptCancel?: (data: string, bindings: BindingResolution<BindingId>) => boolean): Promise<Result | undefined>;
+export {};

package/dist/commands/sys/setup-settings-runner.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var i=(r,o)=>c(r,"name",{value:o,configurable:!0});import{ModelRegistry as d,ModelRuntime as u}from"@earendil-works/pi-coding-agent";import{join as n}from"node:path";import{piAgentDir as f}from"../../core/runtime/package-health.js";import{secretsDir as m}from"../../core/layout.js";import{PoolCredentialStore as l}from"../../core/pool-credential-store.js";import{initializeFreshScopedStore as g}from"../../core/scoped-state/migrate.js";import{runTuiPage as S}from"../../core/tui/page-host.js";async function k(r,o){const t=f();g({kind:"provider",root:m()});const e=await u.create({credentials:new l(n(m(),"auth.json")),modelsPath:n(t,"models.json")}),s=new d(e);return S((p,a)=>r({...p,agentDir:t,runtime:e,registry:s},a),o)}i(k,"runSetupSettingsProcess");export{k as runSetupSettingsProcess};

package/dist/commands/sys/setup-wizard.d.ts

@@ -0,0 +1,52 @@
+import { ModelRegistry, ModelRuntime } from '@earendil-works/pi-coding-agent';
+import { TUI, type Component, type Focusable } from '@earendil-works/pi-tui';
+import { type BindingId, type BindingResolution } from '../../core/keybindings/index.js';
+import { type SetupPackageId, type SetupPackageManifestEntry, type SetupSubmission, type SetupSystemInstallPlan } from './setup-core.js';
+import { type OptionAsAltPlan } from './terminal-option.js';
+/** The host owns step navigation, focus, submission and composition. Each step
+ *  owns its own mutable UI state. */
+export declare class SetupWizard implements Component, Focusable {
+    private readonly bindings;
+    private readonly terminalRows;
+    private readonly providers;
+    private readonly plugins;
+    private readonly pluginEnv;
+    private readonly dependencies;
+    private readonly terminal;
+    private readonly steps;
+    private step;
+    private confirming;
+    private cachedWidth;
+    private cachedHeight;
+    private cachedLines;
+    private _focused;
+    private readonly installedPackageIds;
+    onSubmit?: (submission: SetupSubmission) => void;
+    onCancel?: () => void;
+    constructor(manifest: SetupPackageManifestEntry[], installedPackageIds: Set<SetupPackageId>, systemPlans: SetupSystemInstallPlan[], tui: TUI, agentDir: string, runtime: ModelRuntime, registry: ModelRegistry, bindings: BindingResolution<BindingId>, terminalRows: () => number, existingEnvNames: Set<string>, optionPlan?: OptionAsAltPlan | null);
+    set focused(value: boolean);
+    get focused(): boolean;
+    invalidate(): void;
+    private matches;
+    private label;
+    /** Gestures safe to advertise while a text field owns the keyboard. */
+    private fieldSafeLabel;
+    private setStep;
+    private moveStep;
+    /** Enter on a non-final step walks forward; on the last one it finishes. */
+    private advance;
+    private cancel;
+    dispose(): void;
+    private hasPendingInstalls;
+    private buildSubmission;
+    private finalize;
+    private currentPanel;
+    handleInput(data: string): void;
+    /** `Providers › Plugins › Dependencies`, active step lit, done
+     *  steps checked — a first run should always show how much is left. */
+    private renderTrail;
+    private footer;
+    private renderConfirm;
+    render(width: number): string[];
+}
+export declare function runSetup(): Promise<'completed' | 'skipped'>;

package/dist/commands/sys/setup-wizard.js

@@ -0,0 +1 @@
+var P=Object.defineProperty;var p=(h,e)=>P(h,"name",{value:e,configurable:!0});import{matchesKey as b,truncateToWidth as c,visibleWidth as g}from"@earendil-works/pi-tui";import{formatGesture as v,formatMovePair as k,matchesPiTuiInput as $}from"../../core/keybindings/index.js";import{buildSetupInitialState as y,executeSetupSubmission as I,formatSetupExecutionSummary as w,packagePlanAction as A,reconcileInboxFrontDoor as x,renderSetupStaticInstructions as T,setupPluginEnvFields as C}from"./setup-core.js";import{runSetupSettingsProcess as W}from"./setup-settings-runner.js";import{DependenciesPanel as D}from"./panels/dependencies-panel.js";import{PAGE_CHROME_ROWS as L,pageFrame as F,theme as r}from"../../core/tui/panel.js";import{PluginsPanel as H}from"./panels/plugins-panel.js";import{ProviderPanel as O}from"./panels/provider-panel.js";import{PluginEnvPanel as _}from"./panels/plugin-env-panel.js";import{TerminalPanel as z}from"./panels/terminal-panel.js";import{describeEdit as M,planOptionAsAlt as N}from"./terminal-option.js";import{homedir as R}from"node:os";import{cliClient as S}from"../api-client.js";const E=["Providers","Plugins","Plugin env","Dependencies"],j="Option key";class B{static{p(this,"SetupWizard")}bindings;terminalRows;providers;plugins;pluginEnv;dependencies;terminal;steps;step=0;confirming=!1;cachedWidth;cachedHeight;cachedLines;_focused=!1;installedPackageIds;onSubmit;onCancel;constructor(e,i,s,t,n,a,u,o,m,f,d=null){this.bindings=o,this.terminalRows=m,this.installedPackageIds=i;const l=p(()=>this.invalidate(),"invalidate");this.providers=new O(t,n,a,u),this.providers.onChange=l,this.plugins=new H(e,i,l),this.pluginEnv=new _(f,l),this.dependencies=new D(s,l),this.terminal=d===null?void 0:new z(d,l),this.steps=this.terminal===void 0?E:[...E,j]}set focused(e){this._focused=e}get focused(){return this._focused}invalidate(){this.cachedWidth=void 0,this.cachedHeight=void 0,this.cachedLines=void 0}matches(e,i){return $(this.bindings,e,i,(s,t)=>b(s,t))}label(e){const i=this.bindings.gestures(e);return i.length===0?"disabled":v(i[0].split(" > ").pop())}fieldSafeLabel(e){const i=this.bindings.gestures(e).filter(s=>{if(s.includes(" > "))return!0;const t=s.split("+").pop();return!(t==="up"||t==="down"||t==="left"||t==="right")&&(t.length>1||s.includes("+"))});return i.length===0?"Disabled":i.map(v).join(" / ")}setStep(e){e===2&&this.step!==2&&this.pluginEnv.setFields(C(this.plugins.selected)),this.step=e,this.invalidate()}moveStep(e){this.setStep((this.step+e+this.steps.length)%this.steps.length)}advance(){this.step===this.steps.length-1?this.finalize():(this.step!==2||this.pluginEnv.complete)&&this.moveStep(1)}cancel(){if(this.confirming){this.confirming=!1,this.invalidate();return}this.onCancel?.()}dispose(){this.providers.dispose()}hasPendingInstalls(){return this.plugins.selected.some(e=>!this.installedPackageIds.has(e.id))||this.dependencies.selected.length>0||this.terminal?.selectedEdit!==void 0}buildSubmission(){return{packages:[...this.plugins.selected],installedPackageIds:new Set(this.installedPackageIds),systemDeps:[...this.dependencies.selected],pluginEnv:new Map(this.pluginEnv.values),...this.terminal?.selectedEdit===void 0?{}:{terminalEdit:this.terminal.selectedEdit}}}finalize(){if(this.confirming||!this.hasPendingInstalls()){this.onSubmit?.(this.buildSubmission());return}this.confirming=!0,this.invalidate()}currentPanel(){return this.step===0?this.providers:this.step===1?this.plugins:this.step===2?this.pluginEnv:this.step===3?this.dependencies:this.terminal}handleInput(e){const i=this.currentPanel(),s=p((n,a)=>this.matches(n,a),"match");if(this.step===0&&this.providers.isNestedFlowActive()){i.handleInput(e,s)&&this.invalidate();return}if(this.confirming){this.matches("crtr.setup.confirm.accept",e)?this.onSubmit?.(this.buildSubmission()):this.matches("crtr.setup.confirm.back",e)&&(this.confirming=!1,this.invalidate());return}if(this.step===2&&this.pluginEnv.handleInput(e)){this.invalidate();return}if(this.matches("crtr.setup.cancel",e)){this.cancel();return}if(this.matches("crtr.setup.tab-next",e)){if(this.step===2&&!this.pluginEnv.complete)return;this.moveStep(1);return}if(this.matches("crtr.setup.tab-previous",e)){this.moveStep(-1);return}if(i.handleInput(e,s)){this.invalidate();return}this.matches("crtr.setup.advance",e)&&this.advance()}renderTrail(e){const s=this.steps.map((t,n)=>{if(n===this.step)return r.bg("selectedBg",` ${n+1} ${t} `);const a=n<this.step?r.fg("success","\u2713"):`${n+1}`;return r.fg("dim",` ${a} ${t} `)}).join(r.fg("dim","\u203A"));return g(s)<=e?[c(s,e),""]:[c(`${r.fg("dim",`Step ${this.step+1} of ${this.steps.length}`)}  ${r.fg("accent",r.bold(this.steps[this.step]))}`,e),""]}footer(e){const i=`${this.fieldSafeLabel("crtr.setup.tab-next")}/${this.fieldSafeLabel("crtr.setup.tab-previous")} step \xB7 ${this.label("crtr.setup.cancel")} cancel`,s=k(this.bindings,"crtr.setup.list-down","crtr.setup.list-up");let t;this.confirming?t=`${this.label("crtr.setup.confirm.accept")} confirm \xB7 ${this.label("crtr.setup.confirm.back")} go back`:this.step===0?t=this.providers.isNestedFlowActive()?"OAuth in progress \xB7 esc cancel":`${s} select \xB7 a add \xB7 p prefer \xB7 r rename \xB7 l re-login \xB7 x remove \xB7 ${this.label("crtr.setup.advance")} next`:this.step===1?t=`${s} move \xB7 ${this.label("crtr.setup.toggle")} toggle \xB7 ${this.label("crtr.setup.details")} details \xB7 ${this.label("crtr.setup.advance")} next`:this.step===2?t=`type value \xB7 Enter save/skip \xB7 ${this.pluginEnv.complete?`${this.label("crtr.setup.advance")} next`:"complete keys to continue"}`:this.step===3?t=`${s} move \xB7 ${this.label("crtr.setup.toggle")} toggle \xB7 ${this.label("crtr.setup.advance")} ${this.steps.length>4?"next":"finish"}`:t=`${this.terminal?.canApply?`${this.label("crtr.setup.toggle")} apply for me \xB7 `:""}${this.label("crtr.setup.advance")} finish`;const n=e-g(t)-g(i);return n>=2?`${r.fg("dim",t)}${" ".repeat(n)}${r.fg("dim",i)}`:r.fg("dim",t)}renderConfirm(e){const i=this.buildSubmission(),s=[c(r.fg("warning",r.bold("Confirm installs")),e),""];if(i.packages.length===0&&i.systemDeps.length===0&&i.terminalEdit===void 0)return[...s,c(r.fg("success",`Nothing to install; ${this.label("crtr.setup.confirm.accept")} finish.`),e)];if(i.packages.length){s.push(c(r.fg("accent","Packages"),e));for(const t of i.packages)s.push(c(`  \u2022 ${t.name} ${r.fg("dim","\u2192")} ${this.installedPackageIds.has(t.id)?r.fg("success","skip (already installed)"):r.fg("muted",A(t))}`,e))}if(i.systemDeps.length){s.push(c(r.fg("accent","System deps"),e));for(const t of i.systemDeps)s.push(c(`  \u2022 ${t.tool} ${r.fg("dim","\u2192")} ${r.fg("muted",t.command??t.hint)}`,e))}if(i.terminalEdit!==void 0){s.push(c(r.fg("accent","Terminal config"),e));for(const t of M(i.terminalEdit))s.push(c(r.fg("muted",`  ${t}`),e))}return s}render(e){const i=this.step===0,s=this.terminalRows();if(!i&&this.cachedLines&&this.cachedWidth===e&&this.cachedHeight===s)return this.cachedLines;const t=this.currentPanel(),n=Math.max(1,s-L),a=this.confirming||n<=2?[]:this.renderTrail(e),u=Math.max(1,n-a.length),o=F({width:e,height:s,title:"crouter setup",meta:this.confirming?"review":`step ${this.step+1} of ${this.steps.length}`,body:[...a,...this.confirming?this.renderConfirm(e):t.render(e,u)],footer:this.footer(e)});return i||(this.cachedWidth=e,this.cachedHeight=s,this.cachedLines=o),o}}function G(){process.stdout.write("\x1B[2J\x1B[H")}p(G,"clearWizardFrame");async function re(){const h=y();let e=!1;if(await x(),!process.stdout.isTTY)return process.stdout.write(T(h)),"skipped";const i=new Set((await S().listAppEnv()).names),s=await W(({tui:n,terminal:a,agentDir:u,runtime:o,registry:m,bindings:f},d)=>{const l=new B(h.manifest,h.installedPackageIds,h.systemPlans,n,u,o,m,f,()=>a.rows,i,N({env:process.env,platform:process.platform,home:R()}));return l.onCancel=d.cancel,l.onSubmit=d.submit,l},(n,a)=>n===""?(e=!0,!0):n.length>0&&n.charCodeAt(0)<32&&$(a,"crtr.setup.cancel",n,(u,o)=>b(u,o)));if(G(),e){const n=new Error("Interrupted");throw n.name="AbortError",n}if(s===void 0)return"skipped";for(const[n,a]of s.pluginEnv)await S().setAppEnv(n,a);const t=await I(s);return process.stdout.write(w(t)),"completed"}p(re,"runSetup");export{B as SetupWizard,re as runSetup};

package/dist/commands/sys/setup.d.ts

@@ -0,0 +1,6 @@
+import type { LeafDef } from '../../core/command.js';
+/** Shared with the wizard's own limits tab, which imports it back from here —
+ *  keeping it in this cheap module is what lets the leaf's help text state the
+ *  precedence rule without loading the wizard. */
+export declare const BROKER_LIMIT_OVERRIDE_PRECEDENCE = "Valid CRTR_WARN_LIVE_BROKERS and CRTR_MAX_LIVE_BROKERS environment overrides take precedence over their corresponding configured limits.";
+export declare const sysSetupLeaf: LeafDef;

package/dist/commands/sys/setup.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var t=(e,n)=>a(e,"name",{value:n,configurable:!0});import{defineLeaf as s}from"../../core/command.js";const o="Valid CRTR_WARN_LIVE_BROKERS and CRTR_MAX_LIVE_BROKERS environment overrides take precedence over their corresponding configured limits.",c=s({name:"setup",description:"bootstrap a fresh machine \u2014 provider login, companion packages, system dependencies",whenToUse:"you need to re-run the first-launch installer \u2014 sign in to another provider, add companion packages or system dependencies, or repair package paths. A person never needs it to get started: the first bare `crtr` in a terminal opens this installer itself. Use sys settings to change configuration on an installed machine, and sys config set for scriptable edits.",help:{name:"sys setup",summary:"reopen the installer bare `crtr` runs on first launch: provider login, companion packages, system dependencies",inputNote:"No input parameters.",output:[],outputKind:"object",effects:["Opens a three-step pi-tui installer. Step one logs in to a model provider (pi's real OAuth/API-key flow, same as in-app /login) so a fresh install has credentials before running any node.","The remaining steps collect companion package installs and system dependency installs, then confirm them all at once.","On macOS, a final step detects the terminal and explains how to make Option act as Alt (crouter's menu is Alt+C). Where the setting is safely scriptable (Ghostty, stock VS Code) it can write the one line for you, but only if you tick it and after showing exactly what will be written.","Runs the bundled pi CLI to install the selected companion packages and prints a summary.","The companion-package list includes the official crtr marketplace and the plugins installed from it (currently `capture` and `exa-search`), all checked by default and registered or installed into the user scope when left checked. Nothing else registers a marketplace, so an install that never runs setup fetches no catalog. An unreachable marketplace is reported as skipped rather than failing setup. Vendor credentials belong to the plugin that needs them, never to setup.","In a terminal, records setup as done (the same record the first bare `crtr` writes), so the next bare `crtr` boots a conversation instead of reopening the installer, and offers the tutorial if no conversation has started since setup first ran.","On every invocation (best-effort, idempotent), refreshes crouter-owned tmux bindings and registers known nodes' interaction roots so resolved tickets can call back into the asking node. The inbox popup toggle is a crouter-owned keybinding, editable on the keybindings tab."]},run:t(async()=>{const e=await(await import("./setup-wizard.js")).runSetup();process.stdout.isTTY&&await(await import("../../core/runtime/setup-marker.js")).recordSetupCompleted(e)},"run"),render:t(()=>"","render")});export{o as BROKER_LIMIT_OVERRIDE_PRECEDENCE,c as sysSetupLeaf};

package/dist/commands/sys/shared.d.ts

@@ -0,0 +1,51 @@
+import type { Scope } from '../../types.js';
+export declare const PKG_ROOT: string;
+interface ManifestFile {
+    path: string;
+    size: number;
+    sha256: string;
+    symlink?: boolean;
+}
+export interface RuntimeManifest {
+    id: string;
+    packageVersion: string;
+    files: ManifestFile[];
+    entries: Record<string, string>;
+}
+interface RuntimeManifestModule {
+    GENERATION_ID: RegExp;
+    runtimeHome(): string;
+    contained(root: string, candidate: string): boolean;
+    parseSelectionTarget(target: string): string | null;
+    sortInventory(files: ManifestFile[]): ManifestFile[];
+    validateManifestShape(manifest: unknown, context: {
+        id: string;
+        entryName: string;
+    }): {
+        ok: true;
+        entry: string;
+    } | {
+        ok: false;
+        error: string;
+    };
+}
+export declare const runtimeManifest: RuntimeManifestModule;
+export interface GenerationLocation {
+    id: string;
+    root: string;
+}
+export interface LocatedGeneration extends GenerationLocation {
+    manifest: RuntimeManifest;
+}
+export interface GenerationLookup {
+    generation: LocatedGeneration | null;
+    error: string | null;
+}
+/** Find the immutable generation containing this loaded module, if any. */
+export declare function processGeneration(): GenerationLocation | null;
+/** Read the selected symlink without treating an absent runtime as an exception in a source checkout. */
+export declare function selectedGeneration(): GenerationLookup;
+export declare function processLocatedGeneration(): GenerationLookup;
+export declare function readPackageVersion(): string;
+export declare function resolveScope(raw: string | undefined): Scope;
+export {};

package/dist/commands/sys/shared.js

@@ -0,0 +1 @@
+var y=Object.defineProperty;var n=(e,t)=>y(e,"name",{value:t,configurable:!0});import{existsSync as S,lstatSync as l,readFileSync as p,readlinkSync as h,realpathSync as x}from"node:fs";import{basename as f,dirname as o,join as i,resolve as j}from"node:path";import{fileURLToPath as k,pathToFileURL as b}from"node:url";import{usage as G}from"../../core/errors.js";const g=k(import.meta.url);function O(){for(let e=o(g);;e=o(e)){if(S(i(e,"bin","runtime-generation-manifest.mjs")))return e;if(o(e)===e)throw new Error("cannot locate crouter package root")}}n(O,"packageRoot");const m=O(),s=await import(b(i(m,"bin","runtime-generation-manifest.mjs")).href);function v(){for(let e=o(g);;e=o(e)){const t=o(e),r=f(e);if(f(t)==="generations"&&s.GENERATION_ID.test(r))return{id:r,root:e};if(t===e)return null}}n(v,"processGeneration");function d(e,t){try{const r=x(e);if(!l(e).isDirectory()||l(e).isSymbolicLink())return{generation:null,error:`${e} is not a generation directory`};const a=JSON.parse(p(i(r,"generation.json"),"utf8"));return{generation:{id:t,root:r,manifest:a},error:null}}catch(r){return{generation:null,error:r instanceof Error?r.message:String(r)}}}n(d,"locateGeneration");function L(){const e=s.runtimeHome(),t=i(e,"selected");let r;try{r=h(t)}catch{return{generation:null,error:`no selected runtime generation (${t} is absent)`}}const a=s.parseSelectionTarget(r);if(!a)return{generation:null,error:`selected target is invalid: ${JSON.stringify(r)}`};const c=i(e,"generations"),u=j(e,r);return s.contained(c,u)?d(u,a):{generation:null,error:`selected target escapes ${c}`}}n(L,"selectedGeneration");function P(){const e=v();return e===null?{generation:null,error:"no process generation (development checkout)"}:d(e.root,e.id)}n(P,"processLocatedGeneration");function J(){const e=p(i(m,"package.json"),"utf8");return JSON.parse(e).version}n(J,"readPackageVersion");function D(e){if(e===void 0)return"user";if(e==="user"||e==="project")return e;throw G(`scope must be 'user' or 'project', got: ${e}`)}n(D,"resolveScope");export{m as PKG_ROOT,v as processGeneration,P as processLocatedGeneration,J as readPackageVersion,D as resolveScope,s as runtimeManifest,L as selectedGeneration};

package/dist/commands/sys/spaces.d.ts

@@ -0,0 +1 @@
+export declare const sysSpacesLeaf: import("../../core/command.js").LeafDef;

package/dist/commands/sys/spaces.js

@@ -0,0 +1,2 @@
+var t=Object.defineProperty;var a=(s,e)=>t(s,"name",{value:e,configurable:!0});import{defineLeaf as p}from"../../core/command.js";import{cliClient as c}from"../api-client.js";import{formatSize as i}from"./worktrees.js";const m=p({name:"spaces",description:"list every space on the runtime with its size",whenToUse:"you need to see how much disk the person's space and each app's space occupy on this runtime",help:{name:"sys spaces",summary:"list the person's space and every app space with its size",params:[],output:[{name:"spaces",type:"SpaceDTO[]",required:!0,constraint:"`user` first, then each app space by id. Each record: {space, path, size_bytes}; size_bytes is null when the space cannot be measured."}],outputKind:"object",effects:["None. Read-only."]},run:a(async()=>({spaces:(await c().listSpaces()).spaces}),"run"),render:a(s=>s.spaces.map(e=>`- \`${e.space}\` \u2014 ${i(e.size_bytes)} \xB7 \`${e.path}\``).join(`
+`),"render")});export{m as sysSpacesLeaf};

package/dist/commands/sys/support/prepare.d.ts

@@ -0,0 +1,13 @@
+import type { LeafDef } from '../../../core/command.js';
+export interface SupportPrepareResult {
+    status: 'prepared';
+    reference: string;
+    path: string;
+    node_id: string;
+    source_count: number;
+    bytes: number;
+}
+/** Output-free: collects and writes the prepared artifact and returns a
+ *  small result. Never prints; the leaf below owns argv/rendering. */
+export declare function prepareSupportBundle(nodeId: string): SupportPrepareResult;
+export declare const supportPrepareLeaf: LeafDef;

package/dist/commands/sys/support/prepare.js

@@ -0,0 +1,3 @@
+var _=Object.defineProperty;var u=(t,n)=>_(t,"name",{value:n,configurable:!0});import{randomBytes as T}from"node:crypto";import{closeSync as v,constants as m,fstatSync as w,lstatSync as x,mkdirSync as y,openSync as N,readSync as E,rmSync as j,writeFileSync as g}from"node:fs";import{join as l,relative as M}from"node:path";import{defineLeaf as B}from"../../../core/command.js";import{general as C,usage as h}from"../../../core/errors.js";import{crtrHome as O,isSafeNodeId as R,jobDir as $}from"../../../core/canvas/paths.js";import{MAX_EVENT_RECORD_BYTES as D}from"../../../core/events/serialize.js";import{readLogSnapshot as U}from"../../../core/events/read.js";import{userScopeRoot as A}from"../../../core/scope.js";const k="manifest.json",F="bundle.jsonl",b=2097152,L=D-1,re=["events","runtime_state","raw_residue"];function f(t,n){return String(t).padStart(n,"0")}u(f,"pad");function Y(t){const n=`${t.getUTCFullYear()}${f(t.getUTCMonth()+1,2)}${f(t.getUTCDate(),2)}`,r=`${f(t.getUTCHours(),2)}${f(t.getUTCMinutes(),2)}${f(t.getUTCSeconds(),2)}${f(t.getUTCMilliseconds(),3)}`;return`${n}T${r}Z-${T(4).toString("hex")}`}u(Y,"generateReference");function S(t){return Buffer.from(`${JSON.stringify(t)}
+`,"utf8")}u(S,"compactLine");function z(t,n){const r=U({nodeId:t},!0),s=[];for(const e of r.items){const o=e.kind==="event"?"events":"raw_residue",i=e.kind==="event"?e.envelope.ts:new Date(e.effectiveTsMs).toISOString(),a=e.kind==="event"?e.envelope:e.content,c=n.get(e.source);c===void 0?n.set(e.source,{category:o,status:"read",truncated:e.truncated}):e.truncated&&(c.truncated=!0),s.push({source:e.source,line:S({category:o,source:e.source,ts:i,content:a})})}return s.reverse()}u(z,"collectSnapshotRecords");function q(t,n){let r;try{r=x(t)}catch(e){return e.code==="ENOENT"?{status:"absent",truncated:!1}:{status:"unreadable",truncated:!1}}if(r.isSymbolicLink()||!r.isFile())return{status:"unreadable",truncated:!1};let s;try{s=N(t,m.O_RDONLY|m.O_NOFOLLOW)}catch{return{status:"unreadable",truncated:!1}}try{const e=w(s);if(!e.isFile()||e.dev!==r.dev||e.ino!==r.ino)return{status:"raced",truncated:!1};if(!Number.isSafeInteger(e.size)||e.size<0)return{status:"unreadable",truncated:!1};const o=Math.min(e.size,n),i=Buffer.alloc(o);let a=0;for(;a<o;){const d=E(s,i,a,o-a,a);if(d<=0)return{status:"unreadable",truncated:!1};a+=d}let c;try{c=JSON.parse(i.toString("utf8"))}catch{c=i.toString("utf8")}return{status:"read",truncated:e.size>n,content:c}}finally{try{v(s)}catch{}}}u(q,"readFixedStateFile");function H(t,n,r){const s=$(t),e=O(),o=[];for(const i of["fault","telemetry.json"]){const a=l(s,i),c=M(e,a),d=q(a,L);r.set(c,{category:"runtime_state",status:d.status,truncated:d.truncated}),d.status==="read"&&o.push({source:c,line:S({category:"runtime_state",source:c,ts:n,content:d.content})})}return o}u(H,"collectRuntimeState");function I(t,n){const r={reference:t.reference,created_at:t.created_at,node_id:t.node_id,sources:[...n.entries()].map(([s,e])=>({source:s,category:e.category,status:e.status,truncated:e.truncated}))};return Buffer.from(`${JSON.stringify(r)}
+`,"utf8")}u(I,"renderManifestBuffer");function J(t,n,r){const s=t.slice();for(;;){const e=I(r,n),o=Buffer.concat(s.map(c=>c.line));if(e.length+o.length<=b)return{manifestBuffer:e,bundleBuffer:o};if(s.length===0)throw C(`prepared support manifest alone exceeds the ${b}-byte cap`);const i=s.pop(),a=n.get(i.source);a!==void 0&&(a.truncated=!0)}}u(J,"fitToCap");function P(t){if(typeof t!="string"||!R(t))throw h("node_id must be a safe, non-empty single path segment of at most 128 UTF-8 bytes.");const n=l(A(),"support");y(n,{recursive:!0});const r=Y(new Date),s=l(n,r);y(s);try{const e=new Date().toISOString(),o=new Map,i=H(t,e,o),a=z(t,o),c=[...i,...a],{manifestBuffer:d,bundleBuffer:p}=J(c,o,{reference:r,created_at:e,node_id:t});return g(l(s,k),d,{flag:"wx"}),g(l(s,F),p,{flag:"wx"}),{status:"prepared",reference:r,path:s,node_id:t,source_count:o.size,bytes:d.length+p.length}}catch(e){throw j(s,{recursive:!0,force:!0}),e}}u(P,"prepareSupportBundle");const se=B({name:"prepare",description:"locally collect one node\u2019s diagnostics into a bounded support bundle (zero egress)",whenToUse:"you want to hand a maintainer diagnostics for one node without exposing anything beyond that node\u2019s canonical events, current fault/telemetry state, and residue mentioning it. This step never leaves the machine; run `crtr sys support submit <reference>` afterward to actually share it.",help:{name:"sys support prepare",summary:"locally collect one node\u2019s bounded diagnostics into ~/.crouter/support/<reference>/manifest.json + bundle.jsonl",params:[{kind:"positional",name:"node_id",required:!0,constraint:"The node to collect diagnostics for \u2014 a safe, non-empty single path segment."}],output:[{name:"reference",type:"string",required:!0,constraint:"Generated YYYYMMDDTHHmmssSSSZ-xxxxxxxx \u2014 pass this to `crtr sys support submit`."},{name:"path",type:"string",required:!0,constraint:"Absolute path to the new ~/.crouter/support/<reference>/ directory."},{name:"source_count",type:"number",required:!0,constraint:"Number of distinct sources declared in the manifest."},{name:"bytes",type:"number",required:!0,constraint:"Combined size of manifest.json + bundle.jsonl, always \u2264 2,097,152."}],outputKind:"object",effects:["Reads only local diagnostic sources for node_id: canonical events (node-relevant across daemon/broker/web), current job/fault and job/telemetry.json, and broker/daemon raw residue mentioning the node.","Creates a new ~/.crouter/support/<reference>/ directory containing exactly manifest.json and bundle.jsonl, bounded to 2,097,152 combined bytes; removes that directory if preparation fails partway.","Performs no network, DNS, gh, or repository access \u2014 the bundle stays entirely local until an explicit `crtr sys support submit <reference>`."]},run:u(async t=>{const n=t.node_id;if(n===void 0||n==="")throw h("node_id is required. Run `crtr sys support prepare -h`.");const r=P(n);return{reference:r.reference,path:r.path,source_count:r.source_count,bytes:r.bytes}},"run")});export{P as prepareSupportBundle,se as supportPrepareLeaf};

package/dist/commands/sys/support/submit.d.ts

@@ -0,0 +1,19 @@
+import type { LeafDef } from '../../../core/command.js';
+export interface GhRunResult {
+    code: number | null;
+    stdout: Buffer;
+    stderr: string;
+    error?: Error;
+    /** HTTP status parsed from `gh api --include`; absent is deliberately indeterminate. */
+    httpStatus?: number;
+}
+export type GhRunner = (args: string[], input?: Buffer) => GhRunResult;
+export declare function defaultGhRunner(args: string[], input?: Buffer): GhRunResult;
+export interface SubmitResult {
+    status: 'submitted';
+    reference: string;
+    repository: string;
+    url: string;
+}
+export declare function submitPreparedBundle(reference: string, env: NodeJS.ProcessEnv, ghRunner?: GhRunner): Promise<SubmitResult>;
+export declare const supportSubmitLeaf: LeafDef;

package/dist/commands/sys/support/submit.js

@@ -0,0 +1,6 @@
+var J=Object.defineProperty;var c=(t,r)=>J(t,"name",{value:r,configurable:!0});import{spawnSync as G}from"node:child_process";import{randomBytes as Z}from"node:crypto";import{closeSync as W,constants as y,fstatSync as x,fsyncSync as V,lstatSync as R,openSync as A,readdirSync as K,readSync as X,realpathSync as Q,renameSync as tt,unlinkSync as et,writeSync as rt}from"node:fs";import{basename as ot,dirname as nt,join as S}from"node:path";import{defineLeaf as st}from"../../../core/command.js";import{general as i,network as m,notFound as _,usage as O}from"../../../core/errors.js";import{userScopeRoot as it}from"../../../core/scope.js";const f="manifest.json",l="bundle.jsonl",T="submitted.json",g=2097152,at=/^\d{8}T\d{9}Z-[0-9a-f]{8}$/,E=/^([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+)$/,ct=/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/,k=["events","runtime_state","raw_residue"],L=["absent","read","unreadable","raced"],ut=8*1024*1024;function dt(t){const r=t.indexOf(`\r
+\r
+`),o=t.indexOf(`
+
+`),e=r>=0?r:o;if(e<0)return{body:t};const s=r>=0?4:2,n=t.subarray(0,e).toString("ascii"),a=/^HTTP\/\S+ ([0-9]{3})(?: |\r?$)/m.exec(n);return a===null?{body:t}:{body:t.subarray(e+s),httpStatus:Number(a[1])}}c(dt,"splitIncludedResponse");function j(t,r){const o=G("gh",t,{input:r,maxBuffer:ut,env:{...process.env,GH_HOST:"github.com"}});if(o.error!==void 0)return{code:null,stdout:Buffer.alloc(0),stderr:"",error:o.error};const e=Buffer.isBuffer(o.stdout)?o.stdout:Buffer.from(String(o.stdout??""),"utf8"),s=Buffer.isBuffer(o.stderr)?o.stderr.toString("utf8"):String(o.stderr??""),n=t.includes("--include")?dt(e):{body:e,httpStatus:void 0};return{code:o.status,stdout:n.body,stderr:s,httpStatus:n.httpStatus}}c(j,"defaultGhRunner");function b(t){try{W(t)}catch{}}c(b,"closeSafe");function $(t,r){return t.dev===r.dev&&t.ino===r.ino}c($,"sameIdentity");function P(t){const r=x(t.fd);let o;try{o=R(t.path)}catch(e){throw i(`${t.path} identity changed since it was opened: ${e.message}`)}if(!r.isDirectory()||!$(r,t)||o.isSymbolicLink()||!o.isDirectory()||!$(o,t))throw i(`${t.path} identity changed since it was opened \u2014 refusing further access`)}c(P,"reconfirmDir");function C(t){let r;try{r=R(t)}catch(e){throw _(`${t} does not exist: ${e.message}`)}if(r.isSymbolicLink()||!r.isDirectory())throw i(`${t} must be a real, non-symlink directory`);const o=A(t,y.O_RDONLY|y.O_DIRECTORY|y.O_NOFOLLOW);try{const e=x(o);if(!e.isDirectory()||!$(e,r))throw i(`${t} identity changed while it was opened`);return{path:t,realPath:Q(t),fd:o,dev:e.dev,ino:e.ino}}catch(e){throw b(o),e}}c(C,"openSafeDirectory");function M(t,r){P(t);const o=S(t.path,r);let e;try{e=R(o)}catch(n){throw _(`${o} does not exist: ${n.message}`)}if(e.isSymbolicLink()||!e.isFile())throw i(`${o} must be a regular, non-symlink file`);const s=A(o,y.O_RDONLY|y.O_NOFOLLOW);try{const n=x(s);if(!n.isFile()||!$(n,e))throw i(`${o} identity changed while it was opened`);if(!Number.isSafeInteger(n.size)||n.size<0||n.size>g)throw i(`${r} size ${n.size} is outside the allowed 0..${g}-byte range`);return{path:o,fd:s,dev:n.dev,ino:n.ino,size:n.size,mtimeMs:n.mtimeMs,ctimeMs:n.ctimeMs}}catch(n){throw b(s),n}}c(M,"openSafeFile");function v(t){const r=Buffer.alloc(t.size);let o=0;for(;o<r.length;){const e=X(t.fd,r,o,r.length-o,o);if(e<=0)throw i(`${t.path} could not be read in full`);o+=e}return r}c(v,"readAll");function F(t){const r=x(t.fd);let o;try{o=R(t.path)}catch{return!1}return r.size===t.size&&r.mtimeMs===t.mtimeMs&&r.ctimeMs===t.ctimeMs&&$(r,t)&&!o.isSymbolicLink()&&o.isFile()&&$(o,t)}c(F,"unchanged");function U(t){P(t);const r=K(t.path,{withFileTypes:!0}),o=new Set;for(const e of r){if(e.name!==f&&e.name!==l&&e.name!==T)throw i(`unexpected entry in prepared bundle directory: ${e.name}`);if(!e.isFile())throw i(`${e.name} must be a regular file, not a directory or symlink`);o.add(e.name)}if(!o.has(f))throw _(`prepared bundle directory is missing ${f}`);if(!o.has(l))throw _(`prepared bundle directory is missing ${l}`)}c(U,"checkEntries");function ft(t){const r=S(it(),"support");let o;try{o=C(r)}catch(e){throw _(`no trustworthy support root at ${r} \u2014 run \`crtr sys support prepare\` first: ${e.message}`)}try{P(o);const e=C(S(o.path,t));if(nt(e.realPath)!==o.realPath||ot(e.realPath)!==t)throw b(e.fd),i(`prepared bundle directory for ${t} is not directly contained in the opened support root`);return{root:o,dir:e}}catch(e){throw b(o.fd),e}}c(ft,"openReference");function N(t,r,o){const e=Object.keys(t).sort(),s=[...r].sort();if(e.length!==s.length||e.some((n,a)=>n!==s[a]))throw i(`${o} has an unexpected set of fields: ${e.join(",")}`)}c(N,"exactKeySet");function B(t,r){if(typeof t!="string"||!ct.test(t)||!Number.isFinite(Date.parse(t)))throw i(`${r} must be a valid finite ISO timestamp`);return t}c(B,"isoTimestamp");function lt(t,r){if(typeof t!="string"||t===""||t==="."||t===".."||Buffer.byteLength(t)>128||/[\\/\0]/.test(t))throw i(`${r} is not a safe node identifier`);return t}c(lt,"safeNodeId");function z(t,r){if(typeof t!="string"||t===""||t.startsWith("/")||t.includes("\\")||t.includes("\0"))throw i(`${r} must be a nonempty relative slash path`);if(t.split("/").some(e=>e===""||e==="."||e===".."))throw i(`${r} contains an unsafe path segment`);return t}c(z,"safeSourceLabel");function D(t,r){if(typeof t!="string"||!k.includes(t))throw i(`${r} must be one of ${k.join(", ")}`);return t}c(D,"categoryValue");function ht(t,r){if(typeof t!="string"||!L.includes(t))throw i(`${r} must be one of ${L.join(", ")}`);return t}c(ht,"statusValue");function mt(t,r){let o;try{o=JSON.parse(t.toString("utf8"))}catch(d){throw i(`${f} is not valid JSON: ${d.message}`)}if(typeof o!="object"||o===null||Array.isArray(o))throw i(`${f} must be a JSON object`);const e=o;if(N(e,["reference","created_at","node_id","sources"],f),e.reference!==r)throw i(`${f} reference does not match ${r}`);const s=B(e.created_at,`${f} created_at`),n=lt(e.node_id,`${f} node_id`);if(!Array.isArray(e.sources))throw i(`${f} sources must be an array`);const a=[],u=new Set;for(let d=0;d<e.sources.length;d+=1){const h=e.sources[d];if(typeof h!="object"||h===null||Array.isArray(h))throw i(`${f} sources[${d}] must be an object`);const p=h;N(p,["source","category","status","truncated"],`${f} sources[${d}]`);const w=z(p.source,`${f} sources[${d}].source`);if(u.has(w))throw i(`${f} contains duplicate source ${w}`);u.add(w);const Y=D(p.category,`${f} sources[${d}].category`),q=ht(p.status,`${f} sources[${d}].status`);if(typeof p.truncated!="boolean")throw i(`${f} sources[${d}].truncated must be a boolean`);a.push({source:w,category:Y,status:q,truncated:p.truncated})}return{reference:r,created_at:s,node_id:n,sources:a}}c(mt,"parseManifest");function pt(t,r){const o=new Map(r.sources.map(s=>[s.source,s]));let e=0;for(;e<t.length;){const s=t.indexOf(10,e);if(s<0)throw i(`${l} contains an unterminated record`);const n=t.subarray(e,s);if(n.length===0||s+1-e>g)throw i(`${l} contains an empty or oversized record`);let a;try{a=JSON.parse(n.toString("utf8"))}catch(w){throw i(`${l} contains invalid JSON: ${w.message}`)}if(typeof a!="object"||a===null||Array.isArray(a))throw i(`${l} record must be an object`);const u=a;N(u,["category","source","ts","content"],`${l} record`);const d=D(u.category,`${l} record category`),h=z(u.source,`${l} record source`);B(u.ts,`${l} record ts`);const p=o.get(h);if(p===void 0||p.category!==d)throw i(`${l} record references an undeclared manifest source or mismatched category`);e=s+1}}c(pt,"validateBundle");function yt(t,r,o){if(t.length===0||t.at(-1)!==10)throw i(`${f} must be nonempty and LF-terminated`);if(r.length>0&&r.at(-1)!==10)throw i(`${l} must be LF-terminated when nonempty`);if(t.length+r.length>g)throw i(`combined prepared bytes exceed the ${g}-byte cap`);const e=mt(t,o);pt(r,e)}c(yt,"validatePreparedArtifact");function bt(t){const r=t.CRTR_SUPPORT_REPO;if(typeof r!="string")throw O('CRTR_SUPPORT_REPO must be set to exactly "owner/name" \u2014 there is no default or public destination.');const o=E.exec(r);if(o===null)throw O(`CRTR_SUPPORT_REPO must be exactly "owner/name"; got ${JSON.stringify(r)}.`);return{owner:o[1],name:o[2]}}c(bt,"requireSupportRepo");function gt(t){const r=t(["auth","status","--hostname","github.com"]);if(r.error!==void 0)throw m(`gh CLI is not available: ${r.error.message}`);if(r.code!==0)throw m(`gh is not authenticated for github.com: ${r.stderr.trim()||"gh auth status failed"}`)}c(gt,"requireGhAuth");function wt(t,r){const o=t(["api","--hostname","github.com",`repos/${r.owner}/${r.name}`]);if(o.error!==void 0)throw m(`gh repository lookup failed: ${o.error.message}`);if(o.code!==0)throw m(`could not read repository metadata: ${o.stderr.trim()||`gh exited ${o.code}`}`);let e;try{e=JSON.parse(o.stdout.toString("utf8"))}catch(a){throw m(`repository metadata was not valid JSON: ${a.message}`)}if(typeof e!="object"||e===null||Array.isArray(e))throw m("repository metadata was not an object");const s=e;if(s.private!==!0)throw O("CRTR_SUPPORT_REPO must resolve to a repository proven private on github.com.");if(typeof s.full_name!="string"||typeof s.html_url!="string"||typeof s.default_branch!="string"||s.default_branch.length===0||s.default_branch.length>255||/[\0-\x1f\x7f]/.test(s.default_branch))throw m("repository metadata lacks a valid canonical full_name, html_url, or default_branch");const n=E.exec(s.full_name);if(n===null||s.full_name.toLowerCase()!==`${r.owner}/${r.name}`.toLowerCase())throw m("repository metadata did not prove the requested canonical repository identity");if(s.html_url!==`https://github.com/${s.full_name}`)throw m("repository metadata did not prove a canonical github.com URL");return{owner:n[1],name:n[2],fullName:s.full_name,htmlUrl:s.html_url,defaultBranch:s.default_branch}}c(wt,"requirePrivateRepo");function I(t,r,o){const e=t(["api","--hostname","github.com","--include",`repos/${r.owner}/${r.name}/contents/${o}`,"-H","Accept: application/vnd.github.raw"]);return e.error!==void 0?{kind:"ambiguous",detail:e.error.message}:e.code===0&&e.httpStatus===200?{kind:"found",bytes:e.stdout}:e.code!==0&&e.httpStatus===404?{kind:"absent"}:{kind:"ambiguous",detail:`HTTP ${e.httpStatus??"unknown"}; ${e.stderr.trim()||`gh exited ${e.code}`}`}}c(I,"rawGet");function $t(t,r,o,e,s){const n=Buffer.from(JSON.stringify({message:s,content:e.toString("base64")}),"utf8"),a=t(["api","--hostname","github.com","--method","PUT",`repos/${r.owner}/${r.name}/contents/${o}`,"--input","-"],n);if(a.error!==void 0)throw m(`gh PUT failed for ${o}: ${a.error.message}`);if(a.code!==0)throw m(`gh PUT rejected ${o}: ${a.stderr.trim()||`gh exited ${a.code}`}`)}c($t,"putContent");function H(t,r,o,e,s){const n=`support/${o}/${e}`,a=I(t,r,n);if(a.kind==="found"){if(a.bytes.equals(s))return;throw i(`remote ${n} already exists with different content \u2014 refusing to overwrite`)}if(a.kind==="ambiguous")throw m(`could not determine whether remote ${n} exists: ${a.detail}`);$t(t,r,n,s,`support: add ${e} for ${o}`);const u=I(t,r,n);if(u.kind!=="found")throw m(`post-upload verification of ${n} failed${u.kind==="ambiguous"?`: ${u.detail}`:": still absent"}`);if(!u.bytes.equals(s))throw i(`post-upload verification of ${n} found mismatched bytes`)}c(H,"uploadAndVerify");function St(t,r){P(t);const o=`.submitted-${Z(8).toString("hex")}.tmp`,e=S(t.path,o),s=S(t.path,T),n=Buffer.from(JSON.stringify(r,null,2)+`
+`,"utf8");let a=!1;try{const u=A(e,y.O_WRONLY|y.O_CREAT|y.O_EXCL|y.O_NOFOLLOW,384);try{let d=0;for(;d<n.length;)d+=rt(u,n,d,n.length-d,d);V(u)}finally{b(u)}tt(e,s),a=!0}catch(u){throw i(`could not publish ${T}: ${u.message}`)}finally{if(!a)try{et(e)}catch{}}}c(St,"publishMarker");async function _t(t,r,o=j){if(!at.test(t))throw O(`invalid support reference ${JSON.stringify(t)} \u2014 expected YYYYMMDDTHHmmssSSSZ-xxxxxxxx.`);const e=ft(t);let s,n;try{if(U(e.dir),s=M(e.dir,f),n=M(e.dir,l),s.size+n.size>g)throw i(`captured prepared file sizes exceed the ${g}-byte cap`);const a=v(s),u=v(n);yt(a,u,t);const d=bt(r);gt(o);const h=wt(o,d);if(H(o,h,t,f,a),H(o,h,t,l,u),!F(s)||!F(n))throw i(`prepared files changed during submission \u2014 refusing to write ${T}`);U(e.dir);const p=`${h.htmlUrl}/tree/${encodeURIComponent(h.defaultBranch)}/support/${t}`;return St(e.dir,{reference:t,repository:h.fullName,submitted_at:new Date().toISOString(),url:p}),{status:"submitted",reference:t,repository:h.fullName,url:p}}finally{s!==void 0&&b(s.fd),n!==void 0&&b(n.fd),b(e.dir.fd),b(e.root.fd)}}c(_t,"submitPreparedBundle");const kt=st({name:"submit",description:"submit a prepared local support bundle to a private GitHub repository",whenToUse:"you already ran `crtr sys support prepare` and have decided to share its printed reference with maintainers. Requires exact CRTR_SUPPORT_REPO=owner/name naming a private github.com repository plus working `gh` auth; fails closed before egress and never re-collects or transforms prepared files.",help:{name:"sys support submit",summary:"Validate a prepared bundle locally, then upload manifest.json and bundle.jsonl to support/<reference>/ in the canonical private github.com repository named by CRTR_SUPPORT_REPO, verifying each remote file byte-for-byte",params:[{kind:"positional",name:"reference",required:!0,constraint:"The exact reference `crtr sys support prepare` printed \u2014 YYYYMMDDTHHmmssSSSZ-xxxxxxxx."}],output:[{name:"repository",type:"string",required:!0,constraint:"Canonical owner/name of the private destination."},{name:"url",type:"string",required:!0,constraint:"Canonical github.com URL of support/<reference>/."}],outputKind:"object",effects:["Reads and revalidates the two prepared files under ~/.crouter/support/<reference>/; it never recollects diagnostic sources.","Uploads manifest.json then bundle.jsonl through the GitHub Contents API; equal remote bytes resume, unequal bytes reject, and only a structured exact HTTP 404 authorizes creation.","After confirming the local files are unchanged, atomically writes/replaces submitted.json in the reference directory; prepared files remain unchanged."]},run:c(async t=>{const r=t.reference;if(r===void 0||r==="")throw O("reference is required. Run `crtr sys support submit -h`.");const o=await _t(r,process.env,j);return{repository:o.repository,url:o.url}},"run")});export{j as defaultGhRunner,_t as submitPreparedBundle,kt as supportSubmitLeaf};

package/dist/commands/sys/support.d.ts

@@ -0,0 +1,2 @@
+import type { BranchDef } from '../../core/command.js';
+export declare const supportBranch: BranchDef;

package/dist/commands/sys/support.js

@@ -0,0 +1 @@
+import{defineBranch as e}from"../../core/command.js";import{supportPrepareLeaf as t}from"./support/prepare.js";import{supportSubmitLeaf as o}from"./support/submit.js";const i=e({name:"support",description:"prepare and submit a bounded local diagnostics bundle for one node",whenToUse:"a maintainer asked for diagnostics on a node \u2014 prepare collects them locally with zero egress, submit is the one explicit step that shares them privately",help:{name:"sys support",summary:"locally prepare a node\u2019s diagnostics, then optionally submit them to a private repository",model:"prepare is local and zero-egress: it writes manifest.json + bundle.jsonl under ~/.crouter/support/<reference>/ and touches no network. submit is the only step that leaves the machine \u2014 it uploads that exact prepared bundle to the private GitHub repository named by CRTR_SUPPORT_REPO. Nothing submits automatically."},children:[t,o]});export{i as supportBranch};

package/dist/commands/sys/sync-deps.d.ts

@@ -0,0 +1,16 @@
+import type { CrtrClient } from '../../api/index.js';
+export declare const DEPS_GENERATED_MARKER = "crtr sys sync deps";
+interface DepsRow {
+    source: string;
+    /** Full name of the vendored document (`<repo>/deps/...`), except on an
+     *  `excluded` row, which names the excluded package selector. */
+    name: string;
+    status: 'imported' | 'unchanged' | 'would-import' | 'deleted' | 'would-delete' | 'skipped' | 'excluded';
+    reason?: string;
+}
+export declare function runDepsSync(client: CrtrClient, opts: {
+    sourceArg?: string;
+    dryRun: boolean;
+}): Promise<DepsRow[]>;
+export declare const sysSyncDepsLeaf: import("../../core/command.js").LeafDef;
+export {};

package/dist/commands/sys/sync-deps.js

@@ -0,0 +1,14 @@
+var le=Object.defineProperty;var p=(s,n)=>le(s,"name",{value:n,configurable:!0});import{dirname as W,join as w,relative as F,resolve as X,sep as z}from"node:path";import{defineLeaf as pe}from"../../core/command.js";import{usage as D}from"../../core/errors.js";import{parseFrontmatterGeneric as Q}from"../../core/frontmatter.js";import{pathExists as M,readJsonIfExists as Y,readText as I,walkFiles as ee}from"../../core/fs-utils.js";import{cliClient as ue}from"../api-client.js";import{normalizedName as ne,putDoc as se,repoOwner as me,routeFromDescription as he,scalarString as fe,writeFailure as te}from"./sync-shared.js";import{isRecord as E}from"../../shared/predicates.js";import{readdirSync as ge}from"node:fs";const L="crtr sys sync deps";function f(s){throw D(`--deps: invalid package.json crtr.sync.deps.exclude: ${s}`)}p(f,"invalidDepsConfig");function ke(s){const n=Y(w(s,"package.json"));E(n)||f("package.json must contain an object");const o=n.crtr;if(o===void 0)return[];E(o)||f("crtr must be an object");const r=o.sync;if(r===void 0)return[];E(r)||f("crtr.sync must be an object");const t=r.deps;if(t===void 0)return[];E(t)||f("crtr.sync.deps must be an object");const i=t.exclude;if(i===void 0)return[];Array.isArray(i)||f("exclude must be an array of {package, version, skill} selectors");const m=new Set;return i.map((k,g)=>{E(k)||f(`exclude[${g}] must be an object with exactly package, version, and skill`),Object.keys(k).sort().join(",")!=="package,skill,version"&&f(`exclude[${g}] must contain exactly package, version, and skill`);const u=k.package,v=k.version,h=k.skill;(typeof u!="string"||!ye.test(u))&&f(`exclude[${g}].package must be one exact npm package name`),(typeof v!="string"||!$e.test(v))&&f(`exclude[${g}].version must be one exact installed semver version`),(typeof h!="string"||h===""||h!=="."&&(h.startsWith("/")||h.split("/").some(x=>x===""||x==="."||x==="..")||/[\\*?[\]{}]/.test(h)))&&f(`exclude[${g}].skill must be one exact POSIX path relative to the package skills/ directory (use . for a root SKILL.md)`);const $={package:u,version:v,skill:h},S=`${u}\0${v}\0${h}`;return m.has(S)&&f(`exclude[${g}] duplicates ${u}@${v} skill ${h}`),m.add(S),$})}p(ke,"readDepsExclusions");const ye=/^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/,oe="(?:0|[1-9]\\d*|[0-9A-Za-z-]*[A-Za-z-][0-9A-Za-z-]*)",$e=new RegExp(`^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-${oe}(?:\\.${oe})*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$`);function _(s,n,o){return`${s}\0${n}\0${o}`}p(_,"exclusionKey");function be(s,n,o){return s.has(_(n.pkg,n.version,o))}p(be,"isExcluded");function we(s){if(s!==void 0)return X(s);let n=X(process.cwd());for(;;){if(M(w(n,"package.json")))return n;const o=W(n);if(o===n)throw D("--deps: no package.json found from cwd upward; run inside a Node project or pass --source <project-dir>");n=o}}p(we,"depsProjectDir");function ve(s){const n=[];for(const r of re(s))if(!r.startsWith("."))if(r.startsWith("@"))for(const t of re(w(s,r)))n.push(w(s,r,t));else n.push(w(s,r));const o=[];for(const r of n.sort()){const t=w(r,"skills");if(!M(t))continue;const i=Y(w(r,"package.json"));o.push({pkg:i?.name??F(s,r).split(z).join("/"),version:i?.version??"",skillsRoot:t})}return o}p(ve,"skillsPackages");function re(s){try{return ge(s)}catch{return[]}}p(re,"listDirNames");function xe(s,n){return n.find(o=>s===o||s.startsWith(`${o}${z}`))}p(xe,"owningBundle");function de(s,n=220){const o=s.replace(/\s+/g," ").trim(),r=o.split(/(?<=[.!?])\s+/)[0]??o,t=r.length>=30?r:o;if(t.length<=n)return t;const i=t.slice(0,n),m=i.lastIndexOf(" ");return`${i.slice(0,m>80?m:n).trimEnd()}\u2026`}p(de,"condenseDescription");function je(s){const n=s.match(/^#{1,6}\s+(.+)$/m);return n?n[1].trim():void 0}p(je,"firstHeading");async function Re(s,n){const o=we(n.sourceArg),r=w(o,"node_modules");if(!M(r))throw D(`sys sync deps: ${r} does not exist; install dependencies first (npm ci / npm install), then re-run`);const t=await me(s,o),i=[...t.existing].filter(e=>e.startsWith("deps/"));if(i.length>0||t.existing.has("deps")){const e=t.existing.has("deps")?await s.objects.read(`${t.handle}/deps`):null;if(!(e!==null&&e.state==="object"&&e.type==="document"&&e.data.bodies.some(c=>c.includes(L))))throw D(`--deps: repo ${t.handle} already has documents named deps/\u2026 but its \`deps\` document does not carry the "${L}" marker; they may be hand-written \u2014 move or delete them (\`crtr doc move\` / \`crtr doc delete\`) before vendoring dependency docs there`)}const m=ke(o),k=new Set(m.map(e=>_(e.package,e.version,e.skill))),g=new Map(m.map(e=>[_(e.package,e.version,e.skill),0])),y=new Map,u=[],v=ve(r),h=[];for(const e of v){const d=[],c=new Set;for(const a of ee(e.skillsRoot,l=>l==="SKILL.md",l=>l==="node_modules"||l===".git")){const l=W(a);d.push(l);const b=W(F(e.skillsRoot,a).split(z).join("/"));if(!be(k,e,b))continue;const j=_(e.pkg,e.version,b);g.set(j,(g.get(j)??0)+1),c.add(l),u.push({source:a,name:`${e.pkg}@${e.version}:${b}`,status:"excluded",reason:"matched package.json crtr.sync.deps.exclude"})}h.push({...e,bundleRoots:d.sort((a,l)=>l.length-a.length),excludedBundleRoots:c})}for(const e of m){const d=_(e.package,e.version,e.skill),c=g.get(d);if(c!==1)throw D(`--deps: package.json crtr.sync.deps.exclude selector ${e.package}@${e.version}:${e.skill} ${c===0?"does not match an installed dependency skill bundle":`matches ${c} installed dependency skill bundles`}; update or remove the selector before syncing`)}for(const e of h){const d=e.bundleRoots??[],c=e.excludedBundleRoots??new Set;for(const a of ee(e.skillsRoot,l=>l.toLowerCase().endsWith(".md"),l=>l==="node_modules"||l===".git")){const l=xe(a,d);if(l===void 0||c.has(l))continue;const b=F(e.skillsRoot,a).split(z).join("/");let j,R;if(b==="SKILL.md"||b.endsWith("/SKILL.md")){const V=W(b),H=ne(V==="."?e.pkg.split("/").pop()??e.pkg:V);R=H;let J={},P="";try{const U=Q(I(a));J=U.data??{},P=U.body}catch{P=I(a)}j={kind:"skill",sourceAbs:a,pkg:e.pkg,version:e.version,bundleRel:H,body:P,description:fe(J.description)??""}}else R=ne(b),j={kind:"sidecar-md",sourceAbs:a,pkg:e.pkg,version:e.version};if(R==="")continue;const q=y.get(R);if(q){j.kind==="skill"&&u.push({source:a,name:`${t.handle}/deps/${R}`,status:"skipped",reason:`collides with same-named document from ${q.pkg}`});continue}y.set(R,j)}}const $=[...y.entries()].filter(e=>e[1].kind==="skill"),S=$.map(([,e])=>e.bundleRel).sort((e,d)=>d.length-e.length),x=new Map;for(const[e,d]of y){if(d.kind==="skill")continue;const c=S.find(a=>e.startsWith(`${a}/`));c&&x.set(c,(x.get(c)??0)+1)}const C=new Set($.map(([,e])=>`${e.pkg}@${e.version}`)),O=`generated catalog of ${$.length} docs from ${C.size} package${C.size===1?"":"s"}`,B=p((e,d)=>{if(d.kind!=="skill")return;const c=x.get(d.bundleRel)??0;return c>0?`+${c} sidecar doc${c===1?"":"s"}`:void 0},"reasonFor"),G=i.filter(e=>!y.has(e.slice(5)));if(n.dryRun){for(const[e,d]of y){const c=B(e,d);u.push({source:d.sourceAbs,name:`${t.handle}/deps/${e}`,status:"would-import",...c?{reason:c}:{}})}for(const e of G)u.push({source:"\u2014",name:`${t.handle}/${e}`,status:"would-delete",reason:"no dependency ships it any more"});return u.push({source:r,name:`${t.handle}/deps`,status:"would-import",reason:O}),u}const T="regenerated by crtr sys sync deps";for(const[e,d]of y){const c=d.kind==="skill"?Se(e,d):Ae(e,d,S,t.handle);try{const a=await se(s,t,c,T),l=B(e,d);u.push({source:d.sourceAbs,name:a.name,status:a.changed?"imported":"unchanged",...l?{reason:l}:{}})}catch(a){u.push({source:d.sourceAbs,name:`${t.handle}/deps/${e}`,status:"skipped",reason:te(a)})}}for(const e of G)await s.docs.delete(`${t.handle}/${e}`),u.push({source:"\u2014",name:`${t.handle}/${e}`,status:"deleted",reason:"no dependency ships it any more"});const A=`${t.handle}/deps`,Z=[...new Set($.map(([,e])=>e.pkg))],ce=Z.slice(0,6).join(", ")+(Z.length>6?", \u2026":""),N=new Map;for(const[,e]of $){const d=`${e.pkg}@${e.version}`,c=N.get(d)??[],a=e.description!==""?` \u2014 ${de(e.description,180)}`:"";c.push(`- [[${A}/${e.bundleRel}]]${a}`),N.set(d,c)}const ie=[...N.entries()].map(([e,d])=>`## ${e}
+
+${d.sort().join(`
+`)}`).join(`
+
+`),K=$.length===0,ae={name:"deps",kind:"knowledge",preview:K?"When deciding whether dependency-shipped agent docs are available in this project, read this because no dependency guides are currently vendored.":`When writing code against this project's dependencies (${ce}), read this because those packages ship their own agent guides, vendored as documents readable with \`crtr canvas read ${A}/<name>\`.`,summary:K?"No dependency-shipped agent docs are currently vendored.":"Generated catalog of the agent docs shipped inside this project's npm dependencies.",rules:[{on:"boot",deliver:"preview"}],body:K?`# Dependency-shipped agent docs (generated)
+
+No dependency agent docs are currently vendored. \`${L}\` found no included Agent Skill bundles.
+`:`# Dependency-shipped agent docs (generated)
+
+Generated by \`${L}\` from the Agent Skill bundles inside this project's node_modules. Do not hand-edit: every \`${A}/\u2026\` document is rewritten on every run \u2014 re-run after dependencies change. Read any entry with \`crtr canvas read ${A}/<name>\`.
+
+`+ie};try{const e=await se(s,t,ae,T);u.push({source:r,name:e.name,status:e.changed?"imported":"unchanged",reason:O})}catch(e){u.push({source:r,name:A,status:"skipped",reason:te(e)})}return u}p(Re,"runDepsSync");function Se(s,n){return{name:`deps/${s}`,kind:"knowledge",preview:he(n.description,"knowledge"),summary:n.description!==""?de(n.description):`Vendored agent doc shipped by ${n.pkg}@${n.version}.`,rules:[{on:"boot",deliver:"name"}],body:n.body}}p(Se,"skillDoc");function Ae(s,n,o,r){let t;try{t=Q(I(n.sourceAbs)).body}catch{t=I(n.sourceAbs)}const i=o.find(k=>s.startsWith(`${k}/`)),m=i?`${r}/deps/${i}`:`a ${r}/deps document`;return{name:`deps/${s}`,kind:"knowledge",preview:`When ${m} links to this file, read this because it carries the linked supporting reference.`,summary:je(t)??`Supporting reference vendored from ${n.pkg}@${n.version}.`,rules:[{on:"boot",deliver:"name"}],body:t}}p(Ae,"sidecarDoc");function De(s){const n=p(i=>s.filter(m=>m.status===i).length,"count"),o=n("would-import")>0?`crtr sys sync deps \u2014 dry run: ${n("would-import")} would import, ${n("would-delete")} would delete, ${n("skipped")} skipped, ${n("excluded")} excluded`:`crtr sys sync deps \u2014 ${n("imported")} imported, ${n("unchanged")} unchanged, ${n("deleted")} deleted, ${n("skipped")} skipped, ${n("excluded")} excluded`,r=s.map(i=>{const m=i.reason?` (${i.reason})`:"";return`| ${i.status} | ${i.name||"\u2014"} | ${i.source}${m} |`}),t=r.length===0?["No sync candidates."]:["| status | document | source |","| --- | --- | --- |",...r];return[o,"",...t].join(`
+`)}p(De,"renderDepsSummary");const Me=pe({name:"deps",description:"vendor Agent Skill bundles shipped inside npm dependencies as documents owned by the project's repo",whenToUse:"vendoring Agent Skill bundles shipped inside a project's installed npm dependencies (node_modules/<pkg>/skills/**/SKILL.md) as documents owned by that project's repo, named under `deps/` and rewritten on every run, so agents get first-party dependency guidance without touching node_modules directly.",help:{name:"sys sync deps",summary:"vendor npm-dependency Agent Skill bundles as the repo's `deps/\u2026` documents (rewritten every run)",params:[{kind:"flag",name:"source",type:"string",required:!1,constraint:"The project directory whose dependencies to vendor. Default: the nearest ancestor of cwd with a package.json. node_modules must already be installed there, and the directory must be inside a repo."},{kind:"flag",name:"dry-run",type:"bool",required:!1,constraint:"Report what would be vendored without writing anything."}],output:[{name:"results",type:"object[]",required:!0,constraint:"Each: {source,name,status,reason?}; status is one of imported, unchanged, would-import, deleted, would-delete, skipped, excluded. `name` is the document's full name (`<repo>/deps/<bundle>`), except on an excluded row, which names the `<package>@<version>:<skill>` selector. An excluded row is a dependency bundle rejected before its files are planned."}],outputKind:"object",effects:["Writes the repo's documents from installed dependency skills, except bundles selected by exact {package,version,skill} entries in package.json crtr.sync.deps.exclude: each included SKILL.md becomes `<repo>/deps/<bundle>` and each Markdown sidecar `<repo>/deps/<bundle>/<path>`, both with a boot rule at name; the `<repo>/deps` catalog carries a boot rule at preview. Other sidecar files are not vendored. Repo documents sync to everyone working in the repo.","Deletes `<repo>/deps/\u2026` documents no installed dependency ships any more.",`Refuses when \`<repo>/deps/\u2026\` documents exist and \`<repo>/deps\` does not carry the "${L}" marker.`,"With --dry-run: read-only; writes nothing."]},run:p(async s=>{const n=s.source,o=s.dryRun??!1;return{results:await Re(ue(),{sourceArg:n,dryRun:o})}},"run"),render:p(s=>De(s.results),"render")});export{L as DEPS_GENERATED_MARKER,Re as runDepsSync,Me as sysSyncDepsLeaf};

package/dist/commands/sys/sync-project-guidance.d.ts

@@ -0,0 +1 @@
+export declare const sysSyncProjectGuidanceLeaf: import("../../core/command.js").LeafDef;

package/dist/commands/sys/sync-project-guidance.js

@@ -0,0 +1,5 @@
+var N=Object.defineProperty;var c=(r,t)=>N(r,"name",{value:t,configurable:!0});import{envProfileId as x}from"../../shared/env.js";import{existsSync as y,readdirSync as T,statSync as v}from"node:fs";import{basename as L,join as g,relative as F,resolve as f}from"node:path";import{defineLeaf as W}from"../../core/command.js";import{parseFrontmatterGeneric as $}from"../../core/frontmatter.js";import{readText as D,realpathOrSelf as S,walkFiles as G}from"../../core/fs-utils.js";import{identifyCheckout as M}from"../../core/graph/repo-sync/identity.js";import{loadProfileManifest as O}from"../../core/profiles/manifest.js";import{CRTR_DIR_NAME as P}from"../../types.js";import{cliClient as _}from"../api-client.js";import{normalizedName as j,putDoc as U,repoOwner as I,routeFromDescription as q,rulesFromLegacyFrontmatter as z,scalarString as w,writeFailure as J}from"./sync-shared.js";const K=new Set(["node_modules",".git",".venv","venv","dist","build",".next",".cache",".yalc",".sisyphus",P]),B=["AGENTS.md","CLAUDE.md"];function H(r){if(r!==void 0)return[f(r)];const t=[f(process.cwd())],e=x();if(e!==void 0&&e!=="")try{const{manifest:s}=O(e);for(const o of s.projects){const n=f(o.path);t.includes(n)||t.push(n)}}catch{}return t}c(H,"projectDocRoots");function Q(r){const t=[];if(!y(r)||!v(r).isDirectory())return t;const e=f(r),s=[e];for(;s.length>0;){const o=s.pop();for(const a of B){const d=g(o,a);if(y(d)&&v(d).isFile()){t.push({kind:"agents",path:d,sourceDir:o,walkRoot:e});break}}const n=g(o,".claude","rules");if(y(n))for(const a of G(n,d=>d.endsWith(".md")))t.push({kind:"rule",path:a,sourceDir:o,walkRoot:e});let i;try{i=T(o,{withFileTypes:!0})}catch{continue}for(const a of i)a.isDirectory()&&!K.has(a.name)&&s.push(g(o,a.name))}return t}c(Q,"collectProjectDocCandidates");function me(r){for(const t of r.split(`
+`)){const e=t.replace(/^#+\s*/,"").replace(/\s+/g," ").trim();if(e!=="")return e.length>200?`${e.slice(0,197)}...`:e}return"Migrated project guidance."}c(me,"synthesizeShortForm");function E(r){const t=[];let e=0,s="";for(const o of r){if(o==="{"?e+=1:o==="}"&&(e=Math.max(0,e-1)),o===","&&e===0){t.push(s),s="";continue}s+=o}return t.push(s),t.map(o=>o.trim()).filter(o=>o!=="")}c(E,"splitTopLevelCommas");function V(r){return typeof r=="string"?E(r):Array.isArray(r)?r.filter(t=>typeof t=="string").flatMap(E):[]}c(V,"normalizeRulePaths");function R(r,t){let e=r.trim();return e.includes("/")&&!e.startsWith("/")&&!e.startsWith("**")&&!e.startsWith("./")&&(e=`./${e}`),!e.startsWith("./")||t===""?e:`./${t}/${e.slice(2)}`}c(R,"anchorReadGlob");function k(r){for(const t of r.split(`
+`)){const e=t.replace(/^#+\s*/,"").replace(/\s+/g," ").trim();if(e!=="")return e.length>200?`${e.slice(0,197)}...`:e}return"Migrated project guidance."}c(k,"firstNonEmptyLine");function C(r,t){return j(F(S(r.cwd),S(t)))}c(C,"folderName");function X(r,t){const e=$(D(r.path)),s=e.data??{},o=C(t,r.sourceDir);if(o==="")return{candidate:r,owner:t,doc:{name:"index",kind:"knowledge",preview:`When working in ${t.handle}, read this because it is the project's operating guide.`,summary:k(e.body),rules:[{on:"workspace-open",deliver:"content"},{on:"file-read",match:["./**"],deliver:"content"}],body:e.body}};const n=z(s).filter(a=>a.on==="file-read"),i=w(s["when-and-why-to-read"])?.trim();return{candidate:r,owner:t,doc:{name:o,kind:"knowledge",preview:i!==void 0&&i!==""?i:`When working under ${o} in ${t.handle}, read this because it carries that folder's guidance.`,summary:k(e.body),rules:n.length>0?n.map(a=>a.match?{...a,match:a.match.map(d=>R(d,o))}:a):[{on:"file-read",match:[`./${o}/**`],deliver:"content"}],body:e.body}}}c(X,"prepareAgents");function Y(r,t){const e=$(D(r.path)),s=e.data??{},o=C(t,r.sourceDir),n=w(s.name),i=j(n!==void 0&&n.trim()!==""?n:L(r.path)),a=o===""?i:`${o}/${i}`,d=w(s.description)??"",p=V(s.paths).map(l=>R(l,o)),u={on:"file-read",match:p.length>0?p:[o===""?"./**":`./${o}/**`],deliver:"content"};return{candidate:r,owner:t,doc:{name:a,kind:"knowledge",preview:d!==""?q(d,"knowledge"):`When working under ${o===""?t.handle:`${o} in ${t.handle}`}, read this because it is migrated project rule guidance.`,summary:d!==""?d.replace(/\s+/g," ").trim():k(e.body),rules:[u],body:e.body}}}c(Y,"prepareRule");async function Z(r,t,e){const{owner:s,doc:o}=t,n={source:t.candidate.path,name:`${s.handle}/${o.name}`};if(s.existing.has(o.name)&&!e.overwrite)return{...n,status:"skipped",reason:"a document with this name already exists; re-run with --overwrite to replace it"};if(e.dryRun)return{...n,status:"would-import"};try{const i=await U(r,s,o,"migrated by crtr sys sync project-guidance");return{...n,name:i.name,status:i.changed?"imported":"unchanged"}}catch(i){return{...n,status:"skipped",reason:J(i)}}}c(Z,"convertProjectDoc");function ee(r){const t=c(n=>r.filter(i=>i.status===n).length,"count"),e=t("would-import")>0?`crtr sys sync project-guidance \u2014 dry run: ${t("would-import")} would import, ${t("skipped")} skipped`:`crtr sys sync project-guidance \u2014 ${t("imported")} imported, ${t("unchanged")} unchanged, ${t("skipped")} skipped`,s=r.map(n=>{const i=n.reason?` (${n.reason})`:"";return`| ${n.status} | ${n.name||"\u2014"} | ${n.source}${i} |`}),o=s.length===0?["No sync candidates."]:["| status | document | source |","| --- | --- | --- |",...s];return[e,"",...o].join(`
+`)}c(ee,"renderSummary");const fe=W({name:"project-guidance",description:"migrate repository guidance into documents owned by the repo",whenToUse:"migrating a repository's CLAUDE.md/AGENTS.md/.claude/rules into documents owned by that repo: one-way copy. Only the repository-root guide becomes the workspace front door (`<repo>/index`); nested guides and rules load when files under their folder are read. Never exports documents back to these source files.",help:{name:"sys sync project-guidance",summary:"one-way migration: CLAUDE.md/AGENTS.md/.claude/rules \u2192 documents owned by the repo",params:[{kind:"flag",name:"source",type:"string",required:!1,constraint:"The root to walk recursively for CLAUDE.md/AGENTS.md/.claude/rules files. Default: cwd plus every project in the current profile's purview (when one is selected)."},{kind:"flag",name:"dry-run",type:"bool",required:!1,constraint:"Show what would be migrated without writing documents."},{kind:"flag",name:"overwrite",type:"bool",required:!1,constraint:"Replace the body and fields of an existing document of the same name (a new revision). Default: skip it."}],output:[{name:"results",type:"object[]",required:!0,constraint:"Each: {source,name,status,reason?}; status is one of imported, unchanged, skipped, would-import. `name` is the document's full name."}],outputKind:"object",effects:["Copies the repository-root CLAUDE.md/AGENTS.md into `<repo>/index` with a workspace-open rule and a file-read rule over the whole repo, both at content. Copies a nested guide into `<repo>/<folder>` with a file-read rule over that folder. Copies each .claude/rules/*.md into `<repo>/<folder>/<rule name>` with a file-read rule over its `paths` (placed under the folder when relative), or over the folder when it declares none. Originals are left untouched; a source outside any repo is skipped. Repo documents sync to everyone working in the repo.","Skips existing documents unless --overwrite is present.","With --dry-run: read-only; writes nothing."]},run:c(async r=>{const t=r.source,e=r.dryRun??!1,s=r.overwrite??!1,o=_(),n=[],i=new Set,a=new Map,d=[];for(const p of H(t))for(const u of Q(p)){if(i.has(u.path))continue;i.add(u.path);const l=M(u.sourceDir);if(!l.ok){n.push({source:u.path,name:"",status:"skipped",reason:`not inside a repo: ${l.reason}`});continue}let m=a.get(l.root);m===void 0&&(m=I(o,l.root),a.set(l.root,m));const b=await m;try{d.push(u.kind==="agents"?X(u,b):Y(u,b))}catch(h){const A=(h instanceof Error?h.message:String(h)).split(`
+`)[0];n.push({source:u.path,name:"",status:"skipped",reason:`unparseable source frontmatter: ${A} \u2014 fix the source file and re-run`})}}for(const p of d)n.push(await Z(o,p,{dryRun:e,overwrite:s}));return{results:n}},"run"),render:c(r=>ee(r.results),"render")});export{fe as sysSyncProjectGuidanceLeaf};