specweave 0.18.1 → 0.20.1

package/dist/src/core/sync/spec-content-sync.d.ts

@@ -1,88 +0,0 @@
-/**
- * Type definitions for spec content synchronization with external tools
- */
-export interface SpecIdentifier {
-    /** Compact format: SPEC-0031 */
-    compact: string;
-    /** Full format: spec-0031-external-tool-status-sync */
-    full: string;
-}
-export interface AcceptanceCriterion {
-    /** AC identifier: AC-US1-01 */
-    id: string;
-    /** Description of the acceptance criterion */
-    description: string;
-    /** Priority: P1, P2, P3 */
-    priority?: string;
-    /** Whether this criterion is testable */
-    testable?: boolean;
-}
-export interface UserStory {
-    /** User story ID: 001, 002, etc. */
-    id: string;
-    /** Title of the user story */
-    title: string;
-    /** As a... (role) */
-    asA: string;
-    /** I want... (action) */
-    iWant: string;
-    /** So that... (benefit) */
-    soThat: string;
-    /** Acceptance criteria for this user story */
-    acceptanceCriteria: AcceptanceCriterion[];
-}
-export interface Task {
-    /** Task ID: T-001, T-002, etc. */
-    id: string;
-    /** Title of the task */
-    title: string;
-    /** User stories this task implements */
-    userStories: string[];
-    /** GitHub issue number (if synced) */
-    githubIssue?: number;
-}
-export interface TaskMapping {
-    /** Increment ID this mapping belongs to */
-    incrementId: string;
-    /** Tasks from the increment */
-    tasks: Task[];
-    /** URL to tasks.md file */
-    tasksUrl: string;
-}
-export interface ArchitectureDoc {
-    /** Type of architecture document */
-    type: 'adr' | 'hld' | 'diagram';
-    /** Path to the document */
-    path: string;
-    /** Title/description of the document */
-    title: string;
-}
-export interface SourceLinks {
-    /** Link to spec.md */
-    spec?: string;
-    /** Link to plan.md */
-    plan?: string;
-    /** Link to tasks.md */
-    tasks?: string;
-}
-export interface SpecContent {
-    /** Spec identifier */
-    identifier: SpecIdentifier;
-    /** Title of the spec */
-    title: string;
-    /** Project this spec belongs to */
-    project: string;
-    /** Executive summary */
-    summary: string;
-    /** User stories */
-    userStories: UserStory[];
-    /** Metadata (priority, etc.) */
-    metadata: Record<string, any>;
-    /** Task mapping (optional) */
-    taskMapping?: TaskMapping;
-    /** Architecture documents (optional) */
-    architectureDocs?: ArchitectureDoc[];
-    /** Source links (optional) */
-    sourceLinks?: SourceLinks;
-}
-//# sourceMappingURL=spec-content-sync.d.ts.map

package/dist/src/core/sync/spec-content-sync.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec-content-sync.d.ts","sourceRoot":"","sources":["../../../../src/core/sync/spec-content-sync.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,kBAAkB,EAAE,mBAAmB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,IAAI;IACnB,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;IAChC,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,sBAAsB;IACtB,UAAU,EAAE,cAAc,CAAC;IAC3B,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,8BAA8B;IAC9B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,8BAA8B;IAC9B,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B"}

package/dist/src/core/sync/spec-content-sync.js

@@ -1,5 +0,0 @@
-/**
- * Type definitions for spec content synchronization with external tools
- */
-export {};
-//# sourceMappingURL=spec-content-sync.js.map

package/dist/src/core/sync/spec-content-sync.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec-content-sync.js","sourceRoot":"","sources":["../../../../src/core/sync/spec-content-sync.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/tsconfig.tsbuildinfo

