@jsonstudio/rcc 0.89.2239 → 0.90.89

package/dist/cli/commands/{clock-admin.js → session-admin.js}

@@ -88,29 +88,29 @@ async function callJson(ctx, url, method, body) {
     }
     return { ok: response.ok, status: response.status, data };
 }
-export function createClockAdminCommand(program, ctx) {
+export function createSessionAdminCommand(program, ctx) {
     program
-        .command('clock-admin')
-        .description('Manage clock schedules and tmux/session bindings (list + CRUD + cleanup)')
+        .command('session-admin')
+        .description('Manage session schedules and tmux/session bindings (list + CRUD + cleanup)')
         .option('--port <port>', 'RouteCodex server port')
         .option('--host <host>', 'RouteCodex server host')
         .option('--url <url>', 'RouteCodex base URL')
         .option('-c, --config <config>', 'RouteCodex configuration file path')
-        .option('--session-id <sessionId>', 'Conversation/session id for clock task CRUD')
+        .option('--session-id <sessionId>', 'Conversation/session id for session task CRUD')
         .option('--task-id <taskId>', 'Task id for update/delete')
         .option('--due-at <dueAt>', 'ISO8601 due time for create/update')
         .option('--task <task>', 'Task text for create/update')
         .option('--recurrence <kind>', 'Recurrence kind: daily|weekly|interval')
         .option('--every-minutes <minutes>', 'everyMinutes for interval recurrence')
         .option('--max-runs <count>', 'maxRuns for recurrence')
-        .option('--list', 'List clock sessions/tasks', false)
-        .option('--create', 'Create clock task', false)
-        .option('--update', 'Update clock task', false)
-        .option('--delete', 'Delete one clock task', false)
+        .option('--list', 'List session schedules/tasks', false)
+        .option('--create', 'Create session task', false)
+        .option('--update', 'Update session task', false)
+        .option('--delete', 'Delete one session task', false)
         .option('--clear', 'Clear all tasks in a session', false)
         .option('--cleanup-dead-tmux', 'Cleanup daemons whose tmux session is gone', false)
         .option('--unbind-session <conversationSessionId>', 'Unbind conversation session mapping manually')
-        .option('--clear-tasks', 'With --unbind-session, clear its clock tasks too', false)
+        .option('--clear-tasks', 'With --unbind-session, clear its session tasks too', false)
         .option('--json', 'Print JSON output', false)
         .action(async (options) => {
         try {
@@ -125,7 +125,7 @@ export function createClockAdminCommand(program, ctx) {
                 }
             };
             if (options.cleanupDeadTmux) {
-                const result = await callJson(ctx, `${baseUrl}/daemon/clock/cleanup`, 'POST', { mode: 'dead_tmux' });
+                const result = await callJson(ctx, `${baseUrl}/daemon/session/cleanup`, 'POST', { mode: 'dead_tmux' });
                 if (!result.ok) {
                     throw new Error(`cleanup-dead-tmux failed (${result.status})`);
                 }
@@ -133,7 +133,7 @@ export function createClockAdminCommand(program, ctx) {
                 return;
             }
             if (typeof options.unbindSession === 'string' && options.unbindSession.trim()) {
-                const result = await callJson(ctx, `${baseUrl}/daemon/clock/cleanup`, 'POST', {
+                const result = await callJson(ctx, `${baseUrl}/daemon/session/cleanup`, 'POST', {
                     mode: 'unbind',
                     conversationSessionId: options.unbindSession.trim(),
                     clearTasks: Boolean(options.clearTasks)
@@ -160,7 +160,7 @@ export function createClockAdminCommand(program, ctx) {
                         ...(parseInteger(options.everyMinutes) ? { everyMinutes: parseInteger(options.everyMinutes) } : {})
                     };
                 }
-                const result = await callJson(ctx, `${baseUrl}/daemon/clock/tasks`, 'POST', payload);
+                const result = await callJson(ctx, `${baseUrl}/daemon/session/tasks`, 'POST', payload);
                 if (!result.ok) {
                     throw new Error(`create failed (${result.status})`);
                 }
@@ -188,7 +188,7 @@ export function createClockAdminCommand(program, ctx) {
                         ...(parseInteger(options.everyMinutes) ? { everyMinutes: parseInteger(options.everyMinutes) } : {})
                     };
                 }
-                const result = await callJson(ctx, `${baseUrl}/daemon/clock/tasks`, 'PATCH', { sessionId, taskId, patch });
+                const result = await callJson(ctx, `${baseUrl}/daemon/session/tasks`, 'PATCH', { sessionId, taskId, patch });
                 if (!result.ok) {
                     throw new Error(`update failed (${result.status})`);
                 }
@@ -204,7 +204,7 @@ export function createClockAdminCommand(program, ctx) {
                 if (options.delete && !taskId) {
                     throw new Error('--delete requires --task-id (or use --clear)');
                 }
-                const result = await callJson(ctx, `${baseUrl}/daemon/clock/tasks`, 'DELETE', {
+                const result = await callJson(ctx, `${baseUrl}/daemon/session/tasks`, 'DELETE', {
                     sessionId,
                     ...(taskId ? { taskId } : {})
                 });
@@ -216,8 +216,8 @@ export function createClockAdminCommand(program, ctx) {
             }
             const sessionId = typeof options.sessionId === 'string' && options.sessionId.trim() ? options.sessionId.trim() : undefined;
             const listUrl = sessionId
-                ? `${baseUrl}/daemon/clock/tasks?sessionId=${encodeURIComponent(sessionId)}`
-                : `${baseUrl}/daemon/clock/tasks`;
+                ? `${baseUrl}/daemon/session/tasks?sessionId=${encodeURIComponent(sessionId)}`
+                : `${baseUrl}/daemon/session/tasks`;
             const response = await ctx.fetch(listUrl);
             const data = await response.json().catch(() => ({}));
             if (!response.ok) {
@@ -231,4 +231,4 @@ export function createClockAdminCommand(program, ctx) {
         }
     });
 }
-//# sourceMappingURL=clock-admin.js.map
+//# sourceMappingURL=session-admin.js.map

package/dist/cli/commands/session-admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-admin.js","sourceRoot":"","sources":["../../../src/cli/commands/session-admin.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/{tmux-inject.d.ts → session-inject.d.ts}

@@ -6,7 +6,7 @@ type LoggerLike = {
     success: (msg: string) => void;
     error: (msg: string) => void;
 };
-export type TmuxInjectCommandContext = {
+export type SessionInjectCommandContext = {
     isDevPackage: boolean;
     defaultDevPort: number;
     logger: LoggerLike;
@@ -16,5 +16,5 @@ export type TmuxInjectCommandContext = {
     env: NodeJS.ProcessEnv;
     exit: (code: number) => never;
 };
-export declare function createTmuxInjectCommand(program: Command, ctx: TmuxInjectCommandContext): void;
+export declare function createSessionInjectCommand(program: Command, ctx: SessionInjectCommandContext): void;
 export {};

package/dist/cli/commands/{tmux-inject.js → session-inject.js}

@@ -63,11 +63,11 @@ async function resolveBaseUrl(ctx, options) {
     return `http://${host}:${Math.floor(port)}`;
 }
 async function fetchDaemonList(ctx, baseUrl) {
-    const url = `${baseUrl}/daemon/clock-client/list`;
+    const url = `${baseUrl}/daemon/session-client/list`;
     const response = await ctx.fetch(url, { method: 'GET' });
     if (!response.ok) {
         const text = await response.text().catch(() => String(response.status));
-        throw new Error(`Failed to list clock daemons (${response.status}): ${text}`);
+        throw new Error(`Failed to list session daemons (${response.status}): ${text}`);
     }
     const data = (await response.json().catch(() => null));
     const records = Array.isArray(data?.records) ? data?.records : [];
@@ -104,7 +104,7 @@ function resolveTargetTmuxSessionId(records, options) {
         return target;
     }
     if (!withSession.length) {
-        throw new Error('No available clock daemon tmux session. Start rcc codex/claude first.');
+        throw new Error('No available session daemon tmux session. Start rcc codex/claude first.');
     }
     throw new Error('Multiple daemon tmux sessions found; specify --tmux-session-id/--session-id or --daemon-id (use --list).');
 }
@@ -125,10 +125,10 @@ function printList(ctx, records, asJson) {
         return;
     }
     if (!records.length) {
-        ctx.logger.info('No clock-client daemons registered.');
+        ctx.logger.info('No session-client daemons registered.');
         return;
     }
-    ctx.logger.info(`Found ${records.length} clock-client daemon(s):`);
+    ctx.logger.info(`Found ${records.length} session-client daemon(s):`);
     for (const rec of records) {
         const daemonId = String(rec.daemonId || '-');
         const tmuxSessionId = String(rec.tmuxSessionId || rec.sessionId || '-');
@@ -137,10 +137,10 @@ function printList(ctx, records, asJson) {
         ctx.log(`- daemonId=${daemonId} tmuxSessionId=${tmuxSessionId} tmux=${tmuxTarget} heartbeat=${heartbeat}`);
     }
 }
-export function createTmuxInjectCommand(program, ctx) {
+export function createSessionInjectCommand(program, ctx) {
     program
-        .command('tmux-inject')
-        .description('Inject text into tmux-backed codex/claude session via RouteCodex clock daemon')
+        .command('session-inject')
+        .description('Inject text into tmux-backed codex/claude session via RouteCodex session daemon')
         .option('--port <port>', 'RouteCodex server port')
         .option('--host <host>', 'RouteCodex server host')
         .option('--url <url>', 'RouteCodex base URL, e.g. http://127.0.0.1:5520')
@@ -149,7 +149,7 @@ export function createTmuxInjectCommand(program, ctx) {
         .option('--session-id <sessionId>', 'Alias of --tmux-session-id (deprecated)')
         .option('--daemon-id <daemonId>', 'Target daemonId (tmux session auto-resolved)')
         .option('--text <text>', 'Text to inject into target tmux pane and press Enter')
-        .option('--source <source>', 'Injection source tag', 'cli.tmux-inject')
+        .option('--source <source>', 'Injection source tag', 'cli.session-inject')
         .option('--request-id <requestId>', 'Optional request id for tracing')
         .option('--list', 'List available daemon targets only')
         .option('--json', 'Print result/list in JSON')
@@ -171,12 +171,12 @@ export function createTmuxInjectCommand(program, ctx) {
                 text,
                 tmuxSessionId,
                 sessionId: tmuxSessionId,
-                source: typeof options.source === 'string' && options.source.trim() ? options.source.trim() : 'cli.tmux-inject'
+                source: typeof options.source === 'string' && options.source.trim() ? options.source.trim() : 'cli.session-inject'
             };
             if (typeof options.requestId === 'string' && options.requestId.trim()) {
                 payload.requestId = options.requestId.trim();
             }
-            const injectUrl = `${baseUrl}/daemon/clock-client/inject`;
+            const injectUrl = `${baseUrl}/daemon/session-client/inject`;
             const response = await ctx.fetch(injectUrl, {
                 method: 'POST',
                 headers: { 'content-type': 'application/json' },
@@ -209,4 +209,4 @@ export function createTmuxInjectCommand(program, ctx) {
         }
     });
 }
-//# sourceMappingURL=tmux-inject.js.map
+//# sourceMappingURL=session-inject.js.map

package/dist/cli/commands/session-inject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-inject.js","sourceRoot":"","sources":["../../../src/cli/commands/session-inject.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/start-types.d.ts

@@ -1,6 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import type { ChildProcess, SpawnOptions } from 'node:child_process';
+import type { GuardianLifecycleEvent, GuardianRegistration } from '../guardian/types.js';
 export type Spinner = {
     start(text?: string): Spinner;
     succeed(text?: string): void;
@@ -60,6 +61,9 @@ export type StartCommandContext = {
     resolveServerEntryPath: () => string;
     spawn: (command: string, args: string[], options: SpawnOptions) => ChildProcess;
     fetch: typeof fetch;
+    ensureGuardianDaemon?: () => Promise<void>;
+    registerGuardianProcess?: (registration: GuardianRegistration) => Promise<void>;
+    reportGuardianLifecycle?: (event: GuardianLifecycleEvent) => Promise<boolean>;
     setupKeypress: (onInterrupt: () => void) => () => void;
     waitForever: () => Promise<void>;
     onSignal?: (signal: NodeJS.Signals, cb: () => void) => void;

package/dist/cli/commands/start-utils.d.ts

@@ -1,5 +1,6 @@
 export type RccRunMode = 'router' | 'analysis' | 'server';
 type StartCommandArgOptions = {
+    port?: string;
     logLevel?: string;
     ua?: string;
     quotaRouting?: unknown;

package/dist/cli/commands/start-utils.js

@@ -49,6 +49,9 @@ function appendFlag(args, enabled, flag) {
 }
 export function buildStartCommandArgs(options, configPath, runMode) {
     const args = ['start', '--config', configPath, '--mode', runMode];
+    if (typeof options.port === 'string' && options.port.trim()) {
+        args.push('--port', options.port.trim());
+    }
     if (typeof options.logLevel === 'string' && options.logLevel.trim()) {
         args.push('--log-level', options.logLevel.trim());
     }

package/dist/cli/commands/start-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"start-utils.js","sourceRoot":"","sources":["../../../src/cli/commands/start-utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"start-utils.js","sourceRoot":"","sources":["../../../src/cli/commands/start-utils.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/start.js

@@ -11,7 +11,7 @@ export function createStartCommand(program, ctx) {
         .command('start')
         .description('Start the RouteCodex server')
         .option('-c, --config <config>', 'Configuration file path')
-        .option('-p, --port <port>', 'RouteCodex server port (dev package only; overrides env/config)')
+        .option('-p, --port <port>', 'RouteCodex server port (overrides env/config)')
         .option('--mode <mode>', 'Run mode (router|analysis|server). analysis => router + force snapshots', 'router')
         .option('--quota-routing <mode>', 'Quota routing admission control (on|off). off => do not remove providers from pool based on quota')
         .option('--log-level <level>', 'Log level (debug, info, warn, error)', 'info')
@@ -164,14 +164,48 @@ export function createStartCommand(program, ctx) {
                 }
             }
             else {
-                const port = (config?.httpserver?.port ?? config?.server?.port ?? config?.port);
-                if (!port || typeof port !== 'number' || port <= 0) {
-                    spinner.fail('Invalid or missing port configuration');
-                    ctx.logger.error('Please set a valid port (httpserver.port or top-level port) in your configuration');
-                    ctx.exit(1);
+                const flagPort = typeof options.port === 'string' ? Number(options.port) : NaN;
+                if (!Number.isNaN(flagPort) && flagPort > 0) {
+                    ctx.logger.info(`Using port ${flagPort} from --port flag [release package: rcc]`);
+                    resolvedPort = flagPort;
+                }
+                else {
+                    const port = (config?.httpserver?.port ?? config?.server?.port ?? config?.port);
+                    if (!port || typeof port !== 'number' || port <= 0) {
+                        spinner.fail('Invalid or missing port configuration');
+                        ctx.logger.error('Please set a valid port (httpserver.port or top-level port) in your configuration');
+                        ctx.exit(1);
+                    }
+                    resolvedPort = port;
                 }
-                resolvedPort = port;
             }
+            await ctx.ensureGuardianDaemon?.();
+            await ctx.registerGuardianProcess?.({
+                source: 'start',
+                pid: process.pid,
+                ppid: process.ppid,
+                port: resolvedPort,
+                metadata: {
+                    mode: runMode,
+                    configPath
+                }
+            });
+            const applyLifecycleOrThrow = async (args) => {
+                const accepted = await ctx.reportGuardianLifecycle?.({
+                    action: args.action,
+                    source: 'cli.start',
+                    actorPid: process.pid,
+                    targetPid: args.targetPid && args.targetPid > 0 ? args.targetPid : undefined,
+                    signal: args.signal,
+                    metadata: {
+                        port: resolvedPort,
+                        ...(args.metadata || {})
+                    }
+                });
+                if (ctx.reportGuardianLifecycle && accepted !== true) {
+                    throw new Error(`guardian lifecycle apply rejected (${args.action})`);
+                }
+            };
             // Ensure port state aligns with requested behavior.
             // Default behavior is takeover/restart; pass --no-restart for legacy non-disruptive mode.
             const shouldRestart = options.restart !== false || options.exclusive === true;
@@ -209,10 +243,15 @@ export function createStartCommand(program, ctx) {
             if (ctx.isDevPackage) {
                 env.ROUTECODEX_PORT = String(resolvedPort);
             }
+            const bindServerToParent = parseBoolish(ctx.env.ROUTECODEX_SERVER_PARENT_GUARD ?? ctx.env.RCC_SERVER_PARENT_GUARD) ?? false;
             const childProcessEnv = {
                 ...env,
-                ROUTECODEX_EXPECT_PARENT_PID: String(process.pid),
-                RCC_EXPECT_PARENT_PID: String(process.pid)
+                ...(bindServerToParent
+                    ? {
+                        ROUTECODEX_EXPECT_PARENT_PID: String(process.pid),
+                        RCC_EXPECT_PARENT_PID: String(process.pid)
+                    }
+                    : {})
             };
             const args = [serverEntry, modulesConfigPath];
             const routeCodexHome = pathImpl.join(home(), '.routecodex');
@@ -309,6 +348,9 @@ export function createStartCommand(program, ctx) {
                             resolve({ code: 1, signal: null });
                         });
                     });
+                    const codeLabel = typeof exitInfo.code === 'number' && Number.isFinite(exitInfo.code) ? String(exitInfo.code) : 'n/a';
+                    const signalLabel = exitInfo.signal || 'none';
+                    ctx.logger.info(`[client-exit] RouteCodex exited (code=${codeLabel}, signal=${signalLabel})`);
                     const stopIntent = consumeStopIntent();
                     if (stopIntent.matched) {
                         logProcessLifecycleSync({
@@ -407,77 +449,82 @@ export function createStartCommand(program, ctx) {
             ctx.logger.info('Press Ctrl+C to stop the server');
             const shutdown = async (sig) => {
                 try {
-                    await ctx.fetch(`${HTTP_PROTOCOLS.HTTP}${LOCAL_HOSTS.IPV4}:${resolvedPort}${API_PATHS.SHUTDOWN}`, { method: 'POST' }).catch(() => { });
-                }
-                catch {
-                    /* ignore */
-                }
-                try {
-                    if (childProc.pid && childProc.pid === process.pid) {
-                        logProcessLifecycleSync({
-                            event: 'self_termination',
-                            source: 'cli.start.shutdown',
-                            details: {
-                                reason: 'self_kill_guard',
-                                signal: sig,
-                                childPid: childProc.pid,
-                                parentPid: process.pid,
-                                result: 'blocked'
-                            }
-                        });
-                    }
-                    childProc.kill(sig);
-                }
-                catch {
-                    /* ignore */
-                }
-                // Avoid process-group signals here; only target the known child pid,
-                // then rely on managed pid discovery + graceful/force cleanup below.
-                const deadline = Date.now() + 3500;
-                while (Date.now() < deadline) {
-                    if (ctx.findListeningPids(resolvedPort).length === 0) {
-                        break;
+                    await applyLifecycleOrThrow({
+                        action: 'server_shutdown_requested',
+                        signal: sig,
+                        targetPid: childProc.pid ?? null
+                    });
+                    try {
+                        await ctx.fetch(`${HTTP_PROTOCOLS.HTTP}${LOCAL_HOSTS.IPV4}:${resolvedPort}${API_PATHS.SHUTDOWN}`, { method: 'POST' }).catch(() => { });
                     }
-                    await ctx.sleep(120);
-                }
-                const remain = ctx.findListeningPids(resolvedPort);
-                if (remain.length) {
-                    for (const pid of remain) {
-                        ctx.killPidBestEffort(pid, { force: false });
+                    catch {
+                        /* ignore */
                     }
-                    const killDeadline = Date.now() + 1500;
-                    while (Date.now() < killDeadline) {
-                        if (ctx.findListeningPids(resolvedPort).length === 0) {
-                            break;
+                    try {
+                        if (childProc.pid && childProc.pid === process.pid) {
+                            logProcessLifecycleSync({
+                                event: 'self_termination',
+                                source: 'cli.start.shutdown',
+                                details: {
+                                    reason: 'self_kill_guard',
+                                    signal: sig,
+                                    childPid: childProc.pid,
+                                    parentPid: process.pid,
+                                    result: 'blocked'
+                                }
+                            });
                         }
-                        await ctx.sleep(100);
+                        childProc.kill(sig);
                     }
-                }
-                const still = ctx.findListeningPids(resolvedPort);
-                if (still.length) {
-                    for (const pid of still) {
-                        ctx.killPidBestEffort(pid, { force: true });
+                    catch {
+                        /* ignore */
                     }
-                }
-                logProcessLifecycleSync({
-                    event: 'self_termination',
-                    source: 'cli.start.shutdown',
-                    details: {
-                        reason: 'shutdown_sequence_completed',
+                    const childExited = await new Promise((resolve) => {
+                        let settled = false;
+                        const complete = (value) => {
+                            if (settled) {
+                                return;
+                            }
+                            settled = true;
+                            resolve(value);
+                        };
+                        childProc.once('exit', () => complete(true));
+                        setTimeout(() => complete(false), 3500);
+                    });
+                    logProcessLifecycleSync({
+                        event: 'self_termination',
+                        source: 'cli.start.shutdown',
+                        details: {
+                            reason: 'shutdown_sequence_completed',
+                            signal: sig,
+                            targetPort: resolvedPort,
+                            childPid: childProc.pid ?? null,
+                            childExited
+                        }
+                    });
+                    await applyLifecycleOrThrow({
+                        action: 'server_shutdown_complete',
                         signal: sig,
-                        targetPort: resolvedPort,
-                        remainingPids: still
+                        targetPid: childProc.pid ?? null,
+                        metadata: {
+                            childExited
+                        }
+                    });
+                    if (ctx.isDevPackage) {
+                        await ctx.stopTokenDaemonIfRunning?.();
+                    }
+                    closeServerLogStream();
+                    try {
+                        ctx.exit(0);
+                    }
+                    catch {
+                        /* ignore */
                     }
-                });
-                if (ctx.isDevPackage) {
-                    await ctx.stopTokenDaemonIfRunning?.();
-                }
-                closeServerLogStream();
-                try {
-                    ctx.exit(0);
                 }
-                catch {
-                    /* ignore */
+                catch (error) {
+                    closeServerLogStream();
+                    ctx.logger.error(error instanceof Error ? error.message : String(error));
+                    ctx.exit(1);
                 }
             };
             const onSignal = ctx.onSignal ?? ((sig, cb) => process.on(sig, cb));
@@ -490,6 +537,9 @@ export function createStartCommand(program, ctx) {
                     cleanupKeypress();
                 }
                 catch { /* ignore */ }
+                const codeLabel = typeof code === 'number' && Number.isFinite(code) ? String(code) : 'n/a';
+                const signalLabel = signal || 'none';
+                ctx.logger.info(`[client-exit] RouteCodex exited (code=${codeLabel}, signal=${signalLabel})`);
                 if (signal) {
                     ctx.exit(0);
                 }