specweave 1.0.235 → 1.0.239

package/README.md

@@ -1,14 +1,13 @@
 # SpecWeave
 
-**The Enterprise Layer for AI Coding.**
+**The spec-driven framework for Claude Code and OpenClaw.**
 
-*Permanent memory, GitHub/JIRA sync, quality gates, autonomous execution. Powered by Claude Opus 4.6. Ship features while you sleep.*
+*Coordinate parallel AI agents. Prevent task overlap. Quality gates. Ship features while you sleep.*
 
 [![NPM Version](https://img.shields.io/npm/v/specweave?color=brightgreen)](https://www.npmjs.com/package/specweave)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Test & Validate](https://github.com/anton-abyzov/specweave/actions/workflows/test.yml/badge.svg?branch=develop)](https://github.com/anton-abyzov/specweave/actions/workflows/test.yml)
 [![Discord](https://img.shields.io/badge/Discord-Join-5865F2?logo=discord&logoColor=white)](https://discord.gg/UYg4BGJ65V)
-[![YouTube](https://img.shields.io/badge/YouTube-Tutorials-red?logo=youtube&logoColor=white)](https://www.youtube.com/@antonabyzov)
 
 ```bash
 npm install -g specweave   # Requires Node.js 20.12.0+
@@ -19,173 +18,97 @@ npm install -g specweave   # Requires Node.js 20.12.0+
 ## Quick Demo
 
 ```bash
-/sw:increment "User authentication"
-/sw:auto                              # Ship while you sleep
+/sw:increment "User authentication"   # AI creates spec + plan + tasks
+/sw:auto                               # Autonomous execution for hours
+/sw:grill 0001                         # Senior-level code review
+/sw:done 0001                          # Validate and complete
 ```
 
-**What happens:**
-- AI creates spec + plan + tasks
-- Executes autonomously for **hours**
-- Tests, fixes failures, syncs to GitHub/JIRA
-- You review finished work
-
-```
-[08:23:41] [Planning]      Analyzing T-003: Implement refresh token rotation
-[08:24:12] [Implementing]  Writing src/auth/token-manager.ts
-[08:25:33] [Testing]       Running tests... FAILED
-[08:25:47] [Fixing]        Adjusting implementation...
-[08:26:15] [Testing]       Re-running... PASSED
-[08:26:22] [Done]          T-003 complete. Moving to T-004...
-```
+**What happens:** Claude creates a full specification, executes tasks autonomously, runs tests, fixes failures, and syncs progress to GitHub/JIRA. You review finished work.
 
 ---
 
 ## Why SpecWeave?
 
-Every AI coding tool loses context when the chat ends. SpecWeave creates **permanent documentation**:
-
-```
-.specweave/increments/0001-oauth/
-├── spec.md    <- WHAT: User stories, acceptance criteria
-├── plan.md    <- HOW: Architecture decisions, tech choices
-└── tasks.md   <- DO: Implementation tasks with tests
-```
-
-**After 6 months**: Search "OAuth" → find exact decisions, who approved, why it was built that way.
-
----
-
-## Key Differentiators
-
-### Lazy Plugin Loading (99% Token Savings)
-
-SpecWeave loads plugins **on-demand** based on your prompt keywords:
-
-| Scenario | Without Lazy Loading | With Lazy Loading |
-|----------|---------------------|-------------------|
-| Non-SpecWeave work | ~60k tokens | ~500 tokens |
-| SpecWeave work | ~60k tokens | ~60k (when needed) |
-
-Say "React frontend" → frontend plugin loads. Say "Kubernetes deploy" → k8s plugin loads. No manual configuration.
-
-### Self-Improving Skills
-
-SpecWeave learns from corrections. When you fix something, it captures the learning:
-
-```markdown
-## Skill Memories
-<!-- Auto-captured by SpecWeave reflect -->
-- Always use `vi.hoisted()` for ESM mocking in Vitest 4.x+
-- Prefer native `fs` over fs-extra in new code
-```
-
-Next time, it won't make the same mistake.
-
-### Structured Documentation (No Root Bloat)
+AI coding agents are powerful individually. Run three of them on the same codebase and you get conflicts, duplicated work, and zero traceability.
 
-Everything stays organized in `.specweave/`:
+SpecWeave solves this with **file-based coordination**:
 
 ```
-.specweave/
-├── increments/####-name/     # Feature specs + tasks
-├── docs/internal/            # Living documentation
-│   ├── architecture/adr/     # Architecture Decision Records
-│   └── specs/                # Feature specifications
-└── config.json               # Project configuration
+.specweave/increments/0001-oauth/
+├── spec.md    ← WHAT: User stories, acceptance criteria
+├── plan.md    ← HOW: Architecture decisions, tech choices
+└── tasks.md   ← DO: Implementation tasks with tests
 ```
 
-Your project root stays clean. No scattered markdown files.
+Each increment is a self-contained scope. Each agent knows exactly what's taken and what's available. No overlap. No conflicts. Six months later, search "OAuth" and find exactly what was decided, who approved it, and why.
 
-### Deep Interview Mode (NEW)
+### What Makes It Different
 
-For complex features, enable **Deep Interview Mode** during init. Claude asks 40+ questions about architecture, integrations, UI/UX, and tradeoffs before creating specifications:
+- **Parallel agent coordination** — multiple Claude Code sessions, OpenClaw instances, or remote agents work on different increments without stepping on each other.
+- **Autonomous execution** — runs for hours, not minutes. Write, test, fix, repeat.
+- **Persistent memory** — AI learns from corrections. Fix once, remembered permanently.
+- **Quality gates** — Code Grill reviews code like a demanding senior engineer before every release.
+- **Living documentation** — specs, ADRs, and runbooks sync automatically after every task.
+- **100+ specialized skills** — PM, Architect, QA, Security, DevOps, Frontend, Mobile, ML, and more collaborate on deliverables.
+- **External sync** — GitHub Issues, JIRA, Azure DevOps — bidirectional, real-time.
+- **Self-improving** — captures what works and what doesn't. Gets smarter over time.
+- **LSP integration** — semantic code intelligence for TypeScript, Python, Go, Rust, Java, C#.
 
-```
-Deep Interview Mode
+---
 
-For big features, Claude can ask 40+ questions about architecture,
-integrations, UI/UX, and tradeoffs before creating specifications.
+## Install
 
-Enable Deep Interview Mode? [y/N]
+```bash
+npm install -g specweave
+cd your-project
+specweave init .
 ```
 
-Inspired by [Thariq's workflow](https://x.com/trq212/status/2005315275026260309) (Claude Code creator): *"For big features Claude might ask me 40+ questions and I end up with a much more detailed spec."*
-
-### 68+ AI Agents Working Together
-
-| Agent | Role |
-|-------|------|
-| **PM** | Requirements, user stories, acceptance criteria |
-| **Architect** | System design, ADRs, tech decisions |
-| **QA Lead** | Test strategy, quality gates |
-| **Security** | OWASP review, vulnerability scanning |
-| **DevOps** | CI/CD, infrastructure, deployment |
-
-Agents auto-activate based on context. Mention "security" → security expertise loads. Best results with Claude Opus 4.6 and Sonnet 4.5.
-
-### LSP Integration (100x Faster Code Understanding)
-
-SpecWeave leverages **Language Server Protocol** for semantic code intelligence:
-
-| Operation | Without LSP | With LSP |
-|-----------|-------------|----------|
-| Find all references | Grep + read 15 files (~10K tokens) | Semantic query (~500 tokens) |
-| Check type errors | Build + parse output (~5K tokens) | getDiagnostics (~1K tokens) |
-| Navigate to definition | Grep + verify (~8K tokens) | goToDefinition (~200 tokens) |
-
-**LSP plugins work automatically** when editing code. Edit a `.cs` file → `csharp-lsp` activates. Edit `.ts` → `typescript-lsp` activates. No configuration needed.
-
+Then in Claude Code:
 ```bash
-# Install language servers for your stack
-npm install -g typescript-language-server typescript  # TypeScript
-pip install pyright                                    # Python
-dotnet tool install -g csharp-ls                      # C#
+/sw:increment "Add dark mode"   # Describe your feature
+/sw:auto                        # Ship while you sleep
 ```
 
-**[Full LSP Guide →](https://spec-weave.com/docs/guides/lsp-integration)**
+> **Node.js 20.12.0+** required (22 LTS recommended). Getting `SyntaxError`? [Upgrade instructions](https://spec-weave.com/docs/guides/troubleshooting/common-errors#node-version-error).
 
 ---
 
-## Install
+## Parallel Development
 
-### Prerequisites
+Run multiple AI agents on the same repository — locally, in the cloud, or with [OpenClaw](https://openclaw.ai). SpecWeave's increment files are the coordination layer:
 
-**Node.js 20.12.0+** required (recommend Node.js 22 LTS).
-
-```bash
-node --version   # Check version
 ```
-
-> **Getting `SyntaxError: Unexpected token 'with'`?** Your Node.js is too old. [Upgrade instructions →](https://spec-weave.com/docs/guides/troubleshooting/common-errors#node-version-error)
-
-### New Project
-
-```bash
-npm install -g specweave
-mkdir my-app && cd my-app
-specweave init .
+Agent 1 (local Claude Code)    Agent 2 (cloud)           Agent 3 (OpenClaw)
+working on: 0001-auth          working on: 0002-payments  working on: 0003-notifications
+         │                              │                           │
+         └──────────────────────────────┼───────────────────────────┘
+                                        │
+                           .specweave/increments/
+                           ├── 0001-auth/tasks.md           ← Agent 1's scope
+                           ├── 0002-payments/tasks.md       ← Agent 2's scope
+                           └── 0003-notifications/tasks.md  ← Agent 3's scope
 ```
 
-Then describe what you want in Claude Code:
-```
-"Build a calculator app with React"
-```
+**How it works:**
+1. Create increments for each feature: `/sw:increment "auth"`, `/sw:increment "payments"`
+2. Each agent picks an increment and runs `/sw:auto` — tasks.md tracks exactly what's done
+3. Agents work in isolated scopes — different files, different specs, different tests
+4. Quality gates (`/sw:grill`) ensure consistent standards regardless of which agent built it
+5. Progress syncs to GitHub/JIRA so you see everything in one place
 
-### Existing Project
+**Why this matters:** OpenClaw and Claude Code sessions are stateless by default. SpecWeave's spec/plan/tasks files persist across sessions and agents — your coordination layer survives restarts, crashes, and context window limits.
 
-```bash
-npm install -g specweave
-cd your-project
-specweave init .
-```
+**Agent team commands:**
 
-Then:
-```bash
-/sw:increment "Add dark mode"   # Create spec + plan + tasks
-/sw:auto                        # Ship while you sleep
-/sw:grill 0001                  # Code review before close
-/sw:done 0001                   # Complete with validation
-```
+| Command | Purpose |
+|---------|---------|
+| `/sw:team-orchestrate "feature"` | Split feature across parallel agents |
+| `/sw:team-status` | Monitor all agent progress |
+| `/sw:team-merge` | Merge completed work in dependency order |
+
+**[Full agent teams guide](https://spec-weave.com/docs/guides/agent-teams-and-swarms)**
 
 ---
 
@@ -194,63 +117,43 @@ Then:
 | Command | Purpose |
 |---------|---------|
 | `/sw:increment "feature"` | Create spec + plan + tasks |
-| `/sw:auto` | Autonomous execution (hours) |
+| `/sw:auto` | Autonomous execution |
 | `/sw:do` | Execute one task at a time |
-| `/sw:grill 0001` | **Code review before close** |
-| `/sw:done 0001` | Close with quality validation |
-| `/sw:sync-progress` | Push to GitHub/JIRA/ADO |
+| `/sw:grill` | Code review before close |
+| `/sw:done` | Close with quality validation |
+| `/sw:sync-progress` | Push to GitHub / JIRA / ADO |
 | `/sw:next` | Auto-close + suggest next |
 
-**[100+ total commands →](https://spec-weave.com/docs/commands/overview)**
+**[Full command reference](https://spec-weave.com/docs/commands/overview)**
 
 ---
 
-## External Integrations
+## Integrations
 
-| Platform | Capabilities |
-|----------|--------------|
-| **GitHub** | Issues, PRs, milestones, bidirectional sync |
-| **JIRA** | Epics, stories, status sync |
+| Platform | What Syncs |
+|----------|-----------|
+| **GitHub** | Issues, PRs, milestones — bidirectional |
+| **JIRA** | Epics, stories, status |
 | **Azure DevOps** | Work items, area paths |
 
-**Automatic sync**: When you close an increment (`/sw:done`), external tools update immediately. Task progress syncs at session end.
-
-```bash
-/sw:sync-progress         # Manual: Push updates to ALL tools
-/sw-github:sync 0001      # Manual: Sync specific increment to GitHub
-/sw-jira:sync 0001        # Manual: Sync specific increment to JIRA
-```
-
----
-
-## Works On Everything
-
-| Scenario | What Happens |
-|----------|-------------|
-| **10-year legacy codebase** | Brownfield analysis detects doc gaps |
-| **Weekend MVP** | Full spec-driven development |
-| **50-team enterprise** | Multi-project sync to JIRA/ADO |
-
----
-
-## CLI Commands
-
-| Command | Purpose |
-|---------|---------|
-| `specweave init .` | Initialize project |
-| `specweave update` | **Full update**: CLI + plugins + instructions |
-
-### Troubleshooting
-
-Run `specweave update` - this fixes 98% of issues (updates CLI, plugins, and instructions).
+When you close an increment, external tools update automatically.
 
 ---
 
-## Requirements
-
-- **Node.js 20.12.0+** (recommend 22 LTS)
-- Any AI coding tool (Claude Code with Opus 4.6 recommended)
-- Git repository
+## How It Compares
+
+| Capability | SpecWeave | BMAD Method | GitHub SpecKit |
+|------------|-----------|-------------|----------------|
+| **Parallel agent coordination** | Increment-scoped isolation | No | No |
+| **Autonomous execution** | Hours of unattended `/sw:auto` | No | No |
+| **Quality gates** | Code Grill before every release | No | No |
+| **Living documentation** | Auto-updated after every task | Manual | Manual |
+| **Self-improving AI** | Learns from corrections | No | No |
+| **External sync** | GitHub / JIRA / ADO bidirectional | No | No |
+| **Specialized skills** | 100+ (PM, QA, DevOps, ML...) | 21 agents | None |
+| **Works with OpenClaw** | Yes | Partial | Partial |
+| **Spec/plan/tasks workflow** | Yes | Yes | Yes |
+| **Agent-agnostic** | Claude Code + OpenClaw + Copilot + Codex | Multi-IDE | Multi-IDE |
 
 ---
 
@@ -258,25 +161,18 @@ Run `specweave update` - this fixes 98% of issues (updates CLI, plugins, and ins
 
 > This framework builds itself. Every feature, bug fix, and release is spec-driven.
 
-[![Deploy Frequency](https://img.shields.io/badge/dynamic/json?url=https://raw.githubusercontent.com/anton-abyzov/specweave/develop/.specweave/metrics/dora-latest.json&query=$.metrics.deploymentFrequency.value&label=Deploy%20Frequency&suffix=/month&color=brightgreen)](https://github.com/anton-abyzov/specweave/blob/develop/.specweave/docs/internal/delivery/dora-metrics.md)
-[![Features](https://img.shields.io/badge/Features-190+-blue)](https://github.com/anton-abyzov/specweave/tree/develop/.specweave/increments)
-
-**[Browse our increments →](https://github.com/anton-abyzov/specweave/tree/develop/.specweave/increments)**
+**[Browse increments](https://github.com/anton-abyzov/specweave/tree/develop/.specweave/increments)** — see how SpecWeave develops SpecWeave.
 
 ---
 
 ## Documentation
 
-**[spec-weave.com](https://spec-weave.com)** - Full documentation, guides, and examples.
-
----
+**[spec-weave.com](https://spec-weave.com)** — guides, examples, and full reference.
 
 ## Community
 
-[Discord](https://discord.gg/UYg4BGJ65V) | [YouTube](https://www.youtube.com/@antonabyzov) | [GitHub Issues](https://github.com/anton-abyzov/specweave/issues)
-
----
+[Discord](https://discord.gg/UYg4BGJ65V) · [YouTube](https://www.youtube.com/@antonabyzov) · [GitHub Issues](https://github.com/anton-abyzov/specweave/issues)
 
 ## License
 
-MIT - [github.com/anton-abyzov/specweave](https://github.com/anton-abyzov/specweave)
+MIT — [github.com/anton-abyzov/specweave](https://github.com/anton-abyzov/specweave)

package/dist/plugins/specweave-github/lib/github-ac-comment-poster.d.ts

@@ -0,0 +1,37 @@
+/**
+ * GitHub AC Comment Poster — Posts progress comments to GitHub issues
+ * when acceptance criteria are completed in spec.md.
+ *
+ * Triggered by github-ac-sync-handler.sh after task-ac-sync-guard
+ * updates spec.md ACs.
+ *
+ * @module github-ac-comment-poster
+ */
+export interface CommentPostOptions {
+    owner: string;
+    repo: string;
+    token?: string;
+}
+export interface CommentPostResult {
+    posted: Array<{
+        usId: string;
+        issueNumber: number;
+    }>;
+    errors: Array<{
+        usId: string;
+        error: string;
+    }>;
+}
+/**
+ * Post AC progress comments to GitHub issues for affected user stories.
+ *
+ * For each affected US:
+ * 1. Look up GitHub issue link from spec.md frontmatter
+ * 2. Extract AC states for that US
+ * 3. Build progress comment
+ * 4. Post via `gh issue comment`
+ *
+ * Never throws — all errors are captured in result.errors.
+ */
+export declare function postACProgressComments(incrementId: string, affectedUSIds: string[], specPath: string, options: CommentPostOptions): Promise<CommentPostResult>;
+//# sourceMappingURL=github-ac-comment-poster.d.ts.map

package/dist/plugins/specweave-github/lib/github-ac-comment-poster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-ac-comment-poster.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-ac-comment-poster.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAaD;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EAAE,EACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CA8D5B"}

package/dist/plugins/specweave-github/lib/github-ac-comment-poster.js

@@ -0,0 +1,176 @@
+/**
+ * GitHub AC Comment Poster — Posts progress comments to GitHub issues
+ * when acceptance criteria are completed in spec.md.
+ *
+ * Triggered by github-ac-sync-handler.sh after task-ac-sync-guard
+ * updates spec.md ACs.
+ *
+ * @module github-ac-comment-poster
+ */
+import { readFile } from 'fs/promises';
+import { execFileNoThrow } from '../../../src/utils/execFileNoThrow.js';
+import { pushSyncUserStories } from './github-push-sync.js';
+/**
+ * Post AC progress comments to GitHub issues for affected user stories.
+ *
+ * For each affected US:
+ * 1. Look up GitHub issue link from spec.md frontmatter
+ * 2. Extract AC states for that US
+ * 3. Build progress comment
+ * 4. Post via `gh issue comment`
+ *
+ * Never throws — all errors are captured in result.errors.
+ */
+export async function postACProgressComments(incrementId, affectedUSIds, specPath, options) {
+    const result = { posted: [], errors: [] };
+    if (affectedUSIds.length === 0) {
+        return result;
+    }
+    let content;
+    try {
+        content = await readFile(specPath, 'utf-8');
+    }
+    catch (err) {
+        result.errors.push({
+            usId: affectedUSIds[0],
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return result;
+    }
+    const issueLinks = parseIssueLinks(content);
+    const repoSlug = `${options.owner}/${options.repo}`;
+    const env = options.token ? { GH_TOKEN: options.token } : undefined;
+    for (const usId of affectedUSIds) {
+        const link = issueLinks[usId];
+        if (!link) {
+            continue;
+        }
+        const acStates = parseACStatesForUS(content, usId);
+        const commentBody = buildProgressCommentForUS(incrementId, usId, acStates);
+        const execResult = await execFileNoThrow('gh', ['issue', 'comment', String(link.issueNumber), '--body', commentBody, '-R', repoSlug], env ? { env } : {});
+        if (execResult.success) {
+            result.posted.push({ usId, issueNumber: link.issueNumber });
+        }
+        else {
+            result.errors.push({
+                usId,
+                error: execResult.stderr || 'Unknown error posting comment',
+            });
+        }
+        // Targeted push-sync: update issue body with current AC states
+        const usForSync = buildUserStoryForSync(content, usId, acStates, incrementId);
+        if (usForSync) {
+            try {
+                await pushSyncUserStories([usForSync], {
+                    owner: options.owner,
+                    repo: options.repo,
+                    token: options.token,
+                });
+            }
+            catch {
+                // Push-sync failure is non-blocking
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Parse issue links from spec.md YAML frontmatter.
+ * Extracts externalLinks.github.userStories entries.
+ */
+function parseIssueLinks(content) {
+    const links = {};
+    const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!fmMatch)
+        return links;
+    const frontmatter = fmMatch[1];
+    // Parse userStories section from YAML frontmatter
+    const usBlockMatch = frontmatter.match(/userStories:\s*\n((?:\s{6,}[\s\S]*?)(?=\n\s{0,3}\S|$))/);
+    if (!usBlockMatch)
+        return links;
+    const usBlock = usBlockMatch[1];
+    const usEntries = usBlock.match(/^\s+(US-\d+):\s*\n((?:\s+\w[\s\S]*?)(?=\n\s+US-|\s*$))/gm);
+    if (!usEntries)
+        return links;
+    for (const entry of usEntries) {
+        const idMatch = entry.match(/(US-\d+):/);
+        const numMatch = entry.match(/issueNumber:\s*(\d+)/);
+        const urlMatch = entry.match(/issueUrl:\s*"([^"]+)"/);
+        if (idMatch && numMatch) {
+            links[idMatch[1]] = {
+                issueNumber: parseInt(numMatch[1], 10),
+                issueUrl: urlMatch ? urlMatch[1] : '',
+            };
+        }
+    }
+    return links;
+}
+/**
+ * Extract AC states for a specific user story from spec.md content.
+ */
+function parseACStatesForUS(content, usId) {
+    const states = [];
+    // AC IDs use unpadded US number: US-001 → AC-US1-XX
+    const usNum = String(parseInt(usId.replace('US-', ''), 10));
+    const acPattern = new RegExp(`- \\[([ x])\\] \\*\\*AC-US${usNum}-(\\d+)\\*\\*:\\s*(.+)`, 'g');
+    let match;
+    while ((match = acPattern.exec(content)) !== null) {
+        states.push({
+            id: `AC-US${usNum}-${match[2]}`,
+            description: match[3].trim(),
+            completed: match[1] === 'x',
+        });
+    }
+    return states;
+}
+/**
+ * Build a UserStoryForSync object for targeted push-sync.
+ */
+function buildUserStoryForSync(content, usId, acStates, incrementId) {
+    // Extract US title from content
+    const usNum = String(parseInt(usId.replace('US-', ''), 10)).padStart(3, '0');
+    const titleMatch = content.match(new RegExp(`### US-${usNum}:\\s*(.+)`));
+    const title = titleMatch ? titleMatch[1].trim() : usId;
+    return {
+        id: usId,
+        title,
+        description: '',
+        priority: 'P1',
+        status: 'in-progress',
+        acceptanceCriteria: acStates.map(ac => ({
+            id: ac.id,
+            description: ac.description,
+            completed: ac.completed,
+        })),
+        specId: incrementId,
+    };
+}
+/**
+ * Build a progress comment for a specific user story.
+ * Follows ProgressCommentBuilder format: percentage, AC checkboxes, timestamp.
+ */
+function buildProgressCommentForUS(incrementId, usId, acStates) {
+    const total = acStates.length;
+    const completed = acStates.filter(ac => ac.completed).length;
+    const percentage = total > 0 ? Math.round((completed / total) * 100) : 0;
+    let comment = `**Progress Update** — ${usId} (Increment ${incrementId})\n\n`;
+    comment += `**Status**: ${completed}/${total} ACs complete (${percentage}%)\n\n`;
+    if (completed > 0) {
+        comment += `**Completed**:\n`;
+        for (const ac of acStates.filter(a => a.completed)) {
+            comment += `- [x] **${ac.id}**: ${ac.description}\n`;
+        }
+        comment += '\n';
+    }
+    if (completed < total) {
+        comment += `**Remaining**:\n`;
+        for (const ac of acStates.filter(a => !a.completed)) {
+            comment += `- [ ] **${ac.id}**: ${ac.description}\n`;
+        }
+        comment += '\n';
+    }
+    comment += `---\n`;
+    comment += `Auto-synced by SpecWeave | ${new Date().toISOString().split('T')[0]}\n`;
+    return comment;
+}
+//# sourceMappingURL=github-ac-comment-poster.js.map

package/dist/plugins/specweave-github/lib/github-ac-comment-poster.js.map

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

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

@@ -0,0 +1,36 @@
+/**
+ * GitHub Batch Sync — Sync all specs in workspace
+ *
+ * Discovers all spec files and syncs them sequentially
+ * using the GitHubSyncOrchestrator.
+ *
+ * @module github-batch-sync
+ */
+export interface BatchSyncConfig {
+    owner: string;
+    repo: string;
+    workspaceRoot: string;
+    token?: string;
+    dryRun?: boolean;
+    projectV2Enabled?: boolean;
+    projectV2Number?: number;
+    projectV2Id?: string;
+    statusFieldMapping?: Record<string, string>;
+    priorityFieldMapping?: Record<string, string>;
+}
+export interface BatchSyncResult {
+    specsProcessed: number;
+    specsFailed: number;
+    totalIssuesCreated: number;
+    totalIssuesUpdated: number;
+    errors: Array<{
+        specPath: string;
+        error: string;
+    }>;
+    summary: string;
+}
+/**
+ * Discover all specs and sync them sequentially.
+ */
+export declare function batchSyncAllSpecs(config: BatchSyncConfig): Promise<BatchSyncResult>;
+//# sourceMappingURL=github-batch-sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github-batch-sync.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-batch-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CA0DzF"}