@north-light/crouter 0.3.318 → 0.3.320

package/dist/commands/sys/config.js

@@ -1,353 +1 @@
-import { defineBranch, defineLeaf } from '../../core/command.js';
-import { InvalidRawSettingsError, readConfig, readRawSettingsForTarget, replaceRawSettingsForTarget, updateConfig, persistModelLadders, configPath as coreConfigPath } from '../../core/config.js';
-import { usage, notFound } from '../../core/errors.js';
-import { requireScopeRoot } from '../../core/scope.js';
-import { resolveScope } from './shared.js';
-import { resolveProfileOperand } from '../../core/profiles/manifest.js';
-import { SettingsRevisionConflictError } from '../../core/scoped-state/settings.js';
-import { InputError } from '../../core/io.js';
-import { SCOPE_CONFIG_KEYS, USER_SETTINGS, findUserSetting } from '../../core/user-settings.js';
-// Config helpers (ported from commands/config.ts)
-const CONFIG_TOP_LEVEL_HELP = SCOPE_CONFIG_KEYS.join(', ');
-const SCALAR_SETTING_HELP = USER_SETTINGS.map((setting) => `${setting.key} (${setting.valueConstraint})`).join(', ');
-const MODEL_PROVIDERS = new Set(['anthropic', 'openai']);
-const MODEL_STRENGTHS = new Set(['ultra', 'strong', 'medium', 'light']);
-function isModelProvider(value) {
-    return MODEL_PROVIDERS.has(value);
-}
-function isModelStrength(value) {
-    return MODEL_STRENGTHS.has(value);
-}
-function getNestedValue(obj, key) {
-    const parts = key.split('.');
-    let current = obj;
-    for (const part of parts) {
-        if (current === null || typeof current !== 'object')
-            return undefined;
-        current = current[part];
-    }
-    return current;
-}
-function parseConfigValue(raw) {
-    if (raw === 'true')
-        return true;
-    if (raw === 'false')
-        return false;
-    if (/^-?\d+$/.test(raw))
-        return parseInt(raw, 10);
-    return raw;
-}
-function assertUserScopeBrokerThresholds(key, scope) {
-    if (key.split('.', 1)[0] === 'brokerThresholds' && scope !== 'user') {
-        throw usage('brokerThresholds are available only in user scope');
-    }
-}
-function assertUserScopeLifecycle(key, scope) {
-    if (key.split('.', 1)[0] === 'lifecycle' && scope !== 'user') {
-        throw usage('lifecycle settings are available only in user scope');
-    }
-}
-function assertWorkingGerundsScope(key, scope) {
-    if (key === 'working_gerunds' && scope !== 'user') {
-        throw usage('working_gerunds is available only in user scope');
-    }
-}
-function assertWhipMessagesScope(key, scope) {
-    if (key === 'whip_messages' && scope !== 'user') {
-        throw usage('whip_messages are available only in user scope');
-    }
-}
-function assertUserSettingScope(key, scope) {
-    if (findUserSetting(key) !== undefined && scope !== 'user') {
-        throw usage(`${key} is available only in user scope`);
-    }
-}
-/** Validate a `modelLadders.*` key/value into an explicit sparse patch, or
- *  return null when the key is not a ladder key. Ladder sets do NOT go through
- *  `setNestedValue`/`updateConfig`: that path persists only what differs from
- *  the compiled defaults, so choosing today's default value would record
- *  nothing (see `persistModelLadders`). */
-function modelLadderPatch(key, rawValue) {
-    const parts = key.split('.');
-    if (parts[0] !== 'modelLadders')
-        return null;
-    if (parts.length === 2 && parts[1] === 'defaultProvider') {
-        if (!isModelProvider(rawValue)) {
-            throw usage(`modelLadders.defaultProvider must be anthropic or openai`);
-        }
-        return { defaultProvider: rawValue };
-    }
-    if (parts.length === 3) {
-        const provider = parts[1];
-        const strength = parts[2];
-        if (!isModelProvider(provider)) {
-            throw usage(`modelLadders provider must be anthropic or openai`);
-        }
-        if (!isModelStrength(strength)) {
-            throw usage(`modelLadders strength must be ultra, strong, medium, or light`);
-        }
-        if (rawValue.trim() === '') {
-            throw usage(`modelLadders.${provider}.${strength} cannot be empty`);
-        }
-        return { [provider]: { [strength]: rawValue } };
-    }
-    throw usage(`unsupported key path for set: ${key}`);
-}
-function rawSettingsTarget(input) {
-    const scope = input['scope'];
-    if (scope === 'project') {
-        throw usage('project settings remain a JSON file; use `crtr sys config set` or `crtr sys config path --scope project`.');
-    }
-    const profile = input['profile'];
-    if (scope === 'user') {
-        if (profile !== undefined)
-            throw usage('--profile is available only with --scope profile.');
-        return { scope: 'user' };
-    }
-    if (profile === undefined)
-        throw usage('--profile is required with --scope profile.');
-    return { scope: 'profile', profileId: resolveProfileOperand(profile).profileId };
-}
-function parseRawSettings(raw) {
-    let value;
-    try {
-        value = JSON.parse(raw);
-    }
-    catch {
-        throw new InputError({ error: 'invalid_request', message: 'stdin must be valid JSON', field: 'stdin', next: 'Pipe one complete JSON object on stdin.' });
-    }
-    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
-        throw new InputError({ error: 'invalid_request', message: 'stdin must be a JSON object', field: 'stdin', next: 'Pipe one complete JSON object on stdin.' });
-    }
-    return value;
-}
-function setNestedValue(cfg, key, rawValue, value) {
-    const parts = key.split('.');
-    const topKey = parts[0];
-    if (key === 'working_gerunds' || key === 'whip_messages') {
-        let parsed;
-        try {
-            parsed = JSON.parse(rawValue);
-        }
-        catch {
-            throw usage(`${key} must be a JSON array of non-empty strings`);
-        }
-        if (!Array.isArray(parsed) || parsed.length === 0 || !parsed.every((entry) => typeof entry === 'string' && entry.trim() !== '')) {
-            throw usage(`${key} must be a non-empty JSON array of non-empty strings`);
-        }
-        cfg[key] = parsed.map((entry) => entry.trim());
-        return;
-    }
-    if (topKey === 'keybindings') {
-        throw usage('keybindings are edited only through `crtr sys settings`');
-    }
-    if (topKey === 'modelLadders') {
-        throw usage('modelLadders keys are written through persistModelLadders, not this path');
-    }
-    const setting = findUserSetting(key);
-    if (setting !== undefined) {
-        const error = setting.setFromString(cfg, rawValue);
-        if (error !== null)
-            throw usage(error);
-        return;
-    }
-    if (topKey === 'brokerThresholds') {
-        if (parts.length !== 2 || (parts[1] !== 'warning' && parts[1] !== 'automaticReviveCap')) {
-            throw usage(`brokerThresholds key must be warning or automaticReviveCap`);
-        }
-        if (typeof value !== 'number' || !Number.isFinite(value) || value < 1) {
-            throw usage(`brokerThresholds.${parts[1]} must be an integer >= 1`);
-        }
-        const threshold = Math.floor(value);
-        if (parts[1] === 'warning' && threshold > cfg.brokerThresholds.automaticReviveCap) {
-            throw usage('brokerThresholds.warning must be <= brokerThresholds.automaticReviveCap');
-        }
-        if (parts[1] === 'automaticReviveCap' && threshold < cfg.brokerThresholds.warning) {
-            throw usage('brokerThresholds.automaticReviveCap must be >= brokerThresholds.warning');
-        }
-        cfg.brokerThresholds[parts[1]] = threshold;
-        return;
-    }
-    if (topKey === 'lifecycle') {
-        if (parts.length !== 2 || parts[1] !== 'unattendedParkMs') {
-            throw usage(`lifecycle key must be unattendedParkMs`);
-        }
-        if (typeof value !== 'number' || !Number.isFinite(value) || value < 1) {
-            throw usage(`lifecycle.unattendedParkMs must be an integer >= 1`);
-        }
-        cfg.lifecycle.unattendedParkMs = Math.floor(value);
-        return;
-    }
-    throw usage(`unsupported key path for set: ${key}`);
-}
-// Leaf definitions
-const configGet = defineLeaf({
-    name: 'get',
-    description: 'read a config value by key',
-    whenToUse: 'you want to inspect one config value — including the whole user keybindings object — optionally from a specific scope. Use sys settings to edit keybindings and sys config set for supported scalar settings.',
-    help: {
-        name: 'sys config get',
-        summary: 'read a config value by dotted key',
-        params: [
-            { kind: 'positional', name: 'key', type: 'string', required: true, constraint: `Dotted key path. Top-level keys: ${CONFIG_TOP_LEVEL_HELP}. brokerThresholds and lifecycle are user-only; keybindings is readable only as the whole user-scope object and editable only through sys settings.` },
-            { kind: 'flag', name: 'scope', type: 'enum', choices: ['user', 'project'], required: false, constraint: 'Scope to read from. Default: user.' },
-        ],
-        output: [
-            { name: 'key', type: 'string', required: true, constraint: 'Echo of input key.' },
-            { name: 'value', type: 'unknown', required: true, constraint: 'The resolved value. Type depends on the key.' },
-            { name: 'scope', type: 'string', required: true, constraint: 'Scope the value was read from.' },
-        ],
-        outputKind: 'object',
-        effects: ['None. Read-only.'],
-    },
-    run: async (input) => {
-        const key = input['key'];
-        const scope = resolveScope(input['scope']);
-        assertUserScopeBrokerThresholds(key, scope);
-        assertUserScopeLifecycle(key, scope);
-        if (key.startsWith('keybindings.') || (key === 'keybindings' && scope !== 'user')) {
-            throw notFound('keybindings are available only as the whole user-scope object');
-        }
-        const cfg = readConfig(scope);
-        const value = getNestedValue(cfg, key);
-        if (value === undefined) {
-            throw notFound(`config key not found: ${key}`);
-        }
-        return { key, value: value, scope };
-    },
-});
-const configSet = defineLeaf({
-    name: 'set',
-    description: 'write a config value by key',
-    whenToUse: 'you want to change a supported crtr setting in user or project scope. Use sys settings instead for keybindings, and sys config get to inspect values.',
-    help: {
-        name: 'sys config set',
-        summary: 'write a config value by dotted key',
-        params: [
-            { kind: 'positional', name: 'key', type: 'string', required: true, constraint: `Dotted key path. User-scope scalar settings: ${SCALAR_SETTING_HELP}. Also supported: working_gerunds and whip_messages (non-empty JSON string arrays), brokerThresholds.warning and brokerThresholds.automaticReviveCap (user scope; integer >= 1), lifecycle.unattendedParkMs (user scope; integer ms >= 1), modelLadders.defaultProvider, and modelLadders.<anthropic|openai>.<ultra|strong|medium|light>. Keybindings are edited only through sys settings. For arbitrary raw user or profile documents, use sys config get-raw and set-raw.` },
-            { kind: 'flag', name: 'value', type: 'string', required: true, constraint: 'value VALUE — string, required. working_gerunds and whip_messages accept JSON arrays; other values are stored as-is if quoted and coerced to number or boolean when unambiguous.' },
-            { kind: 'flag', name: 'scope', type: 'enum', choices: ['user', 'project'], required: false, constraint: 'Scope to write to. Default: user. Project scope is supported only for modelLadders.' },
-        ],
-        output: [
-            { name: 'value', type: 'unknown', required: true, constraint: 'Resolved value as written after parsing and setting-specific coercion.' },
-            { name: 'scope', type: 'string', required: true, constraint: 'Scope the value was written to.' },
-        ],
-        outputKind: 'object',
-        effects: ['Writes the updated value through the target scope’s configuration storage.'],
-    },
-    run: async (input) => {
-        const key = input['key'];
-        const rawValue = input['value'];
-        const scope = resolveScope(input['scope']);
-        assertUserScopeBrokerThresholds(key, scope);
-        assertUserScopeLifecycle(key, scope);
-        assertWorkingGerundsScope(key, scope);
-        assertWhipMessagesScope(key, scope);
-        assertUserSettingScope(key, scope);
-        // Flags are stringly-typed; coerce to number or boolean when unambiguous
-        const parsed = parseConfigValue(rawValue);
-        // Ladder rungs record explicit intent (even when the value equals today's
-        // compiled default); everything else mutates + persists through the central
-        // raw-partial path, which never freezes a materialized `modelLadders`.
-        const ladder = modelLadderPatch(key, rawValue);
-        const cfg = ladder !== null
-            ? (persistModelLadders(requireScopeRoot(scope), ladder), readConfig(scope))
-            : updateConfig(scope, (c) => setNestedValue(c, key, rawValue, parsed));
-        // Read back the resolved value that was written
-        const written = getNestedValue(cfg, key);
-        return { value: written, scope };
-    },
-});
-const configGetRaw = defineLeaf({
-    name: 'get-raw',
-    description: 'read one raw SQL-backed settings document and revision',
-    whenToUse: 'you need the exact stored user or profile settings document before replacing it with set-raw.',
-    help: {
-        name: 'sys config get-raw',
-        summary: 'read one raw user or profile settings document',
-        params: [
-            { kind: 'flag', name: 'scope', type: 'enum', choices: ['user', 'profile', 'project'], required: true, constraint: 'SQL-backed target: user or profile. project is rejected because its settings remain a JSON file.' },
-            { kind: 'flag', name: 'profile', type: 'string', required: false, constraint: 'Profile id or name to target. Required with --scope profile; rejected with --scope user or project.' },
-        ],
-        output: [
-            { name: 'revision', type: 'string', required: true, constraint: 'Opaque revision token for set-raw. absent means the settings row does not exist.' },
-            { name: 'settings', type: 'object | null', required: true, constraint: 'Exact stored settings document, or null when no row exists.' },
-        ],
-        outputKind: 'object',
-        effects: ['None. Read-only.'],
-    },
-    run: async (input) => readRawSettingsForTarget(rawSettingsTarget(input)),
-});
-const configSetRaw = defineLeaf({
-    name: 'set-raw',
-    description: 'replace one raw SQL-backed settings document at a revision',
-    whenToUse: 'you have a complete user or profile settings document from get-raw and must replace it without losing a concurrent change.',
-    help: {
-        name: 'sys config set-raw',
-        summary: 'atomically replace one raw user or profile settings document',
-        params: [
-            { kind: 'flag', name: 'scope', type: 'enum', choices: ['user', 'profile', 'project'], required: true, constraint: 'SQL-backed target: user or profile. project is rejected because its settings remain a JSON file.' },
-            { kind: 'flag', name: 'profile', type: 'string', required: false, constraint: 'Profile id or name to target. Required with --scope profile; rejected with --scope user or project.' },
-            { kind: 'flag', name: 'if-revision', type: 'string', required: true, constraint: 'Revision returned by get-raw. Required; use absent only when get-raw reported no settings row.' },
-            { kind: 'stdin', name: 'settings', required: true, allowPositional: false, constraint: 'One complete JSON object. It replaces the document exactly; values are not normalized or merged.' },
-        ],
-        output: [
-            { name: 'revision', type: 'string', required: true, constraint: 'Revision token of the stored document after this operation.' },
-            { name: 'changed', type: 'boolean', required: true, constraint: 'Whether the stored document changed.' },
-        ],
-        outputKind: 'object',
-        effects: ['Atomically replaces the SQL-backed settings document only when --if-revision matches its current revision.'],
-    },
-    run: async (input) => {
-        const target = rawSettingsTarget(input);
-        const settings = parseRawSettings(input['settings']);
-        try {
-            return replaceRawSettingsForTarget(target, settings, input['ifRevision']);
-        }
-        catch (error) {
-            if (error instanceof SettingsRevisionConflictError) {
-                throw new InputError({ error: 'settings_revision_conflict', message: 'settings changed since the supplied revision', field: 'if_revision', next: 'Run `crtr sys config get-raw` again, reapply the intended transformation, and retry with its revision.' });
-            }
-            if (error instanceof InvalidRawSettingsError) {
-                throw new InputError({ error: 'invalid_settings', message: error.message, field: 'stdin', next: 'Correct the document so crouter can merge it into resolved settings, then retry with a fresh revision.' });
-            }
-            throw error;
-        }
-    },
-});
-const configPath = defineLeaf({
-    name: 'path',
-    description: 'print the project config.json path',
-    whenToUse: 'you need the project config.json path for inspection or backup. User and profile settings use get-raw and set-raw instead.',
-    help: {
-        name: 'sys config path',
-        summary: 'print the project config.json path',
-        params: [
-            { kind: 'flag', name: 'scope', type: 'enum', choices: ['project', 'user', 'profile'], required: false, constraint: 'Project is the only path-backed settings scope. user and profile are rejected because they use SQL-backed get-raw and set-raw. Default: project.' },
-        ],
-        output: [
-            { name: 'paths', type: 'object[]', required: true, constraint: 'One {scope: "project", path} entry when the current project has a config file; otherwise empty.' },
-        ],
-        outputKind: 'object',
-        effects: ['None. Read-only.'],
-    },
-    run: async (input) => {
-        const scope = input['scope'];
-        if (scope === 'user' || scope === 'profile') {
-            throw usage(`${scope} settings are SQL-backed; use \`crtr sys config get-raw --scope ${scope}\` instead.`);
-        }
-        const path = coreConfigPath('project');
-        return { paths: path === null ? [] : [{ scope: 'project', path }] };
-    },
-});
-export const configBranch = defineBranch({
-    name: 'config',
-    description: 'read and write configuration',
-    whenToUse: 'inspecting crtr settings, changing supported scalar values, replacing complete raw user or profile settings documents, or locating a project config.json. Keybinding changes belong in sys settings.',
-    help: {
-        name: 'sys config',
-        summary: 'read and write crtr configuration, including model ladders and raw SQL-backed user/profile settings',
-        model: 'get and set resolve individual settings. get-raw and set-raw read and replace complete user or profile documents with a revision precondition. path applies only to project config.json.',
-    },
-    children: [configGet, configSet, configGetRaw, configSetRaw, configPath],
-});
+var S=Object.defineProperty;var i=(t,e)=>S(t,"name",{value:e,configurable:!0});import{defineBranch as j,defineLeaf as u}from"../../core/command.js";import{InvalidRawSettingsError as T,readConfig as f,readRawSettingsForTarget as q,replaceRawSettingsForTarget as L,updateConfig as R,persistModelLadders as P,configPath as N}from"../../core/config.js";import{usage as o,notFound as g}from"../../core/errors.js";import{requireScopeRoot as _}from"../../core/scope.js";import{resolveScope as h}from"./shared.js";import{resolveProfileOperand as O}from"../../core/profiles/manifest.js";import{SettingsRevisionConflictError as E}from"../../core/scoped-state/settings.js";import{InputError as l}from"../../core/io.js";import{SCOPE_CONFIG_KEYS as C,USER_SETTINGS as U,findUserSetting as m}from"../../core/user-settings.js";const $=C.join(", "),J=U.map(t=>`${t.key} (${t.valueConstraint})`).join(", "),M=new Set(["anthropic","openai"]),I=new Set(["ultra","strong","medium","light"]);function y(t){return M.has(t)}i(y,"isModelProvider");function x(t){return I.has(t)}i(x,"isModelStrength");function w(t,e){const n=e.split(".");let r=t;for(const s of n){if(r===null||typeof r!="object")return;r=r[s]}return r}i(w,"getNestedValue");function A(t){return t==="true"?!0:t==="false"?!1:/^-?\d+$/.test(t)?parseInt(t,10):t}i(A,"parseConfigValue");function b(t,e){if(t.split(".",1)[0]==="brokerThresholds"&&e!=="user")throw o("brokerThresholds are available only in user scope")}i(b,"assertUserScopeBrokerThresholds");function v(t,e){if(t.split(".",1)[0]==="lifecycle"&&e!=="user")throw o("lifecycle settings are available only in user scope")}i(v,"assertUserScopeLifecycle");function F(t,e){if(t==="working_gerunds"&&e!=="user")throw o("working_gerunds is available only in user scope")}i(F,"assertWorkingGerundsScope");function K(t,e){if(t==="whip_messages"&&e!=="user")throw o("whip_messages are available only in user scope")}i(K,"assertWhipMessagesScope");function D(t,e){if(m(t)!==void 0&&e!=="user")throw o(`${t} is available only in user scope`)}i(D,"assertUserSettingScope");function G(t,e){const n=t.split(".");if(n[0]!=="modelLadders")return null;if(n.length===2&&n[1]==="defaultProvider"){if(!y(e))throw o("modelLadders.defaultProvider must be anthropic or openai");return{defaultProvider:e}}if(n.length===3){const r=n[1],s=n[2];if(!y(r))throw o("modelLadders provider must be anthropic or openai");if(!x(s))throw o("modelLadders strength must be ultra, strong, medium, or light");if(e.trim()==="")throw o(`modelLadders.${r}.${s} cannot be empty`);return{[r]:{[s]:e}}}throw o(`unsupported key path for set: ${t}`)}i(G,"modelLadderPatch");function k(t){const e=t.scope;if(e==="project")throw o("project settings remain a JSON file; use `crtr sys config set` or `crtr sys config path --scope project`.");const n=t.profile;if(e==="user"){if(n!==void 0)throw o("--profile is available only with --scope profile.");return{scope:"user"}}if(n===void 0)throw o("--profile is required with --scope profile.");return{scope:"profile",profileId:O(n).profileId}}i(k,"rawSettingsTarget");function Q(t){let e;try{e=JSON.parse(t)}catch{throw new l({error:"invalid_request",message:"stdin must be valid JSON",field:"stdin",next:"Pipe one complete JSON object on stdin."})}if(e===null||typeof e!="object"||Array.isArray(e))throw new l({error:"invalid_request",message:"stdin must be a JSON object",field:"stdin",next:"Pipe one complete JSON object on stdin."});return e}i(Q,"parseRawSettings");function W(t,e,n,r){const s=e.split("."),c=s[0];if(e==="working_gerunds"||e==="whip_messages"){let a;try{a=JSON.parse(n)}catch{throw o(`${e} must be a JSON array of non-empty strings`)}if(!Array.isArray(a)||a.length===0||!a.every(d=>typeof d=="string"&&d.trim()!==""))throw o(`${e} must be a non-empty JSON array of non-empty strings`);t[e]=a.map(d=>d.trim());return}if(c==="keybindings")throw o("keybindings are edited only through `crtr sys settings`");if(c==="modelLadders")throw o("modelLadders keys are written through persistModelLadders, not this path");const p=m(e);if(p!==void 0){const a=p.setFromString(t,n);if(a!==null)throw o(a);return}if(c==="brokerThresholds"){if(s.length!==2||s[1]!=="warning"&&s[1]!=="automaticReviveCap")throw o("brokerThresholds key must be warning or automaticReviveCap");if(typeof r!="number"||!Number.isFinite(r)||r<1)throw o(`brokerThresholds.${s[1]} must be an integer >= 1`);const a=Math.floor(r);if(s[1]==="warning"&&a>t.brokerThresholds.automaticReviveCap)throw o("brokerThresholds.warning must be <= brokerThresholds.automaticReviveCap");if(s[1]==="automaticReviveCap"&&a<t.brokerThresholds.warning)throw o("brokerThresholds.automaticReviveCap must be >= brokerThresholds.warning");t.brokerThresholds[s[1]]=a;return}if(c==="lifecycle"){if(s.length!==2||s[1]!=="unattendedParkMs")throw o("lifecycle key must be unattendedParkMs");if(typeof r!="number"||!Number.isFinite(r)||r<1)throw o("lifecycle.unattendedParkMs must be an integer >= 1");t.lifecycle.unattendedParkMs=Math.floor(r);return}throw o(`unsupported key path for set: ${e}`)}i(W,"setNestedValue");const B=u({name:"get",description:"read a config value by key",whenToUse:"you want to inspect one config value \u2014 including the whole user keybindings object \u2014 optionally from a specific scope. Use sys settings to edit keybindings and sys config set for supported scalar settings.",help:{name:"sys config get",summary:"read a config value by dotted key",params:[{kind:"positional",name:"key",type:"string",required:!0,constraint:`Dotted key path. Top-level keys: ${$}. brokerThresholds and lifecycle are user-only; keybindings is readable only as the whole user-scope object and editable only through sys settings.`},{kind:"flag",name:"scope",type:"enum",choices:["user","project"],required:!1,constraint:"Scope to read from. Default: user."}],output:[{name:"key",type:"string",required:!0,constraint:"Echo of input key."},{name:"value",type:"unknown",required:!0,constraint:"The resolved value. Type depends on the key."},{name:"scope",type:"string",required:!0,constraint:"Scope the value was read from."}],outputKind:"object",effects:["None. Read-only."]},run:i(async t=>{const e=t.key,n=h(t.scope);if(b(e,n),v(e,n),e.startsWith("keybindings.")||e==="keybindings"&&n!=="user")throw g("keybindings are available only as the whole user-scope object");const r=f(n),s=w(r,e);if(s===void 0)throw g(`config key not found: ${e}`);return{key:e,value:s,scope:n}},"run")}),H=u({name:"set",description:"write a config value by key",whenToUse:"you want to change a supported crtr setting in user or project scope. Use sys settings instead for keybindings, and sys config get to inspect values.",help:{name:"sys config set",summary:"write a config value by dotted key",params:[{kind:"positional",name:"key",type:"string",required:!0,constraint:`Dotted key path. User-scope scalar settings: ${J}. Also supported: working_gerunds and whip_messages (non-empty JSON string arrays), brokerThresholds.warning and brokerThresholds.automaticReviveCap (user scope; integer >= 1), lifecycle.unattendedParkMs (user scope; integer ms >= 1), modelLadders.defaultProvider, and modelLadders.<anthropic|openai>.<ultra|strong|medium|light>. Keybindings are edited only through sys settings. For arbitrary raw user or profile documents, use sys config get-raw and set-raw.`},{kind:"flag",name:"value",type:"string",required:!0,constraint:"value VALUE \u2014 string, required. working_gerunds and whip_messages accept JSON arrays; other values are stored as-is if quoted and coerced to number or boolean when unambiguous."},{kind:"flag",name:"scope",type:"enum",choices:["user","project"],required:!1,constraint:"Scope to write to. Default: user. Project scope is supported only for modelLadders."}],output:[{name:"value",type:"unknown",required:!0,constraint:"Resolved value as written after parsing and setting-specific coercion."},{name:"scope",type:"string",required:!0,constraint:"Scope the value was written to."}],outputKind:"object",effects:["Writes the updated value through the target scope\u2019s configuration storage."]},run:i(async t=>{const e=t.key,n=t.value,r=h(t.scope);b(e,r),v(e,r),F(e,r),K(e,r),D(e,r);const s=A(n),c=G(e,n),p=c!==null?(P(_(r),c),f(r)):R(r,d=>W(d,e,n,s));return{value:w(p,e),scope:r}},"run")}),V=u({name:"get-raw",description:"read one raw SQL-backed settings document and revision",whenToUse:"you need the exact stored user or profile settings document before replacing it with set-raw.",help:{name:"sys config get-raw",summary:"read one raw user or profile settings document",params:[{kind:"flag",name:"scope",type:"enum",choices:["user","profile","project"],required:!0,constraint:"SQL-backed target: user or profile. project is rejected because its settings remain a JSON file."},{kind:"flag",name:"profile",type:"string",required:!1,constraint:"Profile id or name to target. Required with --scope profile; rejected with --scope user or project."}],output:[{name:"revision",type:"string",required:!0,constraint:"Opaque revision token for set-raw. absent means the settings row does not exist."},{name:"settings",type:"object | null",required:!0,constraint:"Exact stored settings document, or null when no row exists."}],outputKind:"object",effects:["None. Read-only."]},run:i(async t=>q(k(t)),"run")}),z=u({name:"set-raw",description:"replace one raw SQL-backed settings document at a revision",whenToUse:"you have a complete user or profile settings document from get-raw and must replace it without losing a concurrent change.",help:{name:"sys config set-raw",summary:"atomically replace one raw user or profile settings document",params:[{kind:"flag",name:"scope",type:"enum",choices:["user","profile","project"],required:!0,constraint:"SQL-backed target: user or profile. project is rejected because its settings remain a JSON file."},{kind:"flag",name:"profile",type:"string",required:!1,constraint:"Profile id or name to target. Required with --scope profile; rejected with --scope user or project."},{kind:"flag",name:"if-revision",type:"string",required:!0,constraint:"Revision returned by get-raw. Required; use absent only when get-raw reported no settings row."},{kind:"stdin",name:"settings",required:!0,allowPositional:!1,constraint:"One complete JSON object. It replaces the document exactly; values are not normalized or merged."}],output:[{name:"revision",type:"string",required:!0,constraint:"Revision token of the stored document after this operation."},{name:"changed",type:"boolean",required:!0,constraint:"Whether the stored document changed."}],outputKind:"object",effects:["Atomically replaces the SQL-backed settings document only when --if-revision matches its current revision."]},run:i(async t=>{const e=k(t),n=Q(t.settings);try{return L(e,n,t.ifRevision)}catch(r){throw r instanceof E?new l({error:"settings_revision_conflict",message:"settings changed since the supplied revision",field:"if_revision",next:"Run `crtr sys config get-raw` again, reapply the intended transformation, and retry with its revision."}):r instanceof T?new l({error:"invalid_settings",message:r.message,field:"stdin",next:"Correct the document so crouter can merge it into resolved settings, then retry with a fresh revision."}):r}},"run")}),Y=u({name:"path",description:"print the project config.json path",whenToUse:"you need the project config.json path for inspection or backup. User and profile settings use get-raw and set-raw instead.",help:{name:"sys config path",summary:"print the project config.json path",params:[{kind:"flag",name:"scope",type:"enum",choices:["project","user","profile"],required:!1,constraint:"Project is the only path-backed settings scope. user and profile are rejected because they use SQL-backed get-raw and set-raw. Default: project."}],output:[{name:"paths",type:"object[]",required:!0,constraint:'One {scope: "project", path} entry when the current project has a config file; otherwise empty.'}],outputKind:"object",effects:["None. Read-only."]},run:i(async t=>{const e=t.scope;if(e==="user"||e==="profile")throw o(`${e} settings are SQL-backed; use \`crtr sys config get-raw --scope ${e}\` instead.`);const n=N("project");return{paths:n===null?[]:[{scope:"project",path:n}]}},"run")}),ce=j({name:"config",description:"read and write configuration",whenToUse:"inspecting crtr settings, changing supported scalar values, replacing complete raw user or profile settings documents, or locating a project config.json. Keybinding changes belong in sys settings.",help:{name:"sys config",summary:"read and write crtr configuration, including model ladders and raw SQL-backed user/profile settings",model:"get and set resolve individual settings. get-raw and set-raw read and replace complete user or profile documents with a revision precondition. path applies only to project config.json."},children:[B,H,V,z,Y]});export{ce as configBranch};

