@krtclcdy/tersio 2.22.1 → 2.24.0

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

@@ -1,21 +1,26 @@
-// OMP extension: /ai-addons manual updater for Ponytail, RTK, Caveman.
-// Built-in Node modules only. Default off; registers a single slash command.
-// ponytail: `skipped: none` — semantics match one-liner: fetch + compare + run install.
-// rtk: `skipped: signature verification` — checksums.txt ships only SHA256 of release assets; add sigchain when upstream publishes a signing key.
-// caveman: `skipped: none` — exactly the ask: write rule.md, report old/new hash.
+// /ai-addons manual updater. Node built-ins only. RTK ships SHA256 checksums
+// with no signature, so checksum-only is the best available.
 import { execFileSync } from 'node:child_process';
 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 { fileURLToPath } from 'node:url';
+import { setExtensionLabel } from '../shared/host.js';
+import { CAVEMAN_REMOTE_RULE as CAVEMAN_REMOTE, RTK_RELEASE_API, fetchJson, findFile, findHoistedPackage, httpsGet, httpsDownload, isPiProcess, sha256Hex, parseChecksum, normalizeRtkVersion, readTextIfExists, rtkPlatformSpec, resolveRtkBinary, } from '../lib/utils.js';
 const IS_WINDOWS = process.platform === 'win32';
-const HOME = os.homedir();
+const EXTENSION_DIR = path.dirname(fileURLToPath(import.meta.url));
 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 RELOAD_MSG = 'Reminder: restart OMP (or reload extensions) for updates to take effect.';
+const RTK_BINARY = resolveRtkBinary();
+// Beside this file, not a host path: that is the rule.md /caveman reads.
+const CAVEMAN_LOCAL = path.join(EXTENSION_DIR, '..', 'caveman-session', 'rule.md');
+const HOST_NAME = isPiProcess() ? 'Pi' : 'OMP';
+const RELOAD_MSG = `Reminder: restart ${HOST_NAME} (or reload extensions) for updates to take effect.`;
+// Ponytail is a hoisted dependency, so the installed copy is found by walking
+// up rather than by naming a host directory.
+function ponytailLocal() {
+    return findHoistedPackage('@dietrichgebert/ponytail', EXTENSION_DIR, 'package.json');
+}
 function notify(ctx, msg, level) {
     ctx?.ui?.notify?.(String(msg), level);
 }
