specweave 0.22.2 → 0.22.3

package/CLAUDE.md

@@ -10,6 +10,66 @@ Users receive a different CLAUDE.md via the template system.
 
 ---
 
+## 🔍 CRITICAL FINDING: Claude Code Marketplace Directory vs Symlink Issue
+
+**⚠️ RECENTLY DISCOVERED (2025-11-18) - AFFECTS ALL SPECWEAVE CONTRIBUTORS ⚠️**
+
+### The Issue
+
+Claude Code's hook execution system expects plugins at `~/.claude/plugins/marketplaces/specweave/`, but this path can be **either a directory OR a symlink**. The difference is critical:
+
+| Type | Symbol | Behavior | Development Impact |
+|------|--------|----------|-------------------|
+| **Directory** | `drwxr-xr-x` | Stale copy from marketplace update | ❌ Hooks fail with "No such file or directory" |
+| **Symlink** | `lrwxr-xr-x` | Live reference to repository | ✅ Hooks work, changes immediately reflected |
+
+### Why This Matters
+
+**Hooks ONLY work reliably with a symlink setup.** If the marketplace path is a directory:
+- ❌ Post-task-completion hooks fail randomly
+- ❌ Status line doesn't update
+- ❌ Living docs don't sync
+- ❌ You waste hours debugging "No such file or directory" errors
+- ❌ Changes to hooks in your repo are NOT reflected until marketplace update
+
+### How the Problem Occurs
+
+1. **Initial setup**: You create a symlink (correct)
+2. **Marketplace update**: Running `claude plugin marketplace update specweave` MAY replace the symlink with a directory copy
+3. **Silent failure**: Hooks start failing but no clear error message points to symlink issue
+
+### The Fix
+
+```bash
+# ALWAYS verify your setup is a symlink:
+ls -ld ~/.claude/plugins/marketplaces/specweave
+# Should show: lrwxr-xr-x ... -> /path/to/your/repo (SYMLINK)
+# NOT: drwxr-xr-x ... (DIRECTORY)
+
+# If it's a directory, fix it:
+rm -rf ~/.claude/plugins/marketplaces/specweave
+ln -s "$(pwd)" ~/.claude/plugins/marketplaces/specweave
+
+# Verify the fix:
+bash .specweave/increments/0043-spec-md-desync-fix/scripts/verify-dev-setup.sh
+```
+
+### Protection Measures
+
+1. ✅ **Pre-commit hook** verifies symlink before each commit (warns if broken)
+2. ✅ **Verification script** checks all aspects of setup (see "Local Development Setup" below)
+3. ✅ **This warning** ensures new contributors know about this issue
+
+### Deep Dive
+
+For complete root cause analysis, investigation process, and prevention strategies:
+- **Ultrathink Report**: `.specweave/increments/0043-spec-md-desync-fix/reports/ULTRATHINK-HOOK-EXECUTION-ERRORS-ROOT-CAUSE-ANALYSIS-2025-11-18.md`
+- **Fixes Applied**: `.specweave/increments/0043-spec-md-desync-fix/reports/HOOK-EXECUTION-ERRORS-FIXES-APPLIED-2025-11-18.md`
+
+**Golden Rule**: If hooks fail with "No such file or directory", check the symlink FIRST!
+
+---
+
 ## 🚨 CRITICAL: NEVER POLLUTE PROJECT ROOT!
 
 **⛔ THIS IS THE #1 RULE - VIOLATING THIS WILL GET YOUR PR REJECTED ⛔**
@@ -283,9 +343,51 @@ For adapter implementation details, see "Multi-Tool Support via Adapters" sectio
 /specweave:increment "feature name"  # Plan new work (increment-planner skill)
 /specweave:do                        # Execute tasks
 /specweave:progress                  # Check status
