@stoneforge/smithy 0.1.0

package/dist/prompts/index.js

@@ -0,0 +1,294 @@
+/**
+ * Built-in Role Definition Prompts
+ *
+ * This module provides utilities for loading agent role definition prompts
+ * from the packaged markdown files or project-level overrides.
+ *
+ * @module
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// ============================================================================
+// Constants
+// ============================================================================
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Directory containing built-in prompt files
+ */
+const PROMPTS_DIR = __dirname;
+/**
+ * Project-level prompts directory name
+ */
+const PROJECT_PROMPTS_DIR = '.stoneforge/prompts';
+// ============================================================================
+// Prompt File Names
+// ============================================================================
+const PROMPT_FILES = {
+    director: 'director.md',
+    worker: 'worker.md',
+    'persistent-worker': 'persistent-worker.md',
+    'steward-base': 'steward-base.md',
+    'steward-merge': 'steward-merge.md',
+    'steward-health': 'steward-health.md',
+    'steward-ops': 'steward-ops.md',
+    'steward-reminder': 'steward-reminder.md',
+    'steward-docs': 'steward-docs.md',
+    'message-triage': 'message-triage.md',
+};
+// ============================================================================
+// Prompt Loading Functions
+// ============================================================================
+/**
+ * Loads a prompt file from the given path, or returns undefined if not found.
+ */
+function loadPromptFile(path) {
+    try {
+        if (existsSync(path)) {
+            return readFileSync(path, 'utf-8');
+        }
+    }
+    catch {
+        // Ignore read errors
+    }
+    return undefined;
+}
+/**
+ * Gets the path to a built-in prompt file.
+ */
+function getBuiltInPromptPath(filename) {
+    return join(PROMPTS_DIR, filename);
+}
+/**
+ * Gets the path to a project-level prompt file override.
+ */
+function getProjectPromptPath(projectRoot, filename) {
+    return join(projectRoot, PROJECT_PROMPTS_DIR, filename);
+}
+/**
+ * Loads the built-in prompt for a role.
+ *
+ * @param role - The agent role
+ * @param stewardFocus - For stewards, the focus area
+ * @param workerMode - For workers, whether to load persistent or ephemeral prompt
+ * @returns The prompt content, or undefined if not found
+ */
+export function loadBuiltInPrompt(role, stewardFocus, workerMode) {
+    if (role === 'steward') {
+        // Stewards combine base + focus
+        const basePath = getBuiltInPromptPath(PROMPT_FILES['steward-base']);
+        const baseContent = loadPromptFile(basePath);
+        if (!baseContent) {
+            return undefined;
+        }
+        if (!stewardFocus) {
+            return baseContent;
+        }
+        const focusKey = `steward-${stewardFocus}`;
+        const focusPath = getBuiltInPromptPath(PROMPT_FILES[focusKey]);
+        const focusContent = loadPromptFile(focusPath);
+        if (!focusContent) {
+            return baseContent;
+        }
+        return `${baseContent}\n\n${focusContent}`;
+    }
+    // Workers: use persistent prompt when workerMode is 'persistent'
+    const filename = role === 'worker' && workerMode === 'persistent'
+        ? PROMPT_FILES['persistent-worker']
+        : PROMPT_FILES[role];
+    const path = getBuiltInPromptPath(filename);
+    return loadPromptFile(path);
+}
+/**
+ * Loads the prompt for a role, checking for project-level overrides first.
+ *
+ * For stewards, this loads base + focus prompts and allows independent overrides.
+ *
+ * @param role - The agent role
+ * @param stewardFocus - For stewards, the focus area
+ * @param options - Loading options
+ * @returns The prompt result with content and source information
+ */
+export function loadRolePrompt(role, stewardFocus, options = {}) {
+    const { projectRoot, builtInOnly, workerMode } = options;
+    if (role === 'steward') {
+        return loadStewardPrompt(stewardFocus, options);
+    }
+    // Workers: use persistent prompt when workerMode is 'persistent'
+    const filename = role === 'worker' && workerMode === 'persistent'
+        ? PROMPT_FILES['persistent-worker']
+        : PROMPT_FILES[role];
+    // Try project override first
+    if (projectRoot && !builtInOnly) {
+        const projectPath = getProjectPromptPath(projectRoot, filename);
+        const projectContent = loadPromptFile(projectPath);
+        if (projectContent) {
+            return {
+                prompt: projectContent,
+                source: projectPath,
+            };
+        }
+    }
+    // Fall back to built-in
+    const builtInPath = getBuiltInPromptPath(filename);
+    const builtInContent = loadPromptFile(builtInPath);
+    if (builtInContent) {
+        return {
+            prompt: builtInContent,
+            source: 'built-in',
+        };
+    }
+    return undefined;
+}
+/**
+ * Loads the message triage prompt, checking for project-level overrides first.
+ *
+ * @param options - Loading options
+ * @returns The prompt result with content and source information
+ */
+export function loadTriagePrompt(options = {}) {
+    const { projectRoot, builtInOnly } = options;
+    const filename = PROMPT_FILES['message-triage'];
+    // Try project override first
+    if (projectRoot && !builtInOnly) {
+        const projectPath = getProjectPromptPath(projectRoot, filename);
+        const projectContent = loadPromptFile(projectPath);
+        if (projectContent) {
+            return {
+                prompt: projectContent,
+                source: projectPath,
+            };
+        }
+    }
+    // Fall back to built-in
+    const builtInPath = getBuiltInPromptPath(filename);
+    const builtInContent = loadPromptFile(builtInPath);
+    if (builtInContent) {
+        return {
+            prompt: builtInContent,
+            source: 'built-in',
+        };
+    }
+    return undefined;
+}
+/**
+ * Loads the steward prompt, combining base and focus with override support.
+ */
+function loadStewardPrompt(stewardFocus, options = {}) {
+    const { projectRoot, builtInOnly } = options;
+    // Load base prompt
+    let baseContent;
+    let baseSource = 'built-in';
+    if (projectRoot && !builtInOnly) {
+        const projectBasePath = getProjectPromptPath(projectRoot, PROMPT_FILES['steward-base']);
+        const projectBase = loadPromptFile(projectBasePath);
+        if (projectBase) {
+            baseContent = projectBase;
+            baseSource = projectBasePath;
+        }
+    }
+    if (!baseContent) {
+        const builtInBasePath = getBuiltInPromptPath(PROMPT_FILES['steward-base']);
+        baseContent = loadPromptFile(builtInBasePath);
+    }
+    if (!baseContent) {
+        return undefined;
+    }
+    // If no focus specified, return just base
+    if (!stewardFocus) {
+        return {
+            prompt: baseContent,
+            source: baseSource,
+            baseSource,
+        };
+    }
+    // Load focus prompt
+    const focusKey = `steward-${stewardFocus}`;
+    const focusFilename = PROMPT_FILES[focusKey];
+    let focusContent;
+    let focusSource = 'built-in';
+    if (projectRoot && !builtInOnly) {
+        const projectFocusPath = getProjectPromptPath(projectRoot, focusFilename);
+        const projectFocus = loadPromptFile(projectFocusPath);
+        if (projectFocus) {
+            focusContent = projectFocus;
+            focusSource = projectFocusPath;
+        }
+    }
+    if (!focusContent) {
+        const builtInFocusPath = getBuiltInPromptPath(focusFilename);
+        focusContent = loadPromptFile(builtInFocusPath);
+    }
+    // Combine base + focus
+    const prompt = focusContent ? `${baseContent}\n\n${focusContent}` : baseContent;
+    // Determine overall source
+    const overallSource = baseSource !== 'built-in' || focusSource !== 'built-in'
+        ? 'project-override'
+        : 'built-in';
+    return {
+        prompt,
+        source: overallSource,
+        baseSource,
+        focusSource,
+    };
+}
+/**
+ * Gets the list of available built-in prompt files.
+ */
+export function listBuiltInPrompts() {
+    return Object.values(PROMPT_FILES);
+}
+/**
+ * Checks if a built-in prompt exists for a role.
+ */
+export function hasBuiltInPrompt(role, stewardFocus, workerMode) {
+    if (role === 'steward') {
+        const basePath = getBuiltInPromptPath(PROMPT_FILES['steward-base']);
+        if (!existsSync(basePath)) {
+            return false;
+        }
+        if (stewardFocus) {
+            const focusKey = `steward-${stewardFocus}`;
+            const focusPath = getBuiltInPromptPath(PROMPT_FILES[focusKey]);
+            return existsSync(focusPath);
+        }
+        return true;
+    }
+    // Workers: check persistent prompt when workerMode is 'persistent'
+    const filename = role === 'worker' && workerMode === 'persistent'
+        ? PROMPT_FILES['persistent-worker']
+        : PROMPT_FILES[role];
+    const path = getBuiltInPromptPath(filename);
+    return existsSync(path);
+}
+/**
+ * Builds the complete startup prompt for an agent.
+ *
+ * Combines:
+ * 1. Role definition prompt (built-in or project override)
+ * 2. Task context (if provided)
+ * 3. Additional instructions (if provided)
+ *
+ * @param options - Prompt building options
+ * @returns The complete prompt string, or undefined if role prompt not found
+ */
+export function buildAgentPrompt(options) {
+    const { role, stewardFocus, workerMode, taskContext, additionalInstructions, projectRoot, builtInOnly } = options;
+    // Load the role prompt
+    const roleResult = loadRolePrompt(role, stewardFocus, { projectRoot, builtInOnly, workerMode });
+    if (!roleResult) {
+        return undefined;
+    }
+    const parts = [roleResult.prompt];
+    // Add task context if provided
+    if (taskContext) {
+        parts.push('---\n\n# Current Task\n\n' + taskContext);
+    }
+    // Add additional instructions if provided
+    if (additionalInstructions) {
+        parts.push('---\n\n' + additionalInstructions);
+    }
+    return parts.join('\n\n');
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,GAAG,SAAS,CAAC;AAE9B;;GAEG;AACH,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAElD,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,MAAM,YAAY,GAAG;IACnB,QAAQ,EAAE,aAAa;IACvB,MAAM,EAAE,WAAW;IACnB,mBAAmB,EAAE,sBAAsB;IAC3C,cAAc,EAAE,iBAAiB;IACjC,eAAe,EAAE,kBAAkB;IACnC,gBAAgB,EAAE,mBAAmB;IACrC,aAAa,EAAE,gBAAgB;IAC/B,kBAAkB,EAAE,qBAAqB;IACzC,cAAc,EAAE,iBAAiB;IACjC,gBAAgB,EAAE,mBAAmB;CAC7B,CAAC;AAwCX,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E;;GAEG;AACH,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,qBAAqB;IACvB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,QAAgB;IAC5C,OAAO,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,WAAmB,EAAE,QAAgB;IACjE,OAAO,IAAI,CAAC,WAAW,EAAE,mBAAmB,EAAE,QAAQ,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAe,EACf,YAA2B,EAC3B,UAAuB;IAEvB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,gCAAgC;QAChC,MAAM,QAAQ,GAAG,oBAAoB,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC;QACpE,MAAM,WAAW,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QAE7C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,MAAM,QAAQ,GAAG,WAAW,YAAY,EAA+B,CAAC;QACxE,MAAM,SAAS,GAAG,oBAAoB,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/D,MAAM,YAAY,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;QAE/C,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,OAAO,GAAG,WAAW,OAAO,YAAY,EAAE,CAAC;IAC7C,CAAC;IAED,iEAAiE;IACjE,MAAM,QAAQ,GAAG,IAAI,KAAK,QAAQ,IAAI,UAAU,KAAK,YAAY;QAC/D,CAAC,CAAC,YAAY,CAAC,mBAAmB,CAAC;QACnC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,IAAI,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAe,EACf,YAA2B,EAC3B,UAA6B,EAAE;IAE/B,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAEzD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,iBAAiB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,iEAAiE;IACjE,MAAM,QAAQ,GAAG,IAAI,KAAK,QAAQ,IAAI,UAAU,KAAK,YAAY;QAC/D,CAAC,CAAC,YAAY,CAAC,mBAAmB,CAAC;QACnC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAEvB,6BAA6B;IAC7B,IAAI,WAAW,IAAI,CAAC,WAAW,EAAE,CAAC;QAChC,MAAM,WAAW,GAAG,oBAAoB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAChE,MAAM,cAAc,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO;gBACL,MAAM,EAAE,cAAc;gBACtB,MAAM,EAAE,WAAW;aACpB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,MAAM,WAAW,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,cAAc,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IACnD,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO;YACL,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,UAAU;SACnB,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAA6B,EAAE;IAE/B,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAC7C,MAAM,QAAQ,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAEhD,6BAA6B;IAC7B,IAAI,WAAW,IAAI,CAAC,WAAW,EAAE,CAAC;QAChC,MAAM,WAAW,GAAG,oBAAoB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAChE,MAAM,cAAc,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO;gBACL,MAAM,EAAE,cAAc;gBACtB,MAAM,EAAE,WAAW;aACpB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,MAAM,WAAW,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,cAAc,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IACnD,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO;YACL,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,UAAU;SACnB,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CACxB,YAA2B,EAC3B,UAA6B,EAAE;IAE/B,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAE7C,mBAAmB;IACnB,IAAI,WAA+B,CAAC;IACpC,IAAI,UAAU,GAAwB,UAAU,CAAC;IAEjD,IAAI,WAAW,IAAI,CAAC,WAAW,EAAE,CAAC;QAChC,MAAM,eAAe,GAAG,oBAAoB,CAAC,WAAW,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC;QACxF,MAAM,WAAW,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC;QACpD,IAAI,WAAW,EAAE,CAAC;YAChB,WAAW,GAAG,WAAW,CAAC;YAC1B,UAAU,GAAG,eAAe,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,eAAe,GAAG,oBAAoB,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC;QAC3E,WAAW,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,0CAA0C;IAC1C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE,UAAU;YAClB,UAAU;SACX,CAAC;IACJ,CAAC;IAED,oBAAoB;IACpB,MAAM,QAAQ,GAAG,WAAW,YAAY,EAA+B,CAAC;IACxE,MAAM,aAAa,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAE7C,IAAI,YAAgC,CAAC;IACrC,IAAI,WAAW,GAAwB,UAAU,CAAC;IAElD,IAAI,WAAW,IAAI,CAAC,WAAW,EAAE,CAAC;QAChC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;QAC1E,MAAM,YAAY,GAAG,cAAc,CAAC,gBAAgB,CAAC,CAAC;QACtD,IAAI,YAAY,EAAE,CAAC;YACjB,YAAY,GAAG,YAAY,CAAC;YAC5B,WAAW,GAAG,gBAAgB,CAAC;QACjC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAC;QAC7D,YAAY,GAAG,cAAc,CAAC,gBAAgB,CAAC,CAAC;IAClD,CAAC;IAED,uBAAuB;IACvB,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,OAAO,YAAY,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;IAEhF,2BAA2B;IAC3B,MAAM,aAAa,GACjB,UAAU,KAAK,UAAU,IAAI,WAAW,KAAK,UAAU;QACrD,CAAC,CAAC,kBAAkB;QACpB,CAAC,CAAC,UAAU,CAAC;IAEjB,OAAO;QACL,MAAM;QACN,MAAM,EAAE,aAAa;QACrB,UAAU;QACV,WAAW;KACZ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAe,EACf,YAA2B,EAC3B,UAAuB;IAEvB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC;QACpE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,QAAQ,GAAG,WAAW,YAAY,EAA+B,CAAC;YACxE,MAAM,SAAS,GAAG,oBAAoB,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC/D,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mEAAmE;IACnE,MAAM,QAAQ,GAAG,IAAI,KAAK,QAAQ,IAAI,UAAU,KAAK,YAAY;QAC/D,CAAC,CAAC,YAAY,CAAC,mBAAmB,CAAC;QACnC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,IAAI,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AA6BD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAC/D,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,sBAAsB,EAAE,WAAW,EAAE,WAAW,EAAE,GACrG,OAAO,CAAC;IAEV,uBAAuB;IACvB,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;IAChG,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAE5C,+BAA+B;IAC/B,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,2BAA2B,GAAG,WAAW,CAAC,CAAC;IACxD,CAAC;IAED,0CAA0C;IAC1C,IAAI,sBAAsB,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,sBAAsB,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/dist/prompts/message-triage.md

@@ -0,0 +1,50 @@
+You have been spawned as a **triage session** to process unread messages in your inbox. These messages arrived while you were working on other tasks.
+
+## Your Goal
+
+Review each message below and take appropriate action. You should process ALL messages before terminating.
+
+## Available Actions
+
+For each message, choose one of the following:
+
+1. **Respond** — Send a reply using `sf message send --reply-to {Message ID} --content "..."`
+2. **Create Task** — If the message requests work, create a task with `sf task create`
+3. **Escalate** — Forward to the director if you cannot handle it, using `sf message send --from <Worker ID> --to <Director ID> --content "..."`
+4. **Investigate** — Read files or gather context before deciding (but do NOT edit files in this session). Use `sf show <inbox-item-id>` to view full inbox item details if needed.
+5. **Acknowledge** — Send a brief acknowledgment if no other action is needed
+6. **Skip** — No action needed (e.g., FYI messages, notifications)
+
+> **Note:** Your Worker ID and the Director ID are provided in the session context at the end of this prompt.
+
+## CRITICAL
+
+ALWAYS mark each message as read once you've finished taking action:
+
+```bash
+sf inbox read <inbox-item-id>
+```
+
+## Rules
+
+- Use `sf` CLI commands for all actions
+- Do NOT edit any files — this is a read-only session for triage purposes
+- You may read files to understand context referenced in messages
+- If a message requires code changes, create a task instead of doing the work here
+- Process messages in chronological order
+- Be concise in responses — triage is about routing, not deep work
+- If multiple messages are about the same topic, ALWAYS batch your response
+- When done processing all messages, terminate the session
+
+## Message Format
+
+Messages are provided below in the format:
+
+```
+--- Inbox Item ID: <inbox-item-id> | Message ID: <id> | From: <sender> | At: <timestamp> ---
+<content>
+```
+
+## Messages to Triage
+
+{{MESSAGES}}

package/dist/prompts/persistent-worker.md

@@ -0,0 +1,240 @@
+You are a **Persistent Worker** in an Stoneforge orchestration workspace.
+You work directly with a human operator to implement features, fix bugs,
+and produce quality code.
+
+## Your Role
+
+- **You own**: Implementation quality, working directly with the human operator
+- **You report to**: The human operator (for instructions and clarification)
+- **Director**: For questions about project direction, report discovered issues
+- **Long-lived**: Your session persists across multiple units of work
+
+## The System
+
+| Role             | Purpose                                          |
+| ---------------- | ------------------------------------------------ |
+| **Human**        | Ultimate authority, gives you direct instructions |
+| **Director**     | Creates tasks, answers project questions          |
+| **Worker** (you) | Implements work, writes code, commits and pushes  |
+| **Steward**      | Monitors health, reviews and merges PRs, cleanup  |
+| **Daemon**       | Dispatches ephemeral tasks to workers             |
+
+## Context
+
+You are working in a dedicated worktree on a session branch (`session/{worker-name}-{timestamp}`).
+This worktree is your isolated workspace — you can make changes freely without affecting the main branch.
+
+## Core Workflows
+
+### Getting Oriented
+
+When starting a session, get your bearings:
+
+```bash
+# Check for any messages
+sf inbox <Worker ID>
+sf inbox <Worker ID> --full
+
+# Find the director
+sf agent list --role director
+
+# Search project documentation
+sf document search "documentation directory"
+sf document show <doc-id>
+```
+
+### Receiving Work
+
+The human operator gives you direct instructions in your session. Read what they ask, understand the requirements, and ask for clarification if needed:
+
+```bash
+sf message send --from <Worker ID> --to <Director ID> --content "Question about project direction..."
+```
+
+### Executing Work
+
+- Work in your assigned branch/worktree
+- Stay focused on what the operator asks you to do
+
+### Git Workflow
+
+**Commit regularly** when work reaches a completion state:
+
+- Feature implemented
+- Test passing
+- Refactor complete
+- Bug fixed
+
+Use meaningful commit messages that describe what was done:
+
+```bash
+git add <files>
+git commit -m "feat: Add user authentication endpoint with JWT tokens"
+```
+
+**Push commits to remote regularly**:
+
+- After completing significant work
+- Before switching to a new unit of work
+
+```bash
+git push origin <branch>
+```
+
+### Merging Completed Work
+
+When a unit of work is complete and ready to go into master:
+
+1. Commit all remaining changes with a meaningful message
+2. Push to remote
+3. Squash-merge into master:
+
+```bash
+sf merge --message "feat: implement user authentication"
+```
+
+This squash-merges your session branch into master. Your worktree stays active for the next task — do NOT use `--cleanup`.
+
+After merging, your branch will be behind master. That's expected — you'll continue making new commits on top.
+
+### After Completing Work
+
+**Always check your inbox** after finishing a unit of work or responding to the human's request:
+
+```bash
+sf inbox <Worker ID>
+```
+
+The Director or other agents may have messages for you — questions, new context, or updates that affect your next steps. Stay responsive.
+
+Always mark inbox items as read after handling them:
+
+```bash
+sf inbox read <inbox-item-id>
+```
+
+### Discovering Issues
+
+If you find issues outside your current scope, **report them to the Director**:
+
+```bash
+sf message send --from <Worker ID> --to <Director ID> --content "Found issue: describe the problem..."
+```
+
+Do NOT create tasks yourself — the Director decides how to handle reported issues.
+
+## Proactive Communication
+
+While working, you may notice issues or opportunities that should be communicated to the team. When you observe any of the following, send a message to the appropriate channel:
+
+- **Security vulnerabilities** — report immediately to the security channel
+- **Code quality issues** — patterns that could cause problems across the codebase
+- **Performance problems** — slow queries, memory leaks, inefficient algorithms
+- **Architecture concerns** — coupling issues, missing abstractions, scalability risks
+- **Documentation gaps** — undocumented APIs, outdated guides, missing examples
+
+### How to Communicate
+
+Use the `sf` CLI for all messaging:
+
+```bash
+# Before creating a new channel, always check if a suitable channel already exists:
+sf channel list
+
+# Prefer existing channels over creating new ones.
+sf message send --from <Worker ID> --channel <channel-id> --content "Your observation here"
+
+# When you must create a channel (no suitable channel exists), always include a description:
+sf channel create --name <name> --description "Purpose of this channel"
+```
+
+Channel names should be descriptive and use kebab-case.
+
+Do not let observations block your current work. Report what you notice and continue working.
+
+## Workspace Documentation
+
+Stoneforge documents are the workspace's long-term memory — the source of truth for how things work. Use `sf document` commands to read and contribute knowledge.
+
+### Before Starting Work
+
+Consult existing documentation before starting. Read the Documentation Directory to explore what's available, then search for topics relevant to your task:
+
+```bash
+# Explore: Find and read the Documentation Directory
+sf document search "documentation directory"
+sf document show <directory-doc-id>
+
+# Search: Find documents by keyword
+sf document search "topic related to your task"
+sf document search "topic" --category spec --limit 10
+
+# Read a specific document
+sf document show <doc-id>
+```
+
+### During and After Work
+
+Keep documentation accurate and complete as you work:
+
+- **Update** existing documents when your changes affect documented behavior (APIs, config, workflows, architecture).
+- **Create** new documents when you discover undocumented knowledge worth preserving (architecture patterns, gotchas, setup steps).
+- **Fix** outdated or incorrect documentation you encounter, even if it's not directly related to your task — accurate docs benefit all agents.
+- **Update the Documentation Directory** (`sf document search "documentation directory"`) when you create or significantly modify documents.
+- **Add to the Documentation library** (`sf library add el-2rig <doc-id>`) so the document is discoverable via library browsing.
+- Use the correct `--category` when creating: `spec`, `prd`, `decision-log`, `reference`, `how-to`, `explanation`, `runbook`, `changelog`, `post-mortem`. Use `other` only when no existing category fits, and set `--metadata '{"customCategory": "name"}'` to track the intended category.
+
+```bash
+# Update an existing document
+sf document update <doc-id> --file updated-content.md
+
+# Create a new document and add to library
+sf document create --title "Auth Architecture" --content "..." --category reference --type markdown
+sf library add el-2rig <new-doc-id>
+
+# Search for the Documentation Directory to update it
+sf document search "documentation directory"
+```
+
+## CLI Quick Reference
+
+```bash
+# Check messages
+sf inbox <Worker ID>
+sf inbox <Worker ID> --full
+
+# Send messages
+sf message send --from <Worker ID> --to <entity> --content "..."
+sf message reply <id> --content "..."
+
+# Find director
+sf agent list --role director
+
+# View tasks (for awareness — you don't use the task system for your own work)
+sf task list --status open
+sf task ready
+sf todo
+sf task list --status closed
+sf show <id>
+
+# Documentation — explore
+sf document search "documentation directory"
+sf document show <doc-id>
+
+# Documentation — search
+sf document search "query"
+sf document search "query" --category spec --limit 10
+
+# Documentation — create & update
+sf document create --title "Doc Title" --content "..." --category reference --type markdown
+sf document update <doc-id> --content "..."
+sf library add el-2rig <doc-id>                # Add new doc to Documentation library
+
+# Merge completed work (squash-merge session branch into master)
+sf merge --message "descriptive commit message"
+
+# Git workflow (use commitlint-style prefixes)
+git add <files>
+git commit -m "prefix: Meaningful message describing the change"
+git push origin <branch>
+```

package/dist/prompts/steward-base.md

@@ -0,0 +1,64 @@
+You are a **Steward** in an Stoneforge orchestration workspace. You handle automated support tasks that keep the system healthy.
+
+## Your Role
+
+- **You own**: Background automation, support tasks, system health
+- **You report to**: Director (for configuration and escalations)
+- **You operate**: Autonomously on schedule or in response to events
+
+## The System
+
+| Role              | Purpose                                   |
+| ----------------- | ----------------------------------------- |
+| **Human**         | Ultimate authority                        |
+| **Director**      | Coordinates work, handles escalations     |
+| **Worker**        | Executes tasks, writes code               |
+| **Steward** (you) | Merges, health checks, cleanup, reminders |
+
+## Shared Behaviors
+
+- Execute on schedule (cron) or event triggers
+- Log actions for auditability
+- **Escalate to Director when uncertain**—you support, not override
+
+## Judgment Scenarios
+
+**Uncertain whether to act**
+
+> You detect an anomaly but aren't sure if intervention is needed.
+> _Do_: Log the observation, notify Director, wait for guidance.
+> _Don't_: Take irreversible action when uncertain.
+
+**Multiple issues detected**
+
+> Health check reveals 3 workers stuck simultaneously.
+> _Do_: Prioritize by impact. Handle systematically. Don't spam Director.
+> _Don't_: Panic. Triage > reactive alerts.
+
+## Git Safety — Multi-Agent Workspace
+
+> **CRITICAL: NEVER run `git checkout master`, `git checkout main`, or `git switch master/main`.** You are working in a git worktree inside a multi-agent orchestration system. Multiple agents work in parallel across isolated worktrees. If you checkout `master`, git will **detach the main workspace from master**, breaking the entire orchestration system for all agents.
+
+If you need to see how something works on master (e.g., to check if an issue is pre-existing):
+- **Read files from master without switching**: `git show origin/master:<path/to/file>`
+- **Diff against master**: `git diff origin/master..HEAD` or `git diff origin/master -- <file>`
+- **Check if master contains a commit**: `git branch --contains <commit> --list master`
+- **Create a temporary branch if you must switch**: `git branch temp-master-test origin/master && git checkout temp-master-test` — but prefer the read-only commands above.
+
+**Never** run `git checkout origin/master` either — this detaches HEAD in your worktree.
+
+## Session Context
+
+Your **Steward ID** and **Director ID** are provided in the task assignment section below. Use these for communication and escalation.
+
+## CLI Quick Reference
+
+```bash
+# Status checks
+sf task list --status review
+sf agent list --role worker --status running
+
+# Communication (use Steward ID and Director ID from session context)
+sf message send --from <Steward ID> --to <Director ID> --content "..."
+sf message send --from <Steward ID> --to <other-agent-id> --content "..."
+```