@juancr11/sibu 0.17.0 → 0.18.0

package/README.md

@@ -123,7 +123,7 @@ Sibu works best when AI collaboration stays small, explicit, and reviewable. The
 
 ```mermaid
 flowchart LR
-  orient["1. Orient<br/>Product vision + module map"] --> design["2. Design<br/>Feature brief + technical design"]
+  orient["1. Orient<br/>Product vision + domain model + capabilities + module map"] --> design["2. Design<br/>Feature brief + technical design"]
   design --> plan["3. Plan<br/>Epics, stories + implementation steps"]
   plan --> build["4. Build<br/>Small AI-assisted changes"]
   build --> validate["5. Validate<br/>Tests, checks + human review"]
@@ -133,7 +133,7 @@ flowchart LR
 
 | Stage | What it means |
 | --- | --- |
-| Orient | Clarify the product promise, boundaries, and deep modules so AI work starts with context instead of vibes. |
+| Orient | Clarify the product promise, business domain, capabilities, and deep modules so AI work starts with context instead of vibes. |
 | Design | Turn a feature idea into a brief and technical direction before implementation details sprawl. |
 | Plan | Split work into epics, stories, and implementation steps small enough for reviewable AI collaboration. |
 | Build | Let agents help with focused changes while the engineer keeps scope and judgment. |
@@ -146,45 +146,82 @@ This is not ceremony for ceremony's sake. It is how Sibu keeps velocity from tur
 
 Skills are reusable instructions that teach an AI agent how to handle a focused kind of work. Sibu uses them to keep prompts smaller, workflows clearer, and responsibilities explicit.
 
+The diagrams below show Sibu's bundled skill inventory, including optional selectable skills. Some skills may not be installed in this repository's `.agents/skills/` directory unless this project selected them.
+
 ```mermaid
 flowchart TB
-  skills["Sibu skills"]
-
-  skills --> product["Product + planning"]
+  product["Product + planning"]
   product --> productVision["product-vision-writer"]
+  product --> businessDomainModel["business-domain-model-writer"]
+  product --> capabilitiesMap["capabilities-map-writer"]
   product --> deepModuleMap["deep-module-map-writer"]
   product --> featureBrief["feature-brief-writer"]
+  product --> featureIdea["feature-idea-capture"]
   product --> scrumPlanner["scrum-master-planner"]
+```
 
-  skills --> designDelivery["Design + delivery"]
-  designDelivery --> technicalDesign["technical-design-writer"]
-  designDelivery --> implementationPlanner["ai-implementation-planner"]
-  designDelivery --> implementationExecutor["ai-implementation-plan-executor"]
+```mermaid
+flowchart TB
+  delivery["Design + delivery"]
+  delivery --> uxExpert["ux-expert"]
+  delivery --> technicalDesign["technical-design-writer"]
+  delivery --> implementationPlanner["ai-implementation-planner"]
+  delivery --> implementationPlannerToolbox["ai-implementation-planner-toolbox"]
+  delivery --> implementationExecutor["ai-implementation-plan-executor"]
+  delivery --> implementationExecutorToolbox["ai-implementation-executor-toolbox"]
+```
 
-  skills --> engineering["Engineering guidance"]
+```mermaid
+flowchart TB
+  engineering["Engineering guidance"]
   engineering --> cleanCode["clean-code"]
   engineering --> typescript["typescript"]
+  engineering --> react["react"]
+  engineering --> nextjs["nextjs"]
+  engineering --> golang["golang"]
+  engineering --> postgres["postgresql-expert"]
   engineering --> commandPattern["command-pattern"]