@@ -1 +0,0 @@
-{"root":["../src/adapters/adapter-base.ts","../src/adapters/adapter-interface.ts","../src/adapters/adapter-loader.ts","../src/adapters/agents-md-generator.ts","../src/adapters/claude-md-generator.ts","../src/adapters/doc-generator.ts","../src/adapters/claude/adapter.ts","../src/adapters/codex/adapter.ts","../src/adapters/cursor/adapter.ts","../src/adapters/gemini/adapter.ts","../src/adapters/generic/adapter.ts","../src/cli/commands/abandon.ts","../src/cli/commands/check-discipline.ts","../src/cli/commands/cicd-monitor.ts","../src/cli/commands/detect-project.ts","../src/cli/commands/detect-specs.ts","../src/cli/commands/import-docs.ts","../src/cli/commands/init-multiproject.ts","../src/cli/commands/init.ts","../src/cli/commands/install.ts","../src/cli/commands/list.ts","../src/cli/commands/migrate-to-multiproject.ts","../src/cli/commands/migrate-to-profiles.ts","../src/cli/commands/pause.ts","../src/cli/commands/qa.ts","../src/cli/commands/resume.ts","../src/cli/commands/revert-wip-limit.ts","../src/cli/commands/status-line.ts","../src/cli/commands/status.ts","../src/cli/commands/switch-project.ts","../src/cli/commands/sync-spec-commits.ts","../src/cli/commands/sync-spec-content.ts","../src/cli/commands/validate-jira.ts","../src/cli/commands/validate-parent-repo.ts","../src/cli/commands/validate-plugins.ts","../src/cli/helpers/github/increment-profile-selector.ts","../src/cli/helpers/github/profile-manager.ts","../src/cli/helpers/issue-tracker/ado.ts","../src/cli/helpers/issue-tracker/github-multi-repo.ts","../src/cli/helpers/issue-tracker/github.ts","../src/cli/helpers/issue-tracker/index.ts","../src/cli/helpers/issue-tracker/jira.ts","../src/cli/helpers/issue-tracker/types.ts","../src/cli/helpers/issue-tracker/utils.ts","../src/core/comment-builder.ts","../src/core/config-manager.ts","../src/core/cost-tracker.ts","../src/core/credentials-manager.ts","../src/core/increment-status.ts","../src/core/plugin-loader.ts","../src/core/project-manager.ts","../src/core/project-structure-detector.ts","../src/core/rfc-generator-v2.ts","../src/core/spec-content-sync.ts","../src/core/spec-detector.ts","../src/core/spec-identifier-detector.ts","../src/core/spec-task-mapper.ts","../src/core/brownfield/analyzer.ts","../src/core/brownfield/importer.ts","../src/core/cicd/config-loader.ts","../src/core/cicd/index.ts","../src/core/cicd/monitor-service.ts","../src/core/cicd/notifier.ts","../src/core/cicd/parent-repo-validator.ts","../src/core/cicd/state-manager.ts","../src/core/cicd/types.ts","../src/core/cicd/workflow-monitor.ts","../src/core/i18n/language-detector.ts","../src/core/i18n/language-manager.ts","../src/core/i18n/language-registry.ts","../src/core/i18n/locale-manager.ts","../src/core/i18n/system-prompt-injector.ts","../src/core/i18n/types.ts","../src/core/increment/active-increment-manager.ts","../src/core/increment/discipline-checker.ts","../src/core/increment/limits.ts","../src/core/increment/metadata-manager.ts","../src/core/increment/metadata-validator.ts","../src/core/increment/status-commands.ts","../src/core/increment/types.ts","../src/core/living-docs/content-classifier.ts","../src/core/living-docs/content-distributor.ts","../src/core/living-docs/content-parser.ts","../src/core/living-docs/cross-linker.ts","../src/core/living-docs/index.ts","../src/core/living-docs/project-detector.ts","../src/core/living-docs/spec-distributor.ts","../src/core/living-docs/types.ts","../src/core/qa/qa-runner.ts","../src/core/qa/quality-gate-decider.ts","../src/core/qa/risk-calculator.ts","../src/core/qa/types.ts","../src/core/repo-structure/folder-detector.ts","../src/core/repo-structure/github-validator.ts","../src/core/repo-structure/prompt-consolidator.ts","../src/core/repo-structure/repo-id-generator.ts","../src/core/repo-structure/repo-structure-manager.ts","../src/core/repo-structure/setup-state-manager.ts","../src/core/repo-structure/setup-summary.ts","../src/core/specs/spec-metadata-manager.ts","../src/core/specs/spec-parser.ts","../src/core/status-line/status-line-manager.ts","../src/core/status-line/types.ts","../src/core/sync/bidirectional-engine.ts","../src/core/sync/conflict-resolver.ts","../src/core/sync/enhanced-content-builder.ts","../src/core/sync/folder-mapper.ts","../src/core/sync/profile-manager.ts","../src/core/sync/profile-selector.ts","../src/core/sync/profile-validator.ts","../src/core/sync/project-context.ts","../src/core/sync/rate-limiter.ts","../src/core/sync/retry-logic.ts","../src/core/sync/spec-increment-mapper.ts","../src/core/sync/status-cache.ts","../src/core/sync/status-mapper.ts","../src/core/sync/status-sync-engine.ts","../src/core/sync/sync-event-logger.ts","../src/core/sync/time-range-selector.ts","../src/core/sync/workflow-detector.ts","../src/core/types/config.ts","../src/core/types/increment-metadata.ts","../src/core/types/plugin.ts","../src/core/types/spec-identifier.ts","../src/core/types/spec-metadata.ts","../src/core/types/sync-profile.ts","../src/integrations/ado/ado-client.ts","../src/integrations/jira/jira-client.ts","../src/integrations/jira/jira-incremental-mapper.ts","../src/integrations/jira/jira-mapper.ts","../src/metrics/dora-calculator.ts","../src/metrics/github-client.ts","../src/metrics/report-generator.ts","../src/metrics/types.ts","../src/metrics/calculators/change-failure-rate.ts","../src/metrics/calculators/deployment-frequency.ts","../src/metrics/calculators/lead-time.ts","../src/metrics/calculators/mttr.ts","../src/metrics/utils/percentile.ts","../src/metrics/utils/tier-classifier.ts","../src/testing/test-generator.ts","../src/types/cost-tracking.ts","../src/types/model-selection.ts","../src/utils/agents-md-compiler.ts","../src/utils/auth-helpers.ts","../src/utils/auto-install.ts","../src/utils/claude-cli-detector.ts","../src/utils/cost-reporter.ts","../src/utils/env-file-generator.ts","../src/utils/env-file.ts","../src/utils/env-multi-project-parser.ts","../src/utils/esm-helpers.ts","../src/utils/execfilenothrow.ts","../src/utils/external-resource-validator.ts","../src/utils/generate-skills-index.ts","../src/utils/git-detector.ts","../src/utils/git-utils.ts","../src/utils/model-selection.ts","../src/utils/plugin-validator.ts","../src/utils/pricing-constants.ts","../src/utils/project-detection.ts","../src/utils/project-mapper.ts","../src/utils/project-validator.ts","../src/utils/spec-parser.ts","../src/utils/spec-splitter.ts","../src/utils/string-utils.ts","../src/utils/translation.ts","../src/utils/docs-preview/config-generator.ts","../src/utils/docs-preview/docusaurus-setup.ts","../src/utils/docs-preview/index.ts","../src/utils/docs-preview/package-installer.ts","../src/utils/docs-preview/server-manager.ts","../src/utils/docs-preview/sidebar-builder.ts","../src/utils/docs-preview/types.ts","../plugins/specweave/lib/hooks/git-diff-analyzer.ts","../plugins/specweave/lib/hooks/invoke-translator-skill.ts","../plugins/specweave/lib/hooks/prepare-reflection-context.ts","../plugins/specweave/lib/hooks/reflection-config-loader.ts","../plugins/specweave/lib/hooks/reflection-parser.ts","../plugins/specweave/lib/hooks/reflection-prompt-builder.ts","../plugins/specweave/lib/hooks/reflection-storage.ts","../plugins/specweave/lib/hooks/run-self-reflection.ts","../plugins/specweave/lib/hooks/sync-living-docs.ts","../plugins/specweave/lib/hooks/translate-file.ts","../plugins/specweave/lib/hooks/translate-living-docs.ts","../plugins/specweave/lib/hooks/update-tasks-md.ts","../plugins/specweave/lib/hooks/types/reflection-types.ts","../plugins/specweave-ado/lib/ado-board-resolver.d.ts","../plugins/specweave-ado/lib/ado-client-v2.ts","../plugins/specweave-ado/lib/ado-client.ts","../plugins/specweave-ado/lib/ado-hierarchical-sync.d.ts","../plugins/specweave-ado/lib/ado-spec-commit-sync.ts","../plugins/specweave-ado/lib/ado-spec-content-sync.ts","../plugins/specweave-ado/lib/ado-spec-sync.ts","../plugins/specweave-ado/lib/ado-status-sync.ts","../plugins/specweave-ado/lib/enhanced-ado-sync.ts","../plugins/specweave-ado/lib/project-selector.d.ts","../plugins/specweave-github/lib/cli-sync-increment-changes.ts","../plugins/specweave-github/lib/enhanced-github-sync.ts","../plugins/specweave-github/lib/github-board-resolver.d.ts","../plugins/specweave-github/lib/github-client-v2.ts","../plugins/specweave-github/lib/github-client.ts","../plugins/specweave-github/lib/github-epic-sync.ts","../plugins/specweave-github/lib/github-hierarchical-sync.d.ts","../plugins/specweave-github/lib/github-issue-updater.ts","../plugins/specweave-github/lib/github-spec-commit-sync.ts","../plugins/specweave-github/lib/github-spec-content-sync.ts","../plugins/specweave-github/lib/github-spec-sync.ts","../plugins/specweave-github/lib/github-status-sync.ts","../plugins/specweave-github/lib/github-sync-bidirectional.ts","../plugins/specweave-github/lib/github-sync-increment-changes.ts","../plugins/specweave-github/lib/index.ts","../plugins/specweave-github/lib/repo-selector.d.ts","../plugins/specweave-github/lib/subtask-sync.ts","../plugins/specweave-github/lib/task-parser.ts","../plugins/specweave-github/lib/task-sync.ts","../plugins/specweave-github/lib/types.ts","../plugins/specweave-jira/lib/enhanced-jira-sync.ts","../plugins/specweave-jira/lib/jira-board-resolver.d.ts","../plugins/specweave-jira/lib/jira-epic-sync.ts","../plugins/specweave-jira/lib/jira-hierarchical-sync.d.ts","../plugins/specweave-jira/lib/jira-spec-commit-sync.ts","../plugins/specweave-jira/lib/jira-spec-content-sync.ts","../plugins/specweave-jira/lib/jira-spec-sync.ts","../plugins/specweave-jira/lib/jira-status-sync.ts","../plugins/specweave-jira/lib/project-selector.d.ts","../plugins/specweave-jira/lib/reorganization-detector.ts","../plugins/specweave-jira/lib/setup-wizard.ts","../plugins/specweave-release/lib/dashboard-generator.ts","../plugins/specweave-release/lib/dora-tracker.ts"],"errors":true,"version":"5.9.3"}

