specweave 0.9.0 → 0.10.0

package/dist/cli/commands/validate-jira.d.ts

@@ -0,0 +1,35 @@
+/**
+ * CLI Command: validate-jira
+ *
+ * Validates Jira configuration and creates missing resources
+ *
+ * Usage:
+ *   specweave validate-jira [options]
+ *
+ * Options:
+ *   --env <path>    Path to .env file (default: .env)
+ *   -h, --help      Display help for command
+ *
+ * @module cli/commands/validate-jira
+ * @since 0.9.5
+ */
+import { Command } from 'commander';
+/**
+ * Setup validate-jira command
+ *
+ * @param program - Commander program instance
+ */
+export declare function setupValidateJiraCommand(program: Command): void;
+/**
+ * Run Jira validation
+ *
+ * @param options - Command options
+ */
+declare function runJiraValidation(options: {
+    env: string;
+}): Promise<void>;
+/**
+ * Export for programmatic use
+ */
+export { runJiraValidation };
+//# sourceMappingURL=validate-jira.d.ts.map

package/dist/cli/commands/validate-jira.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-jira.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/validate-jira.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQ/D;AAED;;;;GAIG;AACH,iBAAe,iBAAiB,CAAC,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBxE;AAgED;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/cli/commands/validate-jira.js

