specweave 1.0.443 → 1.0.444

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "1.0.443",
+  "version": "1.0.444",
   "description": "100+ domain-expert AI skills — PM, Architect, Frontend, QA, Security and more. Skills learn your team's patterns permanently. Spec-first planning, autonomous execution, multi-agent teams, synced to GitHub/JIRA. Claude Code, Cursor, Copilot & more.",
   "type": "module",
   "main": "dist/index.js",

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,15 @@
+{
+  "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

@@ -0,0 +1,3 @@
+[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

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

package/plugins/specweave/skills/done/SKILL.md

@@ -166,15 +166,14 @@ Execute: `Skill({ skill: "sw:sync-docs" })` with the increment ID. Do NOT just m
 
 ### Step 10b: Update Links in Docs (MANDATORY)
 
-After living docs sync, update cross-references and bidirectional links so existing docs reference the newly created feature specs.
+After living docs sync, update cross-references and bidirectional links so existing docs reference the newly created feature specs. Do NOT skip this step:
 
-Execute: `Skill({ skill: "sw:docs-updater" })` — this verifies and repairs links between living docs, feature specs, and increment references. Do NOT skip this step. The docs-updater:
-1. Reads the feature spec files created by Step 10
-2. Updates existing docs (FEATURE-CATALOG, module docs, etc.) with links to the new specs
-3. Verifies bidirectional links between increment → feature spec → living docs
-4. Changes `[DRAFT]` → `[COMPLETE]` on doc sections matching completed ACs
+1. Read the feature spec files created by Step 10 (`.specweave/docs/internal/specs/{project}/FS-XXX/FEATURE.md` and `us-*.md`)
+2. Update existing docs (FEATURE-CATALOG, module docs, etc.) with links to the new specs
+3. Verify bidirectional links between increment → feature spec → living docs
+4. Change `[DRAFT]` → `[COMPLETE]` on doc sections matching completed ACs
 
-If `sw:docs-updater` is unavailable, manually verify that `.specweave/docs/internal/specs/{project}/FS-XXX/` contains `FEATURE.md` and `us-*.md` files. If missing, re-run Step 10.
+Verify that `.specweave/docs/internal/specs/{project}/FS-XXX/` contains `FEATURE.md` and `us-*.md` files. If missing, re-run Step 10.
 
 ### Step 11: Post-Closure Quality Assessment
 

package/plugins/specweave/skills/increment/SKILL.md

@@ -50,7 +50,7 @@ STEP 1:  Pre-flight (TDD mode, multi-project, Deep Interview check)
 STEP 2:  Project Context (resolve project/board)
 STEP 3:  Create Increment (via Template API) ← folder + ID exist after this
 STEP 3a: Deep Interview (if enabled) ← runs AFTER folder exists
-STEP 4:  Delegation (architect + test-aware-planner)
+STEP 4:  Delegation (architect + planner)
 STEP 5:  Post-Creation Sync
 STEP 6:  Execution Strategy Recommendation
 ```

package/plugins/specweave/skills/plan/SKILL.md

@@ -17,7 +17,7 @@ description: Generate plan.md and tasks.md for increment. Use when saying "creat
 
 ---
 
-Generate `plan.md` and `tasks.md` for an increment using Architect Agent and test-aware-planner.
+Generate `plan.md` and `tasks.md` for an increment using Architect Agent.
 
 ## Usage
 
@@ -68,7 +68,7 @@ Generate `plan.md` and `tasks.md` for an increment using Architect Agent and tes
    - Dependencies
    - Risk assessment
 
-4. **Generate tasks.md** (via test-aware-planner):
+4. **Generate tasks.md**:
    - Checkable task list
    - Embedded test plans (BDD format)
    - Coverage targets
@@ -227,7 +227,7 @@ Planning for framework features requires different considerations than user apps
 - `IncrementDetector`: Auto-detect or validate increment
 - `PlanValidator`: Validate pre-conditions
 - `ArchitectAgentInvoker`: Generate plan.md via Architect Agent
-- `TaskGeneratorInvoker`: Generate tasks.md via test-aware-planner
+- `TaskGeneratorInvoker`: Generate tasks.md with BDD test plans
 - `PlanCommandOrchestrator`: Coordinate execution pipeline
 
 **State transitions**:

package/plugins/specweave-ado/lib/ado-multi-project-sync.js

@@ -373,7 +373,6 @@ ${userStory.technicalContext}
         return mapping.task || "Task";
       case "Subtask":
         return mapping.task || "Task";
-      // ADO doesn't have subtasks, use Task
       default:
         return "User Story";
     }

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

@@ -0,0 +1,180 @@
+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
+};