@krtclcdy/tersio 2.22.0 → 2.23.0

package/extensions/ai-addons-updater/index.js

@@ -8,13 +8,13 @@ import { createHash } from 'node:crypto';
 import fs from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
-import { CAVEMAN_REMOTE_RULE as CAVEMAN_REMOTE, RTK_RELEASE_API, fetchJson, findFile, httpsGet, httpsDownload, sha256Hex, parseChecksum, normalizeRtkVersion, readTextIfExists, rtkPlatformSpec, } from '../lib/utils.js';
+import { CAVEMAN_REMOTE_RULE as CAVEMAN_REMOTE, RTK_RELEASE_API, fetchJson, findFile, httpsGet, httpsDownload, sha256Hex, parseChecksum, normalizeRtkVersion, readTextIfExists, rtkPlatformSpec, resolveRtkBinary, } from '../lib/utils.js';
 const IS_WINDOWS = process.platform === 'win32';
 const HOME = os.homedir();
 const PONYTAIL_REMOTE = 'https://raw.githubusercontent.com/DietrichGebert/ponytail/main/package.json';
 const PONYTAIL_LOCAL = path.join(HOME, '.omp', 'plugins', 'node_modules', '@dietrichgebert', 'ponytail', 'package.json');
-const RTK_BINARY = path.join(HOME, '.bun', 'bin', IS_WINDOWS ? 'rtk.exe' : 'rtk');
-const CAVEMAN_LOCAL = path.join(HOME, '.omp', 'agent', 'extensions', 'caveman-session', 'rule.md');
+const RTK_BINARY = resolveRtkBinary();
+const CAVEMAN_LOCAL = path.join(HOME, '.omp', 'plugins', 'node_modules', '@krtclcdy', 'tersio', 'extensions', 'caveman-session', 'rule.md');
 const RELOAD_MSG = 'Reminder: restart OMP (or reload extensions) for updates to take effect.';
 function notify(ctx, msg, level) {
     ctx?.ui?.notify?.(String(msg), level);
@@ -55,6 +55,8 @@ function checkRtk() {
         const latestTag = release.tag_name || null;
         let localVer = null;
         try {
+            if (!RTK_BINARY)
+                throw new Error('rtk not found in PATH');
             const out = execFileSync(RTK_BINARY, ['--version'], { encoding: 'utf8', windowsHide: true, shell: false, timeout: 10000 }) || '';
             if (out)
                 localVer = out.trim().split(/\r?\n/)[0];
@@ -146,6 +148,8 @@ async function updateRtk(ctx, dryRun = false) {
     }
     const tag = release.tag_name || 'unknown';
     const assets = Array.isArray(release.assets) ? release.assets : [];
+    if (!RTK_BINARY)
+        return report(ctx, 'RTK: executable not found in PATH', 'warning');
     // Cross-platform asset selection (mirrors installer stepRtk)
     const PLATFORM = process.platform;
     const ARCH = process.arch;

package/extensions/ai-addons-updater/index.ts

@@ -23,6 +23,7 @@ import {
   normalizeRtkVersion,
   readTextIfExists,
   rtkPlatformSpec,
+  resolveRtkBinary,
 } from '../lib/utils.ts';
 
 const IS_WINDOWS = process.platform === 'win32';
@@ -30,9 +31,18 @@ const HOME = os.homedir();
 
 const PONYTAIL_REMOTE = 'https://raw.githubusercontent.com/DietrichGebert/ponytail/main/package.json';
 const PONYTAIL_LOCAL = path.join(HOME, '.omp', 'plugins', 'node_modules', '@dietrichgebert', 'ponytail', 'package.json');
-const RTK_BINARY = path.join(HOME, '.bun', 'bin', IS_WINDOWS ? 'rtk.exe' : 'rtk');
-const CAVEMAN_LOCAL = path.join(HOME, '.omp', 'agent', 'extensions', 'caveman-session', 'rule.md');
-
+const RTK_BINARY = resolveRtkBinary();
+const CAVEMAN_LOCAL = path.join(
+  HOME,
+  '.omp',
+  'plugins',
+  'node_modules',
+  '@krtclcdy',
+  'tersio',
+  'extensions',
+  'caveman-session',
+  'rule.md',
+);
 const RELOAD_MSG = 'Reminder: restart OMP (or reload extensions) for updates to take effect.';
 
 // --- Types ---
@@ -104,6 +114,7 @@ function checkRtk(): Promise<AddonStatus> {
     const latestTag = release.tag_name || null;
     let localVer: string | null = null;
     try {
+      if (!RTK_BINARY) throw new Error('rtk not found in PATH');
       const out = execFileSync(RTK_BINARY, ['--version'], { encoding: 'utf8', windowsHide: true, shell: false, timeout: 10000 }) || '';
       if (out) localVer = out.trim().split(/\r?\n/)[0];
     } catch { localVer = null; }
@@ -188,6 +199,7 @@ async function updateRtk(ctx: AddonUpdaterCtx, dryRun = false): Promise<string>
   }
   const tag = release.tag_name || 'unknown';
   const assets = Array.isArray(release.assets) ? release.assets : [];
+  if (!RTK_BINARY) return report(ctx, 'RTK: executable not found in PATH', 'warning');
 
   // Cross-platform asset selection (mirrors installer stepRtk)
   const PLATFORM = process.platform;

package/extensions/caveman-session/index.js

@@ -5,16 +5,20 @@ import { dirname, join } from 'node:path';
 import { readCavemanDefault } from '../shared/plugin-settings.js';
 const CAVERN_DIR = dirname(fileURLToPath(import.meta.url));
 const RULE_PATH = join(CAVERN_DIR, 'rule.md');
-const FALLBACK_FULL_RULE = `Respond terse like smart caveman. All technical substance stay. Only fluff die.
+const FALLBACK_FULL_RULE = `Caveman full active for this session.
+Respond terse like smart caveman. Keep all technical substance. Drop filler, pleasantries, and hedging.
 
 Rules:
-- Drop articles (a/an/the), filler (just/really/basically), pleasantries, hedging.
-- Fragments OK. Short synonyms. Technical terms exact. Code unchanged.
-- Pattern: [thing] [action] [reason]. [next step].
-- Not: 'Sure! I'd be happy to help you with that.'
-- Yes: 'Bug in auth middleware. Fix:'
+- Drop articles where meaning stays clear. Keep fragments and short sentences.
+- Keep technical terms, code, commands, paths, API names, numbers, units, and errors exact.
+- Never invent abbreviations or causal arrows. Do not add words to sound caveman.
+- Use ASD-STE100 Simplified Technical English. Keep one idea per sentence, target 20 words, active voice, and consistent terms.
+- Make no tool-call narration. Use no decorative tables or emoji.
+- Preserve the user's reply language. Compress style, not language.
+- Drop caveman for security warnings, irreversible actions, ambiguous multi-step sequences, or requests to clarify.
+- Write code, comments, commits, docs, issues, pull requests, and third-party messages in normal prose.
 
-Auto-clarity: drop caveman for security warnings, irreversible actions, or when user seems confused. Resume after.`;
+Default: **full**. Switch: \`/caveman lite|full|ultra|wenyan-lite|wenyan-full|wenyan-ultra|off\`. Stop: "stop caveman" or "normal mode".`;
 // ponytail: synchronous read each full-mode injection; ceiling = small file, cold session start. Upgrade path: cache file contents + mtime, invalidate on change.
 function readFullRule() {
     try {
@@ -30,9 +34,10 @@ const INSTRUCTIONS = {
 Respond concise. Drop pleasantries, filler, and hedging. Keep complete technical substance. Code, commands, paths, errors, commits, and PR text stay normal/exact.`,
     full: () => `Caveman full active for this session.\n${readFullRule()}`,
     ultra: `Caveman ultra active for this session.
-Maximum terse prose. Fragments preferred. No pleasantries, no tour, no recap unless needed. Keep all technical substance exact. Code, commands, commits, PR text, paths, and errors stay normal/exact. Drop caveman for security warnings, irreversible actions, or user confusion.`,
-    wenyan: `Caveman wenyan active for this session.
-Use ultra-terse classical-Chinese-style prose only where it preserves clarity for the user. Keep technical terms, code, commands, commits, PR text, paths, and errors exact. If clarity would suffer, use caveman full instead.`,
+Maximum terse prose. Strip conjunctions only when meaning stays clear. State each fact once. Use no invented abbreviations or causal arrows. Keep code, commands, commits, PR text, paths, API names, numbers, units, and errors exact. Drop caveman for security warnings, irreversible actions, ambiguous multi-step sequences, or user confusion.`,
+    'wenyan-lite': `Caveman wenyan-lite active for this session. Use semi-classical terse prose. Keep grammar structure, user language, technical terms, code, commands, paths, API names, numbers, units, and errors exact. Drop caveman when clarity or safety needs normal prose.`,
+    'wenyan-full': `Caveman wenyan-full active for this session. Use maximum classical terseness where meaning stays clear. Use classical sentence patterns, verbs before objects, and optional omitted subjects. Keep user language, technical terms, code, commands, paths, API names, numbers, units, and errors exact. Drop caveman when clarity or safety needs normal prose.`,
+    'wenyan-ultra': `Caveman wenyan-ultra active for this session. Use extreme classical abbreviation while keeping a classical Chinese feel and meaning clear. Keep user language, technical terms, code, commands, paths, API names, numbers, units, and errors exact. Drop caveman when clarity or safety needs normal prose.`,
 };
 function resolveMode(entries, fallback = DEFAULT_MODE) {
     return lastCustomValue(entries, 'caveman-mode', (data) => normalizeMode('caveman', data?.mode)) ?? fallback;
@@ -97,7 +102,7 @@ export default function cavemanSessionExtension(pi) {
                 return;
             }
             if (!setMode(arg, ctx)) {
-                ctx?.ui?.notify?.('Usage: /caveman [lite|full|ultra|wenyan|off|status]', 'warning');
+                ctx?.ui?.notify?.('Usage: /caveman [lite|full|ultra|wenyan-lite|wenyan-full|wenyan-ultra|off|status]', 'warning');
             }
         },
     });
@@ -117,7 +122,7 @@ export default function cavemanSessionExtension(pi) {
         // Persisted session state wins; a fresh session falls back to the
         // installer/user-configured default (off unless configured).
         const persisted = resolveMode(entries, '');
-        currentMode = persisted || readCavemanDefault();
+        currentMode = persisted || normalizeMode('caveman', readCavemanDefault()) || DEFAULT_MODE;
         syncStatus(ctx);
     }
     pi.on('session_start', async (_event, ctx) => {

package/extensions/caveman-session/index.ts

@@ -8,16 +8,20 @@ import type { ExtensionApi, ExtensionCtx, InputEvent, SessionEntry, SystemPrompt
 const CAVERN_DIR = dirname(fileURLToPath(import.meta.url));
 const RULE_PATH = join(CAVERN_DIR, 'rule.md');
 
-const FALLBACK_FULL_RULE = `Respond terse like smart caveman. All technical substance stay. Only fluff die.
+const FALLBACK_FULL_RULE = `Caveman full active for this session.
+Respond terse like smart caveman. Keep all technical substance. Drop filler, pleasantries, and hedging.
 
 Rules:
-- Drop articles (a/an/the), filler (just/really/basically), pleasantries, hedging.
-- Fragments OK. Short synonyms. Technical terms exact. Code unchanged.
-- Pattern: [thing] [action] [reason]. [next step].
-- Not: 'Sure! I'd be happy to help you with that.'
-- Yes: 'Bug in auth middleware. Fix:'
+- Drop articles where meaning stays clear. Keep fragments and short sentences.
+- Keep technical terms, code, commands, paths, API names, numbers, units, and errors exact.
+- Never invent abbreviations or causal arrows. Do not add words to sound caveman.
+- Use ASD-STE100 Simplified Technical English. Keep one idea per sentence, target 20 words, active voice, and consistent terms.
+- Make no tool-call narration. Use no decorative tables or emoji.
+- Preserve the user's reply language. Compress style, not language.
+- Drop caveman for security warnings, irreversible actions, ambiguous multi-step sequences, or requests to clarify.
+- Write code, comments, commits, docs, issues, pull requests, and third-party messages in normal prose.
 
-Auto-clarity: drop caveman for security warnings, irreversible actions, or when user seems confused. Resume after.`;
+Default: **full**. Switch: \`/caveman lite|full|ultra|wenyan-lite|wenyan-full|wenyan-ultra|off\`. Stop: "stop caveman" or "normal mode".`;
 
 // ponytail: synchronous read each full-mode injection; ceiling = small file, cold session start. Upgrade path: cache file contents + mtime, invalidate on change.
 function readFullRule(): string {
@@ -30,9 +34,10 @@ const INSTRUCTIONS: Record<string, string | (() => string)> = {
 Respond concise. Drop pleasantries, filler, and hedging. Keep complete technical substance. Code, commands, paths, errors, commits, and PR text stay normal/exact.`,
   full: () => `Caveman full active for this session.\n${readFullRule()}`,
   ultra: `Caveman ultra active for this session.
-Maximum terse prose. Fragments preferred. No pleasantries, no tour, no recap unless needed. Keep all technical substance exact. Code, commands, commits, PR text, paths, and errors stay normal/exact. Drop caveman for security warnings, irreversible actions, or user confusion.`,
-  wenyan: `Caveman wenyan active for this session.
-Use ultra-terse classical-Chinese-style prose only where it preserves clarity for the user. Keep technical terms, code, commands, commits, PR text, paths, and errors exact. If clarity would suffer, use caveman full instead.`,
+Maximum terse prose. Strip conjunctions only when meaning stays clear. State each fact once. Use no invented abbreviations or causal arrows. Keep code, commands, commits, PR text, paths, API names, numbers, units, and errors exact. Drop caveman for security warnings, irreversible actions, ambiguous multi-step sequences, or user confusion.`,
+  'wenyan-lite': `Caveman wenyan-lite active for this session. Use semi-classical terse prose. Keep grammar structure, user language, technical terms, code, commands, paths, API names, numbers, units, and errors exact. Drop caveman when clarity or safety needs normal prose.`,
+  'wenyan-full': `Caveman wenyan-full active for this session. Use maximum classical terseness where meaning stays clear. Use classical sentence patterns, verbs before objects, and optional omitted subjects. Keep user language, technical terms, code, commands, paths, API names, numbers, units, and errors exact. Drop caveman when clarity or safety needs normal prose.`,
+  'wenyan-ultra': `Caveman wenyan-ultra active for this session. Use extreme classical abbreviation while keeping a classical Chinese feel and meaning clear. Keep user language, technical terms, code, commands, paths, API names, numbers, units, and errors exact. Drop caveman when clarity or safety needs normal prose.`,
 };
 
 function resolveMode(entries: SessionEntry[] | null | undefined, fallback: string = DEFAULT_MODE): string {
@@ -102,7 +107,7 @@ export default function cavemanSessionExtension(pi: ExtensionApi): void {
         return;
       }
       if (!setMode(arg, ctx)) {
-        ctx?.ui?.notify?.('Usage: /caveman [lite|full|ultra|wenyan|off|status]', 'warning');
+        ctx?.ui?.notify?.('Usage: /caveman [lite|full|ultra|wenyan-lite|wenyan-full|wenyan-ultra|off|status]', 'warning');
       }
     },
   });
@@ -122,7 +127,7 @@ export default function cavemanSessionExtension(pi: ExtensionApi): void {
     // Persisted session state wins; a fresh session falls back to the
     // installer/user-configured default (off unless configured).
     const persisted = resolveMode(entries, '');
-    currentMode = persisted || readCavemanDefault();
+    currentMode = persisted || normalizeMode('caveman', readCavemanDefault()) || DEFAULT_MODE;
     syncStatus(ctx);
   }
 

package/extensions/caveman-session/rule.md

@@ -0,0 +1,90 @@
+---
+name: caveman
+description: >
+  Ultra-compressed communication mode that cuts output tokens while keeping
+  technical accuracy. Levels: lite, full, ultra and the wenyan variants. Use for
+  /caveman, "caveman mode", "talk like caveman", "be brief" or "less tokens".
+---
+
+Respond terse like smart caveman. All technical substance stay. Only fluff die.
+
+## Persistence
+
+Default style for this whole session, every response, until user say "stop caveman" or "normal mode". Keep terse on long sessions no filler drift.
+
+Default: **full**. Switch: `/caveman lite|full|ultra|wenyan-lite|wenyan-full|wenyan-ultra|off`.
+
+## Rules
+
+Drop: articles (a/an/the), filler (just/really/basically/actually/simply), pleasantries (sure/certainly/of course/happy to), hedging. Fragments OK. Short synonyms (big not extensive, fix not "implement a solution for"). No tool-call narration, no decorative tables/emoji, no dumping long raw error logs unless asked quote shortest decisive line. Standard well-known tech acronyms OK (DB/API/HTTP); never invent new abbreviations (cfg/impl/req/res/fn) tokenizer split them same as full word: zero token saved, reader still decode. Full word cheaper AND clearer. No causal arrows (→) either own token, save nothing. Technical terms exact. Code blocks unchanged. Errors quoted exact.
+
+Never drop not/never/no/only/except flip meaning worse than any token saved. Numbers, units exact.
+
+Never ADD word to sound caveman. Compression only style never grow output. No inserted pronoun or copula to fake broken grammar: "when it not" cost one token more than "when not" and say same thing. Keep correct verb form when correct form cost same "sees" one token, "see" one token, so mangle buy nothing and read worse. Same rule as abbreviations and arrows: if caveman phrasing not shorter than plain phrasing, use plain.
+
+Clarity register: mix ASD-STE100 Simplified Technical English into caveman, always. One idea per sentence. Sentence short, target 20 words max. Active voice. Present tense where true. One word one meaning: same term for same thing every time, no synonym rotation. Instruction = imperative: "Run X", not "X should be run". Noun cluster 3 words max. Pronoun only with one clear referent, else repeat noun. Caveman cut filler; STE keep what make meaning unambiguous. Conflict between them → clarity win.
+
+Tool calls: fire direct. No preamble, plan, or progress note before or between calls. After result: next call direct or final answer never announce next call. Text before call only to clarify, warn security/irreversible, or resolve ambiguity.
+
+Follow explicit reply-language instructions from the user or project. Otherwise preserve the user's dominant language. Never switch because of example text or multilingual context elsewhere. Compress the style, not the language. Every emitted line in that language openings, pre-tool status lines, all not just final reply. ALWAYS keep technical terms, code, API names, CLI commands, commit-type keywords (feat/fix/...), and exact error strings verbatim unless user explicitly ask for translation.
+
+'Drop articles' = article languages only. Where small markers carry case/role (particles, postpositions), keep them grammar, not filler; compress politeness/filler instead.
+
+Answer directly in this style. Skip "caveman mode on", "me caveman think", "Caveman:" prefix or recap redundant with the reply itself. No normal answer plus caveman duplicate. User ask what mode is → say so plainly.
+
+Pattern: `[thing] [action] [reason]. [next step].`
+
+Not: "Sure! I'd be happy to help you with that. The issue you're experiencing is likely caused by..."
+Yes: "Bug in auth middleware. Token expiry check use `<` not `<=`. Fix:"
+
+## Intensity
+
+| Level | What change |
+|-------|------------|
+| **lite** | No filler/hedging. Keep articles + full sentences. Professional but tight |
+| **full** | Drop articles, fragments OK, short synonyms. Classic caveman. No tool-call narration, no decorative tables/emoji, no long raw error-log dumps unless asked. Standard acronyms OK; no invented abbreviations |
+| **ultra** | Strip conjunctions when cause-then-effect stay unambiguous. One word when one word enough. State each fact once. NO prose abbreviations (cfg/impl/req/res/fn/auth), NO arrows (X → Y) measured zero token saving under tokenizer, cost decode clarity. Code symbols, function names, API names, error strings: never touch |
+| **wenyan-lite** | Semi-classical. Drop filler/hedging but keep grammar structure, classical register |
+| **wenyan-full** | Maximum classical terseness. Fully 文言文. 80-90% character reduction chars, not tokens. Classical sentence patterns, verbs precede objects, subjects often omitted, classical particles (之/乃/為/其) |
+| **wenyan-ultra** | Extreme abbreviation while keeping classical Chinese feel. Maximum compression, ultra terse |
+
+Example "Why React component re-render?"
+- lite: "Your component re-renders because you create a new object reference each render. Wrap it in `useMemo`."
+- full: "New object ref each render. Inline object prop = new ref = re-render. Wrap in `useMemo`."
+- ultra: "Inline obj prop, new ref, re-render. `useMemo`."
+- wenyan-lite: "組件頻重繪，以每繪新生對象參照故。以 useMemo 包之。"
+- wenyan-full: "每繪新生對象參照，故重繪；以 useMemo 包之則免。"
+- wenyan-ultra: "新參照則重繪。useMemo 包之。"
+
+Example "Explain database connection pooling."
+- lite: "Connection pooling reuses open connections instead of creating new ones per request. Avoids repeated handshake overhead."
+- full: "Pool reuse open DB connections. No new connection per request. Skip handshake overhead."
+- ultra: "Pool reuse open DB connections. No per-request handshake."
+- wenyan-full: "池蓄已開之連，不逐請而新開，省握手之費。"
+- wenyan-ultra: "池蓄連，免逐請新開，省握手。"
+
+Classical chars = wenyan modes only. Never swap a word to a classical char to shrink at non-wenyan levels.
+
+## Auto-Clarity
+
+Drop caveman when:
+- Security warnings
+- Irreversible action confirmations
+- Multi-step sequences where fragment order or omitted conjunctions risk misread
+- Compression itself creates technical ambiguity (e.g., `"migrate table drop column backup first"` order unclear without articles/conjunctions)
+- User asks to clarify or repeats question
+
+Resume caveman after clear part done.
+
+Example shows FORMAT only write warning in session language, not example's.
+
+Example destructive op:
+> **Warning:** This will permanently delete all rows in the `users` table and cannot be undone.
+> ```sql
+> DROP TABLE users;
+> ```
+> Caveman resume. Verify backup exist first.
+
+## Boundaries
+
+Persisted outside chat: write normal prose code, comments, commits, docs, issue/PR/MR/defect/ticket/bug-report text, memory files, third-party messages (/caveman-compress exempt). "Open a defect" or "file a bug" mean the same as "open issue": body go to other humans, so body normal English. "stop caveman" or "normal mode": revert. Level persist until changed or session end.

package/extensions/combo-toggle/index.js

@@ -4,11 +4,10 @@ import os from 'node:os';
 import path from 'node:path';
 import { createRequire } from 'node:module';
 import { activeModesSummary, asPromptArray, COMBO_LEVELS, getSharedComboState, isComboPresetActive, isOmpSubagentPrompt, normalizeComboLevel, paintableCtx, reconcileSharedComboEntries, sessionEntries, setSharedComboLevel, setSharedComboListener, setSharedComboMode, systemPromptIncludes, } from '../shared/session-state.js';
-import { readComboDefault, readPonytailDefault } from '../shared/plugin-settings.js';
+import { isComboSetupComplete, readComboDefault, readPonytailDefault, saveComboSetup, } from '../shared/plugin-settings.js';
 const require = createRequire(import.meta.url);
 const PONYTAIL_FALLBACK_INTENSITY = {
     lite: 'Prefer the simplest correct solution.',
-    review: 'Review only for avoidable complexity; recommend the smallest correct replacement.',
 };
 function ponytailFallback(mode) {
     const intensity = PONYTAIL_FALLBACK_INTENSITY[mode] ?? 'Use the minimum correct solution. Delete or reuse before adding.';
@@ -30,6 +29,7 @@ function loadPonytailInstructions(mode) {
 export default function comboToggleExtension(pi) {
     pi.setLabel?.('Combo session toggle (all 3 add-ons)');
     let lastCtx = undefined;
+    let setupPrompted = false;
     function syncStatus(ctx) {
         lastCtx = paintableCtx(lastCtx, ctx);
         const c = lastCtx;
@@ -115,10 +115,28 @@ export default function comboToggleExtension(pi) {
             ctx?.ui?.notify?.(level === 'off' ? `Combo off — all tersio modes inactive for this session. Active: ${active}.` : `Combo ${level} on — ${active} active for this session.`, 'info');
         },
     });
+    async function runFirstRunSetup(ctx) {
+        if (setupPrompted || !ctx?.hasUI || !ctx.ui?.select || isComboSetupComplete())
+            return;
+        setupPrompted = true;
+        const choice = await ctx.ui.select('Session-start defaults — Combo preset', [
+            { label: 'off', description: 'Keep every Tersio mode inactive' },
+            { label: 'medium', description: 'caveman=lite, rtk=on, ponytail=lite' },
+            { label: 'balanced', description: 'caveman=full, rtk=on, ponytail=full' },
+            { label: 'max', description: 'caveman=ultra, rtk=on, ponytail=ultra' },
+        ], { selectionMarker: 'radio', helpText: 'You can change this later with /tersio settings.' });
+        const level = choice || 'off';
+        if (saveComboSetup(level) && level !== 'off') {
+            persistPreset(level);
+            useState(setSharedComboLevel(level), ctx);
+            ctx.ui.notify?.(`Combo default saved: ${level} — ${activeModesSummary(getSharedComboState())} will activate on fresh sessions.`, 'info');
+        }
+    }
     pi.on('session_start', async (_event, ctx) => {
         track(ctx);
         if (!ctx?.hasUI)
             syncStatus(ctx);
+        await runFirstRunSetup(ctx);
         // Installer/user-configured default applies only when no persisted *mode*
         // state exists — unrelated session entries must not block it, or the
         // combo bar never paints on sessions that already carry other entries.
@@ -148,6 +166,8 @@ export default function comboToggleExtension(pi) {
     for (const event of ['session_branch', 'session_tree', 'agent_start']) {
         pi.on(event, async (_event, ctx) => {
             track(ctx);
+            if (event === 'agent_start')
+                await runFirstRunSetup(ctx);
         });
     }
     pi.on('before_agent_start', async (event, ctx) => {

package/extensions/combo-toggle/index.ts

@@ -20,14 +20,18 @@ import {
   setSharedComboMode,
   systemPromptIncludes,
 } from '../shared/session-state.ts';
-import { readComboDefault, readPonytailDefault } from '../shared/plugin-settings.ts';
+import {
+  isComboSetupComplete,
+  readComboDefault,
+  readPonytailDefault,
+  saveComboSetup,
+} from '../shared/plugin-settings.ts';
 import type { ComboState, ExtensionApi, ExtensionCtx, SystemPromptEvent } from '../shared/types.ts';
 
 const require = createRequire(import.meta.url);
 
 const PONYTAIL_FALLBACK_INTENSITY: Record<string, string> = {
   lite: 'Prefer the simplest correct solution.',
-  review: 'Review only for avoidable complexity; recommend the smallest correct replacement.',
 };
 
 function ponytailFallback(mode: string): string {
@@ -61,6 +65,7 @@ export default function comboToggleExtension(pi: ExtensionApi): void {
   pi.setLabel?.('Combo session toggle (all 3 add-ons)');
 
   let lastCtx: ExtensionCtx | undefined = undefined;
+  let setupPrompted = false;
 
   function syncStatus(ctx?: ExtensionCtx): void {
     lastCtx = paintableCtx(lastCtx, ctx);
@@ -166,9 +171,27 @@ export default function comboToggleExtension(pi: ExtensionApi): void {
     },
   });
 
+  async function runFirstRunSetup(ctx?: ExtensionCtx): Promise<void> {
+    if (setupPrompted || !ctx?.hasUI || !ctx.ui?.select || isComboSetupComplete()) return;
+    setupPrompted = true;
+    const choice = await ctx.ui.select('Session-start defaults — Combo preset', [
+      { label: 'off', description: 'Keep every Tersio mode inactive' },
+      { label: 'medium', description: 'caveman=lite, rtk=on, ponytail=lite' },
+      { label: 'balanced', description: 'caveman=full, rtk=on, ponytail=full' },
+      { label: 'max', description: 'caveman=ultra, rtk=on, ponytail=ultra' },
+    ], { selectionMarker: 'radio', helpText: 'You can change this later with /tersio settings.' });
+    const level = choice || 'off';
+    if (saveComboSetup(level) && level !== 'off') {
+      persistPreset(level);
+      useState(setSharedComboLevel(level), ctx);
+      ctx.ui.notify?.(`Combo default saved: ${level} — ${activeModesSummary(getSharedComboState())} will activate on fresh sessions.`, 'info');
+    }
+  }
+
   pi.on('session_start', async (_event, ctx) => {
     track(ctx);
     if (!ctx?.hasUI) syncStatus(ctx);
+    await runFirstRunSetup(ctx);
     // Installer/user-configured default applies only when no persisted *mode*
     // state exists — unrelated session entries must not block it, or the
     // combo bar never paints on sessions that already carry other entries.
@@ -200,6 +223,7 @@ export default function comboToggleExtension(pi: ExtensionApi): void {
   for (const event of ['session_branch', 'session_tree', 'agent_start']) {
     pi.on(event, async (_event, ctx) => {
       track(ctx);
+      if (event === 'agent_start') await runFirstRunSetup(ctx);
     });
   }
 

package/extensions/lib/utils.js

@@ -1,7 +1,7 @@
 // Shared helpers for the installer and the AI add-ons updater.
 // Node built-ins only — this module must stay dependency-free.
 import { createHash } from 'node:crypto';
-import { createWriteStream, existsSync, mkdirSync, renameSync } from 'node:fs';
+import { accessSync, constants, createWriteStream, existsSync, mkdirSync, renameSync, statSync } from 'node:fs';
 import fs from 'node:fs/promises';
 import https from 'node:https';
 import os from 'node:os';
@@ -15,7 +15,7 @@ export function withResolvers() {
     return { promise, resolve, reject };
 }
 export const RTK_RELEASE_API = 'https://api.github.com/repos/rtk-ai/rtk/releases/latest';
-export const CAVEMAN_REMOTE_RULE = 'https://raw.githubusercontent.com/JuliusBrussee/caveman/main/src/rules/caveman-activate.md';
+export const CAVEMAN_REMOTE_RULE = 'https://raw.githubusercontent.com/JuliusBrussee/caveman/main/skills/caveman/SKILL.md';
 const RTK_PLATFORM_SPECS = {
     'win32/x64': { triple: 'x86_64-pc-windows-msvc', ext: '.zip', binary: 'rtk.exe' },
     'linux/x64': { triple: 'x86_64-unknown-linux-musl', ext: '.tar.gz', binary: 'rtk' },
@@ -23,6 +23,22 @@ const RTK_PLATFORM_SPECS = {
     'darwin/x64': { triple: 'x86_64-apple-darwin', ext: '.tar.gz', binary: 'rtk' },
     'darwin/arm64': { triple: 'aarch64-apple-darwin', ext: '.tar.gz', binary: 'rtk' },
 };
+export function resolveRtkBinary(managedDir = path.join(os.homedir(), '.bun', 'bin')) {
+    const name = process.platform === 'win32' ? 'rtk.exe' : 'rtk';
+    const candidates = (process.env.PATH || '').split(path.delimiter).filter(Boolean).map((dir) => path.join(dir, name));
+    if (managedDir)
+        candidates.push(path.join(managedDir, name));
+    for (const candidate of candidates) {
+        try {
+            if (!statSync(candidate).isFile())
+                continue;
+            accessSync(candidate, constants.X_OK);
+            return candidate;
+        }
+        catch { /* keep searching */ }
+    }
+    return null;
+}
 export function rtkPlatformSpec(platform = process.platform, arch = process.arch) {
     return RTK_PLATFORM_SPECS[`${platform}/${arch}`] || null;
 }
@@ -36,7 +52,7 @@ function redirectNext(res, url) {
 export function httpsGet(url, opts = {}) {
     const { promise, resolve, reject } = withResolvers();
     const maxRedirects = opts.maxRedirects ?? 5;
-    const req = https.get(url, { headers: { 'User-Agent': 'tersio', Accept: 'application/json,*/*' } }, (res) => {
+    const req = https.get(url, { headers: { 'User-Agent': 'tersio', Accept: 'application/json,*/*' }, signal: opts.signal }, (res) => {
         const next = redirectNext(res, url);
         if (next) {
             if (maxRedirects <= 0) {
@@ -45,7 +61,7 @@ export function httpsGet(url, opts = {}) {
                 return;
             }
             res.resume();
-            resolve(httpsGet(next, { maxRedirects: maxRedirects - 1 }));
+            resolve(httpsGet(next, { maxRedirects: maxRedirects - 1, signal: opts.signal }));
             return;
         }
         if (res.statusCode !== 200) {

package/extensions/lib/utils.ts

@@ -2,7 +2,7 @@
 // Node built-ins only — this module must stay dependency-free.
 
 import { createHash } from 'node:crypto';
-import { createWriteStream, existsSync, mkdirSync, renameSync } from 'node:fs';
+import { accessSync, constants, createWriteStream, existsSync, mkdirSync, renameSync, statSync } from 'node:fs';
 import fs from 'node:fs/promises';
 import https from 'node:https';
 import os from 'node:os';
@@ -10,6 +10,7 @@ import path from 'node:path';
 
 export interface HttpOptions {
   maxRedirects?: number;
+  signal?: AbortSignal;
 }
 
 // Promise.withResolvers is Node 22+; the package supports Node 18+.
@@ -22,7 +23,7 @@ export function withResolvers<T>(): PromiseWithResolvers<T> {
 }
 
 export const RTK_RELEASE_API = 'https://api.github.com/repos/rtk-ai/rtk/releases/latest';
-export const CAVEMAN_REMOTE_RULE = 'https://raw.githubusercontent.com/JuliusBrussee/caveman/main/src/rules/caveman-activate.md';
+export const CAVEMAN_REMOTE_RULE = 'https://raw.githubusercontent.com/JuliusBrussee/caveman/main/skills/caveman/SKILL.md';
 
 export interface RtkPlatformSpec {
   triple: string;
@@ -47,6 +48,19 @@ const RTK_PLATFORM_SPECS: Record<string, RtkPlatformSpec> = {
   'darwin/x64': { triple: 'x86_64-apple-darwin', ext: '.tar.gz', binary: 'rtk' },
   'darwin/arm64': { triple: 'aarch64-apple-darwin', ext: '.tar.gz', binary: 'rtk' },
 };
+export function resolveRtkBinary(managedDir = path.join(os.homedir(), '.bun', 'bin')): string | null {
+  const name = process.platform === 'win32' ? 'rtk.exe' : 'rtk';
+  const candidates = (process.env.PATH || '').split(path.delimiter).filter(Boolean).map((dir) => path.join(dir, name));
+  if (managedDir) candidates.push(path.join(managedDir, name));
+  for (const candidate of candidates) {
+    try {
+      if (!statSync(candidate).isFile()) continue;
+      accessSync(candidate, constants.X_OK);
+      return candidate;
+    } catch { /* keep searching */ }
+  }
+  return null;
+}
 
 export function rtkPlatformSpec(platform: string = process.platform, arch: string = process.arch): RtkPlatformSpec | null {
   return RTK_PLATFORM_SPECS[`${platform}/${arch}`] || null;
@@ -63,12 +77,12 @@ function redirectNext(res: { statusCode?: number; headers: { location?: string }
 export function httpsGet(url: string, opts: HttpOptions = {}): Promise<string> {
   const { promise, resolve, reject } = withResolvers<string>();
   const maxRedirects = opts.maxRedirects ?? 5;
-  const req = https.get(url, { headers: { 'User-Agent': 'tersio', Accept: 'application/json,*/*' } }, (res) => {
+  const req = https.get(url, { headers: { 'User-Agent': 'tersio', Accept: 'application/json,*/*' }, signal: opts.signal }, (res) => {
     const next = redirectNext(res, url);
     if (next) {
       if (maxRedirects <= 0) { res.resume(); reject(new Error(`Too many redirects fetching ${url}`)); return; }
       res.resume();
-      resolve(httpsGet(next, { maxRedirects: maxRedirects - 1 }));
+      resolve(httpsGet(next, { maxRedirects: maxRedirects - 1, signal: opts.signal }));
       return;
     }
     if (res.statusCode !== 200) { res.resume(); reject(new Error(`HTTP ${res.statusCode} for ${url}`)); return; }

package/extensions/rtk-session/index.js

@@ -1,5 +1,3 @@
-import os from 'node:os';
-import path from 'node:path';
 import { activeModesSummary, asPromptArray, getSharedComboState, isComboPresetActive, isOmpSubagentPrompt, lastCustomValue, normalizeInputCommand, paintStatusBar, paintableCtx, reconcileSharedComboEntries, sessionEntries, setSharedComboListener, setSharedComboMode } from '../shared/session-state.js';
 import { readRtkDefault } from '../shared/plugin-settings.js';
 const DEFAULT_ENABLED = false;
@@ -15,12 +13,13 @@ function asBoolean(value) {
 function resolveEnabled(entries) {
     return lastCustomValue(entries, 'rtk-mode', (data) => asBoolean(data?.enabled));
 }
-const IS_WINDOWS = process.platform === 'win32';
-const HOME = os.homedir();
-const RTK_BINARY = path.join(HOME, '.bun', 'bin', IS_WINDOWS ? 'rtk.exe' : 'rtk');
-const RTK_PROMPT = `RTK mode active for this session.
-Use Rust Token Killer for shell output that would otherwise be noisy. Prefer explicit RTK commands in bash: \`rtk git status\`, \`rtk git diff\`, \`rtk read <file>\`, \`rtk grep <pattern> <path>\`, \`rtk find <glob> <path>\`, \`rtk test <cmd...>\`, \`rtk tsc\`, \`rtk lint\`, or \`rtk <tool> ...\` for supported dev commands.
-Do not use RTK when exact raw output is required, when a specialized OMP tool is required by system policy, or when the command changes state and RTK would hide important confirmation text. Specialized OMP tools still win: read/glob/grep/edit/lsp stay preferred over shell equivalents.`;
+function setRtkProcessEnabled(enabled) {
+    if (enabled)
+        delete process.env.RTK_DISABLED;
+    else
+        process.env.RTK_DISABLED = '1';
+}
+const RTK_PROMPT = `RTK guidance active. RTK automatically rewrites eligible Bash calls through the installed rtk hook. Prefer rtk for noisy shell output, but use exact raw output for state changes, checksums, patches, and diagnostics that need full bytes.`;
 export default function rtkSessionExtension(pi) {
     const { z } = pi.zod;
     let enabled = DEFAULT_ENABLED;
@@ -42,7 +41,7 @@ export default function rtkSessionExtension(pi) {
         enabled = Boolean(next);
         pi.appendEntry?.('rtk-mode', { enabled });
         setSharedComboMode('rtk', enabled);
-        syncStatus(ctx);
+        setRtkProcessEnabled(enabled);
         const active = activeModesSummary(getSharedComboState());
         ctx?.ui?.notify?.(enabled ? `RTK on — compact shell output for this session. Active: ${active}.` : `RTK off. Active: ${active}.`, 'info');
     }
@@ -51,6 +50,7 @@ export default function rtkSessionExtension(pi) {
     // it at once so the next turn and the rtk_run gate see it, no reload.
     function syncFromShared(state) {
         enabled = state.rtk === 'on';
+        setRtkProcessEnabled(enabled);
         syncStatus();
     }
     setSharedComboListener(syncFromShared);
@@ -89,7 +89,7 @@ export default function rtkSessionExtension(pi) {
                 };
             }
             onUpdate?.({ content: [{ type: 'text', text: `rtk ${params.args.join(' ')}` }], details: { phase: 'start' } });
-            const result = await pi.exec(RTK_BINARY, params.args, { signal, cwd: ctx?.cwd || pi.cwd });
+            const result = await pi.exec('rtk', params.args, { signal, cwd: ctx?.cwd || pi.cwd });
             const text = [result.stdout, result.stderr].filter(Boolean).join('\n');
             return {
                 isError: result.code !== 0,
@@ -118,6 +118,7 @@ export default function rtkSessionExtension(pi) {
         // installer/user-configured default (off unless configured).
         const persisted = resolveEnabled(entries);
         enabled = typeof persisted === 'boolean' ? persisted : readRtkDefault();
+        setRtkProcessEnabled(enabled);
         syncStatus(ctx);
     }
     pi.on('session_start', async (_event, ctx) => {