specweave 2.2.1 → 2.2.3

package/plugins/specweave/.lint/skill-lint.test.ts

@@ -1,100 +1,15 @@
 /**
- * Tests for skill-lint.ts (0669 Wave 3 / AC-US10-03).
+ * Tests for scripts/lint-skills.mjs — the one linter CI runs (.github/workflows/skill-lint.yml).
  *
- * The linter enforces:
- *   - SKILL.md declaring `allowed-tools` MUST also include a `## Tool-Use Rationale`
- *     section (or `tool-use-rationale:` frontmatter key).
- *   - Retired 4.7 phrases (ULTRATHINK, thinking.budget_tokens, etc.) are flagged.
+ * It keeps the shipped skill surface honest — no `name:` frontmatter, no model/effort/context
+ * pins, short descriptions, every `specweave <cmd>` / `sw:<name>` reference resolvable — and
+ * since 0669 it also owns the two checks that used to sit unused in `.lint/skill-lint.ts`:
+ *   - retired 4.7 phrasing (ULTRATHINK, extended thinking, budget_tokens) is flagged
+ *   - a SKILL.md declaring `allowed-tools` must also carry a `## Tool-Use Rationale` section
+ *     (or a `tool-use-rationale:` frontmatter key)
  */
 
 import { describe, it, expect } from 'vitest';
-import { lintSkillFile } from './skill-lint.js';
-
-describe('skill-lint tool-use-rationale enforcement', () => {
-  it('returns a lint error when SKILL.md has allowed-tools but no tool-use-rationale', async () => {
-    const content = `---
-name: sw/test
-allowed-tools: Read, Grep
----
-
-# Test Skill
-
-Body content without a rationale block.
-`;
-    const result = await lintSkillFile('test/SKILL.md', content);
-    expect(result.errors.some((e) => /tool-use-rationale/i.test(e))).toBe(true);
-  });
-
-  it('returns no errors when both allowed-tools and tool-use-rationale are present', async () => {
-    const content = `---
-name: sw/test
-allowed-tools: Read, Grep
----
-
-# Test Skill
-
-## Tool-Use Rationale
-
-- **Read**: Load spec.md context when AC IDs are referenced.
-- **Grep**: Locate existing ACs to avoid duplication.
-`;
-    const result = await lintSkillFile('test/SKILL.md', content);
-    expect(result.errors).toHaveLength(0);
-  });
-
-  it('accepts the frontmatter-style tool-use-rationale key', async () => {
-    const content = `---
-name: sw/test
-allowed-tools: Read, Grep
-tool-use-rationale: |
-  Read loads context, Grep locates ACs.
----
-
-# Body
-`;
-    const result = await lintSkillFile('test/SKILL.md', content);
-    expect(result.errors).toHaveLength(0);
-  });
-
-  it('flags retired phrases regardless of rationale presence', async () => {
-    const content = `---
-name: sw/test
----
-
-ULTRATHINK BY DEFAULT — think carefully and step-by-step.
-`;
-    const result = await lintSkillFile('test/SKILL.md', content);
-    expect(result.errors.some((e) => /ULTRATHINK/i.test(e))).toBe(true);
-  });
-
-  it('flags thinking.budget_tokens retired phrase', async () => {
-    const content = `---
-name: sw/test
----
-
-Sets thinking.budget_tokens = 4096 during review.
-`;
-    const result = await lintSkillFile('test/SKILL.md', content);
-    expect(result.errors.some((e) => /thinking\.budget_tokens/.test(e))).toBe(true);
-  });
-
-  it('returns no errors when a SKILL.md has no allowed-tools and no retired phrases', async () => {
-    const content = `---
-name: sw/test
----
-
-# Plain skill without tool declarations.
-`;
-    const result = await lintSkillFile('test/SKILL.md', content);
-    expect(result.errors).toHaveLength(0);
-  });
-});
-
-/**
- * Repo-surface lint (2.0): scripts/lint-skills.mjs is the guard that keeps the shipped
- * skill surface honest — no `name:` frontmatter, no model/effort/context pins, short
- * descriptions, and every `specweave <cmd>` / `sw:<name>` reference resolvable.
- */
 // @ts-expect-error — zero-dep .mjs linter, no type declarations by design
 import { lintContent, lintRepo, readRegisteredCommands, readShippedSkills } from '../../../scripts/lint-skills.mjs';
 
