specweave 0.29.1 → 0.30.0

package/plugins/specweave-github/agents/user-story-updater/AGENT.md

@@ -1,6 +1,11 @@
 ---
 name: user-story-updater
 description: Updates GitHub issues for user stories with proper ACs and tasks. Activates for update user story issue, fix GitHub issue format, add checkable ACs, refresh user story issue, sync user story to GitHub.
+model: claude-opus-4-5-20251101
+model_preference: opus
+cost_profile: execution
+fallback_behavior: flexible
+max_response_tokens: 2000
 ---
 
 # User Story Updater Agent
@@ -17,7 +22,7 @@ description: Updates GitHub issues for user stories with proper ACs and tasks. A
 Task({
   subagent_type: "specweave-github:user-story-updater:user-story-updater",
   prompt: "Update GitHub issue #501 for user story FS-031/US-004 with checkable ACs and task connections",
-  model: "haiku" // optional: haiku, sonnet, opus
+  model: "opus" // default: opus (best quality)
 });
 ```
 

package/plugins/specweave-github/hooks/.specweave/logs/hooks-debug.log

@@ -70,3 +70,99 @@
 [Mon Dec  1 22:16:15 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
 [Mon Dec  1 22:16:16 EST 2025] [GitHub] 🔗 GitHub sync hook fired
 [Mon Dec  1 22:16:16 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 22:19:17 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 22:19:17 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 22:19:17 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 22:19:17 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 22:19:18 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 22:19:18 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 22:48:44 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 22:48:44 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 22:48:45 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 22:48:45 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 22:48:45 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 22:48:45 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 22:49:11 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 22:49:11 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 22:49:11 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 22:49:11 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 22:49:11 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 22:49:11 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 23:06:19 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 23:06:19 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 23:06:20 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 23:06:20 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 23:06:20 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 23:06:20 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 23:09:23 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 23:09:23 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 23:09:23 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 23:09:23 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 23:09:23 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 23:09:23 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 23:09:53 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 23:09:53 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 23:09:53 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 23:09:53 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 23:09:54 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 23:09:54 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 23:10:28 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 23:10:28 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 23:10:28 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 23:10:28 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 23:10:28 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 23:10:28 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 23:11:28 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 23:11:28 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 23:11:29 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 23:11:29 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 23:11:29 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 23:11:29 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 23:20:04 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 23:20:04 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 23:20:04 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 23:20:04 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 23:20:04 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 23:20:04 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 23:20:33 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 23:20:33 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 23:20:33 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 23:20:33 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Mon Dec  1 23:20:34 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Mon Dec  1 23:20:34 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Tue Dec  2 00:40:04 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Tue Dec  2 00:40:04 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Tue Dec  2 00:40:04 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Tue Dec  2 00:40:04 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Tue Dec  2 00:40:05 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Tue Dec  2 00:40:05 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Tue Dec  2 00:40:32 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Tue Dec  2 00:40:32 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Tue Dec  2 00:40:32 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Tue Dec  2 00:40:32 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Tue Dec  2 00:40:32 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Tue Dec  2 00:40:32 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Tue Dec  2 00:40:50 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Tue Dec  2 00:40:50 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Tue Dec  2 00:40:50 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Tue Dec  2 00:40:50 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Tue Dec  2 00:40:50 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Tue Dec  2 00:40:50 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Tue Dec  2 00:41:15 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Tue Dec  2 00:41:15 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Tue Dec  2 00:41:15 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Tue Dec  2 00:41:15 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Tue Dec  2 00:41:16 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Tue Dec  2 00:41:16 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Tue Dec  2 01:27:16 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Tue Dec  2 01:27:16 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Tue Dec  2 01:27:17 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Tue Dec  2 01:27:17 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Tue Dec  2 01:27:17 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Tue Dec  2 01:27:17 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Tue Dec  2 01:27:44 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Tue Dec  2 01:27:44 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Tue Dec  2 01:27:45 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Tue Dec  2 01:27:45 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync
+[Tue Dec  2 01:27:45 EST 2025] [GitHub] 🔗 GitHub sync hook fired
+[Tue Dec  2 01:27:45 EST 2025] [GitHub] ⚠️  sync-spec-content CLI not found at /Users/antonabyzov/Documents/Projects/specweave/plugins/specweave-github/hooks/dist/src/cli/commands/sync-spec-content.js, skipping sync

package/plugins/specweave-github/lib/github-client-v2.js

@@ -629,6 +629,103 @@ ${body}`;
   sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
   }
