specweave 0.17.6 → 0.17.8

package/plugins/specweave/lib/hooks/sync-living-docs.js

@@ -18,20 +18,76 @@ async function syncLivingDocs(incrementId) {
       return;
     }
     console.log("\u2705 Living docs sync enabled");
-    const specCopied = await copyIncrementSpecToLivingDocs(incrementId);
-    const changedDocs = detectChangedDocs();
+    const intelligentEnabled = config.livingDocs?.intelligent?.enabled ?? false;
+    let specCopied = false;
+    let changedDocs = [];
+    if (intelligentEnabled) {
+      console.log("\u{1F9E0} Using intelligent sync mode (v0.18.0+)");
+      const result = await intelligentSyncLivingDocs(incrementId, config);
+      specCopied = result.success;
+      changedDocs = result.changedFiles;
+    } else {
+      console.log("\u{1F4CB} Using simple sync mode (legacy)");
+      specCopied = await copyIncrementSpecToLivingDocs(incrementId);
+      changedDocs = detectChangedDocs();
+    }
     if (changedDocs.length === 0 && !specCopied) {
-      console.log("\u2139\uFE0F  No living docs changed (no git diff in .specweave/docs/)");
+      console.log("\u2139\uFE0F  No living docs changed");
       return;
     }
-    console.log(`\u{1F4C4} Detected ${changedDocs.length} changed doc(s):`);
-    changedDocs.forEach((doc) => console.log(`   - ${doc}`));
+    console.log(`\u{1F4C4} Changed/created ${changedDocs.length} file(s)`);
     await syncToGitHub(incrementId, changedDocs);
     console.log("\u2705 Living docs sync complete\n");
   } catch (error) {
     console.error("\u274C Error syncing living docs:", error);
   }
 }
