npm - @juancr11/sibu - Versions diffs - 0.16.0 → 0.17.1 - Mend

@juancr11/sibu 0.16.0 → 0.17.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (78) hide show

package/bin/modules/sync-review-orchestrator/unsupported-agent-cleanup.js ADDED Viewed

@@ -0,0 +1,57 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedDatabaseSkillsFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedMcpServersFromState, getSelectedWorkflowSkillsFromState, getWorkflowTargets, SUPPORTED_AGENTS, } from '../template-catalog/index.js';
+import { cloneState } from '../workflow-state-ledger/index.js';
+export function getUnsupportedAgentCleanupPlan({ rootPath, state }) {
+    const supportedAgentIds = new Set(SUPPORTED_AGENTS.map((agent) => agent.id));
+    const unsupportedAgentIds = state.selectedAgents.filter((agentId) => !supportedAgentIds.has(agentId));
+    if (unsupportedAgentIds.length === 0) {
+        return undefined;
+    }
+    const remainingSupportedAgents = getSelectedAgentsFromState(state);
+    const obsoleteManagedFilePaths = getObsoleteManagedFilePaths({ rootPath, state, remainingSupportedAgents });
+    const filePathsToDelete = obsoleteManagedFilePaths.filter((relativePath) => state.managedFiles[relativePath]?.status !== 'unmanaged');
+    return {
+        unsupportedAgentIds,
+        remainingSupportedAgents,
+        obsoleteManagedFilePaths,
+        filePathsToDelete,
+        removesSibuState: remainingSupportedAgents.length === 0,
+    };
+}
+export function applyUnsupportedAgentCleanup({ rootPath, statePath, state, plan, }) {
+    const removedFiles = [];
+    for (const relativePath of plan.filePathsToDelete) {
+        const targetPath = path.join(rootPath, relativePath);
+        if (!fs.existsSync(targetPath)) {
+            continue;
+        }
+        fs.rmSync(targetPath, { recursive: true, force: true });
+        removedFiles.push(relativePath);
+    }
+    if (plan.removesSibuState) {
+        fs.rmSync(statePath, { force: true });
+        return { removedStateFile: true, removedFiles };
+    }
+    const unsupportedAgentIds = new Set(plan.unsupportedAgentIds);
+    const obsoleteManagedFilePaths = new Set(plan.obsoleteManagedFilePaths);
+    const nextState = cloneState(state);
+    nextState.selectedAgents = nextState.selectedAgents.filter((agentId) => !unsupportedAgentIds.has(agentId));
+    nextState.updatedAt = new Date().toISOString();
+    for (const relativePath of obsoleteManagedFilePaths) {
+        delete nextState.managedFiles[relativePath];
+    }
+    return {
+        removedStateFile: false,
+        removedFiles,
+        state: nextState,
+    };
+}
+function getObsoleteManagedFilePaths({ rootPath, state, remainingSupportedAgents, }) {
+    if (remainingSupportedAgents.length === 0) {
+        return Object.keys(state.managedFiles);
+    }
+    const expectedTargets = getWorkflowTargets(rootPath, remainingSupportedAgents, getSelectedLanguageSkillsFromState(state), getSelectedFrameworkSkillsFromState(state), getSelectedArchitectureSkillFromState(state), getSelectedWorkflowSkillsFromState(state), getSelectedDatabaseSkillsFromState(state), getSelectedMcpServersFromState(state));
+    const expectedManagedFilePaths = new Set(expectedTargets.map((target) => path.relative(rootPath, target.targetPath)));
+    return Object.keys(state.managedFiles).filter((relativePath) => !expectedManagedFilePaths.has(relativePath));
+}

package/bin/modules/{workflow-mutation-readiness → sync-review-orchestrator}/workflow-mutation-readiness.js RENAMED Viewed

