synarcx 0.2.0 → 0.2.1

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);
                     }
                 }

package/dist/core/view.js

@@ -6,16 +6,16 @@ import { MarkdownParser } from './parsers/markdown-parser.js';
 import { SYNSPEC_DIR_NAME } from './config.js';
 export class ViewCommand {
     async execute(targetPath = '.') {
-        const openspecDir = path.join(targetPath, SYNSPEC_DIR_NAME);
-        if (!fs.existsSync(openspecDir)) {
+        const synspecDir = path.join(targetPath, SYNSPEC_DIR_NAME);
+        if (!fs.existsSync(synspecDir)) {
             console.error(chalk.red('No synspec directory found'));
             process.exit(1);
         }
         console.log(chalk.bold('\nsynarcx Dashboard\n'));
         console.log('═'.repeat(60));
         // Get changes and specs data
-        const changesData = await this.getChangesData(openspecDir);
-        const specsData = await this.getSpecsData(openspecDir);
+        const changesData = await this.getChangesData(synspecDir);
+        const specsData = await this.getSpecsData(synspecDir);
         // Display summary metrics
         this.displaySummary(changesData, specsData);
         // Display draft changes
@@ -60,8 +60,8 @@ export class ViewCommand {
         console.log('\n' + '═'.repeat(60));
         console.log(chalk.dim(`\nUse ${chalk.white('synarcx list --changes')} or ${chalk.white('synarcx list --specs')} for detailed views`));
     }
-    async getChangesData(openspecDir) {
-        const changesDir = path.join(openspecDir, 'changes');
+    async getChangesData(synspecDir) {
+        const changesDir = path.join(synspecDir, 'changes');
         if (!fs.existsSync(changesDir)) {
             return { draft: [], active: [], completed: [] };
         }
@@ -101,8 +101,8 @@ export class ViewCommand {
         completed.sort((a, b) => a.name.localeCompare(b.name));
         return { draft, active, completed };
     }
-    async getSpecsData(openspecDir) {
-        const specsDir = path.join(openspecDir, 'specs');
+    async getSpecsData(synspecDir) {
+        const specsDir = path.join(synspecDir, 'specs');
         if (!fs.existsSync(specsDir)) {
             return [];
         }

package/dist/core/workspace/open-surface.d.ts

@@ -1,6 +1,6 @@
 import { WorkspaceLocalState, WorkspaceSharedState } from './foundation.js';
-export declare const WORKSPACE_GUIDANCE_START_MARKER = "<!-- OPENSPEC:WORKSPACE-GUIDANCE:START -->";
-export declare const WORKSPACE_GUIDANCE_END_MARKER = "<!-- OPENSPEC:WORKSPACE-GUIDANCE:END -->";
+export declare const WORKSPACE_GUIDANCE_START_MARKER = "<!-- SYNARCX:WORKSPACE-GUIDANCE:START -->";
+export declare const WORKSPACE_GUIDANCE_END_MARKER = "<!-- SYNARCX:WORKSPACE-GUIDANCE:END -->";
 export declare const WORKSPACE_GUIDANCE_BODY = "# synarcx Workspace Guidance\n\nThis directory is a synarcx workspace for planning across linked repos or folders.\n\n- Use `changes/` for workspace-level planning.\n- Linked repos and folders are available for exploration and planning.\n- Repo or folder visibility supports exploration and planning.\n- Make implementation edits after the user explicitly asks for implementation work.\n- Treat linked repos and folders as the implementation homes for their owned code.\n- Use synarcx workspace commands instead of hand-editing `.synarcx-workspace/*.yaml`.";
 export interface WorkspaceOpenLink {
     name: string;

package/dist/core/workspace/open-surface.js

@@ -3,17 +3,17 @@ import * as path from 'node:path';
 import { FileSystemUtils } from '../../utils/file-system.js';
 import { getWorkspaceCodeWorkspacePath, getWorkspacePortableIgnorePatterns, } from './foundation.js';
 const fs = nodeFs.promises;
-export const WORKSPACE_GUIDANCE_START_MARKER = '<!-- OPENSPEC:WORKSPACE-GUIDANCE:START -->';
-export const WORKSPACE_GUIDANCE_END_MARKER = '<!-- OPENSPEC:WORKSPACE-GUIDANCE:END -->';
-export const WORKSPACE_GUIDANCE_BODY = `# synarcx Workspace Guidance
-
-This directory is a synarcx workspace for planning across linked repos or folders.
-
-- Use \`changes/\` for workspace-level planning.
-- Linked repos and folders are available for exploration and planning.
-- Repo or folder visibility supports exploration and planning.
-- Make implementation edits after the user explicitly asks for implementation work.
-- Treat linked repos and folders as the implementation homes for their owned code.
+export const WORKSPACE_GUIDANCE_START_MARKER = '<!-- SYNARCX:WORKSPACE-GUIDANCE:START -->';
+export const WORKSPACE_GUIDANCE_END_MARKER = '<!-- SYNARCX:WORKSPACE-GUIDANCE:END -->';
+export const WORKSPACE_GUIDANCE_BODY = `# synarcx Workspace Guidance
+
+This directory is a synarcx workspace for planning across linked repos or folders.
+
+- Use \`changes/\` for workspace-level planning.
+- Linked repos and folders are available for exploration and planning.
+- Repo or folder visibility supports exploration and planning.
+- Make implementation edits after the user explicitly asks for implementation work.
+- Treat linked repos and folders as the implementation homes for their owned code.
 - Use synarcx workspace commands instead of hand-editing \`.synarcx-workspace/*.yaml\`.`;
 async function fileExists(filePath) {
     try {
@@ -32,8 +32,8 @@ async function directoryExists(dirPath) {
     }
 }
 export function buildWorkspaceGuidanceBlock() {
-    return `${WORKSPACE_GUIDANCE_START_MARKER}
-${WORKSPACE_GUIDANCE_BODY}
+    return `${WORKSPACE_GUIDANCE_START_MARKER}
+${WORKSPACE_GUIDANCE_BODY}
 ${WORKSPACE_GUIDANCE_END_MARKER}`;
 }
 export function applyWorkspaceGuidanceBlock(existingContent) {

package/package.json

@@ -1,76 +1,84 @@
-{
-  "name": "synarcx",
-  "version": "0.2.0",
-  "description": "SynArcX — Synapse Architecture Code Extension. Spec-driven development workflow for AI coding agents.",
-  "keywords": [
-    "synarcx",
-    "specs",
-    "cli",
-    "ai",
-    "development"
-  ],
-  "homepage": "https://github.com/funara/synarcx",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/funara/synarcx.git"
-  },
-  "license": "MIT",
-  "author": "Adhi Rahmadian",
-  "type": "module",
-  "publishConfig": {
-    "access": "public"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    }
-  },
-  "bin": {
-    "synarcx": "bin/synarcx.js"
-  },
-  "files": [
-    "dist",
-    "bin",
-    "schemas",
-    "scripts/postinstall.js",
-    "!dist/**/*.test.js",
-    "!dist/**/__tests__",
-    "!dist/**/*.map"
-  ],
-  "scripts": {
-    "lint": "eslint src/",
-    "build": "node build.js",
-    "dev": "tsc --watch",
-    "dev:cli": "pnpm build && node bin/synarcx.js",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:ui": "vitest --ui",
-    "test:coverage": "vitest --coverage",
-    "test:postinstall": "node scripts/postinstall.js",
-    "prepare": "pnpm run build",
-    "postinstall": "node scripts/postinstall.js"
-  },
-  "engines": {
-    "node": ">=20.19.0"
-  },
-  "devDependencies": {
-    "@types/node": "^24.2.0",
-    "@vitest/ui": "^3.2.4",
-    "eslint": "^9.39.2",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.50.1",
-    "vitest": "^3.2.4"
-  },
-  "dependencies": {
-    "@inquirer/core": "^10.2.2",
-    "@inquirer/prompts": "^7.8.0",
-    "chalk": "^5.5.0",
-    "commander": "^14.0.0",
-    "cross-spawn": "7.0.6",
-    "fast-glob": "^3.3.3",
-    "ora": "^8.2.0",
-    "yaml": "^2.8.2",
-    "zod": "^4.0.17"
-  }
-}
+{
+  "name": "synarcx",
+  "version": "0.2.1",
+  "description": "Structured engineering workflows for AI coding assistants — persistent project memory, spec-driven development, and architecture drift prevention across every session.",
+  "keywords": [
+    "ai-workflow",
+    "claude-code",
+    "cursor",
+    "spec-driven-development",
+    "ai-coding-assistant",
+    "architecture-drift",
+    "persistent-context",
+    "engineering-workflow",
+    "ai-coding-workflow",
+    "specification",
+    "claude-code-workflow",
+    "ai-context-management"
+  ],
+  "homepage": "https://github.com/funara/synarcx",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/funara/synarcx.git"
+  },
+  "license": "MIT",
+  "author": "Adhi Rahmadian",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "synarcx": "bin/synarcx.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "schemas",
+    "scripts/postinstall.js",
+    "!dist/**/*.test.js",
+    "!dist/**/__tests__",
+    "!dist/**/*.map"
+  ],
+  "scripts": {
+    "lint": "eslint src/",
+    "build": "node build.js",
+    "dev": "tsc --watch",
+    "dev:cli": "pnpm build && node bin/synarcx.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest --coverage",
+    "test:postinstall": "node scripts/postinstall.js",
+    "prepare": "pnpm run build",
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.2.0",
+    "@vitest/ui": "^3.2.4",
+    "eslint": "^9.39.2",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.50.1",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "@inquirer/core": "^10.2.2",
+    "@inquirer/prompts": "^7.8.0",
+    "chalk": "^5.5.0",
+    "commander": "^14.0.0",
+    "cross-spawn": "7.0.6",
+    "fast-glob": "^3.3.3",
+    "ora": "^8.2.0",
+    "synarcx": "link:",
+    "yaml": "^2.8.2",
+    "zod": "^4.0.17"
+  }
+}