specweave 0.34.5 → 0.34.8

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

@@ -1,6 +1,6 @@
 ---
 name: sw:living-docs
-description: Launch or resume Living Docs Builder independently. Generates documentation from codebase analysis with AI-powered insights.
+description: Launch or resume Living Docs Builder independently. Generates comprehensive enterprise documentation from codebase analysis with AI-powered insights.
 usage: /sw:living-docs [--resume <jobId>] [--depth <level>] [--priority <modules>] [--sources <folders>] [--depends-on <jobIds>] [--foreground] [--full-scan]
 ---
 
@@ -17,6 +17,7 @@ Launch the Living Docs Builder independently of `specweave init`. This is essent
 - **On-demand analysis** - Re-analyze codebase after major changes
 - **Large brownfield projects** - Run targeted analysis on specific modules
 - **CI/CD integration** - Automate documentation generation
+- **Enterprise knowledge base** - Generate comprehensive "wikipedia-style" documentation of your entire organization
 
 ---
 
@@ -32,7 +33,7 @@ Launch the Living Docs Builder independently of `specweave init`. This is essent
 | `--depends-on <jobIds>` | Wait for jobs before starting (comma-separated) |
 | `--foreground` | Run in current session instead of background |
 | `--force` | Force run even for greenfield projects |
-| `--full-scan` | **Force full deep scan** - All phases (repos, org, arch, inconsistencies, strategy) |
+| `--full-scan` | **Force full enterprise scan** - All 8 phases including enterprise KB, delivery/ops docs, diagrams |
 
 ---
 
@@ -67,16 +68,17 @@ Launch the Living Docs Builder independently of `specweave init`. This is essent
 ### Quick Analysis (Non-Interactive)
 
 ```bash
-# Quick scan - 5-10 minutes
+# Quick scan - basic structure + imports + tech detection + inconsistencies
 /sw:living-docs --depth quick
 
-# Standard analysis - 15-30 minutes
+# Standard analysis - modules + dependencies + relationships + diagrams
 /sw:living-docs --depth standard --priority auth,payments
 
 # AI-powered deep analysis (FREE with MAX subscription)
 /sw:living-docs --depth deep-native --priority core,api
 
-# Force FULL deep scan (all phases: repos, org, arch, inconsistencies, strategy)
+# FULL ENTERPRISE SCAN - All 8 phases (A through H)
+# Generates complete knowledge base: company history, team structure, delivery docs, diagrams
 /sw:living-docs --full-scan
 ```
 
@@ -84,53 +86,131 @@ Launch the Living Docs Builder independently of `specweave init`. This is essent
 
 ## Analysis Depths
 
-| Depth | Duration | What It Does | Cost |
-|-------|----------|--------------|------|
-| `quick` | ~5-10 min | Structure scan + tech detection + imports map | Free |
-| `standard` | ~15-30 min | Module analysis + exports + dependencies | Free |
-| `deep-native` | Progress-based | ⭐ AI analysis using your MAX subscription - NO EXTRA COST! | FREE (MAX) |
-| `deep-interactive` | Session-based | AI analysis in current Claude Code session (pause/resume) | FREE (MAX) |
+| Depth | Scope | What It Does | Cost |
+|-------|-------|--------------|------|
+| `quick` | Core analysis | Structure scan + tech detection + imports map + inconsistency detection + basic diagrams | Free |
+| `standard` | Full module analysis | Module deep-dive + exports + dependencies + relationships + team detection + Mermaid diagrams | Free |
+| `deep-native` | Intelligent analysis | ⭐ AI-powered understanding: purpose extraction, pattern recognition, organization synthesis | FREE (MAX) |
+| `deep-interactive` | Enterprise knowledge | AI analysis in current session with full enterprise KB generation (checkpoint/resume) | FREE (MAX) |
 
-### Full Scan Mode (--full-scan)
+### Quick Depth Features (Expanded)
 