+  // ==========================================================================
+  // Pull Sync - External Change Detection (Increment 0089)
+  // ==========================================================================
+  /**
+   * Fetch recently changed issues for pull sync
+   *
+   * Uses GitHub Issues API with `since` parameter to find issues
+   * that have been updated since a given timestamp.
+   *
+   * @param since - Timestamp to query changes from
+   * @param linkedIssueNumbers - Optional list of issue numbers to filter (linked items only)
+   * @returns Array of external changes with changedAt, changedBy, and current values
+   */
+  async fetchRecentChanges(since, linkedIssueNumbers) {
+    const sinceISO = since.toISOString();
+    const jqFilter = linkedIssueNumbers && linkedIssueNumbers.length > 0 ? `.[] | select(.number | IN(${linkedIssueNumbers.join(",")})) | {number, title, state, updated_at, user: .user.login, assignee: .assignee.login, labels: [.labels[].name]}` : `.[] | {number, title, state, updated_at, user: .user.login, assignee: .assignee.login, labels: [.labels[].name]}`;
+    const result = await execFileNoThrow("gh", [
+      "api",
+      `repos/${this.fullRepo}/issues`,
+      "--method",
+      "GET",
+      "-f",
+      `since=${sinceISO}`,
+      "-f",
+      "state=all",
+      "-f",
+      "sort=updated",
+      "-f",
+      "direction=desc",
+      "-f",
+      "per_page=100",
+      "--jq",
+      jqFilter
+    ]);
+    if (result.exitCode !== 0) {
+      throw new Error(
+        `Failed to fetch recent changes: ${result.stderr || result.stdout}`
+      );
+    }
+    const lines = result.stdout.trim().split("\n").filter((l) => l.trim());
+    const issues = [];
+    for (const line of lines) {
+      try {
+        issues.push(JSON.parse(line));
+      } catch {
+      }
+    }
+    const changes = issues.map((issue) => ({
+      platform: "github",
+      externalId: `GH-${issue.number}`,
+      issueNumber: issue.number,
+      changedAt: issue.updated_at || (/* @__PURE__ */ new Date()).toISOString(),
+      changedBy: issue.user || "unknown",
+      changedFields: [],
+      // GitHub doesn't provide changelog in list API
+      currentState: {
+        status: issue.state,
+        labels: issue.labels || [],
+        assignee: issue.assignee || null
+      }
+    }));
+    return changes;
+  }
+  /**
+   * Get issue events for detailed change tracking
+   *
+   * Use this for detailed changelog when needed.
+   * GET /repos/{owner}/{repo}/issues/{issue_number}/events
+   *
+   * @param issueNumber - Issue number
+   * @param perPage - Limit number of events
+   * @returns Array of events with action details
+   */
+  async getIssueEvents(issueNumber, perPage = 30) {
+    const result = await execFileNoThrow("gh", [
+      "api",
+      `repos/${this.fullRepo}/issues/${issueNumber}/events`,
+      "-f",
+      `per_page=${perPage}`,
+      "--jq",
+      ".[].{event, created_at, actor: .actor.login}"
+    ]);
+    if (result.exitCode !== 0) {
+      throw new Error(
+        `Failed to get issue events: ${result.stderr || result.stdout}`
+      );
+    }
+    const lines = result.stdout.trim().split("\n").filter((l) => l.trim());
+    const events = [];
+    for (const line of lines) {
+      try {
+        events.push(JSON.parse(line));
+      } catch {
+      }
+    }
+    return events;
+  }
 }
 export {
   GitHubClientV2

package/plugins/specweave-github/lib/github-client-v2.ts

@@ -9,7 +9,7 @@
  */
 
 import { execFileNoThrow } from '../../../src/utils/execFileNoThrow.js';
-import { GitHubIssue, GitHubMilestone } from './types';
+import { GitHubIssue, GitHubMilestone, GitHubExternalChange } from './types';
 import { SyncProfile, GitHubConfig, TimeRangePreset } from '../../../src/core/types/sync-profile';
 
 export class GitHubClientV2 {
@@ -812,4 +812,118 @@ export class GitHubClientV2 {
   private sleep(ms: number): Promise<void> {
     return new Promise((resolve) => setTimeout(resolve, ms));
   }
+
+  // ==========================================================================
+  // Pull Sync - External Change Detection (Increment 0089)
+  // ==========================================================================
+
+  /**
+   * Fetch recently changed issues for pull sync
+   *
+   * Uses GitHub Issues API with `since` parameter to find issues
+   * that have been updated since a given timestamp.
+   *
+   * @param since - Timestamp to query changes from
+   * @param linkedIssueNumbers - Optional list of issue numbers to filter (linked items only)
+   * @returns Array of external changes with changedAt, changedBy, and current values
+   */
+  async fetchRecentChanges(
+    since: Date,
+    linkedIssueNumbers?: number[]
+  ): Promise<GitHubExternalChange[]> {
+    // Build JQ filter for issues updated since timestamp
+    const sinceISO = since.toISOString();
+
+    // Query parameters - MUST use .[] to iterate array from GitHub API
+    const jqFilter = linkedIssueNumbers && linkedIssueNumbers.length > 0
+      ? `.[] | select(.number | IN(${linkedIssueNumbers.join(',')})) | {number, title, state, updated_at, user: .user.login, assignee: .assignee.login, labels: [.labels[].name]}`
+      : `.[] | {number, title, state, updated_at, user: .user.login, assignee: .assignee.login, labels: [.labels[].name]}`;
+
+    // Use GitHub API to fetch issues updated since timestamp
+    const result = await execFileNoThrow('gh', [
+      'api',
+      `repos/${this.fullRepo}/issues`,
+      '--method', 'GET',
+      '-f', `since=${sinceISO}`,
+      '-f', 'state=all',
+      '-f', 'sort=updated',
+      '-f', 'direction=desc',
+      '-f', 'per_page=100',
+      '--jq', jqFilter,
+    ]);
+
+    if (result.exitCode !== 0) {
+      throw new Error(
+        `Failed to fetch recent changes: ${result.stderr || result.stdout}`
+      );
+    }
+
+    // Parse NDJSON output (one JSON object per line)
+    const lines = result.stdout.trim().split('\n').filter(l => l.trim());
+    const issues: any[] = [];
+
+    for (const line of lines) {
+      try {
+        issues.push(JSON.parse(line));
+      } catch {
+        // Skip malformed lines
+      }
+    }
+
+    // Map to GitHubExternalChange format
+    const changes: GitHubExternalChange[] = issues.map(issue => ({
+      platform: 'github' as const,
+      externalId: `GH-${issue.number}`,
+      issueNumber: issue.number,
+      changedAt: issue.updated_at || new Date().toISOString(),
+      changedBy: issue.user || 'unknown',
+      changedFields: [] as Array<{ field: string; oldValue: unknown; newValue: unknown }>, // GitHub doesn't provide changelog in list API
+      currentState: {
+        status: issue.state as 'open' | 'closed',
+        labels: issue.labels || [],
+        assignee: issue.assignee || null,
+      },
+    }));
+
+    return changes;
+  }
+
+  /**
+   * Get issue events for detailed change tracking
+   *
+   * Use this for detailed changelog when needed.
+   * GET /repos/{owner}/{repo}/issues/{issue_number}/events
+   *
+   * @param issueNumber - Issue number
+   * @param perPage - Limit number of events
+   * @returns Array of events with action details
+   */
+  async getIssueEvents(issueNumber: number, perPage = 30): Promise<any[]> {
+    const result = await execFileNoThrow('gh', [
+      'api',
+      `repos/${this.fullRepo}/issues/${issueNumber}/events`,
+      '-f', `per_page=${perPage}`,
+      '--jq', '.[].{event, created_at, actor: .actor.login}',
+    ]);
+
+    if (result.exitCode !== 0) {
+      throw new Error(
+        `Failed to get issue events: ${result.stderr || result.stdout}`
+      );
+    }
+
+    // Parse NDJSON output
+    const lines = result.stdout.trim().split('\n').filter(l => l.trim());
+    const events: any[] = [];
+
+    for (const line of lines) {
+      try {
+        events.push(JSON.parse(line));
+      } catch {
+        // Skip malformed lines
+      }
+    }
+
+    return events;
+  }
 }

package/plugins/specweave-github/lib/github-spec-commit-sync.d.ts

@@ -5,7 +5,7 @@
  * This enables traceability from spec user stories to actual code changes.
  */
 import { GitCommit, GitRepository } from '../../../src/utils/git-utils.js';
-import { UserStory } from '../../../src/core/spec-task-mapper.js';
+import { UserStory } from '../../../src/core/specs/spec-task-mapper.js';
 export interface SyncOptions {
     incrementPath: string;
     dryRun?: boolean;

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

@@ -10,7 +10,7 @@ import {
 import {
   getSpecTaskMapping,
   getCompletedUserStories
-} from "../../../src/core/spec-task-mapper.js";
+} from "../../../src/core/specs/spec-task-mapper.js";
 import {
   buildUserStoryComment,
   buildCommitBatchComment,

package/plugins/specweave-github/lib/github-spec-commit-sync.ts

@@ -22,7 +22,7 @@ import {
   getCompletedUserStories,
   SpecTaskMapping,
   UserStory,
-} from '../../../src/core/spec-task-mapper.js';
+} from '../../../src/core/specs/spec-task-mapper.js';
 import {
   buildUserStoryComment,
   buildCommitBatchComment,

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

@@ -5,7 +5,7 @@ import {
   buildExternalDescription,
   hasExternalLink,
   updateSpecWithExternalLink
-} from "../../../src/core/spec-content-sync.js";
+} from "../../../src/core/specs/spec-content-sync.js";
 import { ProgressCommentBuilder } from "./progress-comment-builder.js";
 import path from "path";
 import fs from "fs/promises";

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

@@ -19,7 +19,7 @@ import {
   wasSpecModifiedSinceSync,
   SpecContent,
   ContentSyncResult,
-} from '../../../src/core/spec-content-sync.js';
+} from '../../../src/core/specs/spec-content-sync.js';
 import { ProgressCommentBuilder } from './progress-comment-builder.js';
 import path from 'path';
 import fs from 'fs/promises';

package/plugins/specweave-github/lib/types.ts

@@ -122,3 +122,24 @@ export interface ThreeLayerSyncResult {
   conflicts: string[];
   errors: string[];
 }
+
+/**
+ * External change representation for pull sync (Increment 0089)
+ */
+export interface GitHubExternalChange {
+  platform: 'github';
+  externalId: string;
+  issueNumber: number;
+  changedAt: string;        // ISO timestamp
+  changedBy: string;        // Username
+  changedFields: Array<{
+    field: string;
+    oldValue: unknown;
+    newValue: unknown;
+  }>;
+  currentState: {
+    status: 'open' | 'closed';
+    labels: string[];
+    assignee: string | null;
+  };
+}

package/plugins/specweave-infrastructure/agents/devops/AGENT.md

@@ -21,7 +21,7 @@ max_response_tokens: 2000
 Task({
   subagent_type: "specweave-infrastructure:devops:devops",
   prompt: "Deploy application to AWS ECS Fargate with Terraform and configure CI/CD pipeline with GitHub Actions",
-  model: "haiku" // optional: haiku, sonnet, opus
+  model: "opus" // default: opus (best quality)
 });
 ```
 

package/plugins/specweave-infrastructure/agents/network-engineer/AGENT.md

@@ -1,8 +1,8 @@
 ---
 name: network-engineer
 description: Expert network engineer specializing in modern cloud networking, security architectures, and performance optimization. Masters multi-cloud connectivity, service mesh, zero-trust networking, SSL/TLS, global load balancing, and advanced troubleshooting. Handles CDN optimization, network automation, and compliance. Use PROACTIVELY for network design, connectivity issues, or performance optimization.
-model: claude-haiku-4-5-20251001
-model_preference: haiku
+model: claude-opus-4-5-20251101
+model_preference: opus
 cost_profile: execution
 fallback_behavior: flexible
 max_response_tokens: 2000
@@ -24,7 +24,7 @@ You are a network engineer specializing in modern cloud networking, security, an
 Task({
   subagent_type: "specweave-infrastructure:network-engineer:network-engineer",
   prompt: "Design secure multi-cloud network architecture with zero-trust connectivity and service mesh",
-  model: "haiku" // optional: haiku, sonnet, opus
+  model: "opus" // default: opus (best quality)
 });
 ```
 

package/plugins/specweave-infrastructure/agents/observability-engineer/AGENT.md

@@ -1,8 +1,8 @@
 ---
 name: observability-engineer
 description: Production observability architect - metrics, logs, traces, SLOs. Opinionated on OpenTelemetry-first, Prometheus+Grafana stack, alert fatigue prevention. Activates for monitoring, observability, SLI/SLO, alerting, Prometheus, Grafana, tracing, logging, Datadog, New Relic.
-model: claude-sonnet-4-5-20250929
-model_preference: haiku
+model: claude-opus-4-5-20251101
+model_preference: opus
 cost_profile: execution
 fallback_behavior: flexible
 max_response_tokens: 2000

package/plugins/specweave-infrastructure/agents/performance-engineer/AGENT.md

@@ -1,8 +1,8 @@
 ---
 name: performance-engineer
 description: Expert performance engineer specializing in modern observability, application optimization, and scalable system performance. Masters OpenTelemetry, distributed tracing, load testing, multi-tier caching, Core Web Vitals, and performance monitoring. Handles end-to-end optimization, real user monitoring, and scalability patterns. Use PROACTIVELY for performance optimization, observability, or scalability challenges.
-model: claude-sonnet-4-5-20250929
-model_preference: haiku
+model: claude-opus-4-5-20251101
+model_preference: opus
 cost_profile: execution
 fallback_behavior: flexible
 max_response_tokens: 2000
@@ -24,7 +24,7 @@ You are a performance engineer specializing in modern application optimization,
 Task({
   subagent_type: "specweave-infrastructure:performance-engineer:performance-engineer",
   prompt: "Analyze and optimize API performance with distributed tracing, implement multi-tier caching, and load testing",
-  model: "haiku" // optional: haiku, sonnet, opus
+  model: "opus" // default: opus (best quality)
 });
 ```
 

package/plugins/specweave-infrastructure/agents/sre/AGENT.md

@@ -2,7 +2,7 @@
 name: sre
 description: Site Reliability Engineering expert for incident response, troubleshooting, and mitigation. Handles production incidents across UI, backend, database, infrastructure, and security layers. Performs root cause analysis, creates mitigation plans, writes post-mortems, and maintains runbooks. Activates for incident, outage, slow, down, performance, latency, error rate, 5xx, 500, 502, 503, 504, crash, memory leak, CPU spike, disk full, database deadlock, SRE, on-call, SEV1, SEV2, SEV3, production issue, debugging, root cause analysis, RCA, post-mortem, runbook, health check, service degradation, timeout, connection refused, high load, monitor, alert, p95, p99, response time, throughput, Prometheus, Grafana, Datadog, New Relic, PagerDuty, observability, logging, tracing, metrics.
 tools: Read, Bash, Grep
-model: claude-sonnet-4-5-20250929
+model: claude-opus-4-5-20251101
 model_preference: auto
 cost_profile: hybrid
 fallback_behavior: auto
@@ -25,7 +25,7 @@ When generating comprehensive incident reports that exceed 1000 lines (e.g., com
 Task({
   subagent_type: "specweave-infrastructure:sre:sre",
   prompt: "Diagnose why dashboard loading is slow (10 seconds) and provide immediate and long-term mitigation plans",
-  model: "haiku" // optional: haiku, sonnet, opus
+  model: "opus" // default: opus (best quality)
 });
 ```
 

package/plugins/specweave-jira/agents/jira-manager/AGENT.md

@@ -1,3 +1,13 @@
+---
+name: jira-manager
+description: Jira integration specialist for SpecWeave increments. Handles epic creation, bidirectional sync, task completion status updates, and cross-system consistency between SpecWeave and Jira.
+model: claude-opus-4-5-20251101
+model_preference: opus
+cost_profile: execution
+fallback_behavior: flexible
+max_response_tokens: 2000
+---
+
 # Jira Manager Agent
 
 ## 🚀 How to Invoke This Agent
@@ -10,7 +20,7 @@
 Task({
   subagent_type: "specweave-jira:jira-manager:jira-manager",
   prompt: "Create Jira epic for increment 0005 and sync all tasks from spec.md and tasks.md",
-  model: "haiku" // optional: haiku, sonnet, opus
+  model: "opus" // default: opus (best quality)
 });
 ```
 

package/plugins/specweave-jira/commands/import-projects.js

@@ -6,7 +6,7 @@ import { JiraClient } from "../../../src/integrations/jira/jira-client.js";
 import { FilterProcessor } from "../../../src/integrations/jira/filter-processor.js";
 import { mergeEnvList, getEnvValue } from "../../../src/utils/env-manager.js";
 import { consoleLogger } from "../../../src/utils/logger.js";
-import { credentialsManager } from "../../../src/core/credentials-manager.js";
+import { credentialsManager } from "../../../src/core/credentials/credentials-manager.js";
 async function importProjects(options = {}) {
   const logger = options.logger ?? consoleLogger;
   const projectRoot = process.cwd();

package/plugins/specweave-jira/commands/import-projects.ts

@@ -26,7 +26,7 @@ import { FilterProcessor, type FilterOptions } from '../../../src/integrations/j
 import { AsyncProjectLoader } from '../../../src/cli/helpers/async-project-loader.js';
 import { mergeEnvList, getEnvValue } from '../../../src/utils/env-manager.js';
 import { consoleLogger, type Logger } from '../../../src/utils/logger.js';
-import { credentialsManager } from '../../../src/core/credentials-manager.js';
+import { credentialsManager } from '../../../src/core/credentials/credentials-manager.js';
 
 export interface ImportProjectsOptions {
   filter?: 'active' | 'archived' | 'all';

package/plugins/specweave-jira/lib/jira-spec-commit-sync.d.ts

@@ -5,7 +5,7 @@
  * This enables traceability from spec user stories to actual code changes.
  */
 import { GitCommit, GitRepository } from '../../../src/utils/git-utils.js';
-import { UserStory } from '../../../src/core/spec-task-mapper.js';
+import { UserStory } from '../../../src/core/specs/spec-task-mapper.js';
 export interface JiraConfig {
     domain: string;
     email: string;

package/plugins/specweave-jira/lib/jira-spec-commit-sync.js

@@ -10,7 +10,7 @@ import {
 import {
   getSpecTaskMapping,
   getCompletedUserStories
-} from "../../../src/core/spec-task-mapper.js";
+} from "../../../src/core/specs/spec-task-mapper.js";
 import {
   buildUserStoryComment,
   buildCommitBatchComment,

package/plugins/specweave-jira/lib/jira-spec-commit-sync.ts

@@ -22,7 +22,7 @@ import {
   getCompletedUserStories,
   SpecTaskMapping,
   UserStory,
-} from '../../../src/core/spec-task-mapper.js';
+} from '../../../src/core/specs/spec-task-mapper.js';
 import {
   buildUserStoryComment,
   buildCommitBatchComment,

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

@@ -4,7 +4,7 @@ import {
   detectContentChanges,
   hasExternalLink,
   updateSpecWithExternalLink
-} from "../../../src/core/spec-content-sync.js";
+} from "../../../src/core/specs/spec-content-sync.js";
 import path from "path";
 import fs from "fs/promises";
 async function syncSpecContentToJira(options) {

package/plugins/specweave-jira/lib/jira-spec-content-sync.ts

@@ -18,7 +18,7 @@ import {
   updateSpecWithExternalLink,
   SpecContent,
   ContentSyncResult,
-} from '../../../src/core/spec-content-sync.js';
+} from '../../../src/core/specs/spec-content-sync.js';
 import path from 'path';
 import fs from 'fs/promises';
 

package/plugins/specweave-jira/lib/setup-wizard.js

@@ -1,6 +1,6 @@
 import { confirm, select, input, password } from "@inquirer/prompts";
-import { credentialsManager } from "../../../src/core/credentials-manager.js";
-import { JiraCredentials as JiraCredentials2 } from "../../../src/core/credentials-manager.js";
+import { credentialsManager } from "../../../src/core/credentials/credentials-manager.js";
+import { JiraCredentials as JiraCredentials2 } from "../../../src/core/credentials/credentials-manager.js";
 async function detectJiraCredentials() {
   if (credentialsManager.hasJiraCredentials()) {
     try {