@@ -1,6 +1,7 @@
-import { readStateForDoctor } from '../workflow-state-registry/index.js';
-import { getSyncPreviews, isActionableSyncPreview } from '../sync-review/index.js';
-import { readTemplateManifest } from '../template-catalog-rendering/index.js';
+import { readTemplateManifest } from '../template-catalog/index.js';
+import { readStateForDoctor } from '../workflow-state-ledger/index.js';
+import { getSyncPreviews, isActionableSyncPreview } from './sync-preview.js';
+import { getUnsupportedAgentCleanupPlan } from './unsupported-agent-cleanup.js';
 export function getWorkflowMutationReadiness({ rootPath, statePath }) {
     const stateResult = readStateForDoctor(statePath);
     if (!stateResult.ok) {
@@ -11,6 +12,14 @@ export function getWorkflowMutationReadiness({ rootPath, statePath }) {
         };
     }
     const manifest = readTemplateManifest();
+    const unsupportedAgentCleanupPlan = getUnsupportedAgentCleanupPlan({ rootPath, state: stateResult.state });
+    if (unsupportedAgentCleanupPlan) {
+        return {
+            ok: false,
+            message: 'Workflow state is not clean enough to select a skill safely.',
+            hint: 'Run `sibu sync` to review workflow state before selecting a skill.',
+        };
+    }
     const previews = getSyncPreviews({ rootPath, state: stateResult.state, manifest });
     const actionablePreviews = previews.filter(isActionableSyncPreview);
     if (actionablePreviews.length > 0) {

package/bin/modules/{workflow-target-planning → template-catalog}/catalog.js RENAMED Viewed

@@ -5,7 +5,6 @@ export const MANDATORY_SKILLS = [
             codex: '.agents/skills/clean-code/SKILL.md',
             gemini: '.agents/skills/clean-code/SKILL.md',
             claude: '.agents/skills/clean-code/SKILL.md',
-            windsurf: '.agents/skills/clean-code/SKILL.md',
         },
     },
     {
@@ -14,7 +13,22 @@ export const MANDATORY_SKILLS = [
             codex: '.agents/skills/product-vision-writer/SKILL.md',
             gemini: '.agents/skills/product-vision-writer/SKILL.md',
             claude: '.agents/skills/product-vision-writer/SKILL.md',
-            windsurf: '.agents/skills/product-vision-writer/SKILL.md',
+        },
+    },
+    {
+        templateRelativePath: 'skills/business-domain-model-writer/SKILL.md',
+        targetRelativePathsByAgent: {
+            codex: '.agents/skills/business-domain-model-writer/SKILL.md',
+            gemini: '.agents/skills/business-domain-model-writer/SKILL.md',
+            claude: '.agents/skills/business-domain-model-writer/SKILL.md',
+        },
+    },
+    {
+        templateRelativePath: 'skills/capabilities-map-writer/SKILL.md',
+        targetRelativePathsByAgent: {
+            codex: '.agents/skills/capabilities-map-writer/SKILL.md',
+            gemini: '.agents/skills/capabilities-map-writer/SKILL.md',
+            claude: '.agents/skills/capabilities-map-writer/SKILL.md',
         },
     },
     {
@@ -23,7 +37,6 @@ export const MANDATORY_SKILLS = [
             codex: '.agents/skills/deep-module-map-writer/SKILL.md',
             gemini: '.agents/skills/deep-module-map-writer/SKILL.md',
             claude: '.agents/skills/deep-module-map-writer/SKILL.md',
-            windsurf: '.agents/skills/deep-module-map-writer/SKILL.md',
         },
     },
     {
@@ -32,7 +45,6 @@ export const MANDATORY_SKILLS = [
             codex: '.agents/skills/feature-brief-writer/SKILL.md',
             gemini: '.agents/skills/feature-brief-writer/SKILL.md',
             claude: '.agents/skills/feature-brief-writer/SKILL.md',
-            windsurf: '.agents/skills/feature-brief-writer/SKILL.md',
         },
     },
     {
@@ -41,7 +53,6 @@ export const MANDATORY_SKILLS = [
             codex: '.agents/skills/technical-design-writer/SKILL.md',
             gemini: '.agents/skills/technical-design-writer/SKILL.md',
             claude: '.agents/skills/technical-design-writer/SKILL.md',
-            windsurf: '.agents/skills/technical-design-writer/SKILL.md',
         },
     },
     {
@@ -50,7 +61,6 @@ export const MANDATORY_SKILLS = [
             codex: '.agents/skills/scrum-master-planner/SKILL.md',
             gemini: '.agents/skills/scrum-master-planner/SKILL.md',
             claude: '.agents/skills/scrum-master-planner/SKILL.md',
-            windsurf: '.agents/skills/scrum-master-planner/SKILL.md',
         },
     },
     {
@@ -59,7 +69,38 @@ export const MANDATORY_SKILLS = [
             codex: '.agents/skills/ai-implementation-planner/SKILL.md',
             gemini: '.agents/skills/ai-implementation-planner/SKILL.md',
             claude: '.agents/skills/ai-implementation-planner/SKILL.md',
-            windsurf: '.agents/skills/ai-implementation-planner/SKILL.md',
+        },
+        supplementalTargetsByAgent: {
+            codex: [
+                {
+                    templateRelativePath: 'skills/ai-implementation-planner-toolbox/SKILL.md',
+                    targetRelativePath: '.agents/skills/ai-implementation-planner-toolbox/SKILL.md',
+                },
+                {
+                    templateRelativePath: '.codex/agents/sibu-implementation-planner.toml',
+                    targetRelativePath: '.codex/agents/sibu-implementation-planner.toml',
+                },
+            ],
+            gemini: [
+                {
+                    templateRelativePath: 'skills/ai-implementation-planner-toolbox/SKILL.md',
+                    targetRelativePath: '.agents/skills/ai-implementation-planner-toolbox/SKILL.md',
+                },
+                {
+                    templateRelativePath: '.gemini/agents/sibu-implementation-planner.md',
+                    targetRelativePath: '.gemini/agents/sibu-implementation-planner.md',
+                },
+            ],
+            claude: [
+                {
+                    templateRelativePath: 'skills/ai-implementation-planner-toolbox/SKILL.md',
+                    targetRelativePath: '.agents/skills/ai-implementation-planner-toolbox/SKILL.md',
+                },
+                {
+                    templateRelativePath: '.claude/agents/sibu-implementation-planner.md',
+                    targetRelativePath: '.claude/agents/sibu-implementation-planner.md',
+                },
+            ],
         },
     },
     {
@@ -68,7 +109,38 @@ export const MANDATORY_SKILLS = [
             codex: '.agents/skills/ai-implementation-plan-executor/SKILL.md',
             gemini: '.agents/skills/ai-implementation-plan-executor/SKILL.md',
             claude: '.agents/skills/ai-implementation-plan-executor/SKILL.md',
-            windsurf: '.agents/skills/ai-implementation-plan-executor/SKILL.md',
+        },
+        supplementalTargetsByAgent: {
+            codex: [
+                {
+                    templateRelativePath: 'skills/ai-implementation-executor-toolbox/SKILL.md',
+                    targetRelativePath: '.agents/skills/ai-implementation-executor-toolbox/SKILL.md',
+                },
+                {
+                    templateRelativePath: '.codex/agents/sibu-implementation-executor.toml',
+                    targetRelativePath: '.codex/agents/sibu-implementation-executor.toml',
+                },
+            ],
+            gemini: [
+                {
+                    templateRelativePath: 'skills/ai-implementation-executor-toolbox/SKILL.md',
+                    targetRelativePath: '.agents/skills/ai-implementation-executor-toolbox/SKILL.md',
+                },
+                {
+                    templateRelativePath: '.gemini/agents/sibu-implementation-executor.md',
+                    targetRelativePath: '.gemini/agents/sibu-implementation-executor.md',
+                },
+            ],
+            claude: [
+                {
+                    templateRelativePath: 'skills/ai-implementation-executor-toolbox/SKILL.md',
+                    targetRelativePath: '.agents/skills/ai-implementation-executor-toolbox/SKILL.md',
+                },
+                {
+                    templateRelativePath: '.claude/agents/sibu-implementation-executor.md',
+                    targetRelativePath: '.claude/agents/sibu-implementation-executor.md',
+                },
+            ],
         },
     },
     {
@@ -77,7 +149,6 @@ export const MANDATORY_SKILLS = [
             codex: '.agents/skills/feature-idea-capture/SKILL.md',
             gemini: '.agents/skills/feature-idea-capture/SKILL.md',
             claude: '.agents/skills/feature-idea-capture/SKILL.md',
-            windsurf: '.agents/skills/feature-idea-capture/SKILL.md',
         },
     },
 ];