package/plugins/specweave-ado/commands/specweave-ado-sync-spec.md

@@ -1,255 +0,0 @@
----
-name: specweave-ado-sync-spec
-description: Sync SpecWeave spec to Azure DevOps Feature (bidirectional). Use when syncing .specweave/docs/internal/specs/spec-*.md files with ADO Features for permanent feature tracking.
----
-
-# Sync Spec to Azure DevOps Feature
-
-**CORRECT ARCHITECTURE**: This command syncs `.specweave/docs/internal/specs/spec-*.md` files (PERMANENT living docs) to Azure DevOps Features, NOT increments to work items.
-
-## Usage
-
-```bash
-/specweave-ado:sync-spec <spec-id> [--direction <to-ado|from-ado|bidirectional>]
-```
-
-## What It Does
-
-**Architecture**:
-- **Spec → ADO Feature** (not increment → work item!)
-- **User Story → ADO User Story** (child of feature)
-- **Acceptance Criteria → Checklist** (in user story description)
-
-**Sync Process**:
-
-1. **Load spec** from `.specweave/docs/internal/specs/spec-{id}.md`
-2. **Load ADO configuration** from `.env` (organization, project, PAT)
-3. **Create or update ADO Feature**:
-   - Title: `[SPEC-001] Feature Title`
-   - Description: Spec overview + progress (HTML)
-   - State: Matches spec status
-4. **Sync user stories as ADO User Stories**:
-   - Create user stories for new user stories
-   - Update existing user stories
-   - Update state based on user story status
-5. **Link spec to feature** (update frontmatter)
-
-## Examples
-
-### Sync spec to ADO (create or update)
-
-```bash
-/specweave-ado:sync-spec spec-001
-```
-
-**Output**:
-```
-🔄 Syncing spec spec-001 to ADO Feature...
-   Creating new ADO Feature...
-   ✅ Created ADO Feature #456: https://dev.azure.com/org/project/_workitems/edit/456
-   Syncing 35 user stories...
-   ✅ Created US-001 → User Story #457
-   ✅ Created US-002 → User Story #458
-   ...
-✅ Sync complete!
-   Created: 35 user stories
-   ADO Feature: https://dev.azure.com/org/project/_workitems/edit/456
-```
-
-### Sync FROM ADO to spec (bidirectional)
-
-```bash
-/specweave-ado:sync-spec spec-001 --direction from-ado
-```
-
-**Output**:
-```
-🔄 Syncing FROM ADO to spec spec-001...
-   Fetching ADO Feature #456...
-   ⚠️  Detected 3 conflict(s)
-   🔄 Resolving: US-002 marked Closed in ADO (ADO wins)
-   🔄 Resolving: US-005 marked Active in ADO (ADO wins)
-✅ Sync FROM ADO complete!
-   Updated: 3 user stories
-```
-
-## Arguments
-
-- `<spec-id>` - Spec ID (e.g., `spec-001` or just `001`)
-- `--direction <mode>` - Sync direction (default: `to-ado`)
-  - `to-ado` - Push local spec to ADO
-  - `from-ado` - Pull ADO state to spec
-  - `bidirectional` - Sync both ways (conflict resolution)
-
-## Configuration
-
-**Required `.env` variables**:
-
-```bash
-# Azure DevOps Configuration
-ADO_ORGANIZATION=mycompany
-ADO_PROJECT=MyProject
-ADO_PERSONAL_ACCESS_TOKEN=your_pat_token_here
-```
-
-**How to get Personal Access Token (PAT)**:
-1. Go to https://dev.azure.com/{organization}/_usersSettings/tokens
-2. Click "New Token"
-3. Set scopes:
-   - Work Items: Read, Write, & Manage
-   - Project: Read
-4. Copy token to `.env`
-
-## Conflict Resolution
-
-When syncing FROM ADO, conflicts are resolved as follows:
-
-**ADO wins** (default):
-- User story state changes → update spec
-- Acceptance criteria status → update spec
-- Work item closure → mark user story done
-
-**Local wins** (future):
-- Spec changes take precedence
-- Push to ADO
-
-## Requirements
-
-1. **Azure DevOps account** with project access
-2. **Personal Access Token** (with Work Items: Read, Write, & Manage)
-3. **Project permissions** (create features, create user stories)
-4. **Spec file exists** at `.specweave/docs/internal/specs/spec-{id}.md`
-
-## What Gets Synced
-
-### Spec → ADO Feature
-
-- ✅ Title: `[SPEC-001] Feature Area Title`
-- ✅ Description: Overview + progress stats (HTML)
-- ✅ Tags: `spec:spec-001`, `priority:P1`
-- ✅ State: New/Active/Resolved/Closed based on spec
-
-### User Story → ADO User Story
-
-- ✅ Title: `[US-001] As a user, I want...`
-- ✅ Description: User story + acceptance criteria checklist (HTML)
-- ✅ Tags: `user-story`, `spec:spec-001`, `priority:P1`
-- ✅ Parent: Links to feature work item
-- ✅ State: New (todo) / Active (in-progress) / Closed (done)
-
-### Acceptance Criteria → Checklist
-
-```html
-<h2>Acceptance Criteria</h2>
-<ul>
-  <li>☑ User can log in with email/password</li>
-  <li>☐ Invalid credentials show error message</li>
-  <li>☐ Account locks after 5 failed attempts</li>
-</ul>
-```
-
-*Note*: ADO uses HTML in descriptions, with ☑/☐ for checkboxes.
-
-## Architecture
-
-**Why This Architecture?**
-
-✅ **Permanent tracking**: Specs never deleted, ADO links remain valid
-✅ **Feature-level granularity**: One ADO Feature per feature (not per increment)
-✅ **PM-friendly**: Stakeholders see progress in ADO board
-✅ **Brownfield-ready**: Existing ADO features map to specs
-
-**What's WRONG?**
-
-❌ Increment → ADO Work Item (increments are temporary!)
-❌ Tasks → ADO Tasks (too granular, implementation details)
-❌ Multiple features per feature (split across increments)
-
-## Metadata
-
-After sync, spec frontmatter is updated:
-
-```yaml
----
-id: spec-001
-title: Core Framework Architecture
-status: in-progress
-priority: P0
-externalLinks:
-  ado:
-    featureId: 456
-    featureUrl: https://dev.azure.com/org/project/_workitems/edit/456
-    syncedAt: "2025-11-10T12:00:00Z"
-    organization: mycompany
-    project: MyProject
----
-```
-
-## Troubleshooting
-
-**"ADO API authentication failed"**:
-- Check `.env` has correct `ADO_ORGANIZATION`, `ADO_PROJECT`, `ADO_PERSONAL_ACCESS_TOKEN`
-- Verify PAT is valid (not expired)
-- Test authentication: `curl -u :{PAT} https://dev.azure.com/{org}/_apis/projects?api-version=7.0`
-
-**"Spec not found"**:
-- Check spec exists: `ls .specweave/docs/internal/specs/`
-- Use correct ID: `spec-001` or `001`
-
-**"Cannot create feature"**:
-- Ensure you have permissions to create features in the project
-- Check project name is correct in `.env`
-
-**"Parent link failed"**:
-- Ensure feature exists before creating user stories
-- Check feature ID is correct
-
-**"No user stories to sync"**:
-- Add user stories to spec.md:
-  ```markdown
-  **US-001**: As a user, I want...
-  - [ ] **AC-001-01**: Acceptance criteria 1
-  ```
-
-## Related
-
-- `/specweave-github:sync-spec` - Sync to GitHub Project
-- `/specweave-jira:sync-spec` - Sync to Jira Epic
-- `/specweave:sync-docs` - Sync living docs from increments to specs
-
-## Implementation
-
-**File**: `plugins/specweave-ado/lib/ado-spec-sync.ts`
-
-**Core Class**: `AdoSpecSync`
-
-**Methods**:
-- `syncSpecToAdo(specId)` - Push to ADO
-- `syncFromAdo(specId)` - Pull from ADO
-- `detectConflicts(spec, feature)` - Compare states
-- `resolveConflicts(spec, conflicts)` - Apply resolution strategy
-
-## Azure DevOps API Reference
-
-**Endpoints used**:
-- `POST /wit/workitems/$Feature` - Create feature
-- `PATCH /wit/workitems/{id}` - Update work item
-- `GET /wit/workitems/{id}` - Fetch work item
-- `POST /wit/wiql` - Search for work items (WIQL query)
-
-**Authentication**: Basic auth with empty username + Personal Access Token
-
-**API Version**: 7.0
-
-## Work Item States
-
-**Feature States**:
-- New → Spec status: draft
-- Active → Spec status: in-progress
-- Resolved → Spec status: complete
-- Closed → Spec status: archived
-
-**User Story States**:
-- New → User story status: todo
-- Active → User story status: in-progress
-- Closed → User story status: done

