synarcx 0.2.0 → 0.3.0

package/dist/core/templates/workflows/sync.js

@@ -1,101 +1,144 @@
+import { commandFromSkill } from '../types.js';
 export function getSynSyncSkillTemplate() {
     return {
         name: 'syn-sync',
         description: 'Generate or update synspec/constitution.md with README validation, supporting file scan, guardrail Q&A, and structured constitution generation.',
-        instructions: `Generate or update the project constitution — a living document in \`synspec/constitution.md\` that captures validated project context.
-
-**Input**: The user can specify a focus area, or just run the command to proceed through the validation flow.
-
----
-
-## README Gate (Required)
-
-Before any generation, the README MUST pass quality validation.
-
-1. **Check that README.md exists and is not empty.**
-   - If missing or blank → stop, output: "SYNC BLOCKED: README.md is missing or empty. Please write a README that describes what this project does and what problem it solves, then re-run \`/syn:sync\`."
-   - Do NOT write any files. Do NOT proceed.
-
-2. **Check that README meaningfully describes the project.**
-   - A passing README must have both:
-     - At least one sentence describing what the project does
-     - At least one sentence describing the problem it solves or who it is for
-   - AI judges quality at runtime. Examples of THIN content that should fail:
-     - Only a title and install instructions
-     - Auto-generated placeholder text ("# My Project", "## Getting Started")
-     - Single-line descriptions with no substance
-   - If README is too thin → stop, output: "SYNC BLOCKED: README is too thin. A passing README must describe (1) what the project does and (2) what problem it solves, in at least one sentence each. Please update README.md and re-run \`/syn:sync\`."
-
-3. **If README passes**, proceed to the next phase.
-
----
-
-## Supporting File Scan
-
-After README passes, read supporting project files for context:
-- \`AGENTS.md\` — AI agent conventions
-- \`package.json\` — dependencies, scripts, metadata
-- \`src/\` structure — code organization (top-level directories)
-- Any other notable config files (\`tsconfig.json\`, \`.eslintrc.*\`, etc.)
-
-Note what information is already well-covered by the README so guardrail questions avoid repeating it.
-
----
-
-## Guardrail Q&A
-
-Generate up to 5 targeted questions. Each question should probe areas that CANNOT be reliably inferred from code or README alone:
-
-| Topic Area | Example Question |
-|------------|-----------------|
-| Off-limits areas | "Are there any parts of the codebase AI should never modify?" |
-| Hard constraints | "Are there compliance, security, or infrastructure constraints?" |
-| Coding rules | "Are there coding conventions not obvious from the code?" |
-| Out-of-scope | "What is explicitly out of scope for this project right now?" |
-| Dependencies | "Are there any planned or pending dependency changes?" |
-
-**Rules:**
-- Adapt questions to the project's stack, structure, and domain — don't ask generic questions that don't apply
-- Skip questions already answered by the README, AGENTS.md, or other supporting files
-- Maximum 5 questions per session
-- Ask one at a time using the AskUserQuestion tool, wait for each answer
-
----
-
-## Constitution Generation
-
-With README validated, supporting files scanned, and Q&A answers collected, generate \`synspec/constitution.md\` with these sections:
-
-1. **\`# Constitution: <project-name>\`** — derived from package.json name, with Version field
-2. **\`## Purpose\`** — 2-3 sentences synthesized from README
-3. **\`## Principles\`** — key design principles inferred from codebase and Q&A
-4. **\`## Tech Stack\`** — languages, frameworks, key dependencies from package.json
-5. **\`## Constraints\`** — from Q&A answers: hard constraints, compliance, infra limits
-6. **\`## Off-Limits\`** — from Q&A answers: areas AI must not touch, out-of-scope items
-7. **\`## Conventions\`** — code style, naming, patterns observed from code and AGENTS.md
-8. **\`## Architecture\`** — high-level structure overview from src/ scan
-9. **\`## Decision Log\`** — table with Date, Decision, Rationale (append-only)
-
-**The Constraints and Off-Limits sections MUST be written from Q&A answers, not inferred from docs.**
-
----
-
-## Re-run (Update)
-
-When re-run and \`synspec/constitution.md\` already exists, still run the README gate — README may have degraded since last sync. Offer a semver bump choice:
-- **MAJOR** — constitution structure changed or reorganized
-- **MINOR** — new section added
-- **PATCH** — content update, typo fixes
-
-Append a Sync Impact Report as an HTML comment at the top:
-\`\`\`
-<!-- Sync Impact: MAJOR — constitution structure reorganized -->
-\`\`\`
-
----
-
-## Output
-
+        instructions: `## Step 0: SynArcX Version Check (MUST run first)
+
+Do NOT read any project files yet. Run this version check first.
+
+### 0.1 Read the daily cache
+
+Read \`synspec/.version-cache.json\`. If \`lastCheck\` matches today's UTC date (YYYY-MM-DD), skip the version check entirely — proceed to "Main Sync Flow" below.
+
+Expected cache format:
+\`\`\`json
+{ "lastCheck": "2026-05-13", "latestVersion": "0.4.0" }
+\`\`\`
+
+If missing or malformed, treat as cache miss and continue.
+
+### 0.2 Fetch latest from npm
+
+Run \`npm view synarcx version\`. On failure (no npm, no network, non-zero exit): silently skip to 0.5, write cache with \`latestVersion: null\`.
+
+### 0.3 Get installed version
+
+Run \`synarcx --version\`. On failure: silently skip to 0.5.
+
+### 0.4 Compare and prompt
+
+Parse both as semver: split on \`.\`, parse each as integer, compare major→minor→patch. If npm version > installed:
+
+1. Print update banner.
+2. Use AskUserQuestion tool: "Update now?" with \`["Yes", "No"]\`.
+3. **Yes**: Run \`npm install -g synarcx@latest\`. On success: print "✓ SynArcX updated" + "Run \`synarcx update\` to refresh skill files." On failure: print error + manual command.
+4. **No**: Print manual command.
+
+If versions match, proceed silently.
+
+### 0.5 Write cache
+
+Write \`synspec/.version-cache.json\` with today's UTC date and latest version (or \`null\` on failure). Use \`new Date().toISOString().split('T')[0]\`.
+
+---
+
+## Main Sync Flow
+
+Generate or update the project constitution — a living document in \`synspec/constitution.md\` that captures validated project context.
+
+**Input**: The user can specify a focus area, or just run the command to proceed through the validation flow.
+
+---
+
+## README Gate (Required)
+
+Before any generation, the README MUST pass quality validation.
+
+1. **Check that README.md exists and is not empty.**
+   - If missing or blank → stop, output: "SYNC BLOCKED: README.md is missing or empty. Please write a README that describes what this project does and what problem it solves, then re-run \`/syn:sync\`."
+   - Do NOT write any files. Do NOT proceed.
+
+2. **Check that README meaningfully describes the project.**
+   - A passing README must have both:
+     - At least one sentence describing what the project does
+     - At least one sentence describing the problem it solves or who it is for
+   - AI judges quality at runtime. Examples of THIN content that should fail:
+     - Only a title and install instructions
+     - Auto-generated placeholder text ("# My Project", "## Getting Started")
+     - Single-line descriptions with no substance
+   - If README is too thin → stop, output: "SYNC BLOCKED: README is too thin. A passing README must describe (1) what the project does and (2) what problem it solves, in at least one sentence each. Please update README.md and re-run \`/syn:sync\`."
+
+3. **If README passes**, proceed to the next phase.
+
+---
+
+## Supporting File Scan
+
+After README passes, read supporting project files for context:
+- \`AGENTS.md\` — AI agent conventions
+- \`package.json\` — dependencies, scripts, metadata
+- \`src/\` structure — code organization (top-level directories)
+- Any other notable config files (\`tsconfig.json\`, \`.eslintrc.*\`, etc.)
+
+Note what information is already well-covered by the README so guardrail questions avoid repeating it.
+
+---
+
+## Guardrail Q&A
+
+Generate up to 5 targeted questions. Each question should probe areas that CANNOT be reliably inferred from code or README alone:
+
+| Topic Area | Example Question |
+|------------|-----------------|
+| Off-limits areas | "Are there any parts of the codebase AI should never modify?" |
+| Hard constraints | "Are there compliance, security, or infrastructure constraints?" |
+| Coding rules | "Are there coding conventions not obvious from the code?" |
+| Out-of-scope | "What is explicitly out of scope for this project right now?" |
+| Dependencies | "Are there any planned or pending dependency changes?" |
+
+**Rules:**
+- Adapt questions to the project's stack, structure, and domain — don't ask generic questions that don't apply
+- Skip questions already answered by the README, AGENTS.md, or other supporting files
+- Maximum 5 questions per session
+- Ask one at a time using the AskUserQuestion tool, wait for each answer
+
+---
+
+## Constitution Generation
+
+With README validated, supporting files scanned, and Q&A answers collected, generate \`synspec/constitution.md\` with these sections:
+
+1. **\`# Constitution: <project-name>\`** — derived from package.json name, with Version field
+2. **\`## Purpose\`** — 2-3 sentences synthesized from README
+3. **\`## Principles\`** — key design principles inferred from codebase and Q&A
+4. **\`## Tech Stack\`** — languages, frameworks, key dependencies from package.json
+5. **\`## Constraints\`** — from Q&A answers: hard constraints, compliance, infra limits
+6. **\`## Off-Limits\`** — from Q&A answers: areas AI must not touch, out-of-scope items
+7. **\`## Conventions\`** — code style, naming, patterns observed from code and AGENTS.md
+8. **\`## Architecture\`** — high-level structure overview from src/ scan
+9. **\`## Decision Log\`** — table with Date, Decision, Rationale (append-only)
+
+**The Constraints and Off-Limits sections MUST be written from Q&A answers, not inferred from docs.**
+
+---
+
+## Re-run (Update)
+
+When re-run and \`synspec/constitution.md\` already exists, still run the README gate — README may have degraded since last sync. Offer a semver bump choice:
+- **MAJOR** — constitution structure changed or reorganized
+- **MINOR** — new section added
+- **PATCH** — content update, typo fixes
+
+Append a Sync Impact Report as an HTML comment at the top:
+\`\`\`
+<!-- Sync Impact: MAJOR — constitution structure reorganized -->
+\`\`\`
+
+---
+
+## Output
+
 After completion, summarize what was created or updated, note the version, and list how many Q&A questions were answered.`,
         license: 'MIT',
         compatibility: 'Requires synarcx CLI.',
@@ -103,63 +146,97 @@ After completion, summarize what was created or updated, note the version, and l
     };
 }
 export function getSynSyncCommandTemplate() {
-    return {
+    return commandFromSkill(getSynSyncSkillTemplate(), {
         name: 'syn:sync',
         description: 'Generate/update project constitution with README validation, guardrail Q&A, and constraint capture',
-        category: 'Workflow',
         tags: ['workflow', 'sync', 'project'],
-        content: `Generate or update the project constitution — a living document in \`synspec/constitution.md\` that captures validated project context.
-
-**Input**: The user can specify a focus area, or just run the command to proceed through the validation flow.
-
----
-
-## README Gate (Required)
-
-Before any generation, the README MUST pass quality validation.
-
-1. **Check that README.md exists and is not empty.**
-   - If missing or blank → stop with message explaining README must exist and describe the project.
-   - Do NOT write any files.
-
-2. **Check that README meaningfully describes the project.**
-   - A passing README must have both: (1) what the project does, (2) what problem it solves.
-   - AI judges quality at runtime.
-   - If too thin → stop with message explaining what's needed.
-
-3. **If README passes**, proceed.
-
----
-
-## Supporting File Scan
-
-Read AGENTS.md, package.json, src/ structure, and other notable config files. Note what's already covered by README to avoid redundant questions.
-
----
-
-## Guardrail Q&A
-
-Generate up to 5 targeted questions about off-limits areas, hard constraints, coding rules, out-of-scope items, and dependency plans. Adapt to the project's stack and domain. Skip questions already answered by README or supporting files.
-
----
-
-## Constitution Generation
-
-Generate \`synspec/constitution.md\` with sections: Purpose, Principles, Tech Stack, Constraints (from Q&A), Off-Limits (from Q&A), Conventions, Architecture, Decision Log.
-
-**Constraints and Off-Limits MUST come from Q&A answers, not inferred.**
-
----
-
-## Re-run (Update)
-
-Still run the README gate even when constitution exists — README may have degraded. Offer semver bump. Append Sync Impact Report HTML comment.
-
----
-
-## Output
-
+        content: `## Step 0: SynArcX Version Check (MUST run first)
+
+Do NOT read any project files yet. Run this version check first.
+
+### 0.1 Read the daily cache
+
+Read \`synspec/.version-cache.json\`. If \`lastCheck\` matches today's UTC date (YYYY-MM-DD), skip to "Main Sync Flow" below. Expected format: \`{ "lastCheck": "2026-05-13", "latestVersion": "0.4.0" }\`.
+
+### 0.2 Fetch latest from npm
+
+Run \`npm view synarcx version\`. On failure, silently skip to 0.5, write cache with \`latestVersion: null\`.
+
+### 0.3 Get installed version
+
+Run \`synarcx --version\`. On failure, silently skip to 0.5.
+
+### 0.4 Compare and prompt
+
+Parse both as semver: split on \`.\`, parse each as integer, compare major→minor→patch. If npm version > installed:
+
+1. Print update banner.
+2. Use AskUserQuestion tool: "Update now?" with \`["Yes", "No"]\`.
+3. **Yes**: Run \`npm install -g synarcx@latest\`. On success: print success + "Run \`synarcx update\` to refresh skill files." On failure: print error + manual command.
+4. **No**: Print manual command.
+
+If versions match, proceed silently.
+
+### 0.5 Write cache
+
+Write \`synspec/.version-cache.json\` with today's UTC date and latest version (or \`null\` on failure). Use \`new Date().toISOString().split('T')[0]\`.
+
+---
+
+## Main Sync Flow
+
+Generate or update the project constitution — a living document in \`synspec/constitution.md\` that captures validated project context.
+
+**Input**: The user can specify a focus area, or just run the command to proceed through the validation flow.
+
+---
+
+## README Gate (Required)
+
+Before any generation, the README MUST pass quality validation.
+
+1. **Check that README.md exists and is not empty.**
+   - If missing or blank → stop with message explaining README must exist and describe the project.
+   - Do NOT write any files.
+
+2. **Check that README meaningfully describes the project.**
+   - A passing README must have both: (1) what the project does, (2) what problem it solves.
+   - AI judges quality at runtime.
+   - If too thin → stop with message explaining what's needed.
+
+3. **If README passes**, proceed.
+
+---
+
+## Supporting File Scan
+
+Read AGENTS.md, package.json, src/ structure, and other notable config files. Note what's already covered by README to avoid redundant questions.
+
+---
+
+## Guardrail Q&A
+
+Generate up to 5 targeted questions about off-limits areas, hard constraints, coding rules, out-of-scope items, and dependency plans. Adapt to the project's stack and domain. Skip questions already answered by README or supporting files.
+
+---
+
+## Constitution Generation
+
+Generate \`synspec/constitution.md\` with sections: Purpose, Principles, Tech Stack, Constraints (from Q&A), Off-Limits (from Q&A), Conventions, Architecture, Decision Log.
+
+**Constraints and Off-Limits MUST come from Q&A answers, not inferred.**
+
+---
+
+## Re-run (Update)
+
+Still run the README gate even when constitution exists — README may have degraded. Offer semver bump. Append Sync Impact Report HTML comment.
+
+---
+
+## Output
+
 Summarize what was created/updated, note the version, and show how many Q&A questions were answered.`
-    };
+    });
 }
 //# sourceMappingURL=sync.js.map

