@north-light/crouter 0.3.317 → 0.3.319

package/dist/commands/pkg/plugin.js

@@ -1,14 +1 @@
-import { defineBranch } from '../../core/command.js';
-import { pluginDisable, pluginEnable, pluginInstall, pluginRemove, pluginUpdate, } from './plugin-manage.js';
-import { pluginList, pluginShow } from './plugin-inspect.js';
-export const pluginBranch = defineBranch({
-    name: 'plugin',
-    description: 'install and manage plugins',
-    whenToUse: 'working with individual plugins: install, remove, enable, disable, update, list, or inspect them. Use `pkg market` only for marketplace source registration, refresh, and browsing.',
-    help: {
-        name: 'pkg plugin',
-        summary: 'plugin lifecycle and inspection',
-        model: 'A plugin may contribute memory docs and commands. Command plugins declare one transport in plugin.json: exec runs a local executable; http calls a remote endpoint. Install accepts either a source ref or an HTTP endpoint.',
-    },
-    children: [pluginInstall, pluginRemove, pluginEnable, pluginDisable, pluginUpdate, pluginList, pluginShow],
-});
+import{defineBranch as n}from"../../core/command.js";import{pluginDisable as e,pluginEnable as i,pluginInstall as l,pluginRemove as a,pluginUpdate as o}from"./plugin-manage.js";import{pluginList as r,pluginShow as p}from"./plugin-inspect.js";const u=n({name:"plugin",description:"install and manage plugins",whenToUse:"working with individual plugins: install, remove, enable, disable, update, list, or inspect them. Use `pkg market` only for marketplace source registration, refresh, and browsing.",help:{name:"pkg plugin",summary:"plugin lifecycle and inspection",model:"A plugin may contribute memory docs and commands. Command plugins declare one transport in plugin.json: exec runs a local executable; http calls a remote endpoint. Install accepts either a source ref or an HTTP endpoint."},children:[l,a,i,e,o,r,p]});export{u as pluginBranch};

package/dist/commands/pkg/shared.js

@@ -1,62 +1 @@
-import { join } from 'node:path';
-import { notFound, usage } from '../../core/errors.js';
-import { resolveScopeArg, pluginsDir, projectScopeRoot } from '../../core/scope.js';
-import { updateConfig } from '../../core/config.js';
-import { pathExists } from '../../core/fs-utils.js';
-// Helpers
-export const GIT_URL_RE = /^(https?:\/\/|git@|ssh:\/\/|file:\/\/)/;
-export function isGitUrl(arg) {
-    return GIT_URL_RE.test(arg) || arg.endsWith('.git');
-}
-export function resolveInstallScope(scopeInput) {
-    if (scopeInput !== undefined) {
-        const resolved = resolveScopeArg(scopeInput);
-        if (resolved === 'all' || resolved === 'builtin') {
-            throw usage('scope must be "user" or "project"');
-        }
-        return resolved;
-    }
-    // Default: project if available, else user
-    return projectScopeRoot() !== null ? 'project' : 'user';
-}
-/** The one installed copy an enable/disable acts on: the first scope in
- *  precedence whose plugins dir holds `name`, disabled copies included. Enable
- *  validates that exact copy before flipping its config, so both share this
- *  resolution rather than each walking the scopes. */
-export function resolvePluginConfigTarget(name, scopeInput) {
-    let scopes;
-    if (scopeInput !== undefined) {
-        const resolved = resolveScopeArg(scopeInput);
-        if (resolved === 'builtin')
-            throw usage('cannot enable/disable plugins in builtin scope');
-        scopes = resolved === 'all' ? ['project', 'user'].filter((s) => s !== 'project' || projectScopeRoot() !== null) : [resolved];
-    }
-    else {
-        scopes = ['project', 'user'].filter((s) => s !== 'project' || projectScopeRoot() !== null);
-    }
-    for (const scope of scopes) {
-        const pDir = pluginsDir(scope);
-        if (pDir === null)
-            continue;
-        const pluginDir = join(pDir, name);
-        if (pathExists(pluginDir))
-            return { scope, root: pluginDir };
-    }
-    return null;
-}
-export async function setPluginEnabled(input, enabled) {
-    const name = input['name'];
-    const target = resolvePluginConfigTarget(name, input['scope']);
-    if (target === null)
-        throw notFound(`plugin not found: ${name}`);
-    updateConfig(target.scope, (cfg) => {
-        const entry = cfg.plugins[name];
-        if (entry !== undefined) {
-            entry.enabled = enabled;
-        }
-        else {
-            cfg.plugins[name] = { enabled };
-        }
-    });
-    return { name, scope: target.scope, enabled };
-}
+var c=Object.defineProperty;var s=(e,o)=>c(e,"name",{value:o,configurable:!0});import{join as f}from"node:path";import{notFound as g,usage as u}from"../../core/errors.js";import{resolveScopeArg as p,pluginsDir as a,projectScopeRoot as l}from"../../core/scope.js";import{updateConfig as d}from"../../core/config.js";import{pathExists as m}from"../../core/fs-utils.js";const j=/^(https?:\/\/|git@|ssh:\/\/|file:\/\/)/;function R(e){return j.test(e)||e.endsWith(".git")}s(R,"isGitUrl");function S(e){if(e!==void 0){const o=p(e);if(o==="all"||o==="builtin")throw u('scope must be "user" or "project"');return o}return l()!==null?"project":"user"}s(S,"resolveInstallScope");function h(e,o){let n;if(o!==void 0){const t=p(o);if(t==="builtin")throw u("cannot enable/disable plugins in builtin scope");n=t==="all"?["project","user"].filter(r=>r!=="project"||l()!==null):[t]}else n=["project","user"].filter(t=>t!=="project"||l()!==null);for(const t of n){const r=a(t);if(r===null)continue;const i=f(r,e);if(m(i))return{scope:t,root:i}}return null}s(h,"resolvePluginConfigTarget");async function y(e,o){const n=e.name,t=h(n,e.scope);if(t===null)throw g(`plugin not found: ${n}`);return d(t.scope,r=>{const i=r.plugins[n];i!==void 0?i.enabled=o:r.plugins[n]={enabled:o}}),{name:n,scope:t.scope,enabled:o}}s(y,"setPluginEnabled");export{j as GIT_URL_RE,R as isGitUrl,S as resolveInstallScope,h as resolvePluginConfigTarget,y as setPluginEnabled};