-**What it does**: Forces a comprehensive deep analysis with ALL phases, regardless of brownfield detection.
+Quick mode now includes:
+- File structure discovery across all repos
+- Technology stack detection (frameworks, languages, tools)
+- Import/export dependency mapping
+- **Basic inconsistency detection** (duplicates, naming issues)
+- **Basic Mermaid diagrams** (module structure, imports)
+- External specification loading (GitHub/JIRA/ADO imports)
+
+### Standard Depth Features (Expanded)
+
+Standard mode adds:
+- Deep module analysis with exports/APIs
+- Cross-module dependency graphs
+- **Team structure inference** from code ownership
+- **Relationship mapping** (feature-to-code, team-to-features)
+- **Full Mermaid diagram suite** (org charts, dependencies, timelines)
+- Basic architecture detection (patterns, ADR candidates)
+- Spec-code gap detection
+
+### Full Scan Mode (--full-scan) - Enterprise Knowledge Base
+
+**What it does**: Forces a comprehensive deep analysis through **ALL 8 PHASES (A-H)**, generating a complete enterprise knowledge base that serves as a "living wikipedia" for your organization.
 
 **When to use**:
 - Initial setup - want complete documentation structure
 - After major refactoring - need fresh analysis of everything
 - Imported external repos - want full org structure, inconsistencies, strategy docs
-- Complete living docs - need `review-needed/` and `strategy/` folders populated
+- Enterprise documentation - need company history, team directory, delivery docs
+- Complete living docs - all folders populated with cross-referenced documentation
 
-**What you get** (beyond standard depths):
+**Duration**: Variable based on project size and complexity. For large enterprise projects (50+ repos, 247+ microservices), **expect this to run over multiple sessions spanning days or weeks**. The checkpoint/resume system ensures no work is lost.
+
+**What you get** (complete enterprise knowledge base):
 ```
 .specweave/docs/internal/
-├── repos/                      # All repos analyzed (Phase B)
+├── repos/                      # Per-repo analysis (Phase B)
 │   └── {repo-name}/
-│       ├── overview.md
-│       └── api-surface.md
+│       ├── overview.md         # Purpose, key concepts, patterns
+│       └── api-surface.md      # All public APIs documented
+│
 ├── organization/               # Team structure (Phase C)
 │   ├── teams/
-│   └── org-chart.mmd
+│   │   └── {team-name}.md      # Responsibilities, expertise, tech stack
+│   ├── microservices/          # Service boundaries
+│   ├── domains/                # Domain groupings
+│   └── org-synthesis.md        # Organization overview
+│
 ├── architecture/               # System architecture (Phase D)
-│   ├── adr/                   # Auto-detected ADRs
-│   └── system-architecture.md
-├── review-needed/              # Inconsistencies (Phase E) ✨
-│   ├── questions-for-cto.md
-│   ├── questions-for-po.md
-│   └── inconsistencies.md
-└── strategy/                   # Strategic recommendations (Phase F) ✨
-    ├── tech-debt-catalog.md
-    ├── modernization-candidates.md
-    └── recommendations.md
+│   ├── adr/                    # Auto-detected ADRs with evidence
+│   │   └── 0001-pattern-name.md
+│   ├── system-architecture.md  # High-level architecture
+│   └── c4-diagrams/            # C4 model diagrams
+│
+├── review-needed/              # Categorized issues (Phase E) ✨
+│   ├── index.md                # Overview with priority summary
+│   ├── CRITICAL-ISSUES.md      # P0: Must fix immediately
+│   ├── BROKEN-LINKS.md         # All broken references
+│   ├── SPEC-CODE-GAPS.md       # Ghost completions, missing impl
+│   ├── ORPHANED-DOCS.md        # Docs without owners
+│   └── tech-debt-catalog.md    # Categorized tech debt
+│
+├── strategy/                   # Strategic recommendations (Phase F) ✨
+│   ├── recommendations.md      # Prioritized action items
+│   ├── modernization.md        # Migration/upgrade candidates
+│   └── risk-assessment.md      # Security and compliance risks
+│
+├── enterprise/                 # Enterprise KB (Phase G) ✨✨ NEW
+│   ├── COMPANY-HISTORY.md      # Timeline of project evolution
+│   ├── FEATURE-CATALOG.md      # All features with status/ownership
+│   ├── TEAM-DIRECTORY.md       # Team roster with expertise areas
+│   └── PROJECT-METRICS.md      # Stats: features, completions, velocity
+│
+├── delivery/                   # Delivery documentation (Phase G) ✨✨ NEW
+│   ├── RELEASE-HISTORY.md      # All releases with changelogs
+│   ├── CI-CD-PIPELINE.md       # Pipeline documentation
+│   ├── DEPLOYMENT-GUIDE.md     # How to deploy
+│   └── ENVIRONMENTS.md         # Environment configurations
+│
+├── operations/                 # Ops documentation (Phase G) ✨✨ NEW
+│   ├── RUNBOOKS.md             # Operational procedures
+│   ├── MONITORING.md           # What to monitor
+│   ├── INCIDENT-HISTORY.md     # Past incidents (if any)
+│   └── SLA-TRACKING.md         # Service level targets
+│
+├── relationships/              # Cross-references (Phase G) ✨✨ NEW
+│   ├── FEATURE-TO-CODE.md      # Feature → file mappings
+│   ├── TEAM-TO-FEATURES.md     # Team → owned features
+│   ├── MODULE-DEPENDENCIES.md  # Module → module deps
+│   └── EXTERNAL-REFS.md        # External tool linkages
+│
+└── diagrams/                   # Mermaid diagrams (Phase H) ✨✨ NEW
+    ├── feature-hierarchy.md    # Feature tree visualization
+    ├── team-org-chart.md       # Team structure
+    ├── module-dependencies.md  # Dependency graph
+    ├── project-timeline.md     # Gantt chart of evolution
+    ├── system-architecture.md  # C4 context diagram
+    └── feature-status.md       # Pie chart of completion
 ```
 
 **Command**:
 ```bash
 /sw:living-docs --full-scan
 
-# Uses deep-native if Claude MAX available, otherwise fails with error
-# Runs ALL phases: B → C → D → E → F
-# Duration: Variable (depends on project size)
+# Uses deep-native (Claude MAX) for AI-powered analysis
+# Runs ALL 8 phases: A → B → C → D → E → F → G → H
+# Checkpoint/resume: Can stop and continue from any phase
+# Enterprise projects: May take multiple sessions (days/weeks)
+```
+
+**Resume after interruption**:
+```bash
+# Check progress
+/sw:jobs
+
+# Resume from checkpoint (all previous work preserved)
+/sw:living-docs --resume <jobId>
 ```
 
 ### Deep-Native (Recommended for MAX Users)