package/plugins/specweave-github/commands/specweave-github-sync-epic.md

@@ -1,248 +0,0 @@
----
-name: specweave-github-sync-epic
-description: Sync SpecWeave Epic folder to GitHub (Milestone + Issues). Implements Universal Hierarchy architecture - Epic → Milestone, Increments → Issues.
----
-
-# Sync Epic to GitHub (Universal Hierarchy)
-
-**Architecture**: Hierarchical sync using Epic folder structure
-
-- **Epic (FS-001)** → **GitHub Milestone**
-- **Increment (0001-core-framework)** → **GitHub Issue** (linked to Milestone)
-
-## Usage
-
-```bash
-/specweave-github:sync-epic <epic-id>
-```
-
-## What It Does
-
-**Hierarchical Sync Process**:
-
-1. **Load Epic folder** from `.specweave/docs/internal/specs/FS-XXX-name/`
-2. **Parse Epic README.md** to get Epic metadata (title, increments, status)
-3. **Create or update GitHub Milestone**:
-   - Title: `[FS-001] Epic Title`
-   - Description: Epic overview + progress stats
-   - State: Open (active/planning) or Closed (complete)
-4. **Sync each increment as GitHub Issue**:
-   - Title: `[INC-0001-core-framework] Title`
-   - Body: Increment overview + link to tasks.md
-   - Milestone: Linked to Epic Milestone
-   - Labels: `increment`, `epic-sync`
-5. **Update frontmatter** in Epic README.md and increment files
-
-## Examples
-
-### Sync Epic FS-001 (Core Framework Architecture)
-
-```bash
-/specweave-github:sync-epic FS-001
-```
-
-**Output**:
-```
-🔄 Syncing Epic FS-001 to GitHub...
-   📦 Epic: Core Framework Architecture
-   📊 Increments: 4
-   🚀 Creating GitHub Milestone...
-   ✅ Created Milestone #10
-
-   📝 Syncing 4 increments...
-   ✅ Created Issue #130 for 0001-core-framework
-   ✅ Created Issue #131 for 0002-core-enhancements
-   ✅ Created Issue #132 for 0004-plugin-architecture
-   ✅ Created Issue #133 for 0005-cross-platform-cli
-
-✅ Epic sync complete!
-   Milestone: https://github.com/owner/repo/milestone/10
-   Issues created: 4
-   Issues updated: 0
-```
-
-### Sync Epic with short ID
-
-```bash
-/specweave-github:sync-epic 031
-# Resolves to FS-031
-```
-
-### Re-sync Epic (updates existing Milestone/Issues)
-
-```bash
-/specweave-github:sync-epic FS-001
-```
-
-**Output**:
-```
-🔄 Syncing Epic FS-001 to GitHub...
-   ♻️  Updating existing Milestone #10...
-   ✅ Updated Milestone #10
-
-   📝 Syncing 4 increments...
-   ♻️  Updated Issue #130 for 0001-core-framework
-   ♻️  Updated Issue #131 for 0002-core-enhancements
-   ♻️  Updated Issue #132 for 0004-plugin-architecture
-   ♻️  Updated Issue #133 for 0005-cross-platform-cli
-
-✅ Epic sync complete!
-   Milestone: https://github.com/owner/repo/milestone/10
-   Issues created: 0
-   Issues updated: 4
-```
-
-## Arguments
-
-- `<epic-id>` - Epic ID (e.g., `FS-001` or just `001`)
-
-## What Gets Created
-
-### GitHub Milestone (Epic-level)
-
-```
-Title: [FS-001] Core Framework Architecture
-Description:
-  Epic: Core Framework Architecture
-
-  Progress: 4/4 increments (100%)
-
-  Priority: P0
-  Status: complete
-
-State: Closed (if complete) or Open (if active/planning)
-```
-
-### GitHub Issues (Increment-level)
-
-```markdown
-Title: [INC-0001-core-framework] Core Framework
-
-# Core Framework
-
-Foundation framework with CLI, plugin system, and agent architecture...
-
----
-
-**Increment**: 0001-core-framework
-**Milestone**: See milestone for Epic progress
-
-🤖 Auto-created by SpecWeave Epic Sync
-```
-
-**Labels**: `increment`, `epic-sync`
-**Milestone**: Linked to Epic Milestone
-
-## Frontmatter Updates
-
-### Epic README.md (after sync)
-
-```yaml
----
-id: FS-001
-title: "Core Framework Architecture"
-external_tools:
-  github:
-    type: milestone
-    id: 10                              # ← Added
-    url: https://github.com/.../milestone/10  # ← Added
-increments:
-  - id: 0001-core-framework
-    external:
-      github: 130                       # ← Added
-  - id: 0002-core-enhancements
-    external:
-      github: 131                       # ← Added
----
-```
-
-### Increment file (0001-core-framework.md)
-
-```yaml
----
-id: 0001-core-framework
-epic: FS-001
-external:
-  github:
-    issue: 130                          # ← Added
-    url: https://github.com/.../issues/130  # ← Added
----
-```
-
-## Benefits
-
-✅ **Hierarchical tracking**: GitHub Milestones group related increments
-✅ **Epic-level progress**: See completion percentage in Milestone
-✅ **Automatic linking**: All Issues linked to Milestone
-✅ **Idempotent**: Safe to re-run (updates existing Milestone/Issues)
-✅ **Brownfield-ready**: Links existing GitHub Milestones/Issues
-
-## Requirements
-
-1. **GitHub CLI** (`gh`) installed and authenticated
-2. **Git repository** with GitHub remote
-3. **Write access** to repository (for creating Milestones/Issues)
-4. **Epic folder exists** at `.specweave/docs/internal/specs/FS-XXX-name/`
-
-## Architecture: Why Milestones?
-
-**GitHub's Hierarchy**:
-- GitHub Milestones = Epic-level grouping
-- GitHub Issues = Increment-level work items
-- GitHub Projects = Optional (cross-Epic tracking)
-
-**Comparison with JIRA/ADO**:
-- JIRA: Epic → Epic, Increment → Story (with Epic Link field)
-- ADO: Epic → Feature, Increment → User Story (with Parent link)
-- GitHub: Epic → Milestone, Increment → Issue (with Milestone link)
-
-All three implement the same Universal Hierarchy, just with different terminology.
-
-## Troubleshooting
-
-**"Epic FS-001 not found"**:
-- Check Epic folder exists: `ls .specweave/docs/internal/specs/`
-- Verify Epic ID format: `FS-001-epic-name/`
-
-**"Epic README.md missing YAML frontmatter"**:
-- Ensure Epic was migrated with `migrate-to-epic-folders.ts`
-- Frontmatter must start with `---` on line 1
-
-**"Failed to create GitHub Milestone"**:
-- Check GitHub CLI auth: `gh auth status`
-- Verify write access: `gh repo view`
-- Check rate limits: `gh api rate_limit`
-
-**"Could not extract issue number"**:
-- GitHub CLI output format may have changed
-- Check CLI version: `gh --version` (need v2.0.0+)
-
-## Related Commands
-
-- `/specweave-github:sync-spec` - OLD (flat spec → project) - DEPRECATED for Epic architecture
-- `/specweave-jira:sync-epic` - Sync to JIRA Epic + Stories
-- `/specweave-ado:sync-epic` - Sync to ADO Feature + User Stories
-
-## Implementation
-
-**File**: `plugins/specweave-github/lib/github-epic-sync.ts`
-
-**Core Class**: `GitHubEpicSync`
-
-**Methods**:
-- `syncEpicToGitHub(epicId)` - Main sync logic
-- `createMilestone(epic)` - Create GitHub Milestone
-- `updateMilestone(number, epic)` - Update existing Milestone
-- `createIssue(increment, milestone)` - Create GitHub Issue
-- `updateIssue(number, increment, milestone)` - Update existing Issue
-- `updateEpicReadme(path, github)` - Update frontmatter
-- `updateIncrementExternalLink(...)` - Update increment frontmatter
-
-## Next Steps
-
-After syncing Epic to GitHub:
-
-1. **View Milestone progress**: `gh milestone view 10`
-2. **List Issues in Milestone**: `gh issue list --milestone 10`
-3. **Track completion**: GitHub automatically calculates Milestone progress
-4. **Close Milestone**: When all increments complete, Milestone auto-closes