synarcx 0.3.3 → 0.3.5

package/README.md

@@ -147,7 +147,7 @@ Each step suggests the next — you decide when to advance. Works in Claude Code
 - `sync` generates the `constitution.md` — run once, re-run when the project shifts. Also runs a daily version check (prompts to auto-update) and checks for pending spec syncs from recently archived changes.
 - `explore`, `debug`, and `refactor` are entry points that hand off to `propose`
 - `quick` skips the pipeline for small, low-risk changes
-- Run `synarcx update` in your terminal to refresh all skill and command files after installing a new version
+- Run `synarcx update` in your terminal to refresh all command files after installing a new version
 - `review` is a three-way fork:
   - **Archive now**: auto-syncs delta specs to main spec via `buildUpdatedSpec()`, writes `.pending-sync.json` marker, moves to archive. If spec sync fails, the change is already safely in archive; retry on next sync run.
   - **Add more work**: scope gate reads proposal capabilities + design goals/non-goals. In-scope → update artifacts, MUST `/syn:clarify` then `/syn:apply` then `/syn:review` again (loop). Out-of-scope → offer archive then route to `/syn:propose`.
@@ -213,7 +213,7 @@ Used in your terminal:
 | Command             | Description                                                  |
 | ------------------- | ------------------------------------------------------------ |
 | `synarcx init`    | Set up SynArcX workflow structure in your repository         |
-| `synarcx update`  | Refresh skill and command files for all configured tools     |
+| `synarcx update`  | Refresh command files for all configured tools               |
 | `synarcx sync`    | Regenerate `constitution.md`                               |
 | `synarcx explore` | Open explore session                                         |
 | `synarcx propose` | Create a structured change proposal                          |

package/dist/core/config.js

