@north-light/crouter 0.3.214 → 0.3.216

package/dist/clients/inbox/controller.d.ts

@@ -12,6 +12,8 @@ export interface InboxControllerOptions {
     scan?: () => TicketSummary[];
     /** Replaces the default synchronous rescan after inbox activity. */
     onInboxActivity?: () => void;
+    /** Ticket dir to seat the selection on at construction, when present. */
+    initialSelection?: string;
 }
 type Screen = 'list' | 'detail';
 /** Host-agnostic model for scanning, stable selection, claims, and rendering. */
@@ -50,9 +52,16 @@ export declare class InboxController {
     resize(cols: number, rows: number): void;
     render(): string[];
     handleKey(input: string, key: Key): void;
+    /** Settle the selected ticket from the list with what crouter already put on
+     *  its summary — the agent's recommended option, or a notice's empty map. A
+     *  row without a fast action says so rather than opening the page: the key
+     *  means one thing, and the page is what Enter is for. */
+    private sendFastAction;
     private cancelFromInbox;
     activate(): void;
     private activateReview;
+    /** Seat the selection on a ticket dir, when present in the current list. */
+    selectDir(dir: string): void;
     reloadSelectedPage(): void;
     close(): void;
     private complete;

package/dist/clients/inbox/controller.js

@@ -1,7 +1,7 @@
 import { watch } from 'node:fs';
 import { renderMarkdown } from '../../core/termrender/termrender.js';
 import { BOLD, CYAN, DIM, GRAY, RESET, YELLOW, clipLine } from './tui/ansi.js';
-import { buildInboxLines } from './tui.js';
+import { buildInboxLines, recommendedLabel } from './tui.js';
 import { inboxLayout } from './layout.js';
 import { scanInbox } from '../../core/human/scan.js';
 import { resolvePageComponents } from '../../core/config.js';
@@ -42,6 +42,8 @@ export class InboxController {
         this.scan = options.scan ?? (() => scanInbox());
         this.cols = options.cols ?? 80;
         this.rows = options.rows ?? 24;
+        // Seeded before the first rescan, which preserves a selected dir it finds.
+        this.selectedDir = options.initialSelection;
         this.rescan();
     }
     snapshot() {
@@ -159,6 +161,11 @@ export class InboxController {
             this.markDirty();
             return;
         }
+        if (input === 's' || input === 'S') {
+            void this.sendFastAction();
+            this.markDirty();
+            return;
+        }
         if (key.escape || input === 'q') {
             this.close();
             return;
@@ -173,6 +180,43 @@ export class InboxController {
             this.activate();
         this.markDirty();
     }
+    /** Settle the selected ticket from the list with what crouter already put on
+     *  its summary — the agent's recommended option, or a notice's empty map. A
+     *  row without a fast action says so rather than opening the page: the key
+     *  means one thing, and the page is what Enter is for. */
+    async sendFastAction() {
+        const item = this.items[this.selectedIndex];
+        if (item === undefined)
+            return;
+        if (item.kind !== 'page' || item.fastAction === undefined) {
+            this.status = 'no recommended answer on this ticket — Enter opens it';
+            return;
+        }
+        const claim = claimTicket(item.dir);
+        if (claim === null) {
+            this.status = 'ticket is being edited by another inbox';
+            return;
+        }
+        const settled = item.fastAction.kind === 'acknowledge'
+            ? 'acknowledged'
+            : `sent: ${recommendedLabel(item) ?? 'recommended answer'}`;
+        this.submittingDir = item.dir;
+        try {
+            await resolveTicketPage(item.dir, item.fastAction.responses);
+            this.status = settled;
+        }
+        catch (error) {
+            this.status = resolveFailureKind(error) === 'already_resolved'
+                ? canonicalResultStatus(readTicketResult(item.dir))
+                : daemonErrorMessage(error);
+        }
+        finally {
+            releaseClaim(item.dir, claim.token);
+            this.submittingDir = undefined;
+            this.rescan();
+            this.markDirty();
+        }
+    }
     async cancelFromInbox(dir) {
         this.submittingDir = dir;
         try {
@@ -247,6 +291,14 @@ export class InboxController {
             this.markDirty();
         }
     }
+    /** Seat the selection on a ticket dir, when present in the current list. */
+    selectDir(dir) {
+        const index = this.items.findIndex((item) => item.dir === dir);
+        if (index >= 0) {
+            this.select(index);
+            this.markDirty();
+        }
+    }
     reloadSelectedPage() {
         if (this.adapter === undefined || this.claim === undefined) {
             this.markDirty();
@@ -350,8 +402,11 @@ export class InboxController {
         if (selected === undefined)
             return this.passiveDetailLines(width).slice(0, rows);
         const focusHint = this.focusAvailable(selected.dir) ? `  ${DIM}g${RESET} chat` : '';
+        const sendHint = selected.kind === 'page' && selected.fastAction !== undefined
+            ? `  ${DIM}s${RESET} ${selected.fastAction.kind === 'acknowledge' ? 'acknowledge' : 'send recommended'}`
+            : '';
         const footer = selected.kind === 'page'
-            ? [`  ${DIM}Enter${RESET} opens the full page  ${DIM}j/k${RESET} select  ${DIM}x${RESET} cancel`, `  ${DIM}Page:${RESET} c comment  u/d scroll${focusHint}  ${DIM}q${RESET} close`]
+            ? [`  ${DIM}Enter${RESET} opens the full page  ${DIM}j/k${RESET} select${sendHint}  ${DIM}x${RESET} cancel`, `  ${DIM}Page:${RESET} c comment  u/d scroll${focusHint}  ${DIM}q${RESET} close`]
             : [`  ${DIM}Enter${RESET} opens the full review  ${DIM}j/k${RESET} select  ${DIM}x${RESET} cancel`, ` ${focusHint}  ${DIM}q${RESET} close`];
         const preview = this.passiveDetailLines(width).slice(0, Math.max(0, rows - footer.length));
         return [...preview, ...footer.map((line) => clipLine(line, width))];

package/dist/clients/inbox/surface.d.ts

@@ -8,6 +8,8 @@ export interface InboxSurfaceOptions {
 export interface InboxSurfaceOwner {
     /** Mount when closed and close when open. */
     toggle(): void;
+    /** Mount if closed; seat the selection on `preselectDir` when given. */
+    open(preselectDir?: string): void;
     /** Idempotent surface and controller teardown. */
     close(): void;
     isOpen(): boolean;

package/dist/clients/inbox/surface.js

@@ -69,6 +69,7 @@ export function createInboxSurface(opts) {
             onClosed: close,
             scan: () => filterVisibleReviewTickets(localScan(), current.visibleIds),
             onInboxActivity: () => refresh(current),
+            ...(current.preselectDir === undefined ? {} : { initialSelection: current.preselectDir }),
         });
         const component = new InboxComponent(nextController);
         current.controller = nextController;
@@ -105,21 +106,35 @@ export function createInboxSurface(opts) {
             opts.host.notice(`Could not load inbox visibility: ${error instanceof Error ? error.message : String(error)}`);
         });
     };
-    const toggle = () => {
+    const open = (preselectDir) => {
         if (session !== undefined) {
-            close();
+            if (preselectDir !== undefined)
+                session.controller?.selectDir(preselectDir);
             return;
         }
         if (opts.host.capabilities.remote) {
             opts.host.notice('The inbox is unavailable in a remote attach.');
             return;
         }
-        const current = { closed: false, refreshGeneration: 0, visibleIds: new Set() };
+        const current = {
+            closed: false,
+            refreshGeneration: 0,
+            visibleIds: new Set(),
+            ...(preselectDir === undefined ? {} : { preselectDir }),
+        };
         session = current;
         refresh(current, true);
     };
+    const toggle = () => {
+        if (session !== undefined) {
+            close();
+            return;
+        }
+        open();
+    };
     return {
         toggle,
+        open,
         close,
         isOpen: () => session !== undefined,
     };

package/dist/clients/inbox/tui.d.ts

@@ -4,3 +4,5 @@ export declare const KIND_COLOR: Record<string, string>;
 export declare function formatTimeAgo(iso: string): string;
 /** Pure inbox rows; selection and terminal ownership belong to InboxController. */
 export declare function buildInboxLines(items: TicketSummary[], width: number, selectedIndex: number, height?: number): string[];
+/** What the agent suggests, for a row that says so without opening the page. */
+export declare function recommendedLabel(item: TicketSummary): string | undefined;

package/dist/clients/inbox/tui.js

@@ -46,7 +46,17 @@ function buildItemLines(item, index, selectedIndex, contentWidth) {
     const titleWidth = Math.max(1, contentWidth - age.length - 6);
     const row = `${cursor}${ansiColor(icon, KIND_COLOR[kind] ?? 'cyan')} ${BOLD}${truncateRow(item.title || `(${item.id.slice(0, 8)})`, titleWidth)}${RESET}  ${DIM}${age}${RESET}`;
     const subtitle = item.claim ? `claimed by ${item.claim.owner} · ${item.subtitle}` : item.subtitle;
-    return [row, `      ${DIM}${truncateRow(subtitle, contentWidth - 6)}${RESET}`];
+    const lines = [row, `      ${DIM}${truncateRow(subtitle, contentWidth - 6)}${RESET}`];
+    const recommended = recommendedLabel(item);
+    if (recommended !== undefined)
+        lines.push(`      ${DIM}Recommended: ${truncateRow(recommended, Math.max(1, contentWidth - 19))}${RESET}`);
+    return lines;
+}
+/** What the agent suggests, for a row that says so without opening the page. */
+export function recommendedLabel(item) {
+    if (item.kind !== 'page' || item.recommendedOptions.length === 0)
+        return undefined;
+    return item.recommendedOptions.map((option) => option.label).join(' · ');
 }
 /** Select a contiguous row window that always contains the selected ticket. */
 function visibleWindow(rows, selectedIndex, capacity) {

package/dist/commands/node/create.js

@@ -69,7 +69,7 @@ export function kindsStateBlock() {
 function nodeNewParams() {
     return [
         { kind: 'stdin', name: 'prompt', required: false, constraint: 'First user message. Required unless --no-kickoff is given.' },
-        { kind: 'flag', name: 'kind', type: 'string', required: false, default: 'general', constraint: 'Persona kind. The <kinds> list below names every top-level installable kind.' },
+        { kind: 'flag', name: 'kind', type: 'string', required: false, constraint: "Persona kind. Defaults to the profile's default kind; `general` when the profile has none. The <kinds> list below names every top-level installable kind." },
         { kind: 'flag', name: 'mode', type: 'enum', choices: ['base', 'orchestrator'], required: false, default: 'base', constraint: 'Persona mode. base for hands-on work; orchestrator when the unit itself needs decomposition across children.' },
         { kind: 'flag', name: 'cwd', type: 'path', required: false, constraint: 'Pin the node to this directory. Defaults to the spawner\u2019s directory for a managed child, and to the directory this command runs in for a root.' },
         { kind: 'flag', name: 'name', type: 'string', required: false, constraint: 'Display name. Defaults to the kind.' },
@@ -104,7 +104,7 @@ async function runNodeCreation(input) {
     if (noKickoff && prompt.trim() !== '') {
         throw new InputError({ error: 'no_kickoff_with_prompt', message: '--no-kickoff cannot be combined with a prompt', field: 'no-kickoff', next: 'Drop --no-kickoff, or drop the prompt.' });
     }
-    const kind = input['kind'] ?? 'general';
+    const kind = input['kind'];
     const mode = (input['mode'] ?? 'base');
     const pinCwd = input['cwd']?.trim();
     const name = input['name'];
@@ -138,7 +138,7 @@ async function runNodeCreation(input) {
     const parentId = parent ?? process.env['CRTR_NODE_ID'];
     mark('node_new.create_start', { root });
     const detail = await cliClient().createNode({
-        kind,
+        ...(kind !== undefined ? { kind } : {}),
         mode,
         // The caller's directory is the profile-SELECTION context; where the node
         // actually lands is resolved server-side (pin > spawner's cwd > profile

package/dist/commands/profile/kind.d.ts

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

package/dist/commands/profile/kind.js

@@ -0,0 +1,39 @@
+import { defineLeaf } from '../../core/command.js';
+import { assertInstalledKind, readMergedLaunchConfig } from '../../core/config.js';
+import { loadProfileManifest, 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: 'Exact profile id, or a unique manifest name.' },
+            { 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',
+        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 } = loadProfileManifest(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/list.js

@@ -4,7 +4,7 @@ import { listProfiles } from '../../core/profiles/manifest.js';
 export const listLeaf = defineLeaf({
     name: 'list',
     description: 'inventory every profile',
-    whenToUse: 'browse every profile that exists — one line each with its id, name, project count, home directory, and last-used time. Reach for `profile show` once you have picked one, for its full project list.',
+    whenToUse: 'browse every profile that exists — one line each with its id, name, project count, home directory, paused state, and last-used time. Reach for `profile show` once you have picked one, for its full manifest.',
     help: {
         name: 'profile list',
         summary: 'every profile as JSONL, one line each, sorted by name then profile_id',
@@ -13,6 +13,8 @@ export const listLeaf = defineLeaf({
             { name: 'name', type: 'string', required: true, constraint: 'Manifest name.' },
             { name: 'projects_count', type: 'int', required: true, constraint: 'Number of project directories on the manifest.' },
             { name: 'home', type: 'string | null', required: true, constraint: 'Directory the profile\u2019s nodes are pinned to, or null when it owns no projects.' },
+            { name: 'paused_at', type: 'string | null', required: true, constraint: 'ISO 8601 pause timestamp, or null when the profile is active.' },
+            { name: 'default_kind', type: 'string | null', required: true, constraint: 'Stored default node kind, or null when creates default to general.' },
             { name: 'last_used_at', type: 'string | null', required: true, constraint: 'ISO 8601 timestamp of the most recent selection, or null if never selected.' },
         ],
         outputKind: 'jsonl',
@@ -29,6 +31,8 @@ export const listLeaf = defineLeaf({
                 name: manifest.name,
                 projects_count: manifest.projects.length,
                 home: manifest.home,
+                paused_at: manifest.paused_at,
+                default_kind: manifest.default_kind ?? null,
                 last_used_at: manifest.last_used_at,
             });
         }

package/dist/commands/profile/meta.d.ts

@@ -0,0 +1,4 @@
+/** Fold `KEY=VALUE` flag repetitions into one map. Key-shape validation stays
+ *  with the manifest store (`assertProfileMetadata`); this only splits. */
+export declare function resolveMetaPairs(raw: unknown, field: string): Record<string, string>;
+export declare const metaLeaf: import("../../core/command.js").LeafDef;

package/dist/commands/profile/meta.js

@@ -0,0 +1,69 @@
+import { defineLeaf } from '../../core/command.js';
+import { InputError } from '../../core/io.js';
+import { loadProfileManifest, 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) {
+    const pairs = Array.isArray(raw) ? raw.map(String) : typeof raw === 'string' && raw !== '' ? [raw] : [];
+    // Null prototype: on a plain object a `__proto__` key would silently
+    // vanish here instead of reaching the store's key-shape rejection.
+    const out = Object.create(null);
+    for (const pair of pairs) {
+        const eq = pair.indexOf('=');
+        if (eq <= 0) {
+            throw new InputError({
+                error: 'bad_meta',
+                message: `"${pair}" is not KEY=VALUE`,
+                field,
+                next: `Pass --${field} KEY=VALUE (repeat the flag per entry).`,
+            });
+        }
+        out[pair.slice(0, eq)] = pair.slice(eq + 1);
+    }
+    return out;
+}
+function resolveNames(raw) {
+    return Array.isArray(raw) ? raw.map(String) : typeof raw === 'string' && raw !== '' ? [raw] : [];
+}
+export const metaLeaf = defineLeaf({
+    name: 'meta',
+    description: "set or remove entries in a profile's metadata map",
+    whenToUse: 'a profile should carry (or stop carrying) identity facts — a display name, role, description — that every node launched under it reads from its env as `CRTR_PROFILE_META_<KEY>`. For secrets, use `profile env` instead: metadata is readable back from every projection.',
+    help: {
+        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: '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: [
+            "Rewrites the profile manifest's `metadata` map (omitted entirely when the result is empty).",
+            'Every broker launched under this profile from now on sees each entry as `CRTR_PROFILE_META_<KEY>` (key uppercased, non-alphanumeric runs → `_`). Already-running nodes pick up changes on their next revive.',
+        ],
+    },
+    run: async (input) => {
+        const set = resolveMetaPairs(input['set'], 'set');
+        const unset = resolveNames(input['unset']);
+        if (Object.keys(set).length === 0 && unset.length === 0) {
+            throw new InputError({
+                error: 'nothing_to_do',
+                message: 'pass at least one --set KEY=VALUE or --unset KEY',
+                next: 'Repeat --set/--unset per entry.',
+            });
+        }
+        const { profileId } = loadProfileManifest(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

@@ -1,6 +1,8 @@
 import { defineLeaf } from '../../core/command.js';
 import { usage } from '../../core/errors.js';
+import { assertInstalledKind } from '../../core/config.js';
 import { createProfile, ensureRootProfile, profileRoot } from '../../core/profiles/manifest.js';
+import { resolveMetaPairs } from './meta.js';
 export const newLeaf = defineLeaf({
     name: 'new',
     description: 'create a new profile',
@@ -21,7 +23,7 @@ export const newLeaf = defineLeaf({
                 name: 'root',
                 type: 'bool',
                 required: false,
-                constraint: 'Provision the canonical stable root profile (fixed id `root-00000000`, name `root`) — the fallback default identity for a home — instead of a fresh named one. Idempotent: re-running returns the existing root. Node-free (no `node new --root` needed). Mutually exclusive with `--name`/`--project`.',
+                constraint: 'Provision the canonical stable root profile (fixed id `root-00000000`, name `root`) — the fallback default identity for a home — instead of a fresh named one. Idempotent: re-running returns the existing root. Node-free (no `node new --root` needed). Mutually exclusive with `--name`/`--project`/`--default-kind`/`--meta`.',
             },
             {
                 kind: 'flag',
@@ -30,6 +32,21 @@ export const newLeaf = defineLeaf({
                 required: false,
                 constraint: "One initial project directory. Must already exist and be a directory; resolved to its absolute real path before storing. Also becomes the profile's home — where its nodes are pinned. Singular — add more with `crtr profile project add` after creation.",
             },
+            {
+                kind: 'flag',
+                name: 'default-kind',
+                type: 'string',
+                required: false,
+                constraint: 'Installed persona kind for node creates under this profile that omit --kind. Defaults to general when omitted; validated against the installed kind registry.',
+            },
+            {
+                kind: 'flag',
+                name: 'meta',
+                type: 'string',
+                required: false,
+                repeatable: true,
+                constraint: 'KEY=VALUE metadata entry (repeat per entry). KEY starts with a letter or digit, followed by letters, digits, `_`, or `-`. Each entry reaches every broker launched under the profile as `CRTR_PROFILE_META_<KEY>` env; readable back via `profile show` — not for secrets (those go to `profile env`).',
+            },
         ],
         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.' },
@@ -37,6 +54,8 @@ export const newLeaf = defineLeaf({
             { name: 'path', type: 'string', required: true, constraint: 'Absolute path to the profile directory.' },
             { name: 'projects', type: 'string[]', required: true, constraint: 'Resolved absolute project directories, in manifest order. 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.' },
         ],
@@ -46,10 +65,12 @@ export const newLeaf = defineLeaf({
     run: async (input) => {
         const name = input['name'];
         const project = input['project'];
+        const defaultKind = input['defaultKind'];
+        const metadata = resolveMetaPairs(input['meta'], 'meta');
         const root = input['root'] === true;
         if (root) {
-            if (name !== undefined || project !== undefined) {
-                throw usage('`--root` provisions the canonical stable root profile and takes no `--name`/`--project`.');
+            if (name !== undefined || project !== undefined || defaultKind !== undefined || Object.keys(metadata).length > 0) {
+                throw usage('`--root` provisions the canonical stable root profile and takes no `--name`/`--project`/`--default-kind`/`--meta`.');
             }
             const { profileId, manifest } = ensureRootProfile();
             return {
@@ -58,19 +79,28 @@ export const newLeaf = defineLeaf({
                 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 with \`crtr profile project add ${profileId} --dir <path>\`.`,
             };
         }
         if (name === undefined)
             throw usage('provide `--name <name>` to create a profile, or `--root` to provision the stable root profile.');
-        const { profileId, manifest } = createProfile(name, project !== undefined ? [project] : []);
+        if (defaultKind !== undefined)
+            assertInstalledKind(defaultKind);
+        const { profileId, manifest } = createProfile(name, project !== undefined ? [project] : [], {
+            defaultKind,
+            ...(Object.keys(metadata).length > 0 ? { metadata } : {}),
+        });
         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 another project with \`crtr profile project add ${profileId} --dir <path>\`, or list every profile with \`crtr profile list\`.`,
         };

package/dist/commands/profile/pause.d.ts

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

package/dist/commands/profile/pause.js

@@ -0,0 +1,60 @@
+import { defineLeaf } from '../../core/command.js';
+import { loadProfileManifest, pauseProfile, resumeProfile } from '../../core/profiles/manifest.js';
+const profileParam = {
+    kind: 'positional',
+    name: 'profile',
+    required: true,
+    constraint: 'Exact profile id, or a unique manifest name.',
+};
+export const pauseLeaf = defineLeaf({
+    name: 'pause',
+    description: 'make a profile inert',
+    whenToUse: 'new nodes and revives under a profile must stop while its running broker is allowed to finish its current turn.',
+    help: {
+        name: 'profile pause',
+        summary: 'pause a profile so it creates and revives no nodes',
+        params: [profileParam],
+        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 { manifest } = pauseProfile(profileId);
+        return {
+            profile_id: profileId,
+            paused_at: manifest.paused_at,
+            follow_up: `Resume it with \`crtr profile resume ${profileId}\`.`,
+        };
+    },
+});
+export const resumeLeaf = defineLeaf({
+    name: 'resume',
+    description: 'make a paused profile active',
+    whenToUse: 'nodes under a paused profile may create and revive again, including queued inbox delivery.',
+    help: {
+        name: 'profile resume',
+        summary: 'resume a profile so it may create and revive nodes again',
+        params: [profileParam],
+        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 { 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/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 } from '../../core/profiles/manifest.js';
+import { loadProfileManifest, profileRoot, sanitizeProfileMetadata } from '../../core/profiles/manifest.js';
 import { CONFIG_FILE } from '../../types.js';
 export const showLeaf = defineLeaf({
     name: 'show',
@@ -23,6 +23,9 @@ export const showLeaf = defineLeaf({
             { name: 'name', type: 'string', required: true, constraint: 'Manifest name.' },
             { name: 'projects', type: 'string[]', required: true, constraint: 'Absolute project directories, in manifest order.' },
             { name: 'home', type: 'string | null', required: true, constraint: 'Where a node under this profile runs when its create names no directory at all — an explicit --cwd and the directory a root is launched from both win over it. Defaults to the first project; re-point it with `profile project add --home`. Null when the profile owns no projects (the root profile).' },
+            { name: 'paused_at', type: 'string | null', required: true, constraint: 'ISO 8601 pause timestamp, or null when the profile is active.' },
+            { name: 'default_kind', type: 'string | null', required: true, constraint: 'Stored default node kind, or null when creates default to general.' },
+            { name: 'metadata', type: 'object', required: true, constraint: 'Stored metadata map — each entry reaches brokers launched under the profile as `CRTR_PROFILE_META_<KEY>` env. Empty when none.' },
             { name: 'created_at', type: 'string', required: true, constraint: 'ISO 8601 creation timestamp.' },
             { name: 'last_used_at', type: 'string | null', required: true, constraint: 'ISO 8601 timestamp of the most recent selection, or null if never selected.' },
             { name: 'path', type: 'string', required: true, constraint: 'Absolute path to the profile directory.' },
@@ -41,12 +44,17 @@ export const showLeaf = defineLeaf({
             name: manifest.name,
             projects: manifest.projects,
             home: manifest.home,
+            paused_at: manifest.paused_at,
+            default_kind: manifest.default_kind ?? null,
+            metadata: sanitizeProfileMetadata(manifest.metadata),
             created_at: manifest.created_at,
             last_used_at: manifest.last_used_at,
             path: profileRoot(profileId),
             config_path: configPath,
             config_exists: existsSync(configPath),
-            follow_up: `Add a project with \`crtr profile project add ${profileId} --dir <path>\`, or rename with \`crtr profile rename ${profileId} --name <name>\`.`,
+            follow_up: manifest.paused_at === null
+                ? `Pause it with \`crtr profile pause ${profileId}\`, or set its default kind with \`crtr profile kind ${profileId} <kind>\`.`
+                : `Resume it with \`crtr profile resume ${profileId}\`.`,
         };
     },
 });

package/dist/commands/profile.js

@@ -2,12 +2,6 @@
 // identities defined at the user root, each owning a manifest naming project
 // directories plus its own memory store.
 //
-// Five flat manifest verbs (new/list/show/rename/delete) plus three sub-nouns:
-// `project` (the profile's project purview), `default` (the per-cwd default
-// pin), and `env` (a profile-scoped store of env vars injected directly into
-// its brokers). Eight children — past the 5-7 soft cap, but `env` is a
-// coherent, self-contained sub-noun with no overlap against the existing six,
-// so it stays flat rather than inventing a deeper nest for one addition.
 // Every manifest verb but `new`/`list` takes <profile> as an exact id OR a
 // unique manifest name.
 import { defineBranch } from '../core/command.js';
@@ -16,6 +10,9 @@ import { listLeaf } from './profile/list.js';
 import { showLeaf } from './profile/show.js';
 import { renameLeaf } from './profile/rename.js';
 import { deleteLeaf } from './profile/delete.js';
+import { pauseLeaf, resumeLeaf } from './profile/pause.js';
+import { kindLeaf } from './profile/kind.js';
+import { metaLeaf } from './profile/meta.js';
 import { projectBranch } from './profile/project.js';
 import { defaultBranch } from './profile/default.js';
 import { envBranch } from './profile/env.js';
@@ -30,8 +27,8 @@ export function registerProfile() {
         help: {
             name: 'profile',
             summary: 'create, inspect, and manage profiles \u2014 agent identities with their own project purview and memory store',
-            model: 'A profile owns a `home` — the first of its project dirs unless `project add --home` re-points it — which is where a node under the profile runs when its create names no directory at all. A node lands in the directory it was launched from when there is one: `node new --cwd`, an inherited spawner directory (notably inside a managed worktree), or the directory a root was started in. So one profile can cover many working directories — cwd selects the identity, and the launch decides where the work happens. `new` creates one from a name (+ at most one initial `--project`, which becomes its home). `list` inventories every profile as JSONL. `show` prints one manifest in full. `rename` changes only the manifest name \u2014 the profile_id is stable across a rename. `delete --force` removes the profile after cascading through its nodes, matching schedules, originating inbox/review state, and default pins; `--detach --force` instead preserves nodes and human history while clearing the profile identity and globalizing its schedules. Both modes block while a matching node owns an open managed worktree and never touch the project directories the profile pointed at. `project` widens/narrows a profile\u2019s project purview (the dirs it resolves memory + config from). `default` pins which profile a directory defaults to at startup so the chooser stops asking \u2014 directory-scoped, independent of purview. `env` manages a profile-scoped 0600 store of env vars injected directly into every broker launched under that profile \u2014 set on stdin, list names only (never values), or remove one; no `spawnEnv.allow` entry needed. Every manifest verb but `new`/`list` takes <profile> as an exact id or a unique manifest name; an ambiguous name fails listing every matching id.',
+            model: 'A profile owns a `home` — the first of its project dirs unless `project add --home` re-points it — which is where a node under the profile runs when its create names no directory at all. A node lands in the directory it was launched from when there is one: `node new --cwd`, an inherited spawner directory (notably inside a managed worktree), or the directory a root was started in. So one profile can cover many working directories — cwd selects the identity, and the launch decides where the work happens. `new` creates one from a name (+ at most one initial `--project`, which becomes its home). `list` inventories every profile as JSONL. `show` prints one manifest in full. `rename` changes only the manifest name \u2014 the profile_id is stable across a rename. `delete --force` removes the profile after cascading through its nodes, matching schedules, originating inbox/review state, and default pins; `--detach --force` instead preserves nodes and human history while clearing the profile identity and globalizing its schedules. Both modes block while a matching node owns an open managed worktree and never touch the project directories the profile pointed at. `project` widens/narrows a profile\u2019s project purview (the dirs it resolves memory + config from). `default` pins which profile a directory defaults to at startup so the chooser stops asking \u2014 directory-scoped, independent of purview. `env` manages a profile-scoped 0600 store of env vars injected directly into every broker launched under that profile \u2014 set on stdin, list names only (never values), or remove one; no `spawnEnv.allow` entry needed. `meta` edits the manifest\u2019s readable metadata map \u2014 identity facts each broker under the profile sees as `CRTR_PROFILE_META_<KEY>` env (secrets stay in `env`). Every manifest verb but `new`/`list` takes <profile> as an exact id or a unique manifest name; an ambiguous name fails listing every matching id.',
         },
-        children: [newLeaf, listLeaf, showLeaf, renameLeaf, deleteLeaf, projectBranch, defaultBranch, envBranch],
+        children: [newLeaf, listLeaf, showLeaf, renameLeaf, pauseLeaf, resumeLeaf, kindLeaf, metaLeaf, deleteLeaf, projectBranch, defaultBranch, envBranch],
     });
 }