-/specweave:done                      # Close increment
+/specweave:done                      # Close increment (with validation)
+```
+
+**🔥 CRITICAL: Increment Completion Validation**
+
+**NEVER** mark an increment as "completed" without ALL of the following:
+1. ✅ All acceptance criteria checked (`- [x] **AC-...`)
+2. ✅ All tasks completed (`**Status**: [x] completed`)
+3. ✅ All tests passing (unit, integration, E2E)
+4. ✅ Coverage target met (`npm run test:coverage`)
+
+**Automated Protection**:
+- `/specweave:done` runs `IncrementCompletionValidator` before PM validation
+- Pre-commit hook blocks commits with invalid completion status
+- CI/CD validates completion on pull requests
+
+**Manual Protection** (if editing metadata.json directly):
+```bash
+# ❌ NEVER DO THIS - Manual metadata edit without validation
+vim .specweave/increments/0043-spec-md-desync-fix/metadata.json
+# Change "status": "active" → "completed"
+git commit -m "Complete increment"  # Will be BLOCKED by pre-commit hook
+
+# ✅ ALWAYS USE THIS - Let /specweave:done validate
+/specweave:done 0043  # Validates ACs, tasks, tests, docs before closing
+```
+
+**What Happens if Validation Fails**:
+```bash
+/specweave:done 0043
+
+❌ CANNOT CLOSE INCREMENT - Automated validation failed
+
+  • 17 acceptance criteria still open
+  • 13 tasks still pending
+
+Fix these issues before running /specweave:done again
 ```
 
+**Why This Matters**:
+- **False completion** → Status line shows wrong increment
+- **GitHub sync broken** → Issues marked closed with open work
+- **Data integrity violation** → Source of truth is inconsistent
+- **Stakeholder confusion** → External tools show wrong status
+
 **State Management**:
 ```bash
 /specweave:pause 0002 --reason="..." # Pause increment
@@ -380,7 +482,51 @@ When developing SpecWeave itself, you MUST use a **symlink** from the marketplac
 - ✅ No need to reinstall plugins after every change
 - ✅ Real-time testing of hooks, skills, and commands
 
-**Setup Instructions:**
+**⚡ QUICK SETUP (MANDATORY - Do this FIRST!):**
+
+```bash
+# 1. Clone and install dependencies
+git clone https://github.com/YOUR_USERNAME/specweave.git
+cd specweave
+npm install
+
+# 2. Create marketplace symlink (CRITICAL!)
+# ⚠️ IMPORTANT: Use absolute path, NOT $PWD (see ultrathink report for details)
+mkdir -p ~/.claude/plugins/marketplaces
+rm -rf ~/.claude/plugins/marketplaces/specweave  # Remove any existing directory/symlink
+ln -s "$(pwd)" ~/.claude/plugins/marketplaces/specweave
+
+# 3. Verify setup (MANDATORY!)
+bash .specweave/increments/0043-spec-md-desync-fix/scripts/verify-dev-setup.sh
+# Must show: ✅ ALL CHECKS PASSED!
+# If verification fails, see ultrathink report:
+#   .specweave/increments/0043-spec-md-desync-fix/reports/ULTRATHINK-HOOK-EXECUTION-ERRORS-ROOT-CAUSE-ANALYSIS-2025-11-18.md
+
+# 4. Install git hooks (for pre-commit verification)
+bash scripts/install-git-hooks.sh
+```
+
+**Why Symlink is MANDATORY:**
+
+Claude Code's hook execution system looks for hooks in `~/.claude/plugins/marketplaces/specweave/`, NOT in your local repo.
+
+**⚠️ CRITICAL: Directory vs Symlink Issue**
+
+The marketplace path MUST be a **symlink**, NOT a **directory**:
+- ✅ **Symlink** (`lrwxr-xr-x`): All hook changes immediately reflected
+- ❌ **Directory** (`drwxr-xr-x`): Stale copy, hooks fail with "No such file or directory"
+
+**Without the symlink:**
+- ❌ All post-task-completion hooks fail with "No such file or directory"
+- ❌ Status line doesn't update automatically
+- ❌ Living docs don't sync after task completion
+- ❌ Increment metadata doesn't update
+- ❌ You'll waste hours debugging hook errors
+
+**Root Cause Analysis**: See comprehensive ultrathink report at:
+`.specweave/increments/0043-spec-md-desync-fix/reports/ULTRATHINK-HOOK-EXECUTION-ERRORS-ROOT-CAUSE-ANALYSIS-2025-11-18.md`
+
+**Detailed Setup (if Quick Setup fails):**
 
 ```bash
 # 1. Remove any existing marketplace installation
@@ -392,20 +538,23 @@ ln -s /path/to/your/specweave/repo ~/.claude/plugins/marketplaces/specweave
 # Example:
 ln -s ~/Projects/github/specweave ~/.claude/plugins/marketplaces/specweave
 
-# 3. Register the local marketplace with Claude Code
-cd /path/to/your/specweave/repo
-claude plugin marketplace add ./.
+# 3. Verify symlink is correct
+readlink ~/.claude/plugins/marketplaces/specweave
+# Should output: /path/to/your/specweave/repo
+
+# 4. Verify hooks are accessible
+test -f ~/.claude/plugins/marketplaces/specweave/plugins/specweave/hooks/post-task-completion.sh && \
+  echo "✅ Hooks accessible" || echo "❌ Setup failed"
 
-# 4. Verify the marketplace is registered
-claude plugin marketplace list
-# Should show: specweave (Source: Directory /path/to/your/repo)
+# 5. Run automated verification
+bash .specweave/increments/0043-spec-md-desync-fix/scripts/verify-dev-setup.sh
+```
 
