@solidnumber/cli 2.16.0 → 2.18.0

package/dist/lib/apply/lock.js

@@ -0,0 +1,285 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_RUNS = exports.LOCK_VERSION = void 0;
+exports.lockKey = lockKey;
+exports.lockPathFor = lockPathFor;
+exports.specHash = specHash;
+exports.emptyLock = emptyLock;
+exports.readLock = readLock;
+exports.writeLock = writeLock;
+exports.newRunId = newRunId;
+exports.mergeRun = mergeRun;
+exports.classifyDrift = classifyDrift;
+exports.isProductionDrift = isProductionDrift;
+exports.buildRollbackPlan = buildRollbackPlan;
+exports.shapeForExport = shapeForExport;
+exports.toManifestYaml = toManifestYaml;
+/**
+ * `solid apply` lockfile, drift classification, rollback plan and export shaping.
+ *
+ * The lock lives NEXT TO the manifest (`site.yaml` → `site.lock.json`) so it is
+ * committed with it. It records, per resource, the server id and the managed
+ * fields as they stood when apply last wrote them — which is what makes a
+ * three-way comparison possible:
+ *
+ *   manifest (git)   lock (last apply)   live (production)
+ *
+ * and what `rollback` restores from: every run stores a pre-image (`before`)
+ * for each write it made.
+ *
+ * Everything in here that decides is pure (classifyDrift, buildRollbackPlan,
+ * shapeForExport, mergeRun); the two functions that touch disk are thin.
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_crypto_1 = require("node:crypto");
+const registry_1 = require("./registry");
+const engine_1 = require("./engine");
+exports.LOCK_VERSION = 1;
+exports.MAX_RUNS = 20;
+function lockKey(kind, identity) { return `${kind}/${identity}`; }
+function lockPathFor(manifestPath) {
+    const dir = path.dirname(manifestPath);
+    const base = path.basename(manifestPath).replace(/\.(ya?ml|json)$/i, '');
+    return path.join(dir, `${base}.lock.json`);
+}
+function specHash(spec) {
+    return (0, node_crypto_1.createHash)('sha256').update(stableStringify(spec)).digest('hex').slice(0, 16);
+}
+function stableStringify(v) {
+    if (v === null || typeof v !== 'object')
+        return JSON.stringify(v);
+    if (Array.isArray(v))
+        return `[${v.map(stableStringify).join(',')}]`;
+    const o = v;
+    return `{${Object.keys(o).sort().map((k) => `${JSON.stringify(k)}:${stableStringify(o[k])}`).join(',')}}`;
+}
+function emptyLock(companyId, manifestPath, cliVersion) {
+    return {
+        version: exports.LOCK_VERSION, company_id: companyId, manifest: path.basename(manifestPath),
+        applied_at: null, cli_version: cliVersion, resources: {}, runs: [],
+    };
+}
+function readLock(lockPath) {
+    if (!fs.existsSync(lockPath))
+        return null;
+    const parsed = JSON.parse(fs.readFileSync(lockPath, 'utf8'));
+    if (parsed.version !== exports.LOCK_VERSION) {
+        throw new Error(`${path.basename(lockPath)} is lock version ${parsed.version}; this CLI writes version ${exports.LOCK_VERSION}`);
+    }
+    return parsed;
+}
+function writeLock(lockPath, lock) {
+    fs.writeFileSync(lockPath, JSON.stringify(lock, null, 2) + '\n');
+}
+function newRunId(now = new Date()) {
+    return now.toISOString().replace(/[-:]/g, '').replace(/\.\d{3}Z$/, 'Z');
+}
+/**
+ * Fold an executed (non-dry-run) plan into the lock: resources that were
+ * created/updated/unchanged are recorded with the spec that now holds on the
+ * server; pruned ones are dropped; failed actions leave the lock untouched for
+ * that resource. Returns the new lock and the run record that was appended.
+ */
+function mergeRun(lock, results, opts) {
+    const now = opts.now ?? new Date();
+    const at = now.toISOString();
+    const resources = { ...lock.resources };
+    const actions = [];
+    for (const r of results) {
+        const key = lockKey(r.kind, r.identity);
+        if (r.status === 'failed')
+            continue;
+        if (r.action === 'noop') {
+            // Re-affirm: the server already matched the manifest. Record it so a
+            // later `drift` has a baseline even for resources apply never wrote.
+            if (r.spec || resources[key]) {
+                const spec = r.spec ?? resources[key].spec;
+                resources[key] = { kind: r.kind, identity: r.identity, id: r.id ?? resources[key]?.id, spec, spec_hash: specHash(spec), applied_at: resources[key]?.applied_at ?? at };
+            }
+            continue;
+        }
+        if (r.action === 'unsupported')
+            continue;
+        if (r.action === 'prune') {
+            delete resources[key];
+            actions.push({ kind: r.kind, identity: r.identity, action: 'prune', id: r.id, before: r.before ?? null, after: null });
+            continue;
+        }
+        if (r.action === 'create' || r.action === 'update') {
+            const spec = r.spec ?? {};
+            resources[key] = { kind: r.kind, identity: r.identity, id: r.id, spec, spec_hash: specHash(spec), applied_at: at };
+            actions.push({
+                kind: r.kind, identity: r.identity, action: r.action, id: r.id,
+                before: r.action === 'update' ? (r.before ?? null) : null, after: spec,
+            });
+        }
+    }
+    const run = { run_id: newRunId(now), at, cli_version: opts.cliVersion, kind: opts.kind ?? 'apply', actions };
+    if (opts.reverts)
+        run.reverts = opts.reverts;
+    const runs = [...lock.runs, run].slice(-exports.MAX_RUNS);
+    return { lock: { ...lock, applied_at: at, cli_version: opts.cliVersion, resources, runs }, run };
+}
+function classifyDrift(desired, lock, liveByKind) {
+    const out = [];
+    const declared = new Set();
+    for (const d of desired) {
+        const key = lockKey(d.kind, d.identity);
+        declared.add(key);
+        const live = liveByKind.get(d.kind);
+        const item = live?.items.find((i) => String(i[live.recon.identity]) === d.identity);
+        const locked = lock?.resources[key];
+        if (!item) {
+            out.push({ kind: d.kind, identity: d.identity, state: 'missing' });
+            continue;
+        }
+        if (!locked) {
+            out.push({ kind: d.kind, identity: d.identity, state: 'never_applied' });
+            continue;
+        }
+        const fields = Array.from(new Set([...Object.keys(locked.spec), ...Object.keys(d.spec)]));
+        const live_diff = [];
+        const manifest_diff = [];
+        for (const f of fields) {
+            const lockV = locked.spec[f];
+            if (!(0, engine_1.valuesEqual)(lockV ?? null, item[f] ?? null))
+                live_diff.push({ field: f, lock: lockV ?? null, live: item[f] ?? null });
+            if (!(0, engine_1.valuesEqual)(lockV ?? null, d.spec[f] ?? null))
+                manifest_diff.push({ field: f, lock: lockV ?? null, manifest: d.spec[f] ?? null });
+        }
+        const state = live_diff.length && manifest_diff.length ? 'conflict'
+            : live_diff.length ? 'live_changed'
+                : manifest_diff.length ? 'manifest_changed'
+                    : 'in_sync';
+        const e = { kind: d.kind, identity: d.identity, state };
+        if (live_diff.length)
+            e.live_diff = live_diff;
+        if (manifest_diff.length)
+            e.manifest_diff = manifest_diff;
+        out.push(e);
+    }
+    if (lock) {
+        for (const key of Object.keys(lock.resources)) {
+            if (!declared.has(key)) {
+                const r = lock.resources[key];
+                out.push({ kind: r.kind, identity: r.identity, state: 'removed_from_manifest' });
+            }
+        }
+    }
+    return out;
+}
+/** States that mean production moved behind git's back. */
+function isProductionDrift(e) {
+    return e.state === 'live_changed' || e.state === 'conflict';
+}
+// ── Rollback ─────────────────────────────────────────────────────────────────
+/**
+ * Invert one run into a plan, most recent action first:
+ *   update → update back to `before`
+ *   create → prune the id it created
+ *   prune  → create from `before` (server-only fields stripped)
+ * Pure; the caller executes it with the ordinary engine.
+ */
+function buildRollbackPlan(run, reconFor) {
+    const actions = [];
+    const skipped = [];
+    for (const a of [...run.actions].reverse()) {
+        const recon = reconFor(a.kind);
+        if (!recon) {
+            skipped.push({ kind: a.kind, identity: a.identity, reason: 'unknown kind' });
+            continue;
+        }
+        if (a.action === 'update') {
+            if (!a.before) {
+                skipped.push({ kind: a.kind, identity: a.identity, reason: 'no pre-image recorded' });
+                continue;
+            }
+            if (recon.updateMethod === null) {
+                skipped.push({ kind: a.kind, identity: a.identity, reason: `${a.kind} is immutable` });
+                continue;
+            }
+            actions.push({ kind: a.kind, identity: a.identity, action: 'update', id: a.id, spec: a.before, changed: Object.keys(a.before), before: a.after ?? undefined });
+        }
+        else if (a.action === 'create') {
+            if (recon.prunable === false || recon.singleton) {
+                skipped.push({ kind: a.kind, identity: a.identity, reason: `${a.kind} is never deleted by apply` });
+                continue;
+            }
+            if (a.id === undefined || a.id === null) {
+                skipped.push({ kind: a.kind, identity: a.identity, reason: 'created id was not recorded' });
+                continue;
+            }
+            actions.push({ kind: a.kind, identity: a.identity, action: 'prune', id: a.id, before: a.after ?? undefined });
+        }
+        else if (a.action === 'prune') {
+            if (!a.before) {
+                skipped.push({ kind: a.kind, identity: a.identity, reason: 'no pre-image recorded' });
+                continue;
+            }
+            if (recon.create === null) {
+                skipped.push({ kind: a.kind, identity: a.identity, reason: `${a.kind} cannot be created by apply` });
+                continue;
+            }
+            actions.push({ kind: a.kind, identity: a.identity, action: 'create', spec: shapeForExport(recon, a.before) });
+        }
+    }
+    return { actions, skipped };
+}
+// ── Export ───────────────────────────────────────────────────────────────────
+/** The manifest-worthy view of one live item: allow-listed fields, or everything minus read-only. */
+function shapeForExport(recon, item) {
+    const fields = recon.exportFields ?? recon.managedFields;
+    const out = {};
+    if (!recon.singleton)
+        out[recon.identity] = item[recon.identity];
+    if (fields) {
+        for (const f of fields)
+            if (item[f] !== undefined)
+                out[f] = item[f];
+        return out;
+    }
+    for (const [k, v] of Object.entries(item)) {
+        if (registry_1.READ_ONLY_FIELDS.has(k) || k.endsWith('_at'))
+            continue;
+        out[k] = v;
+    }
+    return out;
+}
+function toManifestYaml(docs, yamlDump) {
+    return docs.map((d) => yamlDump({ kind: d.kind, ...d.spec }).trimEnd()).join('\n---\n') + '\n';
+}
+//# sourceMappingURL=lock.js.map