@@ -182,3 +97,100 @@ describe('lint-skills: shipped skill surface', () => {
     expect(failures).toEqual([]);
   });
 });
+
+describe('lint-skills: retired 4.7 phrasing', () => {
+  it('flags "ULTRATHINK BY DEFAULT"', () => {
+    const r = lintContent('skills/x/SKILL.md', body('description: short', '\n**ULTRATHINK BY DEFAULT** - validate.\n'), ctx);
+    expect(rules(r)).toEqual(['retired-phrase']);
+    expect(r.errors[0].message).toMatch(/ULTRATHINK BY DEFAULT/);
+    expect(r.errors[0].line).toBe(5);
+  });
+
+  it('flags a bare "Ultrathink" regardless of case', () => {
+    const r = lintContent('skills/x/SKILL.md', body('description: short', '\nUltrathink the plan first.\n'), ctx);
+    expect(r.errors[0].message).toMatch(/Retired phrase "ULTRATHINK"/);
+  });
+
+  it('reports one error, not two, when the longer phrase matches', () => {
+    const r = lintContent('skills/x/SKILL.md', body('description: short', '\nULTRATHINK BY DEFAULT\n'), ctx);
+    expect(r.errors).toHaveLength(1);
+  });
+
+  it('flags "[Extended thinking: ...]" — the survivor a lowercase-only match missed', () => {
+    const r = lintContent(
+      'skills/x/SKILL.md',
+      body('description: short', '\n[Extended thinking: this workflow enforces test-first development.]\n'),
+      ctx,
+    );
+    expect(r.errors[0].message).toMatch(/extended thinking/);
+  });
+
+  it('flags thinking.budget_tokens and spawn-agents-anyway', () => {
+    const r = lintContent(
+      'skills/x/SKILL.md',
+      body('description: short', '\nSets thinking.budget_tokens = 4096.\nEven for small work — spawn agents anyway.\n'),
+      ctx,
+    );
+    expect(rules(r)).toEqual(['retired-phrase', 'retired-phrase']);
+  });
+
+  it('does not flag a phrase quoted inside a fenced code block', () => {
+    const r = lintContent(
+      'skills/x/SKILL.md',
+      body('description: short', '\n```\nULTRATHINK BY DEFAULT - the old wording\n```\n'),
+      ctx,
+    );
+    expect(r.errors).toHaveLength(0);
+  });
+
+  it('does not flag a line that documents the retirement itself', () => {
+    const r = lintContent(
+      'skills/x/SKILL.md',
+      body('description: short', '\nRetired phrases: ULTRATHINK BY DEFAULT, extended thinking, budget_tokens:.\n'),
+      ctx,
+    );
+    expect(r.errors).toHaveLength(0);
+  });
+
+  it('checks non-skill files too (agents, reference, PLUGIN.md)', () => {
+    const r = lintContent('plugins/specweave/agents/x.md', 'Use extended thinking here.\n', {
+      ...ctx,
+      isSkillFile: false,
+    });
+    expect(rules(r)).toEqual(['retired-phrase']);
+  });
+});
+
+describe('lint-skills: tool-use-rationale enforcement', () => {
+  it('returns a lint error when SKILL.md has allowed-tools but no tool-use-rationale', () => {
+    const r = lintContent('skills/x/SKILL.md', body('description: short\nallowed-tools: Read, Grep'), ctx);
+    expect(rules(r)).toEqual(['tool-use-rationale']);
+    expect(r.errors[0].line).toBe(3);
+  });
+
+  it('returns no errors when both allowed-tools and a rationale section are present', () => {
+    const r = lintContent(
+      'skills/x/SKILL.md',
+      body(
+        'description: short\nallowed-tools: Read, Grep',
+        '\n## Tool-Use Rationale\n\n- **Read**: load spec.md context.\n- **Grep**: locate existing ACs.\n',
+      ),
+      ctx,
+    );
+    expect(r.errors).toHaveLength(0);
+  });
+
+  it('accepts the frontmatter-style tool-use-rationale key', () => {
+    const r = lintContent(
+      'skills/x/SKILL.md',
+      body('description: short\nallowed-tools: Read, Grep\ntool-use-rationale: Read loads context, Grep locates ACs.'),
+      ctx,
+    );
+    expect(r.errors).toHaveLength(0);
+  });
+
+  it('says nothing about rationale when the skill declares no tools', () => {
+    const r = lintContent('skills/x/SKILL.md', body('description: short'), ctx);
+    expect(r.errors).toHaveLength(0);
+  });
+});

