@north-light/crouter 0.3.230 → 0.3.232

package/dist/commands/node/wait.js

@@ -124,7 +124,6 @@ const nodeWait = defineLeaf({
         ],
         output: [
             { name: 'node_id', type: 'string', required: true, constraint: 'The terminal node that declared the wait.' },
-            { name: 'controller', type: 'string', required: true, constraint: 'The named live sender whose next inbox delivery clears this wait.' },
         ],
         outputKind: 'object',
         effects: ['Durably records the controller on this node. The stop guard permits dormancy only while that controller remains active or idle; its next inbox delivery clears the record before the delivery wakes this node.'],
@@ -146,9 +145,9 @@ const nodeWait = defineLeaf({
         await cliClient()
             .waitNode(nodeId, { controller })
             .catch((err) => rethrowAsCliError(err));
-        return { node_id: nodeId, controller };
+        return { node_id: nodeId };
     },
-    render: (r) => `Waiting for controller ${r['controller']}. End your turn to dorm; its next message wakes you and clears this wait.`,
+    render: () => 'Waiting for the controller. End your turn to dorm; its next message wakes you and clears this wait.',
 });
 export const nodeWaitBranch = defineBranch({
     name: 'wait',

package/dist/commands/node-lifecycle-revive.js

@@ -101,11 +101,10 @@ export const nodeReviveLeaf = defineLeaf({
             },
         ],
         output: [
-            { name: 'window', type: 'string', required: false, constraint: 'Always null — the revived broker is headless and opens no tmux window. Kept for caller back-compat.' },
-            { name: 'session', type: 'string', required: false, constraint: 'The node\'s last live location session, or null — the headless broker has no tmux session of its own.' },
             { name: 'resumed', type: 'boolean', required: false, constraint: 'True ONLY for a true resume (the existing `.jsonl` replayed as-is). False for a --fresh revive, whether that landed as an in-place CYCLE (an existing `.jsonl` reused with a fresh `crtr-cycle` branch — pi is still told --session, but this is not a resume) or a genuinely fresh launch (no `.jsonl` existed). Absent for a --now kick.' },
             { name: 'ready', type: 'boolean', required: false, constraint: 'True when the revived broker\'s view.sock accepted a connection before return — the node is immediately attachable/drivable. Absent for a --now kick.' },
             { name: 'kicked', type: 'boolean', required: false, constraint: 'True when --now SIGTERM\'d the hanging node\'s live broker (the daemon resumes it on the saved session within ~20s). Absent for an ordinary revive.' },
+            { name: 'message', type: 'string', required: false, constraint: 'Kick confirmation naming the signalled node, pid, and the daemon\'s ~20s resume handoff. Present only for --now.' },
         ],
         outputKind: 'object',
         effects: [
@@ -192,10 +191,6 @@ export const nodeReviveLeaf = defineLeaf({
                 /* best-effort: the broker may have just died; the daemon owns the resume */
             }
             return {
-                window: null,
-                // The DTO carries no `tmux_session` (the headless broker has none); the
-                // pre-API leaf returned `meta.tmux_session ?? null`, which is null here.
-                session: null,
                 kicked: true,
                 message: `Sent SIGTERM to ${fullName(detail)} (${nodeId}, pid ${pid}). The daemon will resume it on the saved session within ~20s (crash→grace→resume).`,
             };
@@ -227,12 +222,6 @@ export const nodeReviveLeaf = defineLeaf({
         // return need this leaf to wait until the socket accepts.
         const ready = await waitForViewSocketReady(nodeId);
         return {
-            // Always null (broker headless, no tmux window); `undefined` omits it from
-            // the JSON payload, matching the pre-API leaf's `result.window ?? undefined`.
-            window: undefined,
-            // The revive DTO carries no location session (the headless broker has none);
-            // the pre-API leaf returned `result.session`, which was null here.
-            session: null,
             resumed: result.resumed,
             ready,
         };

package/dist/commands/pkg/browse/actions.js

@@ -186,9 +186,8 @@ export async function runAction(request) {
                     return missing("Choose a marketplace to remove.");
                 if (request.scope === undefined)
                     return missing("Choose a marketplace scope to remove.");
-                const result = asRecord(await marketRemove.run({ name: request.marketplace, scope: request.scope }));
-                const name = typeof result["name"] === "string" ? result["name"] : request.marketplace;
-                return { ok: true, message: `Removed marketplace ${name}.` };
+                await marketRemove.run({ name: request.marketplace, scope: request.scope });
+                return { ok: true, message: `Removed marketplace ${request.marketplace}.` };
             }
         }
         return missing("Unsupported action.");

package/dist/commands/pkg/market-manage.js

@@ -86,10 +86,7 @@ export const marketRemove = defineLeaf({
             { kind: 'positional', name: 'name', type: 'string', required: true, constraint: 'Marketplace name to remove.' },
             { kind: 'flag', name: 'scope', type: 'enum', choices: ['user', 'project'], required: false, constraint: 'Narrows resolution.' },
         ],
-        output: [
-            { name: 'name', type: 'string', required: true, constraint: 'Removed marketplace name.' },
-            { name: 'removed', type: 'boolean', required: true, constraint: 'Always true on success.' },
-        ],
+        output: [],
         outputKind: 'object',
         effects: ['Deletes the marketplace directory. Removes the entry from config.json. Removes plugin files and config entries sourced from that marketplace in the same scope.'],
     },
@@ -144,7 +141,7 @@ export const marketRemove = defineLeaf({
                 delete c.plugins[pluginName];
             }
         });
-        return { name, removed: true };
+        return {};
     },
 });
 /** Stage a fresh checkout beside the active root. A clone that fails throws

package/dist/commands/pkg/plugin-manage.js

@@ -793,7 +793,6 @@ export const pluginRemove = defineLeaf({
             { kind: 'flag', name: 'scope', type: 'enum', choices: ['user', 'project'], required: false, constraint: 'Default: searches all scopes.' },
         ],
         output: [
-            { name: 'removed', type: 'boolean', required: true, constraint: 'True if removed from at least one scope.' },
             { name: 'scopes', type: 'string[]', required: true, constraint: 'Scopes the plugin was removed from.' },
         ],
         outputKind: 'object',
@@ -832,7 +831,7 @@ export const pluginRemove = defineLeaf({
         if (removedFrom.length === 0) {
             throw notFound(`plugin not found: ${name}`);
         }
-        return { removed: true, scopes: removedFrom };
+        return { scopes: removedFrom };
     },
 });
 export const pluginEnable = defineLeaf({
@@ -847,9 +846,7 @@ export const pluginEnable = defineLeaf({
             { kind: 'flag', name: 'scope', type: 'enum', choices: ['user', 'project'], required: false, constraint: 'Default: scope where the plugin is installed.' },
         ],
         output: [
-            { name: 'name', type: 'string', required: true, constraint: 'Plugin name.' },
             { name: 'scope', type: 'string', required: true, constraint: 'Scope the change was applied in.' },
-            { name: 'enabled', type: 'boolean', required: true, constraint: 'Always true.' },
             { name: 'memory', type: 'object', required: false, constraint: 'Present only when the plugin ships a memory store. {docs: integer (documents checked), migrated: string[] (store-relative documents rewritten to reach exact canonical identity), linkedSource?: string (the caller-owned directory converged in place, present only for a symlinked install)}.' },
         ],
         outputKind: 'object',
@@ -868,7 +865,8 @@ export const pluginEnable = defineLeaf({
             throw notFound(`plugin manifest not found at ${target.root}/.crouter-plugin/plugin.json`);
         const scopeRootPath = target.scope === 'project' ? requireScopeRoot('project') : userScopeRoot();
         const memory = await assertPluginCandidateValid(manifest, target.root, target.scope, scopeRootPath, `${target.root}/.crouter-plugin/plugin.json`, undefined, isSymlink(target.root) ? 'linked' : 'package');
-        return { ...(await setPluginEnabled(input, true)), ...(memory !== undefined ? { memory } : {}) };
+        const result = await setPluginEnabled(input, true);
+        return { scope: result['scope'], ...(memory !== undefined ? { memory } : {}) };
     },
 });
 export const pluginDisable = defineLeaf({
@@ -883,14 +881,15 @@ export const pluginDisable = defineLeaf({
             { kind: 'flag', name: 'scope', type: 'enum', choices: ['user', 'project'], required: false, constraint: 'Default: scope where the plugin is installed.' },
         ],
         output: [
-            { name: 'name', type: 'string', required: true, constraint: 'Plugin name.' },
             { name: 'scope', type: 'string', required: true, constraint: 'Scope the change was applied in.' },
-            { name: 'enabled', type: 'boolean', required: true, constraint: 'Always false.' },
         ],
         outputKind: 'object',
         effects: ['Sets plugin enabled=false in config.json.'],
     },
-    run: async (input) => setPluginEnabled(input, false),
+    run: async (input) => {
+        const result = await setPluginEnabled(input, false);
+        return { scope: result['scope'] };
+    },
 });
 export const pluginUpdate = defineLeaf({
     name: 'update',

package/dist/commands/profile/default.js

@@ -1,7 +1,7 @@
 // `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 } from '../../core/profiles/manifest.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({
@@ -16,14 +16,14 @@ const setLeaf = defineLeaf({
                 kind: 'positional',
                 name: 'profile',
                 required: true,
-                constraint: 'Exact profile id, or a unique manifest name. Must already cover the current directory (be at/above/below it in its project purview); this pin does not change automatic memory disclosure.',
+                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: 'Concrete next commands.' },
+            { 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`).'],
@@ -31,7 +31,7 @@ const setLeaf = defineLeaf({
     run: async (_input) => {
         const cwd = process.cwd();
         const resolved = resolveBindingCwd(cwd);
-        const entry = loadProfileManifest(_input['profile']);
+        const entry = resolveProfileOperand(_input['profile']);
         if (!profileCoversCwd(entry, resolved)) {
             throw new InputError({
                 error: 'not_covered',
@@ -44,7 +44,7 @@ const setLeaf = defineLeaf({
             dir: resolved,
             profile_id: entry.profileId,
             name: entry.manifest.name,
-            follow_up: `Launches here now auto-pick "${entry.manifest.name}". Clear with \`crtr profile default clear\`, or reopen the chooser once with \`crtr --pick-profile\`.`,
+            follow_up: `Launches here now auto-pick "${entry.manifest.name}".`,
         };
     },
 });

package/dist/commands/profile/delete.js

@@ -12,7 +12,7 @@ export const deleteLeaf = defineLeaf({
                 kind: 'positional',
                 name: 'profile',
                 required: true,
-                constraint: 'Exact profile id, or a unique manifest name.',
+                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',

package/dist/commands/profile/env.js

@@ -8,7 +8,7 @@
 // `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 { loadProfileManifest } from '../../core/profiles/manifest.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
@@ -47,7 +47,7 @@ const setLeaf = defineLeaf({
                 kind: 'positional',
                 name: 'profile',
                 required: true,
-                constraint: 'Exact profile id, or a unique manifest name.',
+                constraint: 'Profile id or manifest name; a close-enough name resolves to the nearest profile, reported on stderr.',
             },
             {
                 kind: 'flag',
@@ -65,9 +65,8 @@ const setLeaf = defineLeaf({
         ],
         output: [
             { name: 'profile_id', type: 'string', required: true, constraint: 'Stable directory id.' },
-            { name: 'name', type: 'string', required: true, constraint: 'The env var name written.' },
             { 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: 'Concrete next commands.' },
+            { name: 'follow_up', type: 'string', required: true, constraint: 'The effect on already-running nodes.' },
         ],
         outputKind: 'object',
         effects: [
@@ -78,7 +77,7 @@ const setLeaf = defineLeaf({
     run: async (input) => {
         const name = input['name'];
         requireValidName(name);
-        const { profileId } = loadProfileManifest(input['profile']);
+        const { profileId } = resolveProfileOperand(input['profile']);
         const value = stripSingleTrailingLineEnding(input['value'] ?? '');
         if (value === '') {
             throw new InputError({
@@ -91,9 +90,8 @@ const setLeaf = defineLeaf({
         const created = setProfileEnvVar(profileId, name, value);
         return {
             profile_id: profileId,
-            name,
             created,
-            follow_up: `List stored names with \`crtr profile env list ${profileId}\`. A running node under this profile picks up the change on its next revive.`,
+            follow_up: 'A running node under this profile picks up the change on its next revive.',
         };
     },
 });
@@ -109,7 +107,7 @@ const listLeaf = defineLeaf({
                 kind: 'positional',
                 name: 'profile',
                 required: true,
-                constraint: 'Exact profile id, or a unique manifest name.',
+                constraint: 'Profile id or manifest name; a close-enough name resolves to the nearest profile, reported on stderr.',
             },
         ],
         output: [
@@ -122,7 +120,7 @@ const listLeaf = defineLeaf({
         effects: ['None. Read-only \u2014 and value-blind by construction: this leaf never reads the stored values.'],
     },
     run: async (input) => {
-        const { profileId } = loadProfileManifest(input['profile']);
+        const { profileId } = resolveProfileOperand(input['profile']);
         const names = listProfileEnvNames(profileId);
         return {
             profile_id: profileId,
@@ -146,7 +144,7 @@ const removeLeaf = defineLeaf({
                 kind: 'positional',
                 name: 'profile',
                 required: true,
-                constraint: 'Exact profile id, or a unique manifest name.',
+                constraint: 'Profile id or manifest name; a close-enough name resolves to the nearest profile, reported on stderr.',
             },
             {
                 kind: 'flag',
@@ -158,9 +156,7 @@ const removeLeaf = defineLeaf({
         ],
         output: [
             { name: 'profile_id', type: 'string', required: true, constraint: 'Stable directory id.' },
-            { name: 'name', type: 'string', required: true, constraint: 'The env var name targeted.' },
             { name: 'removed', type: 'boolean', required: true, constraint: 'true when a value existed and was removed; false when nothing was stored under this name.' },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'Concrete next commands.' },
         ],
         outputKind: 'object',
         effects: [
@@ -169,15 +165,13 @@ const removeLeaf = defineLeaf({
         ],
     },
     run: async (input) => {
-        const { profileId } = loadProfileManifest(input['profile']);
+        const { profileId } = resolveProfileOperand(input['profile']);
         const name = input['name'];
         requireValidName(name);
         const removed = removeProfileEnvVar(profileId, name);
         return {
             profile_id: profileId,
-            name,
             removed,
-            follow_up: `List remaining names with \`crtr profile env list ${profileId}\`.`,
         };
     },
 });

package/dist/commands/profile/kind.js

@@ -1,6 +1,6 @@
 import { defineLeaf } from '../../core/command.js';
 import { assertInstalledKind, readMergedLaunchConfig } from '../../core/config.js';
-import { loadProfileManifest, setProfileDefaultKind } from '../../core/profiles/manifest.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'));
@@ -13,13 +13,11 @@ export const kindLeaf = defineLeaf({
         name: 'profile kind',
         summary: "set a profile's manifest `default_kind` for creates that omit --kind",
         params: [
-            { kind: 'positional', name: 'profile', required: true, constraint: 'Exact profile id, or a unique manifest name.' },
+            { 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.' },
-            { name: 'default_kind', type: 'string', required: true, constraint: 'The installed kind stored for creates that omit --kind.' },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'Concrete next command.' },
         ],
         dynamicState: kindsStateBlock,
         outputKind: 'object',
@@ -28,12 +26,10 @@ export const kindLeaf = defineLeaf({
     run: async (input) => {
         const kind = input['kind'];
         assertInstalledKind(kind);
-        const { profileId } = loadProfileManifest(input['profile']);
+        const { profileId } = resolveProfileOperand(input['profile']);
         const { manifest } = setProfileDefaultKind(profileId, kind);
         return {
             profile_id: profileId,
-            default_kind: manifest.default_kind,
-            follow_up: `Create a node under it without --kind, or inspect it with \`crtr profile show ${profileId}\`.`,
         };
     },
 });

package/dist/commands/profile/meta.js

@@ -1,6 +1,6 @@
 import { defineLeaf } from '../../core/command.js';
 import { InputError } from '../../core/io.js';
-import { loadProfileManifest, updateProfileMetadata } from '../../core/profiles/manifest.js';
+import { resolveProfileOperand, updateProfileMetadata } from '../../core/profiles/manifest.js';
 /** Fold `KEY=VALUE` flag repetitions into one map. Key-shape validation stays
  *  with the manifest store (`assertProfileMetadata`); this only splits. */
 export function resolveMetaPairs(raw, field) {
@@ -33,14 +33,13 @@ export const metaLeaf = defineLeaf({
         name: 'profile meta',
         summary: "merge entries into (or drop entries from) a profile manifest's `metadata` map",
         params: [
-            { kind: 'positional', name: 'profile', required: true, constraint: 'Exact profile id, or a unique manifest name.' },
+            { 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: 'set', type: 'string', required: false, repeatable: true, constraint: 'KEY=VALUE to merge over the stored map (repeat per entry). KEY starts with a letter or digit, followed by letters, digits, `_`, or `-`; an existing key is overwritten.' },
             { kind: 'flag', name: 'unset', type: 'string', required: false, repeatable: true, constraint: 'KEY to remove (repeat per entry). Removing an absent key is a no-op.' },
         ],
         output: [
             { name: 'profile_id', type: 'string', required: true, constraint: 'Stable directory id.' },
             { name: 'metadata', type: 'object', required: true, constraint: 'The full resulting metadata map.' },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'Concrete next command.' },
         ],
         outputKind: 'object',
         effects: [
@@ -58,12 +57,11 @@ export const metaLeaf = defineLeaf({
                 next: 'Repeat --set/--unset per entry.',
             });
         }
-        const { profileId } = loadProfileManifest(input['profile']);
+        const { profileId } = resolveProfileOperand(input['profile']);
         const { manifest } = updateProfileMetadata(profileId, set, unset);
         return {
             profile_id: profileId,
             metadata: manifest.metadata ?? {},
-            follow_up: `Inspect it with \`crtr profile show ${profileId}\`.`,
         };
     },
 });

