@krtclcdy/tersio 2.25.6 → 2.25.7

package/dist/bench/code-out/pultra-2/deepClone.js

@@ -0,0 +1,18 @@
+// deepClone: recursive clone of plain objects, arrays, Date, and primitives. Shares no mutable structure with the input; no structuredClone or JSON round-trip.
+export function deepClone(value) {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    if (value instanceof Date) {
+        return new Date(value.getTime());
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => deepClone(item));
+    }
+    const source = value;
+    const clone = {};
+    for (const key of Object.keys(source)) {
+        clone[key] = deepClone(source[key]);
+    }
+    return clone;
+}

package/dist/bench/code-out/pultra-2/groupBy.js

@@ -0,0 +1,15 @@
+// groupBy: buckets items by keyFn. Keys land in first-seen order and each bucket keeps the input order.
+export function groupBy(items, keyFn) {
+    const groups = {};
+    for (const item of items) {
+        const key = keyFn(item);
+        const bucket = groups[key];
+        if (bucket === undefined) {
+            groups[key] = [item];
+        }
+        else {
+            bucket.push(item);
+        }
+    }
+    return groups;
+}

package/dist/bench/code-out/pultra-3/debounce.js

@@ -0,0 +1,13 @@
+// Debounce: fires fn ms after the last call with that call's arguments; a call during the wait restarts it.
+export function debounce(fn, ms) {
+    let timer;
+    return (...args) => {
+        if (timer !== undefined) {
+            clearTimeout(timer);
+        }
+        timer = setTimeout(() => {
+            timer = undefined;
+            fn(...args);
+        }, ms);
+    };
+}

package/dist/bench/code-out/pultra-3/deepClone.js

@@ -0,0 +1,18 @@
+// deepClone: recursive clone of plain objects, arrays, Date, and primitives; shares no mutable structure and never round-trips through structuredClone or JSON.
+export function deepClone(value) {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    if (value instanceof Date) {
+        return new Date(value.getTime());
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => deepClone(item));
+    }
+    const source = value;
+    const clone = {};
+    for (const key of Object.keys(source)) {
+        clone[key] = deepClone(source[key]);
+    }
+    return clone;
+}

package/dist/bench/code-out/pultra-3/groupBy.js

@@ -0,0 +1,15 @@
+// groupBy: buckets items by keyFn; keys land in first-seen order and each bucket preserves input order.
+export function groupBy(items, keyFn) {
+    const groups = {};
+    for (const item of items) {
+        const key = keyFn(item);
+        const bucket = groups[key];
+        if (bucket === undefined) {
+            groups[key] = [item];
+        }
+        else {
+            bucket.push(item);
+        }
+    }
+    return groups;
+}

package/dist/bench/code-out/pultra-4/debounce.js

@@ -0,0 +1,13 @@
+// Debounce: fires fn once, ms after the last call, using that last call's arguments. A call during the wait restarts it.
+export function debounce(fn, ms) {
+    let timer;
+    return (...args) => {
+        if (timer !== undefined) {
+            clearTimeout(timer);
+        }
+        timer = setTimeout(() => {
+            timer = undefined;
+            fn(...args);
+        }, ms);
+    };
+}

package/dist/bench/code-out/pultra-4/deepClone.js

@@ -0,0 +1,18 @@
+// deepClone: recursive clone of plain objects, arrays, Date, and primitives. Shares no mutable structure with the input; no structuredClone or JSON round-trip.
+export function deepClone(value) {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    if (value instanceof Date) {
+        return new Date(value.getTime());
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => deepClone(item));
+    }
+    const source = value;
+    const clone = {};
+    for (const key of Object.keys(source)) {
+        clone[key] = deepClone(source[key]);
+    }
+    return clone;
+}

package/dist/bench/code-out/pultra-4/groupBy.js

@@ -0,0 +1,15 @@
+// groupBy: buckets items by keyFn. Keys land in first-seen order and each bucket keeps the input order.
+export function groupBy(items, keyFn) {
+    const groups = {};
+    for (const item of items) {
+        const key = keyFn(item);
+        const bucket = groups[key];
+        if (bucket === undefined) {
+            groups[key] = [item];
+        }
+        else {
+            bucket.push(item);
+        }
+    }
+    return groups;
+}