+async function intelligentSyncLivingDocs(incrementId, config) {
+  try {
+    const { syncIncrement } = await import("../../../../src/core/living-docs/index.js");
+    console.log("   \u{1F4D6} Parsing and classifying spec sections...");
+    const result = await syncIncrement(incrementId, {
+      verbose: false,
+      // We'll log our own summary
+      dryRun: false,
+      parser: {
+        preserveCodeBlocks: true,
+        preserveLinks: true,
+        preserveImages: true
+      },
+      distributor: {
+        generateFrontmatter: true,
+        preserveOriginal: config.livingDocs?.intelligent?.preserveOriginal ?? true
+      },
+      linker: {
+        generateBacklinks: config.livingDocs?.intelligent?.generateCrossLinks ?? true,
+        updateExisting: true
+      }
+    });
+    console.log(`   \u2705 Intelligent sync complete:`);
+    console.log(`      Project: ${result.project.name} (${(result.project.confidence * 100).toFixed(0)}% confidence)`);
+    console.log(`      Files created: ${result.distribution.summary.filesCreated}`);
+    console.log(`      Files updated: ${result.distribution.summary.filesUpdated}`);
+    console.log(`      Cross-links: ${result.links.length}`);
+    console.log(`      Duration: ${result.duration}ms`);
+    const changedFiles = [
+      ...result.distribution.created.map((f) => f.path),
+      ...result.distribution.updated.map((f) => f.path)
+    ];
+    return {
+      success: result.success,
+      changedFiles
+    };
+  } catch (error) {
+    console.error(`   \u274C Intelligent sync failed: ${error}`);
+    console.error("   Falling back to simple sync mode...");
+    const copied = await copyIncrementSpecToLivingDocs(incrementId);
+    return {
+      success: copied,
+      changedFiles: copied ? [path.join(process.cwd(), ".specweave", "docs", "internal", "specs", `spec-${incrementId}.md`)] : []
+    };
+  }
+}
 async function copyIncrementSpecToLivingDocs(incrementId) {
   try {
     const incrementSpecPath = path.join(process.cwd(), ".specweave", "increments", incrementId, "spec.md");

package/plugins/specweave/lib/hooks/sync-living-docs.ts

@@ -5,6 +5,10 @@
  *
  * Automatically syncs living documentation after task completion.
  *
+ * Supports two modes:
+ * 1. Simple mode: Copy spec.md to living docs (legacy)
+ * 2. Intelligent mode: Parse, classify, and distribute content (v0.18.0+)
+ *
  * Usage:
  *   node dist/hooks/lib/sync-living-docs.js <incrementId>
  *
@@ -13,12 +17,13 @@
  *
  * What it does:
  * 1. Checks if sync_living_docs enabled in config
- * 2. Detects changed docs via git diff
- * 3. Invokes /sync-docs update command (future implementation)
- * 4. Logs sync actions
+ * 2. Detects sync mode (simple or intelligent)
+ * 3. Runs appropriate sync strategy
+ * 4. Syncs to external tools (GitHub/Jira/ADO)
+ * 5. Logs sync actions
  *
  * @author SpecWeave Team
- * @version 1.0.0
+ * @version 2.0.0
  */
 
 import fs from 'fs-extra';
@@ -31,6 +36,16 @@ interface Config {
       sync_living_docs?: boolean;
     };
   };
+  livingDocs?: {
+    intelligent?: {
+      enabled?: boolean;
+      splitByCategory?: boolean;
+      generateCrossLinks?: boolean;
+      preserveOriginal?: boolean;
+      classificationConfidenceThreshold?: number;
+      fallbackProject?: string;
+    };
+  };
 }
 
 /**
@@ -59,19 +74,31 @@ async function syncLivingDocs(incrementId: string): Promise<void> {
 
     console.log('✅ Living docs sync enabled');
 
-    // 3. Copy increment spec to living docs
-    const specCopied = await copyIncrementSpecToLivingDocs(incrementId);
-
-    // 4. Detect changed docs via git diff
-    const changedDocs = detectChangedDocs();
+    // 3. Determine sync mode (simple or intelligent)
+    const intelligentEnabled = config.livingDocs?.intelligent?.enabled ?? false;
+
+    let specCopied = false;
+    let changedDocs: string[] = [];
+
+    if (intelligentEnabled) {
+      // Intelligent mode: Parse, classify, and distribute
+      console.log('🧠 Using intelligent sync mode (v0.18.0+)');
+      const result = await intelligentSyncLivingDocs(incrementId, config);
+      specCopied = result.success;
+      changedDocs = result.changedFiles;
+    } else {
+      // Simple mode: Copy spec to living docs (legacy)
+      console.log('📋 Using simple sync mode (legacy)');
+      specCopied = await copyIncrementSpecToLivingDocs(incrementId);
+      changedDocs = detectChangedDocs();
+    }
 
     if (changedDocs.length === 0 && !specCopied) {
-      console.log('ℹ️  No living docs changed (no git diff in .specweave/docs/)');
+      console.log('ℹ️  No living docs changed');
       return;
     }
 
-    console.log(`📄 Detected ${changedDocs.length} changed doc(s):`);
-    changedDocs.forEach((doc) => console.log(`   - ${doc}`));
+    console.log(`📄 Changed/created ${changedDocs.length} file(s)`);
 
     // 4. Sync to GitHub if configured
     await syncToGitHub(incrementId, changedDocs);
@@ -85,7 +112,69 @@ async function syncLivingDocs(incrementId: string): Promise<void> {
 }
 
 /**
- * Copy increment spec to living docs
+ * Intelligent sync using the new architecture (v0.18.0+)
+ */
+async function intelligentSyncLivingDocs(
+  incrementId: string,
+  config: Config
+): Promise<{ success: boolean; changedFiles: string[] }> {
+  try {
+    // Dynamic import to avoid circular dependencies
+    const { syncIncrement } = await import('../../../../src/core/living-docs/index.js');
+
+    console.log('   📖 Parsing and classifying spec sections...');
+
+    const result = await syncIncrement(incrementId, {
+      verbose: false, // We'll log our own summary
+      dryRun: false,
+      parser: {
+        preserveCodeBlocks: true,
+        preserveLinks: true,
+        preserveImages: true,
+      },
+      distributor: {
+        generateFrontmatter: true,
+        preserveOriginal: config.livingDocs?.intelligent?.preserveOriginal ?? true,
+      },
+      linker: {
+        generateBacklinks: config.livingDocs?.intelligent?.generateCrossLinks ?? true,
+        updateExisting: true,
+      },
+    });
+
+    // Log summary
+    console.log(`   ✅ Intelligent sync complete:`);
+    console.log(`      Project: ${result.project.name} (${(result.project.confidence * 100).toFixed(0)}% confidence)`);
+    console.log(`      Files created: ${result.distribution.summary.filesCreated}`);
+    console.log(`      Files updated: ${result.distribution.summary.filesUpdated}`);
+    console.log(`      Cross-links: ${result.links.length}`);
+    console.log(`      Duration: ${result.duration}ms`);
+
+    // Collect changed file paths
+    const changedFiles = [
+      ...result.distribution.created.map((f) => f.path),
+      ...result.distribution.updated.map((f) => f.path),
+    ];
+
+    return {
+      success: result.success,
+      changedFiles,
+    };
+  } catch (error) {
+    console.error(`   ❌ Intelligent sync failed: ${error}`);
+    console.error('   Falling back to simple sync mode...');
+
+    // Fallback to simple mode
+    const copied = await copyIncrementSpecToLivingDocs(incrementId);
+    return {
+      success: copied,
+      changedFiles: copied ? [path.join(process.cwd(), '.specweave', 'docs', 'internal', 'specs', `spec-${incrementId}.md`)] : [],
+    };
+  }
+}
+
+/**
+ * Copy increment spec to living docs (legacy/simple mode)
  * Returns true if spec was copied, false if skipped
  */
 async function copyIncrementSpecToLivingDocs(incrementId: string): Promise<boolean> {

package/plugins/specweave-ado/.claude-plugin/plugin.json

@@ -17,5 +17,5 @@
     "integration"
   ],
   "license": "MIT",
