specweave 1.0.520 → 1.0.522

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

@@ -45,12 +45,12 @@ Increment planning produces specs, plans, and task breakdowns that require user
 STEP 0A: Discipline Check (BLOCKING)
 STEP 0B: WIP Enforcement
 STEP 0C: Tech Stack Detection
-STEP 0D: Structure Resolution (if deferred from init)
 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 + planner)
+STEP 4:  Direct Specification Writing (universal, CLI-first)
+STEP 4a: Enhanced: Team-Based Delegation (optional, Claude Code only)
 STEP 5:  Post-Creation Sync
 STEP 6:  Execution Strategy Recommendation
 ```
@@ -116,31 +116,6 @@ Auto-detect from project files:
 
 If detection fails, ask user.
 
-## Step 0D: Structure Resolution (if deferred)
-
-Check if the user deferred their repository structure decision during init (greenfield projects):
-
-```bash
-DEFERRED=$(jq -r '.project.structureDeferred // false' .specweave/config.json 2>/dev/null)
-```
-
-If `DEFERRED` is `true`, this is the user's **first increment** and they need to define their project structure.
-
-Based on the user's feature description and what you've learned from tech stack detection:
-
-1. **Ask the user** about their repository structure:
-   - **Single repo** — one repository (monorepo or standard project)
-   - **Multiple repos** — microservices, EDA, parent/child architecture
-
-2. **Run the resolve command** based on their answer:
-   ```bash
-   specweave resolve-structure --type single
-   # OR
-   specweave resolve-structure --type multiple
-   ```
-
-3. This clears the deferred flag and configures the project accordingly. Continue with the normal increment flow.
-
 ## Step 1: Pre-flight Checks
 
 ```bash
@@ -170,7 +145,7 @@ Every US MUST have `**Project**:` field. For 2-level structures, also `**Board**
 
 ### 3a. Determine Increment Location
 
-**CRITICAL for umbrella vs single-repo:**
+**Determine where increments are stored:**
 
 ```bash
 # Check umbrella mode