@@ -29,16 +34,25 @@ function shortHash(text) {
 function checkFailed(name, e) {
     return { text: `${name} check failed: ${e.message}`, level: 'warning' };
 }
-// Single error-handling source for the three probes; messages unchanged.
 function runCheck(name, probe) {
     return probe().then((text) => ({ text, level: 'info' }), (e) => checkFailed(name, e));
 }
-// Check: no mutation. Probes run concurrently via checkAddons below.
+// A missing file is "not installed"; an unreadable one is a reportable fault.
+function parsePackageVersion(raw) {
+    if (!raw)
+        return null;
+    try {
+        return JSON.parse(raw).version ?? null;
+    }
+    catch {
+        throw new Error('ponytail package.json is not readable JSON');
+    }
+}
 function checkPonytail() {
     return runCheck('Ponytail', async () => {
         const remoteJson = await fetchJson(PONYTAIL_REMOTE);
-        const localRaw = await readTextIfExists(PONYTAIL_LOCAL);
-        const localVer = localRaw ? JSON.parse(localRaw).version ?? null : null;
+        const localRaw = await readTextIfExists(ponytailLocal() ?? '');
+        const localVer = parsePackageVersion(localRaw);
         const remoteVer = remoteJson.version;
         const status = !localVer ? 'not installed'
             : localVer === remoteVer ? 'up to date'
@@ -55,6 +69,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];
@@ -118,13 +134,10 @@ async function checkAddons(ctx) {
     return lines.join('\n');
 }
 async function updatePonytail(pi, ctx, dryRun = false) {
-    // Bundled with tersio: no separate package to refresh. `tersio update`
-    // pulls the bundled copy with the CLI.
+    // Bundled with tersio: `tersio update` pulls the copy with the CLI.
     let localVer = null;
     try {
-        const raw = await readTextIfExists(PONYTAIL_LOCAL);
-        if (raw)
-            localVer = JSON.parse(raw).version ?? null;
+        localVer = parsePackageVersion(await readTextIfExists(ponytailLocal() ?? ''));
     }
     catch {
         localVer = null;
@@ -146,7 +159,8 @@ async function updateRtk(ctx, dryRun = false) {
     }
     const tag = release.tag_name || 'unknown';
     const assets = Array.isArray(release.assets) ? release.assets : [];
-    // Cross-platform asset selection (mirrors installer stepRtk)
+    if (!RTK_BINARY)
+        return report(ctx, 'RTK: executable not found in PATH', 'warning');
     const PLATFORM = process.platform;
     const ARCH = process.arch;
     const spec = rtkPlatformSpec(PLATFORM, ARCH);
@@ -175,7 +189,6 @@ async function updateRtk(ctx, dryRun = false) {
             httpsDownload(asset.browser_download_url, archivePath),
             httpsDownload(checksAsset.browser_download_url, checksPath),
         ]);
-        // Verify SHA256 against checksums.txt
         const checks = await fs.readFile(checksPath, 'utf8');
         const expected = parseChecksum(checks, asset.name);
         if (!expected) {
@@ -189,7 +202,6 @@ async function updateRtk(ctx, dryRun = false) {
             return report(ctx, m, 'warning');
         }
         notify(ctx, 'RTK: checksum verified.', 'info');
-        // Extract by archive format
         const extractDir = path.join(tmp, 'extracted');
         await fs.mkdir(extractDir, { recursive: true });
         if (asset.name.endsWith('.zip')) {
@@ -221,7 +233,6 @@ async function updateRtk(ctx, dryRun = false) {
         const backupPath = `${RTK_BINARY}.bak`;
         const backedUp = await fs.copyFile(RTK_BINARY, backupPath).then(() => true, () => false);
         await fs.copyFile(rtkExtracted, RTK_BINARY);
-        // Set executable bit on Unix
         if (!IS_WINDOWS) {
             await fs.chmod(RTK_BINARY, 0o755);
         }
@@ -289,7 +300,7 @@ async function updateCaveman(ctx, dryRun = false) {
     }
 }
 export default function aiAddonsUpdaterExtension(pi) {
-    pi.setLabel?.('AI add-ons updater');
+    setExtensionLabel(pi, 'AI add-ons updater');
     pi.registerCommand?.('ai-addons', {
         description: 'Check or update AI add-ons (ponytail/rtk/caveman/all). Usage: /ai-addons <check|status|update ponytail|rtk|caveman|all> [--dry-run]',
         handler: async (args, ctx) => {

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

@@ -1,39 +1,47 @@
-// OMP extension: /ai-addons manual updater for Ponytail, RTK, Caveman.
-// Built-in Node modules only. Default off; registers a single slash command.
-// ponytail: `skipped: none` — semantics match one-liner: fetch + compare + run install.
-// rtk: `skipped: signature verification` — checksums.txt ships only SHA256 of release assets; add sigchain when upstream publishes a signing key.
-// caveman: `skipped: none` — exactly the ask: write rule.md, report old/new hash.
+// /ai-addons manual updater. Node built-ins only. RTK ships SHA256 checksums
+// with no signature, so checksum-only is the best available.
 
 import { execFileSync } from 'node:child_process';
 import { createHash } from 'node:crypto';
 import fs from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 
+import { setExtensionLabel } from '../shared/host.ts';
 import {
   CAVEMAN_REMOTE_RULE as CAVEMAN_REMOTE,
   RTK_RELEASE_API,
   RtkRelease,
   fetchJson,
   findFile,
+  findHoistedPackage,
   httpsGet,
   httpsDownload,
+  isPiProcess,
   sha256Hex,
   parseChecksum,
   normalizeRtkVersion,
   readTextIfExists,
   rtkPlatformSpec,
+  resolveRtkBinary,
 } from '../lib/utils.ts';
 
 const IS_WINDOWS = process.platform === 'win32';
-const HOME = os.homedir();
+const EXTENSION_DIR = path.dirname(fileURLToPath(import.meta.url));
 
 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 RELOAD_MSG = 'Reminder: restart OMP (or reload extensions) for updates to take effect.';
+const RTK_BINARY = resolveRtkBinary();
+// Beside this file, not a host path: that is the rule.md /caveman reads.
+const CAVEMAN_LOCAL = path.join(EXTENSION_DIR, '..', 'caveman-session', 'rule.md');
+const HOST_NAME = isPiProcess() ? 'Pi' : 'OMP';
+const RELOAD_MSG = `Reminder: restart ${HOST_NAME} (or reload extensions) for updates to take effect.`;
+
+// Ponytail is a hoisted dependency, so the installed copy is found by walking
+// up rather than by naming a host directory.
+function ponytailLocal(): string | null {
+  return findHoistedPackage('@dietrichgebert/ponytail', EXTENSION_DIR, 'package.json');
+}
 
 // --- Types ---
 
@@ -75,17 +83,25 @@ function checkFailed(name: string, e: unknown): AddonStatus {
   return { text: `${name} check failed: ${(e as Error).message}`, level: 'warning' };
 }
 
-// Single error-handling source for the three probes; messages unchanged.
 function runCheck(name: string, probe: () => Promise<string>): Promise<AddonStatus> {
   return probe().then((text) => ({ text, level: 'info' as const }), (e) => checkFailed(name, e));
 }
 
-// Check: no mutation. Probes run concurrently via checkAddons below.
+// A missing file is "not installed"; an unreadable one is a reportable fault.
+function parsePackageVersion(raw: string | null): string | null {
+  if (!raw) return null;
+  try {
+    return (JSON.parse(raw) as { version?: string }).version ?? null;
+  } catch {
+    throw new Error('ponytail package.json is not readable JSON');
+  }
+}
+
 function checkPonytail(): Promise<AddonStatus> {
   return runCheck('Ponytail', async () => {
     const remoteJson = await fetchJson<{ version?: string }>(PONYTAIL_REMOTE);
-    const localRaw = await readTextIfExists(PONYTAIL_LOCAL);
-    const localVer = localRaw ? (JSON.parse(localRaw) as { version?: string }).version ?? null : null;
+    const localRaw = await readTextIfExists(ponytailLocal() ?? '');
+    const localVer = parsePackageVersion(localRaw);
     const remoteVer = remoteJson.version;
     const status = !localVer ? 'not installed'
       : localVer === remoteVer ? 'up to date'
@@ -104,6 +120,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; }
@@ -164,12 +181,10 @@ async function checkAddons(ctx: AddonUpdaterCtx): Promise<string> {
 }
 
 async function updatePonytail(pi: AddonUpdaterPi, ctx: AddonUpdaterCtx, dryRun = false): Promise<string> {
-  // Bundled with tersio: no separate package to refresh. `tersio update`
-  // pulls the bundled copy with the CLI.
+  // Bundled with tersio: `tersio update` pulls the copy with the CLI.
   let localVer: string | null = null;
   try {
-    const raw = await readTextIfExists(PONYTAIL_LOCAL);
-    if (raw) localVer = (JSON.parse(raw) as { version?: string }).version ?? null;
+    localVer = parsePackageVersion(await readTextIfExists(ponytailLocal() ?? ''));
   } catch { localVer = null; }
   void pi;
   const m = dryRun
@@ -188,8 +203,8 @@ 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;
   const ARCH = process.arch;
   const spec = rtkPlatformSpec(PLATFORM, ARCH);
@@ -222,7 +237,6 @@ async function updateRtk(ctx: AddonUpdaterCtx, dryRun = false): Promise<string>
       httpsDownload(asset.browser_download_url, archivePath),
       httpsDownload(checksAsset.browser_download_url, checksPath),
     ]);
-    // Verify SHA256 against checksums.txt
     const checks = await fs.readFile(checksPath, 'utf8');
     const expected = parseChecksum(checks, asset.name);
     if (!expected) {
@@ -237,7 +251,6 @@ async function updateRtk(ctx: AddonUpdaterCtx, dryRun = false): Promise<string>
     }
     notify(ctx, 'RTK: checksum verified.', 'info');
 
-    // Extract by archive format
     const extractDir = path.join(tmp, 'extracted');
     await fs.mkdir(extractDir, { recursive: true });
 
@@ -269,7 +282,6 @@ async function updateRtk(ctx: AddonUpdaterCtx, dryRun = false): Promise<string>
 
     await fs.copyFile(rtkExtracted, RTK_BINARY);
 
-    // Set executable bit on Unix
     if (!IS_WINDOWS) {
       await fs.chmod(RTK_BINARY, 0o755);
     }
@@ -331,7 +343,7 @@ async function updateCaveman(ctx: AddonUpdaterCtx, dryRun = false): Promise<stri
 }
 
 export default function aiAddonsUpdaterExtension(pi: AddonUpdaterPi): void {
-  pi.setLabel?.('AI add-ons updater');
+  setExtensionLabel(pi, 'AI add-ons updater');
 
   pi.registerCommand?.('ai-addons', {
     description: 'Check or update AI add-ons (ponytail/rtk/caveman/all). Usage: /ai-addons <check|status|update ponytail|rtk|caveman|all> [--dry-run]',

package/extensions/caveman-session/index.js

@@ -1,20 +1,25 @@
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
-import { activeModesSummary, asPromptArray, getSharedComboState, isComboPresetActive, isOmpSubagentPrompt, lastCustomValue, normalizeInputCommand, normalizeMode, paintStatusBar, paintableCtx, reconcileSharedComboEntries, sessionEntries, setSharedComboListener, setSharedComboMode } from '../shared/session-state.js';
+import { activeModesSummary, getSharedComboState, isComboPresetActive, isOmpSubagentPrompt, lastCustomValue, normalizeInputCommand, normalizeMode, paintStatusBar, paintableCtx, reconcileSharedComboEntries, sessionEntries, setSharedComboListener, setSharedComboMode } from '../shared/session-state.js';
 import { dirname, join } from 'node:path';
+import { injectPromptText, onHostEvent, setExtensionLabel } from '../shared/host.js';
 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 +35,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;
@@ -72,7 +78,7 @@ export default function cavemanSessionExtension(pi) {
         ctx?.ui?.notify?.(msg, 'info');
         return true;
     }
-    pi.setLabel?.('Caveman session toggle');
+    setExtensionLabel(pi, 'Caveman session toggle');
     // Live mirror: a /tersio or /combo switch publishes shared state — adopt
     // it at once so the next turn injects the new mode with no session reload.
     // Stable identity, so the bridge set dedupes across re-inits.
@@ -97,11 +103,11 @@ 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');
             }
         },
     });
-    pi.on('input', async (event) => {
+    onHostEvent(pi, 'input', async (event) => {
         if (event?.source === 'extension')
             return;
         if (currentMode !== 'off' && isOffCommand(event?.text))
@@ -117,14 +123,14 @@ 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) => {
         restoreMode(ctx);
         ctx?.ui?.notify?.(`Caveman loaded: ${currentMode}`, 'info');
     });
-    pi.on('session_branch', async (_event, ctx) => {
+    onHostEvent(pi, 'session_branch', async (_event, ctx) => {
         restoreMode(ctx);
     });
     pi.on('session_tree', async (_event, ctx) => {
@@ -146,7 +152,6 @@ export default function cavemanSessionExtension(pi) {
         if (!def)
             return;
         const instruction = typeof def === 'function' ? def() : def;
-        const base = asPromptArray(event.systemPrompt);
-        return { systemPrompt: [...base, instruction] };
+        return injectPromptText(pi, event, instruction);
     });
 }

package/extensions/caveman-session/index.ts

@@ -1,23 +1,28 @@
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
-import { activeModesSummary, asPromptArray, getSharedComboState, isComboPresetActive, isOmpSubagentPrompt, lastCustomValue, normalizeInputCommand, normalizeMode, paintStatusBar, paintableCtx, reconcileSharedComboEntries, sessionEntries, setSharedComboListener, setSharedComboMode } from '../shared/session-state.ts';
+import { activeModesSummary, getSharedComboState, isComboPresetActive, isOmpSubagentPrompt, lastCustomValue, normalizeInputCommand, normalizeMode, paintStatusBar, paintableCtx, reconcileSharedComboEntries, sessionEntries, setSharedComboListener, setSharedComboMode } from '../shared/session-state.ts';
 import { dirname, join } from 'node:path';
+import { injectPromptText, onHostEvent, setExtensionLabel } from '../shared/host.ts';
 import { readCavemanDefault } from '../shared/plugin-settings.ts';
 import type { ExtensionApi, ExtensionCtx, InputEvent, SessionEntry, SystemPromptEvent } from '../shared/types.ts';
 
 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 +35,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 {
@@ -76,7 +82,7 @@ export default function cavemanSessionExtension(pi: ExtensionApi): void {
     return true;
   }
 
-  pi.setLabel?.('Caveman session toggle');
+  setExtensionLabel(pi, 'Caveman session toggle');
 
   // Live mirror: a /tersio or /combo switch publishes shared state — adopt
   // it at once so the next turn injects the new mode with no session reload.
@@ -102,12 +108,12 @@ 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');
       }
     },
   });
 
-  pi.on<InputEvent>('input', async (event) => {
+  onHostEvent<InputEvent>(pi, 'input', async (event) => {
     if (event?.source === 'extension') return;
     if (currentMode !== 'off' && isOffCommand(event?.text)) setMode('off');
   });
@@ -122,7 +128,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);
   }
 
@@ -131,7 +137,7 @@ export default function cavemanSessionExtension(pi: ExtensionApi): void {
     ctx?.ui?.notify?.(`Caveman loaded: ${currentMode}`, 'info');
   });
 
-  pi.on('session_branch', async (_event, ctx) => {
+  onHostEvent(pi, 'session_branch', async (_event, ctx) => {
     restoreMode(ctx);
   });
 
@@ -155,7 +161,6 @@ export default function cavemanSessionExtension(pi: ExtensionApi): void {
     const def = INSTRUCTIONS[mode];
     if (!def) return;
     const instruction = typeof def === 'function' ? def() : def;
-    const base = asPromptArray(event.systemPrompt);
-    return { systemPrompt: [...base, instruction] };
+    return injectPromptText(pi, event, instruction);
   });
 }

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.