-  "hooks": "hooks/hooks.json"
+  "hooks": "./hooks/hooks.json"
 }

package/plugins/specweave-docs-preview/commands/preview.md

@@ -51,7 +51,7 @@ if (fs.existsSync(configPath)) {
 const docsConfig = config.documentation?.preview || {
   enabled: true,
   autoInstall: true,
-  port: 3015,
+  port: 3016,
   openBrowser: true,
   theme: 'default',
   excludeFolders: ['legacy', 'node_modules']
@@ -103,7 +103,7 @@ if (setupNeeded) {
 ```typescript
 try {
   const options = {
-    port: docsConfig.port || 3015,
+    port: docsConfig.port || 3016,
     openBrowser: docsConfig.openBrowser !== false,
     theme: docsConfig.theme || 'default',
     excludeFolders: docsConfig.excludeFolders || ['legacy', 'node_modules']
@@ -135,8 +135,8 @@ try {
   } else if (error.message.includes('port')) {
     console.log('💡 Solution:');
     console.log('   • Change port in .specweave/config.json');
-    console.log('   • Or stop the service using port ' + (docsConfig.port || 3015));
-    console.log('   • Check with: lsof -i :' + (docsConfig.port || 3015) + '\n');
+    console.log('   • Or stop the service using port ' + (docsConfig.port || 3016));
+    console.log('   • Check with: lsof -i :' + (docsConfig.port || 3016) + '\n');
   } else {
     console.log('💡 Troubleshooting:');
     console.log('   • Check Node.js version (18+ required): node --version');
@@ -160,7 +160,7 @@ The command uses settings from `.specweave/config.json`:
     "preview": {
       "enabled": true,
       "autoInstall": true,
-      "port": 3015,
+      "port": 3016,
       "openBrowser": true,
       "theme": "default",
       "excludeFolders": ["legacy", "node_modules"]
@@ -250,11 +250,11 @@ Changes to markdown files in `.specweave/docs/internal/` are detected automatica
 ✓ Packages installed successfully
 ✓ Configuration generated
 ✓ Sidebar generated (42 documents, 8 categories)
-✓ Server started on http://localhost:3015
+✓ Server started on http://localhost:3016
 
 ✅ Documentation server started successfully!
 
-🌐 URL: http://localhost:3015
+🌐 URL: http://localhost:3016
 🔄 Hot reload enabled - edit markdown files to see changes instantly
 🗂️  Sidebar auto-generated from folder structure
 📊 Mermaid diagrams supported
@@ -270,11 +270,11 @@ Changes to markdown files in `.specweave/docs/internal/` are detected automatica
 ✓ Configuration up-to-date
 
 ✓ Sidebar generated (42 documents, 8 categories)
-✓ Server started on http://localhost:3015
+✓ Server started on http://localhost:3016
 
 ✅ Documentation server started successfully!
 
-🌐 URL: http://localhost:3015
+🌐 URL: http://localhost:3016
 🔄 Hot reload enabled - edit markdown files to see changes instantly
 🗂️  Sidebar auto-generated from folder structure
 📊 Mermaid diagrams supported
@@ -288,11 +288,11 @@ Changes to markdown files in `.specweave/docs/internal/` are detected automatica
 
 **Port Already in Use:**
 ```
-Error: Port 3015 is already in use
+Error: Port 3016 is already in use
 ```
 Solution:
 1. Change port in `.specweave/config.json` → `documentation.preview.port`
-2. Or stop the service: `lsof -i :3015` then `kill -9 <PID>`
+2. Or stop the service: `lsof -i :3016` then `kill -9 <PID>`
 
 **Node.js Version:**
 ```

package/plugins/specweave-github/.claude-plugin/plugin.json

@@ -16,5 +16,5 @@
     "sync",
     "specweave"
   ],
-  "hooks": "hooks/hooks.json"
+  "hooks": "./hooks/hooks.json"
 }

package/plugins/specweave-github/hooks/post-task-completion.sh

@@ -95,10 +95,10 @@ EOF
 fi
 
 # ============================================================================
-# DETECT CURRENT SPEC
+# DETECT ALL SPECS (Multi-Spec Support)
 # ============================================================================
 
-# Strategy: Find current increment, then find which spec it belongs to
+# Strategy: Use multi-spec detector to find ALL specs referenced in current increment
 
 # 1. Detect current increment (temporary context)
 CURRENT_INCREMENT=$(ls -t .specweave/increments/ 2>/dev/null | grep -v "_backlog" | head -1)
@@ -108,49 +108,78 @@ if [ -z "$CURRENT_INCREMENT" ]; then
   # Fall through to sync all changed specs
 fi
 
-SPEC_ID=""
+# 2. Use TypeScript CLI to detect all specs
+DETECT_CLI="$PROJECT_ROOT/dist/src/cli/commands/detect-specs.js"
 
-if [ -n "$CURRENT_INCREMENT" ]; then
-  # 2. Try to find spec reference in increment
-  SPEC_FILE=".specweave/increments/$CURRENT_INCREMENT/spec.md"
+if [ -f "$DETECT_CLI" ]; then
+  echo "[$(date)] [GitHub] 🔍 Detecting all specs in increment $CURRENT_INCREMENT..." >> "$DEBUG_LOG" 2>/dev/null || true
 
-  if [ -f "$SPEC_FILE" ]; then
-    # Look for "Implements: SPEC-XXX" or "See: SPEC-XXX" patterns
-    SPEC_REF=$(grep -E "^(Implements|See|References).*SPEC-[0-9]+" "$SPEC_FILE" 2>/dev/null | head -1 || echo "")
+  # Call detect-specs CLI and capture JSON output
+  DETECTION_RESULT=$(node "$DETECT_CLI" 2>> "$DEBUG_LOG" || echo "{}")
 
-    if [ -n "$SPEC_REF" ]; then
-      # Extract spec ID (e.g., "SPEC-001" → "spec-001")
-      SPEC_ID=$(echo "$SPEC_REF" | grep -oE "SPEC-[0-9]+" | tr 'A-Z' 'a-z' | head -1)
-      echo "[$(date)] [GitHub] 📋 Detected spec: $SPEC_ID (from increment $CURRENT_INCREMENT)" >> "$DEBUG_LOG" 2>/dev/null || true
-    fi
-  fi
+  # Extract spec count
+  SPEC_COUNT=$(echo "$DETECTION_RESULT" | node -e "const fs=require('fs'); const data=JSON.parse(fs.readFileSync(0,'utf-8')); console.log(data.specs?.length || 0)")
+
+  echo "[$(date)] [GitHub] 📋 Detected $SPEC_COUNT spec(s)" >> "$DEBUG_LOG" 2>/dev/null || true
+
+  # Store detection result for later use
+  echo "$DETECTION_RESULT" > /tmp/specweave-detected-specs.json
+else
+  echo "[$(date)] [GitHub] ⚠️  detect-specs CLI not found at $DETECT_CLI, falling back to git diff" >> "$DEBUG_LOG" 2>/dev/null || true
+  SPEC_COUNT=0
 fi
 
 # ============================================================================
-# SYNC SPEC TO GITHUB
+# SYNC ALL DETECTED SPECS TO GITHUB (Multi-Spec Support)
 # ============================================================================
 
-if [ -n "$SPEC_ID" ]; then
-  # Convert SPEC_ID to spec file path
-  SPEC_FILE=$(find .specweave/docs/internal/specs -name "${SPEC_ID}*.md" -o -name "${SPEC_ID}.md" 2>/dev/null | head -1)
+if [ -f /tmp/specweave-detected-specs.json ] && [ "$SPEC_COUNT" -gt 0 ]; then
+  # Multi-spec sync: Loop through all detected specs
+  echo "[$(date)] [GitHub] 🔄 Syncing $SPEC_COUNT spec(s) to GitHub..." >> "$DEBUG_LOG" 2>/dev/null || true
+
+  # Extract spec paths using Node.js
+  SPEC_PATHS=$(node -e "
+    const fs = require('fs');
+    const data = JSON.parse(fs.readFileSync('/tmp/specweave-detected-specs.json', 'utf-8'));
+    const syncable = data.specs.filter(s => s.syncEnabled && s.project !== '_parent');
+    syncable.forEach(s => console.log(s.path));
+  " 2>> "$DEBUG_LOG")
+
+  # Count syncable specs
+  SYNCABLE_COUNT=$(echo "$SPEC_PATHS" | grep -v '^$' | wc -l | tr -d ' ')
 
-  if [ -n "$SPEC_FILE" ]; then
-    # Sync specific spec
-    echo "[$(date)] [GitHub] 🔄 Syncing spec $SPEC_ID ($SPEC_FILE) to GitHub..." >> "$DEBUG_LOG" 2>/dev/null || true
+  if [ "$SYNCABLE_COUNT" -gt 0 ]; then
+    echo "[$(date)] [GitHub] 📋 Syncing $SYNCABLE_COUNT syncable spec(s) (excluding _parent)" >> "$DEBUG_LOG" 2>/dev/null || true
 
-    (cd "$PROJECT_ROOT" && node "$SYNC_CLI" --spec "$SPEC_FILE" --provider github) 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
-      echo "[$(date)] [GitHub] ⚠️  Spec sync failed for $SPEC_ID (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
-    }
+    # Sync each spec
+    echo "$SPEC_PATHS" | while read -r SPEC_FILE; do
+      if [ -n "$SPEC_FILE" ] && [ -f "$SPEC_FILE" ]; then
+        # Extract project and spec ID from path
+        SPEC_NAME=$(basename "$SPEC_FILE" .md)
+        PROJECT=$(basename "$(dirname "$SPEC_FILE")")
 
-    echo "[$(date)] [GitHub] ✅ Spec sync complete for $SPEC_ID" >> "$DEBUG_LOG" 2>/dev/null || true
+        echo "[$(date)] [GitHub] 🔄 Syncing $PROJECT/$SPEC_NAME..." >> "$DEBUG_LOG" 2>/dev/null || true
+
+        (cd "$PROJECT_ROOT" && node "$SYNC_CLI" --spec "$SPEC_FILE" --provider github) 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
+          echo "[$(date)] [GitHub] ⚠️  Spec sync failed for $PROJECT/$SPEC_NAME (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
+        }
+
+        echo "[$(date)] [GitHub] ✅ Synced $PROJECT/$SPEC_NAME" >> "$DEBUG_LOG" 2>/dev/null || true
+      fi
+    done
+
+    echo "[$(date)] [GitHub] ✅ Multi-spec sync complete ($SYNCABLE_COUNT synced)" >> "$DEBUG_LOG" 2>/dev/null || true
   else
