nightshift-mcp 2.2.0 → 2.3.0

package/dist/routines.d.ts

@@ -0,0 +1,64 @@
+/**
+ * NightShift Routines Engine
+ *
+ * Recurring maintenance tasks that run on schedule during "maintain" mode.
+ * Routines generate bugs/stories rather than being stories themselves —
+ * they're the autonomous equivalent of cron jobs for codebase health.
+ *
+ * Unlike sprint stories (finite, one-shot), routines are infinite and recurring:
+ * - Security audits
+ * - Dependency updates
+ * - Test coverage improvement
+ * - Performance monitoring
+ */
+import { type AgentType } from "./agent-spawner.js";
+import { ChatManager } from "./chat-manager.js";
+import type { RoutineConfig } from "./config.js";
+export interface RoutineRun {
+    routine: string;
+    startedAt: string;
+    completedAt?: string;
+    success: boolean;
+    output?: string;
+    error?: string;
+    agent: AgentType;
+}
+/**
+ * Check if a routine is due to run based on its schedule and last run time.
+ */
+export declare function isRoutineDue(routine: RoutineConfig, lastRun?: string): boolean;
+/**
+ * Execute a single routine.
+ */
+export declare function executeRoutine(routine: RoutineConfig, projectPath: string, chat: ChatManager): Promise<RoutineRun>;
+/**
+ * Check all routines and execute any that are due.
+ * Returns the number of routines that were executed.
+ *
+ * Called by the daemon during maintain mode reconciliation.
+ * Runs routines sequentially to avoid overwhelming the system.
+ */
+export declare function runDueRoutines(routines: RoutineConfig[], projectPath: string, chat: ChatManager, maxConcurrent?: number): Promise<{
+    executed: number;
+    succeeded: number;
+    failed: number;
+}>;
+/**
+ * Get the current state of all routines (for status display).
+ */
+export declare function getRoutineStatus(routines: RoutineConfig[], projectPath: string): Array<{
+    name: string;
+    type: string;
+    schedule: string;
+    agent: string;
+    enabled: boolean;
+    lastRun?: string;
+    nextDue: boolean;
+    consecutiveFailures: number;
+    circuitOpen: boolean;
+}>;
+/**
+ * Reset a routine's failure count (re-enable after circuit break).
+ */
+export declare function resetRoutine(projectPath: string, routineName: string): boolean;
+//# sourceMappingURL=routines.d.ts.map

package/dist/routines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routines.d.ts","sourceRoot":"","sources":["../src/routines.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAMlE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;CAClB;AA2BD;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAQ9E;AAyDD;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,UAAU,CAAC,CA2ErB;AAMD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,aAAa,EAAE,EACzB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,WAAW,EACjB,aAAa,GAAE,MAAU,GACxB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAsDlE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,aAAa,EAAE,EACzB,WAAW,EAAE,MAAM,GAClB,KAAK,CAAC;IACP,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC,CAiBD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAS9E"}

package/dist/routines.js

