@phuetz/code-buddy 0.1.25 → 0.1.26

package/dist/context/restorable-compression.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Restorable Compression — Manus AI context engineering pattern
+ *
+ * Instead of lossy summarisation (which discards content permanently),
+ * this module extracts structural identifiers (file paths, URLs, tool
+ * call IDs, line ranges) from messages that are about to be dropped,
+ * then stores the original content indexed by those identifiers.
+ *
+ * The agent can later call `restore_context(identifier)` to re-fetch
+ * the full content on demand, making context compression reversible.
+ *
+ * This is complementary to summarisation: a short summary of a long
+ * file-read result is kept in the context, while the full content is
+ * recoverable via its file path identifier.
+ *
+ * Ref: "Context Engineering for AI Agents: Lessons from Building Manus"
+ * https://manus.im/blog/Context-Engineering-for-AI-Agents-Lessons-from-Building-Manus
+ */
+export interface CompressibleMessage {
+    role: string;
+    content: string | null;
+    tool_call_id?: string;
+    name?: string;
+}
+export interface CompressionResult {
+    /** Compressed messages (identifiers preserved, full content dropped) */
+    messages: CompressibleMessage[];
+    /** Identifiers that were extracted and stored */
+    identifiers: string[];
+    /** Number of tokens saved (estimated) */
+    tokensSaved: number;
+}
+export interface RestoreResult {
+    found: boolean;
+    content: string;
+    identifier: string;
+}
+export declare class RestorableCompressor {
+    /** identifier → original content */
+    private store;
+    /**
+     * Compress a slice of messages that are about to be dropped.
+     *
+     * For each message, identifiers are extracted and the full content is
+     * stored. The message content is replaced with a compact stub listing
+     * the available identifiers.
+     */
+    compress(messages: CompressibleMessage[]): CompressionResult;
+    /**
+     * Restore the original content for an identifier.
+     *
+     * For file path identifiers, attempts to read from disk as a fallback.
+     * For URLs, returns a hint to use web_fetch.
+     */
+    restore(identifier: string): RestoreResult;
+    /**
+     * Persist a tool result to disk under `.codebuddy/tool-results/<callId>.txt`.
+     * This gives the restore_context tool a reliable disk-backed source and enables
+     * the compact/full dual-representation pattern (Manus AI #19).
+     *
+     * @param callId  - Tool call ID (e.g. call_abc123 or toolu_xyz)
+     * @param content - Full tool output
+     * @param workDir - Working directory (defaults to process.cwd())
+     */
+    writeToolResult(callId: string, content: string, workDir?: string): void;
+    /**
+     * Read a tool result from disk (`.codebuddy/tool-results/<callId>.txt`).
+     * Used by restore_context when the in-memory store has been evicted.
+     */
+    private readToolResultFromDisk;
+    /** List all stored identifiers */
+    listIdentifiers(): string[];
+    /** Total number of bytes stored */
+    storeSize(): number;
+    /** Evict oldest entries if store exceeds maxBytes (default 10 MB) */
+    evict(maxBytes?: number): void;
+}
+export declare function getRestorableCompressor(): RestorableCompressor;
+/** Reset singleton (for tests) */
+export declare function resetRestorableCompressor(): void;

package/dist/context/restorable-compression.js