@@ -4,32 +4,32 @@ export const SYNSPEC_MARKERS = {
     end: '<!-- SYNSPEC:END -->'
 };
 export const AI_TOOLS = [
-    { name: 'Amazon Q Developer', value: 'amazon-q', available: true, successLabel: 'Amazon Q Developer', skillsDir: '.amazonq' },
-    { name: 'Antigravity', value: 'antigravity', available: true, successLabel: 'Antigravity', skillsDir: '.agent' },
-    { name: 'Auggie (Augment CLI)', value: 'auggie', available: true, successLabel: 'Auggie', skillsDir: '.augment' },
-    { name: 'Bob Shell', value: 'bob', available: true, successLabel: 'Bob Shell', skillsDir: '.bob' },
+    { name: 'Amazon Q Developer', value: 'amazon-q', available: true, successLabel: 'Amazon Q Developer', skillsDir: '.amazonq', hasCommands: true },
+    { name: 'Antigravity', value: 'antigravity', available: true, successLabel: 'Antigravity', skillsDir: '.agent', hasCommands: true },
+    { name: 'Auggie (Augment CLI)', value: 'auggie', available: true, successLabel: 'Auggie', skillsDir: '.augment', hasCommands: true },
+    { name: 'Bob Shell', value: 'bob', available: true, successLabel: 'Bob Shell', skillsDir: '.bob', hasCommands: true },
     { name: 'Claude Code', value: 'claude', available: true, successLabel: 'Claude Code', skillsDir: '.claude', hasCommands: true },
-    { name: 'Cline', value: 'cline', available: true, successLabel: 'Cline', skillsDir: '.cline' },
-    { name: 'Codex', value: 'codex', available: true, successLabel: 'Codex', skillsDir: '.codex' },
-    { name: 'CodeBuddy Code (CLI)', value: 'codebuddy', available: true, successLabel: 'CodeBuddy Code', skillsDir: '.codebuddy' },
-    { name: 'Continue', value: 'continue', available: true, successLabel: 'Continue (VS Code / JetBrains / Cli)', skillsDir: '.continue' },
-    { name: 'CoStrict', value: 'costrict', available: true, successLabel: 'CoStrict', skillsDir: '.cospec' },
-    { name: 'Crush', value: 'crush', available: true, successLabel: 'Crush', skillsDir: '.crush' },
-    { name: 'Cursor', value: 'cursor', available: true, successLabel: 'Cursor', skillsDir: '.cursor' },
-    { name: 'Factory Droid', value: 'factory', available: true, successLabel: 'Factory Droid', skillsDir: '.factory' },
-    { name: 'Gemini CLI', value: 'gemini', available: true, successLabel: 'Gemini CLI', skillsDir: '.gemini' },
-    { name: 'GitHub Copilot', value: 'github-copilot', available: true, successLabel: 'GitHub Copilot', skillsDir: '.github', detectionPaths: ['.github/copilot-instructions.md', '.github/instructions', '.github/workflows/copilot-setup-steps.yml', '.github/prompts', '.github/agents', '.github/skills', '.github/.mcp.json'] },
-    { name: 'iFlow', value: 'iflow', available: true, successLabel: 'iFlow', skillsDir: '.iflow' },
-    { name: 'Junie', value: 'junie', available: true, successLabel: 'Junie', skillsDir: '.junie' },
-    { name: 'Kilo Code', value: 'kilocode', available: true, successLabel: 'Kilo Code', skillsDir: '.kilocode' },
-    { name: 'Kiro', value: 'kiro', available: true, successLabel: 'Kiro', skillsDir: '.kiro' },
+    { name: 'Cline', value: 'cline', available: true, successLabel: 'Cline', skillsDir: '.cline', hasCommands: true },
+    { name: 'Codex', value: 'codex', available: true, successLabel: 'Codex', skillsDir: '.codex', hasCommands: true },
+    { name: 'CodeBuddy Code (CLI)', value: 'codebuddy', available: true, successLabel: 'CodeBuddy Code', skillsDir: '.codebuddy', hasCommands: true },
+    { name: 'Continue', value: 'continue', available: true, successLabel: 'Continue (VS Code / JetBrains / Cli)', skillsDir: '.continue', hasCommands: true },
+    { name: 'CoStrict', value: 'costrict', available: true, successLabel: 'CoStrict', skillsDir: '.cospec', hasCommands: true },
+    { name: 'Crush', value: 'crush', available: true, successLabel: 'Crush', skillsDir: '.crush', hasCommands: true },
+    { name: 'Cursor', value: 'cursor', available: true, successLabel: 'Cursor', skillsDir: '.cursor', hasCommands: true },
+    { name: 'Factory Droid', value: 'factory', available: true, successLabel: 'Factory Droid', skillsDir: '.factory', hasCommands: true },
+    { name: 'Gemini CLI', value: 'gemini', available: true, successLabel: 'Gemini CLI', skillsDir: '.gemini', hasCommands: true },
+    { name: 'GitHub Copilot', value: 'github-copilot', available: true, successLabel: 'GitHub Copilot', skillsDir: '.github', detectionPaths: ['.github/copilot-instructions.md', '.github/instructions', '.github/workflows/copilot-setup-steps.yml', '.github/prompts', '.github/agents', '.github/skills', '.github/.mcp.json'], hasCommands: true },
+    { name: 'iFlow', value: 'iflow', available: true, successLabel: 'iFlow', skillsDir: '.iflow', hasCommands: true },
+    { name: 'Junie', value: 'junie', available: true, successLabel: 'Junie', skillsDir: '.junie', hasCommands: true },
+    { name: 'Kilo Code', value: 'kilocode', available: true, successLabel: 'Kilo Code', skillsDir: '.kilocode', hasCommands: true },
+    { name: 'Kiro', value: 'kiro', available: true, successLabel: 'Kiro', skillsDir: '.kiro', hasCommands: true },
     { name: 'OpenCode', value: 'opencode', available: true, successLabel: 'OpenCode', skillsDir: '.opencode', hasCommands: true },
-    { name: 'Pi', value: 'pi', available: true, successLabel: 'Pi', skillsDir: '.pi' },
-    { name: 'Qoder', value: 'qoder', available: true, successLabel: 'Qoder', skillsDir: '.qoder' },
-    { name: 'Lingma', value: 'lingma', available: true, successLabel: 'Lingma', skillsDir: '.lingma' },
-    { name: 'Qwen Code', value: 'qwen', available: true, successLabel: 'Qwen Code', skillsDir: '.qwen' },
-    { name: 'RooCode', value: 'roocode', available: true, successLabel: 'RooCode', skillsDir: '.roo' },
-    { name: 'Windsurf', value: 'windsurf', available: true, successLabel: 'Windsurf', skillsDir: '.windsurf' },
+    { name: 'Pi', value: 'pi', available: true, successLabel: 'Pi', skillsDir: '.pi', hasCommands: true },
+    { name: 'Qoder', value: 'qoder', available: true, successLabel: 'Qoder', skillsDir: '.qoder', hasCommands: true },
+    { name: 'Lingma', value: 'lingma', available: true, successLabel: 'Lingma', skillsDir: '.lingma', hasCommands: true },
+    { name: 'Qwen Code', value: 'qwen', available: true, successLabel: 'Qwen Code', skillsDir: '.qwen', hasCommands: true },
+    { name: 'RooCode', value: 'roocode', available: true, successLabel: 'RooCode', skillsDir: '.roo', hasCommands: true },
+    { name: 'Windsurf', value: 'windsurf', available: true, successLabel: 'Windsurf', skillsDir: '.windsurf', hasCommands: true },
     { name: 'AGENTS.md (works with Amp, VS Code, …)', value: 'agents', available: false, successLabel: 'your AGENTS.md-compatible assistant' }
 ];
 //# sourceMappingURL=config.js.map