@@ -0,0 +1,247 @@
+/**
+ * NightShift Routines Engine
+ *
+ * Recurring maintenance tasks that run on schedule during "maintain" mode.
+ * Routines generate bugs/stories rather than being stories themselves —
+ * they're the autonomous equivalent of cron jobs for codebase health.
+ *
+ * Unlike sprint stories (finite, one-shot), routines are infinite and recurring:
+ * - Security audits
+ * - Dependency updates
+ * - Test coverage improvement
+ * - Performance monitoring
+ */
+import * as fs from "fs";
+import * as path from "path";
+import { spawnAgent } from "./agent-spawner.js";
+// ============================================
+// Schedule Helpers
+// ============================================
+/**
+ * Get the interval in milliseconds for a schedule cadence.
+ */
+function scheduleToMs(schedule) {
+    switch (schedule) {
+        case "hourly": return 60 * 60 * 1000;
+        case "daily": return 24 * 60 * 60 * 1000;
+        case "weekly": return 7 * 24 * 60 * 60 * 1000;
+        case "monthly": return 30 * 24 * 60 * 60 * 1000;
+    }
+}
+/**
+ * Check if a routine is due to run based on its schedule and last run time.
+ */
+export function isRoutineDue(routine, lastRun) {
+    if (!lastRun)
+        return true; // Never run before
+    const lastRunTime = new Date(lastRun).getTime();
+    const interval = scheduleToMs(routine.schedule);
+    const now = Date.now();
+    return (now - lastRunTime) >= interval;
+}
+// ============================================
+// Routine State Persistence
+// ============================================
+const STATE_FILENAME = "routine-state.json";
+/**
+ * Load routine execution state from disk.
+ */
+function loadRoutineState(projectPath) {
+    const stateFile = path.join(projectPath, ".robot-chat", STATE_FILENAME);
+    if (!fs.existsSync(stateFile))
+        return {};
+    try {
+        return JSON.parse(fs.readFileSync(stateFile, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Save routine execution state to disk.
+ */
+function saveRoutineState(projectPath, state) {
+    const dir = path.join(projectPath, ".robot-chat");
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(path.join(dir, STATE_FILENAME), JSON.stringify(state, null, 2), "utf-8");
+}
+/**
+ * Append a routine run to the run log.
+ */
+function logRoutineRun(projectPath, run) {
+    const logFile = path.join(projectPath, ".robot-chat", "routine-runs.jsonl");
+    const dir = path.dirname(logFile);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.appendFileSync(logFile, JSON.stringify(run) + "\n", "utf-8");
+}
+// ============================================
+// Routine Execution
+// ============================================
+/**
+ * Execute a single routine.
+ */
+export async function executeRoutine(routine, projectPath, chat) {
+    const startedAt = new Date().toISOString();
+    chat.writeMessage({
+        agent: "NightShift",
+        type: "INFO",
+        content: `Running routine "${routine.name}" (${routine.type}, ${routine.schedule}) with ${routine.agent}`,
+    });
+    // Build the routine prompt with context
+    const fullPrompt = `You are running a scheduled maintenance routine for this project.
+
+## Routine: ${routine.name}
+## Type: ${routine.type}
+## Schedule: ${routine.schedule}
+
+## Instructions
+${routine.prompt}
+
+## Important
+- This is a recurring maintenance task, not a feature implementation
+- If you find issues, file them as bugs using the nightshift CLI: nightshift bug-claim BUG-XXX
+- If you identify needed features, file them as stories (they'll be picked up in the next sprint)
+- Commit any direct fixes (e.g., dependency updates, test additions)
+- Keep changes small and focused — this is maintenance, not refactoring
+- Report a summary of what you found and what actions you took`;
+    try {
+        const result = await spawnAgent({
+            agent: routine.agent,
+            prompt: fullPrompt,
+            projectPath,
+            timeout: (routine.timeout ?? 600) * 1000,
+            role: `routine-${routine.type}`,
+        });
+        const run = {
+            routine: routine.name,
+            startedAt,
+            completedAt: new Date().toISOString(),
+            success: result.success,
+            output: result.output?.slice(0, 2000), // Cap output in log
+            agent: routine.agent,
+        };
+        if (!result.success) {
+            run.error = result.error;
+            chat.writeMessage({
+                agent: "NightShift",
+                type: "ERROR",
+                content: `Routine "${routine.name}" failed: ${result.error || "unknown error"}`,
+            });
+        }
+        else {
+            chat.writeMessage({
+                agent: "NightShift",
+                type: "INFO",
+                content: `Routine "${routine.name}" completed successfully`,
+            });
+        }
+        logRoutineRun(projectPath, run);
+        return run;
+    }
+    catch (err) {
+        const run = {
+            routine: routine.name,
+            startedAt,
+            completedAt: new Date().toISOString(),
+            success: false,
+            error: err instanceof Error ? err.message : String(err),
+            agent: routine.agent,
+        };
+        logRoutineRun(projectPath, run);
+        return run;
+    }
+}
+// ============================================
+// Routine Scheduler (called by daemon)
+// ============================================
+/**
+ * Check all routines and execute any that are due.
+ * Returns the number of routines that were executed.
+ *
+ * Called by the daemon during maintain mode reconciliation.
+ * Runs routines sequentially to avoid overwhelming the system.
+ */
+export async function runDueRoutines(routines, projectPath, chat, maxConcurrent = 1) {
+    const state = loadRoutineState(projectPath);
+    const enabledRoutines = routines.filter(r => r.enabled !== false);
+    // Find routines that are due
+    const dueRoutines = enabledRoutines.filter(r => {
+        const routineState = state[r.name];
+        // Skip if already running
+        if (routineState?.running)
+            return false;
+        // Skip if too many consecutive failures (circuit breaker)
+        if (routineState?.consecutiveFailures && routineState.consecutiveFailures >= 3) {
+            return false;
+        }
+        return isRoutineDue(r, routineState?.lastRun);
+    });
+    if (dueRoutines.length === 0) {
+        return { executed: 0, succeeded: 0, failed: 0 };
+    }
+    let executed = 0;
+    let succeeded = 0;
+    let failed = 0;
+    // Run routines (sequentially for now, respecting maxConcurrent)
+    for (const routine of dueRoutines.slice(0, maxConcurrent)) {
+        // Mark as running
+        if (!state[routine.name]) {
+            state[routine.name] = { consecutiveFailures: 0, running: false };
+        }
+        state[routine.name].running = true;
+        saveRoutineState(projectPath, state);
+        const run = await executeRoutine(routine, projectPath, chat);
+        executed++;
+        // Update state
+        state[routine.name].running = false;
+        if (run.success) {
+            state[routine.name].lastRun = run.completedAt;
+            state[routine.name].consecutiveFailures = 0;
+            succeeded++;
+        }
+        else {
+            state[routine.name].consecutiveFailures =
+                (state[routine.name].consecutiveFailures || 0) + 1;
+            failed++;
+        }
+        saveRoutineState(projectPath, state);
+    }
+    return { executed, succeeded, failed };
+}
+/**
+ * Get the current state of all routines (for status display).
+ */
+export function getRoutineStatus(routines, projectPath) {
+    const state = loadRoutineState(projectPath);
+    return routines.map(r => {
+        const s = state[r.name] || { consecutiveFailures: 0, running: false };
+        return {
+            name: r.name,
+            type: r.type,
+            schedule: r.schedule,
+            agent: r.agent,
+            enabled: r.enabled !== false,
+            lastRun: s.lastRun,
+            nextDue: isRoutineDue(r, s.lastRun),
+            consecutiveFailures: s.consecutiveFailures,
+            circuitOpen: s.consecutiveFailures >= 3,
+        };
+    });
+}
+/**
+ * Reset a routine's failure count (re-enable after circuit break).
+ */
+export function resetRoutine(projectPath, routineName) {
+    const state = loadRoutineState(projectPath);
+    if (!state[routineName])
+        return false;
+    state[routineName].consecutiveFailures = 0;
+    state[routineName].running = false;
+    saveRoutineState(projectPath, state);
+    return true;
+}
+//# sourceMappingURL=routines.js.map

package/dist/routines.js.map

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

package/dist/tools/agents.d.ts

@@ -11,5 +11,13 @@ export declare const stopDaemonTool: import("../tool-registry.js").ToolDefinitio
 export declare const getRunStatsTool: import("../tool-registry.js").ToolDefinition;
 export declare const getPipelineTool: import("../tool-registry.js").ToolDefinition;
 export declare const setPipelineTool: import("../tool-registry.js").ToolDefinition;
+export declare const setScheduleTool: import("../tool-registry.js").ToolDefinition;
+export declare const getScheduleTool: import("../tool-registry.js").ToolDefinition;
+export declare const removeScheduleTool: import("../tool-registry.js").ToolDefinition;
+export declare const setModeTool: import("../tool-registry.js").ToolDefinition;
+export declare const getModeTool: import("../tool-registry.js").ToolDefinition;
+export declare const listRoutinesTool: import("../tool-registry.js").ToolDefinition;
+export declare const addRoutineTool: import("../tool-registry.js").ToolDefinition;
+export declare const resetRoutineTool: import("../tool-registry.js").ToolDefinition;
 export declare const agentTools: import("../tool-registry.js").ToolDefinition[];
 //# sourceMappingURL=agents.d.ts.map

package/dist/tools/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/tools/agents.ts"],"names":[],"mappings":"AA2EA,eAAO,MAAM,mBAAmB,8CAsC9B,CAAC;AAEH,eAAO,MAAM,cAAc,8CAiGzB,CAAC;AAEH,eAAO,MAAM,wBAAwB,8CAuDnC,CAAC;AAEH,eAAO,MAAM,aAAa,8CA6LxB,CAAC;AAEH,eAAO,MAAM,gBAAgB,8CAoK3B,CAAC;AAEH,eAAO,MAAM,WAAW,8CA0JtB,CAAC;AAEH,eAAO,MAAM,kBAAkB,8CAyC7B,CAAC;AAEH,eAAO,MAAM,qBAAqB,8CAyChC,CAAC;AAEH,eAAO,MAAM,mBAAmB,8CAsB9B,CAAC;AAEH,eAAO,MAAM,cAAc,8CA4CzB,CAAC;AAEH,eAAO,MAAM,eAAe,8CAgC1B,CAAC;AAEH,eAAO,MAAM,eAAe,8CA8B1B,CAAC;AAEH,eAAO,MAAM,eAAe,8CA0D1B,CAAC;AAGH,eAAO,MAAM,UAAU,gDActB,CAAC"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/tools/agents.ts"],"names":[],"mappings":"AAgFA,eAAO,MAAM,mBAAmB,8CAsC9B,CAAC;AAEH,eAAO,MAAM,cAAc,8CAiGzB,CAAC;AAEH,eAAO,MAAM,wBAAwB,8CAuDnC,CAAC;AAEH,eAAO,MAAM,aAAa,8CA6LxB,CAAC;AAEH,eAAO,MAAM,gBAAgB,8CAoK3B,CAAC;AAEH,eAAO,MAAM,WAAW,8CA0JtB,CAAC;AAEH,eAAO,MAAM,kBAAkB,8CAyC7B,CAAC;AAEH,eAAO,MAAM,qBAAqB,8CAyChC,CAAC;AAEH,eAAO,MAAM,mBAAmB,8CAsB9B,CAAC;AAEH,eAAO,MAAM,cAAc,8CA4CzB,CAAC;AAEH,eAAO,MAAM,eAAe,8CAgC1B,CAAC;AAEH,eAAO,MAAM,eAAe,8CA8B1B,CAAC;AAEH,eAAO,MAAM,eAAe,8CA0D1B,CAAC;AAOH,eAAO,MAAM,eAAe,8CAiD1B,CAAC;AAEH,eAAO,MAAM,eAAe,8CAmB1B,CAAC;AAEH,eAAO,MAAM,kBAAkB,8CAmB7B,CAAC;AAMH,eAAO,MAAM,WAAW,8CAwCtB,CAAC;AAEH,eAAO,MAAM,WAAW,8CAgCtB,CAAC;AAMH,eAAO,MAAM,gBAAgB,8CA0C3B,CAAC;AAEH,eAAO,MAAM,cAAc,8CAgEzB,CAAC;AAEH,eAAO,MAAM,gBAAgB,8CAqB3B,CAAC;AAEH,eAAO,MAAM,UAAU,gDAsBtB,CAAC"}

package/dist/tools/agents.js

@@ -5,7 +5,9 @@ import { getNightshiftCliCommand } from "../platform.js";
 import { getRunStats, readRunLog } from "../run-logger.js";
 import { savePipelineOverride, clearPipelineOverride, resolveExecutablePipeline, listPipelines, getTagRouting, } from "../pipeline.js";
 import { ProjectOrchestrator } from "../orchestrator.js";
-import { isDaemonRunning, ensureDaemonRunning, stopDaemon, installWatchdog, } from "../daemon-manager.js";
+import { isDaemonRunning, ensureDaemonRunning, stopDaemon, installWatchdog, installSchedule, removeSchedule, getSchedule, } from "../daemon-manager.js";
+import { loadConfig, saveConfig, getDefaultRoutines } from "../config.js";
+import { getRoutineStatus, resetRoutine } from "../routines.js";
 const AGENT_TYPES = ["claude", "codex", "gemini", "vibe", "goose", "ollama"];
 /**
  * Pre-flight check: verify an agent is installed and can run before attempting to spawn it.
@@ -963,6 +965,290 @@ Use reset=true to clear all runtime overrides and revert to defaults + config fi
     },
 });
 // Export all agent tools as an array
+// ============================================
+// Schedule Tools
+// ============================================
+export const setScheduleTool = defineTool({
+    name: "set_schedule",
+    category: "agents",
+    description: "Set a daily start/stop schedule for the daemon",
+    fullDescription: `Schedule the daemon to start and stop at specific times each day.
+
+This installs cron entries (Unix) or scheduled tasks (Windows) that automatically
+start and stop the daemon within a time window. Perfect for overnight autonomous operation.
+
+Example: Start at 1AM, stop at 5AM on weekdays:
+  set_schedule({ start: "01:00", stop: "05:00", days: ["mon","tue","wed","thu","fri"] })`,
+    inputSchema: z.object({
+        start: z.string().describe("Start time in HH:MM 24h format (e.g., '01:00')"),
+        stop: z.string().describe("Stop time in HH:MM 24h format (e.g., '05:00')"),
+        timezone: z.string().optional().describe("IANA timezone (e.g., 'America/Chicago'). Default: system timezone"),
+        days: z.array(z.enum(["mon", "tue", "wed", "thu", "fri", "sat", "sun"])).optional()
+            .describe("Days to run (default: every day)"),
+    }),
+    handler: async (params, ctx) => {
+        const schedule = {
+            start: params.start,
+            stop: params.stop,
+            timezone: params.timezone,
+            days: params.days,
+        };
+        const result = installSchedule(ctx.projectPath, schedule);
+        if (result.success) {
+            ctx.chatManager.writeMessage({
+                agent: "NightShift",
+                type: "INFO",
+                content: `Schedule installed: ${result.details}`,
+            });
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        success: result.success,
+                        details: result.details,
+                        error: result.error,
+                        schedule,
+                    }, null, 2),
+                }],
+            isError: !result.success,
+        };
+    },
+});
+export const getScheduleTool = defineTool({
+    name: "get_schedule",
+    category: "agents",
+    description: "Get the current daemon schedule",
+    fullDescription: "View the current start/stop schedule for the daemon.",
+    inputSchema: z.object({}),
+    handler: async (_params, ctx) => {
+        const schedule = getSchedule(ctx.projectPath);
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        hasSchedule: !!schedule,
+                        schedule: schedule ?? "No schedule configured. Use set_schedule to add one.",
+                    }, null, 2),
+                }],
+        };
+    },
+});
+export const removeScheduleTool = defineTool({
+    name: "remove_schedule",
+    category: "agents",
+    description: "Remove the daemon schedule",
+    fullDescription: "Remove the start/stop schedule for the daemon. The daemon will no longer auto-start/stop on a timer.",
+    inputSchema: z.object({}),
+    handler: async (_params, ctx) => {
+        const result = removeSchedule(ctx.projectPath);
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        success: result.success,
+                        message: result.success ? "Schedule removed" : result.error,
+                    }, null, 2),
+                }],
+        };
+    },
+});
+// ============================================
+// Mode Tools
+// ============================================
+export const setModeTool = defineTool({
+    name: "set_mode",
+    category: "agents",
+    description: "Set the daemon operating mode",
+    fullDescription: `Set the daemon's operating mode:
+
+- **sprint**: Execute stories from the PRD until all complete (default during active development)
+- **maintain**: Run recurring routines (security audits, dep updates, test coverage) — no new features
+- **grow**: Re-evaluate the project vision and generate strategic stories for the next sprint
+- **auto**: Automatically transition between modes based on project state (recommended)
+
+In auto mode, the lifecycle is: sprint → maintain → grow → sprint (repeating)`,
+    inputSchema: z.object({
+        mode: z.enum(["sprint", "maintain", "grow", "auto"]).describe("Operating mode"),
+    }),
+    handler: async ({ mode }, ctx) => {
+        saveConfig(ctx.projectPath, { mode: mode });
+        ctx.chatManager.writeMessage({
+            agent: "NightShift",
+            type: "INFO",
+            content: `Operating mode set to: ${mode}`,
+        });
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        mode,
+                        message: `Operating mode set to "${mode}"`,
+                        description: {
+                            sprint: "Execute stories until PRD is complete",
+                            maintain: "Run recurring maintenance routines",
+                            grow: "Re-evaluate vision, generate new strategic stories",
+                            auto: "Auto-transition: sprint → maintain → grow → sprint",
+                        }[mode],
+                    }, null, 2),
+                }],
+        };
+    },
+});
+export const getModeTool = defineTool({
+    name: "get_mode",
+    category: "agents",
+    description: "Get the current daemon operating mode",
+    fullDescription: "View the current operating mode and project lifecycle state.",
+    inputSchema: z.object({}),
+    handler: async (_params, ctx) => {
+        const config = loadConfig(ctx.projectPath);
+        const summary = ctx.ralphManager.getCompletionSummary();
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        configuredMode: config.mode,
+                        hasVision: !!config.vision,
+                        vision: config.vision?.substring(0, 200),
+                        hasRoutines: (config.maintain?.routines?.length ?? 0) > 0,
+                        routineCount: config.maintain?.routines?.length ?? 0,
+                        hasGrowConfig: !!config.grow,
+                        stories: {
+                            total: summary.total,
+                            complete: summary.complete,
+                            incomplete: summary.incomplete,
+                            percentComplete: summary.percentComplete,
+                        },
+                        hasSchedule: !!config.schedule,
+                        schedule: config.schedule,
+                    }, null, 2),
+                }],
+        };
+    },
+});
+// ============================================
+// Routine Tools
+// ============================================
+export const listRoutinesTool = defineTool({
+    name: "list_routines",
+    category: "agents",
+    description: "List configured maintenance routines and their status",
+    fullDescription: `View all configured maintenance routines, their schedules, last run times, and health status.
+
+Routines run during "maintain" mode and handle recurring tasks like security audits,
+dependency updates, and test coverage improvement.`,
+    inputSchema: z.object({
+        showDefaults: z.boolean().optional().describe("Show built-in default routines that can be added"),
+    }),
+    handler: async ({ showDefaults }, ctx) => {
+        const config = loadConfig(ctx.projectPath);
+        const routines = config.maintain?.routines ?? [];
+        const status = routines.length > 0
+            ? getRoutineStatus(routines, ctx.projectPath)
+            : [];
+        const response = {
+            configuredRoutines: status,
+            count: routines.length,
+        };
+        if (showDefaults) {
+            response.availableDefaults = getDefaultRoutines().map(r => ({
+                name: r.name,
+                type: r.type,
+                schedule: r.schedule,
+                agent: r.agent,
+                description: r.prompt.split("\n")[0],
+            }));
+        }
+        if (routines.length === 0) {
+            response.hint = "No routines configured. Use add_routine to add maintenance routines, or pass showDefaults=true to see built-in options.";
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
+        };
+    },
+});
+export const addRoutineTool = defineTool({
+    name: "add_routine",
+    category: "agents",
+    description: "Add a maintenance routine",
+    fullDescription: `Add a recurring maintenance routine to the project.
+
+You can add a built-in default routine by name (e.g., "security-audit", "dependency-updates", "test-coverage")
+or define a custom routine with a name, schedule, agent, and prompt.
+
+Routines run during "maintain" mode after all sprint stories are complete.`,
+    inputSchema: z.object({
+        name: z.string().describe("Routine name (use a default name like 'security-audit' to add a built-in routine)"),
+        schedule: z.enum(["hourly", "daily", "weekly", "monthly"]).optional().describe("How often to run (default: from built-in or 'daily')"),
+        agent: z.string().optional().describe("Agent to execute (default: from built-in or 'gemini')"),
+        prompt: z.string().optional().describe("Custom prompt (default: from built-in routine if name matches)"),
+        type: z.string().optional().describe("Routine type: audit, maintenance, quality, optimization, monitoring, custom"),
+    }),
+    handler: async (params, ctx) => {
+        const config = loadConfig(ctx.projectPath);
+        const routines = config.maintain?.routines ?? [];
+        // Check for duplicates
+        if (routines.find(r => r.name === params.name)) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error: `Routine "${params.name}" already exists` }, null, 2) }],
+                isError: true,
+            };
+        }
+        // Check if it's a built-in default
+        const defaults = getDefaultRoutines();
+        const defaultRoutine = defaults.find(d => d.name === params.name);
+        const newRoutine = defaultRoutine
+            ? {
+                ...defaultRoutine,
+                schedule: params.schedule ?? defaultRoutine.schedule,
+                agent: (params.agent ?? defaultRoutine.agent),
+                prompt: params.prompt ?? defaultRoutine.prompt,
+            }
+            : {
+                name: params.name,
+                schedule: params.schedule ?? "daily",
+                agent: (params.agent ?? "gemini"),
+                prompt: params.prompt ?? `Run the "${params.name}" routine for this project.`,
+                type: (params.type ?? "custom"),
+                timeout: 600,
+            };
+        routines.push(newRoutine);
+        saveConfig(ctx.projectPath, { maintain: { routines } });
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        success: true,
+                        routine: { name: newRoutine.name, schedule: newRoutine.schedule, agent: newRoutine.agent, type: newRoutine.type },
+                        message: `Routine "${newRoutine.name}" added (${newRoutine.schedule}, ${newRoutine.agent})`,
+                        totalRoutines: routines.length,
+                    }, null, 2),
+                }],
+        };
+    },
+});
+export const resetRoutineTool = defineTool({
+    name: "reset_routine",
+    category: "agents",
+    description: "Reset a routine's failure count (re-enable after circuit break)",
+    fullDescription: "Reset a routine that has been disabled after 3 consecutive failures. This clears the failure count and allows it to run again.",
+    inputSchema: z.object({
+        name: z.string().describe("Name of the routine to reset"),
+    }),
+    handler: async ({ name }, ctx) => {
+        const success = resetRoutine(ctx.projectPath, name);
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        success,
+                        message: success ? `Routine "${name}" reset — will run on next cycle` : `Routine "${name}" not found in state`,
+                    }, null, 2),
+                }],
+        };
+    },
+});
 export const agentTools = [
     listAvailableAgents,
     spawnAgentTool,
@@ -977,5 +1263,13 @@ export const agentTools = [
     getRunStatsTool,
     getPipelineTool,
     setPipelineTool,
+    setScheduleTool,
+    getScheduleTool,
+    removeScheduleTool,
+    setModeTool,
+    getModeTool,
+    listRoutinesTool,
+    addRoutineTool,
+    resetRoutineTool,
 ];
 //# sourceMappingURL=agents.js.map