@@ -0,0 +1,228 @@
+/**
+ * Restorable Compression — Manus AI context engineering pattern
+ *
+ * Instead of lossy summarisation (which discards content permanently),
+ * this module extracts structural identifiers (file paths, URLs, tool
+ * call IDs, line ranges) from messages that are about to be dropped,
+ * then stores the original content indexed by those identifiers.
+ *
+ * The agent can later call `restore_context(identifier)` to re-fetch
+ * the full content on demand, making context compression reversible.
+ *
+ * This is complementary to summarisation: a short summary of a long
+ * file-read result is kept in the context, while the full content is
+ * recoverable via its file path identifier.
+ *
+ * Ref: "Context Engineering for AI Agents: Lessons from Building Manus"
+ * https://manus.im/blog/Context-Engineering-for-AI-Agents-Lessons-from-Building-Manus
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { logger } from '../utils/logger.js';
+// ============================================================================
+// Identifier extractors
+// ============================================================================
+// File paths: absolute or relative, with extensions
+const FILE_PATH_RE = /(?:^|\s|["'`(])(\/?(?:[\w.-]+\/)*[\w.-]+\.(?:ts|js|py|json|md|txt|yaml|yml|sh|go|rs|java|cpp|c|h|rb|php|swift|kt|cs|html|css|sql|env|toml|cfg|conf|xml)(?::\d+(?:-\d+)?)?)/g;
+// URLs
+const URL_RE = /https?:\/\/[^\s"'<>)]+/g;
+// Tool call IDs (Anthropic/OpenAI style)
+const TOOL_CALL_ID_RE = /\b(call_[a-zA-Z0-9]+|toolu_[a-zA-Z0-9]+)\b/g;
+function extractIdentifiers(text) {
+    const ids = new Set();
+    for (const m of text.matchAll(FILE_PATH_RE)) {
+        const raw = m[1].trim().replace(/['"`:]/g, '');
+        if (raw.length > 3)
+            ids.add(raw);
+    }
+    for (const m of text.matchAll(URL_RE)) {
+        const url = m[0].replace(/[.,;)]+$/, ''); // strip trailing punctuation
+        ids.add(url);
+    }
+    for (const m of text.matchAll(TOOL_CALL_ID_RE)) {
+        ids.add(m[1]);
+    }
+    return [...ids];
+}
+// ============================================================================
+// RestorableCompressor
+// ============================================================================
+export class RestorableCompressor {
+    /** identifier → original content */
+    store = new Map();
+    /**
+     * Compress a slice of messages that are about to be dropped.
+     *
+     * For each message, identifiers are extracted and the full content is
+     * stored. The message content is replaced with a compact stub listing
+     * the available identifiers.
+     */
+    compress(messages) {
+        const compressed = [];
+        const allIdentifiers = [];
+        let tokensSaved = 0;
+        for (const msg of messages) {
+            const content = msg.content ?? '';
+            if (!content || content.length < 200) {
+                // Short messages: keep as-is
+                compressed.push(msg);
+                continue;
+            }
+            const ids = extractIdentifiers(content);
+            if (ids.length === 0) {
+                // No identifiers to preserve — keep original
+                compressed.push(msg);
+                continue;
+            }
+            // Store original content indexed by each identifier
+            for (const id of ids) {
+                if (!this.store.has(id)) {
+                    this.store.set(id, content);
+                }
+            }
+            allIdentifiers.push(...ids);
+            tokensSaved += Math.floor(content.length / 4); // rough token estimate
+            // Replace with a compact stub
+            const stub = `[Content compressed — identifiers: ${ids.slice(0, 5).join(', ')}${ids.length > 5 ? ` +${ids.length - 5} more` : ''}. Use restore_context(identifier) to retrieve.]`;
+            compressed.push({ ...msg, content: stub });
+            logger.debug('RestorableCompressor: compressed message', {
+                identifiers: ids.length,
+                originalLen: content.length,
+                stubLen: stub.length,
+            });
+        }
+        return {
+            messages: compressed,
+            identifiers: [...new Set(allIdentifiers)],
+            tokensSaved,
+        };
+    }
+    /**
+     * Restore the original content for an identifier.
+     *
+     * For file path identifiers, attempts to read from disk as a fallback.
+     * For URLs, returns a hint to use web_fetch.
+     */
+    restore(identifier) {
+        // 1. Check in-memory store
+        const stored = this.store.get(identifier);
+        if (stored) {
+            return { found: true, content: stored, identifier };
+        }
+        // 2. Tool call ID — check disk-backed store
+        if (identifier.startsWith('call_') || identifier.startsWith('toulu_') || identifier.startsWith('toolu_')) {
+            const diskContent = this.readToolResultFromDisk(identifier);
+            if (diskContent) {
+                return { found: true, content: diskContent, identifier };
+            }
+        }
+        // 3. File path fallback — try reading from disk
+        if (!identifier.startsWith('http') && !identifier.startsWith('call_') && !identifier.startsWith('toolu_')) {
+            try {
+                // Strip line range if present (file.ts:10-50 → file.ts)
+                const filePath = identifier.split(':')[0];
+                if (fs.existsSync(filePath)) {
+                    const content = fs.readFileSync(filePath, 'utf-8');
+                    this.store.set(identifier, content); // cache for future
+                    return { found: true, content, identifier };
+                }
+            }
+            catch {
+                // ignore
+            }
+        }
+        // 3. URL hint
+        if (identifier.startsWith('http')) {
+            return {
+                found: false,
+                content: `URL content not cached. Use web_fetch("${identifier}") to retrieve it.`,
+                identifier,
+            };
+        }
+        return {
+            found: false,
+            content: `Identifier "${identifier}" not found in restoration store.`,
+            identifier,
+        };
+    }
+    /**
+     * Persist a tool result to disk under `.codebuddy/tool-results/<callId>.txt`.
+     * This gives the restore_context tool a reliable disk-backed source and enables
+     * the compact/full dual-representation pattern (Manus AI #19).
+     *
+     * @param callId  - Tool call ID (e.g. call_abc123 or toolu_xyz)
+     * @param content - Full tool output
+     * @param workDir - Working directory (defaults to process.cwd())
+     */
+    writeToolResult(callId, content, workDir = process.cwd()) {
+        try {
+            const dir = path.join(workDir, '.codebuddy', 'tool-results');
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            const filePath = path.join(dir, `${callId}.txt`);
+            fs.writeFileSync(filePath, content, 'utf-8');
+            // Also store in memory for fast access
+            this.store.set(callId, content);
+        }
+        catch (err) {
+            // Non-critical: disk write failure should not break tool execution
+            logger.debug('RestorableCompressor: failed to write tool result to disk', { callId, err });
+        }
+    }
+    /**
+     * Read a tool result from disk (`.codebuddy/tool-results/<callId>.txt`).
+     * Used by restore_context when the in-memory store has been evicted.
+     */
+    readToolResultFromDisk(callId, workDir = process.cwd()) {
+        try {
+            const filePath = path.join(workDir, '.codebuddy', 'tool-results', `${callId}.txt`);
+            if (fs.existsSync(filePath)) {
+                const content = fs.readFileSync(filePath, 'utf-8');
+                this.store.set(callId, content); // cache back into memory
+                return content;
+            }
+        }
+        catch {
+            // ignore
+        }
+        return null;
+    }
+    /** List all stored identifiers */
+    listIdentifiers() {
+        return [...this.store.keys()];
+    }
+    /** Total number of bytes stored */
+    storeSize() {
+        let total = 0;
+        for (const v of this.store.values())
+            total += v.length;
+        return total;
+    }
+    /** Evict oldest entries if store exceeds maxBytes (default 10 MB) */
+    evict(maxBytes = 10 * 1024 * 1024) {
+        while (this.storeSize() > maxBytes && this.store.size > 0) {
+            const firstKey = this.store.keys().next().value;
+            if (firstKey !== undefined) {
+                this.store.delete(firstKey);
+            }
+            else {
+                break;
+            }
+        }
+    }
+}
+// ============================================================================
+// Singleton
+// ============================================================================
+let _instance = null;
+export function getRestorableCompressor() {
+    if (!_instance)
+        _instance = new RestorableCompressor();
+    return _instance;
+}
+/** Reset singleton (for tests) */
+export function resetRestorableCompressor() {
+    _instance = null;
+}
+//# sourceMappingURL=restorable-compression.js.map

