specweave 1.0.356 → 1.0.357

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

@@ -622,9 +622,26 @@ Created: ${featureData.created}`;
    * - Prevents premature closure on creation
    */
   async createUserStoryIssue(issueContent, milestoneTitle, userStoryPath) {
+    const repoSlug = `${this.client.getOwner()}/${this.client.getRepo()}`;
+    for (const label of issueContent.labels) {
+      await execFileNoThrow("gh", [
+        "label",
+        "create",
+        label,
+        "--repo",
+        repoSlug,
+        "--color",
+        "ededed",
+        "--description",
+        "SpecWeave auto-label",
+        "--force"
+      ], { env: this.getGhEnv() });
+    }
     const result = await execFileNoThrow("gh", [
       "issue",
       "create",
+      "--repo",
+      repoSlug,
       "--title",
       issueContent.title,
       "--body",

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

@@ -907,10 +907,21 @@ export class GitHubFeatureSync {
     milestoneTitle: string,
     userStoryPath: string
   ): Promise<number> {
+    // Step 0: Ensure all required labels exist in the target repo
+    const repoSlug = `${this.client.getOwner()}/${this.client.getRepo()}`;
+    for (const label of issueContent.labels) {
+      await execFileNoThrow('gh', [
+        'label', 'create', label, '--repo', repoSlug,
+        '--color', 'ededed', '--description', 'SpecWeave auto-label', '--force'
+      ], { env: this.getGhEnv() });
+    }
+
     // Step 1: Create issue (always open initially - gh CLI limitation)
     const result = await execFileNoThrow('gh', [
       'issue',
       'create',
+      '--repo',
+      repoSlug,
       '--title',
       issueContent.title,
       '--body',

package/plugins/specweave-jira/lib/jira-status-sync.js

@@ -92,6 +92,81 @@ _Synced from SpecWeave_`;
       body
     });
   }