@@ -109,7 +180,6 @@ export const SELECTABLE_LANGUAGE_SKILLS = [
             codex: '.agents/skills/typescript/SKILL.md',
             gemini: '.agents/skills/typescript/SKILL.md',
             claude: '.agents/skills/typescript/SKILL.md',
-            windsurf: '.agents/skills/typescript/SKILL.md',
         },
     },
     {
@@ -122,7 +192,6 @@ export const SELECTABLE_LANGUAGE_SKILLS = [
             codex: '.agents/skills/golang/SKILL.md',
             gemini: '.agents/skills/golang/SKILL.md',
             claude: '.agents/skills/golang/SKILL.md',
-            windsurf: '.agents/skills/golang/SKILL.md',
         },
     },
 ];
@@ -137,7 +206,6 @@ export const SELECTABLE_DATABASE_SKILLS = [
             codex: '.agents/skills/postgresql-expert/SKILL.md',
             gemini: '.agents/skills/postgresql-expert/SKILL.md',
             claude: '.agents/skills/postgresql-expert/SKILL.md',
-            windsurf: '.agents/skills/postgresql-expert/SKILL.md',
         },
     },
 ];
@@ -152,7 +220,6 @@ export const SELECTABLE_FRAMEWORK_SKILLS = [
             codex: '.agents/skills/react/SKILL.md',
             gemini: '.agents/skills/react/SKILL.md',
             claude: '.agents/skills/react/SKILL.md',
-            windsurf: '.agents/skills/react/SKILL.md',
         },
     },
     {
@@ -165,7 +232,6 @@ export const SELECTABLE_FRAMEWORK_SKILLS = [
             codex: '.agents/skills/nextjs/SKILL.md',
             gemini: '.agents/skills/nextjs/SKILL.md',
             claude: '.agents/skills/nextjs/SKILL.md',
-            windsurf: '.agents/skills/nextjs/SKILL.md',
         },
     },
 ];