package/dist/commands/profile/new.js

@@ -59,14 +59,12 @@ export const newLeaf = defineLeaf({
         ],
         output: [
             { name: 'profile_id', type: 'string', required: true, constraint: 'Stable directory id (`<slug>-<shortid>`). Pass this, or the name, to every other `profile` verb and to `--profile` elsewhere.' },
-            { name: 'name', type: 'string', required: true, constraint: 'The manifest name as given.' },
             { name: 'path', type: 'string', required: true, constraint: 'Absolute path to the profile directory.' },
             { name: 'projects', type: 'ProfileProject[]', required: true, constraint: 'Explicit `{path, memory}` project relationships in manifest order. `path` defines purview; `memory` caps automatic boot and workspace-open disclosure. Empty when --project was omitted.' },
             { name: 'home', type: 'string | null', required: true, constraint: 'Directory the profile\u2019s nodes are pinned to — the initial project, or null when none was given.' },
             { name: 'default_kind', type: 'string | null', required: true, constraint: 'Stored default persona kind, or null when node creates default to general.' },
             { name: 'metadata', type: 'object', required: true, constraint: 'Stored metadata map; empty when --meta was omitted.' },
             { name: 'created_at', type: 'string', required: true, constraint: 'ISO 8601 creation timestamp.' },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'Concrete next commands.' },
         ],
         outputKind: 'object',
         effects: ['Creates `<profile-dir>/profile.json` and `<profile-dir>/memory/` (the fixed root dir when `--root`).'],