package/dist/commands/pkg.js

@@ -1,21 +1 @@
-// `crtr pkg` subtree: plugin lifecycle and marketplace source management.
-import { defineBranch } from '../core/command.js';
-import { pkgBrowseLeaf } from './pkg/browse.js';
-import { pluginBranch } from './pkg/plugin.js';
-import { marketBranch } from './pkg/market.js';
-export function registerPkg() {
-    return defineBranch({
-        name: 'pkg',
-        rootEntry: {
-            concept: 'plugins and marketplaces that extend crtr',
-            desc: 'manage plugins and marketplace sources',
-            useWhen: 'installing or browsing plugins and marketplace sources; plugin commands may use local executable or remote HTTP transport',
-        },
-        help: {
-            name: 'pkg',
-            summary: 'manage plugins and marketplace sources',
-            model: 'Marketplaces are configured source catalogs; plugins are installed extensions resolved from those catalogs or direct HTTP endpoints. Browsing searches the configured catalogs without changing source or install state.',
-        },
-        children: [pkgBrowseLeaf, pluginBranch, marketBranch],
-    });
-}
+var n=Object.defineProperty;var e=(r,a)=>n(r,"name",{value:a,configurable:!0});import{defineBranch as o}from"../core/command.js";import{pkgBrowseLeaf as t}from"./pkg/browse.js";import{pluginBranch as s}from"./pkg/plugin.js";import{marketBranch as c}from"./pkg/market.js";function u(){return o({name:"pkg",rootEntry:{concept:"plugins and marketplaces that extend crtr",desc:"manage plugins and marketplace sources",useWhen:"installing or browsing plugins and marketplace sources; plugin commands may use local executable or remote HTTP transport"},help:{name:"pkg",summary:"manage plugins and marketplace sources",model:"Marketplaces are configured source catalogs; plugins are installed extensions resolved from those catalogs or direct HTTP endpoints. Browsing searches the configured catalogs without changing source or install state."},children:[t,s,c]})}e(u,"registerPkg");export{u as registerPkg};

package/dist/commands/profile/default.js