-# 5. Update marketplace to discover all plugins
-claude plugin marketplace update specweave
+**Verification Output:**
 
-# 6. Verify hooks are accessible
-test -f ~/.claude/plugins/marketplaces/specweave/plugins/specweave/hooks/user-prompt-submit.sh && \
-  echo "✅ Hooks accessible" || echo "❌ Setup failed"
+```
+✅ ALL CHECKS PASSED! Local development setup is correct.
+You can now use TodoWrite and other tools without hook errors.
 ```
 
 **If you see "Plugin not found" errors:**

package/dist/src/cli/commands/repair-status-desync.d.ts

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+import { DesyncResult } from './validate-status-sync.js';
+/**
+ * Repair options
+ */
+export interface RepairOptions {
+    dryRun?: boolean;
+    createBackup?: boolean;
+    all?: boolean;
+    incrementId?: string;
+}
+/**
+ * Repair result for a single increment
+ */
+export interface RepairResult {
+    incrementId: string;
+    oldStatus: string;
+    newStatus: string;
+    success: boolean;
+    error?: string;
+    backupPath?: string;
+}
+/**
+ * Audit log entry
+ */
+export interface AuditEntry {
+    timestamp: string;
+    incrementId: string;
+    oldStatus: string;
+    newStatus: string;
+    success: boolean;
+    error?: string;
+    backupPath?: string;
+}
+/**
+ * Create backup of spec.md before repair
+ */
+export declare function createBackup(incrementId: string): Promise<string>;
+/**
+ * Repair a single desync
+ */
+export declare function repairDesync(desync: DesyncResult, options?: RepairOptions): Promise<RepairResult>;
+/**
+ * Repair all desyncs or a specific increment
+ */
+export declare function repairStatusDesync(options?: RepairOptions): Promise<{
+    total: number;
+    repaired: number;
+    failed: number;
+    results: RepairResult[];
+}>;
+/**
+ * Write audit log
+ */
+export declare function writeAuditLog(results: RepairResult[]): Promise<string>;
+/**
+ * Format repair report
+ */
+export declare function formatRepairReport(result: {
+    total: number;
+    repaired: number;
+    failed: number;
+    results: RepairResult[];
+}, dryRun?: boolean): string;
+/**
+ * Main CLI entry point
+ */
+export declare function main(argv?: string[]): Promise<void>;
+//# sourceMappingURL=repair-status-desync.d.ts.map

package/dist/src/cli/commands/repair-status-desync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair-status-desync.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/repair-status-desync.ts"],"names":[],"mappings":";AAEA,OAAO,EAAsB,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAM7E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQvE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAuCvB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB,CAAC,CAsCD;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAoB5E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB,EAAE,MAAM,GAAE,OAAe,GAAG,MAAM,CAsElC;AAED;;GAEG;AACH,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0CvE"}

package/dist/src/cli/commands/repair-status-desync.js