@@ -188,7 +163,7 @@ elif [ -d "repositories" ]; then
   echo "Organization: $ORG"
   ls -d repositories/*/* 2>/dev/null | head -20
 else
-  echo "SINGLE-REPO: Use .specweave/increments/"
+  echo "WORKSPACE: Use .specweave/increments/"
 fi
 ```
 
@@ -202,7 +177,7 @@ fi
 - Each repository has its OWN `.specweave/increments/` directory
 - Run `specweave init` in each repo if `.specweave/` doesn't exist
 
-### 3b. Create Increment (Preferred — Atomic)
+### 3b. Create Increment
 
 ```bash
 specweave create-increment --auto-id --name "your-feature-name" --title "Feature Title" --description "Brief description" --project "my-app"
@@ -212,20 +187,9 @@ This atomically reserves the next available ID and creates the increment directo
 
 **Optional flags**: `--type hotfix` | `--priority P1` | `--board "team-name"` | `--json`
 
-### 3c. Legacy two-step creation (when explicit ID is needed)
-
-```bash
-# Step 1: Get the next available increment ID
-NEXT_ID=$(specweave next-id --name "your-feature-name")
-# Returns e.g. "0579-your-feature-name"
-
-# Step 2: Create with explicit ID
-specweave create-increment --id "$NEXT_ID" --title "Feature Title" --description "Brief description" --project "my-app"
-```
-
-**Note**: The two-step approach has a TOCTOU race — another process can claim the ID between steps. Prefer `--auto-id` for concurrent environments.
+For diagnostic purposes, `specweave next-id` is available to preview the next number.
 
-### 3d. Create manually (if CLI unavailable)
+### 3c. Create manually (if CLI unavailable)
 
 ```bash
 mkdir -p .specweave/increments/XXXX-name
@@ -273,31 +237,50 @@ Create files in order: metadata.json FIRST, then spec.md, plan.md, tasks.md.
 
 ## Critical Rules
 
-1. **NEVER write spec.md/plan.md/tasks.md directly** — when TeamCreate is available, ALWAYS delegate via TeamCreate + team-scoped Agent() calls (see Adapter Compatibility for fallback)
+1. **Prefer team-based delegation when TeamCreate is available**; write spec files directly otherwise
 2. **Project field is MANDATORY** — Every US MUST have `**Project**:` field
 3. **Use Template Creator CLI** (REQUIRED): `specweave create-increment --auto-id --name "name" --title "Title" --description "Desc" --project "my-app"`
-4. **Team-based delegation is the ONLY way** to produce spec.md/plan.md/tasks.md when TeamCreate is available — create a team via TeamCreate(), then spawn `sw:sw-pm`, `sw:sw-architect`, `sw:sw-planner` agents with team_name
+4. **Team-based delegation is the preferred path** when TeamCreate is available — but direct spec writing is the universal default that works with ALL AI tools
 5. **Increment naming** — Format: `####-descriptive-kebab-case`
 6. **Umbrella mode** — When `umbrella.enabled: true`, ALL increments go in the umbrella root `.specweave/increments/`. The `**Project**:` field per user story routes sync to child repos. Do NOT create increments in child repos.
 
-## Adapter Compatibility
+## Step 3a: Deep Interview Mode (if enabled)
+
+**IMPORTANT**: This step runs AFTER the increment folder is created (Step 3), so the
+interview state file can reference the real increment ID.
 
-The team-based delegation below uses Claude Code tools (TeamCreate, Agent, SendMessage).
-If these tools are unavailable (OpenCode, Cursor, other adapters):
+**If deep interview is enabled, delegate to PM subagent (if Agent tool available) or conduct inline:**
+
+```typescript
+Agent({ subagent_type: "sw:sw-pm", prompt: "Deep interview for increment XXXX-name: <user description>. Increment path: <path>", description: "PM deep interview" })
+```
+
+The PM agent will:
+1. Assess complexity and determine question count (trivial: 0-3, small: 4-8, medium: 9-18, large: 19-40)
+2. Interview the user across relevant categories
+3. Write interview state to `.specweave/state/interview-{increment-id}.json`
+4. Return interview summary for spec.md creation
+
+**After PM agent returns**, read the interview state file to confirm all categories are covered
+before proceeding to spec.md creation (especially when `enforcement: "strict"`).
+
+## Step 4: Direct Specification Writing (Universal — works with ALL AI tools)
+
+**After increment folder + metadata.json are created, write the spec files using CLI commands and templates.**
+
+This is the default path. It works with Claude Code, Cursor, OpenCode, Copilot, Aider, and any other AI tool.
 
-**Fallback: Direct spec writing**
 1. Create the increment: `specweave create-increment --auto-id --name "feature-name" --title "Title" --description "Desc" --project "my-app"`
-2. Write spec.md directly with user stories and ACs
-3. Write plan.md with architecture decisions
-4. Write tasks.md with BDD test plans for each AC
+2. Write `spec.md` with user stories and acceptance criteria (use the User Story Format above)
+3. Write `plan.md` with architecture decisions and ADR references
+4. Write `tasks.md` with BDD test plans (Given/When/Then) for each AC
 5. Run: `specweave sync-living-docs {increment-id}`
 
-Skip to Step 5 after writing all files.
+Proceed to Step 5 after writing all files.
 
-## CRITICAL: Mandatory Team-Based Delegation
+### Step 4a: Enhanced — Team-Based Delegation (Optional, Claude Code only)
 
-**This skill MUST NOT write spec.md, plan.md, or tasks.md directly** (when TeamCreate is available).
-Delegate via TeamCreate + team-scoped Agent() calls. Each agent gets its own tmux pane for user visibility.
+**If TeamCreate is available**, use team-based delegation for better quality. This provides isolated context, persistent memory, resumability, auto-compaction, and tmux pane visibility for each agent.
 
 **Team lifecycle:**
 1. `TeamCreate({ team_name: "plan-XXXX-name", description: "Planning: <feature>" })`
@@ -317,7 +300,7 @@ Delegate via TeamCreate + team-scoped Agent() calls. Each agent gets its own tmu
    fi
    ```
 
-**You MUST spawn these agents:**
+**Agents to spawn:**
 
 | File | Agent | Invocation |
 |------|-------|------------|
@@ -325,7 +308,7 @@ Delegate via TeamCreate + team-scoped Agent() calls. Each agent gets its own tmu
 | plan.md | sw:sw-architect | `Agent({ team_name: "plan-XXXX-name", name: "architect", subagent_type: "sw:sw-architect", mode: "bypassPermissions", prompt: "...", description: "Architect writes plan.md" })` |
 | tasks.md | sw:sw-planner | `Agent({ team_name: "plan-XXXX-name", name: "planner", subagent_type: "sw:sw-planner", mode: "bypassPermissions", prompt: "...", description: "Planner writes tasks.md" })` |
 
-**DO NOT:**
+**DO NOT (when using team-based delegation):**
 - Write user stories, architecture, or tasks inline
 - Copy/paste spec content into Write() calls
 - "Summarize" what an agent would produce
@@ -333,33 +316,7 @@ Delegate via TeamCreate + team-scoped Agent() calls. Each agent gets its own tmu
 - Use standalone Agent() without team_name for Phase 1/2 delegation — agents MUST be in a team for tmux visibility (exception: Deep Interview in Step 3a is standalone because it's interactive + sequential)
 - Use Skill() for these — team agents provide memory + resumability + visibility
 
-## Step 3a: Deep Interview Mode (if enabled)
-
-**IMPORTANT**: This step runs AFTER the increment folder is created (Step 3), so the
-interview state file can reference the real increment ID.
-
-**If deep interview is enabled, delegate to PM subagent:**
-
-```typescript
-Agent({ subagent_type: "sw:sw-pm", prompt: "Deep interview for increment XXXX-name: <user description>. Increment path: <path>", description: "PM deep interview" })
-```
-
-The PM agent will:
-1. Assess complexity and determine question count (trivial: 0-3, small: 4-8, medium: 9-18, large: 19-40)
-2. Interview the user across relevant categories
-3. Write interview state to `.specweave/state/interview-{increment-id}.json`
-4. Return interview summary for spec.md creation
-
-**After PM agent returns**, read the interview state file to confirm all categories are covered
-before proceeding to spec.md creation (especially when `enforcement: "strict"`).
-
-## Step 4: Delegation (MANDATORY - Team-Based)
-
-**After increment folder + metadata.json are created, create a planning team and spawn agents using a 2-phase overlap strategy.**
-
-Each agent runs in its own tmux pane for visibility. Agents preload their corresponding skill (with full domain logic, phases, templates), providing: isolated context, persistent memory, resumability, auto-compaction.
-
-### 4a. Create Planning Team (REQUIRED — before spawning any agents)
+#### 4a-i. Create Planning Team (before spawning any agents)
 
 **Cleanup first** — if you previously created a planning team in this session, shut down those agents before proceeding:
 ```typescript
@@ -377,7 +334,7 @@ TeamCreate({ team_name: "plan-XXXX-name", description: "Planning: <feature descr
 
 **team_name prefix `plan-*`** bypasses the increment-existence-guard (planning doesn't require an active increment).
 
-### 4b. Spawn PM and Architect IN PARALLEL (REQUIRED)
+#### 4a-ii. Spawn PM and Architect IN PARALLEL
 
 PM and Architect run concurrently in separate tmux panes. Architect starts codebase exploration immediately while PM writes spec.md. Architect polls for spec.md and reads it once available, then produces plan.md.
 
@@ -394,7 +351,7 @@ Agent({ team_name: "plan-XXXX-name", name: "architect", subagent_type: "sw:sw-ar
 
 **IMPORTANT**: Use parallel Agent() tool calls — call PM and Architect in the SAME message so they start concurrently.
 
-### 4c. Spawn Planner (REQUIRED — after PM + Architect complete)
+#### 4a-iii. Spawn Planner (after PM + Architect complete)
 ```typescript
 Agent({ team_name: "plan-XXXX-name", name: "planner", subagent_type: "sw:sw-planner", mode: "bypassPermissions", prompt: "Generate tasks for increment XXXX-name. Read spec.md at .specweave/increments/XXXX-name/spec.md and plan.md at .specweave/increments/XXXX-name/plan.md", description: "Planner writes tasks.md" })
 ```
@@ -403,7 +360,7 @@ Agent({ team_name: "plan-XXXX-name", name: "planner", subagent_type: "sw:sw-plan
 Architect explores the codebase while PM writes spec.md, then reads spec.md to produce plan.md.
 Planner needs both spec.md AND plan.md, so it must wait for Phase 1 to finish.
 
-### 4d. Team Cleanup (REQUIRED — after Planner completes)
+#### 4a-iv. Team Cleanup (after Planner completes)
 
 ```typescript
 SendMessage({ type: "shutdown_request", recipient: "pm" })

package/plugins/specweave/skills/team-lead/SKILL.md

@@ -111,7 +111,30 @@ Skip increment pre-flight entirely. Brainstorm doesn't need a spec — it explor
 1. Create team: `TeamCreate({ team_name: "brainstorm-{slug}", description: "Brainstorm: {topic}" })`
 2. Read agent templates from `agents/brainstorm-advocate.md`, `agents/brainstorm-critic.md`, `agents/brainstorm-pragmatist.md`
 3. Replace `[BRAINSTORM_QUESTION]` with the user's question/topic
-4. Spawn all 3 agents in parallel via `Task()` with `mode: "bypassPermissions"`
+4. Spawn all 3 agents in parallel — each call MUST include `team_name` so agents join the team (and get tmux panes):
+   ```
+   Task({
+     team_name: "brainstorm-{slug}",
+     name: "brainstorm-advocate",
+     subagent_type: "general-purpose",
+     mode: "bypassPermissions",
+     prompt: <replaced brainstorm-advocate.md content>
+   })
+   Task({
+     team_name: "brainstorm-{slug}",
+     name: "brainstorm-critic",
+     subagent_type: "general-purpose",
+     mode: "bypassPermissions",
+     prompt: <replaced brainstorm-critic.md content>
+   })
+   Task({
+     team_name: "brainstorm-{slug}",
+     name: "brainstorm-pragmatist",
+     subagent_type: "general-purpose",
+     mode: "bypassPermissions",
+     prompt: <replaced brainstorm-pragmatist.md content>
+   })
+   ```
 5. **PASSIVE WAIT (CRITICAL)**: Do NOT apply §8b stuck detection to brainstorm agents.
    Brainstorm agents send `STATUS:` heartbeats (not task-granularity `T-{N}/{total}`).
    Wait patiently for `PERSPECTIVE_COMPLETE:` messages — expected 2-5 minutes per agent.
@@ -144,7 +167,23 @@ Planning mode runs PM and Architect agents in parallel for richer, faster spec c
 2. **Spawn PM + Architect in parallel** (TRUE parallelism):
    - Read `agents/pm.md`, replace `[INCREMENT_ID]`, `[MASTER_INCREMENT_PATH]`, `[FEATURE_DESCRIPTION]`
    - Read `agents/architect.md`, replace `[INCREMENT_ID]`, `[MASTER_INCREMENT_PATH]`
-   - **Spawn BOTH via `Task()` with `mode: "bypassPermissions"` in a single step**
+   - **Spawn BOTH in a single step — each call MUST include `team_name`:**
+     ```
+     Task({
+       team_name: "plan-{feature-slug}",
+       name: "pm-agent",
+       subagent_type: "general-purpose",
+       mode: "bypassPermissions",
+       prompt: <replaced pm.md content>
+     })
+     Task({
+       team_name: "plan-{feature-slug}",
+       name: "architect-agent",
+       subagent_type: "general-purpose",
+       mode: "bypassPermissions",
+       prompt: <replaced architect.md content>
+     })
+     ```
    - PM writes spec.md with user stories and ACs
    - Architect starts codebase exploration immediately (does NOT need spec.md for this)
    - Architect polls for spec.md, reads it when PM finishes, then designs architecture
@@ -196,7 +235,16 @@ Skip increment pre-flight. Research is exploratory — no spec needed.
    - Multi-faceted topic: spawn 2-3 researchers with different scopes
      (e.g., "research auth" → one agent on OAuth providers, one on session management, one on security best practices)
 3. Replace `[RESEARCH_TOPIC]` and `[RESEARCH_SCOPE]` in each agent prompt
-4. Spawn all researchers in parallel via `Task()` with `mode: "bypassPermissions"`
+4. Spawn all researchers in parallel — each call MUST include `team_name`:
+   ```
+   Task({
+     team_name: "research-{slug}",
+     name: "researcher-{scope}",
+     subagent_type: "general-purpose",
+     mode: "bypassPermissions",
+     prompt: <replaced researcher.md content>
+   })
+   ```
 5. Collect `RESEARCH_COMPLETE:` messages
 6. Merge findings into a unified research report:
    - Cross-reference findings between agents
@@ -223,7 +271,23 @@ Testing mode requires an increment (it needs to know WHAT to test).
    - **Unit test agent**: read `agents/testing.md`, override scope to unit tests only
    - **E2E test agent**: read `agents/testing.md`, override scope to E2E tests only
    - Split scope via the agent prompt, not via separate templates
-4. Spawn both in parallel via `Task()` with `mode: "bypassPermissions"`
+4. Spawn both in parallel — each call MUST include `team_name`:
+   ```
+   Task({
+     team_name: "test-{id}",
+     name: "unit-test-agent",
+     subagent_type: "general-purpose",
+     mode: "bypassPermissions",
+     prompt: <replaced testing.md content with unit-test scope>
+   })
+   Task({
+     team_name: "test-{id}",
+     name: "e2e-test-agent",
+     subagent_type: "general-purpose",
+     mode: "bypassPermissions",
+     prompt: <replaced testing.md content with e2e scope>
+   })
+   ```
 5. Collect `COMPLETION:` messages
 6. Run test suites to verify: `npx vitest run` + `npx playwright test`
 7. Report results: pass/fail counts, coverage, uncovered ACs

package/scripts/check-node-version.js

@@ -116,7 +116,7 @@ if (!isVersionSatisfied(CURRENT_NODE_VERSION, MIN_NODE_VERSION)) {
   console.error(getUpgradeInstructions());
   console.error('');
   console.error(`${BOLD}Full guide:${RESET}`);
-  console.error(`  ${CYAN}${UNDERLINE}https://verified-skill.com/docs/guides/troubleshooting/common-errors#node-version-error${RESET}`);
+  console.error(`  ${CYAN}${UNDERLINE}https://spec-weave.com/docs/guides/troubleshooting/common-errors#node-version-error${RESET}`);
   console.error('');
   console.error(`${DIM}After upgrading, run: npm install -g specweave${RESET}`);
   console.error('');

package/src/templates/lsp-plugin/plugin.json

@@ -4,7 +4,7 @@
   "description": "Auto-configured LSP servers for code intelligence (go-to-definition, find-references, hover)",
   "author": {
     "name": "SpecWeave",
-    "url": "https://verified-skill.com"
+    "url": "https://spec-weave.com"
   },
   "keywords": ["lsp", "typescript", "python", "code-intelligence"]
 }

package/dist/src/core/migration/consolidation-engine.d.ts

@@ -1,59 +0,0 @@
-/**
- * Consolidation Engine
- *
- * Scans nested repo `.specweave/` directories for orphaned increments
- * and living docs, then consolidates them into the umbrella root.
- *
- * Used by `migrate-to-umbrella --consolidate` CLI command.
- *
- * @module core/migration/consolidation-engine
- */
-/**
- * A planned move operation
- */
-export interface ConsolidationMove {
-    /** Source path (absolute) */
-    from: string;
-    /** Destination path (absolute) */
-    to: string;
-    /** Type of item being moved */
-    type: 'increment' | 'living-doc';
-}
-/**
- * A planned deletion operation
- */
-export interface ConsolidationDeletion {
-    /** Path to delete (absolute) */
-    path: string;
-    /** Reason for deletion */
-    reason: 'duplicate';
-}
-/**
- * Plan produced by scanForOrphans(), consumed by executeConsolidation()
- */
-export interface ConsolidationPlan {
-    moves: ConsolidationMove[];
-    deletions: ConsolidationDeletion[];
-}
-/**
- * Scan nested repos for orphaned increments and living docs.
- *
- * For each `repositories/{org}/{repo}/.specweave/increments/{id}/`:
- * - If the same increment ID exists in umbrella root → schedule deletion (duplicate)
- * - If not → schedule move to umbrella root
- *
- * For each `repositories/{org}/{repo}/.specweave/docs/{...}`:
- * - Schedule move to umbrella root docs
- *
- * @param umbrellaRoot - Absolute path to umbrella root directory
- * @returns ConsolidationPlan with moves and deletions
- */
-export declare function scanForOrphans(umbrellaRoot: string): Promise<ConsolidationPlan>;
-/**
- * Execute a consolidation plan: move orphans and delete duplicates.
- *
- * @param plan - ConsolidationPlan from scanForOrphans()
- * @param _umbrellaRoot - Umbrella root path (reserved for future use)
- */
-export declare function executeConsolidation(plan: ConsolidationPlan, _umbrellaRoot: string): Promise<void>;
-//# sourceMappingURL=consolidation-engine.d.ts.map