package/dist/context/restorable-compression.js.map

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

package/dist/daemon/daily-reset.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Daily Session Reset — OpenClaw-inspired context boundary
+ *
+ * Automatically resets the conversation context at a configurable time
+ * each day (default: 04:00 local time). This prevents unbounded context
+ * growth in long-running daemon sessions and mirrors the daily boundary
+ * reset pattern in OpenClaw.
+ *
+ * What is reset:
+ * - In-memory conversation history (messages array)
+ * - Cached tool selection results
+ *
+ * What is PRESERVED:
+ * - MEMORY.md (durable facts)
+ * - HEARTBEAT.md (task checklist)
+ * - Session metadata (model, cost counters)
+ * - All files on disk (todo.md, PLAN.md, etc.)
+ *
+ * After reset the agent posts a summary message noting the daily boundary
+ * so the conversation log remains intelligible.
+ *
+ * Ref: OpenClaw session management compaction docs
+ * https://docs.openclaw.ai/reference/session-management-compaction
+ */
+import { EventEmitter } from 'events';
+export interface DailyResetConfig {
+    /** Hour of the day for the reset (0-23). Default: 4 */
+    resetHour: number;
+    /** Minute of the reset (0-59). Default: 0 */
+    resetMinute: number;
+    /** IANA timezone identifier. Default: system local */
+    timezone?: string;
+    /** Whether the daily reset is enabled. Default: true */
+    enabled: boolean;
+    /** Post a summary message after reset. Default: true */
+    postSummary: boolean;
+}
+export interface ResetResult {
+    triggeredAt: Date;
+    /** Number of messages cleared */
+    messagesCleared: number;
+    /** Summary message posted to conversation (or null if postSummary is false) */
+    summaryMessage: string | null;
+}
+export declare class DailyResetManager extends EventEmitter {
+    private config;
+    private timer;
+    private lastResetDate;
+    constructor(config?: Partial<DailyResetConfig>);
+    /**
+     * Start the daily reset scheduler.
+     * Call this once when the daemon starts.
+     */
+    start(): void;
+    stop(): void;
+    /** Returns milliseconds until the next reset window. */
+    msUntilNextReset(): number;
+    private scheduleNext;
+    /**
+     * Perform the daily reset on the provided messages array (modified in-place).
+     *
+     * @param messages - The agent's LLM messages array to clear
+     * @param systemMessage - Optional system message to keep at position [0]
+     */
+    runReset(messages: Array<{
+        role: string;
+        content: string | null;
+    }>, systemMessage?: {
+        role: string;
+        content: string;
+    }): Promise<ResetResult>;
+    private buildSummaryMessage;
+    getConfig(): Readonly<DailyResetConfig>;
+    isEnabled(): boolean;
+}
+export declare function getDailyResetManager(config?: Partial<DailyResetConfig>): DailyResetManager;
+export declare function resetDailyResetManager(): void;