package/plugins/specweave/skills/team/agents/_protocol.md

@@ -22,8 +22,9 @@ SendMessage({ type: "message", recipient: "team-lead",
   summary: "[Domain] plan ready — proceeding to implementation" })
 ```
 
-**STATUS** — heartbeat after every task or every 2-3 tasks at minimum. Keeps
-team-lead aware of progress and lets it intervene if something is stuck.
+**STATUS** — send when a task completes, and before anything that will keep you
+silent for minutes. The lead watches the ledger (`specweave task list`), not your
+output, so a STATUS is what tells it a silent stretch is work rather than a stall.
 
 ```
 SendMessage({ type: "message", recipient: "team-lead",
@@ -80,53 +81,8 @@ Approve only if you have no unsaved state. Approving terminates your process.
 ## Rules (apply to every agent)
 
 - Do NOT run `sw:done` or `sw:review` — the lead closes the increment centrally
-- WRITE only to your assigned file patterns (listed in the domain template below)
-- READ any file for context
-- Send STATUS heartbeat after every 2-3 tasks minimum
-- Do NOT wait for team-lead response to PLAN_READY — proceed immediately
-- ALL repository operations MUST use `repositories/{ORG}/` directory structure
-- Create `.specweave/increments/` in YOUR assigned repo, NOT in the umbrella project root
-- **Workflow Mode** (below) is OPT-IN and default-off — only borrow a `Workflow()` for a ≥~25 same-shape independent-task batch, exactly once, and only if `quality.workflows.agentBorrow.enabled` is true
-
-## Workflow Mode (OPT-IN — large homogeneous batch only)
-
-You normally implement tasks sequentially. **IF AND ONLY IF** your assigned task list is a **large homogeneous batch** — **≥~25 tasks of the same shape with no cross-task dependencies** (e.g. apply the same rename/migration/edit to N files, port N similar tests, audit N modules) — you MAY call `Workflow()` **EXACTLY ONCE** to fan them out.
-
-**Gate (ALL must hold, else implement sequentially):**
-- `quality.workflows.enabled === true` AND `quality.workflows.agentBorrow.enabled === true` in `.specweave/config.json` (both default **off** — if absent/false, do NOT use Workflow).
-- ≥~25 same-shape, independent tasks (`quality.workflows.batchShapeThreshold`, default 25).
-- Projected concurrency ≤ `quality.workflows.maxSubagentsPerWorkflow` (≤16) and projected tokens ≤ `quality.workflows.perRunTokenBudget`.
-
-**Nesting law (HARD):** You were spawned by team-lead via the `Task` tool, so you ARE allowed ONE `Workflow()` call. The subagents your Workflow spawns are **leaves** — they CANNOT call `Workflow()` (it throws). One borrow, one level down. Never nest.
-
-**Heartbeat-before-Workflow (MANDATORY — prevents false-kill):** A background Workflow makes you silent for minutes. BEFORE the call, emit a STATUS that declares the delegation so team-lead extends its stuck-detection window (see SKILL.md §8b Workflow-Aware Stuck Detection):
-
-```
-SendMessage({ type: "message", recipient: "team-lead",
-  content: "STATUS: T-{N}/{total} — DELEGATING {batchCount} tasks to background Workflow (workflow_id={id}). Expect silence until WORKFLOW_DONE.",
-  summary: "[Domain] entering Workflow Mode — {batchCount} tasks" })
-```
-On completion emit `STATUS: WORKFLOW_DONE — {done}/{batchCount} ok, {failed} failed. Resuming T-{M}.` then resume normal heartbeats.
-
-**Template** (one call; results stay in script vars, NOT your context). Inject SpecWeave context (spec/AC refs, file paths) into every agent prompt — Workflow is domain-blind:
-
-```js
-export const meta = {
-  name: "batch-fanout",
-  description: "Fan out a homogeneous batch of same-shape tasks",
-  phases: [{ title: "batch" }],
-};
-const items = [/* the >=25 same-shape task descriptors: { target, acRef, file } */];
-const results = await parallel(
-  items.map((it) => () => agent(
-    `Apply <the same transform> to ${it.target}. Spec: ${it.acRef}. Write ONLY ${it.file}.`,
-    { label: it.target, phase: "batch", isolation: "worktree" }
-  ))
-);
-log(`batch complete: ${results.filter(Boolean).length}/${items.length}`);
-return results;
-```
-
-**Budget guard:** Keep projected tokens under `quality.workflows.perRunTokenBudget`. If your batch would exceed it, split into fewer items or fall back to sequential — do NOT raise the cap yourself.
-
-**If the gate fails for any reason → implement the tasks sequentially as usual.** Workflow Mode is an optimization, never a requirement.
+- Write only to your assigned file patterns (listed in the domain template below)
+- Read any file for context
+- Do not wait for a team-lead response to PLAN_READY — proceed immediately
+- All repository operations use the `repositories/{ORG}/` directory structure
+- Create `.specweave/increments/` in your assigned repo, not in the umbrella project root

package/plugins/specweave/skills/team/agents/backend.md

@@ -27,13 +27,10 @@ WORKFLOW:
   6. Create plan.md and tasks.md
   7. Send PLAN_READY (shared protocol) — do NOT wait for approval
   8. Deliverables: API endpoints, services, middleware, OpenAPI spec
-  9. STATUS heartbeat after each task
-  10. `npm test` — do NOT signal COMPLETION until green
-  11. Send COMPLETION with backend-specific fields
+  9. `npm test` — do NOT signal COMPLETION until green
+  10. Send COMPLETION with backend-specific fields
 
 DOMAIN RULES:
   - Every new API endpoint needs request/response validation
   - Error handling follows project conventions
   - All services must have unit tests
-  - Workflow Mode: for >=~25 independent same-shape endpoints/DTOs,
-    you MAY borrow a Workflow() ONCE (see _protocol.md; gated on quality.workflows.agentBorrow.enabled)

package/plugins/specweave/skills/team/agents/brainstorm-advocate.md

@@ -40,8 +40,10 @@ YOUR ANALYSIS MUST INCLUDE:
   ### Migration Path
   If this requires changing existing code, outline the migration strategy.
 
-PROGRESS UPDATES (MANDATORY — prevents false stuck detection):
-  After completing each APPROACH step, send a brief heartbeat:
+PROGRESS UPDATES:
+  Your plain text output is not visible to team-lead, so send a heartbeat as you
+  finish each APPROACH step — a silent stretch is otherwise indistinguishable
+  from a stalled agent:
   SendMessage({
     to: "team-lead",
     message: "STATUS: [Step N/4] [what you just finished]. Proceeding to [next step].",

package/plugins/specweave/skills/team/agents/brainstorm-critic.md

@@ -49,8 +49,10 @@ YOUR ANALYSIS MUST INCLUDE:
   ### Red Lines
   Absolute dealbreakers — conditions under which an approach should be rejected outright.
 
-PROGRESS UPDATES (MANDATORY — prevents false stuck detection):
-  After completing each APPROACH step, send a brief heartbeat:
+PROGRESS UPDATES:
+  Your plain text output is not visible to team-lead, so send a heartbeat as you
+  finish each APPROACH step — a silent stretch is otherwise indistinguishable
+  from a stalled agent:
   SendMessage({
     to: "team-lead",
     message: "STATUS: [Step N/4] [what you just finished]. Proceeding to [next step].",

package/plugins/specweave/skills/team/agents/brainstorm-pragmatist.md

@@ -57,8 +57,10 @@ YOUR ANALYSIS MUST INCLUDE:
   Features or aspects that seem important but aren't worth the effort right now.
   YAGNI candidates.
 
-PROGRESS UPDATES (MANDATORY — prevents false stuck detection):
-  After completing each APPROACH step, send a brief heartbeat:
+PROGRESS UPDATES:
+  Your plain text output is not visible to team-lead, so send a heartbeat as you
+  finish each APPROACH step — a silent stretch is otherwise indistinguishable
+  from a stalled agent:
   SendMessage({
     to: "team-lead",
     message: "STATUS: [Step N/4] [what you just finished]. Proceeding to [next step].",

package/plugins/specweave/skills/team/agents/database.md

@@ -30,5 +30,3 @@ DOMAIN RULES:
   - Always create migrations (never modify schema without a migration)
   - Seed data must be idempotent
   - Schema changes should be backward-compatible when possible
-  - Workflow Mode: for a bulk migration touching >=~25 independent tables/files,
-    you MAY borrow a Workflow() ONCE (see _protocol.md; gated on quality.workflows.agentBorrow.enabled)

package/plugins/specweave/skills/team/agents/testing.md

@@ -33,5 +33,3 @@ DOMAIN RULES:
   - Tests must cover all ACs from spec.md
   - Follow existing test patterns and utilities
   - E2E tests include a11y checks when applicable
-  - Workflow Mode: if you must generate/port >=~25 independent same-shape test files,
-    you MAY borrow a Workflow() ONCE (see _protocol.md; gated on quality.workflows.agentBorrow.enabled)

package/dist/src/cli/helpers/init/ado-repo-cloning.d.ts

@@ -1,32 +0,0 @@
-/**
- * ADO Repository Cloning
- *
- * Handles fetching and cloning Azure DevOps repositories during init.
- * Cloning runs in background (non-blocking) via job manager.
- *
- * @module cli/helpers/init/ado-repo-cloning
- */
-import { type ClonePatternResult } from '../selection-strategy.js';
-/**
- * ADO project selection (from repository-setup.ts)
- */
-export interface AdoProjectSelection {
-    org: string;
-    pat: string;
-    projects: string[];
-}
-/**
- * Trigger ADO repository cloning during init
- *
- * This function:
- * 1. Fetches repository list from each selected ADO project
- * 2. Filters repositories by clone pattern (glob/regex)
- * 3. Creates a background job for cloning
- * 4. Starts cloning asynchronously (non-blocking)
- *
- * @param projectPath - Target directory for cloning
- * @param adoProjectSelection - ADO org, PAT, and selected projects
- * @param clonePattern - Clone pattern configuration
- */
-export declare function triggerAdoRepoCloning(projectPath: string, adoProjectSelection: AdoProjectSelection, clonePattern: ClonePatternResult): Promise<string | undefined>;
-//# sourceMappingURL=ado-repo-cloning.d.ts.map

package/dist/src/cli/helpers/init/ado-repo-cloning.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ado-repo-cloning.d.ts","sourceRoot":"","sources":["../../../../../src/cli/helpers/init/ado-repo-cloning.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAA+B,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAGhG;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAuDD;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,mBAAmB,EACxC,YAAY,EAAE,kBAAkB,GAC/B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA0G7B"}

package/dist/src/cli/helpers/init/ado-repo-cloning.js

@@ -1,157 +0,0 @@
-/**
- * ADO Repository Cloning
- *
- * Handles fetching and cloning Azure DevOps repositories during init.
- * Cloning runs in background (non-blocking) via job manager.
- *
- * @module cli/helpers/init/ado-repo-cloning
- */
-import chalk from 'chalk';
-import { AzureDevOpsProvider } from '../../../core/repo-structure/providers/azure-devops-provider.js';
-import { filterRepositoriesByPattern } from '../selection-strategy.js';
-import { launchCloneJob } from '../../../core/background/job-launcher.js';
-/**
- * Sanitize ADO project name for use as filesystem folder name
- *
- * ADO project names can contain:
- * - Spaces: "My Enterprise Project"
- * - Special characters that are invalid in paths
- *
- * This function creates a filesystem-safe folder name while preserving readability.
- */
-function sanitizeProjectNameForPath(projectName) {
-    return projectName
-        .toLowerCase()
-        .replace(/\s+/g, '-') // Spaces → hyphens
-        .replace(/[<>:"|?*\\\/]/g, '') // Remove filesystem-invalid chars
-        .replace(/&/g, '-and-') // & → -and-
-        .replace(/-+/g, '-') // Collapse multiple hyphens
-        .replace(/^-|-$/g, ''); // Trim leading/trailing hyphens
-}
-/**
- * Build proper ADO clone URL with PAT authentication
- *
- * ADO clone URL format: https://{PAT}@dev.azure.com/{org}/{project}/_git/{repo}
- *
- * The remoteUrl from ADO API may come in different formats:
- * - https://dev.azure.com/org/project/_git/repo
- * - https://org@dev.azure.com/org/project/_git/repo (with org as placeholder)
- *
- * We need to construct a proper URL with PAT authentication.
- * IMPORTANT: URL-encode org, project, and repo names to handle spaces and special characters.
- */
-function buildAdoCloneUrl(org, project, repoName, pat) {
-    // Build clean URL with PAT authentication
-    // Format: https://{PAT}@dev.azure.com/{org}/{project}/_git/{repo}
-    // URL-encode path segments to handle spaces (e.g., "My Enterprise Project")
-    const encodedOrg = encodeURIComponent(org);
-    const encodedProject = encodeURIComponent(project);
-    const encodedRepo = encodeURIComponent(repoName);
-    return `https://${pat}@dev.azure.com/${encodedOrg}/${encodedProject}/_git/${encodedRepo}`;
-}
-/**
- * Trigger ADO repository cloning during init
- *
- * This function:
- * 1. Fetches repository list from each selected ADO project
- * 2. Filters repositories by clone pattern (glob/regex)
- * 3. Creates a background job for cloning
- * 4. Starts cloning asynchronously (non-blocking)
- *
- * @param projectPath - Target directory for cloning
- * @param adoProjectSelection - ADO org, PAT, and selected projects
- * @param clonePattern - Clone pattern configuration
- */
-export async function triggerAdoRepoCloning(projectPath, adoProjectSelection, clonePattern) {
-    // Skip if user chose to skip cloning
-    if (clonePattern.strategy === 'skip') {
-        console.log(chalk.gray('\n   Skipping repository cloning (can configure later with sw:ado-clone-repos)\n'));
-        return undefined;
-    }
-    const { org, pat, projects } = adoProjectSelection;
-    if (!projects || projects.length === 0) {
-        console.log(chalk.yellow('\n   No ADO projects selected for cloning.\n'));
-        return;
-    }
-    if (!pat) {
-        console.log(chalk.yellow('\n   No PAT provided. Cannot clone repositories.\n'));
-        return;
-    }
-    console.log(chalk.blue('\n📦 Fetching ADO Repositories\n'));
-    const provider = new AzureDevOpsProvider();
-    const allRepos = [];
-    // Fetch repositories from each selected project
-    for (const project of projects) {
-        try {
-            console.log(chalk.gray(`   Fetching from ${org}/${project}...`));
-            const repos = await provider.listRepositories(org, project, pat);
-            const reposWithProject = repos.map(r => ({ ...r, project }));
-            allRepos.push(...reposWithProject);
-            console.log(chalk.green(`   ✓ Found ${repos.length} repositories in ${project}`));
-        }
-        catch (error) {
-            const errorMsg = error instanceof Error ? error.message : String(error);
-            console.log(chalk.yellow(`   ⚠️ Failed to fetch from ${project}: ${errorMsg}`));
-        }
-    }
-    if (allRepos.length === 0) {
-        console.log(chalk.yellow('\n   No repositories found in selected projects.\n'));
-        return;
-    }
-    // Filter by pattern
-    const filteredRepos = filterRepositoriesByPattern(allRepos, clonePattern);
-    if (filteredRepos.length === 0) {
-        const patternDesc = clonePattern.pattern ? ` matching "${clonePattern.pattern}"` : '';
-        console.log(chalk.yellow(`\n   No repositories${patternDesc} to clone.\n`));
-        return;
-    }
-    // Group repos by project for display
-    const projectGroups = new Map();
-    for (const repo of filteredRepos) {
-        const group = projectGroups.get(repo.project) || [];
-        group.push(repo);
-        projectGroups.set(repo.project, group);
-    }
-    console.log(chalk.blue(`\n🔄 Starting background clone for ${filteredRepos.length} repositories...\n`));
-    // Show project structure
-    for (const [project, repos] of projectGroups) {
-        const sanitizedName = sanitizeProjectNameForPath(project);
-        console.log(chalk.gray(`   📁 ${sanitizedName}/ (${repos.length} repos from "${project}")`));
-    }
-    console.log('');
-    // Prepare repositories with clone URLs (organized by org folder)
-    // v1.0.21: Clone into repositories/{org}/repo-name/ structure
-    // This keeps all cloned repos organized and separate from the main project
-    // NOTE: ADO org replaces the old project-based structure for consistency across providers
-    const reposWithUrls = filteredRepos.map(r => {
-        return {
-            owner: `${org}/${r.project}`,
-            name: r.name,
-            path: `repositories/${org}/${r.name}`, // Clone into repositories/{org}/{repo}
-            cloneUrl: buildAdoCloneUrl(org, r.project, r.name, pat)
-        };
-    });
-    // Launch background clone job (truly async - spawns detached process)
-    const result = await launchCloneJob({
-        projectPath,
-        repositories: reposWithUrls
-    });
-    // Show progress info (skip if all repos were already cloned)
-    if (!result.skippedPreFlight) {
-        console.log(chalk.gray(`   Repositories will be cloned to: ${projectPath}/repositories/${org}/`));
-        console.log(chalk.gray(`   Job ID: ${result.job.id}`));
-        if (result.isBackground) {
-            console.log(chalk.green(`   ✓ Clone job started in background (PID: ${result.pid})`));
-            console.log(chalk.cyan('\n   Check progress: sw:jobs'));
-            console.log(chalk.cyan(`   Kill if needed: sw:jobs --kill ${result.job.id}`));
-            console.log(chalk.gray('\n   Init will continue - cloning runs independently.\n'));
-        }
-        else {
-            console.log(chalk.yellow('   ⚠️ Running in foreground (clone worker not found)'));
-            console.log(chalk.gray('   Init will block until cloning completes.\n'));
-        }
-    }
-    // Return job ID for dependency tracking
-    return result.job.id;
-}
-//# sourceMappingURL=ado-repo-cloning.js.map

package/dist/src/cli/helpers/init/ado-repo-cloning.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ado-repo-cloning.js","sourceRoot":"","sources":["../../../../../src/cli/helpers/init/ado-repo-cloning.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/helpers/init/api-docs-config.d.ts

@@ -1,67 +0,0 @@
-/**
- * API Documentation configuration prompts
- * Handles OpenAPI and Postman collection settings for API projects
- *
- * @module api-docs-config
- * @since v1.0.58
- */
-import type { SupportedLanguage } from '../../../core/i18n/types.js';
-import { WIZARD_BACK } from './wizard-navigation.js';
-/**
- * API Documentation configuration
- */
-export interface ApiDocsConfig {
-    /** Enable API documentation features */
-    enabled: boolean;
-    /** OpenAPI spec location */
-    openApiPath: string;
-    /** Auto-generate OpenAPI from code decorators */
-    autoGenerateOpenApi: boolean;
-    /** Generate Postman collection from OpenAPI */
-    generatePostman: boolean;
-    /** Postman collection output path */
-    postmanPath: string;
-    /** When to regenerate API docs */
-    generateOn: 'on-increment-done' | 'on-api-change' | 'manual';
-    /** API file patterns to watch */
-    watchPatterns: string[];
-    /** Base URL for the API */
-    baseUrl: string;
-}
-/**
- * Detected API framework
- */
-export interface DetectedApiFramework {
-    name: string;
-    openApiSupport: 'built-in' | 'plugin' | 'manual';
-    setupInstructions: string;
-}
-/**
- * Detect API framework from project files
- */
-export declare function detectApiFramework(targetDir: string): DetectedApiFramework | null;
-/**
- * Result of API docs configuration
- */
-export interface ApiDocsConfigResult {
-    config: ApiDocsConfig | null;
-    /** Signal to go back to previous step */
-    goBack?: typeof WIZARD_BACK;
-}
-/**
- * Prompt user for API documentation configuration
- *
- * @param targetDir - Project directory
- * @param language - Language for translations
- * @returns API docs configuration or null if skipped
- */
-export declare function promptApiDocsConfig(targetDir: string, language?: SupportedLanguage): Promise<ApiDocsConfigResult>;
-/**
- * Update config.json with API docs configuration
- *
- * @param targetDir - Project directory
- * @param config - API docs configuration
- * @param language - Language for translations
- */
-export declare function updateConfigWithApiDocs(targetDir: string, config: ApiDocsConfig, language?: SupportedLanguage): void;
-//# sourceMappingURL=api-docs-config.d.ts.map

package/dist/src/cli/helpers/init/api-docs-config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-docs-config.d.ts","sourceRoot":"","sources":["../../../../../src/cli/helpers/init/api-docs-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,WAAW,EAAyC,MAAM,wBAAwB,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IAEjB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IAEpB,iDAAiD;IACjD,mBAAmB,EAAE,OAAO,CAAC;IAE7B,+CAA+C;IAC/C,eAAe,EAAE,OAAO,CAAC;IAEzB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IAEpB,kCAAkC;IAClC,UAAU,EAAE,mBAAmB,GAAG,eAAe,GAAG,QAAQ,CAAC;IAE7D,iCAAiC;IACjC,aAAa,EAAE,MAAM,EAAE,CAAC;IAExB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACjD,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AA0KD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAyIjF;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,yCAAyC;IACzC,MAAM,CAAC,EAAE,OAAO,WAAW,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,iBAAwB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CA2G9B;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,EACrB,QAAQ,GAAE,iBAAwB,GACjC,IAAI,CAWN"}