@@ -150,6 +230,27 @@ Uses your Claude MAX subscription via `claude --print`:
 
 ---
 
+## The 8 Phases of Enterprise Analysis
+
+Full scan (`--full-scan`) executes all 8 phases sequentially with checkpoint/resume support:
+
+| Phase | Name | What It Does | Output |
+|-------|------|--------------|--------|
+| **A** | Discovery | Scan file structure, detect repos, identify entry points | Internal state |
+| **B** | Deep Analysis | AI-powered per-repo understanding: purpose, concepts, APIs, patterns | `repos/{name}/overview.md`, `api-surface.md` |
+| **C** | Org Synthesis | Infer team structure, microservices, domains from code patterns | `organization/teams/`, `microservices/`, `domains/` |
+| **D** | Architecture | Detect architectural decisions, generate ADRs, system diagrams | `architecture/adr/`, `system-architecture.md` |
+| **E** | Inconsistencies | Find issues: broken links, spec-code gaps, orphaned docs, duplicates | `review-needed/CRITICAL-ISSUES.md`, `BROKEN-LINKS.md`, etc. |
+| **F** | Strategy | Generate recommendations, tech debt catalog, modernization roadmap | `strategy/recommendations.md`, `tech-debt-catalog.md` |
+| **G** | Enterprise | Build knowledge base: history, feature catalog, delivery docs, runbooks | `enterprise/`, `delivery/`, `operations/`, `relationships/` |
+| **H** | Diagrams | Generate Mermaid visualizations: org charts, dependencies, timelines | `diagrams/*.md` |
+
+**Checkpoint/Resume**: Each phase completion is checkpointed. If interrupted, resume continues from the last completed phase - no work is lost.
+
+**Enterprise Scale**: For large organizations (50+ repos), phases B-G may each take significant time. The system is designed for long-running analysis that spans multiple sessions.
+
+---
+
 ## Implementation Steps
 
 When this command is invoked:
@@ -307,7 +408,9 @@ After completion, you'll see a detailed summary showing:
 
 ## Output Files
 
-After completion:
+After completion (varies by depth):
+
+### Core Output (All Depths)
 
 | File | Description |
 |------|-------------|