package/dist/core/update.d.ts

@@ -44,27 +44,7 @@ export declare class UpdateCommand {
      */
     private displayOldCoreCustomProfileNote;
     /**
-     * Removes skill directories for workflows when delivery changed to commands-only.
-     * Returns the number of directories removed.
-     */
-    private removeSkillDirs;
-    /**
-     * Removes skill directories for workflows that are no longer selected in the active profile.
-     * Returns the number of directories removed.
-     */
-    private removeUnselectedSkillDirs;
-    /**
-     * Removes command files for workflows when delivery changed to skills-only.
-     * Returns the number of files removed.
-     */
-    private removeCommandFiles;
-    /**
-     * Removes command files for workflows that are no longer selected in the active profile.
-     * Returns the number of files removed.
-     */
-    private removeUnselectedCommandFiles;
-    /**
-     * Detect and handle legacy OpenSpec artifacts.
+     * Detect and handle legacy artifacts.
      * Unlike init, update warns but continues if legacy files found in non-interactive mode.
      * Returns array of tool IDs that were newly configured during legacy upgrade.
      */

package/dist/core/update.js

@@ -7,7 +7,6 @@
 import path from 'path';
 import chalk from 'chalk';
 import ora from 'ora';
-import * as fs from 'fs';
 import { createRequire } from 'module';
 import { FileSystemUtils } from '../utils/file-system.js';
 import { transformToHyphenCommands } from '../utils/command-references.js';
@@ -17,12 +16,14 @@ import { getToolVersionStatus, getSkillTemplates, getCommandContents, generateSk
 import { detectLegacyArtifacts, cleanupLegacyArtifacts, formatCleanupSummary, formatDetectionSummary, getToolsFromLegacyArtifacts, } from './legacy-cleanup.js';
 import { isInteractive } from '../utils/interactive.js';
 import { getGlobalConfig } from './global-config.js';
-import { getProfileWorkflows, ALL_WORKFLOWS } from './profiles.js';
+import { getProfileWorkflows } from './profiles.js';
+import { ALL_WORKFLOWS } from './shared/workflow-registry.js';
+import { removeSkillDirs, removeUnselectedSkillDirs, removeCommandFiles, removeUnselectedCommandFiles, } from './shared/artifact-cleanup.js';
 import { getAvailableTools } from './available-tools.js';
-import { WORKFLOW_TO_SKILL_DIR, getCommandConfiguredTools, getConfiguredToolsForProfileSync, getToolsNeedingProfileSync, } from './profile-sync-drift.js';
+import { getCommandConfiguredTools, getConfiguredToolsForProfileSync, getToolsNeedingProfileSync, } from './profile-sync-drift.js';
 import { scanInstalledWorkflows as scanInstalledWorkflowsShared, migrateIfNeeded as migrateIfNeededShared, } from './migration.js';
 const require = createRequire(import.meta.url);
-const { version: OPENSPEC_VERSION } = require('../../package.json');
+const { version: SYNARCX_VERSION } = require('../../package.json');
 const OLD_CORE_WORKFLOWS = ['propose', 'explore', 'apply', 'archive'];
 /**
  * Scans installed workflow artifacts (skills and managed commands) across all configured tools.
@@ -43,9 +44,9 @@ export class UpdateCommand {
     }
     async execute(projectPath) {
         const resolvedProjectPath = path.resolve(projectPath);
-        const openspecPath = path.join(resolvedProjectPath, SYNSPEC_DIR_NAME);
+        const synspecPath = path.join(resolvedProjectPath, SYNSPEC_DIR_NAME);
         // 1. Check synspec directory exists
-        if (!await FileSystemUtils.directoryExists(openspecPath)) {
+        if (!await FileSystemUtils.directoryExists(synspecPath)) {
             throw new Error(`No synarcx directory found. Run 'synarcx init' first.`);
         }
         // 2. Perform one-time migration if needed before any legacy upgrade generation.
@@ -73,7 +74,7 @@ export class UpdateCommand {
         const commandConfiguredTools = getCommandConfiguredTools(resolvedProjectPath);
         const commandConfiguredSet = new Set(commandConfiguredTools);
         const toolStatuses = configuredTools.map((toolId) => {
-            const status = getToolVersionStatus(resolvedProjectPath, toolId, OPENSPEC_VERSION);
+            const status = getToolVersionStatus(resolvedProjectPath, toolId, SYNARCX_VERSION);
             if (!status.configured && commandConfiguredSet.has(toolId)) {
                 return { ...status, configured: true };
             }
@@ -132,14 +133,14 @@ export class UpdateCommand {
                         const skillFile = path.join(skillDir, 'SKILL.md');
                         // Use hyphen-based command references for tools where filename = command name
                         const transformer = tool.value === 'pi' ? transformToHyphenCommands : undefined;
-                        const skillContent = generateSkillContent(template, OPENSPEC_VERSION, transformer);
+                        const skillContent = generateSkillContent(template, SYNARCX_VERSION, transformer);
                         await FileSystemUtils.writeFile(skillFile, skillContent);
                     }
-                    removedDeselectedSkillCount += await this.removeUnselectedSkillDirs(skillsDir, desiredWorkflows);
+                    removedDeselectedSkillCount += await removeUnselectedSkillDirs(skillsDir, desiredWorkflows);
                 }
                 // Delete skill directories if delivery is commands-only
                 if (!shouldGenerateSkills) {
-                    removedSkillCount += await this.removeSkillDirs(skillsDir);
+                    removedSkillCount += await removeSkillDirs(skillsDir);
                 }
                 // Generate commands if delivery includes commands
                 if (shouldGenerateCommands) {
@@ -150,12 +151,12 @@ export class UpdateCommand {
                             const commandFile = path.isAbsolute(cmd.path) ? cmd.path : path.join(resolvedProjectPath, cmd.path);
                             await FileSystemUtils.writeFile(commandFile, cmd.fileContent);
                         }
-                        removedDeselectedCommandCount += await this.removeUnselectedCommandFiles(resolvedProjectPath, toolId, desiredWorkflows);
+                        removedDeselectedCommandCount += await removeUnselectedCommandFiles(resolvedProjectPath, toolId, desiredWorkflows);
                     }
                 }
                 // Delete command files if delivery is skills-only
                 if (!shouldGenerateCommands) {
-                    removedCommandCount += await this.removeCommandFiles(resolvedProjectPath, toolId);
+                    removedCommandCount += await removeCommandFiles(resolvedProjectPath, toolId);
                 }
                 spinner.succeed(`Updated ${tool.name}`);
                 updatedTools.push(tool.name);
@@ -171,7 +172,7 @@ export class UpdateCommand {
         // 11. Summary
         console.log();
         if (updatedTools.length > 0) {
-            console.log(chalk.green(`✓ Updated: ${updatedTools.join(', ')} (v${OPENSPEC_VERSION})`));
+            console.log(chalk.green(`✓ Updated: ${updatedTools.join(', ')} (v${SYNARCX_VERSION})`));
         }
         if (failedTools.length > 0) {
             console.log(chalk.red(`✗ Failed: ${failedTools.map(f => `${f.name} (${f.error})`).join(', ')}`));
@@ -215,7 +216,7 @@ export class UpdateCommand {
      */
     displayUpToDateMessage(toolStatuses) {
         const toolNames = toolStatuses.map((s) => s.toolId);
-        console.log(chalk.green(`✓ All ${toolStatuses.length} tool(s) up to date (v${OPENSPEC_VERSION})`));
+        console.log(chalk.green(`✓ All ${toolStatuses.length} tool(s) up to date (v${SYNARCX_VERSION})`));
         console.log(chalk.dim(`  Tools: ${toolNames.join(', ')}`));
         console.log();
         console.log(chalk.dim('Use --force to refresh files anyway.'));
@@ -228,7 +229,7 @@ export class UpdateCommand {
             const status = statusByTool.get(toolId);
             if (status?.needsUpdate) {
                 const fromVersion = status.generatedByVersion ?? 'unknown';
-                return `${status.toolId} (${fromVersion} → ${OPENSPEC_VERSION})`;
+                return `${status.toolId} (${fromVersion} → ${SYNARCX_VERSION})`;
             }
             return `${toolId} (config sync)`;
         });
@@ -283,107 +284,7 @@ export class UpdateCommand {
         console.log(chalk.dim('Run `synarcx config profile core` and then `synarcx update` to add sync.'));
     }
     /**
-     * Removes skill directories for workflows when delivery changed to commands-only.
-     * Returns the number of directories removed.
-     */
-    async removeSkillDirs(skillsDir) {
-        let removed = 0;
-        for (const workflow of ALL_WORKFLOWS) {
-            const dirName = WORKFLOW_TO_SKILL_DIR[workflow];
-            if (!dirName)
-                continue;
-            const skillDir = path.join(skillsDir, dirName);
-            try {
-                if (fs.existsSync(skillDir)) {
-                    await fs.promises.rm(skillDir, { recursive: true, force: true });
-                    removed++;
-                }
-            }
-            catch {
-                // Ignore errors
-            }
-        }
-        return removed;
-    }
-    /**
-     * Removes skill directories for workflows that are no longer selected in the active profile.
-     * Returns the number of directories removed.
-     */
-    async removeUnselectedSkillDirs(skillsDir, desiredWorkflows) {
-        const desiredSet = new Set(desiredWorkflows);
-        let removed = 0;
-        for (const workflow of ALL_WORKFLOWS) {
-            if (desiredSet.has(workflow))
-                continue;
-            const dirName = WORKFLOW_TO_SKILL_DIR[workflow];
-            if (!dirName)
-                continue;
-            const skillDir = path.join(skillsDir, dirName);
-            try {
-                if (fs.existsSync(skillDir)) {
-                    await fs.promises.rm(skillDir, { recursive: true, force: true });
-                    removed++;
-                }
-            }
-            catch {
-                // Ignore errors
-            }
-        }
-        return removed;
-    }
-    /**
-     * Removes command files for workflows when delivery changed to skills-only.
-     * Returns the number of files removed.
-     */
-    async removeCommandFiles(projectPath, toolId) {
-        let removed = 0;
-        const adapter = CommandAdapterRegistry.get(toolId);
-        if (!adapter)
-            return 0;
-        for (const workflow of ALL_WORKFLOWS) {
-            const cmdPath = adapter.getFilePath(workflow);
-            const fullPath = path.isAbsolute(cmdPath) ? cmdPath : path.join(projectPath, cmdPath);
-            try {
-                if (fs.existsSync(fullPath)) {
-                    await fs.promises.unlink(fullPath);
-                    removed++;
-                }
-            }
-            catch {
-                // Ignore errors
-            }
-        }
-        return removed;
-    }
-    /**
-     * Removes command files for workflows that are no longer selected in the active profile.
-     * Returns the number of files removed.
-     */
-    async removeUnselectedCommandFiles(projectPath, toolId, desiredWorkflows) {
-        let removed = 0;
-        const adapter = CommandAdapterRegistry.get(toolId);
-        if (!adapter)
-            return 0;
-        const desiredSet = new Set(desiredWorkflows);
-        for (const workflow of ALL_WORKFLOWS) {
-            if (desiredSet.has(workflow))
-                continue;
-            const cmdPath = adapter.getFilePath(workflow);
-            const fullPath = path.isAbsolute(cmdPath) ? cmdPath : path.join(projectPath, cmdPath);
-            try {
-                if (fs.existsSync(fullPath)) {
-                    await fs.promises.unlink(fullPath);
-                    removed++;
-                }
-            }
-            catch {
-                // Ignore errors
-            }
-        }
-        return removed;
-    }
-    /**
-     * Detect and handle legacy OpenSpec artifacts.
+     * Detect and handle legacy artifacts.
      * Unlike init, update warns but continues if legacy files found in non-interactive mode.
      * Returns array of tool IDs that were newly configured during legacy upgrade.
      */
@@ -523,7 +424,7 @@ export class UpdateCommand {
                         const skillFile = path.join(skillDir, 'SKILL.md');
                         // Use hyphen-based command references for tools where filename = command name
                         const transformer = tool.value === 'pi' ? transformToHyphenCommands : undefined;
-                        const skillContent = generateSkillContent(template, OPENSPEC_VERSION, transformer);
+                        const skillContent = generateSkillContent(template, SYNARCX_VERSION, transformer);
                         await FileSystemUtils.writeFile(skillFile, skillContent);
                     }
                 }