+  engineering --> dddHexagonal["ddd-hexagonal"]
+  engineering --> layeredArchitecture["layered-architecture"]
+```
+
+```mermaid
+flowchart TB
+  maintenance["Prompts, exports + workflow maintenance"]
+  maintenance --> promptEngineer["ai-prompt-engineer-master"]
+  maintenance --> exportGithub["export-to-github"]
+  maintenance --> exportNotion["export-to-notion"]
+  maintenance --> templateChange["sibu-template-change"]
+```
 
-  skills --> promptsMaintenance["Prompts + workflow maintenance"]
-  promptsMaintenance --> promptEngineer["ai-prompt-engineer-master"]
-  promptsMaintenance --> templateChange["sibu-template-change"]
-```
-
-| Skill | Helps with | Use when... |
-| --- | --- | --- |
-| `product-vision-writer` | Product vision and positioning | You need to define or revise the product north star, audience, boundaries, voice, or success signals. |
-| `deep-module-map-writer` | Deep implementation boundaries | You need to map durable modules before feature work, or decide where future work belongs. |
-| `feature-brief-writer` | Business-level feature definition | You need a scoped feature brief grounded in the product vision and Deep Module Map. |
-| `technical-design-writer` | Implementation-oriented design | You have an approved feature brief and need a concise technical direction before planning stories. |
-| `scrum-master-planner` | Epics and user stories | You need to split an approved feature brief and technical design into pragmatic delivery slices. |
-| `ai-implementation-planner` | Story implementation steps | You need an approved user story turned into small, executable implementation-plan files. |
-| `ai-implementation-plan-executor` | Plan execution | You want an agent to execute a story implementation plan, stop for review, then commit after approval. |
-| `clean-code` | General code quality | Any task writes or modifies code and should stay clear, simple, focused, and readable. |
-| `typescript` | TypeScript guidance | A task changes `.ts` or `.tsx` files and needs practical TypeScript discipline. |
-| `command-pattern` | Vertical-slice command design | Work involves command handlers, workflows, request processing, or executable tasks. |
-| `ai-prompt-engineer-master` | Prompt and template quality | You are creating, rewriting, compressing, or evaluating prompts or reusable AI instructions. |
-| `sibu-template-change` | Sibu template maintenance | You change files under `templates/` or template manifest metadata and need safe lifecycle validation. |
+| Skill | Helps with | Availability | Use when... |
+| --- | --- | --- | --- |
+| `product-vision-writer` | Product vision and positioning | Installed here | You need to define or revise the product north star, audience, boundaries, voice, or success signals. |
+| `business-domain-model-writer` | Domain language and rules | Installed here | You need to clarify business concepts, subdomains, workflows, lifecycle rules, domain events, or boundaries. |
+| `capabilities-map-writer` | Business/product capability map | Installed here | You need to map the product abilities each subdomain must provide before module or feature planning. |
+| `deep-module-map-writer` | Deep implementation boundaries | Installed here | You need to map durable modules from the product vision, domain model, and capabilities map before feature work. |
+| `feature-brief-writer` | Business-level feature definition | Installed here | You need a scoped feature brief grounded in the product vision, Business Domain Model, and Capabilities Map. |
+| `feature-idea-capture` | Rough future ideas | Installed here | You want to save a feature, product, workflow, or improvement idea without turning it into planned work yet. |
+| `scrum-master-planner` | Epics and user stories | Installed here | You need to split an approved feature brief and technical design into pragmatic delivery slices. |
+| `ux-expert` | UX design guidance | Bundled optional | You need UX design, interaction, flow, layout, or experience guidance. |
+| `technical-design-writer` | Implementation-oriented design | Installed here | You have an approved feature brief and need a concise technical direction before planning stories. |
+| `ai-implementation-planner` | Story implementation steps | Installed here | You need an approved user story turned into small, executable implementation-plan files. |
+| `ai-implementation-planner-toolbox` | Planner sub-agent rules | Installed here | A Sibu implementation planner worker needs worker-only rules for creating a story-local implementation plan. |
+| `ai-implementation-plan-executor` | Plan execution | Installed here | You want an agent to execute a story implementation plan, stop for review, then commit after approval. |
+| `ai-implementation-executor-toolbox` | Executor sub-agent rules | Installed here | A Sibu implementation executor worker needs worker-only rules for executing one story plan with validation. |
+| `clean-code` | General code quality | Installed here | Any task writes or modifies code and should stay clear, simple, focused, and readable. |
+| `typescript` | TypeScript guidance | Installed here | A task changes `.ts` or `.tsx` files and needs practical TypeScript discipline. |
+| `react` | React component design | Bundled optional | Work creates or edits React components, props, state ownership, or presentation boundaries. |
+| `nextjs` | Next.js App Router guidance | Bundled optional | Work touches Next.js App Router files, rendering choices, data fetching placement, or framework-specific behavior. |
+| `golang` | Go implementation guidance | Bundled optional | Work changes Go code and needs idiomatic Go structure, errors, tests, or interfaces. |
+| `postgresql-expert` | PostgreSQL guidance | Bundled optional | Work changes PostgreSQL schema, queries, migrations, indexes, constraints, or transaction behavior. |
+| `command-pattern` | Vertical-slice command design | Installed here | Work involves command handlers, workflows, request processing, or executable tasks. |
+| `ddd-hexagonal` | DDD/hexagonal architecture | Bundled optional | Work needs domain/application/infrastructure boundaries, ports, adapters, or dependency-direction guidance. |
+| `layered-architecture` | Layered architecture | Bundled optional | Work needs presentation, application, domain, and infrastructure layering guidance. |
+| `ai-prompt-engineer-master` | Prompt and template quality | Installed here | You are creating, rewriting, compressing, or evaluating prompts or reusable AI instructions. |
+| `export-to-github` | GitHub issue export | Installed here | You need to export a feature's Epics and User Stories to GitHub issues and sub-issues. |
+| `export-to-notion` | Notion documentation export | Installed here | You need to export local feature briefs, UX designs, or technical designs to Notion. |
+| `sibu-template-change` | Sibu template maintenance | Installed here | You change files under `templates/` or template manifest metadata and need safe lifecycle validation. |
 
 The point is not to make agents magical. The point is to give them the right job, the right context, and a tight enough boundary that a human can trust the result.
 

