synarcx 0.3.1 → 0.3.3

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

@@ -3,11 +3,47 @@ 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: `## Step 0: SynArcX Version Check (MUST run first)
+        instructions: `## Step 0: Pending Spec Sync Check (runs before version check)
 
-Do NOT read any project files yet. Run this version check first.
+Check for pending spec syncs from recently archived changes. This runs before the version check because it's a local filesystem operation and should not be blocked by network issues.
 
-### 0.1 Read the daily cache
+### 0.1 Read \`synspec/.pending-sync.json\`
+
+If the file doesn't exist, skip this step entirely (no pending syncs).
+
+Expected format:
+\`\`\`json
+{ "pending": [{ "change": "YYYY-MM-DD-<name>", "archivedAt": "<ISO>", "syncedAt": null }] }
+\`\`\`
+
+### 0.2 Process pending entries (FIFO order)
+
+For each entry where \`syncedAt\` is \`null\`:
+- Construct path: \`synspec/changes/archive/<change>/\`
+- Call \`findSpecUpdates(archivePath, synspec/specs/)\` to discover delta specs in the archived change
+- For each delta spec, call \`buildUpdatedSpec()\` to merge into main specs
+- Write rebuilt specs atomically (\`.tmp\` + rename to \`spec.md\`)
+- Show per-change output: "Synced specs from <change>: <capability>: +N ~M"
+- After each change processed, update its \`syncedAt\` field
+- If \`buildUpdatedSpec()\` throws: show error, leave \`syncedAt\` as \`null\` (retry next time)
+
+### 0.3 Clean up marker
+
+After all pending entries are processed:
+- If all entries have \`syncedAt\` set: delete \`synspec/.pending-sync.json\` entirely (clean slate)
+- If some entries failed (\`syncedAt\` still \`null\`): keep the marker, show which changes still need attention, and why
+
+### 0.4 Proceed to version check
+
+Once pending syncs are handled, proceed to Step 1.
+
+---
+
+## Step 1: SynArcX Version Check
+
+Do NOT read any project files yet. Run this version check after pending spec syncs are handled.
+
+### 1.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.
 
@@ -18,15 +54,15 @@ Expected cache format:
 
 If missing or malformed, treat as cache miss and continue.
 
-### 0.2 Fetch latest from npm
+### 1.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\`.
+Run \`npm view synarcx version\`. On failure (no npm, no network, non-zero exit): silently skip to 1.5, write cache with \`latestVersion: null\`.
 
-### 0.3 Get installed version
+### 1.3 Get installed version
 
-Run \`synarcx --version\`. On failure: silently skip to 0.5.
+Run \`synarcx --version\`. On failure: silently skip to 1.5.
 
-### 0.4 Compare and prompt
+### 1.4 Compare and prompt
 
 Parse both as semver: split on \`.\`, parse each as integer, compare major→minor→patch. If npm version > installed:
 
@@ -37,7 +73,7 @@ Parse both as semver: split on \`.\`, parse each as integer, compare major→min
 
 If versions match, proceed silently.
 
-### 0.5 Write cache
+### 1.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]\`.
 
@@ -150,23 +186,31 @@ export function getSynSyncCommandTemplate() {
         name: 'syn:sync',
         description: 'Generate/update project constitution with README validation, guardrail Q&A, and constraint capture',
         tags: ['workflow', 'sync', 'project'],
-        content: `## Step 0: SynArcX Version Check (MUST run first)
+        content: `## Step 0: Pending Spec Sync Check (runs before version check)
+
+Check \`synspec/.pending-sync.json\`. If file missing, skip (no pending syncs). Expected format: \`{ "pending": [{ "change": "YYYY-MM-DD-<name>", "archivedAt": "<ISO>", "syncedAt": null }] }\`.
+
+For each entry with \`syncedAt: null\`: construct path \`synspec/changes/archive/<change>/\`, call \`findSpecUpdates()\` + \`buildUpdatedSpec()\`, write atomically (\`.tmp\` + rename), update \`syncedAt\`. On error: leave \`syncedAt: null\` for retry.
+
+After all processed: if all entries have \`syncedAt\`, delete marker file. If some still \`null\`, keep marker with error info. Then proceed.
+
+---
 
-Do NOT read any project files yet. Run this version check first.
+## Step 1: SynArcX Version Check
 
-### 0.1 Read the daily cache
+### 1.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
+### 1.2 Fetch latest from npm
 
-Run \`npm view synarcx version\`. On failure, silently skip to 0.5, write cache with \`latestVersion: null\`.
+Run \`npm view synarcx version\`. On failure, silently skip to 1.5, write cache with \`latestVersion: null\`.
 
-### 0.3 Get installed version
+### 1.3 Get installed version
 
-Run \`synarcx --version\`. On failure, silently skip to 0.5.
+Run \`synarcx --version\`. On failure, silently skip to 1.5.
 
-### 0.4 Compare and prompt
+### 1.4 Compare and prompt
 
 Parse both as semver: split on \`.\`, parse each as integer, compare major→minor→patch. If npm version > installed:
 
@@ -177,7 +221,7 @@ Parse both as semver: split on \`.\`, parse each as integer, compare major→min
 
 If versions match, proceed silently.
 
-### 0.5 Write cache
+### 1.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]\`.
 

package/dist/core/update.d.ts

@@ -38,6 +38,12 @@ export declare class UpdateCommand {
      * Displays a note about extra workflows installed that aren't in the current profile.
      */
     private displayExtraWorkflowsNote;
+    /**
+     * Runs on every `synarcx update` so any newly introduced workflow (e.g. syn:review)
+     * is automatically added to the saved custom workflow list rather than silently dropped.
+     * Also prints a dim notice listing what was added.
+     */
+    private runSyncNewCoreWorkflowsToCustomProfile;
     /**
      * Suggest opting back into core when a custom profile still matches the old
      * pre-sync core set. Keep custom profiles user-owned; do not mutate them.

package/dist/core/update.js

@@ -16,7 +16,7 @@ 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 } from './profiles.js';
+import { getProfileWorkflows, syncNewCoreWorkflowsToCustomProfile } 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';
@@ -57,7 +57,13 @@ export class UpdateCommand {
         const globalConfig = getGlobalConfig();
         const profile = globalConfig.profile ?? 'core';
         const delivery = globalConfig.delivery ?? 'both';
-        const profileWorkflows = getProfileWorkflows(profile, globalConfig.workflows);
+        // 3b. For custom profiles, auto-merge any new ALL_WORKFLOWS entries that aren't
+        // listed yet (e.g. 'syn:review' added in a new release). This prevents future
+        // versions from silently dropping new commands for existing custom-profile users.
+        this.runSyncNewCoreWorkflowsToCustomProfile(globalConfig);
+        // Re-read after potential mutation so desiredWorkflows is always current.
+        const effectiveConfig = getGlobalConfig();
+        const profileWorkflows = getProfileWorkflows(profile, effectiveConfig.workflows);
         const desiredWorkflows = profileWorkflows.filter((workflow) => ALL_WORKFLOWS.includes(workflow));
         const shouldGenerateSkills = delivery !== 'commands';
         const shouldGenerateCommands = delivery !== 'skills';
@@ -266,6 +272,23 @@ export class UpdateCommand {
             console.log(chalk.dim(`Note: ${extraWorkflows.length} extra workflows not in profile (use \`synarcx config profile\` to manage)`));
         }
     }
+    /**
+     * Runs on every `synarcx update` so any newly introduced workflow (e.g. syn:review)
+     * is automatically added to the saved custom workflow list rather than silently dropped.
+     * Also prints a dim notice listing what was added.
+     */
+    runSyncNewCoreWorkflowsToCustomProfile(config) {
+        const before = config.workflows ? [...config.workflows] : null;
+        syncNewCoreWorkflowsToCustomProfile(config);
+        const after = config.workflows ?? [];
+        const beforeSet = new Set(before ?? []);
+        const added = after.filter(w => !beforeSet.has(w));
+        if (added.length > 0) {
+            const listed = added.map(w => `/syn:${w}`).join(', ');
+            console.log(chalk.dim(`Auto-added new workflow(s) to your profile: ${listed}`));
+            console.log();
+        }
+    }
     /**
      * Suggest opting back into core when a custom profile still matches the old
      * pre-sync core set. Keep custom profiles user-owned; do not mutate them.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synarcx",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Structured engineering workflows for AI coding assistants — persistent project memory, spec-driven development, and architecture drift prevention across every session.",
   "keywords": [
     "ai-workflow",