+  /**
+   * Post AC progress comment with proper ADF formatting and dedup.
+   *
+   * Builds native ADF with:
+   * - Bold header showing completion percentage
+   * - Bullet list with checkmark/cross emojis per AC
+   * - Fingerprint marker to prevent duplicate comments
+   *
+   * @param issueKey - JIRA issue key (e.g., PROJ-123)
+   * @param acStates - Array of AC states with id, description, completed
+   * @returns true if comment was posted, false if skipped (duplicate)
+   */
+  async postProgressComment(issueKey, acStates) {
+    const total = acStates.length;
+    const completed = acStates.filter((ac) => ac.completed).length;
+    const percentage = Math.round(completed / total * 100);
+    const fingerprint = `sw-progress:${completed}/${total}`;
+    try {
+      const commentsResp = await this.client.get(`/issue/${issueKey}/comment`, {
+        params: { orderBy: "-created", maxResults: 1 }
+      });
+      const lastComment = commentsResp.data?.comments?.[0];
+      if (lastComment) {
+        const lastText = extractAdfText(lastComment.body);
+        if (lastText.includes(fingerprint)) {
+          return false;
+        }
+      }
+    } catch {
+    }
+    const listItems = acStates.map((ac) => ({
+      type: "listItem",
+      content: [{
+        type: "paragraph",
+        content: [
+          { type: "text", text: `${ac.completed ? "\u2705" : "\u274C"} ${ac.id}: ${ac.description}` }
+        ]
+      }]
+    }));
+    const body = {
+      type: "doc",
+      version: 1,
+      content: [
+        {
+          type: "heading",
+          attrs: { level: 3 },
+          content: [{ type: "text", text: `Progress: ${completed}/${total} ACs (${percentage}%)` }]
+        },
+        {
+          type: "bulletList",
+          content: listItems
+        },
+        {
+          type: "paragraph",
+          content: [
+            { type: "text", text: `${fingerprint} | Synced from SpecWeave`, marks: [{ type: "em" }] }
+          ]
+        }
+      ]
+    };
+    await this.client.post(`/issue/${issueKey}/comment`, { body });
+    return true;
+  }
+}
+function extractAdfText(adf) {
+  if (!adf) return "";
+  if (typeof adf === "string") return adf;
+  let text = "";
+  if (adf.text) text += adf.text;
+  if (Array.isArray(adf.content)) {
+    for (const child of adf.content) {
+      text += extractAdfText(child);
+    }
+  }
+  return text;
 }
 export {
   JiraStatusSync

package/plugins/specweave-jira/lib/jira-status-sync.ts

@@ -13,7 +13,7 @@
 
 import axios, { AxiosInstance } from 'axios';
 import { detectDeploymentType, getApiBaseUrl } from './jira-deployment-detector.js';
-import { toCommentBody } from './content-format-adapter.js';
+import { toCommentBody, type AdfDocument, type AdfNode } from './content-format-adapter.js';
 
 /**
  * External status representation (JIRA-specific)
@@ -160,4 +160,94 @@ export class JiraStatusSync {
       body
     });
   }
+
+  /**
+   * Post AC progress comment with proper ADF formatting and dedup.
+   *
+   * Builds native ADF with:
+   * - Bold header showing completion percentage
+   * - Bullet list with checkmark/cross emojis per AC
+   * - Fingerprint marker to prevent duplicate comments
+   *
+   * @param issueKey - JIRA issue key (e.g., PROJ-123)
+   * @param acStates - Array of AC states with id, description, completed
+   * @returns true if comment was posted, false if skipped (duplicate)
+   */
+  async postProgressComment(
+    issueKey: string,
+    acStates: Array<{ id: string; description: string; completed: boolean }>,
+  ): Promise<boolean> {
+    const total = acStates.length;
+    const completed = acStates.filter(ac => ac.completed).length;
+    const percentage = Math.round((completed / total) * 100);
+    const fingerprint = `sw-progress:${completed}/${total}`;
+
+    // Dedup: check last comment for same fingerprint
+    try {
+      const commentsResp = await this.client.get(`/issue/${issueKey}/comment`, {
+        params: { orderBy: '-created', maxResults: 1 },
+      });
+      const lastComment = commentsResp.data?.comments?.[0];
+      if (lastComment) {
+        const lastText = extractAdfText(lastComment.body);
+        if (lastText.includes(fingerprint)) {
+          return false; // Already posted for this state
+        }
+      }
+    } catch {
+      // If comment fetch fails, proceed with posting
+    }
+
+    // Build ADF body directly — ✅ for done, ❌ for pending
+    const listItems: AdfNode[] = acStates.map(ac => ({
+      type: 'listItem',
+      content: [{
+        type: 'paragraph',
+        content: [
+          { type: 'text', text: `${ac.completed ? '\u2705' : '\u274C'} ${ac.id}: ${ac.description}` },
+        ],
+      }],
+    }));
+
+    const body: AdfDocument = {
+      type: 'doc',
+      version: 1,
+      content: [
+        {
+          type: 'heading',
+          attrs: { level: 3 },
+          content: [{ type: 'text', text: `Progress: ${completed}/${total} ACs (${percentage}%)` }],
+        },
+        {
+          type: 'bulletList',
+          content: listItems,
+        },
+        {
+          type: 'paragraph',
+          content: [
+            { type: 'text', text: `${fingerprint} | Synced from SpecWeave`, marks: [{ type: 'em' }] },
+          ],
+        },
+      ],
+    };
+
+    await this.client.post(`/issue/${issueKey}/comment`, { body });
+    return true;
+  }
+}
+
+/**
+ * Extract plain text from an ADF document (for dedup comparison).
+ */
+function extractAdfText(adf: any): string {
+  if (!adf) return '';
+  if (typeof adf === 'string') return adf;
+  let text = '';
+  if (adf.text) text += adf.text;
+  if (Array.isArray(adf.content)) {
+    for (const child of adf.content) {
+      text += extractAdfText(child);
+    }
+  }
+  return text;
 }

package/src/templates/CLAUDE.md.template

@@ -64,7 +64,9 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 
 **Signals** (5+ = auto-route): Project name | Features list (3+) | Tech stack | Timeline/MVP | Problem statement | Business model
 
-**Opt-out phrases**: "Just brainstorm first" | "Don't plan yet" | "Quick discussion" | "Let's explore ideas"
+**Opt-out phrases**: "Don't plan yet" | "Quick discussion" | "Let's explore ideas"
+
+**Brainstorm routing**: "Just brainstorm first" | "brainstorm" | "ideate" | "what are our options" → routes to `/sw:brainstorm`
 
 **NOT opt-out phrases**: "simple" | "quick" | "basic" | "small" — these still require `/sw:increment`
 

