shennian 0.2.89 → 0.2.90

package/dist/src/upgrade/engine.js

@@ -1,347 +1,3 @@
-// @arch docs/architecture/cli/upgrade.md
-import fs from 'node:fs';
-import path from 'node:path';
-import { execSync, exec as execCb } from 'node:child_process';
-import { promisify } from 'node:util';
-import { fileURLToPath } from 'node:url';
-import { getShennianDir, resolveShennianPath } from '../config/index.js';
-const exec = promisify(execCb);
-const BACKUP_DIR = resolveShennianPath('backup');
-const UPGRADE_ATTEMPT_FILE = resolveShennianPath('upgrade-attempt.json');
-const MAX_CRASH_COUNT = 3;
-const BACKUP_TTL_DAYS = 7;
-const NPM_REGISTRY_FALLBACK = 'https://registry.npmjs.org';
-const RETRY_DELAYS_MS = [
-    5 * 60_000,
-    30 * 60_000,
-    2 * 60 * 60_000,
-    6 * 60 * 60_000,
-];
-// ─── Version helpers ─────────────────────────────────────────────────────────
-export function getCurrentVersion() {
-    try {
-        const pkgPath = findPackageJson();
-        if (pkgPath) {
-            const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
-            return pkg.version;
-        }
-    }
-    catch { /* noop */ }
-    return '0.0.0';
-}
-export function findPackageJson(startFilePath = fileURLToPath(import.meta.url)) {
-    // Walk up from this file's location to find package.json
-    let dir = path.dirname(startFilePath);
-    for (let i = 0; i < 6; i++) {
-        const candidate = path.join(dir, 'package.json');
-        if (fs.existsSync(candidate)) {
-            const pkg = JSON.parse(fs.readFileSync(candidate, 'utf-8'));
-            if (pkg.name === 'shennian')
-                return candidate;
-        }
-        dir = path.dirname(dir);
-    }
-    return null;
-}
-export async function fetchLatestVersion() {
-    const res = await fetch('https://registry.npmjs.org/shennian/latest', {
-        headers: { Accept: 'application/json' },
-        signal: AbortSignal.timeout(10_000),
-    });
-    if (!res.ok)
-        throw new Error(`npm registry returned ${res.status}`);
-    const data = (await res.json());
-    return data.version;
-}
-/**
- * Compare semver strings. Returns:
- *   'none'  — same or older
- *   'patch' — only patch differs
- *   'minor' — minor or patch differs
- *   'major' — major differs
- */
-export function compareVersions(current, latest) {
-    const parse = (v) => v.replace(/^v/, '').split('.').map(Number);
-    const [cMaj, cMin, cPat] = parse(current);
-    const [lMaj, lMin, lPat] = parse(latest);
-    if (lMaj > cMaj)
-        return 'major';
-    if (lMaj === cMaj && lMin > cMin)
-        return 'minor';
-    if (lMaj === cMaj && lMin === cMin && lPat > cPat)
-        return 'patch';
-    return 'none';
-}
-// ─── npm global path helpers ──────────────────────────────────────────────────
-function getNpmGlobalRoot() {
-    return execSync('npm root -g', { encoding: 'utf-8', stdio: 'pipe', windowsHide: true }).trim();
-}
-function getGlobalPkgDir() {
-    return path.join(getNpmGlobalRoot(), 'shennian');
-}
-function getGlobalBinScript() {
-    const root = getNpmGlobalRoot();
-    return path.join(root, 'shennian', 'dist', 'bin', 'shennian.js');
-}
-// ─── Backup / Restore ─────────────────────────────────────────────────────────
-function backupVersion(version) {
-    const pkgDir = getGlobalPkgDir();
-    const dest = path.join(BACKUP_DIR, version);
-    fs.rmSync(dest, { recursive: true, force: true });
-    fs.mkdirSync(dest, { recursive: true });
-    copyPackageRuntimeFiles(pkgDir, dest);
-}
-function restoreVersion(version) {
-    const src = path.join(BACKUP_DIR, version);
-    if (!fs.existsSync(src))
-        throw new Error(`Backup for ${version} not found`);
-    const pkgDir = getGlobalPkgDir();
-    fs.cpSync(src, pkgDir, { recursive: true, force: true });
-}
-export function copyPackageRuntimeFiles(src, dest) {
-    for (const entry of ['package.json', 'README.md', 'dist']) {
-        const from = path.join(src, entry);
-        if (!fs.existsSync(from))
-            continue;
-        fs.cpSync(from, path.join(dest, entry), { recursive: true, force: true });
-    }
-}
-function cleanOldBackups() {
-    try {
-        if (!fs.existsSync(BACKUP_DIR))
-            return;
-        const cutoff = Date.now() - BACKUP_TTL_DAYS * 86400_000;
-        for (const entry of fs.readdirSync(BACKUP_DIR)) {
-            const full = path.join(BACKUP_DIR, entry);
-            const stat = fs.statSync(full);
-            if (stat.mtimeMs < cutoff) {
-                fs.rmSync(full, { recursive: true, force: true });
-            }
-        }
-    }
-    catch { /* noop */ }
-}
-// ─── Upgrade attempt tracking (crash detection) ───────────────────────────────
-export function readUpgradeAttempt() {
-    try {
-        return JSON.parse(fs.readFileSync(UPGRADE_ATTEMPT_FILE, 'utf-8'));
-    }
-    catch {
-        return null;
-    }
-}
-export function writeUpgradeAttempt(attempt) {
-    fs.mkdirSync(getShennianDir(), { recursive: true });
-    fs.writeFileSync(UPGRADE_ATTEMPT_FILE, JSON.stringify(attempt, null, 2));
-}
-export function clearUpgradeAttempt() {
-    try {
-        fs.unlinkSync(UPGRADE_ATTEMPT_FILE);
-    }
-    catch { /* noop */ }
-}
-function getUpgradeFailuresFile() {
-    return resolveShennianPath('upgrade-failures.json');
-}
-export function readUpgradeFailures(filePath = getUpgradeFailuresFile()) {
-    try {
-        const parsed = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
-        if (!parsed || typeof parsed !== 'object' || !parsed.versions)
-            return { versions: {} };
-        return { versions: parsed.versions };
-    }
-    catch {
-        return { versions: {} };
-    }
-}
-function writeUpgradeFailures(failures) {
-    fs.mkdirSync(getShennianDir(), { recursive: true });
-    fs.writeFileSync(getUpgradeFailuresFile(), JSON.stringify(failures, null, 2));
-}
-export function getUpgradeRetryDelayMs(failureCount) {
-    return RETRY_DELAYS_MS[Math.min(Math.max(failureCount - 1, 0), RETRY_DELAYS_MS.length - 1)];
-}
-export function isUpgradeVersionInCooldown(version, now = Date.now(), failures = readUpgradeFailures()) {
-    const record = failures.versions[version];
-    return Boolean(record && record.nextRetryAt > now);
-}
-export function recordUpgradeFailure(version, error, now = Date.now()) {
-    const failures = readUpgradeFailures();
-    const previous = failures.versions[version];
-    const failureCount = (previous?.failureCount ?? 0) + 1;
-    const record = {
-        version,
-        failureCount,
-        firstFailedAt: previous?.firstFailedAt ?? now,
-        lastFailedAt: now,
-        nextRetryAt: now + getUpgradeRetryDelayMs(failureCount),
-        error,
-    };
-    failures.versions[version] = record;
-    writeUpgradeFailures(failures);
-    return record;
-}
-export function clearUpgradeFailure(version) {
-    const failures = readUpgradeFailures();
-    if (!failures.versions[version])
-        return;
-    delete failures.versions[version];
-    writeUpgradeFailures(failures);
-}
-/**
- * Called on daemon startup. Detects crash loops from a failed upgrade and
- * initiates rollback if crash count exceeds threshold.
- * Returns true if rollback was performed (caller should exit and let service manager restart).
- */
-export async function handleStartupCrashCheck() {
-    const attempt = readUpgradeAttempt();
-    if (!attempt)
-        return false;
-    const elapsed = Date.now() - attempt.attemptAt;
-    // If more than 10 minutes have passed, this is a stale record — clear and continue
-    if (elapsed > 10 * 60 * 1000) {
-        clearUpgradeAttempt();
-        return false;
-    }
-    attempt.attemptCount++;
-    if (attempt.attemptCount >= MAX_CRASH_COUNT) {
-        console.error(`[upgrade] New version crashed ${attempt.attemptCount} times, rolling back to ${attempt.from}...`);
-        try {
-            restoreVersion(attempt.from);
-            clearUpgradeAttempt();
-            console.error(`[upgrade] Rolled back to ${attempt.from}. Restarting...`);
-            return true;
-        }
-        catch (err) {
-            console.error(`[upgrade] Rollback failed: ${err instanceof Error ? err.message : String(err)}`);
-            clearUpgradeAttempt();
-            return false;
-        }
-    }
-    writeUpgradeAttempt(attempt);
-    return false;
-}
-// ─── Core upgrade ─────────────────────────────────────────────────────────────
-export async function performUpgrade(targetVersion, onProgress, opts = {}) {
-    const currentVersion = opts.currentVersion ?? getCurrentVersion();
-    const installedVersion = getCurrentVersion();
-    if (currentVersion === targetVersion) {
-        clearUpgradeFailure(targetVersion);
-        return { ok: false, error: `Already on version ${targetVersion}` };
-    }
-    // Step 1: Verify npm is accessible
-    onProgress({ step: 'checking' });
-    try {
-        execSync('npm --version', { stdio: 'pipe', windowsHide: true });
-    }
-    catch {
-        return { ok: false, error: 'npm is not available in PATH' };
-    }
-    if (installedVersion === targetVersion) {
-        onProgress({ step: 'verifying', version: targetVersion });
-        try {
-            const binScript = getGlobalBinScript();
-            const { stdout } = await exec(`node "${binScript}" --version`, { timeout: 10_000, windowsHide: true });
-            if (!stdout.trim())
-                throw new Error('Empty output from --version check');
-        }
-        catch (err) {
-            return {
-                ok: false,
-                error: `Smoke test failed: ${err instanceof Error ? err.message : String(err)}`,
-            };
-        }
-        writeUpgradeAttempt({
-            from: currentVersion,
-            to: targetVersion,
-            attemptCount: 0,
-            attemptAt: Date.now(),
-        });
-        clearUpgradeFailure(targetVersion);
-        onProgress({ step: 'restarting', from: currentVersion, to: targetVersion });
-        return { ok: true, from: currentVersion, to: targetVersion };
-    }
-    // Step 2: Backup current version
-    onProgress({ step: 'backing-up' });
-    try {
-        fs.mkdirSync(BACKUP_DIR, { recursive: true });
-        backupVersion(currentVersion);
-    }
-    catch (err) {
-        return { ok: false, error: `Backup failed: ${err instanceof Error ? err.message : String(err)}` };
-    }
-    // Step 3: npm install new version
-    onProgress({ step: 'installing', version: targetVersion });
-    try {
-        await installShennianVersion(targetVersion);
-    }
-    catch (err) {
-        // Restore backup and abort
-        try {
-            restoreVersion(currentVersion);
-        }
-        catch { /* best effort */ }
-        return {
-            ok: false,
-            error: `npm install failed: ${err instanceof Error ? err.message : String(err)}`,
-            rolledBack: true,
-        };
-    }
-    // Step 4: Smoke test — verify the new binary works
-    onProgress({ step: 'verifying', version: targetVersion });
-    try {
-        const binScript = getGlobalBinScript();
-        const { stdout } = await exec(`node "${binScript}" --version`, { timeout: 10_000, windowsHide: true });
-        if (!stdout.trim())
-            throw new Error('Empty output from --version check');
-    }
-    catch (err) {
-        try {
-            restoreVersion(currentVersion);
-        }
-        catch { /* best effort */ }
-        return {
-            ok: false,
-            error: `Smoke test failed: ${err instanceof Error ? err.message : String(err)}`,
-            rolledBack: true,
-        };
-    }
-    // Step 5: Write upgrade attempt file (crash detection on restart)
-    writeUpgradeAttempt({
-        from: currentVersion,
-        to: targetVersion,
-        attemptCount: 0,
-        attemptAt: Date.now(),
-    });
-    cleanOldBackups();
-    clearUpgradeFailure(targetVersion);
-    // Step 6: Signal restart (caller sends upgrade.status: restarting before killing)
-    onProgress({ step: 'restarting', from: currentVersion, to: targetVersion });
-    return { ok: true, from: currentVersion, to: targetVersion };
-}
-async function installShennianVersion(targetVersion) {
-    try {
-        await exec(`npm install -g shennian@${targetVersion}`, { timeout: 120_000, windowsHide: true });
-    }
-    catch (error) {
-        const firstMessage = error instanceof Error ? error.message : String(error);
-        try {
-            await exec(`npm install -g shennian@${targetVersion} --registry ${NPM_REGISTRY_FALLBACK}`, {
-                timeout: 120_000,
-                windowsHide: true,
-            });
-        }
-        catch (fallbackError) {
-            const secondMessage = fallbackError instanceof Error ? fallbackError.message : String(fallbackError);
-            throw new Error(`${firstMessage}\n--- npmjs fallback ---\n${secondMessage}`);
-        }
-    }
-}
-export async function checkForUpdate(currentVersion) {
-    const current = currentVersion ?? getCurrentVersion();
-    const latest = await fetchLatestVersion();
-    const changeType = compareVersions(current, latest);
-    if (changeType === 'none')
-        return { hasUpdate: false };
-    return { hasUpdate: true, current, latest, changeType };
-}
+import i from"node:fs";import c from"node:path";import{execSync as w,exec as $}from"node:child_process";import{promisify as C}from"node:util";import{fileURLToPath as R}from"node:url";import{getShennianDir as v,resolveShennianPath as p}from"../config/index.js";const f=C($),u=p("backup"),l=p("upgrade-attempt.json"),D=3,M=7,N="https://registry.npmjs.org",x=[5*6e4,30*6e4,120*6e4,360*6e4];function m(){try{const t=T();if(t)return JSON.parse(i.readFileSync(t,"utf-8")).version}catch{}return"0.0.0"}function T(t=R(import.meta.url)){let r=c.dirname(t);for(let n=0;n<6;n++){const e=c.join(r,"package.json");if(i.existsSync(e)&&JSON.parse(i.readFileSync(e,"utf-8")).name==="shennian")return e;r=c.dirname(r)}return null}async function B(){const t=await fetch("https://registry.npmjs.org/shennian/latest",{headers:{Accept:"application/json"},signal:AbortSignal.timeout(1e4)});if(!t.ok)throw new Error(`npm registry returned ${t.status}`);return(await t.json()).version}function H(t,r){const n=U=>U.replace(/^v/,"").split(".").map(Number),[e,s,o]=n(t),[a,k,F]=n(r);return a>e?"major":a===e&&k>s?"minor":a===e&&k===s&&F>o?"patch":"none"}function A(){return w("npm root -g",{encoding:"utf-8",stdio:"pipe",windowsHide:!0}).trim()}function E(){return c.join(A(),"shennian")}function j(){const t=A();return c.join(t,"shennian","dist","bin","shennian.js")}function O(t){const r=E(),n=c.join(u,t);i.rmSync(n,{recursive:!0,force:!0}),i.mkdirSync(n,{recursive:!0}),P(r,n)}function d(t){const r=c.join(u,t);if(!i.existsSync(r))throw new Error(`Backup for ${t} not found`);const n=E();i.cpSync(r,n,{recursive:!0,force:!0})}function P(t,r){for(const n of["package.json","README.md","dist"]){const e=c.join(t,n);i.existsSync(e)&&i.cpSync(e,c.join(r,n),{recursive:!0,force:!0})}}function J(){try{if(!i.existsSync(u))return;const t=Date.now()-M*864e5;for(const r of i.readdirSync(u)){const n=c.join(u,r);i.statSync(n).mtimeMs<t&&i.rmSync(n,{recursive:!0,force:!0})}}catch{}}function L(){try{return JSON.parse(i.readFileSync(l,"utf-8"))}catch{return null}}function y(t){i.mkdirSync(v(),{recursive:!0}),i.writeFileSync(l,JSON.stringify(t,null,2))}function g(){try{i.unlinkSync(l)}catch{}}function _(){return p("upgrade-failures.json")}function h(t=_()){try{const r=JSON.parse(i.readFileSync(t,"utf-8"));return!r||typeof r!="object"||!r.versions?{versions:{}}:{versions:r.versions}}catch{return{versions:{}}}}function b(t){i.mkdirSync(v(),{recursive:!0}),i.writeFileSync(_(),JSON.stringify(t,null,2))}function G(t){return x[Math.min(Math.max(t-1,0),x.length-1)]}function W(t,r=Date.now(),n=h()){const e=n.versions[t];return!!(e&&e.nextRetryAt>r)}function Z(t,r,n=Date.now()){const e=h(),s=e.versions[t],o=(s?.failureCount??0)+1,a={version:t,failureCount:o,firstFailedAt:s?.firstFailedAt??n,lastFailedAt:n,nextRetryAt:n+G(o),error:r};return e.versions[t]=a,b(e),a}function S(t){const r=h();r.versions[t]&&(delete r.versions[t],b(r))}async function V(){const t=L();if(!t)return!1;if(Date.now()-t.attemptAt>600*1e3)return g(),!1;if(t.attemptCount++,t.attemptCount>=D){console.error(`[upgrade] New version crashed ${t.attemptCount} times, rolling back to ${t.from}...`);try{return d(t.from),g(),console.error(`[upgrade] Rolled back to ${t.from}. Restarting...`),!0}catch(n){return console.error(`[upgrade] Rollback failed: ${n instanceof Error?n.message:String(n)}`),g(),!1}}return y(t),!1}async function tt(t,r,n={}){const e=n.currentVersion??m(),s=m();if(e===t)return S(t),{ok:!1,error:`Already on version ${t}`};r({step:"checking"});try{w("npm --version",{stdio:"pipe",windowsHide:!0})}catch{return{ok:!1,error:"npm is not available in PATH"}}if(s===t){r({step:"verifying",version:t});try{const o=j(),{stdout:a}=await f(`node "${o}" --version`,{timeout:1e4,windowsHide:!0});if(!a.trim())throw new Error("Empty output from --version check")}catch(o){return{ok:!1,error:`Smoke test failed: ${o instanceof Error?o.message:String(o)}`}}return y({from:e,to:t,attemptCount:0,attemptAt:Date.now()}),S(t),r({step:"restarting",from:e,to:t}),{ok:!0,from:e,to:t}}r({step:"backing-up"});try{i.mkdirSync(u,{recursive:!0}),O(e)}catch(o){return{ok:!1,error:`Backup failed: ${o instanceof Error?o.message:String(o)}`}}r({step:"installing",version:t});try{await I(t)}catch(o){try{d(e)}catch{}return{ok:!1,error:`npm install failed: ${o instanceof Error?o.message:String(o)}`,rolledBack:!0}}r({step:"verifying",version:t});try{const o=j(),{stdout:a}=await f(`node "${o}" --version`,{timeout:1e4,windowsHide:!0});if(!a.trim())throw new Error("Empty output from --version check")}catch(o){try{d(e)}catch{}return{ok:!1,error:`Smoke test failed: ${o instanceof Error?o.message:String(o)}`,rolledBack:!0}}return y({from:e,to:t,attemptCount:0,attemptAt:Date.now()}),J(),S(t),r({step:"restarting",from:e,to:t}),{ok:!0,from:e,to:t}}async function I(t){try{await f(`npm install -g shennian@${t}`,{timeout:12e4,windowsHide:!0})}catch(r){const n=r instanceof Error?r.message:String(r);try{await f(`npm install -g shennian@${t} --registry ${N}`,{timeout:12e4,windowsHide:!0})}catch(e){const s=e instanceof Error?e.message:String(e);throw new Error(`${n}
+--- npmjs fallback ---
+${s}`)}}}async function rt(t){const r=t??m(),n=await B(),e=H(r,n);return e==="none"?{hasUpdate:!1}:{hasUpdate:!0,current:r,latest:n,changeType:e}}export{rt as checkForUpdate,g as clearUpgradeAttempt,S as clearUpgradeFailure,H as compareVersions,P as copyPackageRuntimeFiles,B as fetchLatestVersion,T as findPackageJson,m as getCurrentVersion,G as getUpgradeRetryDelayMs,V as handleStartupCrashCheck,W as isUpgradeVersionInCooldown,tt as performUpgrade,L as readUpgradeAttempt,h as readUpgradeFailures,Z as recordUpgradeFailure,y as writeUpgradeAttempt};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shennian",
-  "version": "0.2.89",
+  "version": "0.2.90",
   "description": "Shennian — AI Agent Control Plane CLI",
   "type": "module",
   "bin": {
@@ -46,12 +46,13 @@
     "@types/node": "^20",
     "@types/qrcode-terminal": "^0.12.2",
     "@types/ws": "^8.18.1",
+    "esbuild": "^0.27.4",
     "tsx": "^4.19.4",
     "typescript": "^5.9.3"
   },
   "scripts": {
     "build": "tsc && node scripts/copy-wechat-rpa-assets.mjs && node -e \"require('node:fs').chmodSync('dist/bin/shennian.js', 0o755)\"",
-    "build:publish": "node -e \"const fs=require('node:fs'); fs.rmSync('dist', { recursive: true, force: true }); fs.rmSync('.tsbuildinfo.publish', { force: true })\" && tsc -p tsconfig.publish.json && node scripts/copy-wechat-rpa-assets.mjs && node -e \"require('node:fs').chmodSync('dist/bin/shennian.js', 0o755)\" && node scripts/check-publish-artifact.mjs",
+    "build:publish": "node -e \"const fs=require('node:fs'); fs.rmSync('dist', { recursive: true, force: true }); fs.rmSync('.tsbuildinfo.publish', { force: true })\" && tsc -p tsconfig.publish.json && node scripts/copy-wechat-rpa-assets.mjs && node scripts/minify-publish-js.mjs && node -e \"require('node:fs').chmodSync('dist/bin/shennian.js', 0o755)\" && node scripts/check-publish-artifact.mjs",
     "dev": "tsc --watch"
   }
 }