package/dist/core/init.js

@@ -384,8 +384,8 @@ export class InitCommand {
                     const skillsDir = path.join(projectPath, tool.skillsDir, 'skills');
                     removedSkillCount += await removeSkillDirs(skillsDir);
                 }
-                // Generate commands if delivery includes commands
-                if (shouldGenerateCommands) {
+                // Generate commands if delivery includes commands and tool supports them
+                if (shouldGenerateCommands && hasCommands) {
                     const adapter = CommandAdapterRegistry.get(tool.value);
                     if (adapter) {
                         const generatedCommands = generateCommands(commandContents, adapter);

package/dist/core/shared/artifact-cleanup.js

@@ -19,6 +19,18 @@ export async function removeSkillDirs(skillsDir) {
             // Ignore errors
         }
     }
+    // Remove empty parent skills directory
+    try {
+        if (fs.existsSync(skillsDir)) {
+            const remaining = await fs.promises.readdir(skillsDir);
+            if (remaining.length === 0) {
+                await fs.promises.rmdir(skillsDir);
+            }
+        }
+    }
+    catch {
+        // Ignore errors
+    }
     return removed;
 }
 export async function removeUnselectedSkillDirs(skillsDir, desiredWorkflows) {

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

@@ -98,7 +98,7 @@ export function getSynReviewSkillTemplate() {
    4. **OUT OF SCOPE** (new capability, different concern, violates non-goal):
       - Inform user: "This is outside the current change's scope."
       - Offer: "Archive current change first?" — YES archives with spec sync, NO leaves active
-      - Route: "Start a new change with \`/syn:propose\`"
+      - Route: "Start a new change with \`/syn:propose\`"
 
    **If any checks failed** (dirty):
 
@@ -140,7 +140,7 @@ export function getSynReviewSkillTemplate() {
 
     e. **Confirm**:
        - "Archived <change-name> to synspec/changes/archive/YYYY-MM-DD-<name>/"
-       - If specs were synced: "Specs synced: <capability>: +N ~M"
+       - If specs were synced: "Specs synced: <capability>: +N ~M"
 
 ---
 
@@ -301,7 +301,7 @@ export function getSynReviewCommandTemplate() {
     c. Move: \`mv synspec/changes/<name> synspec/changes/archive/YYYY-MM-DD-<name>\`
     d. Sync specs: \`findSpecUpdates(archivePath)\` → \`buildUpdatedSpec()\` → atomic write (\`.tmp\` + rename) → per-capability output
     e. Update marker with \`syncedAt\` timestamp
-    f. On failure: archive is already moved, marker stays \`null\`, backstop retries on next sync
+    f. On failure: archive is already moved, marker stays \`null\`, backstop retries on next sync
 
 ---
 

package/dist/core/update.js

@@ -144,12 +144,12 @@ export class UpdateCommand {
                     }
                     removedDeselectedSkillCount += await removeUnselectedSkillDirs(skillsDir, desiredWorkflows);
                 }
-                // Delete skill directories if delivery is commands-only
-                if (!shouldGenerateSkills) {
+                // Delete skill directories if delivery is commands-only or tool uses commands
+                if (!shouldGenerateSkills || tool.hasCommands) {
                     removedSkillCount += await removeSkillDirs(skillsDir);
                 }
-                // Generate commands if delivery includes commands
-                if (shouldGenerateCommands) {
+                // Generate commands if delivery includes commands and tool supports them
+                if (shouldGenerateCommands && tool.hasCommands) {
                     const adapter = CommandAdapterRegistry.get(tool.value);
                     if (adapter) {
                         const generatedCommands = generateCommands(commandContents, adapter);

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "synarcx",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "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",
+    "opencode",
+    "codex",
+    "gemini",
     "spec-driven-development",
     "ai-coding-assistant",
     "architecture-drift",
@@ -34,7 +37,7 @@
     }
   },
   "bin": {
-    "synarcx": "bin/synarcx.js"
+    "synarcx": "./dist/index.js"
   },
   "files": [
     "dist",