package/bin/entrypoints/cli/create-program.js

@@ -1,5 +1,5 @@
 import { Command as CommanderCommand } from 'commander';
-import { SIBU_VERSION } from '../../modules/version-advisory/index.js';
+import { SIBU_VERSION } from '../../support/version-advisory/index.js';
 import { executeCliCommand } from './execute-command.js';
 export function createProgram() {
     const cli = new CommanderCommand();

package/bin/entrypoints/cli/execute-command.js

@@ -1,10 +1,7 @@
-import { handleDoctorProject } from '../../modules/workflow-health-diagnosis/index.js';
-import { handleInitProject } from '../../modules/project-adoption/index.js';
-import { handleListMcpServers, handleStopMcpServer, handleUseMcpServer } from '../../modules/mcp-server-selection-management/index.js';
-import { handleListSkills } from '../../modules/skill-selection-management/index.js';
-import { handleStopManagingFile } from '../../modules/skill-selection-management/index.js';
-import { handleSyncProject } from '../../modules/sync-review/index.js';
-import { handleUseSkill } from '../../modules/skill-selection-management/index.js';
+import { handleDoctorProject } from '../../modules/workflow-health-inspector/index.js';
+import { handleInitProject } from '../../modules/workflow-installer/index.js';
+import { handleListMcpServers, handleListSkills, handleStopManagingFile, handleStopMcpServer, handleUseMcpServer, handleUseSkill, } from '../../modules/workflow-configuration-manager/index.js';
+import { handleSyncProject } from '../../modules/sync-review-orchestrator/index.js';
 export async function executeCliCommand(command) {
     switch (command.type) {
         case 'init':

package/bin/modules/agent-tool-configuration/index.js

@@ -0,0 +1 @@
+export { getMcpConfigTargetsForAgents, renderMcpConfig, resolveMcpConfigAgentId } from './mcp-config.js';

package/bin/modules/agent-tool-configuration/mcp-config.js

@@ -0,0 +1,134 @@
+export function getMcpConfigTargetsForAgents(selectedAgents, selectedMcpServers) {
+    if (selectedMcpServers.length === 0) {
+        return [];
+    }
+    return selectedAgents.flatMap((agent) => {
+        if (agent.id === 'codex') {
+            return [
+                {
+                    targetRelativePath: '.codex/config.toml',
+                    templateRelativePath: '.codex/config.toml',
+                    agentId: 'codex',
+                },
+            ];
+        }
+        if (agent.id === 'claude') {
+            return [
+                {
+                    targetRelativePath: '.mcp.json',
+                    templateRelativePath: 'mcp/claude/.mcp.json',
+                    agentId: 'claude',
+                },
+            ];
+        }
+        if (agent.id === 'gemini') {
+            return [
+                {
+                    targetRelativePath: '.gemini/settings.json',
+                    templateRelativePath: 'mcp/gemini/settings.json',
+                    agentId: 'gemini',
+                },
+            ];
+        }
+        return [];
+    });
+}
+export function renderMcpConfig({ agentId, baseContents, selectedMcpServers, }) {
+    if (selectedMcpServers.length === 0) {
+        return baseContents ?? renderJsonMcpConfig({});
+    }
+    if (agentId === 'codex') {
+        return renderCodexMcpConfig(baseContents ?? '', selectedMcpServers);
+    }
+    return renderJsonMcpConfig(buildJsonMcpServerConfigs(agentId, selectedMcpServers), baseContents);
+}
+export function resolveMcpConfigAgentId(templateRelativePath) {
+    if (templateRelativePath === '.codex/config.toml') {
+        return 'codex';
+    }
+    if (templateRelativePath === 'mcp/claude/.mcp.json') {
+        return 'claude';
+    }
+    if (templateRelativePath === 'mcp/gemini/settings.json') {
+        return 'gemini';
+    }
+    if (templateRelativePath === '.gemini/settings.json') {
+        return 'gemini';
+    }
+    return undefined;
+}
+function renderCodexMcpConfig(baseContents, selectedMcpServers) {
+    const trimmedBaseContents = baseContents.trimEnd();
+    const serverConfigs = selectedMcpServers.map((server) => buildCodexMcpServerConfig(server)).filter((config) => config.length > 0);
+    if (serverConfigs.length === 0) {
+        return baseContents;
+    }
+    const separator = trimmedBaseContents ? '\n\n' : '';
+    return `${trimmedBaseContents}${separator}${serverConfigs.join('\n\n')}\n`;
+}
+function buildCodexMcpServerConfig(server) {
+    if (server.id === 'github') {
+        return `[mcp_servers.github]
+url = "https://api.githubcopilot.com/mcp/"
+bearer_token_env_var = "GITHUB_PERSONAL_ACCESS_TOKEN"
+
+[mcp_servers.github.tools.issue_write]
+approval_mode = "approve"
+
+[mcp_servers.github.tools.sub_issue_write]
+approval_mode = "approve"`;
+    }
+    if (server.id === 'notion') {
+        return `[mcp_servers.notion]
+url = "https://mcp.notion.com/mcp"`;
+    }
+    return '';
+}
+function buildJsonMcpServerConfigs(agentId, selectedMcpServers) {
+    const mcpServers = {};
+    for (const server of selectedMcpServers) {
+        if (server.id === 'github') {
+            mcpServers.github = buildGithubMcpServerConfig(agentId);
+        }
+        if (server.id === 'notion') {
+            mcpServers.notion = buildNotionMcpServerConfig();
+        }
+    }
+    return mcpServers;
+}
+function buildGithubMcpServerConfig(agentId) {
+    const headers = {
+        Authorization: 'Bearer ${GITHUB_PERSONAL_ACCESS_TOKEN}',
+    };
+    if (agentId === 'gemini') {
+        return {
+            httpUrl: 'https://api.githubcopilot.com/mcp/',
+            headers,
+        };
+    }
+    return {
+        type: 'http',
+        url: 'https://api.githubcopilot.com/mcp/',
+        headers,
+    };
+}
+function buildNotionMcpServerConfig() {
+    return {
+        url: 'https://mcp.notion.com/mcp',
+    };
+}
+function renderJsonMcpConfig(mcpServers, baseContents) {
+    const baseConfig = parseJsonObject(baseContents);
+    baseConfig.mcpServers = mcpServers;
+    return `${JSON.stringify(baseConfig, null, 2)}\n`;
+}
+function parseJsonObject(contents) {
+    if (!contents?.trim()) {
+        return {};
+    }
+    const parsed = JSON.parse(contents);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error('Expected JSON template to contain an object.');
+    }
+    return parsed;
+}

package/bin/modules/interactive-guidance/prompts.js

@@ -3,7 +3,7 @@ import { cancel, isCancel, multiselect, select, text } from '@clack/prompts';
 import gradient from 'gradient-string';
 import { Box, Text, render, useApp } from 'ink';
 import { useEffect } from 'react';
-import { SELECTABLE_ARCHITECTURE_SKILLS, SELECTABLE_DATABASE_SKILLS, SELECTABLE_FRAMEWORK_SKILLS, SELECTABLE_LANGUAGE_SKILLS, SELECTABLE_MCP_SERVERS, SELECTABLE_WORKFLOW_SKILLS, SUPPORTED_AGENTS, } from '../workflow-target-planning/index.js';
+import { SELECTABLE_ARCHITECTURE_SKILLS, SELECTABLE_DATABASE_SKILLS, SELECTABLE_FRAMEWORK_SKILLS, SELECTABLE_LANGUAGE_SKILLS, SELECTABLE_MCP_SERVERS, SELECTABLE_WORKFLOW_SKILLS, SUPPORTED_AGENTS, } from '../template-catalog/index.js';
 const NONE_OPTION_ID = 'none';
 export const MCP_SERVER_SELECTION_MESSAGE = 'Select optional MCP servers to configure. Sibu writes config files only; you own prerequisites and authentication.';
 export async function renderIntro() {

package/bin/modules/mcp-server-selection-management/list-mcp-servers/handler.js

@@ -1,9 +1,9 @@
 import { intro, log, outro } from '@clack/prompts';
 import chalk from 'chalk';
-import { SELECTABLE_MCP_SERVERS } from '../../workflow-target-planning/index.js';
+import { SELECTABLE_MCP_SERVERS } from '../../template-catalog/index.js';
 import { getProjectContext } from '../../../shared/paths.js';
 import { renderIntro } from '../../interactive-guidance/index.js';
-import { readStateForDoctor } from '../../workflow-state-registry/index.js';
+import { readStateForDoctor } from '../../workflow-state-ledger/index.js';
 const defaultDependencies = {
     renderIntro,
     intro,

package/bin/modules/mcp-server-selection-management/stop-mcp-server/handler.js

@@ -5,11 +5,11 @@ import { STATE_RELATIVE_PATH } from '../../../shared/catalog.js';
 import { readFileHashIfPresent, sha256 } from '../../../shared/hash.js';
 import { removeUndefinedFields } from '../../../shared/object.js';
 import { getProjectContext } from '../../../shared/paths.js';
-import { renderMissingWorkflowFiles, resolveSelectableMcpServerById } from '../../workflow-target-planning/index.js';
-import { getWorkflowMutationReadiness } from '../../workflow-mutation-readiness/index.js';
-import { getTemplateVersion, readTemplateManifest } from '../../template-catalog-rendering/index.js';
-import { cloneState, writeStateFile } from '../../workflow-state-registry/index.js';
-import { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedDatabaseSkillsFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedMcpServersFromState, getSelectedWorkflowSkillsFromState, getWorkflowTargets, } from '../../workflow-target-planning/index.js';
+import { renderMissingWorkflowFiles, resolveSelectableMcpServerById } from '../../template-catalog/index.js';
+import { getWorkflowMutationReadiness } from '../../sync-review-orchestrator/index.js';
+import { getTemplateVersion, readTemplateManifest } from '../../template-catalog/index.js';
+import { cloneState, writeStateFile } from '../../workflow-state-ledger/index.js';
+import { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedDatabaseSkillsFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedMcpServersFromState, getSelectedWorkflowSkillsFromState, getWorkflowTargets, } from '../../template-catalog/index.js';
 export async function handleStopMcpServer(command) {
     const { rootPath, statePath } = getProjectContext();
     const readiness = getWorkflowMutationReadiness({ rootPath, statePath });

package/bin/modules/mcp-server-selection-management/use-mcp-server/handler.js

@@ -1,13 +1,14 @@
 import fs from 'node:fs';
 import path from 'node:path';
+import { writeSibuState } from '../../workflow-state-ledger/index.js';
 import { log } from '@clack/prompts';
 import { STATE_RELATIVE_PATH } from '../../../shared/catalog.js';
 import { sha256 } from '../../../shared/hash.js';
 import { getProjectContext } from '../../../shared/paths.js';
 import { askForNotionDocsParentPage } from '../../interactive-guidance/index.js';
-import { renderTemplateForSync } from '../../template-catalog-rendering/index.js';
-import { getWorkflowMutationReadiness } from '../../workflow-mutation-readiness/index.js';
-import { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedDatabaseSkillsFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedMcpServersFromState, getSelectedWorkflowSkillsFromState, getWorkflowSkillsImpliedByMcpServers, getWorkflowTargets, renderMissingWorkflowFiles, resolveSelectableMcpServerById, writeSibuState, } from '../../workflow-target-planning/index.js';
+import { renderTemplateForSync } from '../../template-catalog/index.js';
+import { getWorkflowMutationReadiness } from '../../sync-review-orchestrator/index.js';
+import { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedDatabaseSkillsFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedMcpServersFromState, getSelectedWorkflowSkillsFromState, getWorkflowSkillsImpliedByMcpServers, getWorkflowTargets, renderMissingWorkflowFiles, resolveSelectableMcpServerById, } from '../../template-catalog/index.js';
 const defaultDependencies = {
     askForNotionDocsParentPage,
 };

package/bin/modules/skill-selection-management/list-skills/handler.js

@@ -1,9 +1,9 @@
 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 '../../workflow-target-planning/index.js';
+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 '../../interactive-guidance/index.js';
-import { readStateForDoctor } from '../../workflow-state-registry/index.js';
+import { readStateForDoctor } from '../../workflow-state-ledger/index.js';
 export async function handleListSkills(_command) {
     await renderIntro();
     intro(chalk.cyan('Available workflow skills'));

package/bin/modules/skill-selection-management/stop-managing-file/handler.js

@@ -3,14 +3,15 @@ import path from 'node:path';
 import { cancel, intro, isCancel, log, outro, select } from '@clack/prompts';
 import chalk from 'chalk';
 import { STATE_RELATIVE_PATH } from '../../../shared/catalog.js';
-import { resolveSelectableSkillById } from '../../workflow-target-planning/index.js';
+import { resolveSelectableSkillById } from '../../template-catalog/index.js';
 import { readFileHashIfPresent, sha256 } from '../../../shared/hash.js';
 import { getProjectContext } from '../../../shared/paths.js';
 import { renderIntro } from '../../interactive-guidance/index.js';
-import { cloneState, readStateForDoctor, writeStateFile } from '../../workflow-state-registry/index.js';
-import { getTemplateVersion, readTemplateManifest, renderTemplateForSync } from '../../template-catalog-rendering/index.js';
+import { cloneState, readStateForDoctor, writeStateFile } from '../../workflow-state-ledger/index.js';
+import { getTemplateVersion, readTemplateManifest } from '../../template-catalog/index.js';
+import { renderTemplateForSync } from '../../template-catalog/index.js';
 import { removeUndefinedFields } from '../../../shared/object.js';
-import { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedDatabaseSkillsFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedWorkflowSkillsFromState, getSkillTargetsForAgents, } from '../../workflow-target-planning/index.js';
+import { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedDatabaseSkillsFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedWorkflowSkillsFromState, getSkillTargetsForAgents, } from '../../template-catalog/index.js';
 export async function handleStopManagingFile({ skillName }) {
     await renderIntro();
     intro(chalk.cyan('Updating skill management'));

package/bin/modules/skill-selection-management/use-skill/handler.js

@@ -1,14 +1,15 @@
 import fs from 'node:fs';
 import path from 'node:path';
+import { writeSibuState } from '../../workflow-state-ledger/index.js';
 import { log } from '@clack/prompts';
 import { STATE_RELATIVE_PATH } from '../../../shared/catalog.js';
 import { askForNotionDocsParentPage } from '../../interactive-guidance/index.js';
-import { getMcpServersRequiredByWorkflowSkills, resolveSelectableSkillById } from '../../workflow-target-planning/index.js';
+import { getMcpServersRequiredByWorkflowSkills, resolveSelectableSkillById } from '../../template-catalog/index.js';
 import { sha256 } from '../../../shared/hash.js';
 import { getProjectContext } from '../../../shared/paths.js';
-import { renderTemplateForSync } from '../../template-catalog-rendering/index.js';
-import { getWorkflowMutationReadiness } from '../../workflow-mutation-readiness/index.js';
-import { getSelectedAgentsFromState, getSelectedMcpServersFromState, getWorkflowTargets, renderMissingWorkflowFiles, writeSibuState } from '../../workflow-target-planning/index.js';
+import { renderTemplateForSync } from '../../template-catalog/index.js';
+import { getWorkflowMutationReadiness } from '../../sync-review-orchestrator/index.js';
+import { getSelectedAgentsFromState, getSelectedMcpServersFromState, getWorkflowTargets, renderMissingWorkflowFiles, } from '../../template-catalog/index.js';
 const defaultDependencies = {
     askForNotionDocsParentPage,
 };

package/bin/modules/{sync-review → sync-review-orchestrator}/apply-action.js

@@ -3,9 +3,10 @@ import path from 'node:path';
 import { log } from '@clack/prompts';
 import { sha256 } from '../../shared/hash.js';
 import { getSideTemplatePath } from '../../shared/paths.js';
-import { cloneState } from '../workflow-state-registry/index.js';
-import { getTemplateVersion, renderTemplateForSync } from '../template-catalog-rendering/index.js';
-import { getSelectedArchitectureSkillFromState, getSelectedDatabaseSkillsFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedMcpServersFromState, getSelectedWorkflowSkillsFromState, } from '../workflow-target-planning/index.js';
+import { cloneState } from '../workflow-state-ledger/index.js';
+import { getTemplateVersion } from '../template-catalog/index.js';
+import { renderTemplateForSync } from '../template-catalog/index.js';
+import { getSelectedArchitectureSkillFromState, getSelectedDatabaseSkillsFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedMcpServersFromState, getSelectedWorkflowSkillsFromState, } from '../template-catalog/index.js';
 export function applySyncAction({ rootPath, state, manifest, preview, action, }) {
     const nextState = cloneState(state);
     const managedFile = nextState.managedFiles[preview.relativePath] ?? preview.managedFile;

package/bin/modules/{sync-review → sync-review-orchestrator}/handler.js

@@ -1,10 +1,10 @@
 import { intro, log, outro } from '@clack/prompts';
 import chalk from 'chalk';
-import { STATE_RELATIVE_PATH } from '../../shared/catalog.js';
+import { STATE_RELATIVE_PATH } from '../workflow-state-ledger/state-path.js';
 import { getProjectContext } from '../../shared/paths.js';
-import { askForMissingFrameworkSkills, askForNewArchitectureSkill, askForNewLanguageSkills, renderIntro } from '../interactive-guidance/index.js';
-import { readStateForDoctor, writeStateFile } from '../workflow-state-registry/index.js';
-import { readTemplateManifest } from '../template-catalog-rendering/index.js';
+import { askForMissingFrameworkSkills, askForNewArchitectureSkill, askForNewLanguageSkills, renderIntro } from '../../support/interactive-guidance/index.js';
+import { readStateForDoctor, writeStateFile } from '../workflow-state-ledger/index.js';
+import { readTemplateManifest } from '../template-catalog/index.js';
 import { askForSyncAction, askForUnsupportedAgentCleanup } from './action-prompt.js';
 import { applySyncAction } from './apply-action.js';
 import { logSyncPreview } from './log-preview.js';

package/bin/modules/{sync-review → sync-review-orchestrator}/index.js

@@ -4,3 +4,4 @@ export { handleSyncProject } from './handler.js';
 export { logSyncPreview } from './log-preview.js';
 export { getSyncPreviews, isActionableSyncPreview, shouldAskForSyncAction } from './sync-preview.js';
 export { applyUnsupportedAgentCleanup, getUnsupportedAgentCleanupPlan } from './unsupported-agent-cleanup.js';
+export { getWorkflowMutationReadiness } from './workflow-mutation-readiness.js';

package/bin/modules/{sync-review → sync-review-orchestrator}/log-preview.js

@@ -1,5 +1,5 @@
 import { log } from '@clack/prompts';
-import { STATE_RELATIVE_PATH } from '../../shared/catalog.js';
+import { STATE_RELATIVE_PATH } from '../workflow-state-ledger/state-path.js';
 export function logSyncPreview(preview) {
     switch (preview.status) {
         case 'up-to-date':

package/bin/modules/{sync-review → sync-review-orchestrator}/sync-preview.js

@@ -1,9 +1,9 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { sha256 } from '../../shared/hash.js';
-import { hasReviewedTemplateVersion } from '../workflow-state-registry/index.js';
-import { renderTemplateForSync } from '../template-catalog-rendering/index.js';
-import { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedDatabaseSkillsFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedMcpServersFromState, getSelectedWorkflowSkillsFromState, getSkillTargetsForAgents, getWorkflowSkillsImpliedByMcpServers, getWorkflowTargets, } from '../workflow-target-planning/index.js';
+import { hasReviewedTemplateVersion } from '../workflow-state-ledger/index.js';
+import { renderTemplateForSync } from '../template-catalog/index.js';
+import { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedDatabaseSkillsFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedMcpServersFromState, getSelectedWorkflowSkillsFromState, getSkillTargetsForAgents, getWorkflowSkillsImpliedByMcpServers, getWorkflowTargets, } from '../template-catalog/index.js';
 const ACTIONABLE_SYNC_PREVIEW_STATUSES = new Set([
     'new-template',
     'missing',

package/bin/modules/{sync-review → sync-review-orchestrator}/unsupported-agent-cleanup.js

@@ -1,7 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
-import { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedDatabaseSkillsFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedMcpServersFromState, getSelectedWorkflowSkillsFromState, getWorkflowTargets, SUPPORTED_AGENTS, } from '../workflow-target-planning/index.js';
-import { cloneState } from '../workflow-state-registry/index.js';
+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));

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

@@ -1,7 +1,7 @@
-import { readStateForDoctor } from '../workflow-state-registry/index.js';
-import { getSyncPreviews, isActionableSyncPreview } from '../sync-review/index.js';
-import { getUnsupportedAgentCleanupPlan } from '../sync-review/unsupported-agent-cleanup.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) {

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

@@ -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';