@@ -85,14 +83,12 @@ export const newLeaf = defineLeaf({
             const { profileId, manifest } = ensureRootProfile();
             return {
                 profile_id: profileId,
-                name: manifest.name,
                 path: profileRoot(profileId),
                 projects: manifest.projects,
                 home: manifest.home,
                 default_kind: manifest.default_kind ?? null,
                 metadata: manifest.metadata ?? {},
                 created_at: manifest.created_at,
-                follow_up: `Root profile ensured. Spawn nodes under it with \`--profile ${profileId}\`, or widen its purview and choose its automatic memory disclosure cap with \`crtr profile project add ${profileId} --dir <path> --memory <none|name|preview|content>\`.`,
             };
         }
         if (name === undefined)
@@ -108,14 +104,12 @@ export const newLeaf = defineLeaf({
         });
         return {
             profile_id: profileId,
-            name: manifest.name,
             path: profileRoot(profileId),
             projects: manifest.projects,
             home: manifest.home,
             default_kind: manifest.default_kind ?? null,
             metadata: manifest.metadata ?? {},
             created_at: manifest.created_at,
-            follow_up: `Show it with \`crtr profile show ${profileId}\`, add purview and choose its automatic memory disclosure cap with \`crtr profile project add ${profileId} --dir <path> --memory <none|name|preview|content>\`, or list every profile with \`crtr profile list\`.`,
         };
     },
 });