@@ -1,139 +1 @@
-// `crtr profile default` manages the per-cwd profile-selection pin.
-import { defineLeaf, defineBranch } from '../../core/command.js';
-import { InputError } from '../../core/io.js';
-import { loadProfileManifest, resolveProfileOperand } from '../../core/profiles/manifest.js';
-import { profileCoversCwd } from '../../core/profiles/select.js';
-import { getDefaultProfileId, setDefaultProfileId, clearDefaultProfile, resolveBindingCwd, } from '../../core/profiles/default-binding.js';
-const setLeaf = defineLeaf({
-    name: 'set',
-    description: 'pin a profile as the default for the current directory',
-    whenToUse: 'you want crtr to stop asking which profile to use here and always default to a chosen one — the command form of the startup menu\u2019s `d` action. The profile must already cover this directory (add its purview relationship with `profile project add` and required `--memory` first if not).',
-    help: {
-        name: 'profile default set',
-        summary: "pin a profile as the current directory's default, so the startup chooser stops asking",
-        params: [
-            {
-                kind: 'positional',
-                name: 'profile',
-                required: true,
-                constraint: 'Profile id or manifest name; a close-enough name resolves to the nearest profile, reported on stderr. Must already cover the current directory (be at/above/below it in its project purview); this pin does not change automatic memory disclosure.',
-            },
-        ],
-        output: [
-            { name: 'dir', type: 'string', required: true, constraint: "The resolved directory the pin was set for." },
-            { name: 'profile_id', type: 'string', required: true, constraint: 'The pinned profile id.' },
-            { name: 'name', type: 'string', required: true, constraint: 'The pinned profile name.' },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'The resulting ambient effect.' },
-        ],
-        outputKind: 'object',
-        effects: ['Writes this directory\'s pin into `~/.crouter/profile-defaults.json`. The next launch here auto-picks this profile with no prompt (override once with `crtr --pick-profile`).'],
-    },
-    run: async (_input) => {
-        const cwd = process.cwd();
-        const resolved = resolveBindingCwd(cwd);
-        const entry = resolveProfileOperand(_input['profile']);
-        if (!profileCoversCwd(entry, resolved)) {
-            throw new InputError({
-                error: 'not_covered',
-                message: `profile "${entry.manifest.name}" does not cover ${resolved}, so a default pinned here would be ignored.`,
-                next: `Widen its purview and choose its automatic memory disclosure cap first: \`crtr profile project add ${entry.profileId} --dir ${resolved} --memory <none|name|preview|content>\`, then re-run this.`,
-            });
-        }
-        setDefaultProfileId(cwd, entry.profileId);
-        return {
-            dir: resolved,
-            profile_id: entry.profileId,
-            name: entry.manifest.name,
-            follow_up: `Launches here now auto-pick "${entry.manifest.name}".`,
-        };
-    },
-});
-const clearLeaf = defineLeaf({
-    name: 'clear',
-    description: "remove the current directory's default-profile pin",
-    whenToUse: 'you no longer want a fixed default here — go back to the normal startup chooser (MRU / covering menu). No-op if nothing was pinned.',
-    help: {
-        name: 'profile default clear',
-        summary: "remove the current directory's default-profile pin",
-        params: [],
-        output: [
-            { name: 'dir', type: 'string', required: true, constraint: 'The resolved directory the pin was cleared for.' },
-            { name: 'cleared', type: 'boolean', required: true, constraint: 'True when a pin existed and was removed; false when nothing was pinned.' },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'Concrete next commands.' },
-        ],
-        outputKind: 'object',
-        effects: ['Deletes this directory\'s entry from `~/.crouter/profile-defaults.json`, if present.'],
-    },
-    run: async (_input) => {
-        const cwd = process.cwd();
-        const resolved = resolveBindingCwd(cwd);
-        const had = getDefaultProfileId(cwd) !== null;
-        clearDefaultProfile(cwd);
-        return {
-            dir: resolved,
-            cleared: had,
-            follow_up: had
-                ? 'The startup chooser will ask again here. Re-pin with `crtr profile default set <profile>`.'
-                : 'Nothing was pinned here.',
-        };
-    },
-});
-const showLeaf = defineLeaf({
-    name: 'show',
-    description: "show the current directory's default-profile pin",
-    whenToUse: "you want to know which profile (if any) is pinned as this directory's default.",
-    help: {
-        name: 'profile default show',
-        summary: "report the current directory's pinned default profile, or none",
-        params: [],
-        output: [
-            { name: 'dir', type: 'string', required: true, constraint: 'The resolved directory queried.' },
-            { name: 'pinned', type: 'boolean', required: true, constraint: 'True when a default is pinned here.' },
-            { name: 'profile_id', type: 'string', required: false, constraint: 'The pinned profile id, when pinned.' },
-            { name: 'name', type: 'string', required: false, constraint: 'The pinned profile name, when it still resolves.' },
-            { name: 'stale', type: 'boolean', required: false, constraint: 'True when a pin exists but its profile no longer resolves (deleted); the selector will self-heal it on next launch.' },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'Concrete next commands.' },
-        ],
-        outputKind: 'object',
-        effects: ['Read-only.'],
-    },
-    run: async (_input) => {
-        const cwd = process.cwd();
-        const resolved = resolveBindingCwd(cwd);
-        const id = getDefaultProfileId(cwd);
-        if (id === null) {
-            return {
-                dir: resolved,
-                pinned: false,
-                follow_up: 'Pin one with `crtr profile default set <profile>`.',
-            };
-        }
-        let name;
-        try {
-            name = loadProfileManifest(id).manifest.name;
-        }
-        catch {
-            name = undefined;
-        }
-        return {
-            dir: resolved,
-            pinned: true,
-            profile_id: id,
-            ...(name !== undefined ? { name } : { stale: true }),
-            follow_up: name !== undefined
-                ? 'Change it with `crtr profile default set <profile>`, or clear it with `crtr profile default clear`.'
-                : 'This profile no longer exists; clear the stale pin with `crtr profile default clear`.',
-        };
-    },
-});
-export const defaultBranch = defineBranch({
-    name: 'default',
-    description: "manage this directory's default-profile pin",
-    whenToUse: "setting, clearing, or inspecting which profile a directory defaults to at startup — so crtr stops asking. Directory-scoped, independent of project purview and automatic memory disclosure.",
-    help: {
-        name: 'profile default',
-        summary: "the per-directory default profile — pin one so the startup chooser stops asking",
-        model: "A pin binds the CURRENT directory to a profile: launches here auto-pick it with no prompt (`crtr --pick-profile` reopens the chooser once). `set` pins a profile (which must already cover this dir), `clear` removes the pin, `show` reports it. This is directory-scoped selection, independent of `crtr profile project`: project `path` values govern purview and each `memory` value caps automatic disclosure. The startup menu's `d` action writes the same pin.",
-    },
-    children: [setLeaf, clearLeaf, showLeaf],
-});
+var p=Object.defineProperty;var n=(o,r)=>p(o,"name",{value:r,configurable:!0});import{defineLeaf as s,defineBranch as d}from"../../core/command.js";import{InputError as c}from"../../core/io.js";import{loadProfileManifest as u,resolveProfileOperand as f}from"../../core/profiles/manifest.js";import{profileCoversCwd as h}from"../../core/profiles/select.js";import{getDefaultProfileId as l,setDefaultProfileId as m,clearDefaultProfile as w,resolveBindingCwd as a}from"../../core/profiles/default-binding.js";const y=s({name:"set",description:"pin a profile as the default for the current directory",whenToUse:"you want crtr to stop asking which profile to use here and always default to a chosen one \u2014 the command form of the startup menu\u2019s `d` action. The profile must already cover this directory (add its purview relationship with `profile project add` and required `--memory` first if not).",help:{name:"profile default set",summary:"pin a profile as the current directory's default, so the startup chooser stops asking",params:[{kind:"positional",name:"profile",required:!0,constraint:"Profile id or manifest name; a close-enough name resolves to the nearest profile, reported on stderr. Must already cover the current directory (be at/above/below it in its project purview); this pin does not change automatic memory disclosure."}],output:[{name:"dir",type:"string",required:!0,constraint:"The resolved directory the pin was set for."},{name:"profile_id",type:"string",required:!0,constraint:"The pinned profile id."},{name:"name",type:"string",required:!0,constraint:"The pinned profile name."},{name:"follow_up",type:"string",required:!0,constraint:"The resulting ambient effect."}],outputKind:"object",effects:["Writes this directory's pin into `~/.crouter/profile-defaults.json`. The next launch here auto-picks this profile with no prompt (override once with `crtr --pick-profile`)."]},run:n(async o=>{const r=process.cwd(),t=a(r),e=f(o.profile);if(!h(e,t))throw new c({error:"not_covered",message:`profile "${e.manifest.name}" does not cover ${t}, so a default pinned here would be ignored.`,next:`Widen its purview and choose its automatic memory disclosure cap first: \`crtr profile project add ${e.profileId} --dir ${t} --memory <none|name|preview|content>\`, then re-run this.`});return m(r,e.profileId),{dir:t,profile_id:e.profileId,name:e.manifest.name,follow_up:`Launches here now auto-pick "${e.manifest.name}".`}},"run")}),g=s({name:"clear",description:"remove the current directory's default-profile pin",whenToUse:"you no longer want a fixed default here \u2014 go back to the normal startup chooser (MRU / covering menu). No-op if nothing was pinned.",help:{name:"profile default clear",summary:"remove the current directory's default-profile pin",params:[],output:[{name:"dir",type:"string",required:!0,constraint:"The resolved directory the pin was cleared for."},{name:"cleared",type:"boolean",required:!0,constraint:"True when a pin existed and was removed; false when nothing was pinned."},{name:"follow_up",type:"string",required:!0,constraint:"Concrete next commands."}],outputKind:"object",effects:["Deletes this directory's entry from `~/.crouter/profile-defaults.json`, if present."]},run:n(async o=>{const r=process.cwd(),t=a(r),e=l(r)!==null;return w(r),{dir:t,cleared:e,follow_up:e?"The startup chooser will ask again here. Re-pin with `crtr profile default set <profile>`.":"Nothing was pinned here."}},"run")}),v=s({name:"show",description:"show the current directory's default-profile pin",whenToUse:"you want to know which profile (if any) is pinned as this directory's default.",help:{name:"profile default show",summary:"report the current directory's pinned default profile, or none",params:[],output:[{name:"dir",type:"string",required:!0,constraint:"The resolved directory queried."},{name:"pinned",type:"boolean",required:!0,constraint:"True when a default is pinned here."},{name:"profile_id",type:"string",required:!1,constraint:"The pinned profile id, when pinned."},{name:"name",type:"string",required:!1,constraint:"The pinned profile name, when it still resolves."},{name:"stale",type:"boolean",required:!1,constraint:"True when a pin exists but its profile no longer resolves (deleted); the selector will self-heal it on next launch."},{name:"follow_up",type:"string",required:!0,constraint:"Concrete next commands."}],outputKind:"object",effects:["Read-only."]},run:n(async o=>{const r=process.cwd(),t=a(r),e=l(r);if(e===null)return{dir:t,pinned:!1,follow_up:"Pin one with `crtr profile default set <profile>`."};let i;try{i=u(e).manifest.name}catch{i=void 0}return{dir:t,pinned:!0,profile_id:e,...i!==void 0?{name:i}:{stale:!0},follow_up:i!==void 0?"Change it with `crtr profile default set <profile>`, or clear it with `crtr profile default clear`.":"This profile no longer exists; clear the stale pin with `crtr profile default clear`."}},"run")}),x=d({name:"default",description:"manage this directory's default-profile pin",whenToUse:"setting, clearing, or inspecting which profile a directory defaults to at startup \u2014 so crtr stops asking. Directory-scoped, independent of project purview and automatic memory disclosure.",help:{name:"profile default",summary:"the per-directory default profile \u2014 pin one so the startup chooser stops asking",model:"A pin binds the CURRENT directory to a profile: launches here auto-pick it with no prompt (`crtr --pick-profile` reopens the chooser once). `set` pins a profile (which must already cover this dir), `clear` removes the pin, `show` reports it. This is directory-scoped selection, independent of `crtr profile project`: project `path` values govern purview and each `memory` value caps automatic disclosure. The startup menu's `d` action writes the same pin."},children:[y,g,v]});export{x as defaultBranch};