package/plugins/specweave/hooks/.specweave/logs/auto-iterations.log

@@ -1 +0,0 @@
-{"timestamp":"2026-01-04T16:11:43Z","event":"session_stop","reason":"No auto session active","details":"approve_called:main","success":false,"iteration":0,"increment":"none"}

package/plugins/specweave/hooks/.specweave/logs/auto-stop-reasons.log

@@ -1 +0,0 @@
-{"timestamp":"2026-01-04T16:11:43Z","sessionId":"unknown","reason":"No auto session active","details":"approve_called:main","success":false,"iteration":0,"increment":"none","testsRun":false,"testsPassed":0,"testsFailed":0}

package/plugins/specweave/skills/.specweave/logs/reflect/auto-reflect.log

@@ -1,15 +0,0 @@
-{
-  "ran": false,
-  "inputSummary": {
-    "transcriptLines": 266
-  },
-  "extracted": {
-    "skillLearnings": []
-  },
-  "written": {
-    "learningsAdded": 0,
-    "learningsSkippedDuplicate": 0
-  },
-  "durationMs": 1.4448749999999997,
-  "reason": "CLAUDE.md not found in project"
-}

package/plugins/specweave/skills/.specweave/logs/reflect/reflect.log

@@ -1,3 +0,0 @@
-[2026-02-03T22:03:06Z] [info] Starting reflection (265 lines)
-[2026-02-03T22:03:06Z] [info] Reflection started in background
-[2026-02-03T22:03:06Z] [info] Reflection completed - no learnings

package/plugins/specweave/skills/.specweave/logs/stop-auto.log

@@ -1 +0,0 @@
-[2026-02-03T22:03:06Z] APPROVE: No increments directory

package/plugins/specweave-ado/lib/enhanced-ado-sync.js