package/dist/bench/code-out/run-0/debounce.js

@@ -0,0 +1,12 @@
+export function debounce(fn, ms) {
+    let timer;
+    return (...args) => {
+        if (timer !== undefined) {
+            clearTimeout(timer);
+        }
+        timer = setTimeout(() => {
+            timer = undefined;
+            fn(...args);
+        }, ms);
+    };
+}

package/dist/bench/code-out/run-0/deepClone.js

@@ -0,0 +1,17 @@
+export function deepClone(value) {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    if (value instanceof Date) {
+        return new Date(value.getTime());
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => deepClone(item));
+    }
+    const source = value;
+    const clone = {};
+    for (const key of Object.keys(source)) {
+        clone[key] = deepClone(source[key]);
+    }
+    return clone;
+}

package/dist/bench/code-out/run-0/groupBy.js

@@ -0,0 +1,14 @@
+export function groupBy(items, keyFn) {
+    const groups = {};
+    for (const item of items) {
+        const key = keyFn(item);
+        const existing = groups[key];
+        if (existing === undefined) {
+            groups[key] = [item];
+        }
+        else {
+            existing.push(item);
+        }
+    }
+    return groups;
+}

package/dist/bench/code-out/run-1/debounce.js

@@ -0,0 +1,13 @@
+// Debounce: the returned wrapper fires fn once, after ms milliseconds of quiet, using the last call's arguments.
+export function debounce(fn, ms) {
+    let timer;
+    // Each call rebinds args, so the closure the timeout reads is always the latest one.
+    return (...args) => {
+        if (timer !== undefined)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            timer = undefined;
+            fn(...args);
+        }, ms);
+    };
+}

package/dist/bench/code-out/run-1/deepClone.js

@@ -0,0 +1,15 @@
+// deepClone: recursive clone for plain objects, arrays, Date, and primitives. No structuredClone or JSON round-trip.
+export function deepClone(value) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    if (value instanceof Date)
+        return new Date(value.getTime());
+    if (Array.isArray(value))
+        return value.map((item) => deepClone(item));
+    const source = value;
+    const clone = {};
+    for (const key of Object.keys(source)) {
+        clone[key] = deepClone(source[key]);
+    }
+    return clone;
+}

package/dist/bench/code-out/run-1/groupBy.js

@@ -0,0 +1,13 @@
+// groupBy: buckets items by keyFn. Keys land in first-seen order and each bucket keeps the input order.
+export function groupBy(items, keyFn) {
+    const groups = {};
+    for (const item of items) {
+        const key = keyFn(item);
+        const bucket = groups[key];
+        if (bucket === undefined)
+            groups[key] = [item];
+        else
+            bucket.push(item);
+    }
+    return groups;
+}

package/dist/bench/code-out/run-2/debounce.js

@@ -0,0 +1,12 @@
+// Trailing-edge debounce: `fn` runs only once `ms` passes with no further call, and always with the last call's arguments.
+export function debounce(fn, ms) {
+    let timer;
+    return (...args) => {
+        if (timer !== undefined)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            timer = undefined;
+            fn(...args);
+        }, ms);
+    };
+}

package/dist/bench/code-out/run-2/deepClone.js

@@ -0,0 +1,18 @@
+// Recursive structural copy: plain objects, arrays, Dates, and primitives. No shared mutable structure with the input.
+export function deepClone(value) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    // SAFETY: a Date owns no enumerable props, so it must be rebuilt from its epoch ms or it clones to `{}`.
+    if (value instanceof Date)
+        return new Date(value.getTime());
+    // SAFETY: Array.isArray above proves an array, so mapping deepClone over the elements preserves its shape.
+    if (Array.isArray(value)) {
+        const items = value;
+        return items.map((item) => deepClone(item));
+    }
+    // SAFETY: Object.entries copies every own enumerable key, so the plain-object form of T is reproduced.
+    const clone = {};
+    for (const [key, item] of Object.entries(value))
+        clone[key] = deepClone(item);
+    return clone;
+}