-    echo "[$(date)] [GitHub] ⚠️  Spec file not found for $SPEC_ID" >> "$DEBUG_LOG" 2>/dev/null || true
+    echo "[$(date)] [GitHub] ℹ️  No syncable specs (all specs are _parent or syncEnabled=false)" >> "$DEBUG_LOG" 2>/dev/null || true
   fi
+
+  # Cleanup temp file
+  rm -f /tmp/specweave-detected-specs.json 2>/dev/null || true
 else
-  # Sync all modified specs (check git diff)
+  # Fallback: Sync all modified specs (check git diff)
   echo "[$(date)] [GitHub] 🔄 Checking for modified specs..." >> "$DEBUG_LOG" 2>/dev/null || true
 
-  MODIFIED_SPECS=$(git diff --name-only HEAD .specweave/docs/internal/specs/*.md 2>/dev/null || echo "")
+  MODIFIED_SPECS=$(git diff --name-only HEAD .specweave/docs/internal/specs/**/*.md 2>/dev/null || echo "")
 
   if [ -n "$MODIFIED_SPECS" ]; then
     echo "[$(date)] [GitHub] 📝 Found modified specs:" >> "$DEBUG_LOG" 2>/dev/null || true
@@ -158,7 +187,7 @@ else
 
     # Sync each modified spec
     echo "$MODIFIED_SPECS" | while read -r SPEC_FILE; do