@@ -180,7 +246,6 @@ export const SELECTABLE_ARCHITECTURE_SKILLS = [
             codex: '.agents/skills/ddd-hexagonal/SKILL.md',
             gemini: '.agents/skills/ddd-hexagonal/SKILL.md',
             claude: '.agents/skills/ddd-hexagonal/SKILL.md',
-            windsurf: '.agents/skills/ddd-hexagonal/SKILL.md',
         },
     },
     {
@@ -193,7 +258,6 @@ export const SELECTABLE_ARCHITECTURE_SKILLS = [
             codex: '.agents/skills/command-pattern/SKILL.md',
             gemini: '.agents/skills/command-pattern/SKILL.md',
             claude: '.agents/skills/command-pattern/SKILL.md',
-            windsurf: '.agents/skills/command-pattern/SKILL.md',
         },
     },
     {
@@ -206,7 +270,6 @@ export const SELECTABLE_ARCHITECTURE_SKILLS = [
             codex: '.agents/skills/layered-architecture/SKILL.md',
             gemini: '.agents/skills/layered-architecture/SKILL.md',
             claude: '.agents/skills/layered-architecture/SKILL.md',
-            windsurf: '.agents/skills/layered-architecture/SKILL.md',
         },
     },
 ];
@@ -221,7 +284,6 @@ export const SELECTABLE_WORKFLOW_SKILLS = [
             codex: '.agents/skills/ai-prompt-engineer-master/SKILL.md',
             gemini: '.agents/skills/ai-prompt-engineer-master/SKILL.md',
             claude: '.agents/skills/ai-prompt-engineer-master/SKILL.md',
-            windsurf: '.agents/skills/ai-prompt-engineer-master/SKILL.md',
         },
     },
     {
@@ -234,7 +296,6 @@ export const SELECTABLE_WORKFLOW_SKILLS = [
             codex: '.agents/skills/ux-expert/SKILL.md',
             gemini: '.agents/skills/ux-expert/SKILL.md',
             claude: '.agents/skills/ux-expert/SKILL.md',
-            windsurf: '.agents/skills/ux-expert/SKILL.md',
         },
     },
     {
@@ -247,7 +308,6 @@ export const SELECTABLE_WORKFLOW_SKILLS = [
             codex: '.agents/skills/export-to-github/SKILL.md',
             gemini: '.agents/skills/export-to-github/SKILL.md',
             claude: '.agents/skills/export-to-github/SKILL.md',
-            windsurf: '.agents/skills/export-to-github/SKILL.md',
         },
         supplementalTargetsByAgent: {
             codex: [
@@ -280,7 +340,6 @@ export const SELECTABLE_WORKFLOW_SKILLS = [
             codex: '.agents/skills/export-to-notion/SKILL.md',
             gemini: '.agents/skills/export-to-notion/SKILL.md',
             claude: '.agents/skills/export-to-notion/SKILL.md',
-            windsurf: '.agents/skills/export-to-notion/SKILL.md',
         },
         supplementalTargetsByAgent: {
             codex: [
@@ -352,6 +411,7 @@ export const SUPPORTED_AGENTS = [
         description: 'Create .codex/config.toml pointing Codex to AGENTS.md',
         targetRelativePath: '.codex/config.toml',
         templateRelativePath: '.codex/config.toml',
+        supportsForegroundWorkers: true,
     },
     {
         id: 'gemini',
@@ -359,6 +419,7 @@ export const SUPPORTED_AGENTS = [
         description: 'Create GEMINI.md that delegates to AGENTS.md',
         targetRelativePath: 'GEMINI.md',
         templateRelativePath: 'GEMINI.md',
+        supportsForegroundWorkers: true,
     },
     {
         id: 'claude',
@@ -366,11 +427,7 @@ export const SUPPORTED_AGENTS = [
         description: 'Create CLAUDE.md that delegates to AGENTS.md',
         targetRelativePath: 'CLAUDE.md',
         templateRelativePath: 'CLAUDE.md',
-    },
-    {
-        id: 'windsurf',
-        name: 'Windsurf',
-        description: 'Use root AGENTS.md and shared .agents/skills/ discovery',
+        supportsForegroundWorkers: true,
     },
 ];
 export function resolveSelectableMcpServerById(serverId) {

package/bin/modules/{workflow-target-planning → template-catalog}/index.js RENAMED Viewed

@@ -1,2 +1,3 @@
+export { extractProjectOverview, getTemplateVersion, readTemplate, readTemplateManifest, renderMissingWorkflowFiles, renderSkillRouting, renderTemplateForSync, renderWorkerToolboxRouting, renderWorkerToolboxRoutingPlaceholders, } from './templates.js';
 export { MANDATORY_SKILLS, SELECTABLE_ARCHITECTURE_SKILLS, SELECTABLE_DATABASE_SKILLS, SELECTABLE_FRAMEWORK_SKILLS, SELECTABLE_LANGUAGE_SKILLS, SELECTABLE_MCP_SERVERS, SELECTABLE_WORKFLOW_SKILLS, SESSION_START_HOOKS, SUPPORTED_AGENTS, getMcpServersRequiredByWorkflowSkills, getWorkflowSkillsImpliedByMcpServers, resolveSelectableMcpServerById, resolveSelectableSkillById, } from './catalog.js';
-export { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedDatabaseSkillsFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedMcpServersFromState, getSelectedMcpTargetsForAgents, getSelectedSkillTargetsForAgents, getSelectedWorkflowSkillsFromState, getSkillTargetsForAgents, getWorkflowTargets, renderMissingWorkflowFiles, writeSibuState, } from './workflow-targets.js';
+export { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedDatabaseSkillsFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedMcpServersFromState, getSelectedSkillTargetsForAgents, getSelectedWorkflowSkillsFromState, getSkillTargetsForAgents, getWorkflowTargets, } from '../../support/expected-workflow-targets.js';

package/bin/modules/template-catalog/templates.js ADDED Viewed

@@ -0,0 +1,154 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { getTemplatesPath } from '../../shared/paths.js';
+import { renderMcpConfig, resolveMcpConfigAgentId } from '../agent-tool-configuration/index.js';
+export function readTemplate(relativePath) {
+    return fs.readFileSync(path.join(getTemplatesPath(), relativePath), 'utf8');
+}
+export function readTemplateManifest() {
+    const manifest = JSON.parse(fs.readFileSync(path.join(getTemplatesPath(), 'manifest.json'), 'utf8'));
+    if (!isTemplateManifest(manifest)) {
+        throw new Error('templates/manifest.json is not a valid template manifest.');
+    }
+    return manifest;
+}
+export function getTemplateVersion(manifest, templateRelativePath) {
+    const template = manifest.templates[templateRelativePath];
+    if (!template) {
+        throw new Error(`Template ${templateRelativePath} is missing from templates/manifest.json.`);
+    }
+    return template.version;
+}
+function isTemplateManifest(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const manifest = value;
+    return (typeof manifest.templateVersion === 'string' &&
+        !!manifest.templates &&
+        typeof manifest.templates === 'object' &&
+        Object.values(manifest.templates).every((template) => !!template &&
+            typeof template === 'object' &&
+            typeof template.version === 'string' &&
+            typeof template.description === 'string' &&
+            Array.isArray(template.changes) &&
+            template.changes.every((change) => typeof change === 'string')));
+}
+export function renderTemplateForSync({ templateRelativePath, currentPath, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills = [], selectedDatabaseSkills = [], selectedMcpServers = [], }) {
+    let contents = readTemplate(templateRelativePath);
+    const mcpConfigAgentId = resolveMcpConfigAgentId(templateRelativePath);
+    if (mcpConfigAgentId) {
+        return renderMcpConfig({ agentId: mcpConfigAgentId, baseContents: contents, selectedMcpServers });
+    }
+    if (contents.includes('{{PROJECT_OVERVIEW}}')) {
+        contents = contents.replace('{{PROJECT_OVERVIEW}}', extractProjectOverview(currentPath) ?? 'Describe this project.');
+    }
+    contents = renderSkillRouting(contents, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills, selectedDatabaseSkills);
+    contents = renderWorkerToolboxRoutingPlaceholders(contents, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills, selectedDatabaseSkills);
+    return contents;
+}
+export function renderMissingWorkflowFiles({ missingTargets, overview, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills = [], selectedDatabaseSkills = [], selectedMcpServers = [], }) {
+    return missingTargets.map((target) => {
+        let contents = readTemplate(target.templateRelativePath);
+        if (target.mcpConfigAgentId && (target.selectedMcpServers?.length || selectedMcpServers.length)) {
+            contents = renderMcpConfig({
+                agentId: target.mcpConfigAgentId,
+                baseContents: contents,
+                selectedMcpServers: target.selectedMcpServers ?? selectedMcpServers,
+            });
+        }
+        if (target.requiresProjectOverview) {
+            if (!overview?.trim()) {
+                throw new Error('Project overview is required to create AGENTS.md.');
+            }
+            contents = contents.replace('{{PROJECT_OVERVIEW}}', overview.trim());
+        }
+        contents = renderSkillRouting(contents, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills, selectedDatabaseSkills);
+        contents = renderWorkerToolboxRoutingPlaceholders(contents, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills, selectedDatabaseSkills);
+        return {
+            label: target.label,
+            targetPath: target.targetPath,
+            contents,
+        };
+    });
+}
+export function renderSkillRouting(contents, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills = [], selectedDatabaseSkills = []) {
+    if (!contents.includes('{{OPTIONAL_SKILL_ROUTING}}')) {
+        return contents;
+    }
+    const optionalRouting = [...selectedLanguageSkills, ...selectedFrameworkSkills, ...selectedDatabaseSkills, ...(selectedArchitectureSkill ? [selectedArchitectureSkill] : []), ...selectedWorkflowSkills]
+        .map((skill) => `- ${skill.routingInstruction}`)
+        .join('\n');
+    return contents.replace('{{OPTIONAL_SKILL_ROUTING}}', optionalRouting);
+}
+export function renderWorkerToolboxRouting({ profile, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills = [], selectedDatabaseSkills = [], }) {
+    const selectedSkills = collectWorkerRelevantSkills({
+        selectedLanguageSkills,
+        selectedFrameworkSkills,
+        selectedArchitectureSkill,
+        selectedWorkflowSkills,
+        selectedDatabaseSkills,
+    });
+    const selectedSkillLines = selectedSkills.map((skill) => `- ${skill.name}: read \`${getSharedSkillTargetPath(skill)}\` when relevant. ${skill.routingInstruction}`);
+    const selectedSkillsSection = selectedSkillLines.length > 0
+        ? selectedSkillLines.join('\n')
+        : '- No optional implementation-relevant Sibu skills are selected for this project. Use source artifacts and flag unmapped patterns as risks instead of guessing silently.';
+    return `## Focused ${profile} worker routing
+- Always read and apply \`.agents/skills/clean-code/SKILL.md\` before ${profile === 'planner' ? 'writing implementation plan steps' : 'editing code or running story execution'}.
+- Read the worker toolbox skill path provided in the main-agent packet before doing work.
+- Read every required skill path listed in the packet. If a required skill path is missing, stop and report the blocker to the main agent.
+- Read optional installed skill paths only when they are relevant to the story, touched files, source artifacts, or validation work.
+- Treat distilled skill constraints from the packet as binding task constraints.
+- If an optional relevant skill is not installed and you encounter an unmapped language, framework, database, or architecture pattern, do not guess silently; continue only when safe and flag the gap as a ${profile === 'planner' ? 'plan risk' : 'Review Gate risk'}.
+### Optional installed skills relevant to ${profile} work
+${selectedSkillsSection}`;
+}
+export function renderWorkerToolboxRoutingPlaceholders(contents, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills = [], selectedDatabaseSkills = []) {
+    const placeholderProfiles = [
+        { placeholder: '{{PLANNER_WORKER_ROUTING}}', profile: 'planner' },
+        { placeholder: '{{EXECUTOR_WORKER_ROUTING}}', profile: 'executor' },
+    ];
+    let renderedContents = contents;
+    for (const { placeholder, profile } of placeholderProfiles) {
+        if (!renderedContents.includes(placeholder)) {
+            continue;
+        }
+        renderedContents = renderedContents.replace(placeholder, renderWorkerToolboxRouting({
+            profile,
+            selectedLanguageSkills,
+            selectedFrameworkSkills,
+            selectedArchitectureSkill,
+            selectedWorkflowSkills,
+            selectedDatabaseSkills,
+        }));
+    }
+    return renderedContents;
+}
+function collectWorkerRelevantSkills({ selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills, selectedDatabaseSkills, }) {
+    const implementationRelevantWorkflowSkills = selectedWorkflowSkills.filter((skill) => skill.id === 'ai-prompt-engineer-master' || skill.id === 'ux-expert');
+    return [
+        ...selectedLanguageSkills,
+        ...selectedFrameworkSkills,
+        ...selectedDatabaseSkills,
+        ...(selectedArchitectureSkill ? [selectedArchitectureSkill] : []),
+        ...implementationRelevantWorkflowSkills,
+    ];
+}
+function getSharedSkillTargetPath(skill) {
+    const sharedTargetPath = Object.values(skill.targetRelativePathsByAgent).find((targetPath) => targetPath !== undefined);
+    if (!sharedTargetPath) {
+        throw new Error(`Selectable skill ${skill.id} has no target path.`);
+    }
+    return sharedTargetPath;
+}
+export function extractProjectOverview(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return undefined;
+    }
+    const contents = fs.readFileSync(filePath, 'utf8');
+    const match = contents.match(/## Project overview\s+([\s\S]*?)(?=\n## |$)/);
+    const overview = match?.[1]?.trim();
+    return overview || undefined;
+}

package/bin/modules/workflow-configuration-manager/index.js ADDED Viewed

@@ -0,0 +1,6 @@
+export { handleListSkills } from './list-skills/handler.js';
+export { getNextSkillSelection, handleUseSkill } from './use-skill/handler.js';
+export { handleStopManagingFile, stopSelectedSkill } from './stop-managing-file/handler.js';
+export { getMcpServerListItems, handleListMcpServers } from './list-mcp-servers/handler.js';
+export { getNextMcpSelection, handleUseMcpServer } from './use-mcp-server/handler.js';
+export { applyStoppedMcpFileDeleteDecision, getNextStoppedMcpSelection, handleStopMcpServer, stopSelectedMcpServer } from './stop-mcp-server/handler.js';

package/bin/modules/workflow-configuration-manager/list-mcp-servers/handler.js ADDED Viewed

@@ -0,0 +1,46 @@
+import { intro, log, outro } from '@clack/prompts';
+import chalk from 'chalk';
+import { SELECTABLE_MCP_SERVERS } from '../../template-catalog/index.js';
+import { getProjectContext } from '../../../shared/paths.js';
+import { renderIntro } from '../../../support/interactive-guidance/index.js';
+import { readStateForDoctor } from '../../workflow-state-ledger/index.js';
+const defaultDependencies = {
+    renderIntro,
+    intro,
+    logMessage: log.message,
+    logWarn: log.warn,
+    logInfo: log.info,
+    outro,
+    getStatePath: () => getProjectContext().statePath,
+    readState: readStateForDoctor,
+};
+export async function handleListMcpServers(_command, dependencies = defaultDependencies) {
+    await dependencies.renderIntro();
+    dependencies.intro(chalk.cyan('Available MCP servers'));
+    const statePath = dependencies.getStatePath();
+    const stateResult = dependencies.readState(statePath);
+    const state = stateResult.ok ? stateResult.state : undefined;
+    if (!stateResult.ok) {
+        dependencies.logWarn(`${stateResult.message} Showing available MCP servers without project state.`);
+        dependencies.logInfo('Run `sibu init` before selecting project MCP servers.');
+    }
+    dependencies.logInfo('Sibu configures MCP files only; prerequisites, credentials, and provider authentication remain user-owned.');
+    dependencies.logMessage(chalk.bold('MCP servers'));
+    for (const server of getMcpServerListItems(state)) {
+        const marker = server.selected ? chalk.green('● selected') : chalk.dim('○ available');
+        console.log(`  ${marker} ${chalk.bold(server.name)} ${chalk.dim(`(${server.id})`)}`);
+        console.log(`    ${chalk.dim(server.description)}`);
+        console.log(`    ${chalk.dim(`Source: ${server.source}`)}`);
+    }
+    dependencies.outro(chalk.green('MCP server list ready.'));
+}
+export function getMcpServerListItems(state) {
+    const selectedServerIds = new Set(state?.selectedMcpServers ?? []);
+    return SELECTABLE_MCP_SERVERS.map((server) => ({
+        name: server.name,
+        id: server.id,
+        description: server.description,
+        source: server.source,
+        selected: selectedServerIds.has(server.id),
+    }));
+}

package/bin/modules/workflow-configuration-manager/list-skills/command.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/bin/modules/workflow-configuration-manager/list-skills/handler.js ADDED Viewed

@@ -0,0 +1,75 @@
+import { intro, log, outro } from '@clack/prompts';
+import chalk from 'chalk';
+import { SELECTABLE_ARCHITECTURE_SKILLS, SELECTABLE_DATABASE_SKILLS, SELECTABLE_FRAMEWORK_SKILLS, SELECTABLE_LANGUAGE_SKILLS, SELECTABLE_WORKFLOW_SKILLS } from '../../template-catalog/index.js';
+import { getProjectContext } from '../../../shared/paths.js';
+import { renderIntro } from '../../../support/interactive-guidance/index.js';
+import { readStateForDoctor } from '../../workflow-state-ledger/index.js';
+export async function handleListSkills(_command) {
+    await renderIntro();
+    intro(chalk.cyan('Available workflow skills'));
+    const { statePath } = getProjectContext();
+    const stateResult = readStateForDoctor(statePath);
+    const state = stateResult.ok ? stateResult.state : undefined;
+    if (!stateResult.ok) {
+        log.warn(`${stateResult.message} Showing available skills without project state.`);
+        log.info('Run `sibu init` before selecting project skills.');
+    }
+    logSkillGroup('Languages', getLanguageSkillItems(state));
+    logSkillGroup('Frameworks', getFrameworkSkillItems(state));
+    logSkillGroup('Databases', getDatabaseSkillItems(state));
+    logSkillGroup('Architecture', getArchitectureSkillItems(state));
+    logSkillGroup('Workflow', getWorkflowSkillItems(state));
+    outro(chalk.green('Skill list ready.'));
+}
+function getLanguageSkillItems(state) {
+    const selectedSkillIds = new Set(state?.selectedLanguageSkills ?? []);
+    return SELECTABLE_LANGUAGE_SKILLS.map((skill) => ({
+        name: skill.name,
+        id: skill.id,
+        description: skill.description,
+        selected: selectedSkillIds.has(skill.id),
+    }));
+}
+function getFrameworkSkillItems(state) {
+    const selectedSkillIds = new Set(state?.selectedFrameworkSkills ?? []);
+    return SELECTABLE_FRAMEWORK_SKILLS.map((skill) => ({
+        name: skill.name,
+        id: skill.id,
+        description: skill.description,
+        selected: selectedSkillIds.has(skill.id),
+    }));
+}
+function getDatabaseSkillItems(state) {
+    const selectedSkillIds = new Set(state?.selectedDatabaseSkills ?? []);
+    return SELECTABLE_DATABASE_SKILLS.map((skill) => ({
+        name: skill.name,
+        id: skill.id,
+        description: skill.description,
+        selected: selectedSkillIds.has(skill.id),
+    }));
+}
+function getArchitectureSkillItems(state) {
+    return SELECTABLE_ARCHITECTURE_SKILLS.map((skill) => ({
+        name: skill.name,
+        id: skill.id,
+        description: skill.description,
+        selected: state?.selectedArchitectureSkill === skill.id,
+    }));
+}
+function getWorkflowSkillItems(state) {
+    const selectedSkillIds = new Set(state?.selectedWorkflowSkills ?? []);
+    return SELECTABLE_WORKFLOW_SKILLS.map((skill) => ({
+        name: skill.name,
+        id: skill.id,
+        description: skill.description,
+        selected: selectedSkillIds.has(skill.id),
+    }));
+}
+function logSkillGroup(label, skills) {
+    log.message(chalk.bold(label));
+    for (const skill of skills) {
+        const marker = skill.selected ? chalk.green('● selected') : chalk.dim('○ available');
+        console.log(`  ${marker} ${chalk.bold(skill.name)} ${chalk.dim(`(${skill.id})`)}`);
+        console.log(`    ${chalk.dim(skill.description)}`);
+    }
+}

package/bin/modules/workflow-configuration-manager/stop-managing-file/command.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};