@miller-tech/uap 2.21.3 → 2.36.1

package/dist/cli/models.js

@@ -0,0 +1,567 @@
+/**
+ * `uap models` — model placement surface (spec §4.7).
+ *
+ *   validate — registry (repo + machine-local merge) ↔ capacity-policy
+ *              cross-check, provenance per measured config. Read-only.
+ *   measure  — record the LIVE backend's footprint into
+ *              ~/.uap/model-registry.json. Fails closed on anything
+ *              unverifiable.
+ *   status   — sync + print the placement ledger: devices (probe fact),
+ *              residents, headroom.
+ *   pending  — list parked placement requests awaiting the operator, with
+ *              ranked options (1-based, what `apply` takes).
+ *   apply    — the explicit operator yes: prints the impact list first,
+ *              then enforces (drain → stop → verify-free → start → verify
+ *              → refresh), rolling back on any failure. --yes required.
+ *   dismiss  — refuse a parked request; the client falls back on expiry.
+ *   load     — operator-initiated load; reuse/load-alongside only, never
+ *              displacement (displacement needs the pending path).
+ *   unload   — drain, stop, verify-free, refresh for a model's residents.
+ *   units    — write Conflicts= drop-ins for same-device units (systemd
+ *              itself then refuses two same-device residents).
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { dirname } from 'path';
+import { REGISTRY_VERSION, configCostMiB, isMeasuredConfig, loadModelRegistry, validateRegistry, } from '../placement/registry.js';
+import { gpuComputeMiB, gpuStatsByIndex, hostRssMiB, hostTotalMiB, listeningPortPid, unitCgroupPids, unitMainPid, isUnitActive, } from '../placement/probes.js';
+import { loadLedger, placementLedgerPath, residentTargetId, syncLedger, } from '../placement/ledger.js';
+import { computeOptions } from '../placement/admission.js';
+import { buildVictimPreviews } from '../placement/preview.js';
+import { resolvePendingPlacement, dismissPendingPlacement, loadPlacement, unloadPlacement, writePlacementUnitDropins, fetchProxyInflight, } from '../placement/enforce.js';
+import { resolveAttentionBySource } from '../delivery/attention.js';
+import { autoPolicyPath, loadAutoPolicy, MIN_UNLOAD_IDLE_SECS, saveAutoPolicy, } from '../placement/auto.js';
+import { loadPolicy } from '../capacity/probe.js';
+import { looksLikeStrataMetrics, parseStrataEngine } from '../inference/strata.js';
+const PROBE_TIMEOUT_MS = 5000;
+function fail(msg) {
+    throw new Error(msg);
+}
+async function fetchMetrics(endpoint) {
+    const url = `${endpoint.replace(/\/+$/, '')}/metrics`;
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), PROBE_TIMEOUT_MS);
+    try {
+        const res = await fetch(url, { signal: ctrl.signal });
+        if (!res.ok)
+            throw new Error(`GET ${url} → HTTP ${res.status}`);
+        return (await res.json());
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function endpointPort(endpoint) {
+    try {
+        return new URL(endpoint).port ? Number(new URL(endpoint).port) : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function modelsValidateCommand(opts = {}) {
+    const projectDir = opts.projectDir ?? process.cwd();
+    const loaded = loadModelRegistry(projectDir, { repoPath: opts.repoPath, localPath: opts.localPath });
+    for (const err of loaded.errors)
+        console.error(`registry error: ${err}`);
+    let findings = [];
+    try {
+        const { policy } = loadPolicy(projectDir);
+        findings = validateRegistry(loaded.registry, policy);
+    }
+    catch (err) {
+        console.error(`capacity policy unavailable: ${err.message}`);
+    }
+    console.log(`repo registry:   ${loaded.repoPath}${existsSync(loaded.repoPath) ? '' : '  (missing)'}`);
+    console.log(`local registry:  ${loaded.localPath}${existsSync(loaded.localPath) ? '' : '  (missing — no measured footprints on this machine)'}`);
+    console.log('');
+    for (const [dKey, dev] of Object.entries(loaded.registry.devices)) {
+        const total = dev.total_mib !== undefined ? `${dev.total_mib} MiB` : 'total unmeasured';
+        const reserved = dev.reserved_mib !== undefined ? `, ${dev.reserved_mib} MiB reserved` : ', reserve unmeasured';
+        console.log(`device ${dKey}: ${dev.kind}, ${total}${reserved}`);
+    }
+    console.log('');
+    for (const [mKey, model] of Object.entries(loaded.registry.models)) {
+        console.log(`${model.display}  (${mKey})`);
+        for (const [cKey, cfg] of Object.entries(model.configs)) {
+            if (isMeasuredConfig(cfg)) {
+                const src = loaded.measuredFrom.get(`${mKey}/${cKey}`);
+                const cost = configCostMiB(cfg, cfg.kv_resident_cells);
+                console.log(`  ${cKey}: measured — ${cfg.resident_gpu_mib} MiB GPU, ${cfg.host_rss_mib} MiB RSS, kv ${cfg.kv_kind ?? '?'} (${cfg.kv_resident_cells}/${cfg.context_pool_cells} cells) [${src}]` + (cost === null ? '  cost above pool: unknown' : ''));
+            }
+            else {
+                console.log(`  ${cKey}: unmeasured — fails closed (servable if resident, never loadable)`);
+            }
+        }
+    }
+    console.log('');
+    if (findings.length > 0) {
+        for (const f of findings)
+            console.error(`${f.severity === 'error' ? 'ERROR' : 'WARN '}  ${f.scope}: ${f.message}`);
+    }
+    else {
+        console.log('validate: no findings');
+    }
+    const errors = loaded.errors.length + findings.filter((f) => f.severity === 'error').length;
+    return errors > 0 ? 1 : 0;
+}
+/** Find the registry entry the live backend's advertised model id maps to.
+ * Exactly one match or explicit --model/--config; ambiguity is an error, not
+ * a guess — attributing a measurement to the wrong entry poisons the
+ * registry. */
+function resolveMeasureTarget(registry, liveModel, modelKey, configKey) {
+    const wantExplicit = modelKey !== undefined || configKey !== undefined;
+    if (wantExplicit && (modelKey === undefined || configKey === undefined)) {
+        fail('--model and --config must be given together');
+    }
+    if (modelKey !== undefined && configKey !== undefined) {
+        const entry = registry.models[modelKey]?.configs[configKey];
+        if (!entry)
+            fail(`no registry config '${modelKey}/${configKey}'`);
+        const advertises = registry.models[modelKey].advertises ?? [];
+        if (liveModel && advertises.length > 0 && !advertises.includes(liveModel)) {
+            fail(`live backend advertises '${liveModel}' but ${modelKey} advertises [${advertises.join(', ')}] — refusing to attribute this measurement`);
+        }
+        return { modelKey, configKey, registry };
+    }
+    const matches = [];
+    for (const [mKey, model] of Object.entries(registry.models)) {
+        if (!liveModel)
+            continue;
+        if ((model.advertises ?? []).includes(liveModel)) {
+            const configKeys = Object.keys(model.configs);
+            for (const cKey of configKeys)
+                matches.push({ modelKey: mKey, configKey: cKey, registry });
+        }
+    }
+    if (matches.length === 1)
+        return matches[0];
+    if (matches.length === 0)
+        fail(`no registry entry advertises '${liveModel ?? '?'}' — pass --model <key> --config <key> to attribute the measurement`);
+    fail(`ambiguous: ${matches.map((m) => `${m.modelKey}/${m.configKey}`).join(', ')} all advertise '${liveModel}' — pass --model and --config`);
+}
+export async function modelsMeasureCommand(opts = {}) {
+    const projectDir = opts.projectDir ?? process.cwd();
+    const loaded = loadModelRegistry(projectDir, { repoPath: opts.repoPath, localPath: opts.localPath });
+    for (const err of loaded.errors)
+        console.error(`registry error: ${err}`);
+    if (loaded.errors.length > 0)
+        return 1;
+    const endpoint = opts.endpoint ?? 'http://127.0.0.1:8080';
+    const metrics = await fetchMetrics(endpoint).catch((err) => fail(`${err.message} — is the backend live? measure only works against a resident backend`));
+    if (!looksLikeStrataMetrics(metrics))
+        fail(`${endpoint}/metrics is not a strata metrics document — v1 measure supports strata-kind backends only`);
+    const { engine } = parseStrataEngine(metrics);
+    if (engine.maxContext === undefined)
+        fail('/metrics engine.max_context missing — refusing to guess the context pool');
+    if (engine.kvResident === undefined)
+        fail('/metrics engine.kv_resident missing — refusing to guess the resident KV pool');
+    if (engine.model === undefined)
+        fail('/metrics engine.model missing — cannot attribute the measurement');
+    const target = resolveMeasureTarget(loaded.registry, engine.model, opts.model, opts.config);
+    const model = loaded.registry.models[target.modelKey];
+    const entry = model.configs[target.configKey];
+    const unit = entry.unit ?? model.unit;
+    const port = endpointPort(endpoint);
+    // Prefer the unit's whole cgroup (multi-process backends), then MainPID,
+    // then the port listener (unit-less single-process backends).
+    const mainPid = unit ? unitMainPid(unit) : null;
+    const pids = (unit ? unitCgroupPids(unit) : null) ?? (mainPid ? [mainPid] : null) ?? (port ? [listeningPortPid(port)] : []);
+    if (pids.length === 0)
+        fail(`cannot find the backend processes (unit '${unit ?? 'none'}', port ${port ?? '?'}) — nothing to measure`);
+    const residentGpu = gpuComputeMiB(pids);
+    if (residentGpu === null)
+        fail(`nvidia-smi shows no GPU memory held by [${pids.join(', ')}] — refusing to record zero; is the backend on the GPU?`);
+    const rss = hostRssMiB(pids);
+    if (rss === null)
+        fail(`no /proc/<pid>/status readable for [${pids.join(', ')}] — refusing to guess host RSS`);
+    const device = opts.device ?? Object.entries(loaded.registry.devices).find(([, d]) => d.kind === 'gpu')?.[0] ?? 'gpu0';
+    // Identity fields (unit/profile/service/...) come from the merged entry so
+    // the measured write never drops how the config was found.
+    const measured = {
+        engine: entry.engine,
+        unit: entry.unit,
+        profile: entry.profile,
+        service: entry.service,
+        note: entry.note,
+        flags: entry.flags,
+        rails: entry.rails,
+        resident_gpu_mib: residentGpu,
+        host_rss_mib: rss,
+        context_pool_cells: engine.maxContext,
+        kv_resident_cells: engine.kvResident,
+        kv_kind: engine.kv,
+        measured_at: new Date().toISOString(),
+        measured_on: device,
+    };
+    console.log(`${target.modelKey}/${target.configKey} (${pids.join(', ')}${unit ? `, unit ${unit}` : ''}):`);
+    console.log(`  resident_gpu_mib: ${residentGpu}`);
+    console.log(`  host_rss_mib:     ${rss}`);
+    console.log(`  context_pool:     ${engine.maxContext} cells, kv ${engine.kv ?? '?'} resident ${engine.kvResident}`);
+    // Device facts (spec §4.1.1): the gpu reserve is DERIVED — capacity minus
+    // free minus the backend's own compute apps — so unattributed graphics
+    // memory lands in the reserve whether or not a PID owns it. The cpu
+    // reserve is the documented spec floor, not a measurement.
+    const deviceFacts = {};
+    const gpuIdx = /^gpu(\d+)$/.exec(device);
+    if (gpuIdx) {
+        const stats = gpuStatsByIndex().get(Number(gpuIdx[1]));
+        if (stats?.total_mib !== undefined && stats?.free_mib !== undefined) {
+            const reserved = Math.max(0, stats.total_mib - stats.free_mib - residentGpu);
+            deviceFacts[device] = {
+                kind: 'gpu',
+                total_mib: stats.total_mib,
+                reserved_mib: reserved,
+                reserve_reason: `derived: total ${stats.total_mib} − free ${stats.free_mib} − backend compute apps ${residentGpu}; captures desktop + unattributed graphics memory`,
+            };
+            console.log(`  ${device}: total ${stats.total_mib} MiB, derived reserve ${reserved} MiB (desktop + graphics)`);
+        }
+    }
+    const hostTotal = hostTotalMiB();
+    if (hostTotal !== null) {
+        deviceFacts.cpu0 = {
+            kind: 'cpu',
+            total_mib: hostTotal,
+            reserved_mib: 8192,
+            reserve_reason: 'spec §4.1 floor: page cache and the TS side must survive a 52 GiB engine attach',
+        };
+        console.log(`  cpu0: total ${hostTotal} MiB, reserve 8192 MiB (spec floor)`);
+    }
+    if (opts.dryRun) {
+        console.log('dry-run: nothing written');
+        return 0;
+    }
+    const localPath = loaded.localPath;
+    let localDoc = {};
+    if (existsSync(localPath)) {
+        localDoc = JSON.parse(readFileSync(localPath, 'utf-8'));
+    }
+    if (localDoc.version !== undefined && localDoc.version !== REGISTRY_VERSION) {
+        fail(`${localPath}: unsupported version ${localDoc.version} (expected ${REGISTRY_VERSION}) — refusing to clobber`);
+    }
+    localDoc.version = REGISTRY_VERSION;
+    localDoc.models = localDoc.models ?? {};
+    if (Object.keys(deviceFacts).length > 0) {
+        localDoc.devices = { ...localDoc.devices, ...deviceFacts };
+    }
+    const localModel = (localDoc.models[target.modelKey] = localDoc.models[target.modelKey] ?? { display: model.display, configs: {} });
+    localModel.configs = localModel.configs ?? {};
+    localModel.configs[target.configKey] = measured;
+    mkdirSync(dirname(localPath), { recursive: true });
+    writeFileSync(localPath, `${JSON.stringify(localDoc, null, 2)}\n`);
+    console.log(`written: ${localPath}`);
+    console.log('next: uap models validate');
+    return 0;
+}
+function printLedger(ledger) {
+    for (const [dKey, dev] of Object.entries(ledger.devices)) {
+        const free = dev.free_mib !== undefined ? `${dev.free_mib} MiB free` : 'free unprobed';
+        const total = dev.total_mib !== undefined ? `${dev.total_mib} MiB total` : 'total unmeasured';
+        const reserved = dev.reserved_mib !== undefined ? `, ${dev.reserved_mib} reserved` : ', reserve unmeasured';
+        console.log(`device ${dKey}: ${dev.kind}, ${total}, ${free}${reserved}  [${dev.source ?? '?'}]`);
+    }
+    console.log('');
+    if (ledger.residents.length === 0) {
+        console.log('residents: none');
+    }
+    for (const r of ledger.residents) {
+        const gpu = r.gpu_mib !== undefined ? `, ${r.gpu_mib} MiB GPU` : ', GPU unknown';
+        const rss = r.host_rss_mib !== undefined ? `, ${r.host_rss_mib} MiB RSS` : '';
+        console.log(`resident ${r.model}/${r.config}  ${r.state} on ${r.device}${gpu}${rss}${r.unit ? `  (${r.unit})` : ''}`);
+    }
+    console.log('');
+    console.log(ledger.pending.length === 0 ? 'pending: none' : `pending: ${ledger.pending.length}`);
+    for (const p of ledger.pending) {
+        console.log(`  ${p.id} ${p.requested_model} (client ${p.client ?? '?'}, expires ${p.expires_at}) — ${p.reason ?? 'parked'}`);
+    }
+}
+export async function modelsStatusCommand(opts = {}) {
+    const projectDir = opts.projectDir ?? process.cwd();
+    const loaded = loadModelRegistry(projectDir, { repoPath: opts.repoPath, localPath: opts.localPath });
+    for (const err of loaded.errors)
+        console.error(`registry error: ${err}`);
+    if (loaded.errors.length > 0)
+        return 1;
+    const ledgerPath = opts.ledgerPath ?? placementLedgerPath();
+    const ledger = syncLedger(loaded.registry, ledgerPath, isUnitActive);
+    printLedger(ledger);
+    return 0;
+}
+export async function modelsPendingCommand(opts = {}) {
+    const projectDir = opts.projectDir ?? process.cwd();
+    const ledgerPath = opts.ledgerPath ?? placementLedgerPath();
+    const ledger = loadLedger(ledgerPath);
+    if (ledger.pending.length === 0) {
+        console.log('no pending placement requests');
+        return 0;
+    }
+    const loaded = loadModelRegistry(projectDir, { repoPath: opts.repoPath, localPath: opts.localPath });
+    const now = Date.now();
+    for (const p of ledger.pending) {
+        const expires = new Date(p.expires_at).getTime();
+        console.log(`${p.id}  ${p.requested_model}`);
+        console.log(`  client ${p.client ?? '?'}${p.session ? `, session ${p.session}` : ''}${p.pid ? `, pid ${p.pid}` : ''}`);
+        console.log(`  parked ${p.created_at}, expires ${p.expires_at} (${expires > now ? `${Math.round((expires - now) / 1000)}s left` : 'EXPIRED'})`);
+        console.log(`  reason: ${p.reason ?? 'parked'}`);
+        // Options are per-request (spec §4.4): recompute against the context the
+        // parked request actually needs, when the proxy recorded it — the 32k
+        // default would fail-closed-refuse a small-pool config that fits fine.
+        const options = computeOptions(loaded.registry, ledger, p.requested_model, { cells: p.cells }).options;
+        if (options.length === 0) {
+            console.log('  no viable option (unmeasured, unknown cost, or nothing fits)');
+        }
+        options.forEach((o, i) => {
+            const victims = o.victims ?? [];
+            const impact = victims.length
+                ? ` — displaces ${victims.map((v) => `${v.model}/${v.config}`).join(', ')}`
+                : '';
+            console.log(`  option ${i + 1}: ${o.kind} ${o.model}/${o.config} on ${o.device}${impact}`);
+        });
+    }
+    console.log('');
+    console.log('resolve: uap models apply <id> <option> --yes   |   refuse: uap models dismiss <id>');
+    return 0;
+}
+export async function modelsApplyCommand(opts = {}) {
+    const projectDir = opts.projectDir ?? process.cwd();
+    const placementId = opts.placementId ?? '';
+    const option = Number(opts.option);
+    if (!placementId || !Number.isInteger(option) || option < 1) {
+        console.error('usage: uap models apply <placement-id> <option> [--yes]');
+        return 1;
+    }
+    const ledgerPath = opts.ledgerPath ?? placementLedgerPath();
+    const pending = loadLedger(ledgerPath).pending.find((p) => p.id === placementId);
+    if (!pending) {
+        console.error(`no pending placement ${placementId} (run: uap models pending)`);
+        return 1;
+    }
+    const loaded = loadModelRegistry(projectDir, { repoPath: opts.repoPath, localPath: opts.localPath });
+    // The operator approves the option list the PARKED REQUEST computed against
+    // its own context need (recorded in the entry) — not the 32k default, which
+    // can refuse a config that serves this request fine.
+    const options = computeOptions(loaded.registry, loadLedger(ledgerPath), pending.requested_model, {
+        cells: pending.cells,
+    }).options;
+    const approved = options[option - 1];
+    if (!approved) {
+        console.error(`option ${option} does not exist (1-${options.length})`);
+        return 1;
+    }
+    // Print the impact list first (spec §4.7): the operator approves KNOWING
+    // what is killed. In-flight is the proxy's live view when it answers;
+    // otherwise the honest `unknown`.
+    if (approved.victims?.length) {
+        const inflightMap = await fetchProxyInflight();
+        const inflightOf = (victim) => {
+            if (inflightMap === null)
+                return 'unknown';
+            const entries = inflightMap.get(residentTargetId(victim));
+            return entries !== undefined ? entries.length > 0 : 'unknown';
+        };
+        console.log('impact:');
+        for (const v of buildVictimPreviews(loaded.registry, approved.victims, inflightOf)) {
+            console.log(`  ${v.model}/${v.config} on ${v.device}: ${v.consequence} (frees ${v.frees_gpu_mib} MiB GPU)`);
+        }
+    }
+    else {
+        console.log(`impact: none (${approved.kind} ${approved.model}/${approved.config})`);
+    }
+    if (!opts.yes) {
+        console.log('');
+        console.log(`confirm: uap models apply ${placementId} ${option} --yes`);
+        return 1;
+    }
+    // The approval signature: what is enforced must be exactly what the
+    // impact list above showed (a recomputed drift between print and enforce
+    // refuses instead of displacing a set the operator never saw).
+    const result = await resolvePendingPlacement(projectDir, placementId, option, {
+        ledgerPath,
+        expectedVictims: (approved.victims ?? []).map((v) => ({ model: v.model, config: v.config })),
+    });
+    for (const s of result.steps)
+        console.log(`${s.ok ? 'ok  ' : 'FAIL'} ${s.name}${s.detail ? ` — ${s.detail}` : ''}`);
+    if (!result.ok) {
+        console.error(`enforcement failed${result.rolledBack ? ' (rolled back)' : ''}: ${result.error}`);
+        return 1;
+    }
+    // P3: close the attention ask by origin — the operator answered through
+    // the placement surface; a later sweep must not record a false AFK
+    // adoption over this decision. Best-effort + idempotent (no open ask →
+    // resolves nothing).
+    resolveAttentionBySource(projectDir, `placement:${placementId}`, `operator applied option ${option}`);
+    console.log('placement applied; the parked client is served on its next retry');
+    return 0;
+}
+export async function modelsDismissCommand(opts = {}) {
+    const placementId = opts.placementId ?? '';
+    if (!placementId) {
+        console.error('usage: uap models dismiss <placement-id>');
+        return 1;
+    }
+    const { dismissed } = dismissPendingPlacement(placementId, { ledgerPath: opts.ledgerPath });
+    if (dismissed) {
+        // Same origin-close as apply (see above); the queue root is the main
+        // checkout, so the CLI's cwd only needs to be inside the project.
+        resolveAttentionBySource(process.cwd(), `placement:${placementId}`, 'operator dismissed the parked request');
+    }
+    console.log(dismissed ? `dismissed ${placementId}; the client falls back on its next retry` : `no pending placement ${placementId}`);
+    return dismissed ? 0 : 1;
+}
+export async function modelsLoadCommand(opts = {}) {
+    const projectDir = opts.projectDir ?? process.cwd();
+    const model = opts.model ?? '';
+    if (!model) {
+        console.error('usage: uap models load <model-key>');
+        return 1;
+    }
+    const result = await loadPlacement(projectDir, model, { ledgerPath: opts.ledgerPath });
+    for (const s of result.steps)
+        console.log(`${s.ok ? 'ok  ' : 'FAIL'} ${s.name}${s.detail ? ` — ${s.detail}` : ''}`);
+    if (!result.ok) {
+        console.error(result.error);
+        return 1;
+    }
+    return 0;
+}
+export async function modelsUnloadCommand(opts = {}) {
+    const projectDir = opts.projectDir ?? process.cwd();
+    const model = opts.model ?? '';
+    if (!model) {
+        console.error('usage: uap models unload <model-key>');
+        return 1;
+    }
+    const result = await unloadPlacement(projectDir, model, { ledgerPath: opts.ledgerPath });
+    for (const s of result.steps)
+        console.log(`${s.ok ? 'ok  ' : 'FAIL'} ${s.name}${s.detail ? ` — ${s.detail}` : ''}`);
+    if (!result.ok) {
+        console.error(result.error);
+        return 1;
+    }
+    return 0;
+}
+export async function modelsUnitsCommand(opts = {}) {
+    const projectDir = opts.projectDir ?? process.cwd();
+    const loaded = loadModelRegistry(projectDir, { repoPath: opts.repoPath, localPath: opts.localPath });
+    const { written, dir } = writePlacementUnitDropins(loaded.registry);
+    if (written.length === 0) {
+        console.log('no same-device unit pairs in the registry; nothing to write');
+        return 0;
+    }
+    for (const w of written)
+        console.log(`wrote ${w}`);
+    console.log(`(Conflicts= drop-ins in ${dir}; the operator's unit files are untouched)`);
+    return 0;
+}
+export function modelsAutoCommand(opts = {}) {
+    const path = opts.policyPath ?? autoPolicyPath();
+    const policy = loadAutoPolicy(path);
+    if (opts.enable === true && opts.disable === true) {
+        console.error('--enable and --disable are mutually exclusive; pick one');
+        return 1;
+    }
+    if (opts.unloadIdleAfterSecs !== undefined && opts.unloadIdleAfterSecsOff) {
+        console.error('--unload-idle-after-secs and --unload-idle-off are mutually exclusive');
+        return 1;
+    }
+    const wantsChange = opts.enable === true || opts.disable === true || !!opts.allowDisplace || !!opts.disallowDisplace ||
+        opts.unloadIdleAfterSecs !== undefined || opts.unloadIdleAfterSecsOff === true ||
+        !!opts.allowUnload || !!opts.disallowUnload;
+    if (!wantsChange) {
+        console.log(`auto-load: ${policy.enabled ? 'enabled' : 'disabled'} (${path})`);
+        console.log('  non-displacing options (load-alongside) load automatically when the policy is enabled');
+        console.log(`  auto-displacement allowlist: ${policy.allow_displace.length ? policy.allow_displace.join(', ') : '(empty — displacement always parks for the operator)'}`);
+        console.log(`  idle-unload: ${policy.unload_idle_after_secs
+            ? `after ${policy.unload_idle_after_secs}s idle; allowlist: ${policy.unload_allow?.length ? policy.unload_allow.join(', ') : '(empty — nobody is swept)'}`
+            : '(off — no unload_idle_after_secs recorded)'}`);
+        return 0;
+    }
+    const next = { ...policy, allow_displace: [...policy.allow_displace] };
+    if (opts.enable === true)
+        next.enabled = true;
+    if (opts.disable === true)
+        next.enabled = false;
+    const parseList = (v) => v.split(',').map((s) => s.trim()).filter(Boolean);
+    if (opts.allowDisplace) {
+        const adding = parseList(opts.allowDisplace);
+        if (!opts.yes) {
+            console.log('auto-displacement means: a parked request for these models UNLOADS the current');
+            console.log('resident(s) — the minimal set that makes room, re-evaluated at load time — and');
+            console.log('loads the requested one WITHOUT an operator prompt between them.');
+            console.log(`models: ${adding.join(', ')}`);
+            console.log(`confirm: uap models auto --allow-displace ${opts.allowDisplace} --yes`);
+            return 1;
+        }
+        for (const m of adding)
+            if (!next.allow_displace.includes(m))
+                next.allow_displace.push(m);
+        console.log(`auto-displacement allowed for: ${next.allow_displace.join(', ')}`);
+    }
+    if (opts.disallowDisplace) {
+        for (const m of parseList(opts.disallowDisplace)) {
+            next.allow_displace = next.allow_displace.filter((x) => x !== m);
+        }
+        console.log(`auto-displacement allowed for: ${next.allow_displace.join(', ') || '(none)'}`);
+    }
+    if (opts.allowUnload) {
+        const adding = parseList(opts.allowUnload);
+        if (!opts.yes) {
+            console.log('idle-unload means: once these models have served no gated request for the');
+            console.log('armed idle window AND their endpoint has no established connections, the');
+            console.log('dashboard STOPS their resident automatically — full drain and in-flight');
+            console.log('checks included — with no operator prompt.');
+            console.log(`models: ${adding.join(', ')}`);
+            console.log(`confirm: uap models auto --allow-unload ${opts.allowUnload} --yes`);
+            return 1;
+        }
+        next.unload_allow = [...(next.unload_allow ?? [])];
+        for (const m of adding)
+            if (!next.unload_allow.includes(m))
+                next.unload_allow.push(m);
+        console.log(`idle-unload allowed for: ${next.unload_allow.join(', ')}`);
+    }
+    if (opts.disallowUnload) {
+        next.unload_allow = [...(next.unload_allow ?? [])];
+        for (const m of parseList(opts.disallowUnload)) {
+            next.unload_allow = next.unload_allow.filter((x) => x !== m);
+        }
+        console.log(`idle-unload allowed for: ${next.unload_allow.join(', ') || '(none)'}`);
+    }
+    if (opts.unloadIdleAfterSecs !== undefined) {
+        if (!Number.isFinite(opts.unloadIdleAfterSecs) || opts.unloadIdleAfterSecs < MIN_UNLOAD_IDLE_SECS) {
+            console.error(`--unload-idle-after-secs must be >= ${MIN_UNLOAD_IDLE_SECS} (under a minute the sweep would thrash)`);
+            return 1;
+        }
+        next.unload_idle_after_secs = Math.floor(opts.unloadIdleAfterSecs);
+        console.log(`idle-unload timer: ${next.unload_idle_after_secs}s`);
+    }
+    if (opts.unloadIdleAfterSecsOff === true) {
+        delete next.unload_idle_after_secs;
+        console.log('idle-unload timer: (disarmed — allowlist left as recorded)');
+    }
+    saveAutoPolicy(next, path);
+    console.log(`auto-load: ${next.enabled ? 'enabled' : 'disabled'} (policy written to ${path})`);
+    console.log('the dashboard controller picks the policy up on its next admission (no restart needed)');
+    return 0;
+}
+export async function modelsCommand(action, opts) {
+    if (action === 'validate')
+        return modelsValidateCommand(opts);
+    if (action === 'measure')
+        return modelsMeasureCommand(opts);
+    if (action === 'status')
+        return modelsStatusCommand(opts);
+    if (action === 'apply')
+        return modelsApplyCommand(opts);
+    if (action === 'dismiss')
+        return modelsDismissCommand(opts);
+    if (action === 'load')
+        return modelsLoadCommand(opts);
+    if (action === 'unload')
+        return modelsUnloadCommand(opts);
+    if (action === 'units')
+        return modelsUnitsCommand(opts);
+    if (action === 'auto')
+        return modelsAutoCommand(opts);
+    return modelsPendingCommand(opts);
+}
+//# sourceMappingURL=models.js.map