-      if [ -n "$SPEC_FILE" ]; then
+      if [ -n "$SPEC_FILE" ] && [ -f "$SPEC_FILE" ]; then
         echo "[$(date)] [GitHub] 🔄 Syncing $SPEC_FILE..." >> "$DEBUG_LOG" 2>/dev/null || true
         (cd "$PROJECT_ROOT" && node "$SYNC_CLI" --spec "$SPEC_FILE" --provider github) 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || true
       fi

package/plugins/specweave-github/lib/github-spec-content-sync.js

@@ -8,8 +8,34 @@ import {
 } from "../../../src/core/spec-content-sync.js";
 import path from "path";
 import fs from "fs/promises";
+async function getGitHubRepoForProject(project, specPath) {
+  try {
+    let currentDir = path.dirname(specPath);
+    let configPath = path.join(currentDir, ".specweave", "config.json");
+    while (!await fs.access(configPath).then(() => true).catch(() => false)) {
+      const parentDir = path.dirname(currentDir);
+      if (parentDir === currentDir) {
+        return null;
+      }
+      currentDir = parentDir;
+      configPath = path.join(currentDir, ".specweave", "config.json");
+    }
+    const configContent = await fs.readFile(configPath, "utf-8");
+    const config = JSON.parse(configContent);
+    const projectConfig = config.specs?.projects?.[project];
+    if (!projectConfig?.github) {
+      return null;
+    }
+    return {
+      owner: projectConfig.github.owner,
+      repo: projectConfig.github.repo
+    };
+  } catch {
+    return null;
+  }
+}
 async function syncSpecContentToGitHub(options) {
-  const { specPath, owner, repo, dryRun = false, verbose = false } = options;
+  let { specPath, owner, repo, dryRun = false, verbose = false } = options;
   try {
     const spec = await parseSpecContent(specPath);
     if (!spec) {
@@ -20,10 +46,26 @@ async function syncSpecContentToGitHub(options) {
       };
     }
     if (verbose) {
-      console.log(`\u{1F4C4} Parsed spec: ${spec.id}`);
+      console.log(`\u{1F4C4} Parsed spec: ${spec.identifier.compact}`);
+      console.log(`   Project: ${spec.project}`);
       console.log(`   Title: ${spec.title}`);
       console.log(`   User Stories: ${spec.userStories.length}`);
     }
+    if (!owner || !repo) {
+      const repoConfig = await getGitHubRepoForProject(spec.project, specPath);
+      if (!repoConfig) {
+        return {
+          success: false,
+          action: "error",
+          error: `No GitHub repository configured for project "${spec.project}". Add specs.projects.${spec.project}.github in config.json`
+        };
+      }
+      owner = repoConfig.owner;
+      repo = repoConfig.repo;
+      if (verbose) {
+        console.log(`   Auto-detected repo: ${owner}/${repo}`);
+      }
+    }
     const existingIssueNumber = await hasExternalLink(specPath, "github");
     const client = GitHubClientV2.fromRepo(owner, repo);
     if (existingIssueNumber) {
@@ -42,7 +84,7 @@ async function syncSpecContentToGitHub(options) {
 async function createGitHubIssue(client, spec, options) {
   const { specPath, dryRun, verbose } = options;
   try {
-    const title = `[${spec.id.toUpperCase()}] ${spec.title}`;
+    const title = `[${spec.identifier.compact}] ${spec.title}`;
     const body = buildExternalDescription(spec);
     if (verbose) {
       console.log(`
@@ -62,7 +104,13 @@ ${body}`);
         externalUrl: "https://github.com/DRY-RUN"
       };
     }
-    const labels = ["specweave", "spec", spec.metadata.priority || "P2"].filter(Boolean);
+    const labels = [
+      "specweave",
+      "spec",
+      spec.project,
+      // backend, frontend, mobile, etc.
+      spec.metadata.priority || "P2"
+    ].filter(Boolean);
     const issue = await client.createEpicIssue(title, body, void 0, labels);
     if (verbose) {
       console.log(`\u2705 Created issue #${issue.number}`);
@@ -96,8 +144,9 @@ async function updateGitHubIssue(client, spec, issueNumber, options) {
       console.log(`
 \u{1F504} Checking for changes in issue #${issueNumber}`);
     }
+    const cleanTitle = issue.title.replace(/^\[[A-Z]{2,4}-[A-Z0-9-]+\]\s*/, "");
     const changes = detectContentChanges(spec, {
-      title: issue.title.replace(/^\[SPEC-\d+\]\s*/, ""),
+      title: cleanTitle,
       description: issue.body || "",
       userStoryCount: countUserStoriesInBody(issue.body || "")
     });
@@ -118,7 +167,7 @@ async function updateGitHubIssue(client, spec, issueNumber, options) {
         console.log(`      - ${change}`);
       }
     }
-    const newTitle = `[${spec.id.toUpperCase()}] ${spec.title}`;
+    const newTitle = `[${spec.identifier.compact}] ${spec.title}`;
     const newBody = buildExternalDescription(spec);
     if (dryRun) {
       console.log("\n\u{1F50D} Dry run - would update issue:");