package/dist/commands/profile/delete.js

@@ -1,66 +1 @@
-import { envNodeId } from '../../shared/env.js';
-import { defineLeaf } from '../../core/command.js';
-import { cliClient, rethrowAsCliError } from '../api-client.js';
-export const deleteLeaf = defineLeaf({
-    name: 'delete',
-    description: 'force-delete a profile and its owned runtime state',
-    whenToUse: 'a profile is no longer needed and you intend either to remove every node and schedule pinned to it, or to preserve that state while detaching the profile identity',
-    help: {
-        name: 'profile delete',
-        summary: 'force-delete a profile and its owned state, or detach that state before removing the profile',
-        params: [
-            {
-                kind: 'positional',
-                name: 'profile',
-                required: true,
-                constraint: 'Exact profile id, or a unique manifest name. Deletion never guesses at a near miss — unlike every other profile verb, an unrecognized value fails.',
-            },
-            {
-                kind: 'flag',
-                name: 'force',
-                type: 'bool',
-                required: true,
-                constraint: 'Required confirmation for this irreversible operation.',
-            },
-            {
-                kind: 'flag',
-                name: 'detach',
-                type: 'bool',
-                required: false,
-                constraint: 'Preserve nodes and inbox/review history; clear their profile identity and globalize matching crons before removing the profile.',
-            },
-        ],
-        output: [
-            { name: 'profile_id', type: 'string', required: true, constraint: 'The removed profile’s stable id.' },
-            { name: 'name', type: 'string', required: true, constraint: 'The removed profile’s manifest name.' },
-            { name: 'mode', type: 'string', required: true, constraint: '`deleted` for the destructive cascade; `detached` when --detach preserved nodes and history.' },
-            { name: 'nodes', type: 'number', required: true, constraint: 'Nodes hard-deleted or detached.' },
-            { name: 'crons', type: 'number', required: true, constraint: 'Crons deleted or globalized.' },
-            { name: 'tickets', type: 'number', required: true, constraint: 'Originating inbox ticket directories removed; zero in detach mode.' },
-            { name: 'reviews', type: 'number', required: true, constraint: 'Originating daemon review records removed; zero in detach mode.' },
-            { name: 'default_pins', type: 'number', required: true, constraint: 'Per-directory default profile pins cleared.' },
-            { name: 'accepted', type: 'boolean', required: false, constraint: 'True when the invoking node belongs to the profile and teardown begins after this result settles.' },
-            { name: 'grace_ms', type: 'number', required: false, constraint: 'Acknowledgement grace before an accepted self-deletion begins.' },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'Concrete next action.' },
-        ],
-        outputKind: 'object',
-        effects: [
-            'Always clears every per-directory default pin for the profile and removes the profile directory last. Blocks before mutation while any matching node owns an open managed worktree.',
-            'Without --detach: tears down and hard-deletes every node whose profile_id matches, deletes matching or anchored crons and their in-flight runs, and removes originating inbox tickets plus review records. Cross-profile children are preserved.',
-            'With --detach: preserves nodes, conversations, topology, inbox tickets, and reviews; rewrites node profile_id to null, restarts active brokers without the profile, and rewrites matching crons to global scope.',
-        ],
-    },
-    run: async (input) => {
-        const result = await cliClient().deleteProfile(input['profile'], {
-            force: input['force'],
-            detach: input['detach'],
-            caller_node_id: envNodeId() ?? null,
-        }).catch(rethrowAsCliError);
-        return {
-            ...result,
-            follow_up: result.accepted === true
-                ? 'The deletion was accepted; this node will stop after its result settles.'
-                : 'Run `crtr profile list` to see remaining profiles.',
-        };
-    },
-});
+var n=Object.defineProperty;var t=(e,r)=>n(e,"name",{value:r,configurable:!0});import{envNodeId as o}from"../../shared/env.js";import{defineLeaf as i}from"../../core/command.js";import{cliClient as a,rethrowAsCliError as d}from"../api-client.js";const u=i({name:"delete",description:"force-delete a profile and its owned runtime state",whenToUse:"a profile is no longer needed and you intend either to remove every node and schedule pinned to it, or to preserve that state while detaching the profile identity",help:{name:"profile delete",summary:"force-delete a profile and its owned state, or detach that state before removing the profile",params:[{kind:"positional",name:"profile",required:!0,constraint:"Exact profile id, or a unique manifest name. Deletion never guesses at a near miss \u2014 unlike every other profile verb, an unrecognized value fails."},{kind:"flag",name:"force",type:"bool",required:!0,constraint:"Required confirmation for this irreversible operation."},{kind:"flag",name:"detach",type:"bool",required:!1,constraint:"Preserve nodes and inbox/review history; clear their profile identity and globalize matching crons before removing the profile."}],output:[{name:"profile_id",type:"string",required:!0,constraint:"The removed profile\u2019s stable id."},{name:"name",type:"string",required:!0,constraint:"The removed profile\u2019s manifest name."},{name:"mode",type:"string",required:!0,constraint:"`deleted` for the destructive cascade; `detached` when --detach preserved nodes and history."},{name:"nodes",type:"number",required:!0,constraint:"Nodes hard-deleted or detached."},{name:"crons",type:"number",required:!0,constraint:"Crons deleted or globalized."},{name:"tickets",type:"number",required:!0,constraint:"Originating inbox ticket directories removed; zero in detach mode."},{name:"reviews",type:"number",required:!0,constraint:"Originating daemon review records removed; zero in detach mode."},{name:"default_pins",type:"number",required:!0,constraint:"Per-directory default profile pins cleared."},{name:"accepted",type:"boolean",required:!1,constraint:"True when the invoking node belongs to the profile and teardown begins after this result settles."},{name:"grace_ms",type:"number",required:!1,constraint:"Acknowledgement grace before an accepted self-deletion begins."},{name:"follow_up",type:"string",required:!0,constraint:"Concrete next action."}],outputKind:"object",effects:["Always clears every per-directory default pin for the profile and removes the profile directory last. Blocks before mutation while any matching node owns an open managed worktree.","Without --detach: tears down and hard-deletes every node whose profile_id matches, deletes matching or anchored crons and their in-flight runs, and removes originating inbox tickets plus review records. Cross-profile children are preserved.","With --detach: preserves nodes, conversations, topology, inbox tickets, and reviews; rewrites node profile_id to null, restarts active brokers without the profile, and rewrites matching crons to global scope."]},run:t(async e=>{const r=await a().deleteProfile(e.profile,{force:e.force,detach:e.detach,caller_node_id:o()??null}).catch(d);return{...r,follow_up:r.accepted===!0?"The deletion was accepted; this node will stop after its result settles.":"Run `crtr profile list` to see remaining profiles."}},"run")});export{u as deleteLeaf};

