@stoneforge/smithy 1.1.0 → 1.4.0

package/dist/services/settings-service.js

@@ -0,0 +1,92 @@
+/**
+ * Settings Service
+ *
+ * Server-side key-value settings persisted to SQLite.
+ * Used for workspace-wide configuration that needs to be accessible server-side,
+ * such as default executable paths for agent providers.
+ *
+ * Settings are stored in the `settings` table as JSON-encoded values.
+ */
+import { createLogger } from '../utils/logger.js';
+const logger = createLogger('settings-service');
+/**
+ * Well-known setting keys
+ */
+export const SETTING_KEYS = {
+    AGENT_DEFAULTS: 'agentDefaults',
+};
+// ============================================================================
+// Implementation
+// ============================================================================
+function dbToSetting(row) {
+    let parsedValue;
+    try {
+        parsedValue = JSON.parse(row.value);
+    }
+    catch {
+        parsedValue = row.value;
+    }
+    return {
+        key: row.key,
+        value: parsedValue,
+        updatedAt: row.updated_at,
+    };
+}
+const DEFAULT_AGENT_DEFAULTS = {
+    defaultExecutablePaths: {},
+};
+export function createSettingsService(storage) {
+    return {
+        getSetting(key) {
+            const row = storage.queryOne('SELECT key, value, updated_at FROM settings WHERE key = ?', [key]);
+            if (!row)
+                return undefined;
+            return dbToSetting(row);
+        },
+        setSetting(key, value) {
+            const jsonValue = JSON.stringify(value);
+            const updatedAt = new Date().toISOString();
+            storage.run('INSERT INTO settings (key, value, updated_at) VALUES (?, ?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value, updated_at = excluded.updated_at', [key, jsonValue, updatedAt]);
+            logger.debug(`Setting updated: ${key}`);
+            return {
+                key,
+                value,
+                updatedAt,
+            };
+        },
+        deleteSetting(key) {
+            const result = storage.run('DELETE FROM settings WHERE key = ?', [key]);
+            return result.changes > 0;
+        },
+        getAgentDefaults() {
+            const setting = this.getSetting(SETTING_KEYS.AGENT_DEFAULTS);
+            if (!setting) {
+                return { ...DEFAULT_AGENT_DEFAULTS };
+            }
+            // Validate shape — ensure defaultExecutablePaths exists and is an object
+            const value = setting.value;
+            const paths = value?.defaultExecutablePaths;
+            return {
+                defaultExecutablePaths: paths && typeof paths === 'object' && !Array.isArray(paths)
+                    ? paths
+                    : {},
+            };
+        },
+        setAgentDefaults(defaults) {
+            // Validate that defaultExecutablePaths is a plain object of strings
+            const paths = defaults.defaultExecutablePaths ?? {};
+            const sanitized = {};
+            for (const [provider, path] of Object.entries(paths)) {
+                if (typeof path === 'string') {
+                    sanitized[provider] = path;
+                }
+            }
+            const validated = {
+                defaultExecutablePaths: sanitized,
+            };
+            this.setSetting(SETTING_KEYS.AGENT_DEFAULTS, validated);
+            return validated;
+        },
+    };
+}
+//# sourceMappingURL=settings-service.js.map

package/dist/services/settings-service.js.map

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

package/dist/services/steward-scheduler.d.ts

@@ -16,9 +16,9 @@
  */
 import type { EntityId, Timestamp } from '@stoneforge/core';
 import type { StewardTrigger, CronTrigger, EventTrigger } from '../types/index.js';
+import type { SessionManager } from '../runtime/session-manager.js';
 import type { AgentRegistry, AgentEntity } from './agent-registry.js';
 import type { MergeStewardService } from './merge-steward-service.js';
-import type { HealthStewardService } from './health-steward-service.js';
 import type { DocsStewardService } from './docs-steward-service.js';
 /**
  * Result of a steward execution
@@ -326,22 +326,54 @@ export declare class StewardSchedulerImpl implements StewardScheduler {
  * @param config - Optional configuration
  */
 export declare function createStewardScheduler(agentRegistry: AgentRegistry, executor: StewardExecutor, config?: StewardSchedulerConfig): StewardScheduler;