package/dist/bench/code-out/run-2/groupBy.js

@@ -0,0 +1,13 @@
+// Buckets items by `keyFn`, preserving input order inside each group.
+export function groupBy(items, keyFn) {
+    const groups = {};
+    for (const item of items) {
+        const key = keyFn(item);
+        const bucket = groups[key];
+        if (bucket === undefined)
+            groups[key] = [item];
+        else
+            bucket.push(item);
+    }
+    return groups;
+}

package/dist/bench/code-out/run-3/debounce.js

@@ -0,0 +1,12 @@
+export function debounce(fn, ms) {
+    let timer;
+    return (...args) => {
+        if (timer !== undefined) {
+            clearTimeout(timer);
+        }
+        timer = setTimeout(() => {
+            timer = undefined;
+            fn(...args);
+        }, ms);
+    };
+}

package/dist/bench/code-out/run-3/deepClone.js

@@ -0,0 +1,18 @@
+export function deepClone(value) {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    if (value instanceof Date) {
+        return new Date(value.getTime());
+    }
+    if (Array.isArray(value)) {
+        const source = value;
+        return source.map((item) => deepClone(item));
+    }
+    const source = value;
+    const clone = {};
+    for (const [key, item] of Object.entries(source)) {
+        clone[key] = deepClone(item);
+    }
+    return clone;
+}

package/dist/bench/code-out/run-3/groupBy.js

@@ -0,0 +1,14 @@
+export function groupBy(items, keyFn) {
+    const groups = {};
+    for (const item of items) {
+        const key = keyFn(item);
+        const existing = groups[key];
+        if (existing === undefined) {
+            groups[key] = [item];
+        }
+        else {
+            existing.push(item);
+        }
+    }
+    return groups;
+}

package/dist/bench/code-out/run-4/debounce.js

@@ -0,0 +1,12 @@
+export function debounce(fn, ms) {
+    let timer;
+    return (...args) => {
+        if (timer !== undefined) {
+            clearTimeout(timer);
+        }
+        timer = setTimeout(() => {
+            timer = undefined;
+            fn(...args);
+        }, ms);
+    };
+}

package/dist/bench/code-out/run-4/deepClone.js

@@ -0,0 +1,16 @@
+export function deepClone(value) {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    if (value instanceof Date) {
+        return new Date(value.getTime());
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => deepClone(item));
+    }
+    const clone = {};
+    for (const [key, item] of Object.entries(value)) {
+        clone[key] = deepClone(item);
+    }
+    return clone;
+}

package/dist/bench/code-out/run-4/groupBy.js

@@ -0,0 +1,13 @@
+export function groupBy(items, keyFn) {
+    const groups = {};
+    for (const item of items) {
+        const key = keyFn(item);
+        if (Object.hasOwn(groups, key)) {
+            groups[key].push(item);
+        }
+        else {
+            groups[key] = [item];
+        }
+    }
+    return groups;
+}

package/dist/cli/banner.js

@@ -81,8 +81,7 @@ function printWelcome() {
         'tersio update    refresh CLI + add-ons',
         'tersio doctor    verify the install',
     ];