@@ -1,180 +0,0 @@
-import { AdoClientV2 } from "./ado-client-v2.js";
-import { EnhancedContentBuilder } from "../../../src/core/sync/enhanced-content-builder.js";
-import { SpecIncrementMapper } from "../../../src/core/sync/spec-increment-mapper.js";
-import { parseSpecContent } from "../../../src/core/spec-content-sync.js";
-import path from "path";
-import fs from "fs/promises";
-async function syncSpecToAdoWithEnhancedContent(options) {
-  const { specPath, organization, project, dryRun = false, verbose = false } = options;
-  try {
-    const baseSpec = await parseSpecContent(specPath);
-    if (!baseSpec) {
-      return {
-        success: false,
-        action: "error",
-        error: "Failed to parse spec content"
-      };
-    }
-    if (verbose) {
-      console.log(`\u{1F4C4} Parsed spec: ${baseSpec.identifier.compact}`);
-    }
-    const specId = baseSpec.identifier.full || baseSpec.identifier.compact;
-    const rootDir = await findSpecWeaveRoot(specPath);
-    const mapper = new SpecIncrementMapper(rootDir);
-    const mapping = await mapper.mapSpecToIncrements(specId);
-    if (verbose) {
-      console.log(`\u{1F517} Found ${mapping.increments.length} related increments`);
-    }
-    const taskMapping = buildTaskMapping(mapping.increments, organization, project);
-    const architectureDocs = await findArchitectureDocs(rootDir, specId);
-    const enhancedSpec = {
-      ...baseSpec,
-      summary: baseSpec.description,
-      taskMapping,
-      architectureDocs
-    };
-    const builder = new EnhancedContentBuilder();
-    const description = builder.buildExternalDescription(enhancedSpec);
-    if (verbose) {
-      console.log(`\u{1F4DD} Generated description: ${description.length} characters`);
-    }
-    if (dryRun) {
-      console.log("\u{1F50D} DRY RUN - Would create/update feature with:");
-      console.log(`   Title: ${baseSpec.title}`);
-      console.log(`   Description length: ${description.length}`);
-      return {
-        success: true,
-        action: "no-change",
-        tasksLinked: taskMapping?.tasks.length || 0
-      };
-    }
-    if (!organization || !project) {
-      return {
-        success: false,
-        action: "error",
-        error: "Azure DevOps organization/project not specified"
-      };
-    }
-    const profile = {
-      provider: "ado",
-      displayName: `${organization}/${project}`,
-      config: {
-        organization,
-        project
-      },
-      timeRange: { default: "1M", max: "6M" }
-    };
-    const pat = process.env.AZURE_DEVOPS_PAT || "";
-    const client = new AdoClientV2(profile, pat);
-    const existingFeature = await findExistingFeature(client, baseSpec.identifier.compact);
-    let result;
-    if (existingFeature) {
-      await client.updateWorkItem(existingFeature.id, {
-        title: `[${baseSpec.identifier.compact}] ${baseSpec.title}`,
-        description
-      });
-      result = {
-        success: true,
-        action: "updated",
-        featureId: existingFeature.id,
-        featureUrl: `https://dev.azure.com/${organization}/${project}/_workitems/edit/${existingFeature.id}`,
-        tasksLinked: taskMapping?.tasks.length || 0
-      };
-    } else {
-      const feature = await client.createEpic({
-        title: `[${baseSpec.identifier.compact}] ${baseSpec.title}`,
-        description,
-        tags: ["spec", "external-tool-sync"]
-      });
-      result = {
-        success: true,
-        action: "created",
-        featureId: feature.id,
-        featureUrl: `https://dev.azure.com/${organization}/${project}/_workitems/edit/${feature.id}`,
-        tasksLinked: taskMapping?.tasks.length || 0
-      };
-    }
-    if (verbose) {
-      console.log(`\u2705 ${result.action === "created" ? "Created" : "Updated"} feature #${result.featureId}`);
-    }
-    return result;
-  } catch (error) {
-    return {
-      success: false,
-      action: "error",
-      error: error.message
-    };
-  }
-}
-async function findSpecWeaveRoot(specPath) {
-  let currentDir = path.dirname(specPath);
-  while (true) {
-    const specweaveDir = path.join(currentDir, ".specweave");
-    try {
-      await fs.access(specweaveDir);
-      return currentDir;
-    } catch {
-      const parentDir = path.dirname(currentDir);
-      if (parentDir === currentDir) {
-        throw new Error(".specweave directory not found");
-      }
-      currentDir = parentDir;
-    }
-  }
-}
-function buildTaskMapping(increments, organization, project) {
-  if (increments.length === 0) return void 0;
-  const firstIncrement = increments[0];
-  const tasks = firstIncrement.tasks.map((task) => ({
-    id: task.id,
-    title: task.title,
-    userStories: task.userStories
-  }));
-  // Derive repository name from git remote or fall back to project name
-  let repoName = project;
-  try {
-    const { execSync } = require("child_process");
-    const remoteUrl = execSync("git remote get-url origin", { encoding: "utf-8" }).trim();
-    const match = remoteUrl.match(/\/([^/]+?)(?:\.git)?$/);
-    if (match) repoName = match[1];
-  } catch {
-    // Fallback to project name if git is unavailable
-  }
-  return {
-    incrementId: firstIncrement.id,
-    tasks,
-    tasksUrl: `https://dev.azure.com/${organization}/${project}/_git/${repoName}?path=/.specweave/increments/${firstIncrement.id}/tasks.md`
-  };
-}
-async function findArchitectureDocs(rootDir, specId) {
-  const docs = [];
-  const archDir = path.join(rootDir, ".specweave/docs/internal/architecture");
-  try {
-    const adrDir = path.join(archDir, "adr");
-    try {
-      const adrs = await fs.readdir(adrDir);
-      const relatedAdrs = adrs.filter((file) => file.includes(specId.replace("spec-", "")));
-      for (const adr of relatedAdrs) {
-        docs.push({
-          type: "adr",
-          path: path.join(adrDir, adr),
-          title: adr.replace(".md", "").replace(/-/g, " ")
-        });
-      }
-    } catch {
-    }
-  } catch {
-  }
-  return docs;
-}
-async function findExistingFeature(client, specId) {
-  try {
-    const features = await client.queryWorkItems(`[System.Title] Contains '[${specId}]' AND [System.WorkItemType] = 'Feature'`);
-    return features[0] || null;
-  } catch {
-    return null;
-  }
-}
-export {
-  syncSpecToAdoWithEnhancedContent
-};