package/dist/src/core/migration/consolidation-engine.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"consolidation-engine.d.ts","sourceRoot":"","sources":["../../../../src/core/migration/consolidation-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,+BAA+B;IAC/B,IAAI,EAAE,WAAW,GAAG,YAAY,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,SAAS,EAAE,qBAAqB,EAAE,CAAC;CACpC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkDrF;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,iBAAiB,EACvB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/dist/src/core/migration/consolidation-engine.js

@@ -1,177 +0,0 @@
-/**
- * Consolidation Engine
- *
- * Scans nested repo `.specweave/` directories for orphaned increments
- * and living docs, then consolidates them into the umbrella root.
- *
- * Used by `migrate-to-umbrella --consolidate` CLI command.
- *
- * @module core/migration/consolidation-engine
- */
-import * as fs from 'fs';
-import * as path from 'path';
-/**
- * Scan nested repos for orphaned increments and living docs.
- *
- * For each `repositories/{org}/{repo}/.specweave/increments/{id}/`:
- * - If the same increment ID exists in umbrella root → schedule deletion (duplicate)
- * - If not → schedule move to umbrella root
- *
- * For each `repositories/{org}/{repo}/.specweave/docs/{...}`:
- * - Schedule move to umbrella root docs
- *
- * @param umbrellaRoot - Absolute path to umbrella root directory
- * @returns ConsolidationPlan with moves and deletions
- */
-export async function scanForOrphans(umbrellaRoot) {
-    const plan = { moves: [], deletions: [] };
-    const reposDir = path.join(umbrellaRoot, 'repositories');
-    if (!fs.existsSync(reposDir)) {
-        return plan;
-    }
-    // Collect all nested repo paths: repositories/{org}/{repo}
-    const nestedRepoPaths = collectNestedRepoPaths(reposDir);
-    // Get umbrella root increment IDs for duplicate detection
-    const umbrellaIncrementsDir = path.join(umbrellaRoot, '.specweave', 'increments');
-    const umbrellaIncrementIds = listDirectoryNames(umbrellaIncrementsDir);
-    for (const repoPath of nestedRepoPaths) {
-        // Scan increments
-        const nestedIncDir = path.join(repoPath, '.specweave', 'increments');
-        if (fs.existsSync(nestedIncDir)) {
-            const nestedIncrements = listDirectoryNames(nestedIncDir);
-            for (const incName of nestedIncrements) {
-                const nestedIncPath = path.join(nestedIncDir, incName);
-                const umbrellaIncPath = path.join(umbrellaIncrementsDir, incName);
-                if (umbrellaIncrementIds.has(incName)) {
-                    // Duplicate — schedule deletion of nested copy
-                    plan.deletions.push({
-                        path: nestedIncPath,
-                        reason: 'duplicate',
-                    });
-                }
-                else {
-                    // Orphan — schedule move
-                    plan.moves.push({
-                        from: nestedIncPath,
-                        to: umbrellaIncPath,
-                        type: 'increment',
-                    });
-                }
-            }
-        }
-        // Scan docs
-        const nestedDocsDir = path.join(repoPath, '.specweave', 'docs');
-        if (fs.existsSync(nestedDocsDir)) {
-            const umbrellaDocsDir = path.join(umbrellaRoot, '.specweave', 'docs');
-            scanDocsRecursive(nestedDocsDir, umbrellaDocsDir, plan);
-        }
-    }
-    return plan;
-}
-/**
- * Execute a consolidation plan: move orphans and delete duplicates.
- *
- * @param plan - ConsolidationPlan from scanForOrphans()
- * @param _umbrellaRoot - Umbrella root path (reserved for future use)
- */
-export async function executeConsolidation(plan, _umbrellaRoot) {
-    // Execute moves
-    for (const move of plan.moves) {
-        // Ensure parent directory exists
-        const parentDir = path.dirname(move.to);
-        await fs.promises.mkdir(parentDir, { recursive: true });
-        // Move via rename; fall back to copy+delete if across filesystems (EXDEV)
-        try {
-            await fs.promises.rename(move.from, move.to);
-        }
-        catch (e) {
-            if (e.code === 'EXDEV') {
-                await fs.promises.cp(move.from, move.to, { recursive: true });
-                await fs.promises.rm(move.from, { recursive: true, force: true });
-            }
-            else {
-                throw e;
-            }
-        }
-    }
-    // Execute deletions
-    for (const deletion of plan.deletions) {
-        await fs.promises.rm(deletion.path, { recursive: true, force: true });
-    }
-}
-// ---------------------------------------------------------------------------
-// Internal helpers
-// ---------------------------------------------------------------------------
-/**
- * Collect all nested repo paths under repositories/{org}/{repo}
- */
-function collectNestedRepoPaths(reposDir) {
-    const repoPaths = [];
-    try {
-        const orgEntries = fs.readdirSync(reposDir, { withFileTypes: true });
-        for (const orgEntry of orgEntries) {
-            if (!orgEntry.isDirectory())
-                continue;
-            const orgDir = path.join(reposDir, orgEntry.name);
-            const repoEntries = fs.readdirSync(orgDir, { withFileTypes: true });
-            for (const repoEntry of repoEntries) {
-                if (!repoEntry.isDirectory())
-                    continue;
-                repoPaths.push(path.join(orgDir, repoEntry.name));
-            }
-        }
-    }
-    catch {
-        // Ignore read errors
-    }
-    return repoPaths;
-}
-/**
- * List directory names (non-recursive) as a Set
- */
-function listDirectoryNames(dirPath) {
-    const names = new Set();
-    if (!fs.existsSync(dirPath))
-        return names;
-    try {
-        const entries = fs.readdirSync(dirPath, { withFileTypes: true });
-        for (const entry of entries) {
-            if (entry.isDirectory()) {
-                names.add(entry.name);
-            }
-        }
-    }
-    catch {
-        // Ignore read errors
-    }
-    return names;
-}
-/**
- * Recursively scan a nested docs directory for leaf directories to move.
- * Finds the deepest directories containing files and schedules moves.
- */
-function scanDocsRecursive(nestedDocsDir, umbrellaDocsDir, plan) {
-    try {
-        const entries = fs.readdirSync(nestedDocsDir, { withFileTypes: true });
-        const hasFiles = entries.some(e => e.isFile());
-        const subdirs = entries.filter(e => e.isDirectory());
-        if (hasFiles) {
-            // This directory has files — schedule move
-            // umbrellaDocsDir already has the correct target path via recursion
-            plan.moves.push({
-                from: nestedDocsDir,
-                to: umbrellaDocsDir,
-                type: 'living-doc',
-            });
-            return; // Don't recurse further — moving the whole directory
-        }
-        // Recurse into subdirectories
-        for (const subdir of subdirs) {
-            scanDocsRecursive(path.join(nestedDocsDir, subdir.name), path.join(umbrellaDocsDir, subdir.name), plan);
-        }
-    }
-    catch {
-        // Ignore read errors
-    }
-}
-//# sourceMappingURL=consolidation-engine.js.map

package/dist/src/core/migration/consolidation-engine.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"consolidation-engine.js","sourceRoot":"","sources":["../../../../src/core/migration/consolidation-engine.ts"],"names":[],"mappings":"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"}

