specweave 0.21.2 → 0.22.0

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

@@ -84,3 +84,41 @@ export interface GitHubSyncOptions {
   projectName?: string; // Optional: Add issues to GitHub Project (e.g., "SpecWeave v0.4.0")
   fastMode?: boolean; // Skip rate limiting (for increments < 10 tasks)
 }
+
+/**
+ * Three-Layer Sync Types (for bidirectional sync)
+ */
+export interface AcceptanceCriterion {
+  id: string; // e.g., "AC-US1-01"
+  userStoryId: string; // e.g., "US1"
+  description: string;
+  completed: boolean;
+  projects: string[]; // ["backend", "frontend", "mobile"]
+  rawLine: string; // Original markdown line
+}
+
+export interface SyncTask {
+  id: string; // e.g., "T-001"
+  title: string;
+  completed: boolean;
+  completedDate?: string;
+  acIds: string[]; // e.g., ["AC-US1-01", "AC-US1-02"]
+  filePaths?: string[]; // For code validation
+}
+
+export interface SyncChange {
+  type: 'ac' | 'task';
+  id: string;
+  completed: boolean;
+  layer: 'github' | 'living-docs' | 'increment';
+  userStoryPath?: string;
+  incrementPath?: string;
+}
+
+export interface ThreeLayerSyncResult {
+  acsUpdated: number;
+  tasksUpdated: number;
+  tasksReopened: number;
+  conflicts: string[];
+  errors: string[];
+}

package/plugins/specweave-github/lib/user-story-issue-builder.js

@@ -2,6 +2,7 @@ import { readFile } from "fs/promises";
 import { existsSync } from "fs";
 import * as path from "path";
 import * as yaml from "yaml";
+import { IssueStateManager } from "./IssueStateManager.js";
 class UserStoryIssueBuilder {
   constructor(userStoryPath, projectRoot, featureId, repoInfo) {
     this.userStoryPath = userStoryPath;
@@ -206,6 +207,10 @@ class UserStoryIssueBuilder {
    */
   buildBody(data) {
     const sections = [];
+    const progress = IssueStateManager.calculateProgress(
+      data.acceptanceCriteria,
+      data.tasks
+    );
     sections.push(`**Feature**: ${this.featureId}`);
     sections.push(`**Status**: ${this.capitalize(data.frontmatter.status)}`);
     sections.push(`**Priority**: ${data.frontmatter.priority || "P2"}`);
@@ -213,6 +218,8 @@ class UserStoryIssueBuilder {
       sections.push(`**Project**: ${data.frontmatter.project}`);
     }
     sections.push("");
+    sections.push(IssueStateManager.formatProgressMarkdown(progress));
+    sections.push("");
     if (data.userStoryStatement) {
       sections.push("## User Story");
       sections.push("");

package/plugins/specweave-github/lib/user-story-issue-builder.ts

@@ -17,6 +17,7 @@ import { readFile } from 'fs/promises';
 import { existsSync } from 'fs';
 import * as path from 'path';
 import * as yaml from 'yaml';
+import { IssueStateManager, ProgressInfo } from './IssueStateManager.js';
 
 interface UserStoryFrontmatter {
   id: string;
@@ -356,6 +357,12 @@ export class UserStoryIssueBuilder {
   }): string {
     const sections: string[] = [];
 
+    // Calculate progress
+    const progress = IssueStateManager.calculateProgress(
+      data.acceptanceCriteria,
+      data.tasks
+    );
+
     // Header with metadata
     sections.push(`**Feature**: ${this.featureId}`);
     sections.push(`**Status**: ${this.capitalize(data.frontmatter.status)}`);
@@ -366,6 +373,10 @@ export class UserStoryIssueBuilder {
     }
     sections.push('');
 
+    // Progress section (NEW)
+    sections.push(IssueStateManager.formatProgressMarkdown(progress));
+    sections.push('');
+
     // User Story statement
     if (data.userStoryStatement) {
       sections.push('## User Story');