package/dist/commands/sys/context/admin/actions.js

@@ -1,246 +1,2 @@
-// Every write `crtr sys context admin` can make. Document changes go through
-// the same `memory edit` / `memory move` leaves the CLI runs, always with
-// rationale `editor`; a project relationship's memory ceiling goes through the
-// profile manifest the profiles settings panel writes. Nothing here touches a
-// memory file directly.
-import { dirname } from 'node:path';
-import { editLeaf } from '../../../memory/edit.js';
-import { literalBodySegment } from '../../../memory/shared.js';
-import { moveLeaf } from '../../../memory/move.js';
-import { addProfileProject, loadProfileManifest } from '../../../../core/profiles/manifest.js';
-import { findProjectScopeRoots } from '../../../../core/scope.js';
-import { readText, realpathOrSelf } from '../../../../core/fs-utils.js';
-import { parseSubstrateFrontmatter } from '../../../../core/substrate/schema.js';
-import { surfaceEntryToFlag } from './model.js';
-const RATIONALE = 'editor';
-/** Which store a mutation must land in, or why the page cannot name one.
- *
- *  The memory leaves resolve a bare name against the AMBIENT target — this
- *  process's cwd, profile and node — while the page plans against a dialled
- *  snapshot that may name a different one. Every mutation therefore carries an
- *  explicit selector for the store the record was actually read from. A record
- *  no selector reaches is READ-ONLY here rather than sent without one: the leaf
- *  would resolve the bare name ambiently and rewrite whatever wins it — a
- *  same-named override at a writable scope — and report that as success. */
-function storeAddress(record, profileId) {
-    if (record.doc.plugin !== undefined) {
-        return {
-            refusal: `${record.name} belongs to the plugin “${record.doc.plugin}” and is read-only here — override it with \`crtr memory write ${record.name}\`.`,
-        };
-    }
-    if (record.scope === 'builtin') {
-        return {
-            refusal: `${record.name} is a builtin document and is read-only here — override it with \`crtr memory write ${record.name}\`.`,
-        };
-    }
-    if (record.scope === 'project') {
-        const ownerDir = record.source.store.ownerDir;
-        return ownerDir === undefined
-            ? { refusal: `${record.name} resolves from a project store with no owning directory, which this page cannot address — edit it with \`crtr memory edit ${record.name} --dir <dir>\`.` }
-            : { selector: { dir: ownerDir } };
-    }
-    if (record.scope === 'profile') {
-        return { selector: profileId === null ? { scope: 'profile' } : { scope: 'profile', profile: profileId } };
-    }
-    if (record.scope === 'user' || record.scope === 'node')
-        return { selector: { scope: record.scope } };
-    return { refusal: `${record.name} resolves from the ${record.scope} scope, which this page cannot address.` };
-}
-/** The notice a mutating action shows instead of writing, or null when the
- *  record is writable. The dossier marks a refusing record read-only so the
- *  refusal is never a surprise. */
-export function readOnlyReason(record, profileId) {
-    const address = storeAddress(record, profileId);
-    return 'refusal' in address ? address.refusal : null;
-}
-function failure(error) {
-    return { ok: false, message: error instanceof Error ? error.message : String(error) };
-}
-async function runEdit(record, profileId, request, success) {
-    const address = storeAddress(record, profileId);
-    if ('refusal' in address)
-        return { ok: false, message: address.refusal };
-    const surfaces = request.surfaces;
-    const unset = [...(request.unset ?? [])];
-    if (surfaces !== undefined && surfaces.length === 0 && !unset.includes('surfaces'))
-        unset.push('surfaces');
-    try {
-        await editLeaf.run({
-            name: record.name,
-            rationale: RATIONALE,
-            ...address.selector,
-            ...(surfaces !== undefined && surfaces.length > 0 ? { surface: surfaces.map(surfaceEntryToFlag) } : {}),
-            ...(request.body === undefined ? {} : { body: request.body }),
-            ...(request.gate === undefined ? {} : { gate: request.gate }),
-            ...(request.unlisted === undefined ? {} : { unlisted: true }),
-            ...(request.slash === undefined ? {} : { slash: true }),
-            ...(request.whenAndWhyToRead === undefined ? {} : { whenAndWhyToRead: request.whenAndWhyToRead }),
-            ...(request.shortForm === undefined ? {} : { shortForm: request.shortForm }),
-            ...(unset.length > 0 ? { unset } : {}),
-        });
-        return { ok: true, message: success, name: record.name };
-    }
-    catch (error) {
-        return failure(error);
-    }
-}
-/** Replace one document's whole surfaces list — refused when the list on disk
- *  holds more than the parsed list can carry back. */
-export function writeSurfaces(record, profileId, surfaces, success) {
-    const refusal = readOnlyReason(record, profileId) ?? unwritableSurfaces(record);
-    if (refusal !== null)
-        return Promise.resolve({ ok: false, message: refusal });
-    return runEdit(record, profileId, { surfaces }, success);
-}
-/** Why the authored `surfaces` list cannot survive a write, or null when it can.
- *
- *  A surface write REPLACES the whole list with the parsed entries, and the
- *  runtime parser is tolerant: it drops an entry it cannot read and strips a key
- *  it does not know. Writing that list back would delete authored content the
- *  page never showed, so an unrepresentable list refuses the edit instead —
- *  `memory edit --surface` admits only entries the strict coercion accepts, so
- *  carrying the original through verbatim is not available either. */
-function unwritableSurfaces(record) {
-    const raw = record.source.frontmatter?.['surfaces'];
-    if (raw === undefined || raw === null)
-        return null;
-    const fix = `a write replaces the whole list, so fix ${record.storePath} first`;
-    if (!Array.isArray(raw)) {
-        return `The \`surfaces\` field of ${record.name} is not a list of entries — ${fix}.`;
-    }
-    for (const [index, entry] of raw.entries()) {
-        const loss = entryLoss(record.kind, entry);
-        if (loss !== null)
-            return `Entry ${index + 1} of ${record.name} ${loss} — ${fix}.`;
-    }
-    return null;
-}
-/** The frontmatter key behind each field a parsed entry carries back. */
-const ENTRY_FIELDS = {
-    on: 'on',
-    at: 'at',
-    match: 'match',
-    'match-frontmatter': 'matchFrontmatter',
-    gate: 'gate',
-};
-function entryLoss(kind, raw) {
-    if (raw === null || typeof raw !== 'object' || Array.isArray(raw))
-        return 'is not an entry object';
-    const rec = raw;
-    const parsed = parseSubstrateFrontmatter({ kind, surfaces: [rec] })?.surfaces[0];
-    if (parsed === undefined)
-        return `(on ${JSON.stringify(rec['on'] ?? null)}) is malformed and the parser drops it`;
-    for (const key of Object.keys(rec)) {
-        if (rec[key] === undefined)
-            continue;
-        const field = ENTRY_FIELDS[key];
-        if (field === undefined)
-            return `carries an unknown key \`${key}\``;
-        if (parsed[field] === undefined)
-            return `carries a \`${key}\` the parser drops`;
-    }
-    return null;
-}
-/** The body exactly as it sits after the frontmatter fence, which is what the
- *  revision path saves back. The PARSED body eats the blank line the fence opens
- *  with, so seeding an editor from it would rewrite every doc it touched. */
-export function readBody(record) {
-    const segment = literalBodySegment(readText(record.storePath));
-    return segment.startsWith('\n') ? segment.slice(1) : segment;
-}
-/** Replace one document's whole body. */
-export function writeBody(record, profileId, body) {
-    if (body.trim() === '') {
-        return Promise.resolve({
-            ok: false,
-            message: `An empty body is not an edit \u2014 remove ${record.name} with \`crtr memory delete\` instead.`,
-        });
-    }
-    return runEdit(record, profileId, { body }, `Rewrote the body of ${record.name}.`);
-}
-/** Set or clear the document-level gate. An empty predicate clears it. */
-export function writeGate(record, profileId, gate) {
-    const trimmed = gate.trim();
-    return trimmed === ''
-        ? runEdit(record, profileId, { unset: ['gate'] }, `Cleared the gate on ${record.name}.`)
-        : runEdit(record, profileId, { gate: trimmed }, `Gated ${record.name} on ${trimmed}.`);
-}
-export function toggleFlag(record, profileId, field) {
-    const on = field === 'unlisted' ? record.doc.unlisted : record.doc.slash;
-    if (on)
-        return runEdit(record, profileId, { unset: [field] }, `${record.name} is no longer ${field}.`);
-    const set = field === 'unlisted' ? { unlisted: true } : { slash: true };
-    return runEdit(record, profileId, set, `${record.name} is now ${field}.`);
-}
-export function writeRoutingLine(record, profileId, line) {
-    const trimmed = line.trim();
-    if (trimmed === '') {
-        return Promise.resolve({ ok: false, message: 'A routing line cannot be empty — it is the document\u2019s contract.' });
-    }
-    return runEdit(record, profileId, { whenAndWhyToRead: trimmed }, `Rewrote the routing line on ${record.name}.`);
-}
-export function writeShortForm(record, profileId, text) {
-    const trimmed = text.trim();
-    return trimmed === ''
-        ? runEdit(record, profileId, { unset: ['short-form'] }, `Cleared the short form on ${record.name}.`)
-        : runEdit(record, profileId, { shortForm: trimmed }, `Rewrote the short form on ${record.name}.`);
-}
-/** Rename or relocate a document inside its own store. */
-export async function moveDoc(record, profileId, to) {
-    const trimmed = to.trim();
-    if (trimmed === '')
-        return { ok: false, message: 'Type the new canonical name.' };
-    const address = storeAddress(record, profileId);
-    if ('refusal' in address)
-        return { ok: false, message: address.refusal };
-    try {
-        const result = (await moveLeaf.run({
-            name: record.name,
-            to: trimmed,
-            ...address.selector,
-        }));
-        const name = typeof result?.['name'] === 'string' ? result['name'] : trimmed;
-        return { ok: true, message: `${record.name} now answers to ${name}.`, name };
-    }
-    catch (error) {
-        return failure(error);
-    }
-}
-/** The profile project entry whose ceiling reaches a document's store, or null
- *  when the store carries the neutral ceiling because no entry covers it.
- *
- *  Mirrors `resolveProjectScopeRoots`: pointers are walked in manifest order
- *  and the FIRST entry whose ancestor walk reaches the store's SCOPE root — the
- *  `.crouter/` dir one level above the `memory/` store — owns the ceiling, so
- *  cycling any other entry would move a number the store never reads. */
-export function capOwnerFor(record, profileId) {
-    if (profileId === null || record.scope !== 'project')
-        return null;
-    // Realpathed on both sides: a manifest path is stored already resolved while
-    // a store root is derived from the dialled cwd, so a symlinked ancestor would
-    // otherwise read as no entry governing the store.
-    const scopeRoot = realpathOrSelf(dirname(record.source.store.storeRoot));
-    let manifest;
-    try {
-        manifest = loadProfileManifest(profileId).manifest;
-    }
-    catch {
-        return null;
-    }
-    for (const project of manifest.projects) {
-        if (findProjectScopeRoots(project.path, null).some((root) => realpathOrSelf(root) === scopeRoot)) {
-            return { path: project.path, memory: project.memory };
-        }
-    }
-    return null;
-}
-/** Move a project relationship's automatic-delivery ceiling. */
-export function writeCap(profileId, path, memory) {
-    try {
-        addProfileProject(profileId, path, { memory });
-        return { ok: true, message: `${path} discloses up to "${memory}".`, change: { path, memory } };
-    }
-    catch (error) {
-        return failure(error);
-    }
-}
+var h=Object.defineProperty;var a=(e,n)=>h(e,"name",{value:n,configurable:!0});import{dirname as d}from"node:path";import{editLeaf as p}from"../../../memory/edit.js";import{literalBodySegment as g}from"../../../memory/shared.js";import{moveLeaf as y}from"../../../memory/move.js";import{addProfileProject as $,loadProfileManifest as w}from"../../../../core/profiles/manifest.js";import{findProjectScopeRoots as k}from"../../../../core/scope.js";import{readText as x,realpathOrSelf as l}from"../../../../core/fs-utils.js";import{parseSubstrateFrontmatter as R}from"../../../../core/substrate/schema.js";import{surfaceEntryToFlag as b}from"./model.js";const A="editor";function f(e,n){if(e.doc.plugin!==void 0)return{refusal:`${e.name} belongs to the plugin \u201C${e.doc.plugin}\u201D and is read-only here \u2014 override it with \`crtr memory write ${e.name}\`.`};if(e.scope==="builtin")return{refusal:`${e.name} is a builtin document and is read-only here \u2014 override it with \`crtr memory write ${e.name}\`.`};if(e.scope==="project"){const t=e.source.store.ownerDir;return t===void 0?{refusal:`${e.name} resolves from a project store with no owning directory, which this page cannot address \u2014 edit it with \`crtr memory edit ${e.name} --dir <dir>\`.`}:{selector:{dir:t}}}return e.scope==="profile"?{selector:n===null?{scope:"profile"}:{scope:"profile",profile:n}}:e.scope==="user"||e.scope==="node"?{selector:{scope:e.scope}}:{refusal:`${e.name} resolves from the ${e.scope} scope, which this page cannot address.`}}a(f,"storeAddress");function F(e,n){const t=f(e,n);return"refusal"in t?t.refusal:null}a(F,"readOnlyReason");function m(e){return{ok:!1,message:e instanceof Error?e.message:String(e)}}a(m,"failure");async function i(e,n,t,r){const o=f(e,n);if("refusal"in o)return{ok:!1,message:o.refusal};const s=t.surfaces,u=[...t.unset??[]];s!==void 0&&s.length===0&&!u.includes("surfaces")&&u.push("surfaces");try{return await p.run({name:e.name,rationale:A,...o.selector,...s!==void 0&&s.length>0?{surface:s.map(b)}:{},...t.body===void 0?{}:{body:t.body},...t.gate===void 0?{}:{gate:t.gate},...t.unlisted===void 0?{}:{unlisted:!0},...t.slash===void 0?{}:{slash:!0},...t.whenAndWhyToRead===void 0?{}:{whenAndWhyToRead:t.whenAndWhyToRead},...t.shortForm===void 0?{}:{shortForm:t.shortForm},...u.length>0?{unset:u}:{}}),{ok:!0,message:r,name:e.name}}catch(c){return m(c)}}a(i,"runEdit");function G(e,n,t,r){const o=F(e,n)??j(e);return o!==null?Promise.resolve({ok:!1,message:o}):i(e,n,{surfaces:t},r)}a(G,"writeSurfaces");function j(e){const n=e.source.frontmatter?.surfaces;if(n==null)return null;const t=`a write replaces the whole list, so fix ${e.storePath} first`;if(!Array.isArray(n))return`The \`surfaces\` field of ${e.name} is not a list of entries \u2014 ${t}.`;for(const[r,o]of n.entries()){const s=S(e.kind,o);if(s!==null)return`Entry ${r+1} of ${e.name} ${s} \u2014 ${t}.`}return null}a(j,"unwritableSurfaces");const v={on:"on",at:"at",match:"match","match-frontmatter":"matchFrontmatter",gate:"gate"};function S(e,n){if(n===null||typeof n!="object"||Array.isArray(n))return"is not an entry object";const t=n,r=R({kind:e,surfaces:[t]})?.surfaces[0];if(r===void 0)return`(on ${JSON.stringify(t.on??null)}) is malformed and the parser drops it`;for(const o of Object.keys(t)){if(t[o]===void 0)continue;const s=v[o];if(s===void 0)return`carries an unknown key \`${o}\``;if(r[s]===void 0)return`carries a \`${o}\` the parser drops`}return null}a(S,"entryLoss");function J(e){const n=g(x(e.storePath));return n.startsWith(`
+`)?n.slice(1):n}a(J,"readBody");function M(e,n,t){return t.trim()===""?Promise.resolve({ok:!1,message:`An empty body is not an edit \u2014 remove ${e.name} with \`crtr memory delete\` instead.`}):i(e,n,{body:t},`Rewrote the body of ${e.name}.`)}a(M,"writeBody");function Y(e,n,t){const r=t.trim();return r===""?i(e,n,{unset:["gate"]},`Cleared the gate on ${e.name}.`):i(e,n,{gate:r},`Gated ${e.name} on ${r}.`)}a(Y,"writeGate");function _(e,n,t){return(t==="unlisted"?e.doc.unlisted:e.doc.slash)?i(e,n,{unset:[t]},`${e.name} is no longer ${t}.`):i(e,n,t==="unlisted"?{unlisted:!0}:{slash:!0},`${e.name} is now ${t}.`)}a(_,"toggleFlag");function z(e,n,t){const r=t.trim();return r===""?Promise.resolve({ok:!1,message:"A routing line cannot be empty \u2014 it is the document\u2019s contract."}):i(e,n,{whenAndWhyToRead:r},`Rewrote the routing line on ${e.name}.`)}a(z,"writeRoutingLine");function H(e,n,t){const r=t.trim();return r===""?i(e,n,{unset:["short-form"]},`Cleared the short form on ${e.name}.`):i(e,n,{shortForm:r},`Rewrote the short form on ${e.name}.`)}a(H,"writeShortForm");async function K(e,n,t){const r=t.trim();if(r==="")return{ok:!1,message:"Type the new canonical name."};const o=f(e,n);if("refusal"in o)return{ok:!1,message:o.refusal};try{const s=await y.run({name:e.name,to:r,...o.selector}),u=typeof s?.name=="string"?s.name:r;return{ok:!0,message:`${e.name} now answers to ${u}.`,name:u}}catch(s){return m(s)}}a(K,"moveDoc");function Q(e,n){if(n===null||e.scope!=="project")return null;const t=l(d(e.source.store.storeRoot));let r;try{r=w(n).manifest}catch{return null}for(const o of r.projects)if(k(o.path,null).some(s=>l(s)===t))return{path:o.path,memory:o.memory};return null}a(Q,"capOwnerFor");function U(e,n,t){try{return $(e,n,{memory:t}),{ok:!0,message:`${n} discloses up to "${t}".`,change:{path:n,memory:t}}}catch(r){return m(r)}}a(U,"writeCap");export{Q as capOwnerFor,K as moveDoc,J as readBody,F as readOnlyReason,_ as toggleFlag,M as writeBody,U as writeCap,Y as writeGate,z as writeRoutingLine,H as writeShortForm,G as writeSurfaces};