specweave 0.17.0 → 0.17.1

package/dist/utils/git-utils.js

@@ -0,0 +1,272 @@
+/**
+ * Git Utilities for SpecWeave
+ *
+ * Provides utilities for:
+ * - Getting recent commits
+ * - Generating commit URLs for different providers
+ * - Finding PRs containing commits
+ * - Detecting repository information
+ */
+import { execFileNoThrow } from './execFileNoThrow.js';
+/**
+ * Get recent commits since a specific date/SHA
+ */
+export async function getRecentCommits(since, sinceCommit, cwd) {
+    const args = [
+        'log',
+        '--pretty=format:%H|%h|%s|%an|%aI',
+        '--no-merges',
+    ];
+    if (sinceCommit) {
+        // Get commits since specific commit (exclusive)
+        args.push(`${sinceCommit}..HEAD`);
+    }
+    else if (since) {
+        // Get commits since date
+        args.push(`--since=${since}`);
+    }
+    else {
+        // Default: last 24 hours
+        args.push('--since=24.hours');
+    }
+    const result = await execFileNoThrow('git', args, { cwd });
+    if (result.exitCode !== 0) {
+        throw new Error(`Failed to get git commits: ${result.stderr || result.stdout}`);
+    }
+    const lines = result.stdout.trim().split('\n').filter(line => line.length > 0);
+    return lines.map(line => {
+        const [sha, shortSha, message, author, dateStr] = line.split('|');
+        return {
+            sha,
+            shortSha,
+            message,
+            author,
+            date: new Date(dateStr),
+        };
+    });
+}
+/**
+ * Get commits between two refs (e.g., last sync to HEAD)
+ */
+export async function getCommitsBetween(fromRef, toRef = 'HEAD', cwd) {
+    const args = [
+        'log',
+        '--pretty=format:%H|%h|%s|%an|%aI',
+        '--no-merges',
+        `${fromRef}..${toRef}`,
+    ];
+    const result = await execFileNoThrow('git', args, { cwd });
+    if (result.exitCode !== 0) {
+        throw new Error(`Failed to get git commits: ${result.stderr || result.stdout}`);
+    }
+    const lines = result.stdout.trim().split('\n').filter(line => line.length > 0);
+    return lines.map(line => {
+        const [sha, shortSha, message, author, dateStr] = line.split('|');
+        return {
+            sha,
+            shortSha,
+            message,
+            author,
+            date: new Date(dateStr),
+        };
+    });
+}
+/**
+ * Detect repository information from git remote
+ */
+export async function detectRepository(remoteName = 'origin', cwd) {
+    // Get remote URL
+    const result = await execFileNoThrow('git', [
+        'remote',
+        'get-url',
+        remoteName,
+    ], { cwd });
+    if (result.exitCode !== 0) {
+        return null;
+    }
+    const remoteUrl = result.stdout.trim();
+    // Parse different URL formats
+    return parseGitRemoteUrl(remoteUrl);
+}
+/**
+ * Parse git remote URL to extract provider, owner, repo
+ */
+export function parseGitRemoteUrl(url) {
+    // GitHub patterns
+    const githubHttps = url.match(/https:\/\/github\.com\/(.+?)\/(.+?)(?:\.git)?$/);
+    const githubSsh = url.match(/git@github\.com:(.+?)\/(.+?)(?:\.git)?$/);
+    if (githubHttps || githubSsh) {
+        const match = githubHttps || githubSsh;
+        return {
+            provider: 'github',
+            owner: match[1],
+            repo: match[2],
+            url: `https://github.com/${match[1]}/${match[2]}`,
+        };
+    }
+    // GitLab patterns
+    const gitlabHttps = url.match(/https:\/\/gitlab\.com\/(.+?)\/(.+?)(?:\.git)?$/);
+    const gitlabSsh = url.match(/git@gitlab\.com:(.+?)\/(.+?)(?:\.git)?$/);
+    if (gitlabHttps || gitlabSsh) {
+        const match = gitlabHttps || gitlabSsh;
+        return {
+            provider: 'gitlab',
+            owner: match[1],
+            repo: match[2],
+            url: `https://gitlab.com/${match[1]}/${match[2]}`,
+        };
+    }
+    // Bitbucket patterns
+    const bitbucketHttps = url.match(/https:\/\/bitbucket\.org\/(.+?)\/(.+?)(?:\.git)?$/);
+    const bitbucketSsh = url.match(/git@bitbucket\.org:(.+?)\/(.+?)(?:\.git)?$/);
+    if (bitbucketHttps || bitbucketSsh) {
+        const match = bitbucketHttps || bitbucketSsh;
+        return {
+            provider: 'bitbucket',
+            owner: match[1],
+            repo: match[2],
+            url: `https://bitbucket.org/${match[1]}/${match[2]}`,
+        };
+    }
+    // Azure DevOps patterns
+    const azureHttps = url.match(/https:\/\/dev\.azure\.com\/(.+?)\/_git\/(.+?)(?:\.git)?$/);
+    const azureSsh = url.match(/git@ssh\.dev\.azure\.com:v3\/(.+?)\/(.+?)\/(.+?)(?:\.git)?$/);
+    if (azureHttps) {
+        return {
+            provider: 'azure',
+            owner: azureHttps[1],
+            repo: azureHttps[2],
+            url: `https://dev.azure.com/${azureHttps[1]}/_git/${azureHttps[2]}`,
+        };
+    }
+    if (azureSsh) {
+        return {
+            provider: 'azure',
+            owner: azureSsh[1],
+            repo: azureSsh[3],
+            url: `https://dev.azure.com/${azureSsh[1]}/_git/${azureSsh[3]}`,
+        };
+    }
+    return null;
+}
+/**
+ * Generate commit URL for different providers
+ */
+export function getCommitUrl(commit, repo) {
+    switch (repo.provider) {
+        case 'github':
+            return `${repo.url}/commit/${commit.sha}`;
+        case 'gitlab':
+            return `${repo.url}/-/commit/${commit.sha}`;
+        case 'bitbucket':
+            return `${repo.url}/commits/${commit.sha}`;
+        case 'azure':
+            return `${repo.url}/commit/${commit.sha}`;
+        default:
+            return commit.sha;
+    }
+}
+/**
+ * Find PR containing a commit (GitHub only for now)
+ */
+export async function findPRForCommit(commitSha, owner, repo) {
+    // Check if gh CLI is available
+    const ghCheck = await execFileNoThrow('gh', ['--version']);
+    if (ghCheck.exitCode !== 0) {
+        return null;
+    }
+    // Search for PR containing this commit
+    const result = await execFileNoThrow('gh', [
+        'pr',
+        'list',
+        '--repo',
+        `${owner}/${repo}`,
+        '--search',
+        commitSha,
+        '--json',
+        'number,title,url,state',
+        '--limit',
+        '1',
+    ]);
+    if (result.exitCode !== 0 || !result.stdout.trim()) {
+        return null;
+    }
+    try {
+        const prs = JSON.parse(result.stdout);
+        if (prs.length === 0) {
+            return null;
+        }
+        const pr = prs[0];
+        return {
+            number: pr.number,
+            title: pr.title,
+            url: pr.url,
+            state: pr.state.toLowerCase(),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get last sync commit SHA from metadata
+ */
+export async function getLastSyncCommit(metadataPath) {
+    try {
+        const fs = await import('fs/promises');
+        const metadata = JSON.parse(await fs.readFile(metadataPath, 'utf-8'));
+        return metadata.lastSyncCommit || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Update last sync commit in metadata
+ */
+export async function updateLastSyncCommit(metadataPath, commitSha) {
+    try {
+        const fs = await import('fs/promises');
+        let metadata = {};
+        try {
+            metadata = JSON.parse(await fs.readFile(metadataPath, 'utf-8'));
+        }
+        catch {
+            // File doesn't exist or invalid JSON, start fresh
+        }
+        metadata.lastSyncCommit = commitSha;
+        metadata.lastSyncDate = new Date().toISOString();
+        await fs.writeFile(metadataPath, JSON.stringify(metadata, null, 2));
+    }
+    catch (error) {
+        throw new Error(`Failed to update last sync commit: ${error.message}`);
+    }
+}
+/**
+ * Get current HEAD commit SHA
+ */
+export async function getCurrentCommitSha(cwd) {
+    const result = await execFileNoThrow('git', ['rev-parse', 'HEAD'], { cwd });
+    if (result.exitCode !== 0) {
+        throw new Error(`Failed to get current commit SHA: ${result.stderr || result.stdout}`);
+    }
+    return result.stdout.trim();
+}
+/**
+ * Check if working directory is clean
+ */
+export async function isWorkingDirectoryClean(cwd) {
+    const result = await execFileNoThrow('git', ['status', '--porcelain'], { cwd });
+    return result.exitCode === 0 && result.stdout.trim().length === 0;
+}
+/**
+ * Get current branch name
+ */
+export async function getCurrentBranch(cwd) {
+    const result = await execFileNoThrow('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd });
+    if (result.exitCode !== 0) {
+        throw new Error(`Failed to get current branch: ${result.stderr || result.stdout}`);
+    }
+    return result.stdout.trim();
+}
+//# sourceMappingURL=git-utils.js.map

package/dist/utils/git-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-utils.js","sourceRoot":"","sources":["../../src/utils/git-utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.17.0",
+  "version": "0.17.1",
   "description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
   "type": "module",
   "main": "dist/index.js",
@@ -74,6 +74,7 @@
     "@anthropic-ai/sdk": "^0.20.0",
     "@octokit/rest": "^22.0.1",
     "ajv": "^8.17.1",
+    "axios": "^1.13.2",
     "chalk": "^5.3.0",
     "commander": "^14.0.2",
     "fs-extra": "^11.2.0",

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

@@ -18,5 +18,6 @@
     "pm",
     "architect",
     "living-docs"
-  ]
+  ],
+  "hooks": "hooks/hooks.json"
 }

package/plugins/specweave/commands/revert-wip-limit.md

@@ -0,0 +1,82 @@
+---
+name: specweave:revert-wip-limit
+description: Revert WIP limit to original value after temporary adjustment
+---
+
+# Revert WIP Limit Command
+
+**Purpose**: Restore WIP (Work In Progress) limit to original value after temporary adjustment
+
+## What This Command Does
+
+When you temporarily adjust the WIP limit using the migration system:
+```bash
+bash plugins/specweave/hooks/lib/migrate-increment-work.sh adjust-wip 3
+```
+
+This command reverts it back to the original value (usually 2).
+
+## Usage
+
+```bash
+/specweave:revert-wip-limit
+```
+
+## What Gets Reverted
+
+1. **WIP Limit**: Restored to original `hardCap` value (stored in `config.limits.originalHardCap`)
+2. **Timestamp**: Cleared (`wipAdjustedAt` removed)
+3. **Backup**: Original config backup is kept for safety
+
+## Example Workflow
+
+```bash
+# 1. WIP limit reached, temporarily adjust
+bash plugins/specweave/hooks/lib/migrate-increment-work.sh adjust-wip 3
+
+# 2. Work on both increments (20% productivity cost)
+
+# 3. Complete one increment
+/specweave:done 0026
+
+# 4. Revert WIP limit back to 2
+/specweave:revert-wip-limit
+```
+
+## Output
+
+```
+✅ WIP limit reverted to original value: 2
+   Previous limit: 3
+   Adjusted at: 2025-11-11T15:30:00Z
+   Duration: 2 hours 15 minutes
+```
+
+## Implementation
+
+You should:
+
+1. Read `.specweave/config.json`
+2. Check if `limits.originalHardCap` exists
+3. If yes:
+   - Restore `limits.hardCap = limits.originalHardCap`
+   - Remove `limits.wipAdjustedAt`
+   - Remove `limits.originalHardCap`
+   - Save config
+4. If no: Show "No temporary WIP adjustment to revert"
+
+## Safety
+
+- ✅ Creates backup before reverting (`.specweave/config.json.bak`)
+- ✅ Validates config structure
+- ✅ Shows confirmation message
+- ✅ Non-destructive (can manually restore from backup if needed)
+
+## Best Practice
+
+**Revert ASAP!** Temporary WIP adjustments are for emergencies only. The longer you work with 3+ active increments, the more productivity suffers.
+
+**Research shows**:
+- 1 active increment = 100% productivity ✅
+- 2 active increments = 80% productivity (20% cost) ⚠️
+- 3+ active increments = 60% productivity (40% cost) ❌

package/plugins/specweave/hooks/hooks.json

@@ -19,6 +19,16 @@
             "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-task-completion.sh"
           }
         ]
+      },
+      {
+        "matcher": "Write",
+        "matcher_content": "\\.specweave/increments/[0-9]{4}-.+/(spec|plan|tasks)\\.md",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-increment-planning.sh"
+          }
+        ]
       }
     ]
   }