+/**
+ * Default idle timeout for steward sessions in milliseconds (2 minutes).
+ * If a steward session receives no events for this duration, it is
+ * assumed to be stuck and will be force-terminated.
+ */
+export declare const STEWARD_SESSION_DEFAULT_IDLE_TIMEOUT_MS = 120000;
+/**
+ * Default maximum duration for steward sessions in milliseconds (30 minutes).
+ * Steward sessions exceeding this duration are force-terminated regardless
+ * of activity, as a safety net.
+ */
+export declare const STEWARD_SESSION_DEFAULT_MAX_DURATION_MS: number;
 /**
  * Dependencies required by the real steward executor.
  */
 export interface StewardExecutorDeps {
     mergeStewardService: MergeStewardService;
-    healthStewardService: HealthStewardService;
     docsStewardService: DocsStewardService;
+    sessionManager: SessionManager;
+    projectRoot: string;
+    /**
+     * Optional callback to resolve a playbook (workflow template) by ID.
+     * Returns the playbook content as a markdown string for the steward prompt,
+     * or undefined if not found. Used when a custom steward has `playbookId` set.
+     */
+    resolvePlaybookContent?: (playbookId: string) => Promise<string | undefined>;
+    /**
+     * Idle timeout in ms for spawned steward sessions (docs, custom).
+     * If no session events are received within this window, the session
+     * is force-terminated. Default: 120000 (2 minutes).
+     */
+    stewardSessionIdleTimeoutMs?: number;
+    /**
+     * Maximum duration in ms for spawned steward sessions (docs, custom).
+     * Sessions exceeding this duration are force-terminated regardless of
+     * activity. Default: 1800000 (30 minutes).
+     */
+    stewardSessionMaxDurationMs?: number;
 }
 /**
  * Creates a steward executor that dispatches to the appropriate service
  * based on the steward's focus.
  *
  * - 'merge' focus → MergeStewardService.processAllPending()
- * - 'health' focus → HealthStewardService.runHealthCheck()
- * - 'docs' focus → DocsStewardService.scanAll()
- * - 'reminder' / 'ops' → no-op (require agent sessions)
+ * - 'docs' → spawns an agent session via sessionManager
+ *
+ * Session-based stewards check for an existing active session before spawning
+ * to prevent overlapping runs across cron ticks.
  *
  * Each case is wrapped in try/catch so one failing steward doesn't crash
  * the scheduler.

package/dist/services/steward-scheduler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"steward-scheduler.d.ts","sourceRoot":"","sources":["../../src/services/steward-scheduler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"steward-scheduler.d.ts","sourceRoot":"","sources":["../../src/services/steward-scheduler.ts"],"names":[],"mappings":"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"}

package/dist/services/steward-scheduler.js

@@ -17,7 +17,10 @@
 import { EventEmitter } from 'node:events';
 import { createTimestamp } from '@stoneforge/core';
 import { isCronTrigger, isEventTrigger, } from '../types/index.js';
+import { loadRolePrompt } from '../prompts/index.js';
 import { getAgentMetadata } from './agent-registry.js';
+import { createLogger } from '../utils/logger.js';
+const logger = createLogger('steward-scheduler');
 // ============================================================================
 // Cron Schedule Utilities
 // ============================================================================
@@ -172,6 +175,7 @@ export class StewardSchedulerImpl {
         if (this.config.startImmediately) {
             await this.registerAllStewards();
         }
+        logger.info(`Started with ${this.cronJobs.size} cron job(s) and ${[...this.eventSubscriptions.values()].flat().length} event subscription(s)`);
     }
     async stop() {
         if (!this.running) {
@@ -238,6 +242,9 @@ export class StewardSchedulerImpl {
                 });
             }
         }
+        const cronCount = triggers.filter(t => isCronTrigger(t)).length;
+        const eventCount = triggers.filter(t => isEventTrigger(t)).length;
+        logger.info(`Registered steward '${agent.name}' (${stewardId}) with ${cronCount} cron trigger(s) and ${eventCount} event trigger(s)`);
         this.emitter.emit('steward:registered', stewardId);
         return true;
     }
@@ -282,6 +289,7 @@ export class StewardSchedulerImpl {
                 registered++;
             }
         }
+        logger.info(`Registered ${registered}/${stewards.length} steward(s)`);
         return registered;
     }
     // ----------------------------------------
@@ -335,8 +343,8 @@ export class StewardSchedulerImpl {
             const agent = await this.agentRegistry.getAgent(sub.stewardId);
             if (agent) {
                 // Run execution asynchronously
-                this.runExecution(agent, sub.trigger, false, eventData).catch(() => {
-                    // Errors are handled in runExecution
+                this.runExecution(agent, sub.trigger, false, eventData).catch((error) => {
+                    logger.error(`Event-triggered execution failed for steward '${sub.stewardName}':`, error);
                 });
                 triggered++;
             }
@@ -449,27 +457,40 @@ export class StewardSchedulerImpl {
     }
     scheduleNextRun(job) {
         const nextTime = this.getNextCronTime(job.trigger.schedule);
-        if (!nextTime)
+        if (!nextTime) {
+            logger.warn(`Failed to compute next run time for steward '${job.stewardName}' with schedule '${job.trigger.schedule}'`);
             return;
+        }
         job.nextRunAt = nextTime;
         const delayMs = Math.max(0, nextTime.getTime() - Date.now());
+        logger.debug(`Scheduled next run for steward '${job.stewardName}' at ${nextTime.toISOString()} (in ${Math.round(delayMs / 1000)}s)`);
         job.intervalId = setTimeout(async () => {
-            if (!this.running)
-                return;
-            if (job.isRunning) {
-                // Skip this run but schedule the next one
-                job.intervalId = undefined;
-                this.scheduleNextRun(job);
-                return;
-            }
-            const agent = await this.agentRegistry.getAgent(job.stewardId);
-            if (agent && this.running) {
-                await this.runExecution(agent, job.trigger, false);
-                job.lastRunAt = createTimestamp();
-            }
-            if (this.running) {
-                job.intervalId = undefined;
-                this.scheduleNextRun(job);
+            try {
+                if (!this.running)
+                    return;
+                if (job.isRunning) {
+                    logger.warn(`Skipping overlapping execution for steward '${job.stewardName}'`);
+                    return; // finally block will schedule the next run
+                }
+                logger.debug(`Cron firing for steward '${job.stewardName}' (schedule: ${job.trigger.schedule})`);
+                const agent = await this.agentRegistry.getAgent(job.stewardId);
+                if (!agent) {
+                    logger.warn(`Agent not found for steward '${job.stewardId}', skipping cron execution`);
+                }
+                if (agent && this.running) {
+                    const result = await this.runExecution(agent, job.trigger, false);
+                    job.lastRunAt = createTimestamp();
+                    logger.info(`Cron execution completed for steward '${job.stewardName}': success=${result.success}${result.error ? `, error=${result.error}` : ''}`);
+                }
+            }
+            catch (error) {
+                logger.error(`Unhandled error in cron callback for steward '${job.stewardName}':`, error);
+            }
+            finally {
+                if (this.running) {
+                    job.intervalId = undefined;
+                    this.scheduleNextRun(job);
+                }
             }
         }, delayMs);
     }
@@ -704,14 +725,112 @@ export class StewardSchedulerImpl {
 export function createStewardScheduler(agentRegistry, executor, config) {
     return new StewardSchedulerImpl(agentRegistry, executor, config);
 }
+// ============================================================================
+// Steward Executor Factory
+// ============================================================================
+/**
+ * Default idle timeout for steward sessions in milliseconds (2 minutes).
+ * If a steward session receives no events for this duration, it is
+ * assumed to be stuck and will be force-terminated.
+ */
+export const STEWARD_SESSION_DEFAULT_IDLE_TIMEOUT_MS = 120_000;
+/**
+ * Default maximum duration for steward sessions in milliseconds (30 minutes).
+ * Steward sessions exceeding this duration are force-terminated regardless
+ * of activity, as a safety net.
+ */
+export const STEWARD_SESSION_DEFAULT_MAX_DURATION_MS = 30 * 60 * 1000;
+/**
+ * Sets up idle timeout and max duration monitoring for a spawned steward session.
+ * Watches for session activity via the session manager's event emitter and
+ * force-terminates the session if it goes idle or exceeds the max duration.
+ *
+ * @param sessionId - The session ID to monitor
+ * @param sessionEvents - The session's event emitter (from startSession)
+ * @param deps - Steward executor dependencies (for session manager and config)
+ * @param stewardName - Name of the steward (for logging)
+ */
+function monitorStewardSession(sessionId, sessionEvents, deps, stewardName) {
+    const idleTimeoutMs = deps.stewardSessionIdleTimeoutMs ?? STEWARD_SESSION_DEFAULT_IDLE_TIMEOUT_MS;
+    const maxDurationMs = deps.stewardSessionMaxDurationMs ?? STEWARD_SESSION_DEFAULT_MAX_DURATION_MS;
+    const startTime = Date.now();
+    let lastActivityAt = Date.now();
+    let cleanedUp = false;
+    // Update last activity on any session event
+    const onEvent = () => {
+        lastActivityAt = Date.now();
+    };
+    // Clean up watchers
+    const cleanup = () => {
+        if (cleanedUp)
+            return;
+        cleanedUp = true;
+        clearInterval(checkInterval);
+        sessionEvents.removeListener('event', onEvent);
+        sessionEvents.removeListener('exit', onExit);
+        sessionEvents.removeListener('status', onStatus);
+    };
+    // Session exited naturally — clean up watchers
+    const onExit = () => {
+        cleanup();
+    };
+    // Session status changed to terminated — clean up watchers
+    const onStatus = (status) => {
+        if (status === 'terminated') {
+            cleanup();
+        }
+    };
+    sessionEvents.on('event', onEvent);
+    sessionEvents.on('exit', onExit);
+    sessionEvents.on('status', onStatus);
+    // Periodically check idle time and max duration
+    const checkIntervalMs = Math.min(idleTimeoutMs / 2, 30_000);
+    const checkInterval = setInterval(() => {
+        const now = Date.now();
+        const idleMs = now - lastActivityAt;
+        const totalMs = now - startTime;
+        if (idleMs > idleTimeoutMs) {
+            logger.warn(`Steward '${stewardName}' session ${sessionId} idle for ${Math.round(idleMs / 1000)}s (timeout: ${Math.round(idleTimeoutMs / 1000)}s), force-terminating`);
+            cleanup();
+            deps.sessionManager.stopSession(sessionId, {
+                graceful: false,
+                reason: `Steward session idle for ${Math.round(idleMs / 1000)}s (timeout: ${Math.round(idleTimeoutMs / 1000)}s)`,
+            }).catch((err) => {
+                const msg = err instanceof Error ? err.message : String(err);
+                if (!msg.includes('not found')) {
+                    logger.warn(`Failed to stop idle steward session ${sessionId}:`, err);
+                }
+            });
+            return;
+        }
+        if (totalMs > maxDurationMs) {
+            logger.warn(`Steward '${stewardName}' session ${sessionId} exceeded max duration ${Math.round(maxDurationMs / 1000)}s, force-terminating`);
+            cleanup();
+            deps.sessionManager.stopSession(sessionId, {
+                graceful: false,
+                reason: `Steward session exceeded max duration (${Math.round(totalMs / 1000)}s)`,
+            }).catch((err) => {
+                const msg = err instanceof Error ? err.message : String(err);
+                if (!msg.includes('not found')) {
+                    logger.warn(`Failed to stop over-duration steward session ${sessionId}:`, err);
+                }
+            });
+        }
+    }, checkIntervalMs);
+    // Prevent the interval from keeping the process alive
+    if (checkInterval.unref) {
+        checkInterval.unref();
+    }
+}
 /**
  * Creates a steward executor that dispatches to the appropriate service
  * based on the steward's focus.
  *
  * - 'merge' focus → MergeStewardService.processAllPending()
- * - 'health' focus → HealthStewardService.runHealthCheck()
- * - 'docs' focus → DocsStewardService.scanAll()
- * - 'reminder' / 'ops' → no-op (require agent sessions)
+ * - 'docs' → spawns an agent session via sessionManager
+ *
+ * Session-based stewards check for an existing active session before spawning
+ * to prevent overlapping runs across cron ticks.
  *
  * Each case is wrapped in try/catch so one failing steward doesn't crash
  * the scheduler.
@@ -742,55 +861,119 @@ export function createStewardExecutor(deps) {
                     };
                 }
             }
-            case 'health': {
+            case 'docs': {
                 try {
-                    const result = await deps.healthStewardService.runHealthCheck();
+                    const stewardId = steward.id;
+                    const activeSession = deps.sessionManager.getActiveSession(stewardId);
+                    if (activeSession) {
+                        return {
+                            success: true,
+                            output: `Steward '${steward.name}' already has active session ${activeSession.id}, skipping`,
+                            durationMs: Date.now() - startTime,
+                            itemsProcessed: 0,
+                        };
+                    }
+                    const roleResult = loadRolePrompt('steward', focus, {
+                        projectRoot: deps.projectRoot,
+                    });
+                    const initialPrompt = roleResult?.prompt ?? '';
+                    const { session, events } = await deps.sessionManager.startSession(stewardId, {
+                        workingDirectory: deps.projectRoot,
+                        initialPrompt,
+                        interactive: false,
+                    });
+                    // Monitor session for idle timeout and max duration
+                    monitorStewardSession(session.id, events, deps, steward.name);
                     return {
                         success: true,
-                        output: `Checked ${result.agentsChecked} agents, ${result.newIssues.length} new issues, ${result.actionsTaken.length} actions taken`,
+                        output: `Spawned ${focus} steward session ${session.id}`,
                         durationMs: Date.now() - startTime,
-                        itemsProcessed: result.agentsChecked,
+                        itemsProcessed: 1,
                     };
                 }
                 catch (error) {
                     return {
                         success: false,
                         error: error instanceof Error ? error.message : String(error),
-                        output: `Health steward '${steward.name}' failed: ${error instanceof Error ? error.message : String(error)}`,
+                        output: `${focus} steward '${steward.name}' failed: ${error instanceof Error ? error.message : String(error)}`,
                         durationMs: Date.now() - startTime,
                         itemsProcessed: 0,
                     };
                 }
             }
-            case 'docs': {
+            case 'custom': {
                 try {
-                    const result = await deps.docsStewardService.scanAll();
+                    const stewardId = steward.id;
+                    const activeSession = deps.sessionManager.getActiveSession(stewardId);
+                    if (activeSession) {
+                        return {
+                            success: true,
+                            output: `Steward '${steward.name}' already has active session ${activeSession.id}, skipping`,
+                            durationMs: Date.now() - startTime,
+                            itemsProcessed: 0,
+                        };
+                    }
+                    // Build prompt from steward base + custom playbook
+                    // Resolve playbook content: prefer playbookId (template reference), fall back to inline playbook
+                    let playbook;
+                    if (metadata?.playbookId && deps.resolvePlaybookContent) {
+                        try {
+                            playbook = await deps.resolvePlaybookContent(metadata.playbookId);
+                            if (!playbook) {
+                                logger.warn(`Custom steward '${steward.name}': playbook template ${metadata.playbookId} not found, falling back to inline playbook`);
+                                playbook = metadata?.playbook;
+                            }
+                        }
+                        catch (err) {
+                            logger.warn(`Custom steward '${steward.name}': failed to resolve playbook template ${metadata.playbookId}: ${err}, falling back to inline playbook`);
+                            playbook = metadata?.playbook;
+                        }
+                    }
+                    else {
+                        playbook = metadata?.playbook;
+                    }
+                    if (!playbook) {
+                        return {
+                            success: false,
+                            error: 'Custom steward has no playbook configured',
+                            output: `Custom steward '${steward.name}' has no playbook configured`,
+                            durationMs: Date.now() - startTime,
+                            itemsProcessed: 0,
+                        };
+                    }
+                    // Load the steward base prompt for shared context
+                    const roleResult = loadRolePrompt('steward', undefined, {
+                        projectRoot: deps.projectRoot,
+                    });
+                    const basePrompt = roleResult?.prompt ?? '';
+                    // Combine base steward prompt with the custom playbook
+                    const initialPrompt = basePrompt
+                        ? `${basePrompt}\n\n---\n\n## Custom Steward Playbook\n\n${playbook}`
+                        : `## Custom Steward Playbook\n\n${playbook}`;
+                    const { session, events } = await deps.sessionManager.startSession(stewardId, {
+                        workingDirectory: deps.projectRoot,
+                        initialPrompt,
+                        interactive: false,
+                    });
+                    // Monitor session for idle timeout and max duration
+                    monitorStewardSession(session.id, events, deps, steward.name);
                     return {
                         success: true,
-                        output: `Scanned docs: ${result.issues.length} issues found`,
+                        output: `Spawned custom steward session ${session.id}`,
                         durationMs: Date.now() - startTime,
-                        itemsProcessed: result.issues.length,
+                        itemsProcessed: 1,
                     };
                 }
                 catch (error) {
                     return {
                         success: false,
                         error: error instanceof Error ? error.message : String(error),
-                        output: `Docs steward '${steward.name}' failed: ${error instanceof Error ? error.message : String(error)}`,
+                        output: `Custom steward '${steward.name}' failed: ${error instanceof Error ? error.message : String(error)}`,
                         durationMs: Date.now() - startTime,
                         itemsProcessed: 0,
                     };
                 }
             }
-            case 'reminder':
-            case 'ops':
-                // These focus types don't have dedicated services yet
-                return {
-                    success: true,
-                    output: `Steward focus '${focus}' has no automated service — requires agent session`,
-                    durationMs: Date.now() - startTime,
-                    itemsProcessed: 0,
-                };
             default:
                 return {
                     success: false,