@krtclcdy/tersio 2.1.0 → 2.2.0

package/README.md

@@ -11,6 +11,12 @@ Terse replies, compact shell output, and minimal code decisions for [Oh My Pi (O
 
 ## Install
 
+Quick install (macOS/Linux/WSL — checks npm, then bootstraps the CLI):
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/KurutoDenzeru/tersio/main/install.sh | sh
+```
+
 OMP plugin (recommended — updates and feature flags handled by OMP):
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krtclcdy/tersio",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "✂️ Token-saving OMP add-ons: terse Caveman replies, compact RTK shell output, lean Ponytail code calls — one-command combo presets.",
   "keywords": [
     "omp",

package/tersio.js

@@ -680,7 +680,7 @@ async function runDoctor() {
     const modeReinforcement = path.join(extDir, 'shared', 'mode-reinforcement.js');
     const selfPkg = path.join(pluginsDir, 'node_modules', PACKAGE_NAME, 'package.json');
     // Independent probes run concurrently; logs below keep fixed order.
-    const [ompVersion, agentEntries, extEntries, sharedStateText, configText, ponytailPkgText, ponytailExtText, pluginsPkgRaw, selfPkgText, rtkBinText, cavemanIndexText, cavemanRuleText, rtkIndexText, updaterIndexText, comboIndexText, modeReinforcementText,] = await Promise.all([
+    const [ompVersion, agentEntries, extEntries, sharedStateText, configText, ponytailPkgText, ponytailExtText, pluginsPkgRaw, selfPkgText, rtkBinText, cavemanIndexText, cavemanRuleText, rtkIndexText, updaterIndexText, comboIndexText, modeReinforcementText, ruleMtime, rtkMtime, ponytailMtime, updateVersion,] = await Promise.all([
         execP(OMP_BIN, ['--version']).then((r) => r.stdout.trim(), () => null),
         fs.readdir(agentDir).catch(() => null),
         fs.readdir(extDir).catch(() => null),
@@ -697,6 +697,10 @@ async function runDoctor() {
         readTextIfExists(updaterIndex),
         readTextIfExists(comboIndex),
         readTextIfExists(modeReinforcement),
+        fs.stat(cavemanRule).catch(() => null),
+        fs.stat(rtkBin).catch(() => null),
+        fs.stat(ponytailPkg).catch(() => null),
+        checkForUpdate(),
     ]);
     // Categorized output with a tally; section headers group related probes.
     const tally = { ok: 0, missing: 0, warn: 0 };
@@ -717,6 +721,10 @@ async function runDoctor() {
     section('Environment');
     check('Node', true, process.version);
     check('OMP CLI', ompVersion !== null, ompVersion ?? '');
+    if (updateVersion)
+        warnLine('Tersio CLI', `${updateVersion} available — run tersio update`);
+    else
+        check('Tersio CLI', true, PACKAGE_VERSION);
     console.log(`  Home: ${HOME}`);
     section('Installation');
     check('OMP agent dir', agentEntries !== null, agentDir);
@@ -725,7 +733,6 @@ async function runDoctor() {
     check('Shared session bridge', sharedStateText !== null);
     section('Extensions');
     check('Caveman extension', cavemanIndexText !== null);
-    check('Caveman rule.md', cavemanRuleText !== null);
     check('RTK extension', rtkIndexText !== null);
     check('Updater extension', updaterIndexText !== null);
     check('Combo extension', comboIndexText !== null);
@@ -737,22 +744,27 @@ async function runDoctor() {
         check('Ponytail in config.yml', configText.includes('ponytail') && configText.includes('pi-extension'));
         check('Combo in config.yml', configText.includes('combo-toggle'));
     }
-    check('Self plugin package', selfPkgText !== null);
+    check('Self plugin package', selfPkgText !== null, parseJsonObject(selfPkgText)?.version ?? '');
     const selfDep = PACKAGE_NAME in (parseJsonObject(pluginsPkgRaw)?.dependencies || {});
     check('Self plugin in plugins/package.json', selfDep);
-    section('RTK');
-    check('RTK binary', rtkBinText !== null, rtkBin);
-    if (rtkBinText !== null) {
-        // rtk may exit non-zero while still printing its version — accept either stream.
-        const version = await execP(rtkBin, ['--version'], { timeout: 5000 }).then((r) => r.stdout.trim() || r.stderr.trim() || null, (e) => {
-            const err = e;
-            return err.stdout?.trim() || err.stderr?.trim() || null;
-        });
-        if (version)
-            check('RTK version', true, version);
-        else
+    section('Add-ons');
+    const ruleAge = ruleMtime ? `updated ${relTime(Date.now() - ruleMtime.mtimeMs)}` : '';
+    check('Caveman rule', cavemanRuleText !== null, ruleAge);
+    const rtkVersion = rtkBinText === null ? null : await execP(rtkBin, ['--version'], { timeout: 5000 }).then((r) => r.stdout.trim() || r.stderr.trim() || null, (e) => {
+        const err = e;
+        return err.stdout?.trim() || err.stderr?.trim() || null;
+    });
+    const rtkAge = rtkMtime ? `updated ${relTime(Date.now() - rtkMtime.mtimeMs)}` : '';
+    if (rtkBinText === null)
+        check('RTK binary', false, rtkBin);
+    else {
+        const bits = [rtkVersion, rtkAge].filter(Boolean).join(', ');
+        check('RTK binary', true, bits);
+        if (!rtkVersion)
             warnLine('RTK version', 'unavailable — binary may not be executable');
     }
+    const ponytailAge = ponytailMtime ? `updated ${relTime(Date.now() - ponytailMtime.mtimeMs)}` : '';
+    check('Ponytail', ponytailPkgText !== null, [parseJsonObject(ponytailPkgText)?.version ?? '', ponytailAge].filter(Boolean).join(', '));
     const total = tally.ok + tally.missing + tally.warn;
     console.log(`\n  Summary: ${total} checks — ${tally.ok} ok, ${tally.warn} warn, ${tally.missing} missing`);
 }
@@ -907,6 +919,66 @@ async function runUninstall(options = {}) {
 }
 const SCOPE_MAP = { user: '1', project: '2', both: '3' };
 const COMBO_MENU = { '1': 'off', '2': 'medium', '3': 'balanced', '4': 'max' };
+// --- Update check (cached; used by the bare-invocation banner and doctor) ---
+const UPDATE_CHECK_TTL_MS = 6 * 60 * 60 * 1000;
+function newerThan(a, b) {
+    const pa = a.replace(/^v/, '').split('.').map((n) => parseInt(n, 10) || 0);
+    const pb = b.replace(/^v/, '').split('.').map((n) => parseInt(n, 10) || 0);
+    for (let i = 0; i < 3; i++) {
+        if ((pa[i] || 0) !== (pb[i] || 0))
+            return (pa[i] || 0) > (pb[i] || 0);
+    }
+    return false;
+}
+async function latestPublishedVersion() {
+    try {
+        const args = IS_WINDOWS
+            ? ['/d', '/s', '/c', 'npm', 'view', PACKAGE_NAME, 'version', '--prefer-online']
+            : ['view', PACKAGE_NAME, 'version', '--prefer-online'];
+        const r = await execP(IS_WINDOWS ? process.env.ComSpec || 'cmd.exe' : 'npm', args, {
+            timeout: 4000,
+            maxBuffer: 1024 * 1024,
+            windowsHide: true,
+            shell: false,
+        });
+        return r.stdout.trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+// Returns a newer published version, or null. Reads the registry at most once
+// per TTL (cached under OMP_PLUGINS_DIR) and stays silent on failure.
+async function checkForUpdate() {
+    const cachePath = path.join(OMP_PLUGINS_DIR, 'tersio-update-check.json');
+    const cached = parseJsonObject(await readTextIfExists(cachePath));
+    const cacheFresh = typeof cached?.lastCheck === 'number' && Date.now() - cached.lastCheck < UPDATE_CHECK_TTL_MS;
+    if (cacheFresh && cached?.latest)
+        return newerThan(cached.latest, PACKAGE_VERSION) ? cached.latest : null;
+    const latest = await latestPublishedVersion();
+    if (latest) {
+        await fs.mkdir(OMP_PLUGINS_DIR, { recursive: true }).catch(() => { });
+        await fs.writeFile(cachePath, JSON.stringify({ latest, lastCheck: Date.now() }) + '\n', 'utf8').catch(() => { });
+        return newerThan(latest, PACKAGE_VERSION) ? latest : null;
+    }
+    // Registry unreachable: fall back to a stale cache rather than staying silent.
+    return cached?.latest && newerThan(cached.latest, PACKAGE_VERSION) ? cached.latest : null;
+}
+function relTime(ageMs) {
+    const mins = Math.floor(ageMs / 60000);
+    if (mins < 1)
+        return 'just now';
+    if (mins < 60)
+        return `${mins} min${mins === 1 ? '' : 's'} ago`;
+    const hours = Math.floor(mins / 60);
+    if (hours < 24)
+        return `${hours} hour${hours === 1 ? '' : 's'} ago`;
+    const days = Math.floor(hours / 24);
+    if (days < 14)
+        return `${days} day${days === 1 ? '' : 's'} ago`;
+    const weeks = Math.floor(days / 7);
+    return `${weeks} week${weeks === 1 ? '' : 's'} ago`;
+}
 async function runLatestUpdate() {
     const updateScope = scopeFlag || 'user';
     if (!Object.hasOwn(SCOPE_MAP, updateScope)) {
@@ -1163,6 +1235,13 @@ async function main() {
     console.log(`  Platform: ${process.platform}`);
     console.log(`  Arch: ${process.arch}`);
     console.log(`  Home: ${HOME}`);
+    // Remind humans a newer release exists; silent for scripts (no TTY) and for
+    // the apply-update payload, which is itself an update run.
+    if (tty() && !applyUpdate && command !== 'uninstall') {
+        const newer = await checkForUpdate();
+        if (newer)
+            console.log(`\n  [update] tersio ${newer} available (installed ${PACKAGE_VERSION}) — run \`tersio update\``);
+    }
     const scope = await resolveScope();
     // Resolve session defaults: flags > interactive prompt > defaults.
     const profile = await resolveProfile();