package/dist/commands/profile/pause.js

@@ -1,10 +1,10 @@
 import { defineLeaf } from '../../core/command.js';
-import { loadProfileManifest, pauseProfile, resumeProfile } from '../../core/profiles/manifest.js';
+import { resolveProfileOperand, pauseProfile, resumeProfile } from '../../core/profiles/manifest.js';
 const profileParam = {
     kind: 'positional',
     name: 'profile',
     required: true,
-    constraint: 'Exact profile id, or a unique manifest name.',
+    constraint: 'Profile id or manifest name; a close-enough name resolves to the nearest profile, reported on stderr.',
 };
 export const pauseLeaf = defineLeaf({
     name: 'pause',
@@ -17,18 +17,16 @@ export const pauseLeaf = defineLeaf({
         output: [
             { name: 'profile_id', type: 'string', required: true, constraint: 'Stable directory id.' },
             { name: 'paused_at', type: 'string', required: true, constraint: 'ISO 8601 timestamp when the profile became inert.' },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'Concrete resume command.' },
         ],
         outputKind: 'object',
         effects: ['Writes `paused_at` to the profile manifest. Existing brokers continue their current turn; queued inbox messages do not revive nodes until resume.'],
     },
     run: async (input) => {
-        const { profileId } = loadProfileManifest(input['profile']);
+        const { profileId } = resolveProfileOperand(input['profile']);
         const { manifest } = pauseProfile(profileId);
         return {
             profile_id: profileId,
             paused_at: manifest.paused_at,
-            follow_up: `Resume it with \`crtr profile resume ${profileId}\`.`,
         };
     },
 });