package/dist/commands/profile/env.js

@@ -1,188 +1,3 @@
-// `crtr profile env` — a profile-scoped store of env vars, injected directly
-// into every broker launched under that profile (`buildBrokerEnv`,
-// `core/runtime/spawn-env.ts`), independent of the daemon's own ambient env
-// or any `.envrc`/`.env` a node's cwd carries. Setting a value here IS the
-// consent to cross the spawn boundary — no matching `spawnEnv.allow` entry is
-// needed. Values are write-only from this surface: `set` and `remove` never
-// echo a value back, and `list` reports names only. See
-// `core/profiles/env-store.ts` for the on-disk (0600) store this wraps.
-import { defineLeaf, defineBranch } from '../../core/command.js';
-import { InputError } from '../../core/io.js';
-import { resolveProfileOperand } from '../../core/profiles/manifest.js';
-import { validateEnvVarName } from '../../core/env-name.js';
-import { listProfileEnvNames, setProfileEnvVar, removeProfileEnvVar } from '../../core/profiles/env-store.js';
-/** Strips exactly one trailing line ending (`\r\n` or `\n`) — the one
- *  documented byte the piped-value contract trims — and leaves every other
- *  byte (leading/trailing spaces, tabs, embedded newlines) untouched. A
- *  single-quoted heredoc (`<<'EOF'`) always appends exactly one such
- *  terminator; anything beyond that is content the caller wrote on purpose. */
-function stripSingleTrailingLineEnding(raw) {
-    if (raw.endsWith('\r\n'))
-        return raw.slice(0, -2);
-    if (raw.endsWith('\n'))
-        return raw.slice(0, -1);
-    return raw;
-}
-function requireValidName(name) {
-    const check = validateEnvVarName(name);
-    if (!check.isValid) {
-        throw new InputError({
-            error: 'invalid_name',
-            message: `invalid --name: ${check.errors.join('; ')}`,
-            field: 'name',
-            received: name,
-            next: 'Use an env-var-shaped name: starts with a letter or underscore, followed by letters, digits, or underscores.',
-        });
-    }
-}
-const setLeaf = defineLeaf({
-    name: 'set',
-    description: 'store one env var for a profile, value piped on stdin',
-    whenToUse: 'a profile needs a credential or config value injected directly into every broker launched under it \u2014 e.g. a HTTP-transport plugin\u2019s `auth-env` token. Setting it here crosses the broker spawn boundary with no separate `spawnEnv.allow` entry required; re-running with the same name overwrites the value.',
-    help: {
-        name: 'profile env set',
-        summary: 'write (or overwrite) one env var in a profile\u2019s 0600 env store',
-        params: [
-            {
-                kind: 'positional',
-                name: 'profile',
-                required: true,
-                constraint: 'Profile id or manifest name; a close-enough name resolves to the nearest profile, reported on stderr.',
-            },
-            {
-                kind: 'flag',
-                name: 'name',
-                type: 'string',
-                required: true,
-                constraint: 'Env var name. Must start with a letter or underscore, followed by letters, digits, or underscores (e.g. NL_CORE_TOKEN).',
-            },
-            {
-                kind: 'stdin',
-                name: 'value',
-                required: true,
-                constraint: 'The raw value, piped on stdin \u2014 never as an argv value, to keep it out of shell history. Pipe from a single-quoted heredoc (`<<\'EOF\'`) or `echo -n "$VALUE" |` to preserve exact bytes; trailing newline is trimmed.',
-            },
-        ],
-        output: [
-            { name: 'profile_id', type: 'string', required: true, constraint: 'Stable directory id.' },
-            { name: 'created', type: 'boolean', required: true, constraint: 'true when this name was newly added, false when it replaced an existing value.' },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'The effect on already-running nodes.' },
-        ],
-        outputKind: 'object',
-        effects: [
-            'Writes {name: value} to the profile\u2019s 0600 env.json, replacing any prior value under the same name.',
-            'Every broker launched under this profile from now on injects this value directly into its process env \u2014 independent of the daemon\u2019s ambient env, no `spawnEnv.allow` entry needed. Already-running brokers keep whatever env they launched with; a running node picks up a new/changed value only on its next revive.',
-        ],
-    },
-    run: async (input) => {
-        const name = input['name'];
-        requireValidName(name);
-        const { profileId } = resolveProfileOperand(input['profile']);
-        const value = stripSingleTrailingLineEnding(input['value'] ?? '');
-        if (value === '') {
-            throw new InputError({
-                error: 'empty_value',
-                message: 'env var value is empty',
-                field: 'value',
-                next: 'Pipe a non-empty value on stdin.',
-            });
-        }
-        const created = setProfileEnvVar(profileId, name, value);
-        return {
-            profile_id: profileId,
-            created,
-            follow_up: 'A running node under this profile picks up the change on its next revive.',
-        };
-    },
-});
-const listLeaf = defineLeaf({
-    name: 'list',
-    description: 'inventory a profile\u2019s stored env var NAMES \u2014 never values',
-    whenToUse: 'you want to know which env vars a profile has set, without exposing any value. Values never leave the 0600 store \u2014 there is no leaf that reads one back.',
-    help: {
-        name: 'profile env list',
-        summary: 'the sorted list of env var names stored for a profile',
-        params: [
-            {
-                kind: 'positional',
-                name: 'profile',
-                required: true,
-                constraint: 'Profile id or manifest name; a close-enough name resolves to the nearest profile, reported on stderr.',
-            },
-        ],
-        output: [
-            { name: 'profile_id', type: 'string', required: true, constraint: 'Stable directory id.' },
-            { name: 'names', type: 'string[]', required: true, constraint: 'Every stored env var name, sorted. Empty when nothing is stored.' },
-            { name: 'count', type: 'int', required: true, constraint: 'names.length.' },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'Concrete next commands.' },
-        ],
-        outputKind: 'object',
-        effects: ['None. Read-only \u2014 and value-blind by construction: this leaf never reads the stored values.'],
-    },
-    run: async (input) => {
-        const { profileId } = resolveProfileOperand(input['profile']);
-        const names = listProfileEnvNames(profileId);
-        return {
-            profile_id: profileId,
-            names,
-            count: names.length,
-            follow_up: names.length > 0
-                ? `Remove one with \`crtr profile env remove ${profileId} --name <name>\`.`
-                : `Set one with \`crtr profile env set ${profileId} --name <name>\`.`,
-        };
-    },
-});
-const removeLeaf = defineLeaf({
-    name: 'remove',
-    description: 'delete one stored env var from a profile',
-    whenToUse: 'an env var a profile owns is no longer needed \u2014 remove it so future brokers launched under this profile stop receiving it. No-op-shaped success (`removed: false`) if it was never set.',
-    help: {
-        name: 'profile env remove',
-        summary: 'delete one env var from a profile\u2019s 0600 env store',
-        params: [
-            {
-                kind: 'positional',
-                name: 'profile',
-                required: true,
-                constraint: 'Profile id or manifest name; a close-enough name resolves to the nearest profile, reported on stderr.',
-            },
-            {
-                kind: 'flag',
-                name: 'name',
-                type: 'string',
-                required: true,
-                constraint: 'Env var name. Must start with a letter or underscore, followed by letters, digits, or underscores (e.g. NL_CORE_TOKEN).',
-            },
-        ],
-        output: [
-            { name: 'profile_id', type: 'string', required: true, constraint: 'Stable directory id.' },
-            { name: 'removed', type: 'boolean', required: true, constraint: 'true when a value existed and was removed; false when nothing was stored under this name.' },
-        ],
-        outputKind: 'object',
-        effects: [
-            'Deletes {name} from the profile\u2019s 0600 env.json, if present.',
-            'Already-running brokers keep whatever env they launched with; a running node stops receiving this value only on its next revive.',
-        ],
-    },
-    run: async (input) => {
-        const { profileId } = resolveProfileOperand(input['profile']);
-        const name = input['name'];
-        requireValidName(name);
-        const removed = removeProfileEnvVar(profileId, name);
-        return {
-            profile_id: profileId,
-            removed,
-        };
-    },
-});
-export const envBranch = defineBranch({
-    name: 'env',
-    description: 'manage a profile-scoped store of env vars injected into its brokers',
-    whenToUse: 'a profile needs a credential or config value available directly to every broker (and thus every node) launched under it \u2014 e.g. a HTTP-transport plugin\u2019s `auth-env` token \u2014 without exporting it into the daemon\u2019s own ambient shell or granting a `spawnEnv.allow` passthrough.',
-    help: {
-        name: 'profile env',
-        summary: 'a profile\u2019s own 0600 store of env vars, injected directly into every broker launched under it',
-        model: 'Values are write-only from this surface: `set` stores one (value piped on stdin, never argv), `remove` deletes one, `list` reports NAMES only \u2014 no leaf ever reads a value back. `buildBrokerEnv` (`core/runtime/spawn-env.ts`) reads the store straight off disk at every broker launch and injects each value directly into that broker\u2019s process env, independent of the daemon\u2019s own ambient env or any `.envrc`/`.env` a node\u2019s cwd carries. Setting a value here IS the operator\u2019s consent to cross the spawn boundary \u2014 it needs no matching `spawnEnv.allow` entry. A change only reaches an already-running node on its next revive.',
-    },
-    children: [setLeaf, listLeaf, removeLeaf],
-});
+var u=Object.defineProperty;var t=(e,n)=>u(e,"name",{value:n,configurable:!0});import{defineLeaf as a,defineBranch as v}from"../../core/command.js";import{InputError as s}from"../../core/io.js";import{resolveProfileOperand as i}from"../../core/profiles/manifest.js";import{validateEnvVarName as p}from"../../core/env-name.js";import{listProfileEnvNames as c,setProfileEnvVar as m,removeProfileEnvVar as f}from"../../core/profiles/env-store.js";function h(e){return e.endsWith(`\r
+`)?e.slice(0,-2):e.endsWith(`
+`)?e.slice(0,-1):e}t(h,"stripSingleTrailingLineEnding");function l(e){const n=p(e);if(!n.isValid)throw new s({error:"invalid_name",message:`invalid --name: ${n.errors.join("; ")}`,field:"name",received:e,next:"Use an env-var-shaped name: starts with a letter or underscore, followed by letters, digits, or underscores."})}t(l,"requireValidName");const y=a({name:"set",description:"store one env var for a profile, value piped on stdin",whenToUse:"a profile needs a credential or config value injected directly into every broker launched under it \u2014 e.g. a HTTP-transport plugin\u2019s `auth-env` token. Setting it here crosses the broker spawn boundary with no separate `spawnEnv.allow` entry required; re-running with the same name overwrites the value.",help:{name:"profile env set",summary:"write (or overwrite) one env var in a profile\u2019s 0600 env store",params:[{kind:"positional",name:"profile",required:!0,constraint:"Profile id or manifest name; a close-enough name resolves to the nearest profile, reported on stderr."},{kind:"flag",name:"name",type:"string",required:!0,constraint:"Env var name. Must start with a letter or underscore, followed by letters, digits, or underscores (e.g. NL_CORE_TOKEN)."},{kind:"stdin",name:"value",required:!0,constraint:"The raw value, piped on stdin \u2014 never as an argv value, to keep it out of shell history. Pipe from a single-quoted heredoc (`<<'EOF'`) or `echo -n \"$VALUE\" |` to preserve exact bytes; trailing newline is trimmed."}],output:[{name:"profile_id",type:"string",required:!0,constraint:"Stable directory id."},{name:"created",type:"boolean",required:!0,constraint:"true when this name was newly added, false when it replaced an existing value."},{name:"follow_up",type:"string",required:!0,constraint:"The effect on already-running nodes."}],outputKind:"object",effects:["Writes {name: value} to the profile\u2019s 0600 env.json, replacing any prior value under the same name.","Every broker launched under this profile from now on injects this value directly into its process env \u2014 independent of the daemon\u2019s ambient env, no `spawnEnv.allow` entry needed. Already-running brokers keep whatever env they launched with; a running node picks up a new/changed value only on its next revive."]},run:t(async e=>{const n=e.name;l(n);const{profileId:r}=i(e.profile),o=h(e.value??"");if(o==="")throw new s({error:"empty_value",message:"env var value is empty",field:"value",next:"Pipe a non-empty value on stdin."});const d=m(r,n,o);return{profile_id:r,created:d,follow_up:"A running node under this profile picks up the change on its next revive."}},"run")}),g=a({name:"list",description:"inventory a profile\u2019s stored env var NAMES \u2014 never values",whenToUse:"you want to know which env vars a profile has set, without exposing any value. Values never leave the 0600 store \u2014 there is no leaf that reads one back.",help:{name:"profile env list",summary:"the sorted list of env var names stored for a profile",params:[{kind:"positional",name:"profile",required:!0,constraint:"Profile id or manifest name; a close-enough name resolves to the nearest profile, reported on stderr."}],output:[{name:"profile_id",type:"string",required:!0,constraint:"Stable directory id."},{name:"names",type:"string[]",required:!0,constraint:"Every stored env var name, sorted. Empty when nothing is stored."},{name:"count",type:"int",required:!0,constraint:"names.length."},{name:"follow_up",type:"string",required:!0,constraint:"Concrete next commands."}],outputKind:"object",effects:["None. Read-only \u2014 and value-blind by construction: this leaf never reads the stored values."]},run:t(async e=>{const{profileId:n}=i(e.profile),r=c(n);return{profile_id:n,names:r,count:r.length,follow_up:r.length>0?`Remove one with \`crtr profile env remove ${n} --name <name>\`.`:`Set one with \`crtr profile env set ${n} --name <name>\`.`}},"run")}),w=a({name:"remove",description:"delete one stored env var from a profile",whenToUse:"an env var a profile owns is no longer needed \u2014 remove it so future brokers launched under this profile stop receiving it. No-op-shaped success (`removed: false`) if it was never set.",help:{name:"profile env remove",summary:"delete one env var from a profile\u2019s 0600 env store",params:[{kind:"positional",name:"profile",required:!0,constraint:"Profile id or manifest name; a close-enough name resolves to the nearest profile, reported on stderr."},{kind:"flag",name:"name",type:"string",required:!0,constraint:"Env var name. Must start with a letter or underscore, followed by letters, digits, or underscores (e.g. NL_CORE_TOKEN)."}],output:[{name:"profile_id",type:"string",required:!0,constraint:"Stable directory id."},{name:"removed",type:"boolean",required:!0,constraint:"true when a value existed and was removed; false when nothing was stored under this name."}],outputKind:"object",effects:["Deletes {name} from the profile\u2019s 0600 env.json, if present.","Already-running brokers keep whatever env they launched with; a running node stops receiving this value only on its next revive."]},run:t(async e=>{const{profileId:n}=i(e.profile),r=e.name;l(r);const o=f(n,r);return{profile_id:n,removed:o}},"run")}),T=v({name:"env",description:"manage a profile-scoped store of env vars injected into its brokers",whenToUse:"a profile needs a credential or config value available directly to every broker (and thus every node) launched under it \u2014 e.g. a HTTP-transport plugin\u2019s `auth-env` token \u2014 without exporting it into the daemon\u2019s own ambient shell or granting a `spawnEnv.allow` passthrough.",help:{name:"profile env",summary:"a profile\u2019s own 0600 store of env vars, injected directly into every broker launched under it",model:"Values are write-only from this surface: `set` stores one (value piped on stdin, never argv), `remove` deletes one, `list` reports NAMES only \u2014 no leaf ever reads a value back. `buildBrokerEnv` (`core/runtime/spawn-env.ts`) reads the store straight off disk at every broker launch and injects each value directly into that broker\u2019s process env, independent of the daemon\u2019s own ambient env or any `.envrc`/`.env` a node\u2019s cwd carries. Setting a value here IS the operator\u2019s consent to cross the spawn boundary \u2014 it needs no matching `spawnEnv.allow` entry. A change only reaches an already-running node on its next revive."},children:[y,g,w]});export{T as envBranch};

