fraim 2.0.281 → 2.0.283

package/dist/src/cli/setup/ide-invocation-surfaces.js

@@ -14,9 +14,9 @@ exports.buildAntigravityCommandContent = buildAntigravityCommandContent;
 exports.buildGeminiCommandContent = buildGeminiCommandContent;
 exports.describeInvocationSurface = describeInvocationSurface;
 exports.FRAIM_LAUNCH_PHRASE = 'Use FRAIM for <job or task>';
-exports.CURSOR_MDC_FRONTMATTER = `---
-description: FRAIM discovery and execution contract
-alwaysApply: true
+exports.CURSOR_MDC_FRONTMATTER = `---
+description: FRAIM discovery and execution contract
+alwaysApply: true
 ---`;
 exports.FRAIM_DEFERRED_TOOL_PRELOAD = [
     'fraim_connect',
@@ -38,112 +38,112 @@ function buildDeferredToolBootstrapSection(profile) {
     const preloadList = exports.FRAIM_DEFERRED_TOOL_PRELOAD.map((toolName) => `\`${toolName}\``).join(', ');
     switch (profile) {
         case 'claude-toolsearch':
-            return `0. **Preload deferred FRAIM tools when needed**:
-   - If FRAIM MCP tools are unavailable because this host lazily loads deferred tool schemas, call \`ToolSearch\` once to load ${preloadList}.
-   - Do the preload as one batched discovery step, not one search per tool.
-
+            return `0. **Preload deferred FRAIM tools when needed**:
+   - If FRAIM MCP tools are unavailable because this host lazily loads deferred tool schemas, call \`ToolSearch\` once to load ${preloadList}.
+   - Do the preload as one batched discovery step, not one search per tool.
+
 `;
         case 'codex-tool-search':
-            return `0. **Preload deferred FRAIM tools when needed**:
-   - If FRAIM MCP tools are unavailable because this host lazily loads deferred tool schemas, call \`tool_search\` once to load ${preloadList}.
-   - Do the preload as one batched discovery step, not one search per tool.
-
+            return `0. **Preload deferred FRAIM tools when needed**:
+   - If FRAIM MCP tools are unavailable because this host lazily loads deferred tool schemas, call \`tool_search\` once to load ${preloadList}.
+   - Do the preload as one batched discovery step, not one search per tool.
+
 `;
         case 'generic-tool-discovery':
-            return `0. **Preload deferred FRAIM tools when needed**:
-   - If FRAIM MCP tools are unavailable because this host lazily loads deferred tool schemas, use the host's tool discovery surface once to load ${preloadList}.
-   - Do the preload as one batched discovery step, not one search per tool.
-
+            return `0. **Preload deferred FRAIM tools when needed**:
+   - If FRAIM MCP tools are unavailable because this host lazily loads deferred tool schemas, use the host's tool discovery surface once to load ${preloadList}.
+   - Do the preload as one batched discovery step, not one search per tool.
+
 `;
         default:
             return '';
     }
 }
 function buildFraimInvocationBody(profile = 'none') {
-    return `Follow this process:
-
-${buildDeferredToolBootstrapSection(profile)}1. **Confirm FRAIM activation**:
-   Use this process only when the user explicitly invokes FRAIM, names a FRAIM job, asks what FRAIM job to run, or the active surface has already selected a FRAIM job. For ordinary requests, answer or work normally; do not scan FRAIM stubs first.
-
-2. **If the user did not specify a FRAIM job or topic after activation**:
-   If local FRAIM job stubs are present in the workspace, inspect those first and match the request locally. Also inspect \`fraim/personalized-employee/jobs/\` for local overrides or repo-specific jobs. If local files are missing or you cannot inspect workspace files, call \`list_fraim_jobs()\` to view the full catalog, including any proxy-discoverable personalized jobs.
-
-3. **Find the match**:
-   If the user names an exact FRAIM job, call \`get_fraim_job({ job: "<job-name>" })\` directly. Otherwise, match the user's request to a FRAIM job from the local stub catalog, \`fraim/personalized-employee/jobs/\`, or the full \`list_fraim_jobs()\` response. If no exact or high-confidence job match exists, say that no FRAIM job matches and continue with normal tools or ask one concise clarification. Do not pick the nearest catalog job.
-
-4. **Load the full content**:
-   - For jobs, call \`get_fraim_job({ job: "<matched-job-name>" })\`.
-   - For skills, use the content returned by \`get_fraim_file(...)\`.
-
-5. **Execute**:
-   - For jobs, follow the phased instructions and use \`seekMentoring\` when the job requires phase transitions.
-   - For skills, apply the skill steps directly to the user's current context.
-   - ${exports.FRAIM_MCP_UNAVAILABLE_MANAGER_GUIDANCE}
+    return `Follow this process:
+
+${buildDeferredToolBootstrapSection(profile)}1. **Confirm FRAIM activation**:
+   Use this process only when the user explicitly invokes FRAIM, names a FRAIM job, asks what FRAIM job to run, or the active surface has already selected a FRAIM job. For ordinary requests, answer or work normally; do not scan FRAIM stubs first.
+
+2. **If the user did not specify a FRAIM job or topic after activation**:
+   If local FRAIM job stubs are present in the workspace, inspect those first and match the request locally. Also inspect \`fraim/personalized-employee/jobs/\` for local overrides or repo-specific jobs. If local files are missing or you cannot inspect workspace files, call \`list_fraim_jobs()\` to view the full catalog, including any proxy-discoverable personalized jobs.
+
+3. **Find the match**:
+   If the user names an exact FRAIM job, call \`get_fraim_job({ job: "<job-name>" })\` directly. Otherwise, match the user's request to a FRAIM job from the local stub catalog, \`fraim/personalized-employee/jobs/\`, or the full \`list_fraim_jobs()\` response. If no exact or high-confidence job match exists, say that no FRAIM job matches and continue with normal tools or ask one concise clarification. Do not pick the nearest catalog job.
+
+4. **Load the full content**:
+   - For jobs, call \`get_fraim_job({ job: "<matched-job-name>" })\`.
+   - For skills, use the content returned by \`get_fraim_file(...)\`.
+
+5. **Execute**:
+   - For jobs, follow the phased instructions and use \`seekMentoring\` when the job requires phase transitions.
+   - For skills, apply the skill steps directly to the user's current context.
+   - ${exports.FRAIM_MCP_UNAVAILABLE_MANAGER_GUIDANCE}
 `;
 }
 exports.FRAIM_INVOCATION_BODY = buildFraimInvocationBody();
 function buildClaudeSkillContent() {
-    return `# FRAIM
-
+    return `# FRAIM
+
 ${buildFraimInvocationBody('claude-toolsearch')}`;
 }
 function buildClaudeCommandShimContent() {
-    return `# FRAIM Compatibility Command
-
-Use the FRAIM skill when Claude exposes skills directly. This compatibility command keeps \`/fraim\` working on surfaces that still discover legacy command files.
-
+    return `# FRAIM Compatibility Command
+
+Use the FRAIM skill when Claude exposes skills directly. This compatibility command keeps \`/fraim\` working on surfaces that still discover legacy command files.
+
 ${buildFraimInvocationBody('claude-toolsearch')}`;
 }
 function buildClaudeSlashCommandContent() {
     return buildClaudeCommandShimContent();
 }
 function buildCursorMentionRuleContent() {
-    return `${exports.CURSOR_MDC_FRONTMATTER}
-
-# FRAIM
-
-${buildFraimInvocationBody('generic-tool-discovery')}
+    return `${exports.CURSOR_MDC_FRONTMATTER}
+
+# FRAIM
+
+${buildFraimInvocationBody('generic-tool-discovery')}
 `;
 }
-exports.CODEX_SKILL_FRONTMATTER = `---
-name: fraim
-description: Discover and execute FRAIM jobs and skills from Codex.
+exports.CODEX_SKILL_FRONTMATTER = `---
+name: fraim
+description: Discover and execute FRAIM jobs and skills from Codex.
 ---`;
 function buildCodexSkillContent() {
-    return `${exports.CODEX_SKILL_FRONTMATTER}
-# FRAIM
-
+    return `${exports.CODEX_SKILL_FRONTMATTER}
+# FRAIM
+
 ${buildFraimInvocationBody('codex-tool-search')}`;
 }
 function buildGrokSkillContent() {
-    return `# FRAIM
-
+    return `# FRAIM
+
 ${buildFraimInvocationBody('generic-tool-discovery')}`;
 }
 function buildWindsurfCommandContent() {
-    return `# FRAIM
-
+    return `# FRAIM
+
 ${buildFraimInvocationBody('generic-tool-discovery')}`;
 }
 function buildKiroCommandContent() {
-    return `# FRAIM
-
+    return `# FRAIM
+
 ${buildFraimInvocationBody('generic-tool-discovery')}`;
 }
 function escapeTomlMultiline(value) {
     return value.replace(/"""/g, '\\"""');
 }
 function buildAntigravityCommandContent() {
-    return `# FRAIM
-
+    return `# FRAIM
+
 ${buildFraimInvocationBody('generic-tool-discovery')}`;
 }
 function buildGeminiCommandContent() {
-    return `description = "Discover and execute FRAIM jobs and skills"
-prompt = """
-# FRAIM
-
-${escapeTomlMultiline(buildFraimInvocationBody('generic-tool-discovery'))}
+    return `description = "Discover and execute FRAIM jobs and skills"
+prompt = """
+# FRAIM
+
+${escapeTomlMultiline(buildFraimInvocationBody('generic-tool-discovery'))}
 """`;
 }
 function describeInvocationSurface(ideName, invocationProfile) {

package/dist/src/cli/utils/agent-adapters.js

@@ -25,9 +25,9 @@ function adapterConfigTypes(file) {
     return Array.isArray(file.configType) ? file.configType : [file.configType];
 }
 function buildManagedSection(body) {
-    return `${START_MARKER}
-${body.trim()}
-${END_MARKER}
+    return `${START_MARKER}
+${body.trim()}
+${END_MARKER}
 `;
 }
 function mergeManagedSection(existingContent, managedSection) {
@@ -59,69 +59,69 @@ function getAdapterFiles(allowedConfigTypes = null) {
     const employeeRulesPath = (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('ai-employee/rules');
     const personalizedRootPath = (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('personalized-employee');
     const projectRulesPath = (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('personalized-employee/rules/project_rules.md');
-    const markdownBody = buildManagedSection(`
-## FRAIM
-
-This repository uses FRAIM.
-
-- The FRAIM discovery catalog lives under \`${fraimRoot}/\`.
-- Jobs under \`${employeeJobsPath}/\` and \`${managerJobsPath}/\` are FRAIM's primary execution units. Treat them like first-class workflows when deciding how to execute work.
-- Skills under \`${employeeSkillsPath}/\` are reusable capabilities that jobs compose.
-- Rules under \`${employeeRulesPath}/\` are always-on constraints and conventions.
-- Repo-specific overrides and learning artifacts live under \`${personalizedRootPath}/\` and take precedence over synced baseline content.
-- Use FRAIM when the user explicitly invokes FRAIM, names a FRAIM job, asks what FRAIM job to run, or the active surface has already selected a FRAIM job.
-- For ordinary requests, answer or work normally. Do not scan FRAIM stubs first.
-- If the user names an exact FRAIM job, call \`get_fraim_job({ job: "<job-name>" })\` directly.
-- When FRAIM routing is active but the job is not exact, scan the job stubs under \`${employeeJobsPath}/\` and \`${managerJobsPath}/\` to identify the most appropriate job. Read stub filenames and their Intent/Outcome sections before using catalog tools.
-- Once you identify the relevant job, call \`get_fraim_job({ job: "<job-name>" })\` to get the full phased instructions.
-- If no exact or high-confidence job match exists, say that no FRAIM job matches and continue with normal tools or ask one concise clarification.
-- For deeper capability detail, call \`get_fraim_file({ path: "skills/<category>/<skill-name>.md" })\` or \`get_fraim_file({ path: "rules/<category>/<rule-name>.md" })\`.
-- Read \`${projectRulesPath}\` if it exists before doing work.
-- When users ask for next step recommendations, use recommend-next-job skill under \`${employeeSkillsPath}/\` to gather context before suggesting jobs.
-- ${ide_invocation_surfaces_1.FRAIM_MCP_UNAVAILABLE_MANAGER_GUIDANCE}
-
-> [!IMPORTANT]
-> **Job stubs are for discovery only.** When a user mentions or references any file under \`${employeeJobsPath}/\` or \`${managerJobsPath}/\`, do NOT attempt to execute the job from the stub content. The stub only shows intent and phase names. Always call \`get_fraim_job({ job: "<job-name>" })\` first to get the full phased instructions before doing any work.
+    const markdownBody = buildManagedSection(`
+## FRAIM
+
+This repository uses FRAIM.
+
+- The FRAIM discovery catalog lives under \`${fraimRoot}/\`.
+- Jobs under \`${employeeJobsPath}/\` and \`${managerJobsPath}/\` are FRAIM's primary execution units. Treat them like first-class workflows when deciding how to execute work.
+- Skills under \`${employeeSkillsPath}/\` are reusable capabilities that jobs compose.
+- Rules under \`${employeeRulesPath}/\` are always-on constraints and conventions.
+- Repo-specific overrides and learning artifacts live under \`${personalizedRootPath}/\` and take precedence over synced baseline content.
+- Use FRAIM when the user explicitly invokes FRAIM, names a FRAIM job, asks what FRAIM job to run, or the active surface has already selected a FRAIM job.
+- For ordinary requests, answer or work normally. Do not scan FRAIM stubs first.
+- If the user names an exact FRAIM job, call \`get_fraim_job({ job: "<job-name>" })\` directly.
+- When FRAIM routing is active but the job is not exact, scan the job stubs under \`${employeeJobsPath}/\` and \`${managerJobsPath}/\` to identify the most appropriate job. Read stub filenames and their Intent/Outcome sections before using catalog tools.
+- Once you identify the relevant job, call \`get_fraim_job({ job: "<job-name>" })\` to get the full phased instructions.
+- If no exact or high-confidence job match exists, say that no FRAIM job matches and continue with normal tools or ask one concise clarification.
+- For deeper capability detail, call \`get_fraim_file({ path: "skills/<category>/<skill-name>.md" })\` or \`get_fraim_file({ path: "rules/<category>/<rule-name>.md" })\`.
+- Read \`${projectRulesPath}\` if it exists before doing work.
+- When users ask for next step recommendations, use recommend-next-job skill under \`${employeeSkillsPath}/\` to gather context before suggesting jobs.
+- ${ide_invocation_surfaces_1.FRAIM_MCP_UNAVAILABLE_MANAGER_GUIDANCE}
+
+> [!IMPORTANT]
+> **Job stubs are for discovery only.** When a user mentions or references any file under \`${employeeJobsPath}/\` or \`${managerJobsPath}/\`, do NOT attempt to execute the job from the stub content. The stub only shows intent and phase names. Always call \`get_fraim_job({ job: "<job-name>" })\` first to get the full phased instructions before doing any work.
 `);
-    const cursorManagedBody = buildManagedSection(`
-# FRAIM
-
-${(0, ide_invocation_surfaces_1.buildFraimInvocationBody)('generic-tool-discovery')}
+    const cursorManagedBody = buildManagedSection(`
+# FRAIM
+
+${(0, ide_invocation_surfaces_1.buildFraimInvocationBody)('generic-tool-discovery')}
 `);
-    const copilotBody = buildManagedSection(`
-## FRAIM
-
-- Use \`${fraimRoot}/\` as the repository's FRAIM catalog.
-- FRAIM jobs are the primary execution units and should be treated like first-class workflows.
-- FRAIM skills are reusable capabilities jobs compose.
-- FRAIM rules are always-on constraints and conventions.
-- Repo-specific overrides and learnings live under \`${personalizedRootPath}/\`.
-- Use FRAIM when the user explicitly invokes FRAIM, names a FRAIM job, asks what FRAIM job to run, or the active surface has already selected a FRAIM job.
-- For ordinary requests, answer or work normally. Do not scan FRAIM stubs first.
-- If the user names an exact FRAIM job, fetch that full job directly with FRAIM MCP tools.
-- When FRAIM routing is active but the job is not exact, use local stubs to identify which job to invoke before fetching full content with FRAIM MCP tools.
-- If no exact or high-confidence job match exists, say that no FRAIM job matches and continue with normal tools or ask one concise clarification.
-- **Job stubs are for discovery only.** Never execute a job from stub content - always call \`get_fraim_job({ job: "<job-name>" })\` first.
-- ${ide_invocation_surfaces_1.FRAIM_MCP_UNAVAILABLE_MANAGER_GUIDANCE}
+    const copilotBody = buildManagedSection(`
+## FRAIM
+
+- Use \`${fraimRoot}/\` as the repository's FRAIM catalog.
+- FRAIM jobs are the primary execution units and should be treated like first-class workflows.
+- FRAIM skills are reusable capabilities jobs compose.
+- FRAIM rules are always-on constraints and conventions.
+- Repo-specific overrides and learnings live under \`${personalizedRootPath}/\`.
+- Use FRAIM when the user explicitly invokes FRAIM, names a FRAIM job, asks what FRAIM job to run, or the active surface has already selected a FRAIM job.
+- For ordinary requests, answer or work normally. Do not scan FRAIM stubs first.
+- If the user names an exact FRAIM job, fetch that full job directly with FRAIM MCP tools.
+- When FRAIM routing is active but the job is not exact, use local stubs to identify which job to invoke before fetching full content with FRAIM MCP tools.
+- If no exact or high-confidence job match exists, say that no FRAIM job matches and continue with normal tools or ask one concise clarification.
+- **Job stubs are for discovery only.** Never execute a job from stub content - always call \`get_fraim_job({ job: "<job-name>" })\` first.
+- ${ide_invocation_surfaces_1.FRAIM_MCP_UNAVAILABLE_MANAGER_GUIDANCE}
 `);
-    const fraimReadme = `# FRAIM Catalog
-
-This directory is the repository-visible FRAIM surface.
-
-- \`ai-employee/jobs/\`: employee job stubs
-- \`ai-manager/jobs/\`: manager job stubs
-- \`ai-employee/skills/\`: skill stubs
-- \`ai-employee/rules/\`: rule stubs
-- \`personalized-employee/\`: repo-specific overrides and learnings
-
-When FRAIM routing is active and no exact FRAIM job is named, use the stubs here to discover which FRAIM job, skill, or rule is relevant, then load the full content through FRAIM MCP tools. If an exact FRAIM job is named, load it directly. For ordinary requests, do not scan this catalog first.
+    const fraimReadme = `# FRAIM Catalog
+
+This directory is the repository-visible FRAIM surface.
+
+- \`ai-employee/jobs/\`: employee job stubs
+- \`ai-manager/jobs/\`: manager job stubs
+- \`ai-employee/skills/\`: skill stubs
+- \`ai-employee/rules/\`: rule stubs
+- \`personalized-employee/\`: repo-specific overrides and learnings
+
+When FRAIM routing is active and no exact FRAIM job is named, use the stubs here to discover which FRAIM job, skill, or rule is relevant, then load the full content through FRAIM MCP tools. If an exact FRAIM job is named, load it directly. For ordinary requests, do not scan this catalog first.
 `;
-    const vscodePrompt = `# FRAIM
-
+    const vscodePrompt = `# FRAIM
+
 ${(0, ide_invocation_surfaces_1.buildFraimInvocationBody)('generic-tool-discovery')}`;
-    const geminiProjectInstructions = `# Gemini Project Instructions
-
-@../AGENTS.md
+    const geminiProjectInstructions = `# Gemini Project Instructions
+
+@../AGENTS.md
 `;
     const all = [
         { path: 'AGENTS.md', content: markdownBody, configType: 'standard' },

package/dist/src/core/handoff-contracts.js

@@ -273,48 +273,48 @@ function validateHandoffContracts(args) {
 // ---------------------------------------------------------------------------
 // Rejection message builder
 // ---------------------------------------------------------------------------
-const ADDRESS_FEEDBACK_APPROVAL_SCHEMA = `\`\`\`javascript
-evidence: {
-  approved: true  // Set only after the manager explicitly approves via the Hub review action
-}
+const ADDRESS_FEEDBACK_APPROVAL_SCHEMA = `\`\`\`javascript
+evidence: {
+  approved: true  // Set only after the manager explicitly approves via the Hub review action
+}
 \`\`\``;
-const REVIEW_HANDOFF_SCHEMA = `\`\`\`javascript
-evidence: {
-  reviewHandoff: {
-    reviewRequired: true,
-    reviewTarget: { kind: "pull_request", url: "<PR URL>" } | { kind: "artifact_set", files: ["<path>"] } | null,
-    artifacts: [{ label: "<label>", path: "<path>", kind: "<kind>" }],
-    summary: "<optional summary>",
-    reviewActions: [
-      { kind: "approve", label: "Approve" },
-      { kind: "request_changes", label: "Request Changes" }
-    ]
-  }
-}
+const REVIEW_HANDOFF_SCHEMA = `\`\`\`javascript
+evidence: {
+  reviewHandoff: {
+    reviewRequired: true,
+    reviewTarget: { kind: "pull_request", url: "<PR URL>" } | { kind: "artifact_set", files: ["<path>"] } | null,
+    artifacts: [{ label: "<label>", path: "<path>", kind: "<kind>" }],
+    summary: "<optional summary>",
+    reviewActions: [
+      { kind: "approve", label: "Approve" },
+      { kind: "request_changes", label: "Request Changes" }
+    ]
+  }
+}
 \`\`\``;
-const NEXT_JOB_RECOMMENDATIONS_SCHEMA = `\`\`\`javascript
-evidence: {
-  nextJobRecommendations: [
-    {
-      jobId: "<job-slug>",
-      label: "<human-readable label>",
-      reason: "<optional: why this job is recommended>",
-      contextSummary: "<optional: one sentence context for the next agent>"
-    }
-    // 0–3 entries; an empty array [] is valid
-  ]
-}
+const NEXT_JOB_RECOMMENDATIONS_SCHEMA = `\`\`\`javascript
+evidence: {
+  nextJobRecommendations: [
+    {
+      jobId: "<job-slug>",
+      label: "<human-readable label>",
+      reason: "<optional: why this job is recommended>",
+      contextSummary: "<optional: one sentence context for the next agent>"
+    }
+    // 0–3 entries; an empty array [] is valid
+  ]
+}
 \`\`\``;
-const DELEGATION_LEDGER_SCHEMA = `\`\`\`javascript
-evidence: {
-  delegationLedger: {
-    delegationRequired: true,
-    objective: "<optional objective string>",
-    tasks: [
-      { jobId: "<job-slug>", personaKey: "<persona key or null>", briefing: "<optional briefing>" }
-    ]
-  }
-}
+const DELEGATION_LEDGER_SCHEMA = `\`\`\`javascript
+evidence: {
+  delegationLedger: {
+    delegationRequired: true,
+    objective: "<optional objective string>",
+    tasks: [
+      { jobId: "<job-slug>", personaKey: "<persona key or null>", briefing: "<optional briefing>" }
+    ]
+  }
+}
 \`\`\``;
 const FIELD_SCHEMAS = {
     approved: ADDRESS_FEEDBACK_APPROVAL_SCHEMA,

package/dist/src/core/utils/stub-generator.js

@@ -50,71 +50,71 @@ function generateJobStub(jobName, _jobPath, intent, outcome, steps, displayName)
     const metadata = displayName
         ? `---\n${JSON.stringify({ name: jobName, displayName }, null, 2)}\n---\n`
         : '';
-    return `${STUB_MARKER}
-${metadata}
-# FRAIM Job: ${jobName}
-
-## Intent
-${intent}
-
-## Outcome
-${outcome}
-
-## Steps
-${steps}
-
----
-
-> [!IMPORTANT]
-> **For AI Agents:** Do NOT attempt to execute this job based on the Intent/Outcome above.
-> This stub is for discoverability only. The actual job has multiple phases with
-> detailed steps, validation criteria, and required skills.
->
-> To get full phase-by-phase instructions, call:
-> \`get_fraim_job({ job: "${jobName}" })\`
->
-> Then follow all phases using \`seekMentoring\` at each phase transition.
+    return `${STUB_MARKER}
+${metadata}
+# FRAIM Job: ${jobName}
+
+## Intent
+${intent}
+
+## Outcome
+${outcome}
+
+## Steps
+${steps}
+
+---
+
+> [!IMPORTANT]
+> **For AI Agents:** Do NOT attempt to execute this job based on the Intent/Outcome above.
+> This stub is for discoverability only. The actual job has multiple phases with
+> detailed steps, validation criteria, and required skills.
+>
+> To get full phase-by-phase instructions, call:
+> \`get_fraim_job({ job: "${jobName}" })\`
+>
+> Then follow all phases using \`seekMentoring\` at each phase transition.
 `;
 }
 /**
  * Generates a lightweight markdown stub for a skill.
  */
 function generateSkillStub(skillName, skillPath, skillInput, skillOutput) {
-    return `${STUB_MARKER}
-# FRAIM Skill: ${skillName}
-
-## Skill Input
-${skillInput}
-
-## Skill Output
-${skillOutput}
-
----
-
-> [!IMPORTANT]
-> **For AI Agents:** This is a discoverability stub for the skill.
-> All execution details must be fetched from MCP before use.
-> To retrieve the complete skill instructions, call:
-> \`get_fraim_file({ path: "skills/${skillPath}" })\`
+    return `${STUB_MARKER}
+# FRAIM Skill: ${skillName}
+
+## Skill Input
+${skillInput}
+
+## Skill Output
+${skillOutput}
+
+---
+
+> [!IMPORTANT]
+> **For AI Agents:** This is a discoverability stub for the skill.
+> All execution details must be fetched from MCP before use.
+> To retrieve the complete skill instructions, call:
+> \`get_fraim_file({ path: "skills/${skillPath}" })\`
 `;
 }
 /**
  * Generates a lightweight markdown stub for a rule.
  */
 function generateRuleStub(ruleName, rulePath, intent) {
-    return `${STUB_MARKER}
-# FRAIM Rule: ${ruleName}
-
-## Intent
-${intent}
-
----
-
-> [!IMPORTANT]
-> **For AI Agents:** This is a discoverability stub for the rule.
-> All rule details must be fetched from MCP before use.
-> To retrieve the complete rule instructions, call:
-> \`get_fraim_file({ path: "rules/${rulePath}" })\`
+    return `${STUB_MARKER}
+# FRAIM Rule: ${ruleName}
+
+## Intent
+${intent}
+
+---
+
+> [!IMPORTANT]
+> **For AI Agents:** This is a discoverability stub for the rule.
+> All rule details must be fetched from MCP before use.
+> To retrieve the complete rule instructions, call:
+> \`get_fraim_file({ path: "rules/${rulePath}" })\`
 `;
 }
 /**

package/dist/src/first-run/server.js

@@ -121,6 +121,7 @@ class FirstRunServer {
     constructor(options) {
         this.app = (0, express_1.default)();
         this.sessionService = options.sessionService;
+        this.onOpenHub = options.onOpenHub;
         this.finishPromise = new Promise((resolve) => {
             this.finishResolver = resolve;
         });
@@ -299,13 +300,16 @@ class FirstRunServer {
         // a durable launcher binary that survives independently.
         this.app.post('/api/first-run/open-hub', async (_req, res) => {
             try {
-                const result = await this.sessionService.openHub();
+                let result = await this.sessionService.openHub();
                 // Write the next-prompt artifact as a side effect of opening the
                 // Hub so the client doesn't need a separate /finish call. We
                 // intentionally do NOT resolve the finishPromise - see /finish
                 // handler comment above.
                 if (result.ok) {
                     this.sessionService.finish();
+                    if (this.onOpenHub) {
+                        result = { ...result, ...(await this.onOpenHub()) };
+                    }
                 }
                 return res.json(result);
             }