package/plugins/specweave/hooks/lib/migrate-increment-work.sh

@@ -0,0 +1,245 @@
+#!/bin/bash
+
+# SpecWeave Increment Work Migration Utility
+# Purpose: Smart migration options when WIP limit is reached
+#
+# Options:
+#   1. Transfer work (move incomplete tasks to new increment)
+#   2. Adjust WIP limit (temporarily allow 3 active)
+#   3. Force-close (mark as complete without transferring work)
+
+set -euo pipefail
+
+# ============================================================================
+# CONFIGURATION
+# ============================================================================
+
+SPECWEAVE_DIR="${SPECWEAVE_DIR:-.specweave}"
+CONFIG_FILE="$SPECWEAVE_DIR/config.json"
+
+# ============================================================================
+# HELPER FUNCTIONS
+# ============================================================================
+
+# Get incomplete tasks from increment
+get_incomplete_tasks() {
+  local increment_id="$1"
+  local tasks_file="$SPECWEAVE_DIR/increments/$increment_id/tasks.md"
+
+  if [[ ! -f "$tasks_file" ]]; then
+    echo ""
+    return
+  fi
+
+  # Extract unchecked tasks (lines starting with "- [ ]")
+  grep -E "^\s*-\s*\[ \]" "$tasks_file" 2>/dev/null || echo ""
+}
+
+# Count incomplete tasks
+count_incomplete_tasks() {
+  local increment_id="$1"
+  local tasks=$(get_incomplete_tasks "$increment_id")
+
+  if [[ -z "$tasks" ]]; then
+    echo "0"
+  else
+    echo "$tasks" | wc -l | xargs
+  fi
+}
+
+# Transfer work from old increment to new increment
+transfer_work() {
+  local source_increment="$1"
+  local target_increment="$2"
+
+  echo "🔄 Transferring incomplete work from $source_increment to $target_increment..."
+
+  # Get incomplete tasks
+  local incomplete_tasks=$(get_incomplete_tasks "$source_increment")
+
+  if [[ -z "$incomplete_tasks" ]]; then
+    echo "✅ No incomplete tasks to transfer"
+    return 0
+  fi
+
+  local task_count=$(echo "$incomplete_tasks" | wc -l | xargs)
+  echo "   📋 Found $task_count incomplete tasks"
+
+  # Append to target increment's tasks.md
+  local target_tasks="$SPECWEAVE_DIR/increments/$target_increment/tasks.md"
+
+  if [[ ! -f "$target_tasks" ]]; then
+    echo "❌ Target increment tasks.md not found: $target_tasks"
+    return 1
+  fi
+
+  # Add separator and transferred tasks
+  cat >> "$target_tasks" <<EOF
+
+---
+
+## 🔄 Transferred from $source_increment
+
+$incomplete_tasks
+
+EOF
+
+  echo "   ✅ Transferred $task_count tasks to $target_tasks"
+
+  # Mark source increment as completed-with-work-transfer
+  local source_metadata="$SPECWEAVE_DIR/increments/$source_increment/metadata.json"
+
+  if [[ -f "$source_metadata" ]]; then
+    node -e "
+      const fs = require('fs');
+      const path = '$source_metadata';
+      const data = JSON.parse(fs.readFileSync(path, 'utf-8'));
+      data.status = 'completed';
+      data.completionNote = 'Work transferred to $target_increment';
+      data.completedAt = new Date().toISOString();
+      data.workTransferredTo = '$target_increment';
+      fs.writeFileSync(path, JSON.stringify(data, null, 2));
+    "
+    echo "   ✅ Updated $source_increment metadata (status: completed, work transferred)"
+  fi
+
+  # Update target increment metadata
+  local target_metadata="$SPECWEAVE_DIR/increments/$target_increment/metadata.json"
+
+  if [[ -f "$target_metadata" ]]; then
+    node -e "
+      const fs = require('fs');
+      const path = '$target_metadata';
+      const data = JSON.parse(fs.readFileSync(path, 'utf-8'));
+      data.workTransferredFrom = data.workTransferredFrom || [];
+      data.workTransferredFrom.push('$source_increment');
+      fs.writeFileSync(path, JSON.stringify(data, null, 2));
+    "
+    echo "   ✅ Updated $target_increment metadata (work received from $source_increment)"
+  fi
+
+  echo "✅ Work transfer complete!"
+  return 0
+}
+
+# Adjust WIP limit temporarily
+adjust_wip_limit() {
+  local new_limit="$1"
+
+  echo "⚠️  Temporarily adjusting WIP limit to $new_limit..."
+
+  if [[ ! -f "$CONFIG_FILE" ]]; then
+    echo "❌ Config file not found: $CONFIG_FILE"
+    return 1
+  fi
+
+  # Update config.json (create backup first)
+  cp "$CONFIG_FILE" "$CONFIG_FILE.bak"
+
+  node -e "
+    const fs = require('fs');
+    const path = '$CONFIG_FILE';
+    const data = JSON.parse(fs.readFileSync(path, 'utf-8'));
+
+    // Ensure limits object exists
+    if (!data.limits) {
+      data.limits = {};
+    }
+
+    // Store original limit
+    if (!data.limits.originalHardCap) {
+      data.limits.originalHardCap = data.limits.hardCap || 2;
+    }
+
+    // Set new limit
+    data.limits.hardCap = parseInt('$new_limit', 10);
+    data.limits.wipAdjustedAt = new Date().toISOString();
+
+    fs.writeFileSync(path, JSON.stringify(data, null, 2));
+  "
+
+  echo "   ✅ WIP limit adjusted to $new_limit"
+  echo "   ⚠️  Remember to revert after completing one increment!"
+  echo "   💡 Run: specweave revert-wip-limit"
+
+  return 0
+}
+
+# Force-close increment
+force_close() {
+  local increment_id="$1"
+
+  echo "⚠️  Force-closing $increment_id..."
+
+  local metadata_file="$SPECWEAVE_DIR/increments/$increment_id/metadata.json"
+
+  if [[ ! -f "$metadata_file" ]]; then
+    echo "❌ Metadata file not found: $metadata_file"
+    return 1
+  fi
+
+  node -e "
+    const fs = require('fs');
+    const path = '$metadata_file';
+    const data = JSON.parse(fs.readFileSync(path, 'utf-8'));
+    data.status = 'completed';
+    data.completionNote = 'Force-closed to start new increment (WIP limit reached)';
+    data.completedAt = new Date().toISOString();
+    data.forceCloseReason = 'wip-limit-reached';
+    fs.writeFileSync(path, JSON.stringify(data, null, 2));
+  "
+
+  echo "   ✅ $increment_id marked as completed (force-closed)"
+  echo "   ⚠️  Incomplete work was not transferred!"
+
+  return 0
+}
+
+# ============================================================================
+# MAIN CLI
+# ============================================================================
+
+case "${1:-}" in
+  transfer)
+    if [[ $# -ne 3 ]]; then
+      echo "Usage: $0 transfer <source_increment> <target_increment>"
+      exit 1
+    fi
+    transfer_work "$2" "$3"
+    ;;
+
+  adjust-wip)
+    if [[ $# -ne 2 ]]; then
+      echo "Usage: $0 adjust-wip <new_limit>"
+      exit 1
+    fi
+    adjust_wip_limit "$2"
+    ;;
+
+  force-close)
+    if [[ $# -ne 2 ]]; then
+      echo "Usage: $0 force-close <increment_id>"
+      exit 1
+    fi
+    force_close "$2"
+    ;;
+
+  count-incomplete)
+    if [[ $# -ne 2 ]]; then
+      echo "Usage: $0 count-incomplete <increment_id>"
+      exit 1
+    fi
+    count_incomplete_tasks "$2"
+    ;;
+
+  *)
+    echo "SpecWeave Increment Work Migration Utility"
+    echo ""
+    echo "Usage:"
+    echo "  $0 transfer <source> <target>    # Transfer work from source to target"
+    echo "  $0 adjust-wip <limit>             # Adjust WIP limit temporarily"
+    echo "  $0 force-close <increment>        # Force-close increment"
+    echo "  $0 count-incomplete <increment>   # Count incomplete tasks"
+    exit 1
+    ;;
+esac