@@ -317,6 +420,26 @@ After completion:
 | `.specweave/docs/overview/TECH-STACK.md` | Detected technologies and frameworks |
 | `.specweave/docs/modules/*.md` | Per-module documentation |
 
+### Standard+ Output
+
+| Folder | Description |
+|--------|-------------|
+| `.specweave/docs/internal/organization/` | Team structure, microservices, domains |
+| `.specweave/docs/internal/relationships/` | Feature-to-code, team-to-features mappings |
+| `.specweave/docs/internal/diagrams/` | Mermaid diagrams for visual navigation |
+
+### Full Scan Output (Enterprise KB)
+
+| Folder | Description |
+|--------|-------------|
+| `.specweave/docs/internal/repos/` | Per-repo deep analysis with APIs |
+| `.specweave/docs/internal/architecture/` | ADRs, system architecture, C4 diagrams |
+| `.specweave/docs/internal/review-needed/` | Categorized issues (P0-P3) with remediation |
+| `.specweave/docs/internal/strategy/` | Recommendations, modernization, risk assessment |
+| `.specweave/docs/internal/enterprise/` | Company history, feature catalog, team directory |
+| `.specweave/docs/internal/delivery/` | CI/CD, releases, deployment guides |
+| `.specweave/docs/internal/operations/` | Runbooks, monitoring, SLAs |
+
 ---
 
 ## Examples
@@ -339,16 +462,22 @@ After completion:
 #    Continuing from: payments-service
 ```
 
-### Example 2: Large Brownfield (247 repos)
+### Example 2: Large Enterprise (247 repos)
 
 ```bash
-# Focus on critical modules first
-/sw:living-docs --depth deep-native \
-  --priority auth,payments,billing,core \
-  --depends-on clone-main123
+# Full enterprise scan - generates complete knowledge base
+# For large projects, this runs across multiple sessions
+/sw:living-docs --full-scan --depends-on clone-main123
 
-# Monitor in another terminal
+# Monitor progress (runs in background, survives terminal close)
 /sw:jobs --follow ldb-xyz789