@@ -0,0 +1,221 @@
+#!/usr/bin/env node
+import { validateStatusSync } from './validate-status-sync.js';
+import { SpecFrontmatterUpdater } from '../../core/increment/spec-frontmatter-updater.js';
+import chalk from 'chalk';
+import fs from 'fs-extra';
+import path from 'path';
+/**
+ * Create backup of spec.md before repair
+ */
+export async function createBackup(incrementId) {
+    const specPath = path.join(process.cwd(), '.specweave', 'increments', incrementId, 'spec.md');
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const backupPath = `${specPath}.backup-${timestamp}`;
+    await fs.copyFile(specPath, backupPath);
+    return backupPath;
+}
+/**
+ * Repair a single desync
+ */
+export async function repairDesync(desync, options = {}) {
+    const { dryRun = false, createBackup: shouldBackup = true } = options;
+    // Dry-run: preview only
+    if (dryRun) {
+        return {
+            incrementId: desync.incrementId,
+            oldStatus: desync.specStatus,
+            newStatus: desync.metadataStatus,
+            success: true,
+        };
+    }
+    try {
+        // Create backup if enabled
+        let backupPath;
+        if (shouldBackup) {
+            backupPath = await createBackup(desync.incrementId);
+        }
+        // Update spec.md to match metadata.json
+        await SpecFrontmatterUpdater.updateStatus(desync.incrementId, desync.metadataStatus);
+        return {
+            incrementId: desync.incrementId,
+            oldStatus: desync.specStatus,
+            newStatus: desync.metadataStatus,
+            success: true,
+            backupPath,
+        };
+    }
+    catch (error) {
+        return {
+            incrementId: desync.incrementId,
+            oldStatus: desync.specStatus,
+            newStatus: desync.metadataStatus,
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Repair all desyncs or a specific increment
+ */
+export async function repairStatusDesync(options = {}) {
+    const { all = false, incrementId, dryRun = false } = options;
+    // Get desyncs from validation
+    const validation = await validateStatusSync();
+    let desyncsToRepair = [];
+    if (incrementId) {
+        // Repair specific increment
+        const desync = validation.desyncs.find((d) => d.incrementId === incrementId);
+        if (!desync) {
+            throw new Error(`No desync found for increment ${incrementId}`);
+        }
+        desyncsToRepair = [desync];
+    }
+    else if (all) {
+        // Repair all desyncs
+        desyncsToRepair = validation.desyncs;
+    }
+    else {
+        throw new Error('Must specify either --all or <incrementId>');
+    }
+    const results = [];
+    for (const desync of desyncsToRepair) {
+        const result = await repairDesync(desync, options);
+        results.push(result);
+    }
+    const repaired = results.filter((r) => r.success).length;
+    const failed = results.filter((r) => !r.success).length;
+    return {
+        total: results.length,
+        repaired,
+        failed,
+        results,
+    };
+}
+/**
+ * Write audit log
+ */
+export async function writeAuditLog(results) {
+    const logsDir = path.join(process.cwd(), '.specweave', 'logs');
+    await fs.ensureDir(logsDir);
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const logPath = path.join(logsDir, `status-desync-repair-${timestamp}.json`);
+    const entries = results.map((result) => ({
+        timestamp: new Date().toISOString(),
+        incrementId: result.incrementId,
+        oldStatus: result.oldStatus,
+        newStatus: result.newStatus,
+        success: result.success,
+        error: result.error,
+        backupPath: result.backupPath,
+    }));
+    await fs.writeFile(logPath, JSON.stringify(entries, null, 2), 'utf-8');
+    return logPath;
+}
+/**
+ * Format repair report
+ */
+export function formatRepairReport(result, dryRun = false) {
+    const lines = [];
+    lines.push('');
+    lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    if (dryRun) {
+        lines.push(chalk.cyan('DRY RUN: Status Desync Repair Preview'));
+    }
+    else {
+        lines.push('Status Desync Repair Report');
+    }
+    lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    lines.push('');
+    lines.push(`Total desyncs: ${result.total}`);
+    if (dryRun) {
+        lines.push(chalk.cyan(`Would repair: ${result.repaired}`));
+        if (result.failed > 0) {
+            lines.push(chalk.yellow(`Would fail: ${result.failed}`));
+        }
+    }
+    else {
+        lines.push(chalk.green(`Repaired: ${result.repaired}`));
+        if (result.failed > 0) {
+            lines.push(chalk.red(`Failed: ${result.failed}`));
+        }
+    }
+    lines.push('');
+    for (const repair of result.results) {
+        if (dryRun) {
+            lines.push(chalk.cyan(`DRY RUN: Would update ${chalk.bold(repair.incrementId)} from "${repair.oldStatus}" to "${repair.newStatus}"`));
+        }
+        else if (repair.success) {
+            lines.push(chalk.green(`✅ Repaired ${chalk.bold(repair.incrementId)}: "${repair.oldStatus}" → "${repair.newStatus}"`));
+            if (repair.backupPath) {
+                lines.push(`   Backup: ${repair.backupPath}`);
+            }
+        }
+        else {
+            lines.push(chalk.red(`❌ Failed ${chalk.bold(repair.incrementId)}: "${repair.oldStatus}" → "${repair.newStatus}"`));
+            if (repair.error) {
+                lines.push(`   Error: ${repair.error}`);
+            }
+        }
+    }
+    lines.push('');
+    if (!dryRun && result.repaired > 0) {
+        lines.push(chalk.green(`✅ ${result.repaired} desync(s) repaired successfully!`));
+        lines.push('');
+        lines.push('To verify:');
+        lines.push(chalk.cyan('  npx specweave validate-status-sync'));
+    }
+    else if (dryRun) {
+        lines.push(chalk.cyan('To apply these changes:'));
+        lines.push(chalk.cyan('  npx specweave repair-status-desync --all'));
+    }
+    lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Main CLI entry point
+ */
+export async function main(argv = process.argv) {
+    try {
+        // Parse CLI arguments
+        const args = argv.slice(2);
+        const options = {
+            all: args.includes('--all'),
+            dryRun: args.includes('--dry-run'),
+            createBackup: !args.includes('--no-backup'),
+        };
+        // Check for increment ID (non-flag argument)
+        const incrementIdArg = args.find((arg) => !arg.startsWith('--'));
+        if (incrementIdArg) {
+            options.incrementId = incrementIdArg;
+        }
+        if (options.dryRun) {
+            console.log(chalk.cyan('🔍 DRY RUN MODE: No files will be modified\n'));
+        }
+        else {
+            console.log('🔧 Repairing status desyncs...\n');
+        }
+        const result = await repairStatusDesync(options);
+        const report = formatRepairReport(result, options.dryRun);
+        console.log(report);
+        // Write audit log (skip in dry-run mode)
+        if (!options.dryRun && result.total > 0) {
+            const logPath = await writeAuditLog(result.results);
+            console.log(chalk.gray(`Audit log: ${logPath}\n`));
+        }
+        // Exit with error code if any repairs failed
+        if (result.failed > 0 && !options.dryRun) {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error(chalk.red('Error during repair:'));
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+// Run if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main();
+}
+//# sourceMappingURL=repair-status-desync.js.map

package/dist/src/cli/commands/repair-status-desync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair-status-desync.js","sourceRoot":"","sources":["../../../../src/cli/commands/repair-status-desync.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/commands/validate-status-sync.d.ts

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+import { IncrementStatus } from '../../core/types/increment-metadata.js';
+/**
+ * Severity levels for status desyncs
+ */
+export declare enum DesyncSeverity {
+    CRITICAL = "CRITICAL",
+    HIGH = "HIGH",
+    MEDIUM = "MEDIUM",
+    LOW = "LOW"
+}
+/**
+ * Desync detection result
+ */
+export interface DesyncResult {
+    incrementId: string;
+    metadataStatus: IncrementStatus;
+    specStatus: IncrementStatus;
+    severity: DesyncSeverity;
+    impact: string;
+    fix: string;
+}
+/**
+ * Calculate severity of a status desync
+ */
+export declare function calculateSeverity(metadataStatus: IncrementStatus, specStatus: IncrementStatus): {
+    severity: DesyncSeverity;
+    impact: string;
+};
+/**
+ * Validate status sync across all increments
+ */
+export declare function validateStatusSync(): Promise<{
+    total: number;
+    synced: number;
+    desynced: number;
+    desyncs: DesyncResult[];
+}>;
+/**
+ * Format and print validation report
+ */
+export declare function formatReport(result: {
+    total: number;
+    synced: number;
+    desynced: number;
+    desyncs: DesyncResult[];
+}): string;
+/**
+ * Main CLI entry point
+ */
+export declare function main(): Promise<void>;
+//# sourceMappingURL=validate-status-sync.d.ts.map

package/dist/src/cli/commands/validate-status-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-status-sync.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/validate-status-sync.ts"],"names":[],"mappings":";AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAGzE;;GAEG;AACH,oBAAY,cAAc;IACxB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,GAAG,QAAQ;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,eAAe,CAAC;IAChC,UAAU,EAAE,eAAe,CAAC;IAC5B,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,eAAe,EAC/B,UAAU,EAAE,eAAe,GAC1B;IAAE,QAAQ,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA6C9C;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB,CAAC,CAqDD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB,GAAG,MAAM,CAiDT;AAED;;GAEG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAkB1C"}