-    // Below 26 rows the note scrolls off the top and slices the art, and the screen must also hold the
-    // update prompt and every option, so the tips take one line there.
+    // Below 26 rows the tips scroll off the top and slice the art, so they take one line there.
     if (process.stdout.rows < 26) {
         clackNote(`  ${tips.join(' · ')}`);
         return;

package/dist/cli/common.js

@@ -131,7 +131,7 @@ async function writeIfChanged(dest, content, options = {}) {
         return true;
     }
     await fs.mkdir(path.dirname(dest), { recursive: true });
-    if (existing !== null) {
+    if (existing !== null && options.backup === true) {
         await fs.copyFile(dest, `${dest}.bak`);
         debug(`${path.basename(dest)} → ${path.basename(dest)}.bak`);
     }

package/dist/cli/doctor.js

@@ -4,13 +4,14 @@ import { existsSync, readdirSync, readFileSync, statSync, promises as fs } from
 import path from 'node:path';
 import { HOME, OMP_AGENT_DIR, OMP_PLUGINS_DIR, PACKAGE_NAME, PACKAGE_VERSION, args, dryRun, fix, yes, BUN_BIN_DIR, OMP_BIN, execP, parseJsonObject, relTime, } from './common.js';
 import { detectHosts, hostExtensionsDir, ompPackageDir, piPonytailPackageDir } from './hosts.js';
+import { GENERATED_TREE_FILES } from './manifest.js';
 import { askInteractiveChoice, askInteractiveConfirm, runInteractivePhase } from './interactive.js';
 import { usageDbPath } from '../extensions/shared/usage-store.js';
 import { pricesCachePath } from '../extensions/shared/pricing.js';
 import { findHoistedPackage, fetchJson, piAgentDir, readTextIfExists, resolveHostBinary, resolveRtkBinary, ruleBodyProblem } from '../extensions/shared/utils.js';
 import { sqliteScript, statsDbPath } from '../extensions/shared/agent-stats.js';
 import { OMP_SUBAGENT_MARKER } from '../extensions/shared/session-state.js';
-import { PI_PONYTAIL_FILES, PONYTAIL_BUNDLE_FILES, TREE_FILES, isObsoleteTreeFile, treeFileText, treeFilesFor } from './manifest.js';
+import { PI_PONYTAIL_FILES, PONYTAIL_BUNDLE_FILES, TREE_FILES, TREE_PSTACK_FILES, isObsoleteTreeFile, treeFileText, treeFilesFor } from './manifest.js';
 import { serviceRunning, serviceState } from './doctor-fix.js';
 /** Bytes at the scale a transcript gap reads in: `5.6M`, not `5571992`. */
 function shortBytes(bytes) {
@@ -42,8 +43,7 @@ async function runDoctor(recheck = false) {
     const updaterIndex = path.join(tersioPluginDir, 'extensions', 'updater', 'index.ts');
     // Probes start concurrently and report in fixed order as data settles; each resolves instead of rejecting.
     const hosts = detectHosts();
-    // Every host keeps a copy, and the copy omp loads is the reference itself, so only the hosts that get
-    // their own copy are compared below. The package root, not the hook's directory, is what the paths hang off.
+    // Only hosts with their own copy are compared: omp's copy is the reference. Paths hang off the package root.
     const ponytailLoads = {
         pi: { dir: piPonytailPackageDir(piAgentDir()), files: PI_PONYTAIL_FILES },
         opencode: { dir: path.join(hostExtensionsDir('opencode'), 'ponytail-bundle'), files: PONYTAIL_BUNDLE_FILES },
@@ -70,9 +70,7 @@ async function runDoctor(recheck = false) {
     const treeOrphan = [];
     // The tree a host loads: omp reads the plugin package, every other host its own directory.
     const treeBaseFor = (host) => host.id === 'omp' ? path.join(tersioPluginDir, 'extensions') : hostExtensionsDir(host.id);
-    // A tree holding at least one file of this build is compared even when the host reads as not
-    // installed. pi auto-discovers every index.ts it finds, so a half-written tree needs reporting,
-    // and `detectHosts` reads one as absent: it wants every file or a declared package.
+    // A tree holding any file of this build is compared even when the host reads as not installed: pi auto-discovers every index.ts it finds, so a half-written tree needs reporting.
     const treeHoldsOwnFiles = (host) => treeFilesFor(host.id === 'omp' ? 'opencode' : host.id).some((rel) => existsSync(path.join(treeBaseFor(host), ...rel.split('/'))));
     for (const host of hosts.filter((h) => h.installed || treeHoldsOwnFiles(h))) {
         const treeId = host.id === 'omp' ? 'opencode' : host.id;
@@ -103,6 +101,22 @@ async function runDoctor(recheck = false) {
             }
         }
     }
+    // A host reading as installed whose tree is short of this build's declared files: the pair loop above cannot see a file that is absent on both sides.
+    const unwrittenTreeFiles = async () => {
+        const out = [];
+        for (const host of hosts.filter((h) => h.installed)) {
+            const treeId = host.id === 'omp' ? 'opencode' : host.id;
+            const base = treeBaseFor(host);
+            for (const rel of treeFilesFor(treeId)) {
+                if (existsSync(path.join(base, ...rel.split('/'))))
+                    continue;
+                if (host.id === 'omp' && GENERATED_TREE_FILES[rel] !== undefined)
+                    continue;
+                out.push(`${host.id}/${rel}`);
+            }
+        }
+        return out;
+    };
     const probes = {
         ompPkgText: readTextIfExists(path.join(ompPackageDir(), 'package.json')),
         configText: readTextIfExists(path.join(OMP_AGENT_DIR, 'config.yml')),
@@ -110,9 +124,13 @@ async function runDoctor(recheck = false) {
         rtkBinText: rtkBin ? readTextIfExists(rtkBin) : Promise.resolve(null),
         cavemanIndexText: readTextIfExists(cavemanIndex),
         cavemanRuleText: readTextIfExists(cavemanRule('rule.md')),
+        cavemanLiteText: readTextIfExists(cavemanRule('rule-lite.md')),
+        cavemanMegacaveLiteText: readTextIfExists(cavemanRule('rule-megacave-lite.md')),
+        cavemanMegacaveUltraText: readTextIfExists(cavemanRule('rule-megacave-ultra.md')),
         cavemanUltraText: readTextIfExists(cavemanRule('rule-ultra.md')),
         cavemanMegacaveText: readTextIfExists(cavemanRule('rule-megacave.md')),
         pstackRuleText: readTextIfExists(pstackRule),
+        pstackTreeFiles: Promise.all(TREE_PSTACK_FILES.map((rel) => readTextIfExists(path.join(tersioPluginDir, "extensions", ...rel.split("/"))))),
         rtkIndexText: readTextIfExists(rtkIndex),
         updaterIndexText: readTextIfExists(updaterIndex),
         rtkMtime: rtkBin ? fs.stat(rtkBin).catch(() => null) : Promise.resolve(null),
@@ -128,7 +146,7 @@ async function runDoctor(recheck = false) {
     const opencodeServiceProbe = opencodeBin
         ? Promise.resolve(serviceState())
         : Promise.resolve(null);
-    const [[ompPkgText, configText], [cavemanIndexText, rtkIndexText, updaterIndexText, ponytailPkgText], [cavemanRuleText, cavemanUltraText, cavemanMegacaveText, pstackRuleText, ruleMtime, rtkBinText, rtkMtime, rtkVersion, ponytailMtime, pricesMtime], [opencodeService]] = await runInteractivePhase('Checking installation', () => Promise.all([
+    const [[ompPkgText, configText], [cavemanIndexText, rtkIndexText, updaterIndexText, ponytailPkgText], [cavemanRuleText, cavemanLiteText, cavemanMegacaveLiteText, cavemanMegacaveUltraText, cavemanUltraText, cavemanMegacaveText, pstackRuleText, pstackTreeFiles, ruleMtime, rtkBinText, rtkMtime, rtkVersion, ponytailMtime, pricesMtime], [opencodeService]] = await runInteractivePhase('Checking installation', () => Promise.all([
         Promise.all([
             probes.ompPkgText,
             probes.configText,
@@ -141,9 +159,13 @@ async function runDoctor(recheck = false) {
         ]),
         Promise.all([
             probes.cavemanRuleText,
+            probes.cavemanLiteText,
+            probes.cavemanMegacaveLiteText,
+            probes.cavemanMegacaveUltraText,
             probes.cavemanUltraText,
             probes.cavemanMegacaveText,
             probes.pstackRuleText,
+            probes.pstackTreeFiles,
             probes.ruleMtime,
             probes.rtkBinText,
             probes.rtkMtime,
@@ -201,8 +223,7 @@ async function runDoctor(recheck = false) {
         const kind = host.via === 'tree' ? 'extensions' : 'package';
         check(host.label, true, `${kind} ${PACKAGE_NAME}${host.version ? ` ${host.version}` : ''}`);
     }
-    // A healthy service adds no row: the host row already names the install with its version, and
-    // this row earns its place only when the manager's report and the live process disagree.
+    // A healthy service adds no row: the host row already names the install, and this row only shows when the manager's report and the live process disagree.
     if (opencodeService) {
         const running = serviceRunning(opencodeService.status);
         if (!running && opencodeService.live) {
@@ -236,7 +257,7 @@ async function runDoctor(recheck = false) {
         warnLine('omp stats index', indexLag);
     section('Add-ons');
     const ruleAge = ruleMtime ? `(updated ${relTime(Date.now() - ruleMtime.mtimeMs)} · ${absDate(ruleMtime.mtimeMs)})` : '';
-    const cavemanRules = [['rule.md', cavemanRuleText], ['rule-ultra.md', cavemanUltraText], ['rule-megacave.md', cavemanMegacaveText]];
+    const cavemanRules = [['rule.md', cavemanRuleText], ['rule-lite.md', cavemanLiteText], ['rule-megacave-lite.md', cavemanMegacaveLiteText], ['rule-megacave-ultra.md', cavemanMegacaveUltraText], ['rule-ultra.md', cavemanUltraText], ['rule-megacave.md', cavemanMegacaveText]];
     const missingRules = cavemanRules.filter(([, text]) => text === null).map(([name]) => name);
     check('Caveman rule', missingRules.length === 0, missingRules.length ? `missing: ${missingRules.join(', ')}` : ruleAge);
     for (const [name, text] of cavemanRules) {
@@ -253,6 +274,16 @@ async function runDoctor(recheck = false) {
         if (problem)
             warnLine('pstack rule.md', `unusable body (${problem}) — run: tersio install`);
     }
+    // The index routes to files, so a tree with the rule but no leaves serves a mode that cannot apply.
+    const pstackOnDisk = {};
+    TREE_PSTACK_FILES.forEach((rel, i) => {
+        if (pstackTreeFiles[i] !== null)
+            pstackOnDisk[rel] = true;
+    });
+    const pstackMissing = TREE_PSTACK_FILES.filter((rel) => !pstackOnDisk[rel]).map((rel) => rel.replace(/^pstack\//, ''));
+    if (pstackMissing.length > 0) {
+        warnLine('pstack tree', `missing ${pstackMissing.length} file${pstackMissing.length === 1 ? '' : 's'}: ${pstackMissing.slice(0, 6).join(', ')}${pstackMissing.length > 6 ? ` +${pstackMissing.length - 6} more` : ''} — run: tersio install`);
+    }
     // A verbatim sentence read out of omp's own prompt, so a re-worded release stops Caveman reaching subagents.
     const subagentGap = subagentMarkerStatus(ompBinary());
     if (subagentGap)
@@ -270,6 +301,11 @@ async function runDoctor(recheck = false) {
         warnLine('Per-host add-on files', `orphaned in ${treeOrphan.length} file${treeOrphan.length === 1 ? '' : 's'}: ${treeOrphan.join(', ')}` +
             ` — run: tersio doctor --fix extensions`);
     }
+    // A count of pairs compared cannot show a file that is absent from disk and absent from the declaration, so assert every declared file landed.
+    const unwritten = await unwrittenTreeFiles();
+    if (unwritten.length > 0) {
+        check('Add-on tree content', false, `${unwritten.length} declared file${unwritten.length === 1 ? '' : 's'} not written for a host reading as installed: ${unwritten.slice(0, 6).join(', ')}${unwritten.length > 6 ? ` +${unwritten.length - 6} more` : ''} — run: tersio doctor --fix extensions`);
+    }
     const rtkAge = rtkMtime ? `(updated ${relTime(Date.now() - rtkMtime.mtimeMs)} · ${absDate(rtkMtime.mtimeMs)})` : '';
     check('RTK binary', rtkBin !== null, rtkBinText === null ? 'not found in PATH' : [rtkVersion, rtkAge].filter(Boolean).join(' '));
     // rtk_run needs a host exec API, which doctor cannot assume.
@@ -336,8 +372,8 @@ function ompBinary() {
     const managed = path.join(BUN_BIN_DIR, OMP_BIN);
     return existsSync(managed) ? managed : null;
 }
-// The rule bodies a per-host tree carries. rule.md is the bundled fork; the others track upstream.
-const CAVEMAN_BODIES = ['rule.md', 'rule-ultra.md', 'rule-megacave.md'];
+// The rule bodies a per-host tree carries. rule.md and rule-lite.md are bundled forks; the others track upstream.
+const CAVEMAN_BODIES = ['rule.md', 'rule-lite.md', 'rule-megacave-lite.md', 'rule-megacave-ultra.md', 'rule-ultra.md', 'rule-megacave.md'];
 /** `"installed < latest"` when npm answers, else null: silence means "no row", not "stale". */
 async function ponytailLatestGap(installedPkgText) {
     const local = parseJsonObject(installedPkgText)?.version;

package/dist/cli/hosts.js

@@ -86,8 +86,7 @@ function detect(agentDir = piAgentDir()) {
     return HOSTS.map((host) => {
         const pkgDir = host.id === 'omp' ? ompPackageDir() : host.id === 'pi' ? piPackageDir(agentDir) : null;
         const tree = hostExtensionsDir(host.id, agentDir);
-        // A tree wins: it is what the installer writes, and it carries no package.json, so its version is ours.
-        // OpenCode keeps no package to fall back to, so a present tree is the install; its drifted files get the per-host warning instead.
+        // A tree wins: the installer writes it and it carries no package.json, so its version is ours. OpenCode keeps no package to fall back to, so a present tree is the install and drift gets the per-host warning.
         const via = missingTreeFiles(host.id, agentDir).length === 0 || (host.id === 'opencode' && existsSync(tree))
             ? 'tree'
             : pkgDir && existsSync(pkgDir) ? 'package' : null;

package/dist/cli/install.js

@@ -411,9 +411,12 @@ async function stepRtkFilter(extDir, options) {
         console.log('  RTK filter — install built-in tool output filtering');
     await copySources(extDir, filesUnder('rtk'), 'rtk/filter.ts', options);
 }
-// rule.md is a deliberate fork of skills/caveman/SKILL.md: a blind sync would drop the mode switch line.
+// rule.md and rule-lite.md are our forks and always ship bundled; the other two track upstream and keep a usable body when the fetch fails.
 const CAVEMAN_RULES = [
     ['rule.md', null],
+    ['rule-lite.md', null],
+    ['rule-megacave-lite.md', null],
+    ['rule-megacave-ultra.md', null],
     ['rule-ultra.md', CAVEMAN_REMOTE_ULTRA],
     ['rule-megacave.md', CAVEMAN_REMOTE_MEGACAVE],
 ];
@@ -545,7 +548,8 @@ async function stepOpencode(options) {
         await fs.mkdir(path.dirname(configPath), { recursive: true });
         await fs.rm(path.join(HOME, '.config', 'opencode', 'plugins', 'rtk.ts'), { force: true }).catch(() => { });
     }
-    await writeIfChanged(configPath, `${JSON.stringify(config, null, 2)}\n`, options);
+    // The user's own config, so keep the previous copy beside it.
+    await writeIfChanged(configPath, `${JSON.stringify(config, null, 2)}\n`, { ...options, backup: true });
 }
 async function resolveProfile(opts = {}) {
     // Seed from the stored defaults so flag-less runs keep them.
@@ -1007,6 +1011,7 @@ async function runInstall(forcedHost) {
     await capture('shared', () => stepSharedSessionState(extDir, installOptions));
     await capture('rtk session', () => stepRtkSession(extDir, installOptions));
     await capture('rtk filter', () => stepRtkFilter(extDir, installOptions));
+    await capture('timing', () => stepTiming(extDir, installOptions));
     await capture('caveman', () => stepCaveman(extDir, installOptions));
     await capture('combo', () => stepCombo(extDir, installOptions));
     await capture('pstack', () => stepPstack(extDir, installOptions));