package/dist/lib/apply/lock.js.map

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

package/dist/lib/apply/registry.d.ts

@@ -5,10 +5,27 @@
  *
  * Endpoints below are taken verbatim from the matching CLI command files
  * (commands/products.ts, crm.ts, webhooks.ts, pages.ts, site.ts, domains.ts,
- * forms.ts / lib/api-client.ts) so they track the real API.
+ * forms.ts, agent.ts, voice.ts / lib/api-client.ts) so they track the real API.
  * A kind with `updateMethod: null` is immutable (create/delete only) — on
  * drift the engine reports it rather than silently mutating.
+ *
+ * Two kinds are CONFIGURE-ONLY (`create: null`, `prunable: false`):
+ *   - `agent`      — agents are provisioned from the registry, never by a
+ *                    manifest, and never deleted (pause with is_enabled: false).
+ *   - `voice_line` — a phone number is bought and released by explicit
+ *                    commands that cost money and cut service; apply only
+ *                    reconciles how an existing line behaves.
+ * Both declare `managedFields`: the manifest may only carry fields the list
+ * endpoint reads back, so "unchanged" is a real comparison and never a
+ * write-only field that plans as drift forever.
  */
+export interface UpdateRoute {
+    /** Spec fields this endpoint owns. */
+    fields: string[];
+    method: 'patch' | 'put';
+    /** Path template; `{id}` is substituted. */
+    path: string;
+}
 export interface Reconciler {
     /** Manifest `kind` this entry handles. */
     kind: string;
@@ -16,17 +33,57 @@ export interface Reconciler {
     identity: string;
     /** GET collection (list current state). */
     list: string;
-    /** POST collection (create). */
-    create: string;
-    /** Path template for one item; `{id}` is substituted. Used for update/delete. */
-    itemPath: string;
+    /** POST collection (create), or null when apply must never create this kind. */
+    create: string | null;
+    /** Shown on the plan when a declared resource is missing and `create` is null. */
+    createReason?: string;
+    /**
+     * Path template for one item; `{id}` is substituted. Used for update/delete.
+     * ⛔ null when the kind has no in-place update route at all — a kind with
+     * `updateMethod: null` has nothing to address, and the type said `string`
+     * while updateMethod already said `| null`, so the two disagreed.
+     */
+    itemPath: string | null;
     /** HTTP verb for an in-place update, or null when the resource is immutable. */
     updateMethod: 'patch' | 'put' | null;
+    /**
+     * Shown on the plan instead of the generic "delete and recreate" when
+     * updateMethod is null. ⛔ Required for anything where deleting IS the
+     * dangerous act: telling someone to delete and recreate a live payment
+     * processor connection to change a field is advice that takes payments down.
+     */
+    updateReason?: string;
+    /**
+     * When set, an update is split across these routes by field — only routes
+     * owning at least one CHANGED field are called. For kinds whose settings
+     * live behind several endpoints (an agent's autonomy, pause state, model).
+     */
+    updateRoutes?: UpdateRoute[];
     /** Field on a fetched server item that holds its id (default `id`). */
     idField: string;
     /** Key in the list response holding the array, when not auto-detectable. */
     listKey?: string;
+    /** false = `--prune` never deletes this kind (default true). */
+    prunable?: boolean;
+    /** The only spec fields accepted for this kind (identity is always allowed). */
+    managedFields?: string[];
+    /** Read-side field → write-side body, for fields the API names differently on write. */
+    writeMap?: Record<string, (value: unknown) => Record<string, unknown>>;
+    /**
+     * One-per-company resource (brand). `list` returns the single object (under
+     * `listKey`) or null; identity is the constant `kind` name; `itemPath` has no
+     * `{id}`; `--prune` never applies.
+     */
+    singleton?: boolean;
+    /**
+     * Fields `solid apply export` writes for this kind. Defaults to
+     * `managedFields`, else every server field minus the read-only set
+     * (id, company_id, timestamps, stats).
+     */
+    exportFields?: string[];
 }
+/** Server-side fields that never belong in a manifest. */
+export declare const READ_ONLY_FIELDS: Set<string>;
 export declare const RECONCILERS: Record<string, Reconciler>;
 export declare function reconcilerFor(kind: string): Reconciler | undefined;
 export declare function knownKinds(): string[];

package/dist/lib/apply/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/lib/apply/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,YAAY,EAAE,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC;IACrC,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAgFlD,CAAC;AAEF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAElE;AAED,wBAAgB,UAAU,IAAI,MAAM,EAAE,CAErC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/lib/apply/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,OAAO,GAAG,KAAK,CAAC;IACxB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gFAAgF;IAChF,YAAY,EAAE,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC;IACrC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvE;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,aAG3B,CAAC;AAEH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAiOlD,CAAC;AAEF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAElE;AAED,wBAAgB,UAAU,IAAI,MAAM,EAAE,CAErC"}

package/dist/lib/apply/registry.js

@@ -1,8 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RECONCILERS = void 0;
+exports.RECONCILERS = exports.READ_ONLY_FIELDS = void 0;
 exports.reconcilerFor = reconcilerFor;
 exports.knownKinds = knownKinds;
+/** Server-side fields that never belong in a manifest. */
+exports.READ_ONLY_FIELDS = new Set([
+    'id', 'company_id', 'tenant_company_id', 'created_at', 'updated_at', 'deleted_at',
+    'last_active_at', 'stats', 'slug_history', 'version', 'current_version',
+]);
 exports.RECONCILERS = {
     product: {
         kind: 'product',
@@ -83,6 +88,151 @@ exports.RECONCILERS = {
         idField: 'id',
         listKey: 'surveys',
     },
+    kb: {
+        kind: 'kb',
+        identity: 'title',
+        list: '/api/v1/kb/company?limit=500',
+        create: '/api/v1/kb/company',
+        itemPath: '/api/v1/kb/company/{id}',
+        updateMethod: 'put',
+        idField: 'id',
+        listKey: 'results',
+        exportFields: ['title', 'category', 'subcategory', 'content', 'tags', 'keywords', 'priority'],
+    },
+    service: {
+        kind: 'service',
+        identity: 'title',
+        list: '/api/v1/services/catalog?limit=200',
+        create: '/api/v1/services/catalog',
+        itemPath: '/api/v1/services/catalog/{id}',
+        updateMethod: 'put',
+        idField: 'id',
+        listKey: 'items',
+        exportFields: [
+            'title', 'description', 'category', 'subcategory', 'price', 'currency', 'taxable',
+            'default_duration_min', 'buffer_before_min', 'buffer_after_min', 'capacity_per_slot',
+            'requires_on_site', 'service_area_miles', 'visible_online', 'active', 'tags_csv',
+        ],
+    },
+    brand: {
+        kind: 'brand',
+        identity: 'brand',
+        list: '/api/v1/cli/brand',
+        create: '/api/v1/cli/brand',
+        itemPath: '/api/v1/cli/brand',
+        updateMethod: 'put',
+        idField: 'id',
+        listKey: 'brand',
+        singleton: true,
+        prunable: false,
+        managedFields: ['name', 'design', 'voice', 'rules'],
+    },
+    agent: {
+        kind: 'agent',
+        identity: 'agent_type',
+        // include_disabled — a paused agent is still declared state, not a missing one.
+        list: '/api/v1/agents?include_disabled=true',
+        create: null,
+        createReason: 'agents are provisioned from the registry, not a manifest — run `solid agent sync`',
+        itemPath: '/api/v1/agents/{id}',
+        updateMethod: 'put',
+        updateRoutes: [
+            { fields: ['autonomy_level'], method: 'patch', path: '/api/v1/agents/{id}/autonomy' },
+            { fields: ['is_enabled'], method: 'patch', path: '/api/v1/agents/{id}/toggle' },
+            { fields: ['llm_model_override', 'llm_provider_id', 'voice_enabled'], method: 'put', path: '/api/v1/agents/{id}' },
+        ],
+        idField: 'id',
+        listKey: 'agents',
+        prunable: false,
+        managedFields: ['autonomy_level', 'is_enabled', 'llm_model_override', 'llm_provider_id', 'voice_enabled'],
+    },
+    // ⛔ THE THREE KINDS `solid apply` COULD NOT REACH. A manifest that declares
+    // agents, a site and phone numbers but cannot declare what the business is
+    // ALLOWED to do, which flows run, or which processor takes the money is not
+    // "the complete tenant" — it is the parts that happened to have reconcilers.
+    //
+    // Each is backed by real routes, verified before it was added here. Where a
+    // route genuinely does not exist (nothing updates a connected processor in
+    // place) the reconciler says so in createReason rather than pretending.
+    capability: {
+        kind: 'capability',
+        identity: 'name',
+        // include_inactive — a switched-off capability is declared state, not absence.
+        list: '/api/v1/capabilities?include_inactive=true',
+        create: '/api/v1/capabilities',
+        itemPath: '/api/v1/capabilities/{id}',
+        updateMethod: 'put',
+        idField: 'id',
+        listKey: 'capabilities',
+        prunable: false,
+        managedFields: ['name', 'category', 'capability_type', 'description', 'is_active'],
+    },
+    flow: {
+        kind: 'flow',
+        identity: 'name',
+        list: '/api/v1/cli/flows',
+        create: '/api/v1/cli/flows',
+        itemPath: '/api/v1/cli/flows/{id}',
+        updateMethod: 'patch',
+        // ⛔ Status is not a PATCH field. Activating a flow starts it running, so it
+        // has its own routes and its own consequence — the same reason `apply` will
+        // not provision a phone number.
+        updateRoutes: [
+            { fields: ['name', 'commerce_type', 'config', 'product_name'], method: 'patch', path: '/api/v1/cli/flows/{id}' },
+        ],
+        idField: 'id',
+        listKey: 'flows',
+        prunable: false,
+        managedFields: ['name', 'commerce_type', 'config', 'product_name'],
+    },
+    processor: {
+        kind: 'processor',
+        identity: 'processor',
+        list: '/api/v1/processors/connected',
+        create: '/api/v1/processors/connect',
+        // ⛔ There is no route that edits a connected processor in place, and there
+        // should not be one that `apply` drives: rotating live payment credentials
+        // from a manifest is not a reconcile, it is an outage waiting for a typo.
+        // Drift is REPORTED and left alone.
+        itemPath: null,
+        updateMethod: null,
+        updateReason: 'a connected processor is never edited by apply — reconnect it with `solid processor connect`',
+        idField: 'id',
+        listKey: 'processors',
+        prunable: false,
+        // Only the identity is managed, so a changed key shows as drift and nothing
+        // silently rewrites it.
+        managedFields: ['processor', 'environment', 'is_default'],
+    },
+    voice_line: {
+        kind: 'voice_line',
+        identity: 'phone_number',
+        list: '/api/v1/voice/phone-numbers',
+        create: null,
+        createReason: 'apply never provisions a number (that buys one) — use `solid voice numbers add`',
+        itemPath: '/api/v1/voice/phone-numbers/{id}',
+        updateMethod: 'patch',
+        updateRoutes: [
+            { fields: ['routing_mode'], method: 'patch', path: '/api/v1/phone/settings/{id}' },
+            {
+                fields: [
+                    'agent_id', 'greeting_message', 'voice_config', 'business_hours',
+                    'voicemail_enabled', 'translate_mode', 'target_lang', 'is_active',
+                ],
+                method: 'patch',
+                path: '/api/v1/voice/phone-numbers/{id}',
+            },
+        ],
+        idField: 'id',
+        listKey: 'phone_numbers',
+        prunable: false,
+        managedFields: [
+            'routing_mode', 'agent_id', 'greeting_message', 'voice_config', 'business_hours',
+            'voicemail_enabled', 'translate_mode', 'target_lang', 'is_active',
+        ],
+        // The list reads `is_active`; the PATCH writes `status`.
+        writeMap: { is_active: (v) => ({ status: v ? 'active' : 'inactive' }) },
+    },
 };
 function reconcilerFor(kind) {
     return exports.RECONCILERS[kind] || exports.RECONCILERS[kind.toLowerCase()];

package/dist/lib/apply/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/lib/apply/registry.ts"],"names":[],"mappings":";;;AAgHA,sCAEC;AAED,gCAEC;AAxFY,QAAA,WAAW,GAA+B;IACrD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,mBAAmB;QACzB,MAAM,EAAE,mBAAmB;QAC3B,QAAQ,EAAE,uBAAuB;QACjC,YAAY,EAAE,OAAO;QACrB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,UAAU;KACpB;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,sBAAsB;QAC5B,MAAM,EAAE,sBAAsB;QAC9B,QAAQ,EAAE,2BAA2B;QACrC,YAAY,EAAE,OAAO;QACrB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,UAAU;KACpB;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,mBAAmB;QACzB,MAAM,EAAE,mBAAmB;QAC3B,QAAQ,EAAE,wBAAwB;QAClC,YAAY,EAAE,OAAO;QACrB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,OAAO;KACjB;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,4BAA4B;QAClC,MAAM,EAAE,4BAA4B;QACpC,QAAQ,EAAE,iCAAiC;QAC3C,YAAY,EAAE,IAAI,EAAE,8CAA8C;QAClE,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,UAAU;KACpB;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,mBAAmB;QACzB,MAAM,EAAE,mBAAmB;QAC3B,QAAQ,EAAE,wBAAwB;QAClC,YAAY,EAAE,OAAO;QACrB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,OAAO;KACjB;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,eAAe;QACvB,QAAQ,EAAE,oBAAoB;QAC9B,YAAY,EAAE,IAAI,EAAE,wDAAwD;QAC5E,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,OAAO;KACjB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,wBAAwB,EAAE,uBAAuB;QACvD,MAAM,EAAE,wBAAwB;QAChC,QAAQ,EAAE,6BAA6B;QACvC,YAAY,EAAE,IAAI,EAAE,oDAAoD;QACxE,OAAO,EAAE,IAAI;KACd;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,wBAAwB;QAChC,QAAQ,EAAE,sBAAsB;QAChC,YAAY,EAAE,KAAK;QACnB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,SAAS;KACnB;CACF,CAAC;AAEF,SAAgB,aAAa,CAAC,IAAY;IACxC,OAAO,mBAAW,CAAC,IAAI,CAAC,IAAI,mBAAW,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,SAAgB,UAAU;IACxB,OAAO,MAAM,CAAC,IAAI,CAAC,mBAAW,CAAC,CAAC,IAAI,EAAE,CAAC;AACzC,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/lib/apply/registry.ts"],"names":[],"mappings":"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"}

package/dist/lib/json-arg.d.ts

@@ -0,0 +1,2 @@
+export declare function parseJsonArg(name: string, raw: string | undefined): any;
+//# sourceMappingURL=json-arg.d.ts.map

package/dist/lib/json-arg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-arg.d.ts","sourceRoot":"","sources":["../../src/lib/json-arg.ts"],"names":[],"mappings":"AAYA,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,GAAG,CAiBvE"}