+
+# Resume after interruption (all progress preserved)
+/sw:living-docs --resume ldb-xyz789
+
+# Alternatively: Focus on critical modules first (faster initial pass)
+/sw:living-docs --depth standard \
+  --priority auth,payments,billing,core
 ```
 
 ### Example 3: CI/CD Integration

package/plugins/specweave-github/lib/github-feature-sync.js

@@ -243,7 +243,7 @@ const _GitHubFeatureSync = class _GitHubFeatureSync {
     const title = `${featureData.id}: ${featureData.title}`;
     const existingResult = await execFileNoThrow("gh", [
       "api",
-      "repos/:owner/:repo/milestones",
+      "repos/:owner/:repo/milestones?per_page=100&state=all",
       "--jq",
       `.[] | select(.title == "${title}") | {number, html_url}`
     ], { env: this.getGhEnv() });

package/plugins/specweave-github/lib/github-feature-sync.ts

@@ -403,9 +403,11 @@ export class GitHubFeatureSync {
     const title = `${featureData.id}: ${featureData.title}`;
 
     // CRITICAL: Check if milestone already exists before creating
+    // NOTE: Must use per_page=100 to handle repos with 30+ milestones (GitHub default is 30)
+    // BUG FIX: Without pagination, milestone #31+ won't be found → false "not found" → HTTP 422 duplicate error
     const existingResult = await execFileNoThrow('gh', [
       'api',
-      'repos/:owner/:repo/milestones',
+      'repos/:owner/:repo/milestones?per_page=100&state=all',
       '--jq',
       `.[] | select(.title == "${title}") | {number, html_url}`,
     ], { env: this.getGhEnv() });

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

@@ -42,7 +42,7 @@ class GitHubSpecSync {
     if (!project) {
       return null;
     }
-    const profileId = project.defaultSyncProfile || config.activeProfile;
+    const profileId = project.defaultSyncProfile || config.defaultProfile;
     if (!profileId) {
       return null;
     }

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

@@ -143,7 +143,7 @@ export class GitHubSpecSync {
     }
 
     // Get profile from project's default sync profile
-    const profileId = project.defaultSyncProfile || config.activeProfile;
+    const profileId = project.defaultSyncProfile || config.defaultProfile;
     if (!profileId) {
       return null;
     }

package/dist/plugins/specweave-github/lib/github-sync-bidirectional.d.ts

@@ -1,45 +0,0 @@
-/**
- * Bidirectional GitHub Sync
- *
- * @deprecated This module is deprecated as of v0.24.0 (Three-Permission Architecture).
- * The "bidirectional" terminology has been replaced with granular permission controls:
- * - canUpsertInternalItems: CREATE + UPDATE internal items
- * - canUpdateExternalItems: UPDATE external items (full content)
- * - canUpdateStatus: UPDATE status (both types)
- *
- * This file is kept for backward compatibility but is no longer actively maintained.
- * See: .specweave/increments/0047-us-task-linkage/reports/THREE-PERMISSION-ARCHITECTURE-CHANGES.md
- *
- * Syncs state from GitHub back to SpecWeave.
- * Handles issue state changes, comments, assignees, labels, milestones.
- *
- * @module github-sync-bidirectional
- */
-export interface GitHubIssueState {
-    number: number;
-    title: string;
-    body: string;
-    state: 'open' | 'closed';
-    labels: string[];
-    assignees: string[];
-    milestone?: string;
-    comments: GitHubComment[];
-    updated_at: string;
-}
-export interface GitHubComment {
-    id: number;
-    author: string;
-    body: string;
-    created_at: string;
-}
-export interface SyncConflict {
-    type: 'status' | 'assignee' | 'label';
-    githubValue: any;
-    specweaveValue: any;
-    resolution: 'github-wins' | 'specweave-wins' | 'prompt';
-}
-/**
- * Sync from GitHub to SpecWeave
- */
-export declare function syncFromGitHub(incrementId: string): Promise<void>;
-//# sourceMappingURL=github-sync-bidirectional.d.ts.map

package/dist/plugins/specweave-github/lib/github-sync-bidirectional.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"github-sync-bidirectional.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-sync-bidirectional.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAsBH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;IACtC,WAAW,EAAE,GAAG,CAAC;IACjB,cAAc,EAAE,GAAG,CAAC;IACpB,UAAU,EAAE,aAAa,GAAG,gBAAgB,GAAG,QAAQ,CAAC;CACzD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDvE"}

package/dist/plugins/specweave-github/lib/github-sync-bidirectional.js

@@ -1,247 +0,0 @@
-/**
- * Bidirectional GitHub Sync
- *
- * @deprecated This module is deprecated as of v0.24.0 (Three-Permission Architecture).
- * The "bidirectional" terminology has been replaced with granular permission controls:
- * - canUpsertInternalItems: CREATE + UPDATE internal items
- * - canUpdateExternalItems: UPDATE external items (full content)
- * - canUpdateStatus: UPDATE status (both types)
- *
- * This file is kept for backward compatibility but is no longer actively maintained.
- * See: .specweave/increments/0047-us-task-linkage/reports/THREE-PERMISSION-ARCHITECTURE-CHANGES.md
- *
- * Syncs state from GitHub back to SpecWeave.
- * Handles issue state changes, comments, assignees, labels, milestones.
- *
- * @module github-sync-bidirectional
- */
-import * as fs from '../../../src/utils/fs-native.js';
-import path from 'path';
-import { execFileNoThrow } from '../../../src/utils/execFileNoThrow.js';
-import { loadIncrementMetadata, detectRepo } from './github-issue-updater.js';
-import { getGitHubAuthFromProject } from '../../../src/utils/auth-helpers.js';
-/**
- * Get environment object with GH_TOKEN for gh CLI commands.
- */
-function getGhEnv() {
-    const { token } = getGitHubAuthFromProject(process.cwd());
-    return token
-        ? { ...process.env, GH_TOKEN: token }
-        : process.env;
-}
-/**
- * Sync from GitHub to SpecWeave
- */
-export async function syncFromGitHub(incrementId) {
-    console.log(`\n🔄 Syncing from GitHub for increment: ${incrementId}`);
-    try {
-        // 1. Load metadata
-        const metadata = await loadIncrementMetadata(incrementId);
-        if (!metadata?.github?.issue) {
-            console.log('ℹ️  No GitHub issue linked, nothing to sync');
-            return;
-        }
-        // 2. Detect repository
-        const repoInfo = await detectRepo();
-        if (!repoInfo) {
-            console.log('⚠️  Could not detect GitHub repository');
-            return;
-        }
-        const { owner, repo } = repoInfo;
-        const issueNumber = metadata.github.issue;
-        console.log(`   Syncing from ${owner}/${repo}#${issueNumber}`);
-        // 3. Fetch current GitHub state
-        const githubState = await fetchGitHubIssueState(issueNumber, owner, repo);
-        // 4. Compare with local state
-        const conflicts = detectConflicts(metadata, githubState);
-        if (conflicts.length === 0) {
-            console.log('✅ No conflicts - GitHub and SpecWeave in sync');
-            return;
-        }
-        console.log(`⚠️  Detected ${conflicts.length} conflict(s)`);
-        // 5. Resolve conflicts
-        await resolveConflicts(incrementId, metadata, githubState, conflicts);
-        // 6. Sync comments
-        await syncComments(incrementId, githubState.comments);
-        // 7. Update metadata
-        await updateMetadata(incrementId, githubState);
-        console.log('✅ Three-permission sync complete');
-    }
-    catch (error) {
-        console.error('❌ Error syncing from GitHub:', error);
-        throw error;
-    }
-}
-/**
- * Fetch current GitHub issue state
- */
-async function fetchGitHubIssueState(issueNumber, owner, repo) {
-    // Fetch issue details
-    const issueResult = await execFileNoThrow('gh', [
-        'issue',
-        'view',
-        String(issueNumber),
-        '--repo',
-        `${owner}/${repo}`,
-        '--json',
-        'number,title,body,state,labels,assignees,milestone,updatedAt'
-    ], { env: getGhEnv() });
-    if (issueResult.exitCode !== 0) {
-        throw new Error(`Failed to fetch issue: ${issueResult.stderr}`);
-    }
-    const issue = JSON.parse(issueResult.stdout);
-    // Fetch comments
-    const commentsResult = await execFileNoThrow('gh', [
-        'api',
-        `repos/${owner}/${repo}/issues/${issueNumber}/comments`,
-        '--jq',
-        '.[] | {id: .id, author: .user.login, body: .body, created_at: .created_at}'
-    ], { env: getGhEnv() });
-    let comments = [];
-    if (commentsResult.exitCode === 0 && commentsResult.stdout.trim()) {
-        const commentLines = commentsResult.stdout.trim().split('\n');
-        comments = commentLines.map(line => JSON.parse(line));
-    }
-    return {
-        number: issue.number,
-        title: issue.title,
-        body: issue.body,
-        state: issue.state,
-        labels: issue.labels?.map((l) => l.name) || [],
-        assignees: issue.assignees?.map((a) => a.login) || [],
-        milestone: issue.milestone?.title,
-        comments,
-        updated_at: issue.updatedAt
-    };
-}
-/**
- * Detect conflicts between GitHub and SpecWeave
- */
-function detectConflicts(metadata, githubState) {
-    const conflicts = [];
-    // Status conflict
-    const specweaveStatus = metadata.status; // "active", "completed", "paused", "abandoned"
-    const githubStatus = githubState.state; // "open", "closed"
-    const expectedGitHubStatus = mapSpecWeaveStatusToGitHub(specweaveStatus);
-    if (githubStatus !== expectedGitHubStatus) {
-        conflicts.push({
-            type: 'status',
-            githubValue: githubStatus,
-            specweaveValue: specweaveStatus,
-            resolution: 'prompt' // Ask user
-        });
-    }
-    // TODO: Add assignee/label conflicts if needed in future
-    return conflicts;
-}
-/**
- * Resolve conflicts
- */
-async function resolveConflicts(incrementId, metadata, githubState, conflicts) {
-    for (const conflict of conflicts) {
-        console.log(`\n⚠️  Conflict detected: ${conflict.type}`);
-        console.log(`   GitHub: ${conflict.githubValue}`);
-        console.log(`   SpecWeave: ${conflict.specweaveValue}`);
-        if (conflict.type === 'status') {
-            await resolveStatusConflict(incrementId, metadata, githubState);
-        }
-    }
-}
-/**
- * Resolve status conflict
- */
-async function resolveStatusConflict(incrementId, metadata, githubState) {
-    const specweaveStatus = metadata.status;
-    const githubStatus = githubState.state;
-    // GitHub closed but SpecWeave active
-    if (githubStatus === 'closed' && specweaveStatus === 'active') {
-        console.log(`\n⚠️  **CONFLICT**: GitHub issue closed but SpecWeave increment still active!`);
-        console.log(`   Recommendation: Run /sw:done ${incrementId} to close increment`);
-        console.log(`   Or reopen issue on GitHub if work is not complete`);
-    }
-    // GitHub open but SpecWeave completed
-    if (githubStatus === 'open' && specweaveStatus === 'completed') {
-        console.log(`\n⚠️  **CONFLICT**: SpecWeave increment completed but GitHub issue still open!`);
-        console.log(`   Recommendation: Close GitHub issue #${metadata.github.issue}`);
-    }
-    // GitHub open but SpecWeave paused
-    if (githubStatus === 'open' && specweaveStatus === 'paused') {
-        console.log(`\nℹ️  GitHub issue open, SpecWeave increment paused (OK)`);
-    }
-    // GitHub open but SpecWeave abandoned
-    if (githubStatus === 'open' && specweaveStatus === 'abandoned') {
-        console.log(`\n⚠️  **CONFLICT**: SpecWeave increment abandoned but GitHub issue still open!`);
-        console.log(`   Recommendation: Close GitHub issue #${metadata.github.issue} with reason`);
-    }
-}
-/**
- * Sync comments from GitHub to SpecWeave
- */
-async function syncComments(incrementId, comments) {
-    if (comments.length === 0) {
-        console.log('ℹ️  No comments to sync');
-        return;
-    }
-    const commentsPath = path.join(process.cwd(), '.specweave/increments', incrementId, 'logs/github-comments.md');
-    await fs.ensureFile(commentsPath);
-    // Load existing comments
-    let existingContent = '';
-    if (await fs.pathExists(commentsPath)) {
-        existingContent = await fs.readFile(commentsPath, 'utf-8');
-    }
-    // Extract existing comment IDs
-    const existingIds = new Set();
-    const idMatches = existingContent.matchAll(/<!-- comment-id: (\d+) -->/g);
-    for (const match of idMatches) {
-        existingIds.add(parseInt(match[1], 10));
-    }
-    // Append new comments
-    const newComments = comments.filter(c => !existingIds.has(c.id));
-    if (newComments.length === 0) {
-        console.log('ℹ️  All comments already synced');
-        return;
-    }
-    console.log(`📝 Syncing ${newComments.length} new comment(s)`);
-    const commentsMarkdown = newComments.map(comment => `
----
-
-<!-- comment-id: ${comment.id} -->
-
-**Author**: @${comment.author}
-**Date**: ${new Date(comment.created_at).toLocaleString()}
-
-${comment.body}
-`.trim()).join('\n\n');
-    await fs.appendFile(commentsPath, (existingContent ? '\n\n' : '') + commentsMarkdown);
-    console.log(`✅ Comments saved to: logs/github-comments.md`);
-}
-/**
- * Update metadata with GitHub state
- */
-async function updateMetadata(incrementId, githubState) {
-    const metadataPath = path.join(process.cwd(), '.specweave/increments', incrementId, 'metadata.json');
-    const metadata = await fs.readJson(metadataPath);
-    // Update GitHub section
-    metadata.github = metadata.github || {};
-    metadata.github.synced = new Date().toISOString();
-    metadata.github.lastUpdated = githubState.updated_at;
-    metadata.github.state = githubState.state;
-    await fs.writeJson(metadataPath, metadata, { spaces: 2 });
-    console.log('✅ Metadata updated');
-}
-/**
- * Map SpecWeave status to GitHub state
- */
-function mapSpecWeaveStatusToGitHub(status) {
-    switch (status) {
-        case 'completed':
-        case 'abandoned':
-            return 'closed';
-        case 'active':
-        case 'paused':
-        case 'planning':
-        default:
-            return 'open';
-    }
-}
-//# sourceMappingURL=github-sync-bidirectional.js.map

package/dist/plugins/specweave-github/lib/github-sync-bidirectional.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"github-sync-bidirectional.js","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-sync-bidirectional.ts"],"names":[],"mappings":"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"}