package/dist/commands/profile/kind.js

@@ -1,35 +1,2 @@
-import { defineLeaf } from '../../core/command.js';
-import { assertInstalledKind, readMergedLaunchConfig } from '../../core/config.js';
-import { resolveProfileOperand, setProfileDefaultKind } from '../../core/profiles/manifest.js';
-import { stateBlock } from '../../core/help.js';
-function kindsStateBlock() {
-    return stateBlock('kinds', { count: Object.keys(readMergedLaunchConfig().kinds).length }, Object.keys(readMergedLaunchConfig().kinds).sort().join('\n'));
-}
-export const kindLeaf = defineLeaf({
-    name: 'kind',
-    description: "set a profile's default node kind",
-    whenToUse: 'nodes created under a profile without `--kind` should use a persona other than `general`.',
-    help: {
-        name: 'profile kind',
-        summary: "set a profile's manifest `default_kind` for creates that omit --kind",
-        params: [
-            { kind: 'positional', name: 'profile', required: true, constraint: 'Profile id or manifest name; a close-enough name resolves to the nearest profile, reported on stderr.' },
-            { kind: 'positional', name: 'kind', required: true, constraint: 'Installed persona kind to use by default. The live <kinds> list below is the accepted value set.' },
-        ],
-        output: [
-            { name: 'profile_id', type: 'string', required: true, constraint: 'Stable directory id.' },
-        ],
-        dynamicState: kindsStateBlock,
-        outputKind: 'object',
-        effects: ["Sets the profile manifest's `default_kind`. Future node creates under the profile that omit --kind resolve to it server-side."],
-    },
-    run: async (input) => {
-        const kind = input['kind'];
-        assertInstalledKind(kind);
-        const { profileId } = resolveProfileOperand(input['profile']);
-        const { manifest } = setProfileDefaultKind(profileId, kind);
-        return {
-            profile_id: profileId,
-        };
-    },
-});
+var o=Object.defineProperty;var n=(e,t)=>o(e,"name",{value:t,configurable:!0});import{defineLeaf as s}from"../../core/command.js";import{assertInstalledKind as a,readMergedLaunchConfig as r}from"../../core/config.js";import{resolveProfileOperand as d,setProfileDefaultKind as l}from"../../core/profiles/manifest.js";import{stateBlock as f}from"../../core/help.js";function u(){return f("kinds",{count:Object.keys(r().kinds).length},Object.keys(r().kinds).sort().join(`
+`))}n(u,"kindsStateBlock");const b=s({name:"kind",description:"set a profile's default node kind",whenToUse:"nodes created under a profile without `--kind` should use a persona other than `general`.",help:{name:"profile kind",summary:"set a profile's manifest `default_kind` for creates that omit --kind",params:[{kind:"positional",name:"profile",required:!0,constraint:"Profile id or manifest name; a close-enough name resolves to the nearest profile, reported on stderr."},{kind:"positional",name:"kind",required:!0,constraint:"Installed persona kind to use by default. The live <kinds> list below is the accepted value set."}],output:[{name:"profile_id",type:"string",required:!0,constraint:"Stable directory id."}],dynamicState:u,outputKind:"object",effects:["Sets the profile manifest's `default_kind`. Future node creates under the profile that omit --kind resolve to it server-side."]},run:n(async e=>{const t=e.kind;a(t);const{profileId:i}=d(e.profile),{manifest:p}=l(i,t);return{profile_id:i}},"run")});export{b as kindLeaf};