@axiomatic-labs/claudeflow 2.14.4 → 2.14.6

package/lib/install.js

@@ -167,6 +167,17 @@ async function run() {
     if (fs.existsSync(srcTemplates)) {
       copyDirSync(srcTemplates, dstTemplates);
     }
+
+    // Copy v2 orchestrator playbook layer (foundation/methodologies/domain/
+    // ui-ux/routing). Required for claudeflow-build / -test / -review skills
+    // to @-mention. Without this, those skills' @.claudeflow/playbooks/...
+    // refs point to non-existent files.
+    const srcPlaybooks = path.join(srcClaudeflow, 'playbooks');
+    const dstPlaybooks = path.join(cwd, '.claudeflow', 'playbooks');
+    if (fs.existsSync(srcPlaybooks)) {
+      copyDirSync(srcPlaybooks, dstPlaybooks);
+    }
+
     materializeSharedAppendPrompt(cwd);
     ensureDefaultClaudeMdRules(cwd);
     propagateTemplateRules(cwd, srcTemplates);
@@ -200,6 +211,11 @@ async function run() {
     // Remove previously template-seeded base rules. Project memory now comes
     // from setup-context, generated project rules, and root CLAUDE.md.
     pruneLegacyTemplateRules(cwd);
+    // v2 cleanup: remove v1 build-orchestrator artifacts (phases/, references/,
+    // and v1-only enforcement hooks). These were template-managed in earlier
+    // versions but aren't in the v2 manifest, so install.js's stale-removal
+    // doesn't always identify them. Be explicit.
+    pruneLegacyV1BuildArtifacts(cwd);
 
     // Copy commands
     const srcCommands = path.join(srcClaude, 'commands');
@@ -1167,6 +1183,42 @@ function assertRequiredTemplateRules(rulesDir) {
   }
 }
 
+// v1 build-orchestrator artifacts that v2 replaces. When upgrading from a
+// pre-v2 install, these stay on disk because install.js's stale cleanup
+// can't match files that exist on disk but aren't in the v2 ZIP manifest.
+// Listing them explicitly here makes the v1 → v2 upgrade leave a clean
+// .claude/.
+const LEGACY_V1_BUILD_ARTIFACTS = [
+  // v1 had phases/references inside build/test/review skills; v2 doesn't.
+  '.claude/skills/claudeflow-build/phases',
+  '.claude/skills/claudeflow-build/references',
+  '.claude/skills/claudeflow-test/phases',
+  '.claude/skills/claudeflow-test/references',
+  '.claude/skills/claudeflow-review/phases',
+  '.claude/skills/claudeflow-review/references',
+  // v1 enforcement hooks; v2 uses guard-sensitive-files + validate-closure +
+  // session-env + filter-command-output instead.
+  '.claude/hooks/PreToolUse/enforce-task-creation.js',
+  '.claude/hooks/PreToolUse/enforce-ecosystem-artifacts.js',
+  '.claude/hooks/PreToolUse/freeze-step-contract.js',
+  '.claude/hooks/PreToolUse/freeze-workflow-state.js',
+  '.claude/hooks/PreToolUse/route-exit-plan-mode.js',
+  '.claude/hooks/PreToolUse/stack-debt-guard.js',
+];
+
+function pruneLegacyV1BuildArtifacts(projectRoot) {
+  for (const relPath of LEGACY_V1_BUILD_ARTIFACTS) {
+    const absPath = path.join(projectRoot, relPath);
+    if (!fs.existsSync(absPath)) continue;
+    try {
+      fs.rmSync(absPath, { recursive: true, force: true });
+    } catch {
+      // Best-effort. If the file is locked or permissions issue, skip;
+      // the user can clean up manually. Don't abort the install.
+    }
+  }
+}
+
 function pruneLegacyTemplateRules(projectRoot) {
   const rulesDir = path.join(projectRoot, '.claude', 'rules');
   for (const filename of LEGACY_TEMPLATE_RULES) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axiomatic-labs/claudeflow",
-  "version": "2.14.4",
+  "version": "2.14.6",
   "description": "Claudeflow — AI-powered development toolkit for Claude Code. Skills, agents, hooks, and quality gates that ship production apps.",
   "bin": {
     "claudeflow": "./bin/cli.js"