@jstn-sdk/rcs 0.1.0

package/dist/hooks/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/hooks/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAwCD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BxF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAUhF;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAQ3F;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAWT;AAED,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAI9B;AAED,UAAU,oBAAoB;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,UAAU,wBAAwB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACtC,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,oBAAoB,GAAG,IAAI,CAAC;CAClE;AAED,UAAU,mBAAmB;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAuFD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAuBT;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,YAAY,CAAC,CAwBvB;AAED;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,MAAM,EACX,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,YAAY,CAAC,CA6CvB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCnF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAS5F"}

package/dist/hooks/session.js

@@ -0,0 +1,332 @@
+/**
+ * Session Lifecycle Manager for roblox-ai-os-creator-skills
+ *
+ * Tracks session start/end, detects stale sessions from crashed launches,
+ * and provides structured logging for session events.
+ */
+import { readFile, writeFile, mkdir, unlink, appendFile, rm } from 'fs/promises';
+import { dirname, join } from 'path';
+import { existsSync, readFileSync } from 'fs';
+import { rcsStateDir, rcsLogsDir, sameFilePath } from '../utils/paths.js';
+import { getStateFilePath } from '../mcp/state-paths.js';
+const SESSION_FILE = 'session.json';
+const HISTORY_FILE = 'session-history.jsonl';
+const SESSION_ID_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
+// No age-based threshold: staleness is determined by PID liveness/identity.
+// Long-running sessions (>2h) are legitimate and should not be reaped.
+function sessionPath(cwd) {
+    return join(rcsStateDir(cwd), SESSION_FILE);
+}
+function historyPath(cwd) {
+    return join(rcsLogsDir(cwd), HISTORY_FILE);
+}
+async function removeDeadSessionHudState(cwd, sessionIds) {
+    const uniqueSessionIds = [...new Set(sessionIds
+            .filter((value) => typeof value === 'string' && value.trim().length > 0)
+            .map((value) => value.trim()))];
+    const candidatePaths = [
+        getStateFilePath('hud-state.json', cwd),
+        ...uniqueSessionIds.map((sessionId) => getStateFilePath('hud-state.json', cwd, sessionId)),
+    ];
+    await Promise.all(candidatePaths.map(async (path) => {
+        try {
+            await rm(path, { force: true });
+        }
+        catch {
+            // best effort only
+        }
+    }));
+}
+/**
+ * Reset session-scoped HUD/metrics files at launch so stale values do not leak
+ * into a new Codex session.
+ */
+export async function resetSessionMetrics(cwd, sessionId) {
+    const rcsDir = join(cwd, '.rcs');
+    const stateDir = rcsStateDir(cwd);
+    await mkdir(rcsDir, { recursive: true });
+    await mkdir(stateDir, { recursive: true });
+    const now = new Date().toISOString();
+    await writeFile(join(rcsDir, 'metrics.json'), JSON.stringify({
+        total_turns: 0,
+        session_turns: 0,
+        last_activity: now,
+        session_input_tokens: 0,
+        session_output_tokens: 0,
+        session_total_tokens: 0,
+        five_hour_limit_pct: 0,
+        weekly_limit_pct: 0,
+    }, null, 2));
+    const hudStatePath = getStateFilePath('hud-state.json', cwd, sessionId);
+    await mkdir(dirname(hudStatePath), { recursive: true });
+    await writeFile(hudStatePath, JSON.stringify({
+        last_turn_at: now,
+        last_progress_at: now,
+        turn_count: 0,
+        last_agent_output: '',
+    }, null, 2));
+}
+/**
+ * Read current session state. Returns null if no session file exists.
+ */
+export async function readSessionState(cwd) {
+    const path = sessionPath(cwd);
+    if (!existsSync(path))
+        return null;
+    try {
+        const content = await readFile(path, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+export function isSessionStateAuthoritativeForCwd(state, cwd) {
+    if (!SESSION_ID_PATTERN.test(state.session_id))
+        return false;
+    if (typeof state.cwd === 'string' && state.cwd.trim() !== '') {
+        return sameFilePath(state.cwd, cwd);
+    }
+    return true;
+}
+export function isSessionStateUsable(state, cwd, options = {}) {
+    if (!isSessionStateAuthoritativeForCwd(state, cwd))
+        return false;
+    const hasPidMetadata = Number.isInteger(state.pid) && state.pid > 0;
+    const hasLinuxIdentityMetadata = typeof state.pid_start_ticks === 'number'
+        || typeof state.pid_cmdline === 'string';
+    if (hasPidMetadata || hasLinuxIdentityMetadata) {
+        return !isSessionStale(state, options);
+    }
+    return true;
+}
+export async function readUsableSessionState(cwd, options = {}) {
+    const state = await readSessionState(cwd);
+    if (!state)
+        return null;
+    return isSessionStateUsable(state, cwd, options) ? state : null;
+}
+function defaultIsPidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function parseLinuxProcStartTicks(statContent) {
+    const commandEnd = statContent.lastIndexOf(')');
+    if (commandEnd === -1)
+        return null;
+    const remainder = statContent.slice(commandEnd + 1).trim();
+    const fields = remainder.split(/\s+/);
+    if (fields.length <= 19)
+        return null;
+    const startTicks = Number(fields[19]);
+    return Number.isFinite(startTicks) ? startTicks : null;
+}
+function normalizeCmdline(cmdline) {
+    if (!cmdline)
+        return null;
+    const normalized = cmdline.replace(/\s+/g, ' ').trim();
+    return normalized.length > 0 ? normalized : null;
+}
+function readLinuxProcessIdentity(pid) {
+    try {
+        const stat = readFileSync(`/proc/${pid}/stat`, 'utf-8');
+        const startTicks = parseLinuxProcStartTicks(stat);
+        if (startTicks == null)
+            return null;
+        let cmdline = null;
+        try {
+            cmdline = readFileSync(`/proc/${pid}/cmdline`, 'utf-8')
+                .replace(/\u0000+/g, ' ')
+                .trim();
+        }
+        catch {
+            cmdline = null;
+        }
+        return {
+            startTicks,
+            cmdline: normalizeCmdline(cmdline),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function createSessionState(cwd, sessionId, pid, platform, linuxIdentity, options = {}) {
+    const nowIso = options.nowIso ?? new Date().toISOString();
+    const nativeSessionId = typeof options.nativeSessionId === 'string' && options.nativeSessionId.trim()
+        ? options.nativeSessionId.trim()
+        : undefined;
+    const tmuxSessionName = typeof options.tmuxSessionName === 'string' && options.tmuxSessionName.trim()
+        ? options.tmuxSessionName.trim()
+        : undefined;
+    return {
+        session_id: sessionId,
+        ...(nativeSessionId ? { native_session_id: nativeSessionId } : {}),
+        started_at: options.startedAt ?? nowIso,
+        cwd,
+        pid,
+        platform,
+        pid_start_ticks: linuxIdentity?.startTicks,
+        pid_cmdline: linuxIdentity?.cmdline ?? undefined,
+        ...(tmuxSessionName ? { tmux_session_name: tmuxSessionName } : {}),
+    };
+}
+/**
+ * Check if a session is stale.
+ * - If the owning PID is dead, it is stale.
+ * - On Linux, require process identity validation (start ticks, optional cmdline).
+ *   If identity cannot be validated, treat the session as stale.
+ */
+export function isSessionStale(state, options = {}) {
+    if (!Number.isInteger(state.pid) || state.pid <= 0)
+        return true;
+    const isPidAlive = options.isPidAlive ?? defaultIsPidAlive;
+    if (!isPidAlive(state.pid))
+        return true;
+    const platform = options.platform ?? process.platform;
+    if (platform !== 'linux')
+        return false;
+    const readIdentity = options.readLinuxIdentity ?? readLinuxProcessIdentity;
+    const liveIdentity = readIdentity(state.pid);
+    if (!liveIdentity)
+        return true;
+    if (typeof state.pid_start_ticks !== 'number')
+        return true;
+    if (state.pid_start_ticks !== liveIdentity.startTicks)
+        return true;
+    const expectedCmdline = normalizeCmdline(state.pid_cmdline);
+    if (expectedCmdline) {
+        const liveCmdline = normalizeCmdline(liveIdentity.cmdline);
+        if (!liveCmdline || liveCmdline !== expectedCmdline)
+            return true;
+    }
+    return false;
+}
+/**
+ * Write session start state.
+ */
+export async function writeSessionStart(cwd, sessionId, options = {}) {
+    const stateDir = rcsStateDir(cwd);
+    await mkdir(stateDir, { recursive: true });
+    const pid = Number.isInteger(options.pid) && options.pid && options.pid > 0
+        ? options.pid
+        : process.pid;
+    const platform = options.platform ?? process.platform;
+    const linuxIdentity = platform === 'linux'
+        ? readLinuxProcessIdentity(pid)
+        : null;
+    const state = createSessionState(cwd, sessionId, pid, platform, linuxIdentity, {
+        nativeSessionId: options.nativeSessionId,
+        tmuxSessionName: options.tmuxSessionName,
+    });
+    await writeFile(sessionPath(cwd), JSON.stringify(state, null, 2));
+    await appendToLog(cwd, {
+        event: 'session_start',
+        session_id: sessionId,
+        ...(state.native_session_id ? { native_session_id: state.native_session_id } : {}),
+        pid,
+        timestamp: state.started_at,
+    });
+    return state;
+}
+/**
+ * Reconcile a native/Codex SessionStart with the canonical RCS launch session.
+ * If an authoritative current session already exists for this cwd/run, preserve
+ * its RCS scope id and refresh PID/native metadata. Otherwise establish a fresh
+ * canonical session using the native session id.
+ */
+export async function reconcileNativeSessionStart(cwd, nativeSessionId, options = {}) {
+    const existing = await readUsableSessionState(cwd, {
+        ...(options.platform ? { platform: options.platform } : {}),
+    });
+    if (!existing) {
+        return await writeSessionStart(cwd, nativeSessionId, {
+            ...options,
+            nativeSessionId,
+        });
+    }
+    const existingNativeSessionId = typeof existing.native_session_id === 'string'
+        ? existing.native_session_id.trim()
+        : '';
+    if (existingNativeSessionId && existingNativeSessionId !== nativeSessionId) {
+        return await writeSessionStart(cwd, nativeSessionId, {
+            ...options,
+            nativeSessionId,
+        });
+    }
+    const pid = Number.isInteger(options.pid) && options.pid && options.pid > 0
+        ? options.pid
+        : process.pid;
+    const platform = options.platform ?? process.platform;
+    const linuxIdentity = platform === 'linux'
+        ? readLinuxProcessIdentity(pid)
+        : null;
+    const nowIso = new Date().toISOString();
+    const state = createSessionState(cwd, existing.session_id, pid, platform, linuxIdentity, {
+        nowIso,
+        nativeSessionId,
+        startedAt: existing.started_at,
+        tmuxSessionName: existing.tmux_session_name,
+    });
+    await writeFile(sessionPath(cwd), JSON.stringify(state, null, 2));
+    await appendToLog(cwd, {
+        event: 'session_start_reconciled',
+        session_id: state.session_id,
+        native_session_id: nativeSessionId,
+        pid,
+        timestamp: nowIso,
+    });
+    return state;
+}
+/**
+ * Write session end: archive to history, delete session.json.
+ */
+export async function writeSessionEnd(cwd, sessionId) {
+    const state = await readSessionState(cwd);
+    const endTime = new Date().toISOString();
+    // Archive to session history
+    const logsDir = rcsLogsDir(cwd);
+    await mkdir(logsDir, { recursive: true });
+    const historyEntry = {
+        session_id: state?.session_id || sessionId,
+        ...(state?.native_session_id ? { native_session_id: state.native_session_id } : {}),
+        started_at: state?.started_at || 'unknown',
+        ended_at: endTime,
+        cwd,
+        pid: state?.pid || process.pid,
+    };
+    await appendFile(historyPath(cwd), JSON.stringify(historyEntry) + '\n');
+    await removeDeadSessionHudState(cwd, [
+        state?.session_id,
+        state?.native_session_id,
+        sessionId,
+    ]);
+    // Delete session.json
+    try {
+        await unlink(sessionPath(cwd));
+    }
+    catch { /* already gone */ }
+    await appendToLog(cwd, {
+        event: 'session_end',
+        session_id: state?.session_id || sessionId,
+        ...(state?.native_session_id ? { native_session_id: state.native_session_id } : {}),
+        timestamp: endTime,
+    });
+}
+/**
+ * Append a structured JSONL entry to the daily log file.
+ */
+export async function appendToLog(cwd, entry) {
+    const logsDir = rcsLogsDir(cwd);
+    await mkdir(logsDir, { recursive: true });
+    const date = new Date().toISOString().slice(0, 10); // YYYY-MM-DD
+    const logFile = join(logsDir, `rcs-${date}.jsonl`);
+    const line = JSON.stringify({ ...entry, _ts: new Date().toISOString() }) + '\n';
+    await appendFile(logFile, line);
+}
+//# sourceMappingURL=session.js.map

package/dist/hooks/session.js.map

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

package/dist/hooks/task-size-detector.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Task Size Detector — ported from OMC src/hooks/task-size-detector/index.ts
+ *
+ * IMPORTANT: In OMC, this module runs at prompt time via bridge.ts hook interception
+ * (mandatory enforcement). In RCS, Codex CLI does not support pre-tool hooks, so this
+ * module serves as:
+ *   1. Instruction generator — feeds generateKeywordDetectionSection() in emulator.ts
+ *   2. Test infrastructure — verifies gate logic correctness
+ *   3. Future hook readiness — will be promoted to runtime enforcement when Codex CLI
+ *      adds pre-hook support
+ *
+ * The actual gate enforcement in RCS is advisory: AGENTS.md instructs the model to
+ * self-enforce gate behavior. The model may skip the gate under edge cases (long context,
+ * prompt injection, model confusion).
+ */
+export type TaskSize = 'small' | 'medium' | 'large';
+export interface TaskSizeResult {
+    size: TaskSize;
+    reason: string;
+    wordCount: number;
+    hasEscapeHatch: boolean;
+    escapePrefixUsed?: string;
+}
+/**
+ * Word limit thresholds for task size classification.
+ * Prompts under smallLimit are classified as small (unless overridden).
+ * Prompts over largeLimit are classified as large.
+ */
+export interface TaskSizeThresholds {
+    smallWordLimit: number;
+    largeWordLimit: number;
+}
+export declare const DEFAULT_THRESHOLDS: TaskSizeThresholds;
+/**
+ * Count words in a prompt (splits on whitespace).
+ */
+export declare function countWords(text: string): number;
+/**
+ * Check if the prompt starts with a lightweight escape hatch prefix.
+ * Returns the prefix if found, null otherwise.
+ */
+export declare function detectEscapeHatch(text: string): string | null;
+/**
+ * Check for small task signal patterns (single file, typo, minor, etc.)
+ */
+export declare function hasSmallTaskSignals(text: string): boolean;
+/**
+ * Check for large task signal patterns (architecture, refactor, entire codebase, etc.)
+ */
+export declare function hasLargeTaskSignals(text: string): boolean;
+/**
+ * Classify a user prompt as small, medium, or large.
+ *
+ * Classification rules (in priority order):
+ * 1. Escape hatch prefix (`quick:`, `simple:`, etc.) → always small
+ * 2. Large task signals (architecture, refactor, entire codebase) → large
+ * 3. Prompt > largeWordLimit words → large
+ * 4. Small task signals (typo, single file, rename) AND prompt < largeWordLimit → small
+ * 5. Prompt < smallWordLimit words → small
+ * 6. Everything else → medium
+ */
+export declare function classifyTaskSize(text: string, thresholds?: TaskSizeThresholds): TaskSizeResult;
+/**
+ * Heavy orchestration keyword types that should be suppressed for small tasks.
+ * These modes spin up multiple agents and are overkill for single-file/minor changes.
+ */
+export declare const HEAVY_MODE_KEYWORDS: Set<string>;
+/**
+ * Check if a keyword type is a heavy orchestration mode.
+ */
+export declare function isHeavyMode(keywordType: string): boolean;
+//# sourceMappingURL=task-size-detector.d.ts.map

package/dist/hooks/task-size-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-size-detector.d.ts","sourceRoot":"","sources":["../../src/hooks/task-size-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,kBAAkB,EAAE,kBAGhC,CAAC;AAmEF;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ7D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,kBAAuC,GAClD,cAAc,CAiEhB;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,aAQ9B,CAAC;AAEH;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/hooks/task-size-detector.js

@@ -0,0 +1,202 @@
+/**
+ * Task Size Detector — ported from OMC src/hooks/task-size-detector/index.ts
+ *
+ * IMPORTANT: In OMC, this module runs at prompt time via bridge.ts hook interception
+ * (mandatory enforcement). In RCS, Codex CLI does not support pre-tool hooks, so this
+ * module serves as:
+ *   1. Instruction generator — feeds generateKeywordDetectionSection() in emulator.ts
+ *   2. Test infrastructure — verifies gate logic correctness
+ *   3. Future hook readiness — will be promoted to runtime enforcement when Codex CLI
+ *      adds pre-hook support
+ *
+ * The actual gate enforcement in RCS is advisory: AGENTS.md instructs the model to
+ * self-enforce gate behavior. The model may skip the gate under edge cases (long context,
+ * prompt injection, model confusion).
+ */
+export const DEFAULT_THRESHOLDS = {
+    smallWordLimit: 50,
+    largeWordLimit: 200,
+};
+/**
+ * Escape hatch prefixes that force small/lightweight mode.
+ * Users can prefix their prompt with these to skip heavy orchestration.
+ */
+const ESCAPE_HATCH_PREFIXES = [
+    'quick:',
+    'simple:',
+    'tiny:',
+    'minor:',
+    'small:',
+    'just:',
+    'only:',
+];
+/**
+ * Keywords/phrases that strongly indicate a small, bounded task.
+ * If any of these appear and no large indicators are present, bias toward small.
+ */
+const SMALL_TASK_SIGNALS = [
+    /\btypo\b/i,
+    /\bspelling\b/i,
+    /\brename\s+\w+\s+to\b/i,
+    /\bone[\s-]liner?\b/i,
+    /\bone[\s-]line\s+fix\b/i,
+    /\bsingle\s+file\b/i,
+    /\bin\s+this\s+file\b/i,
+    /\bthis\s+function\b/i,
+    /\bthis\s+line\b/i,
+    /\bminor\s+(fix|change|update|tweak)\b/i,
+    /\bfix\s+(a\s+)?typo\b/i,
+    /\badd\s+a?\s*comment\b/i,
+    /\bwhitespace\b/i,
+    /\bindentation\b/i,
+    /\bformat(ting)?\s+(this|the)\b/i,
+    /\bquick\s+fix\b/i,
+    /\bsmall\s+(fix|change|tweak|update)\b/i,
+    /\bupdate\s+(the\s+)?version\b/i,
+    /\bbump\s+version\b/i,
+];
+/**
+ * Keywords/phrases that strongly indicate a large, cross-cutting task.
+ * These bias toward large classification even for short prompts.
+ */
+const LARGE_TASK_SIGNALS = [
+    /\barchitect(ure|ural)?\b/i,
+    /\brefactor\b/i,
+    /\bredesign\b/i,
+    /\bfrom\s+scratch\b/i,
+    /\bcross[\s-]cutting\b/i,
+    /\bentire\s+(codebase|project|application|app|system)\b/i,
+    /\ball\s+(files|modules|components)\b/i,
+    /\bmultiple\s+files\b/i,
+    /\bacross\s+(the\s+)?(codebase|project|files|modules)\b/i,
+    /\bsystem[\s-]wide\b/i,
+    /\bmigrat(e|ion)\b/i,
+    /\bfull[\s-]stack\b/i,
+    /\bend[\s-]to[\s-]end\b/i,
+    /\boverhaul\b/i,
+    /\bcomprehensive\b/i,
+    /\bextensive\b/i,
+    /\bimplement\s+(a\s+)?(new\s+)?system\b/i,
+    /\bbuild\s+(a\s+)?(complete|full|new)\b/i,
+];
+/**
+ * Count words in a prompt (splits on whitespace).
+ */
+export function countWords(text) {
+    return text.trim().split(/\s+/).filter(Boolean).length;
+}
+/**
+ * Check if the prompt starts with a lightweight escape hatch prefix.
+ * Returns the prefix if found, null otherwise.
+ */
+export function detectEscapeHatch(text) {
+    const trimmed = text.trim().toLowerCase();
+    for (const prefix of ESCAPE_HATCH_PREFIXES) {
+        if (trimmed.startsWith(prefix)) {
+            return prefix;
+        }
+    }
+    return null;
+}
+/**
+ * Check for small task signal patterns (single file, typo, minor, etc.)
+ */
+export function hasSmallTaskSignals(text) {
+    return SMALL_TASK_SIGNALS.some(pattern => pattern.test(text));
+}
+/**
+ * Check for large task signal patterns (architecture, refactor, entire codebase, etc.)
+ */
+export function hasLargeTaskSignals(text) {
+    return LARGE_TASK_SIGNALS.some(pattern => pattern.test(text));
+}
+/**
+ * Classify a user prompt as small, medium, or large.
+ *
+ * Classification rules (in priority order):
+ * 1. Escape hatch prefix (`quick:`, `simple:`, etc.) → always small
+ * 2. Large task signals (architecture, refactor, entire codebase) → large
+ * 3. Prompt > largeWordLimit words → large
+ * 4. Small task signals (typo, single file, rename) AND prompt < largeWordLimit → small
+ * 5. Prompt < smallWordLimit words → small
+ * 6. Everything else → medium
+ */
+export function classifyTaskSize(text, thresholds = DEFAULT_THRESHOLDS) {
+    const wordCount = countWords(text);
+    const escapePrefix = detectEscapeHatch(text);
+    // Rule 1: Explicit escape hatch → always small
+    if (escapePrefix !== null) {
+        return {
+            size: 'small',
+            reason: `Escape hatch prefix detected: "${escapePrefix}"`,
+            wordCount,
+            hasEscapeHatch: true,
+            escapePrefixUsed: escapePrefix,
+        };
+    }
+    const hasLarge = hasLargeTaskSignals(text);
+    const hasSmall = hasSmallTaskSignals(text);
+    // Rule 2: Large task signals always classify as large (explicit scope indicators beat word count)
+    if (hasLarge) {
+        return {
+            size: 'large',
+            reason: 'Large task signals detected (architecture/refactor/cross-cutting scope)',
+            wordCount,
+            hasEscapeHatch: false,
+        };
+    }
+    // Rule 3: Long prompt → large
+    if (wordCount > thresholds.largeWordLimit) {
+        return {
+            size: 'large',
+            reason: `Prompt length (${wordCount} words) exceeds large task threshold (${thresholds.largeWordLimit})`,
+            wordCount,
+            hasEscapeHatch: false,
+        };
+    }
+    // Rule 4: Small signals + within limits → small
+    if (hasSmall && !hasLarge) {
+        return {
+            size: 'small',
+            reason: 'Small task signals detected (single file / minor change)',
+            wordCount,
+            hasEscapeHatch: false,
+        };
+    }
+    // Rule 5: Short prompt → small
+    if (wordCount <= thresholds.smallWordLimit) {
+        return {
+            size: 'small',
+            reason: `Prompt length (${wordCount} words) is within small task threshold (${thresholds.smallWordLimit})`,
+            wordCount,
+            hasEscapeHatch: false,
+        };
+    }
+    // Rule 6: Default → medium
+    return {
+        size: 'medium',
+        reason: `Prompt length (${wordCount} words) is in medium range`,
+        wordCount,
+        hasEscapeHatch: false,
+    };
+}
+/**
+ * Heavy orchestration keyword types that should be suppressed for small tasks.
+ * These modes spin up multiple agents and are overkill for single-file/minor changes.
+ */
+export const HEAVY_MODE_KEYWORDS = new Set([
+    'ralph',
+    'autopilot',
+    'team',
+    'ultrawork',
+    'swarm',
+    'ralplan',
+    'ccg',
+]);
+/**
+ * Check if a keyword type is a heavy orchestration mode.
+ */
+export function isHeavyMode(keywordType) {
+    return HEAVY_MODE_KEYWORDS.has(keywordType);
+}
+//# sourceMappingURL=task-size-detector.js.map

package/dist/hooks/task-size-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-size-detector.js","sourceRoot":"","sources":["../../src/hooks/task-size-detector.ts"],"names":[],"mappings":"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"}

package/dist/hooks/triage-config.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Triage Feature Gate Config Reader
+ *
+ * Reads promptRouting.triage.enabled from codexHome()/.rcs-config.json.
+ * Defaults to enabled when the config file is absent or the triage flag is
+ * omitted from an otherwise valid config object (rollout default).
+ * Fails closed (enabled: false) when the file exists but is malformed.
+ */
+export type TriageConfigStatus = "enabled" | "disabled" | "defaulted" | "invalid";
+export interface TriageConfig {
+    enabled: boolean;
+    status: TriageConfigStatus;
+    source: "default" | "file" | "invalid";
+    path: string;
+}
+/**
+ * Read and cache the triage feature gate config.
+ *
+ * Source: promptRouting.triage.enabled in codexHome()/.rcs-config.json
+ *
+ * - Missing file → enabled: true, status: "defaulted" (rollout default)
+ * - Valid object that omits promptRouting.triage.enabled → enabled: true, status: "defaulted"
+ * - File with enabled: true → enabled: true, status: "enabled"
+ * - File with enabled: false → enabled: false, status: "disabled"
+ * - Malformed JSON or wrong shape → enabled: false, status: "invalid" (fail closed)
+ * - Caches result for the process lifetime
+ */
+export declare function readTriageConfig(): TriageConfig;
+/**
+ * Clear the cached triage config. Call in tests to reset state.
+ */
+export declare function resetTriageConfigCache(): void;
+//# sourceMappingURL=triage-config.d.ts.map