@@ -43,18 +41,16 @@ export const resumeLeaf = defineLeaf({
         output: [
             { name: 'profile_id', type: 'string', required: true, constraint: 'Stable directory id.' },
             { name: 'paused_at', type: 'null', required: true, constraint: 'Always null after resume; null means active.' },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'Concrete next command.' },
         ],
         outputKind: 'object',
         effects: ['Clears `paused_at` in the profile manifest. Future creates and revives are allowed.'],
     },
     run: async (input) => {
-        const { profileId } = loadProfileManifest(input['profile']);
+        const { profileId } = resolveProfileOperand(input['profile']);
         const { manifest } = resumeProfile(profileId);
         return {
             profile_id: profileId,
             paused_at: manifest.paused_at,
-            follow_up: `Inspect it with \`crtr profile show ${profileId}\`.`,
         };
     },
 });

package/dist/commands/profile/project.js

@@ -1,6 +1,6 @@
 // `crtr profile project` manages purview relationships and their automatic-memory caps.
 import { defineLeaf, defineBranch } from '../../core/command.js';
-import { addProfileProject, removeProfileProject, loadProfileManifest } from '../../core/profiles/manifest.js';
+import { addProfileProject, removeProfileProject, resolveProfileOperand } from '../../core/profiles/manifest.js';
 import { PROFILE_PROJECT_MEMORY_VALUES } from '../../api/dto/profiles.js';
 const addLeaf = defineLeaf({
     name: 'add',
@@ -14,7 +14,7 @@ const addLeaf = defineLeaf({
                 kind: 'positional',
                 name: 'profile',
                 required: true,
-                constraint: 'Exact profile id, or a unique manifest name.',
+                constraint: 'Profile id or manifest name; a close-enough name resolves to the nearest profile, reported on stderr.',
             },
             {
                 kind: 'flag',
@@ -43,13 +43,12 @@ const addLeaf = defineLeaf({
             { name: 'profile_id', type: 'string', required: true, constraint: 'Stable directory id.' },
             { name: 'projects', type: 'ProfileProject[]', required: true, constraint: 'The updated `{path, memory}` relationships in manifest order. `path` defines purview; `memory` caps automatic boot and workspace-open disclosure.' },
             { name: 'home', type: 'string | null', required: true, constraint: "The profile's home directory after the change." },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'Concrete next commands.' },
         ],
         outputKind: 'object',
         effects: ["Appends a new project relationship or updates an existing relationship’s `memory` in the profile manifest, and rewrites `home` when --home is given. Purview follows `path`; `memory` caps automatic boot and workspace-open disclosure. Invalidates the process scope cache."],
     },
     run: async (input) => {
-        const { profileId } = loadProfileManifest(input['profile']);
+        const { profileId } = resolveProfileOperand(input['profile']);
         const { manifest } = addProfileProject(profileId, input['dir'], {
             memory: input['memory'],
             home: input['home'] === true,
@@ -58,7 +57,6 @@ const addLeaf = defineLeaf({
             profile_id: profileId,
             projects: manifest.projects,
             home: manifest.home,
-            follow_up: `Show the full manifest with \`crtr profile show ${profileId}\`.`,
         };
     },
 });
@@ -74,7 +72,7 @@ const removeLeaf = defineLeaf({
                 kind: 'positional',
                 name: 'profile',
                 required: true,
-                constraint: 'Exact profile id, or a unique manifest name.',
+                constraint: 'Profile id or manifest name; a close-enough name resolves to the nearest profile, reported on stderr.',
             },
             {
                 kind: 'flag',
@@ -88,19 +86,17 @@ const removeLeaf = defineLeaf({
             { name: 'profile_id', type: 'string', required: true, constraint: 'Stable directory id.' },
             { name: 'projects', type: 'ProfileProject[]', required: true, constraint: 'The updated `{path, memory}` relationships in manifest order.' },
             { name: 'home', type: 'string | null', required: true, constraint: "The profile's home directory after the change." },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'Concrete next commands.' },
         ],
         outputKind: 'object',
         effects: ["Removes a project relationship from the profile manifest, re-pointing `home` when that entry was it. This narrows purview and removes its automatic memory disclosure cap. Invalidates the process scope cache."],
     },
     run: async (input) => {
-        const { profileId } = loadProfileManifest(input['profile']);
+        const { profileId } = resolveProfileOperand(input['profile']);
         const { manifest } = removeProfileProject(profileId, input['dir']);
         return {
             profile_id: profileId,
             projects: manifest.projects,
             home: manifest.home,
-            follow_up: `Show the full manifest with \`crtr profile show ${profileId}\`.`,
         };
     },
 });

package/dist/commands/profile/rename.js

@@ -1,5 +1,5 @@
 import { defineLeaf } from '../../core/command.js';
-import { loadProfileManifest, renameProfile } from '../../core/profiles/manifest.js';
+import { resolveProfileOperand, renameProfile } from '../../core/profiles/manifest.js';
 export const renameLeaf = defineLeaf({
     name: 'rename',
     description: "change a profile's display name",
@@ -12,7 +12,7 @@ export const renameLeaf = defineLeaf({
                 kind: 'positional',
                 name: 'profile',
                 required: true,
-                constraint: 'Exact profile id, or a unique manifest name (the CURRENT name, before this rename).',
+                constraint: 'Profile id or manifest name (the CURRENT name, before this rename); a close-enough name resolves to the nearest profile, reported on stderr.',
             },
             {
                 kind: 'flag',
@@ -24,19 +24,15 @@ export const renameLeaf = defineLeaf({
         ],
         output: [
             { name: 'profile_id', type: 'string', required: true, constraint: 'Stable directory id — unchanged by this leaf.' },
-            { name: 'name', type: 'string', required: true, constraint: 'The new manifest name.' },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'Concrete next commands.' },
         ],
         outputKind: 'object',
         effects: ["Changes the profile manifest's `name` field. Invalidates the process scope cache."],
     },
     run: async (input) => {
-        const { profileId } = loadProfileManifest(input['profile']);
+        const { profileId } = resolveProfileOperand(input['profile']);
         const { manifest } = renameProfile(profileId, input['name']);
         return {
             profile_id: profileId,
-            name: manifest.name,
-            follow_up: `Show the full manifest with \`crtr profile show ${profileId}\`.`,
         };
     },
 });

package/dist/commands/profile/show.js

@@ -1,7 +1,7 @@
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { defineLeaf } from '../../core/command.js';
-import { loadProfileManifest, profileRoot, sanitizeProfileMetadata } from '../../core/profiles/manifest.js';
+import { resolveProfileOperand, profileRoot, sanitizeProfileMetadata } from '../../core/profiles/manifest.js';
 import { CONFIG_FILE } from '../../types.js';
 export const showLeaf = defineLeaf({
     name: 'show',
@@ -15,7 +15,7 @@ export const showLeaf = defineLeaf({
                 kind: 'positional',
                 name: 'profile',
                 required: true,
-                constraint: 'Exact profile id, or a unique manifest name. An ambiguous name fails listing every matching id.',
+                constraint: 'Profile id or manifest name; a close-enough name resolves to the nearest profile, reported on stderr. A name shared by several profiles fails listing every matching id.',
             },
         ],
         output: [
@@ -37,7 +37,7 @@ export const showLeaf = defineLeaf({
         effects: ['None. Read-only.'],
     },
     run: async (input) => {
-        const { profileId, manifest } = loadProfileManifest(input['profile']);
+        const { profileId, manifest } = resolveProfileOperand(input['profile']);
         const configPath = join(profileRoot(profileId), CONFIG_FILE);
         return {
             profile_id: profileId,