shennian 0.2.89 → 0.2.90

package/dist/src/index.js

@@ -1,404 +1,2 @@
-// @arch docs/architecture/cli/daemon.md
-// @test src/__tests__/agents-e2e.ts
-// @test src/__tests__/daemon-autostart.test.ts
-import { Command } from 'commander';
-import chalk from 'chalk';
-import os from 'node:os';
-import fs from 'node:fs';
-import { loadConfig, saveConfig, configPath, getShennianDir, resolveShennianPath, } from './config/index.js';
-import { CliRelayClient } from './relay/client.js';
-import { registerPairCommand, runSmartStart } from './commands/pair.js';
-import { clearDaemonPidIfOwner, createDaemonInstanceId, clearDaemonLauncher, findRunningDaemonProcessIds, isRemoteAccessDisabled, registerDaemonCommand, writeDaemonPid, writeDaemonLauncher, } from './commands/daemon.js';
-import { registerAgentCommand } from './commands/agent.js';
-import { registerManagerCommand } from './commands/manager.js';
-import { registerExternalCommand } from './commands/external.js';
-import { registerUpgradeCommand } from './commands/upgrade.js';
-import { registerToolsCommand } from './commands/tools.js';
-import { SessionManager } from './session/manager.js';
-import { SERVERS, regionToUrl, urlToRegion } from './region.js';
-import { getCurrentVersion, handleStartupCrashCheck, checkForUpdate, isUpgradeVersionInCooldown, recordUpgradeFailure, } from './upgrade/engine.js';
-import { detectAgents } from './agents/detect.js';
-import { augmentProcessPath } from './env-path.js';
-augmentProcessPath();
-const cliVersion = getCurrentVersion();
-const AUTO_UPGRADE_INITIAL_DELAY_MS = 30_000;
-const AUTO_UPGRADE_POLL_INTERVAL_MS = 5 * 60_000;
-import { getCachedAgentInfos, resolveAgentInfos } from './agents/model-registry.js';
-import { initCliLogReporter, reportLog } from './log-reporter.js';
-import { isNativeFusionEnabled } from './native-fusion/config.js';
-import { NativeSessionFusionService } from './native-fusion/service.js';
-import { startDaemonLogRetention } from './daemon-log.js';
-const SHENNIAN_DIR = getShennianDir();
-const PID_FILE = resolveShennianPath('daemon.pid');
-function readDaemonPidFile() {
-    try {
-        const raw = fs.readFileSync(PID_FILE, 'utf-8').trim();
-        if (raw.startsWith('{')) {
-            const parsed = JSON.parse(raw);
-            const pid = Number(parsed.pid);
-            return Number.isInteger(pid) && pid > 0 ? pid : null;
-        }
-        const pid = parseInt(raw, 10);
-        return Number.isInteger(pid) && pid > 0 ? pid : null;
-    }
-    catch {
-        return null;
-    }
-}
-function httpToWs(url) {
-    return url.replace(/^https:\/\//, 'wss://').replace(/^http:\/\//, 'ws://');
-}
-function formatDisconnectInfo(info) {
-    const parts = [
-        `trigger=${info.trigger ?? 'unknown'}`,
-        `phase=${info.phase}`,
-        `code=${info.code ?? 'unknown'}`,
-        `attempt=${info.reconnectAttempt}`,
-    ];
-    if (info.reason)
-        parts.push(`reason=${info.reason}`);
-    if (info.error)
-        parts.push(`error=${info.error}`);
-    return parts.join(' ');
-}
-async function waitForPidExit(pid, timeoutMs = 5000) {
-    const startedAt = Date.now();
-    while (Date.now() - startedAt < timeoutMs) {
-        try {
-            process.kill(pid, 0);
-        }
-        catch {
-            return true;
-        }
-        await new Promise((resolve) => setTimeout(resolve, 100));
-    }
-    try {
-        process.kill(pid, 0);
-        return false;
-    }
-    catch {
-        return true;
-    }
-}
-const program = new Command();
-program.name('shennian').description('Shennian — AI Agent Control Plane').version(cliVersion);
-program
-    .option('--api <url>', 'Server URL override')
-    .option('--name <name>', 'Machine name', os.hostname())
-    .action(async (opts) => {
-    const config = loadConfig();
-    const serverUrl = opts.api ?? process.env.SHENNIAN_DESKTOP_SERVER_URL ?? config.serverUrl ?? undefined;
-    await runSmartStart(serverUrl, opts.name);
-});
-// run-service: internal command used by the background service process
-program
-    .command('run-service', { hidden: true })
-    .description('(internal) Connect to relay server, called by the background service')
-    .option('--api <url>', 'Server URL override')
-    .action(async (opts) => {
-    const envFile = resolveShennianPath('env.json');
-    try {
-        const saved = JSON.parse(fs.readFileSync(envFile, 'utf-8'));
-        for (const [k, v] of Object.entries(saved)) {
-            if (!process.env[k])
-                process.env[k] = v;
-        }
-        augmentProcessPath();
-    }
-    catch {
-        // env.json may not exist yet
-    }
-    const logRetentionTimer = startDaemonLogRetention();
-    if (isRemoteAccessDisabled()) {
-        console.log(`[${new Date().toISOString()}] remote access disabled, service start skipped`);
-        clearInterval(logRetentionTimer);
-        process.exit(0);
-    }
-    // Single-instance guard. Service-manager starts are authoritative and may
-    // need to take over from an older detached process after app/daemon upgrades.
-    const serviceManagedStart = Boolean(process.env.INVOCATION_ID ||
-        process.env.JOURNAL_STREAM ||
-        process.env.SHENNIAN_DESKTOP_SERVER_URL);
-    const stopExistingDaemon = async (oldPid, reason) => {
-        console.log(`[${new Date().toISOString()}] ${reason} (PID ${oldPid})`);
-        process.kill(oldPid, 'SIGTERM');
-        const stopped = await waitForPidExit(oldPid);
-        if (!stopped) {
-            process.kill(oldPid, 'SIGKILL');
-            await waitForPidExit(oldPid, 2000);
-        }
-    };
-    try {
-        const oldPid = readDaemonPidFile();
-        if (oldPid && oldPid !== process.pid) {
-            try {
-                process.kill(oldPid, 0);
-                if (serviceManagedStart) {
-                    await stopExistingDaemon(oldPid, 'managed start taking over from existing daemon');
-                }
-                else {
-                    console.log(`[${new Date().toISOString()}] daemon already running (PID ${oldPid}), skipping duplicate start`);
-                    process.exit(0);
-                }
-            }
-            catch {
-                // Stale pid; continue booting and overwrite it below.
-            }
-        }
-    }
-    catch {
-        /* noop */
-    }
-    const orphanPids = findRunningDaemonProcessIds(process.pid);
-    if (orphanPids.length > 0) {
-        if (serviceManagedStart) {
-            for (const orphanPid of orphanPids) {
-                try {
-                    await stopExistingDaemon(orphanPid, 'managed start taking over from orphan daemon');
-                }
-                catch {
-                    // Keep booting; the normal pid-file guard below still protects the managed daemon.
-                }
-            }
-        }
-        else {
-            console.log(`[${new Date().toISOString()}] daemon already running (PID ${orphanPids[0]}), skipping duplicate start`);
-            process.exit(0);
-        }
-    }
-    const daemonInstanceId = createDaemonInstanceId();
-    writeDaemonPid(process.pid, daemonInstanceId, { version: cliVersion });
-    writeDaemonLauncher(process.pid, undefined, daemonInstanceId);
-    process.on('exit', () => {
-        clearDaemonPidIfOwner(process.pid, daemonInstanceId);
-        clearDaemonLauncher(daemonInstanceId);
-    });
-    // Crash detection: if we're recovering from a failed upgrade, rollback and exit
-    const didRollback = await handleStartupCrashCheck();
-    if (didRollback) {
-        console.log(`[${new Date().toISOString()}] Rolled back to previous version, restarting...`);
-        process.exit(0);
-    }
-    const config = loadConfig();
-    if (!config.machineToken) {
-        console.error(chalk.red('✗ Not paired yet. Run: shennian'));
-        process.exit(1);
-    }
-    const serverUrl = opts.api ?? process.env.SHENNIAN_DESKTOP_SERVER_URL ?? config.serverUrl ?? SERVERS.cn.url;
-    const wsBase = httpToWs(serverUrl);
-    const wsUrl = `${wsBase}/relay/machine`;
-    const currentCliVersion = getCurrentVersion();
-    const detectedAgents = detectAgents();
-    const agentList = detectedAgents.map((a) => a.type);
-    const cachedAgentInfos = getCachedAgentInfos(detectedAgents);
-    if (config.machineId) {
-        initCliLogReporter(serverUrl, config.machineId);
-    }
-    console.log(`[${new Date().toISOString()}] Connecting to ${wsUrl}... (v${currentCliVersion}) agents: ${agentList.join(',')}`);
-    reportLog({
-        level: 'info',
-        wsEvent: 'daemon.start',
-        metadata: { version: currentCliVersion, agents: agentList },
-    });
-    let nativeFusion = null;
-    const client = new CliRelayClient({
-        serverUrl: wsUrl,
-        machineToken: config.machineToken,
-        cliVersion: currentCliVersion,
-        agentList,
-        onConnected: () => {
-            console.log(`[${new Date().toISOString()}] ✓ Connected`);
-            reportLog({ level: 'info', wsEvent: 'daemon.connected' });
-            if (cachedAgentInfos.some((agent) => agent.models.length > 0)) {
-                client.sendEvent({
-                    type: 'event',
-                    event: 'machine.agents',
-                    payload: {
-                        agentList,
-                        agents: cachedAgentInfos,
-                    },
-                });
-            }
-            void resolveAgentInfos(detectedAgents, {
-                serverUrl: config.serverUrl ?? serverUrl,
-                authToken: config.machineToken ?? config.accessToken,
-            })
-                .then((agents) => {
-                if (JSON.stringify(agents) === JSON.stringify(cachedAgentInfos))
-                    return;
-                client.sendEvent({
-                    type: 'event',
-                    event: 'machine.agents',
-                    payload: {
-                        agentList,
-                        agents,
-                    },
-                });
-            })
-                .catch(() => { });
-            import('./upgrade/engine.js')
-                .then(({ readUpgradeAttempt, clearUpgradeAttempt }) => {
-                const attempt = readUpgradeAttempt();
-                clearUpgradeAttempt();
-                if (attempt) {
-                    console.log(`[${new Date().toISOString()}] [upgrade] Reporting success: ${attempt.from} → ${attempt.to}`);
-                    client.sendEvent({
-                        type: 'event',
-                        event: 'upgrade',
-                        payload: {
-                            state: 'success',
-                            machineId: 'self',
-                            from: attempt.from,
-                            to: attempt.to,
-                        },
-                    });
-                }
-            })
-                .catch(() => { });
-            void scheduleAutoUpgrade(client, config.autoUpgrade ?? 'patch', currentCliVersion);
-            nativeFusion?.handleConnected();
-        },
-        onDisconnected: (info) => {
-            console.log(`[${new Date().toISOString()}] ⚠ Disconnected, reconnecting... ${formatDisconnectInfo(info)}`);
-            reportLog({
-                level: 'warn',
-                wsEvent: 'daemon.disconnected',
-                metadata: {
-                    code: info.code,
-                    reason: info.reason,
-                    error: info.error,
-                    phase: info.phase,
-                    trigger: info.trigger,
-                    reconnectAttempt: info.reconnectAttempt,
-                },
-            });
-        },
-        onReq: (req) => {
-            console.log(`[${new Date().toISOString()}] [req] ${req.method}`);
-            reportLog({
-                level: 'info',
-                type: 'ws',
-                wsEvent: req.method,
-                wsDirection: 'in',
-                traceId: req.traceId,
-            });
-            void sessionManager.handleReq(req);
-        },
-    });
-    nativeFusion =
-        isNativeFusionEnabled()
-            ? new NativeSessionFusionService(client)
-            : null;
-    const sessionManager = new SessionManager(client, nativeFusion, currentCliVersion);
-    fs.mkdirSync(SHENNIAN_DIR, { recursive: true });
-    writeDaemonPid(process.pid, daemonInstanceId, { version: currentCliVersion });
-    writeDaemonLauncher(process.pid, undefined, daemonInstanceId);
-    client.connect();
-    process.stdin.resume();
-    const shutdown = () => {
-        console.log(chalk.gray('\nDisconnecting...'));
-        reportLog({ level: 'info', wsEvent: 'daemon.stop' });
-        clearInterval(logRetentionTimer);
-        sessionManager.cleanup();
-        nativeFusion?.stop();
-        client.disconnect();
-        clearDaemonPidIfOwner(process.pid, daemonInstanceId);
-        clearDaemonLauncher(daemonInstanceId);
-        process.exit(0);
-    };
-    process.on('SIGINT', shutdown);
-    process.on('SIGTERM', shutdown);
-});
-// config: view and modify settings
-const configCmd = program.command('config').description('View or modify configuration');
-configCmd
-    .command('show', { isDefault: true })
-    .description('Show current configuration')
-    .action(() => {
-    console.log(`Config file: ${configPath}`);
-    const config = loadConfig();
-    const display = { ...config };
-    if (display.machineToken)
-        display.machineToken = display.machineToken.slice(0, 12) + '...';
-    if (display.serverUrl) {
-        const region = urlToRegion(display.serverUrl);
-        console.log(`Region: ${region} (${SERVERS[region].label})`);
-    }
-    console.log(JSON.stringify(display, null, 2));
-});
-configCmd
-    .command('set')
-    .description('Update a config value')
-    .argument('<key>', 'Config key (e.g. "server")')
-    .argument('<value>', 'Config value (e.g. "cn" or "global")')
-    .action((key, value) => {
-    const config = loadConfig();
-    if (key === 'server') {
-        if (value !== 'cn' && value !== 'global') {
-            console.error(chalk.red('✗ Value must be "cn" or "global"'));
-            process.exit(1);
-        }
-        const region = value;
-        config.serverUrl = regionToUrl(region);
-        saveConfig(config);
-        console.log(chalk.green(`✓ Server set to ${SERVERS[region].label}`));
-        console.log(chalk.yellow('  Restart the background service for this to take effect: shennian stop && shennian start'));
-        return;
-    }
-    console.error(chalk.red(`✗ Unknown config key: ${key}. Supported: server`));
-    process.exit(1);
-});
-registerPairCommand(program);
-registerDaemonCommand(program);
-registerAgentCommand(program);
-registerManagerCommand(program);
-registerExternalCommand(program);
-registerUpgradeCommand(program);
-registerToolsCommand(program);
-program.parse();
-// ─── Auto-upgrade helper ──────────────────────────────────────────────────────
-async function scheduleAutoUpgrade(client, policy, currentVersion) {
-    if (policy === 'none')
-        return;
-    let upgradeInFlight = false;
-    const tick = async () => {
-        if (upgradeInFlight)
-            return;
-        let result;
-        try {
-            result = await checkForUpdate(currentVersion);
-        }
-        catch {
-            return; // silently skip on network error
-        }
-        if (!result.hasUpdate)
-            return;
-        const { changeType, current, latest } = result;
-        // Respect the policy
-        if (policy === 'patch' && changeType !== 'patch')
-            return;
-        if (policy === 'minor' && changeType === 'major')
-            return;
-        if (isUpgradeVersionInCooldown(latest))
-            return;
-        console.log(`[${new Date().toISOString()}] [upgrade] ${current} → ${latest} (${changeType}), auto-upgrading...`);
-        upgradeInFlight = true;
-        try {
-            const { handleUpgradeStart } = await import('./commands/upgrade.js');
-            // Use a dummy reqId since this is self-triggered
-            await handleUpgradeStart(client, 'auto-upgrade', latest, { currentVersion });
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            const failure = recordUpgradeFailure(latest, message);
-            console.log(`[${new Date().toISOString()}] [upgrade] ${latest} failed, retry after ${new Date(failure.nextRetryAt).toISOString()}: ${message}`);
-        }
-        finally {
-            upgradeInFlight = false;
-        }
-    };
-    // Delay slightly so we don't hit npm on every cold start during development,
-    // then keep polling so a bad published patch can be superseded by a good one.
-    setTimeout(() => void tick(), AUTO_UPGRADE_INITIAL_DELAY_MS);
-    setInterval(() => void tick(), AUTO_UPGRADE_POLL_INTERVAL_MS);
-}
+import{Command as V}from"commander";import u from"chalk";import M from"node:os";import R from"node:fs";import{loadConfig as w,saveConfig as G,configPath as J,getShennianDir as j,resolveShennianPath as A}from"./config/index.js";import{CliRelayClient as H}from"./relay/client.js";import{registerPairCommand as K,runSmartStart as B}from"./commands/pair.js";import{clearDaemonPidIfOwner as N,createDaemonInstanceId as W,clearDaemonLauncher as O,findRunningDaemonProcessIds as Y,isRemoteAccessDisabled as q,registerDaemonCommand as z,writeDaemonPid as T,writeDaemonLauncher as _}from"./commands/daemon.js";import{registerAgentCommand as Q}from"./commands/agent.js";import{registerManagerCommand as X}from"./commands/manager.js";import{registerExternalCommand as Z}from"./commands/external.js";import{registerUpgradeCommand as ee}from"./commands/upgrade.js";import{registerToolsCommand as ne}from"./commands/tools.js";import{SessionManager as oe}from"./session/manager.js";import{SERVERS as k,regionToUrl as te,urlToRegion as re}from"./region.js";import{getCurrentVersion as P,handleStartupCrashCheck as se,checkForUpdate as ae,isUpgradeVersionInCooldown as ie,recordUpgradeFailure as ce}from"./upgrade/engine.js";import{detectAgents as le}from"./agents/detect.js";import{augmentProcessPath as L}from"./env-path.js";L();const b=P(),pe=3e4,de=5*6e4;import{getCachedAgentInfos as me,resolveAgentInfos as ge}from"./agents/model-registry.js";import{initCliLogReporter as ue,reportLog as v}from"./log-reporter.js";import{isNativeFusionEnabled as fe}from"./native-fusion/config.js";import{NativeSessionFusionService as he}from"./native-fusion/service.js";import{startDaemonLogRetention as ve}from"./daemon-log.js";const Se=j(),Ie=A("daemon.pid");function we(){try{const n=R.readFileSync(Ie,"utf-8").trim();if(n.startsWith("{")){const t=JSON.parse(n),r=Number(t.pid);return Number.isInteger(r)&&r>0?r:null}const o=parseInt(n,10);return Number.isInteger(o)&&o>0?o:null}catch{return null}}function De(n){return n.replace(/^https:\/\//,"wss://").replace(/^http:\/\//,"ws://")}function ye(n){const o=[`trigger=${n.trigger??"unknown"}`,`phase=${n.phase}`,`code=${n.code??"unknown"}`,`attempt=${n.reconnectAttempt}`];return n.reason&&o.push(`reason=${n.reason}`),n.error&&o.push(`error=${n.error}`),o.join(" ")}async function x(n,o=5e3){const t=Date.now();for(;Date.now()-t<o;){try{process.kill(n,0)}catch{return!0}await new Promise(r=>setTimeout(r,100))}try{return process.kill(n,0),!1}catch{return!0}}const i=new V;i.name("shennian").description("Shennian \u2014 AI Agent Control Plane").version(b),i.option("--api <url>","Server URL override").option("--name <name>","Machine name",M.hostname()).action(async n=>{const o=w(),t=n.api??process.env.SHENNIAN_DESKTOP_SERVER_URL??o.serverUrl??void 0;await B(t,n.name)}),i.command("run-service",{hidden:!0}).description("(internal) Connect to relay server, called by the background service").option("--api <url>","Server URL override").action(async n=>{const o=A("env.json");try{const e=JSON.parse(R.readFileSync(o,"utf-8"));for(const[g,p]of Object.entries(e))process.env[g]||(process.env[g]=p);L()}catch{}const t=ve();q()&&(console.log(`[${new Date().toISOString()}] remote access disabled, service start skipped`),clearInterval(t),process.exit(0));const r=!!(process.env.INVOCATION_ID||process.env.JOURNAL_STREAM||process.env.SHENNIAN_DESKTOP_SERVER_URL),f=async(e,g)=>{console.log(`[${new Date().toISOString()}] ${g} (PID ${e})`),process.kill(e,"SIGTERM"),await x(e)||(process.kill(e,"SIGKILL"),await x(e,2e3))};try{const e=we();if(e&&e!==process.pid)try{process.kill(e,0),r?await f(e,"managed start taking over from existing daemon"):(console.log(`[${new Date().toISOString()}] daemon already running (PID ${e}), skipping duplicate start`),process.exit(0))}catch{}}catch{}const d=Y(process.pid);if(d.length>0)if(r)for(const e of d)try{await f(e,"managed start taking over from orphan daemon")}catch{}else console.log(`[${new Date().toISOString()}] daemon already running (PID ${d[0]}), skipping duplicate start`),process.exit(0);const a=W();T(process.pid,a,{version:b}),_(process.pid,void 0,a),process.on("exit",()=>{N(process.pid,a),O(a)}),await se()&&(console.log(`[${new Date().toISOString()}] Rolled back to previous version, restarting...`),process.exit(0));const s=w();s.machineToken||(console.error(u.red("\u2717 Not paired yet. Run: shennian")),process.exit(1));const c=n.api??process.env.SHENNIAN_DESKTOP_SERVER_URL??s.serverUrl??k.cn.url,S=`${De(c)}/relay/machine`,m=P(),y=le(),h=y.map(e=>e.type),$=me(y);s.machineId&&ue(c,s.machineId),console.log(`[${new Date().toISOString()}] Connecting to ${S}... (v${m}) agents: ${h.join(",")}`),v({level:"info",wsEvent:"daemon.start",metadata:{version:m,agents:h}});let I=null;const l=new H({serverUrl:S,machineToken:s.machineToken,cliVersion:m,agentList:h,onConnected:()=>{console.log(`[${new Date().toISOString()}] \u2713 Connected`),v({level:"info",wsEvent:"daemon.connected"}),$.some(e=>e.models.length>0)&&l.sendEvent({type:"event",event:"machine.agents",payload:{agentList:h,agents:$}}),ge(y,{serverUrl:s.serverUrl??c,authToken:s.machineToken??s.accessToken}).then(e=>{JSON.stringify(e)!==JSON.stringify($)&&l.sendEvent({type:"event",event:"machine.agents",payload:{agentList:h,agents:e}})}).catch(()=>{}),import("./upgrade/engine.js").then(({readUpgradeAttempt:e,clearUpgradeAttempt:g})=>{const p=e();g(),p&&(console.log(`[${new Date().toISOString()}] [upgrade] Reporting success: ${p.from} \u2192 ${p.to}`),l.sendEvent({type:"event",event:"upgrade",payload:{state:"success",machineId:"self",from:p.from,to:p.to}}))}).catch(()=>{}),$e(l,s.autoUpgrade??"patch",m),I?.handleConnected()},onDisconnected:e=>{console.log(`[${new Date().toISOString()}] \u26A0 Disconnected, reconnecting... ${ye(e)}`),v({level:"warn",wsEvent:"daemon.disconnected",metadata:{code:e.code,reason:e.reason,error:e.error,phase:e.phase,trigger:e.trigger,reconnectAttempt:e.reconnectAttempt}})},onReq:e=>{console.log(`[${new Date().toISOString()}] [req] ${e.method}`),v({level:"info",type:"ws",wsEvent:e.method,wsDirection:"in",traceId:e.traceId}),U.handleReq(e)}});I=fe()?new he(l):null;const U=new oe(l,I,m);R.mkdirSync(Se,{recursive:!0}),T(process.pid,a,{version:m}),_(process.pid,void 0,a),l.connect(),process.stdin.resume();const C=()=>{console.log(u.gray(`
+Disconnecting...`)),v({level:"info",wsEvent:"daemon.stop"}),clearInterval(t),U.cleanup(),I?.stop(),l.disconnect(),N(process.pid,a),O(a),process.exit(0)};process.on("SIGINT",C),process.on("SIGTERM",C)});const F=i.command("config").description("View or modify configuration");F.command("show",{isDefault:!0}).description("Show current configuration").action(()=>{console.log(`Config file: ${J}`);const o={...w()};if(o.machineToken&&(o.machineToken=o.machineToken.slice(0,12)+"..."),o.serverUrl){const t=re(o.serverUrl);console.log(`Region: ${t} (${k[t].label})`)}console.log(JSON.stringify(o,null,2))}),F.command("set").description("Update a config value").argument("<key>",'Config key (e.g. "server")').argument("<value>",'Config value (e.g. "cn" or "global")').action((n,o)=>{const t=w();if(n==="server"){o!=="cn"&&o!=="global"&&(console.error(u.red('\u2717 Value must be "cn" or "global"')),process.exit(1));const r=o;t.serverUrl=te(r),G(t),console.log(u.green(`\u2713 Server set to ${k[r].label}`)),console.log(u.yellow("  Restart the background service for this to take effect: shennian stop && shennian start"));return}console.error(u.red(`\u2717 Unknown config key: ${n}. Supported: server`)),process.exit(1)}),K(i),z(i),Q(i),X(i),Z(i),ee(i),ne(i),i.parse();async function $e(n,o,t){if(o==="none")return;let r=!1;const f=async()=>{if(r)return;let d;try{d=await ae(t)}catch{return}if(!d.hasUpdate)return;const{changeType:a,current:E,latest:s}=d;if(!(o==="patch"&&a!=="patch")&&!(o==="minor"&&a==="major")&&!ie(s)){console.log(`[${new Date().toISOString()}] [upgrade] ${E} \u2192 ${s} (${a}), auto-upgrading...`),r=!0;try{const{handleUpgradeStart:c}=await import("./commands/upgrade.js");await c(n,"auto-upgrade",s,{currentVersion:t})}catch(c){const D=c instanceof Error?c.message:String(c),S=ce(s,D);console.log(`[${new Date().toISOString()}] [upgrade] ${s} failed, retry after ${new Date(S.nextRetryAt).toISOString()}: ${D}`)}finally{r=!1}}};setTimeout(()=>{f()},pe),setInterval(()=>{f()},de)}

package/dist/src/log-reporter.js

@@ -1,16 +1 @@
-import crypto from 'node:crypto';
-let _serverUrl;
-let _machineId;
-export function initCliLogReporter(serverUrl, machineId) {
-    _serverUrl = serverUrl.replace(/\/$/, '');
-    _machineId = machineId;
-}
-export function generateTraceId() {
-    return crypto.randomBytes(8).toString('hex');
-}
-export function reportLog(entry) {
-    if (!_serverUrl || !_machineId)
-        return;
-    // Remote DB log reporting is intentionally disabled; keep the API for callers.
-    void entry;
-}
+import n from"node:crypto";let e,t;function p(r,o){e=r.replace(/\/$/,""),t=o}function c(){return n.randomBytes(8).toString("hex")}function a(r){}export{c as generateTraceId,p as initCliLogReporter,a as reportLog};

package/dist/src/manager/prompt.js

@@ -1,34 +1,32 @@
-// @arch docs/features/manager-agent.md
-// @test src/__tests__/manager-runtime.test.ts
-export const MANAGER_SYSTEM_PROMPT = `你是项目经理，是当前项目的管理者。
+const s=`\u4F60\u662F\u9879\u76EE\u7ECF\u7406\uFF0C\u662F\u5F53\u524D\u9879\u76EE\u7684\u7BA1\u7406\u8005\u3002
 
-你的职责：
-- 理解用户目标。
-- 拆解任务。
-- 创建、指派、观察和停止同一项目目录下的 worker Agent session。
-- 汇总 worker 结果。
-- 判断是否需要继续等待、调整安排、询问用户或验收。
-- 在项目 .shennian/ 目录下维护必要的计划、记录和项目记忆。
+\u4F60\u7684\u804C\u8D23\uFF1A
+- \u7406\u89E3\u7528\u6237\u76EE\u6807\u3002
+- \u62C6\u89E3\u4EFB\u52A1\u3002
+- \u521B\u5EFA\u3001\u6307\u6D3E\u3001\u89C2\u5BDF\u548C\u505C\u6B62\u540C\u4E00\u9879\u76EE\u76EE\u5F55\u4E0B\u7684 worker Agent session\u3002
+- \u6C47\u603B worker \u7ED3\u679C\u3002
+- \u5224\u65AD\u662F\u5426\u9700\u8981\u7EE7\u7EED\u7B49\u5F85\u3001\u8C03\u6574\u5B89\u6392\u3001\u8BE2\u95EE\u7528\u6237\u6216\u9A8C\u6536\u3002
+- \u5728\u9879\u76EE .shennian/ \u76EE\u5F55\u4E0B\u7EF4\u62A4\u5FC5\u8981\u7684\u8BA1\u5212\u3001\u8BB0\u5F55\u548C\u9879\u76EE\u8BB0\u5FC6\u3002
 
-你的边界：
-- 不要把自己当作主要执行者。
-- 不要直接编辑业务代码，除非用户明确要求你亲自执行。
-- 可以读取文件、搜索项目和检查上下文，以便做判断。
-- 需要修改代码、运行测试、调研方案时，优先创建或指派 worker。
-- 每次收到新任务、补充要求、纠偏或外部消息时，先用 sessions list 查看当前同项目 worker；如果可能相关，再用 sessions read 读取必要摘要后判断是否复用。
-- 如果已有 worker 正在处理同一目标、同一功能区、同一文件范围或同一问题链路，优先用 sessions send 把新要求发给这个 worker；即使 worker 正忙也可以发送，默认会进入本机队列，不要因为它忙就新建 worker。
-- 只有没有相关 worker、现有 worker 已明显不适合继续推进、或任务需要并行拆分给不同专长时，才创建新的 worker。
-- 创建或指派 worker 后，除非用户明确要求你当场继续调度，否则回复用户已安排并结束当前 turn；不要主动轮询 worker 状态，神念会在 worker 终态或健康摘要到来时重新唤醒你。
-- sessions read 返回的是给管理者看的简洁进展、工具摘要和最终结果，不是原始流式 token；不要要求读取或转述完整流式日志。
-- 只能管理与你处于同一台机器、同一项目目录的会话；不要跨机器或跨项目调度。
-- 不要无限循环；没有明确下一步时询问用户或结束当前 turn 等待系统事件。
-- 不要自己设置定时唤醒；神念会在用户消息、worker 终态或 worker 长运行健康摘要到来时唤醒你。
-- 外部消息通道事件会像普通用户消息一样送达，格式类似“外部消息 / 发送人”后跟消息内容，可能是合并消息，也可能包含图片、视频或文件 URL。
-- 外部消息是否需要回复、追问、忽略、转交内部负责人，或创建/指派 worker，由你根据项目上下文显式判断。
-- 对外你是当前项目的项目经理，不要自称神念、Manager Agent 或 worker，也不要解释内部调度机制；只在需要时用“我这边/我们这边”沟通。
-- 不要把所有细节塞进对话上下文；需要长期保存的信息写到项目 .shennian/ 下。
+\u4F60\u7684\u8FB9\u754C\uFF1A
+- \u4E0D\u8981\u628A\u81EA\u5DF1\u5F53\u4F5C\u4E3B\u8981\u6267\u884C\u8005\u3002
+- \u4E0D\u8981\u76F4\u63A5\u7F16\u8F91\u4E1A\u52A1\u4EE3\u7801\uFF0C\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u4F60\u4EB2\u81EA\u6267\u884C\u3002
+- \u53EF\u4EE5\u8BFB\u53D6\u6587\u4EF6\u3001\u641C\u7D22\u9879\u76EE\u548C\u68C0\u67E5\u4E0A\u4E0B\u6587\uFF0C\u4EE5\u4FBF\u505A\u5224\u65AD\u3002
+- \u9700\u8981\u4FEE\u6539\u4EE3\u7801\u3001\u8FD0\u884C\u6D4B\u8BD5\u3001\u8C03\u7814\u65B9\u6848\u65F6\uFF0C\u4F18\u5148\u521B\u5EFA\u6216\u6307\u6D3E worker\u3002
+- \u6BCF\u6B21\u6536\u5230\u65B0\u4EFB\u52A1\u3001\u8865\u5145\u8981\u6C42\u3001\u7EA0\u504F\u6216\u5916\u90E8\u6D88\u606F\u65F6\uFF0C\u5148\u7528 sessions list \u67E5\u770B\u5F53\u524D\u540C\u9879\u76EE worker\uFF1B\u5982\u679C\u53EF\u80FD\u76F8\u5173\uFF0C\u518D\u7528 sessions read \u8BFB\u53D6\u5FC5\u8981\u6458\u8981\u540E\u5224\u65AD\u662F\u5426\u590D\u7528\u3002
+- \u5982\u679C\u5DF2\u6709 worker \u6B63\u5728\u5904\u7406\u540C\u4E00\u76EE\u6807\u3001\u540C\u4E00\u529F\u80FD\u533A\u3001\u540C\u4E00\u6587\u4EF6\u8303\u56F4\u6216\u540C\u4E00\u95EE\u9898\u94FE\u8DEF\uFF0C\u4F18\u5148\u7528 sessions send \u628A\u65B0\u8981\u6C42\u53D1\u7ED9\u8FD9\u4E2A worker\uFF1B\u5373\u4F7F worker \u6B63\u5FD9\u4E5F\u53EF\u4EE5\u53D1\u9001\uFF0C\u9ED8\u8BA4\u4F1A\u8FDB\u5165\u672C\u673A\u961F\u5217\uFF0C\u4E0D\u8981\u56E0\u4E3A\u5B83\u5FD9\u5C31\u65B0\u5EFA worker\u3002
+- \u53EA\u6709\u6CA1\u6709\u76F8\u5173 worker\u3001\u73B0\u6709 worker \u5DF2\u660E\u663E\u4E0D\u9002\u5408\u7EE7\u7EED\u63A8\u8FDB\u3001\u6216\u4EFB\u52A1\u9700\u8981\u5E76\u884C\u62C6\u5206\u7ED9\u4E0D\u540C\u4E13\u957F\u65F6\uFF0C\u624D\u521B\u5EFA\u65B0\u7684 worker\u3002
+- \u521B\u5EFA\u6216\u6307\u6D3E worker \u540E\uFF0C\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u4F60\u5F53\u573A\u7EE7\u7EED\u8C03\u5EA6\uFF0C\u5426\u5219\u56DE\u590D\u7528\u6237\u5DF2\u5B89\u6392\u5E76\u7ED3\u675F\u5F53\u524D turn\uFF1B\u4E0D\u8981\u4E3B\u52A8\u8F6E\u8BE2 worker \u72B6\u6001\uFF0C\u795E\u5FF5\u4F1A\u5728 worker \u7EC8\u6001\u6216\u5065\u5EB7\u6458\u8981\u5230\u6765\u65F6\u91CD\u65B0\u5524\u9192\u4F60\u3002
+- sessions read \u8FD4\u56DE\u7684\u662F\u7ED9\u7BA1\u7406\u8005\u770B\u7684\u7B80\u6D01\u8FDB\u5C55\u3001\u5DE5\u5177\u6458\u8981\u548C\u6700\u7EC8\u7ED3\u679C\uFF0C\u4E0D\u662F\u539F\u59CB\u6D41\u5F0F token\uFF1B\u4E0D\u8981\u8981\u6C42\u8BFB\u53D6\u6216\u8F6C\u8FF0\u5B8C\u6574\u6D41\u5F0F\u65E5\u5FD7\u3002
+- \u53EA\u80FD\u7BA1\u7406\u4E0E\u4F60\u5904\u4E8E\u540C\u4E00\u53F0\u673A\u5668\u3001\u540C\u4E00\u9879\u76EE\u76EE\u5F55\u7684\u4F1A\u8BDD\uFF1B\u4E0D\u8981\u8DE8\u673A\u5668\u6216\u8DE8\u9879\u76EE\u8C03\u5EA6\u3002
+- \u4E0D\u8981\u65E0\u9650\u5FAA\u73AF\uFF1B\u6CA1\u6709\u660E\u786E\u4E0B\u4E00\u6B65\u65F6\u8BE2\u95EE\u7528\u6237\u6216\u7ED3\u675F\u5F53\u524D turn \u7B49\u5F85\u7CFB\u7EDF\u4E8B\u4EF6\u3002
+- \u4E0D\u8981\u81EA\u5DF1\u8BBE\u7F6E\u5B9A\u65F6\u5524\u9192\uFF1B\u795E\u5FF5\u4F1A\u5728\u7528\u6237\u6D88\u606F\u3001worker \u7EC8\u6001\u6216 worker \u957F\u8FD0\u884C\u5065\u5EB7\u6458\u8981\u5230\u6765\u65F6\u5524\u9192\u4F60\u3002
+- \u5916\u90E8\u6D88\u606F\u901A\u9053\u4E8B\u4EF6\u4F1A\u50CF\u666E\u901A\u7528\u6237\u6D88\u606F\u4E00\u6837\u9001\u8FBE\uFF0C\u683C\u5F0F\u7C7B\u4F3C\u201C\u5916\u90E8\u6D88\u606F / \u53D1\u9001\u4EBA\u201D\u540E\u8DDF\u6D88\u606F\u5185\u5BB9\uFF0C\u53EF\u80FD\u662F\u5408\u5E76\u6D88\u606F\uFF0C\u4E5F\u53EF\u80FD\u5305\u542B\u56FE\u7247\u3001\u89C6\u9891\u6216\u6587\u4EF6 URL\u3002
+- \u5916\u90E8\u6D88\u606F\u662F\u5426\u9700\u8981\u56DE\u590D\u3001\u8FFD\u95EE\u3001\u5FFD\u7565\u3001\u8F6C\u4EA4\u5185\u90E8\u8D1F\u8D23\u4EBA\uFF0C\u6216\u521B\u5EFA/\u6307\u6D3E worker\uFF0C\u7531\u4F60\u6839\u636E\u9879\u76EE\u4E0A\u4E0B\u6587\u663E\u5F0F\u5224\u65AD\u3002
+- \u5BF9\u5916\u4F60\u662F\u5F53\u524D\u9879\u76EE\u7684\u9879\u76EE\u7ECF\u7406\uFF0C\u4E0D\u8981\u81EA\u79F0\u795E\u5FF5\u3001Manager Agent \u6216 worker\uFF0C\u4E5F\u4E0D\u8981\u89E3\u91CA\u5185\u90E8\u8C03\u5EA6\u673A\u5236\uFF1B\u53EA\u5728\u9700\u8981\u65F6\u7528\u201C\u6211\u8FD9\u8FB9/\u6211\u4EEC\u8FD9\u8FB9\u201D\u6C9F\u901A\u3002
+- \u4E0D\u8981\u628A\u6240\u6709\u7EC6\u8282\u585E\u8FDB\u5BF9\u8BDD\u4E0A\u4E0B\u6587\uFF1B\u9700\u8981\u957F\u671F\u4FDD\u5B58\u7684\u4FE1\u606F\u5199\u5230\u9879\u76EE .shennian/ \u4E0B\u3002
 
-需要管理 worker 或外部通道时，使用本地命令：
+\u9700\u8981\u7BA1\u7406 worker \u6216\u5916\u90E8\u901A\u9053\u65F6\uFF0C\u4F7F\u7528\u672C\u5730\u547D\u4EE4\uFF1A
 - shennian manager sessions list --json
 - shennian manager sessions start --agent <codex|claude|gemini|cursor|opencode|pi|custom:name> --workdir <path> --message <text>
 - shennian manager sessions send --session-id <id> --message <text>
@@ -36,13 +34,10 @@ export const MANAGER_SYSTEM_PROMPT = `你是项目经理，是当前项目的管
 - shennian manager sessions queue list --session-id <id> --json
 - shennian manager sessions queue edit --session-id <id> --message-id <queueMessageId> --message <text>
 - shennian manager sessions queue delete --session-id <id> --message-id <queueMessageId>
-- shennian manager sessions stop --session-id <id>（终止正在运行的 worker；也可用 terminate/kill 别名）
+- shennian manager sessions stop --session-id <id>\uFF08\u7EC8\u6B62\u6B63\u5728\u8FD0\u884C\u7684 worker\uFF1B\u4E5F\u53EF\u7528 terminate/kill \u522B\u540D\uFF09
 - shennian manager sessions read --session-id <id> --limit 200 --json
 - shennian manager memory path
 
-可创建的 worker Agent 包括 Codex、Claude Code、Gemini、Cursor、opencode、Nian，以及本机 custom agent（custom:<name>）。默认用 sessions send 排队发送 worker 消息：worker 正忙时消息会在本机 daemon 队列里等待，worker 空闲时自动执行。队列里的未执行消息可以 list/edit/delete；已经开始执行的消息不能编辑或删除，只能 stop 后重新发送。只有明确需要打断顺序时才使用 --direct。
+\u53EF\u521B\u5EFA\u7684 worker Agent \u5305\u62EC Codex\u3001Claude Code\u3001Gemini\u3001Cursor\u3001opencode\u3001Nian\uFF0C\u4EE5\u53CA\u672C\u673A custom agent\uFF08custom:<name>\uFF09\u3002\u9ED8\u8BA4\u7528 sessions send \u6392\u961F\u53D1\u9001 worker \u6D88\u606F\uFF1Aworker \u6B63\u5FD9\u65F6\u6D88\u606F\u4F1A\u5728\u672C\u673A daemon \u961F\u5217\u91CC\u7B49\u5F85\uFF0Cworker \u7A7A\u95F2\u65F6\u81EA\u52A8\u6267\u884C\u3002\u961F\u5217\u91CC\u7684\u672A\u6267\u884C\u6D88\u606F\u53EF\u4EE5 list/edit/delete\uFF1B\u5DF2\u7ECF\u5F00\u59CB\u6267\u884C\u7684\u6D88\u606F\u4E0D\u80FD\u7F16\u8F91\u6216\u5220\u9664\uFF0C\u53EA\u80FD stop \u540E\u91CD\u65B0\u53D1\u9001\u3002\u53EA\u6709\u660E\u786E\u9700\u8981\u6253\u65AD\u987A\u5E8F\u65F6\u624D\u4F7F\u7528 --direct\u3002
 
-这些命令已经由神念注入当前 Manager 身份和同项目权限边界。不要尝试伪造 Manager session id。`;
-export function buildManagerPrompt(userText) {
-    return userText;
-}
+\u8FD9\u4E9B\u547D\u4EE4\u5DF2\u7ECF\u7531\u795E\u5FF5\u6CE8\u5165\u5F53\u524D Manager \u8EAB\u4EFD\u548C\u540C\u9879\u76EE\u6743\u9650\u8FB9\u754C\u3002\u4E0D\u8981\u5C1D\u8BD5\u4F2A\u9020 Manager session id\u3002`;function n(e){return e}export{s as MANAGER_SYSTEM_PROMPT,n as buildManagerPrompt};