package/dist/cli/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/cli/models.ts"],"names":[],"mappings":"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"}

package/dist/cli/plan.d.ts

@@ -1,4 +1,5 @@
 import type { LoopExecutor } from '../delivery/convergence-loop.js';
+import { type PlanReadabilityReport } from '../models/plan-readability.js';
 export interface PlanOptions {
     json?: boolean;
     /** Explicit plan artifact to review (positional arg after `validate`). */
@@ -18,6 +19,8 @@ export interface PlanReviewOutcome {
     file?: string;
     findings: string[];
     reason?: string;
+    /** B1 plan-comprehension scan — present whenever a review resolved plan text. */
+    readability?: PlanReadabilityReport;
 }
 declare function statePath(cwd: string): string;
 declare function windowSec(): number;
@@ -47,6 +50,12 @@ export interface PlanState {
         reason: string;
         at: number;
     }>;
+    /**
+     * B1 plan-comprehension scan record for the latest stamp. Additive: the
+     * Python enforcer (validate_plan_on_change.py) reads only pending/validated,
+     * so older/newer readers coexist with this key.
+     */
+    readability?: Pick<PlanReadabilityReport, 'passed' | 'strict' | 'findings'>;
 }
 /** Path key shared with the enforcer: repo-relative, forward slashes. */
 export declare function planKey(cwd: string, file: string): string;