package/dist/src/core/migration/spec-project-mapper.d.ts

@@ -1,51 +0,0 @@
-/**
- * Spec Project Mapper
- *
- * Maps FS-XXX feature spec folders to their owning project(s) by scanning
- * increment metadata and spec.md **Project**: fields. Used by the
- * --reorganize-specs flag of migrate-to-umbrella.
- *
- * @module core/migration/spec-project-mapper
- */
-export interface ReorgOperation {
-    featureId: string;
-    source: string;
-    destination: string;
-    type: 'move' | 'copy';
-}
-/**
- * Builds a map of FS-XXX feature IDs to their owning project(s).
- *
- * Strategy:
- * 1. Scan all increments for feature_id in metadata.json (explicit link)
- * 2. Fall back to numeric matching: FS-282 → glob 0282-*
- * 3. Parse increment spec.md for **Project**: lines
- * 4. Default to current project folder name when no Project field found
- *
- * @param projectRoot - Root of the umbrella workspace
- * @returns Map of featureId (e.g. "FS-282") to project IDs (e.g. ["vskill-platform"])
- */
-export declare function buildFeatureProjectMap(projectRoot: string): Promise<Map<string, string[]>>;
-/**
- * Generates a list of move/copy operations to reorganize FS-XXX folders
- * from a centralized project directory to per-project directories.
- *
- * @param featureMap - Map from buildFeatureProjectMap()
- * @param specsDir - Path to .specweave/docs/internal/specs/
- * @param currentProject - Name of the current (centralized) project folder
- * @returns List of move/copy operations
- */
-export declare function generateReorganizationPlan(featureMap: Map<string, string[]>, specsDir: string, currentProject: string): Promise<ReorgOperation[]>;
-export interface ReorganizeOptions {
-    execute: boolean;
-}
-/**
- * Executes a reorganization plan: moves/copies FS-XXX folders to per-project
- * directories and enables multiProject mode in config.json.
- *
- * @param plan - List of move/copy operations from generateReorganizationPlan()
- * @param configPath - Path to .specweave/config.json
- * @param options - { execute: true } to apply changes, false for dry-run
- */
-export declare function reorganizeSpecs(plan: ReorgOperation[], configPath: string, options: ReorganizeOptions): Promise<void>;
-//# sourceMappingURL=spec-project-mapper.d.ts.map