@@ -0,0 +1,112 @@
+/**
+ * CLI Command: validate-jira
+ *
+ * Validates Jira configuration and creates missing resources
+ *
+ * Usage:
+ *   specweave validate-jira [options]
+ *
+ * Options:
+ *   --env <path>    Path to .env file (default: .env)
+ *   -h, --help      Display help for command
+ *
+ * @module cli/commands/validate-jira
+ * @since 0.9.5
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import { validateJiraResources } from '../../utils/external-resource-validator.js';
+/**
+ * Setup validate-jira command
+ *
+ * @param program - Commander program instance
+ */
+export function setupValidateJiraCommand(program) {
+    program
+        .command('validate-jira')
+        .description('Validate Jira configuration and create missing resources')
+        .option('--env <path>', 'Path to .env file', '.env')
+        .action(async (options) => {
+        await runJiraValidation(options);
+    });
+}
+/**
+ * Run Jira validation
+ *
+ * @param options - Command options
+ */
+async function runJiraValidation(options) {
+    const spinner = ora('Validating Jira configuration...').start();
+    try {
+        spinner.stop();
+        const result = await validateJiraResources(options.env);
+        // Display results
+        if (result.valid) {
+            displaySuccess(result);
+            process.exit(0);
+        }
+        else {
+            displayFailure(result);
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        spinner.stop();
+        console.error(chalk.red(`\n❌ Validation error: ${error.message}`));
+        process.exit(1);
+    }
+}
+/**
+ * Display success message
+ */
+function displaySuccess(result) {
+    console.log(chalk.green('\n✅ Jira configuration validated!\n'));
+    // Show project info
+    if (result.project.exists) {
+        console.log(chalk.gray('Project:'));
+        console.log(chalk.white(`   • ${result.project.key} - ${result.project.name}`));
+        console.log(chalk.dim(`     ID: ${result.project.id}\n`));
+    }
+    // Show boards info
+    if (result.boards.existing.length > 0) {
+        console.log(chalk.gray('Boards:'));
+        result.boards.existing.forEach((id) => {
+            console.log(chalk.white(`   • Board ID: ${id}`));
+        });
+        console.log();
+    }
+    // Show created boards
+    if (result.boards.created.length > 0) {
+        console.log(chalk.green('Created boards:'));
+        result.boards.created.forEach((board) => {
+            console.log(chalk.green(`   ✅ ${board.name} (ID: ${board.id})`));
+        });
+        console.log();
+    }
+    // Show env update
+    if (result.envUpdated) {
+        console.log(chalk.cyan('📝 .env file updated with actual IDs\n'));
+    }
+}
+/**
+ * Display failure message
+ */
+function displayFailure(result) {
+    console.log(chalk.red('\n❌ Jira validation failed\n'));
+    // Show project issues
+    if (!result.project.exists) {
+        console.log(chalk.yellow('Project:'));
+        console.log(chalk.yellow('   • Project not found or not created\n'));
+    }
+    // Show board issues
+    if (!result.boards.valid && result.boards.missing.length > 0) {
+        console.log(chalk.yellow('Boards:'));
+        console.log(chalk.yellow(`   • Missing boards: ${result.boards.missing.join(', ')}\n`));
+    }
+    console.log(chalk.cyan('💡 Run again to retry validation and fix configuration\n'));
+}
+/**
+ * Export for programmatic use
+ */
+export { runJiraValidation };
+//# sourceMappingURL=validate-jira.js.map

package/dist/cli/commands/validate-jira.js.map

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

package/dist/cli/commands/validate-plugins.d.ts

@@ -0,0 +1,41 @@
+/**
+ * CLI Command: validate-plugins
+ *
+ * Validates SpecWeave plugin installation and optionally installs missing components.
+ *
+ * Usage:
+ *   specweave validate-plugins [options]
+ *
+ * Options:
+ *   --auto-install              Auto-install missing components
+ *   --context <description>     Increment description for context detection
+ *   --dry-run                   Show what would be installed without installing
+ *   --verbose                   Show detailed validation steps
+ *   -h, --help                  Display help for command
+ *
+ * @module cli/commands/validate-plugins
+ * @since 0.9.4
+ */
+import { Command } from 'commander';
+/**
+ * Setup validate-plugins command
+ *
+ * @param program - Commander program instance
+ */
+export declare function setupValidatePluginsCommand(program: Command): void;
+/**
+ * Run validation
+ *
+ * @param options - Command options
+ */
+declare function runValidation(options: {
+    autoInstall: boolean;
+    context?: string;
+    dryRun: boolean;
+    verbose: boolean;
+}): Promise<void>;
+/**
+ * Export for programmatic use
+ */
+export { runValidation };
+//# sourceMappingURL=validate-plugins.d.ts.map

package/dist/cli/commands/validate-plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-plugins.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/validate-plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkBlE;AAED;;;;GAIG;AACH,iBAAe,aAAa,CAAC,OAAO,EAAE;IACpC,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkChB;AAiJD;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/cli/commands/validate-plugins.js

@@ -0,0 +1,171 @@
+/**
+ * CLI Command: validate-plugins
+ *
+ * Validates SpecWeave plugin installation and optionally installs missing components.
+ *
+ * Usage:
+ *   specweave validate-plugins [options]
+ *
+ * Options:
+ *   --auto-install              Auto-install missing components
+ *   --context <description>     Increment description for context detection
+ *   --dry-run                   Show what would be installed without installing
+ *   --verbose                   Show detailed validation steps
+ *   -h, --help                  Display help for command
+ *
+ * @module cli/commands/validate-plugins
+ * @since 0.9.4
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import { PluginValidator, } from '../../utils/plugin-validator.js';
+/**
+ * Setup validate-plugins command
+ *
+ * @param program - Commander program instance
+ */
+export function setupValidatePluginsCommand(program) {
+    program
+        .command('validate-plugins')
+        .description('Validate SpecWeave plugin installation')
+        .option('--auto-install', 'Auto-install missing components', false)
+        .option('--context <description>', 'Increment description for context detection')
+        .option('--dry-run', 'Show what would be installed without installing', false)
+        .option('--verbose', 'Show detailed validation steps', false)
+        .action(async (options) => {
+        await runValidation(options);
+    });
+}
+/**
+ * Run validation
+ *
+ * @param options - Command options
+ */
+async function runValidation(options) {
+    const spinner = ora('Validating SpecWeave environment...').start();
+    try {
+        const validator = new PluginValidator();
+        const validationOptions = {
+            autoInstall: options.autoInstall,
+            context: options.context,
+            dryRun: options.dryRun,
+            verbose: options.verbose,
+        };
+        const result = await validator.validate(validationOptions);
+        spinner.stop();
+        // Display results
+        if (result.valid) {
+            displaySuccess(result);
+            process.exit(0);
+        }
+        else {
+            displayFailure(result, options);
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        spinner.stop();
+        console.error(chalk.red(`\n❌ Validation error: ${error.message}`));
+        // Show manual instructions
+        showManualInstructions();
+        process.exit(1);
+    }
+}
+/**
+ * Display success message
+ *
+ * @param result - Validation result
+ */
+function displaySuccess(result) {
+    console.log(chalk.green('\n✅ All plugins validated!'));
+    // Show installed components
+    if (result.installed.corePlugin) {
+        const version = result.installed.corePluginVersion
+            ? ` (v${result.installed.corePluginVersion})`
+            : '';
+        console.log(chalk.gray(`   • Core plugin: installed${version}`));
+    }
+    if (result.installed.contextPlugins.length > 0) {
+        console.log(chalk.gray(`   • Context plugins: ${result.installed.contextPlugins.join(', ')}`));
+    }
+    // Show cache info
+    if (result.cache?.hit) {
+        console.log(chalk.gray(`   • Cache: hit (age: ${Math.round(result.cache.age)}s)`));
+    }
+    console.log(); // Empty line
+}
+/**
+ * Display failure message
+ *
+ * @param result - Validation result
+ * @param options - Command options
+ */
+function displayFailure(result, options) {
+    console.log(chalk.red('\n❌ Missing components detected:'));
+    // Show missing components
+    if (result.missing.marketplace) {
+        console.log(chalk.yellow('   • SpecWeave marketplace not registered'));
+    }
+    if (result.missing.corePlugin) {
+        console.log(chalk.yellow('   • Core plugin (specweave) not installed'));
+    }
+    if (result.missing.contextPlugins.length > 0) {
+        console.log(chalk.yellow(`   • Context plugins: ${result.missing.contextPlugins.join(', ')}`));
+    }
+    // Show errors if any
+    if (result.errors.length > 0) {
+        console.log(chalk.red('\n🚨 Errors encountered:'));
+        result.errors.forEach((error) => {
+            console.log(chalk.red(`   • ${error}`));
+        });
+    }
+    // Show recommendations
+    if (result.recommendations.length > 0) {
+        console.log(chalk.cyan('\n📦 Recommendations:'));
+        result.recommendations.forEach((rec) => {
+            console.log(chalk.gray(`   ${rec}`));
+        });
+    }
+    // Show dry-run note
+    if (options.dryRun) {
+        console.log(chalk.cyan('\n💡 Dry-run mode: No changes made. Remove --dry-run to install.'));
+    }
+    // Show auto-install suggestion
+    if (!options.autoInstall && !options.dryRun) {
+        console.log(chalk.cyan('\n💡 Tip: Use --auto-install flag to automatically install missing components'));
+    }
+    console.log(); // Empty line
+}
+/**
+ * Show manual installation instructions
+ */
+function showManualInstructions() {
+    console.log(chalk.cyan('\n📖 Manual Installation Instructions:'));
+    console.log();
+    console.log(chalk.gray('1. Register SpecWeave marketplace:'));
+    console.log(chalk.gray('   Edit ~/.claude/settings.json and add:'));
+    console.log(chalk.gray(`   {
+     "extraKnownMarketplaces": {
+       "specweave": {
+         "source": {
+           "source": "github",
+           "repo": "anton-abyzov/specweave",
+           "path": ".claude-plugin"
+         }
+       }
+     }
+   }`));
+    console.log();
+    console.log(chalk.gray('2. Install core plugin:'));
+    console.log(chalk.gray('   Run: /plugin install specweave'));
+    console.log();
+    console.log(chalk.gray('3. Restart Claude Code'));
+    console.log();
+    console.log(chalk.gray('4. Re-run: specweave validate-plugins'));
+    console.log();
+}
+/**
+ * Export for programmatic use
+ */
+export { runValidation };
+//# sourceMappingURL=validate-plugins.js.map

package/dist/cli/commands/validate-plugins.js.map

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

package/dist/core/types/sync-profile.d.ts

@@ -5,71 +5,182 @@
  * with time range filtering and rate limiting protection.
  */
 export type SyncProvider = 'github' | 'jira' | 'ado';
+/**
+ * Sync Strategy (v0.10.0+)
+ *
+ * Determines how work is organized and synced:
+ * - simple: One container (project/repo), no filtering (default, backward compatible)
+ * - filtered: Multiple containers + sub-organizations (boards/etc) + filters (NEW)
+ * - custom: Raw query (JQL/GraphQL/WIQL) for power users (NEW)
+ */
+export type SyncStrategy = 'simple' | 'filtered' | 'custom';
 export type JiraStrategy = 'project-per-team' | 'shared-project-with-components';
+/**
+ * Container filters (provider-specific)
+ *
+ * Filters applied to a specific container (project/repo) to narrow down synced items.
+ */
+export interface SyncContainerFilters {
+    /** Include items with these labels */
+    includeLabels?: string[];
+    /** Exclude items with these labels */
+    excludeLabels?: string[];
+    /** Filter by assignees (email or ID) */
+    assignees?: string[];
+    /** Filter by status categories */
+    statusCategories?: string[];
+    /** Filter by components */
+    components?: string[];
+    /** Filter by sprints */
+    sprints?: string[];
+    /** Filter by issue types (Epic, Story, Task, Bug) */
+    issueTypes?: string[];
+    /** Filter by milestones */
+    milestones?: string[];
+    /** Filter by states */
+    states?: ('open' | 'closed')[];
+    /** Filter by area paths */
+    areaPaths?: string[];
+    /** Filter by iteration paths */
+    iterationPaths?: string[];
+    /** Filter by work item types (Epic, Feature, User Story, Bug) */
+    workItemTypes?: string[];
+}
+/**
+ * Container definition (project, repo, etc.)
+ *
+ * Represents a single container (Jira project, GitHub repo, ADO project) with optional sub-organizations.
+ */
+export interface SyncContainer {
+    /**
+     * Container ID
+     * - Jira: Project key (e.g., "PROJECT-A")
+     * - GitHub: Repository (e.g., "owner/repo-name")
+     * - ADO: Project name (e.g., "Platform")
+     */
+    id: string;
+    /**
+     * Sub-organizations within the container
+     * - Jira: Board names (e.g., ["Team Alpha Board", "Team Beta Board"])
+     * - GitHub: Project board titles (e.g., ["Frontend Board", "UI Components"])
+     * - ADO: Team board names (e.g., ["API Team Board"])
+     */
+    subOrganizations?: string[];
+    /**
+     * Filters applied to this container
+     */
+    filters?: SyncContainerFilters;
+}
+/**
+ * GitHub Configuration (Extended for Hierarchical Sync)
+ *
+ * - Simple strategy: owner + repo (backward compatible)
+ * - Filtered strategy: containers array with multiple repos
+ * - Custom strategy: customQuery (GitHub search syntax)
+ */
 export interface GitHubConfig {
-    owner: string;
-    repo: string;
+    owner?: string;
+    repo?: string;
+    containers?: SyncContainer[];
+    customQuery?: string;
 }
 /**
- * Jira Configuration (Multi-Team Support)
+ * Jira Configuration (Extended for Hierarchical Sync)
  *
- * Jira has NO explicit "Team" concept like ADO.
- * Instead, teams are simulated using either:
- * 1. Multiple Projects (one per team) - simpler, more projects
- * 2. One Project with Components (team labels) - fewer projects, shared backlog
+ * Supports:
+ * - Simple strategy: Single project (projectKey) - backward compatible
+ * - Filtered strategy: Multiple projects + boards (containers) - NEW in v0.10.0
+ * - Custom strategy: Raw JQL query (customQuery) - NEW in v0.10.0
  *
  * Backward Compatibility:
- * - Old config: { domain, projectKey } - single project mode
- * - New config: { domain, strategy, projects/components } - multi-team mode
+ * - Old config: { domain, projectKey } - still works (simple strategy)
+ * - Old config: { domain, strategy, projects/components } - still works (deprecated, use filtered)
+ * - New config: { domain, containers: [{id, subOrganizations, filters}] } - hierarchical
  */
 export interface JiraConfig {
     domain: string;
     issueType?: 'Epic' | 'Story' | 'Task';
     /**
-     * How teams are organized in Jira (optional for backward compatibility)
-     * - 'project-per-team': Each team has separate project (FRONTEND, BACKEND, QA)
-     * - 'shared-project-with-components': One project with components per team
-     * - undefined: Single project mode (backward compatible)
+     * @deprecated Use SyncStrategy instead (simple/filtered/custom)
+     * Old field: How teams are organized in Jira
      */
     strategy?: JiraStrategy;
     /**
+     * @deprecated Use containers array instead
      * Strategy 1: Multiple projects (one per team)
-     * Example: ["FRONTEND", "BACKEND", "QA"]
-     * Creates folders: frontend/, backend/, qa/
      */
     projects?: string[];
     /**
-     * Strategy 2: Shared project with components
-     * OR Legacy: Single project key
-     * Example: projectKey="PRODUCT", components=["Frontend", "Backend", "QA"]
-     * Creates folders: frontend/, backend/, qa/
+     * @deprecated Use containers array instead
+     * Strategy 2: Single project key OR shared project
      */
     projectKey?: string;
+    /**
+     * @deprecated Use filters in SyncContainer instead
+     * Components for filtering
+     */
     components?: string[];
+    /**
+     * Filtered strategy: Multiple projects + boards
+     * Example: [
+     *   {id: "PROJECT-A", subOrganizations: ["Board 1", "Board 2"], filters: {...}},
+     *   {id: "PROJECT-B", subOrganizations: ["Board 3"]}
+     * ]
+     */
+    containers?: SyncContainer[];
+    /**
+     * Custom strategy: Raw JQL query
+     * Example: "project IN (PROJECT-A, PROJECT-B) AND labels IN (feature)"
+     */
+    customQuery?: string;
 }
 /**
- * Azure DevOps Configuration (Multi-Team Support)
+ * Azure DevOps Configuration (Extended for Hierarchical Sync)
  *
- * ADO has REAL Teams as explicit entities within a project.
- * Multiple teams can exist in ONE project, each with own Area Path.
+ * Supports:
+ * - Simple strategy: Single project (project) - backward compatible
+ * - Filtered strategy: Multiple projects + area paths (containers) - NEW in v0.10.0
+ * - Custom strategy: Raw WIQL query (customQuery) - NEW in v0.10.0
+ *
+ * Backward Compatibility:
+ * - Old config: { organization, project, teams, areaPaths } - still works
+ * - New config: { organization, containers: [{id, filters: {areaPaths}}] } - hierarchical
  */
 export interface AdoConfig {
     organization: string;
-    project: string;
-    workItemType?: 'Epic' | 'Feature' | 'User Story';
     /**
+     * @deprecated Use containers array instead
+     * Single project name
+     */
+    project?: string;
+    /**
+     * @deprecated Use filters in SyncContainer instead
      * Teams within the project
-     * Example: ["League Scheduler Team", "Platform Engineering Team", "QA Team"]
-     * Creates folders: league-scheduler-team/, platform-engineering-team/, qa-team/
      */
     teams?: string[];
     /**
-     * Explicit Area Paths per team (optional, auto-generated if not provided)
-     * Format: { "team-folder-name": "Project\\Team Name" }
-     * Example: { "platform-team": "League Scheduler\\Platform Engineering Team" }
+     * @deprecated Use filters in SyncContainer instead
+     * Area paths per team
      */
     areaPaths?: Record<string, string>;
+    /**
+     * @deprecated Use filters in SyncContainer instead
+     */
     iterationPath?: string;
+    workItemType?: 'Epic' | 'Feature' | 'User Story';
+    /**
+     * Filtered strategy: Multiple projects + area paths
+     * Example: [
+     *   {id: "Platform", filters: {areaPaths: ["Platform\\Core"], workItemTypes: ["User Story"]}},
+     *   {id: "Services", filters: {areaPaths: ["Services\\API"]}}
+     * ]
+     */
+    containers?: SyncContainer[];
+    /**
+     * Custom strategy: Raw WIQL query
+     * Example: "SELECT * FROM WorkItems WHERE [System.TeamProject] = 'Platform' AND [System.AreaPath] UNDER 'Platform\\Core'"
+     */
+    customQuery?: string;
 }
 export type ProviderConfig = GitHubConfig | JiraConfig | AdoConfig;
 export type TimeRangePreset = '1W' | '2W' | '1M' | '3M' | '6M' | '1Y' | 'ALL';
@@ -144,6 +255,15 @@ export interface SyncProfile {
     displayName: string;
     /** Optional description */
     description?: string;
+    /**
+     * Sync strategy (v0.10.0+)
+     * - simple: One container (default, backward compatible)
+     * - filtered: Multiple containers + boards (NEW)
+     * - custom: Raw query (NEW)
+     *
+     * If not specified, defaults to 'simple' for backward compatibility
+     */
+    strategy?: SyncStrategy;
     /** Provider-specific configuration */
     config: ProviderConfig;
     /** Time range configuration */
@@ -252,4 +372,32 @@ export interface ProjectDetectionResult {
     /** Suggested sync profile */
     suggestedProfile?: string;
 }
+/**
+ * Check if profile uses simple strategy (one container, backward compatible)
+ */
+export declare function isSimpleStrategy(profile: SyncProfile): boolean;
+/**
+ * Check if profile uses filtered strategy (multiple containers + boards)
+ */
+export declare function isFilteredStrategy(profile: SyncProfile): boolean;
+/**
+ * Check if profile uses custom strategy (raw query)
+ */
+export declare function isCustomStrategy(profile: SyncProfile): boolean;
+/**
+ * Check if config has hierarchical containers (Jira)
+ */
+export declare function hasJiraContainers(config: JiraConfig): boolean;
+/**
+ * Check if config has hierarchical containers (GitHub)
+ */
+export declare function hasGitHubContainers(config: GitHubConfig): boolean;
+/**
+ * Check if config has hierarchical containers (ADO)
+ */
+export declare function hasAdoContainers(config: AdoConfig): boolean;
+/**
+ * Get effective strategy (defaults to 'simple' if not specified)
+ */
+export declare function getEffectiveStrategy(profile: SyncProfile): SyncStrategy;
 //# sourceMappingURL=sync-profile.d.ts.map