package/dist/daemon/daily-reset.js

@@ -0,0 +1,175 @@
+/**
+ * Daily Session Reset — OpenClaw-inspired context boundary
+ *
+ * Automatically resets the conversation context at a configurable time
+ * each day (default: 04:00 local time). This prevents unbounded context
+ * growth in long-running daemon sessions and mirrors the daily boundary
+ * reset pattern in OpenClaw.
+ *
+ * What is reset:
+ * - In-memory conversation history (messages array)
+ * - Cached tool selection results
+ *
+ * What is PRESERVED:
+ * - MEMORY.md (durable facts)
+ * - HEARTBEAT.md (task checklist)
+ * - Session metadata (model, cost counters)
+ * - All files on disk (todo.md, PLAN.md, etc.)
+ *
+ * After reset the agent posts a summary message noting the daily boundary
+ * so the conversation log remains intelligible.
+ *
+ * Ref: OpenClaw session management compaction docs
+ * https://docs.openclaw.ai/reference/session-management-compaction
+ */
+import { EventEmitter } from 'events';
+import { logger } from '../utils/logger.js';
+// ============================================================================
+// DailyResetManager
+// ============================================================================
+export class DailyResetManager extends EventEmitter {
+    config;
+    timer = null;
+    lastResetDate = null; // 'YYYY-MM-DD'
+    constructor(config = {}) {
+        super();
+        this.config = {
+            resetHour: config.resetHour ?? 4,
+            resetMinute: config.resetMinute ?? 0,
+            timezone: config.timezone,
+            enabled: config.enabled ?? true,
+            postSummary: config.postSummary ?? true,
+        };
+    }
+    // --------------------------------------------------------------------------
+    // Lifecycle
+    // --------------------------------------------------------------------------
+    /**
+     * Start the daily reset scheduler.
+     * Call this once when the daemon starts.
+     */
+    start() {
+        if (!this.config.enabled)
+            return;
+        this.scheduleNext();
+        logger.debug('DailyResetManager started', {
+            resetHour: this.config.resetHour,
+            resetMinute: this.config.resetMinute,
+        });
+    }
+    stop() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+    // --------------------------------------------------------------------------
+    // Scheduling
+    // --------------------------------------------------------------------------
+    /** Returns milliseconds until the next reset window. */
+    msUntilNextReset() {
+        const now = new Date();
+        const next = new Date(now);
+        next.setHours(this.config.resetHour, this.config.resetMinute, 0, 0);
+        if (next <= now) {
+            // Already past today's reset time — schedule for tomorrow
+            next.setDate(next.getDate() + 1);
+        }
+        return next.getTime() - now.getTime();
+    }
+    scheduleNext() {
+        const ms = this.msUntilNextReset();
+        logger.debug('DailyResetManager: next reset in', {
+            minutes: Math.round(ms / 60_000),
+        });
+        this.timer = setTimeout(() => {
+            this.runReset([]).catch(err => {
+                logger.error('DailyResetManager: reset failed', { err });
+            });
+            this.scheduleNext(); // reschedule for tomorrow
+        }, ms);
+        // Allow Node to exit if this is the only pending timer
+        if (this.timer.unref)
+            this.timer.unref();
+    }
+    // --------------------------------------------------------------------------
+    // Reset logic
+    // --------------------------------------------------------------------------
+    /**
+     * Perform the daily reset on the provided messages array (modified in-place).
+     *
+     * @param messages - The agent's LLM messages array to clear
+     * @param systemMessage - Optional system message to keep at position [0]
+     */
+    async runReset(messages, systemMessage) {
+        const today = new Date().toISOString().split('T')[0];
+        // Avoid duplicate resets on the same day
+        if (this.lastResetDate === today) {
+            return {
+                triggeredAt: new Date(),
+                messagesCleared: 0,
+                summaryMessage: null,
+            };
+        }
+        this.lastResetDate = today;
+        const messagesCleared = messages.length;
+        // Clear messages (in-place)
+        messages.splice(0, messages.length);
+        // Re-inject system message if provided
+        if (systemMessage) {
+            messages.push(systemMessage);
+        }
+        const summaryMessage = this.config.postSummary
+            ? this.buildSummaryMessage(today, messagesCleared)
+            : null;
+        if (summaryMessage && messages.length > 0) {
+            // Append the summary as an assistant message so it appears in the log
+            messages.push({ role: 'assistant', content: summaryMessage });
+        }
+        const result = {
+            triggeredAt: new Date(),
+            messagesCleared,
+            summaryMessage,
+        };
+        this.emit('reset', result);
+        logger.info('DailyResetManager: daily reset completed', {
+            date: today,
+            messagesCleared,
+        });
+        return result;
+    }
+    // --------------------------------------------------------------------------
+    // Helpers
+    // --------------------------------------------------------------------------
+    buildSummaryMessage(date, cleared) {
+        return [
+            `---`,
+            `**[Daily context boundary — ${date}]**`,
+            `Conversation history was automatically cleared at ${String(this.config.resetHour).padStart(2, '0')}:${String(this.config.resetMinute).padStart(2, '0')} to maintain a fresh context window.`,
+            `${cleared} messages from the previous session were cleared.`,
+            `MEMORY.md, HEARTBEAT.md, todo.md, and all project files are preserved.`,
+            `---`,
+        ].join('\n');
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    isEnabled() {
+        return this.config.enabled;
+    }
+}
+// ============================================================================
+// Singleton
+// ============================================================================
+let _instance = null;
+export function getDailyResetManager(config) {
+    if (!_instance) {
+        _instance = new DailyResetManager(config);
+    }
+    return _instance;
+}
+export function resetDailyResetManager() {
+    _instance?.stop();
+    _instance = null;
+}
+//# sourceMappingURL=daily-reset.js.map

package/dist/daemon/daily-reset.js.map

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

package/dist/daemon/index.d.ts

@@ -5,3 +5,4 @@ export { DaemonManager, getDaemonManager, resetDaemonManager, type DaemonConfig,
 export { DaemonLifecycle, getDaemonLifecycle, resetDaemonLifecycle, type DaemonService, type LifecycleConfig, } from './daemon-lifecycle.js';
 export { CronAgentBridge, getCronAgentBridge, resetCronAgentBridge, type BridgeConfig, type JobExecutionResult, } from './cron-agent-bridge.js';
 export { HealthMonitor, getHealthMonitor, resetHealthMonitor, type HealthMetrics, type HealthMonitorConfig, } from './health-monitor.js';
+export { DailyResetManager, getDailyResetManager, resetDailyResetManager, type DailyResetConfig, type ResetResult, } from './daily-reset.js';

package/dist/daemon/index.js

@@ -5,4 +5,5 @@ export { DaemonManager, getDaemonManager, resetDaemonManager, } from './daemon-m
 export { DaemonLifecycle, getDaemonLifecycle, resetDaemonLifecycle, } from './daemon-lifecycle.js';
 export { CronAgentBridge, getCronAgentBridge, resetCronAgentBridge, } from './cron-agent-bridge.js';
 export { HealthMonitor, getHealthMonitor, resetHealthMonitor, } from './health-monitor.js';
+export { DailyResetManager, getDailyResetManager, resetDailyResetManager, } from './daily-reset.js';
 //# sourceMappingURL=index.js.map

package/dist/daemon/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/daemon/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GAInB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,oBAAoB,GAGrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,oBAAoB,GAGrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GAGnB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/daemon/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GAInB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,oBAAoB,GAGrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,oBAAoB,GAGrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GAGnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,GAGvB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -581,8 +581,21 @@ program
     .option("--append-system-prompt <text>", "append text to the default system prompt")
     .option("--append-system-prompt-file <path>", "append file contents to the default system prompt")
     .option("--fallback-model <model>", "auto-fallback model when default is overloaded")
+    .option("--profile <name>", "apply a named configuration profile from .codebuddy/config.toml [profiles.<name>]")
     .option("--from-pr <pr>", "link session to a GitHub pull request (number or URL)")
     .action(async (message, options) => {
+    // Apply named configuration profile (--profile <name>) before anything else
+    if (options.profile) {
+        try {
+            const { getConfigManager } = await import('./config/toml-config.js');
+            getConfigManager().load();
+            getConfigManager().applyProfile(options.profile);
+        }
+        catch (err) {
+            startupLogger.error(`Profile error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    }
     // Handle --setup flag (interactive setup wizard)
     if (options.setup) {
         const { runSetup } = await import("./utils/interactive-setup.js");
@@ -1257,5 +1270,45 @@ addLazyCommandGroup(program, 'config', 'Show environment variable configuration
     const { registerConfigCommand } = await import('./commands/cli/config-command.js');
     registerConfigCommand(program);
 });
+// Dev workflows — plan, run, pr, fix-ci, explain
+addLazyCommandGroup(program, 'dev', 'Golden-path developer workflows (plan, run, pr, fix-ci, explain)', async () => {
+    const { registerDevCommands } = await import('./commands/dev/index.js');
+    registerDevCommands(program);
+});
+// Run observability — list, show, tail, replay
+addLazyCommandGroup(program, 'runs', 'Inspect and replay agent runs (observability)', async () => {
+    const { registerRunCommands } = await import('./commands/run-cli/index.js');
+    registerRunCommands(program);
+});
+// DM pairing — approve, revoke, list, pending
+addLazyCommand(program, 'pairing', 'Manage DM pairing security (allowlist for messaging channel senders)', async () => {
+    const { createPairingCommand } = await import('./commands/pairing.js');
+    return createPairingCommand();
+});
+// Knowledge base management — add, list, show, search, remove, context
+addLazyCommand(program, 'knowledge', 'Manage agent knowledge bases (Knowledge.md files injected as context)', async () => {
+    const { createKnowledgeCommand } = await import('./commands/knowledge.js');
+    return createKnowledgeCommand();
+});
+// Wide Research — parallel agent workers for comprehensive research
+addLazyCommand(program, 'research', 'Wide Research: spawn parallel agent workers to research a topic (Manus AI-inspired)', async () => {
+    const { createResearchCommand } = await import('./commands/research/index.js');
+    return createResearchCommand();
+});
+// Todo attention bias — Manus AI-inspired persistent task list
+addLazyCommand(program, 'todo', 'Manage persistent task list (todo.md) — injected at end of every agent turn for focus', async () => {
+    const { createTodosCommand } = await import('./commands/todos.js');
+    return createTodosCommand();
+});
+// Exec Policy — Codex-inspired command authorization (allow/deny/ask/sandbox + prefix rules)
+addLazyCommand(program, 'execpolicy', 'Manage execution policy rules (allow/deny/ask/sandbox) for shell commands', async () => {
+    const { createExecPolicyCommand } = await import('./commands/execpolicy.js');
+    return createExecPolicyCommand();
+});
+// Lessons — self-improvement loop (lessons learned injected per agent turn)
+addLazyCommand(program, 'lessons', 'Manage lessons learned — self-improvement loop for recurring patterns (injected every turn)', async () => {
+    const { createLessonsCommand } = await import('./commands/lessons.js');
+    return createLessonsCommand();
+});
 program.parse();
 //# sourceMappingURL=index.js.map