specweave 0.17.1 → 0.17.2

package/bin/specweave.js

@@ -38,7 +38,7 @@ program
   .option('-l, --language <lang>', 'Language for generated content (en, ru, es, zh, de, fr, ja, ko, pt)', 'en')
   .option('-f, --force', 'Force fresh start (non-interactive, removes existing .specweave)', false)
   .action(async (projectName, options) => {
-    const { initCommand } = await import('../dist/cli/commands/init.js');
+    const { initCommand } = await import('../dist/src/cli/commands/init.js');
     await initCommand(projectName, options);
   });
 
@@ -48,7 +48,7 @@ program
 //   .description('Manage increments (create, list, status)')
 //   .option('-p, --priority <level>', 'Priority level (P1, P2, P3)', 'P1')
 //   .action(async (action, name, options) => {
-//     const { incrementCommand } = require('../dist/cli/commands/increment');
+//     const { incrementCommand } = require('../dist/src/cli/commands/increment');
 //     await incrementCommand(action, name, options);
 //   });
 
@@ -59,7 +59,7 @@ program
   .option('-g, --global', 'Install globally to ~/.claude/')
   .option('-l, --local', 'Install locally to .claude/ (default)')
   .action(async (componentName, options) => {
-    const { installCommand } = await import('../dist/cli/commands/install.js');
+    const { installCommand } = await import('../dist/src/cli/commands/install.js');
     await installCommand(componentName, options);
   });
 
@@ -69,7 +69,7 @@ program
   .description('List available and installed components')
   .option('--installed', 'Show only installed components')
   .action(async (options) => {
-    const { listCommand } = await import('../dist/cli/commands/list.js');
+    const { listCommand } = await import('../dist/src/cli/commands/list.js');
     await listCommand(options);
   });
 
@@ -80,7 +80,7 @@ program
   .option('-r, --reason <text>', 'Reason for pausing')
   .option('-f, --force', 'Force pause (update reason if already paused)')
   .action(async (incrementId, options) => {
-    const { pauseCommand } = await import('../dist/cli/commands/pause.js');
+    const { pauseCommand } = await import('../dist/src/cli/commands/pause.js');
     await pauseCommand(incrementId, options);
   });
 
@@ -89,7 +89,7 @@ program
   .description('Resume a paused or abandoned increment')
   .option('-f, --force', 'Force resume (bypass WIP limit checks)')
   .action(async (incrementId, options) => {
-    const { resumeCommand } = await import('../dist/cli/commands/resume.js');
+    const { resumeCommand } = await import('../dist/src/cli/commands/resume.js');
     await resumeCommand(incrementId, options);
   });
 
@@ -99,7 +99,7 @@ program
   .option('-r, --reason <text>', 'Reason for abandoning')
   .option('-f, --force', 'Force abandon (skip confirmation)')
   .action(async (incrementId, options) => {
-    const { abandonCommand } = await import('../dist/cli/commands/abandon.js');
+    const { abandonCommand } = await import('../dist/src/cli/commands/abandon.js');
     await abandonCommand(incrementId, options);
   });
 
@@ -109,7 +109,7 @@ program
   .option('-v, --verbose', 'Show detailed information')
   .option('-t, --type <type>', 'Filter by increment type (feature, hotfix, bug, etc.)')
   .action(async (options) => {
-    const { statusCommand } = await import('../dist/cli/commands/status.js');
+    const { statusCommand } = await import('../dist/src/cli/commands/status.js');
     await statusCommand(options);
   });
 
@@ -121,11 +121,11 @@ program
   .option('--clear', 'Clear status line cache')
   .option('--config <path>', 'Path to config file')
   .action(async (options) => {
-    const { registerStatusLineCommand } = await import('../dist/cli/commands/status-line.js');
+    const { registerStatusLineCommand } = await import('../dist/src/cli/commands/status-line.js');
     const tempProgram = new Command();
     registerStatusLineCommand(tempProgram);
     // Execute action manually since we need the temp program
-    const manager = await import('../dist/core/status-line/status-line-manager.js').then(m => m.StatusLineManager);
+    const manager = await import('../dist/src/core/status-line/status-line-manager.js').then(m => m.StatusLineManager);
     const StatusLineManager = manager;
     const path = await import('path');
     const fs = await import('fs');
@@ -188,7 +188,7 @@ program
     if (!options.projectRoot) {
       options.projectRoot = process.cwd();
     }
-    const { checkDisciplineCommand } = await import('../dist/cli/commands/check-discipline.js');
+    const { checkDisciplineCommand } = await import('../dist/src/cli/commands/check-discipline.js');
     await checkDisciplineCommand(options);
   });
 
@@ -197,7 +197,7 @@ program
   .command('revert-wip-limit')
   .description('Revert WIP limit to original value after temporary adjustment')
   .action(async () => {
-    const { revertWipLimitCommand } = await import('../dist/cli/commands/revert-wip-limit.js');
+    const { revertWipLimitCommand } = await import('../dist/src/cli/commands/revert-wip-limit.js');
     await revertWipLimitCommand();
   });
 
@@ -216,7 +216,7 @@ program
   .option('-f, --force', 'Force run even if rule-based fails')
   .option('-v, --verbose', 'Show recommendations')
   .action(async (incrementId, options) => {
-    const { qaCommand } = await import('../dist/cli/commands/qa.js');
+    const { qaCommand } = await import('../dist/src/cli/commands/qa.js');
     await qaCommand(incrementId, options);
   });
 
@@ -229,12 +229,12 @@ program
   .option('--dry-run', 'Show what would be installed without installing', false)
   .option('-v, --verbose', 'Show detailed validation steps', false)
   .action(async (options) => {
-    const { setupValidatePluginsCommand } = await import('../dist/cli/commands/validate-plugins.js');
+    const { setupValidatePluginsCommand } = await import('../dist/src/cli/commands/validate-plugins.js');
     // Create a temporary program for this command
     const tempProgram = new Command();
     setupValidatePluginsCommand(tempProgram);
     // Execute the action directly
-    await import('../dist/cli/commands/validate-plugins.js').then(m => m.runValidation(options));
+    await import('../dist/src/cli/commands/validate-plugins.js').then(m => m.runValidation(options));
   });
 
 // Validate Jira command - Jira resource validation
@@ -243,7 +243,7 @@ program
   .description('Validate Jira configuration and create missing resources')
   .option('--env <path>', 'Path to .env file', '.env')
   .action(async (options) => {
-    const { runJiraValidation } = await import('../dist/cli/commands/validate-jira.js');
+    const { runJiraValidation } = await import('../dist/src/cli/commands/validate-jira.js');
     await runJiraValidation(options);
   });
 

package/dist/plugins/specweave-github/lib/github-spec-sync.d.ts

@@ -1,15 +1,27 @@
 /**
- * GitHub Spec Sync
+ * GitHub Spec Sync (Multi-Project Architecture)
  *
  * CORRECT ARCHITECTURE:
- * - Syncs .specweave/docs/internal/specs/spec-*.md ↔ GitHub Projects
+ * - Syncs .specweave/docs/internal/specs/{project-id}/spec-*.md ↔ GitHub Projects
  * - NOT increments ↔ GitHub Issues (that was wrong!)
  *
+ * MULTI-PROJECT SUPPORT (v0.18.0+):
+ * - Detects which project a spec belongs to (by folder path)
+ * - Routes to correct GitHub repo based on project config
+ * - Supports multiple sync strategies per project
+ * - Handles cross-team specs (create issues in multiple repos)
+ *
  * Mapping:
  * - Spec → GitHub Project
  * - User Story → GitHub Project Card/Issue
  * - Acceptance Criteria → Checklist in Issue
  *
+ * Sync Strategies:
+ * - project-per-spec: One GitHub Project per spec (default)
+ * - team-board: One GitHub Project per team (aggregates specs)
+ * - centralized: Parent repo tracks all (multi-repo pattern)
+ * - distributed: Each team syncs to their repo (microservices)
+ *
  * @module github-spec-sync
  */
 import { SpecSyncResult } from '../../../src/core/types/spec-metadata.js';
@@ -37,13 +49,55 @@ export interface GitHubIssue {
     labels: string[];
     assignees: string[];
 }
+/**
+ * GitHub Sync Strategy
+ */
+export type GitHubSyncStrategy = 'project-per-spec' | 'team-board' | 'centralized' | 'distributed';
+/**
+ * Project-specific GitHub configuration
+ */
+export interface ProjectGitHubConfig {
+    projectId: string;
+    strategy: GitHubSyncStrategy;
+    owner: string;
+    repo: string;
+    teamBoardId?: number;
+}
 export declare class GitHubSpecSync {
     private specManager;
+    private projectContextManager;
+    private projectRoot;
     constructor(projectRoot?: string);
+    /**
+     * Detect project from spec file path
+     *
+     * Spec path format: .specweave/docs/internal/specs/{project-id}/spec-*.md
+     * OR (single project): .specweave/docs/internal/specs/spec-*.md
+     */
+    private detectProjectFromSpecPath;
+    /**
+     * Get GitHub configuration for a project
+     */
+    private getGitHubConfigForProject;
     /**
      * Sync spec to GitHub Project (CREATE or UPDATE)
+     *
+     * MULTI-PROJECT ARCHITECTURE:
+     * - Detects which project the spec belongs to
+     * - Routes to correct GitHub repo based on project config
+     * - Supports multiple sync strategies
      */
     syncSpecToGitHub(specId: string): Promise<SpecSyncResult>;
+    /**
+     * Sync spec using specified strategy
+     */
+    private syncWithStrategy;
+    /**
+     * Strategy 1: Project-per-Spec (DEFAULT)
+     * - One GitHub Project per spec
+     * - Current behavior, no changes needed
+     */
+    private syncProjectPerSpec;
     /**
      * Sync FROM GitHub Project to spec (bidirectional)
      */
@@ -56,10 +110,6 @@ export declare class GitHubSpecSync {
      * Update existing GitHub Project
      */
     private updateGitHubProject;
-    /**
-     * Sync user stories as GitHub Issues
-     */
-    private syncUserStories;
     /**
      * Generate project description from spec
      */
@@ -100,6 +150,59 @@ export declare class GitHubSpecSync {
      * Update GitHub issue
      */
     private updateIssue;
+    /**
+     * Strategy 2: Team-Board
+     * - One GitHub Project per team (aggregates multiple specs)
+     * - All specs from the same team/project sync to same board
+     */
+    private syncTeamBoard;
+    /**
+     * Strategy 3: Centralized
+     * - Parent repo tracks all specs (multi-repo pattern)
+     * - Issues created in parent repo with tags for child repos
+     */
+    private syncCentralized;
+    /**
+     * Strategy 4: Distributed
+     * - Each team syncs to their repo (microservices)
+     * - Cross-team specs create issues in multiple repos
+     */
+    private syncDistributed;
+    /**
+     * Check if spec is cross-team (touches multiple projects)
+     *
+     * Detection heuristics:
+     * - Spec title contains keywords like "integration", "cross-team", "shared"
+     * - User stories reference multiple projects/teams
+     * - Tags include multiple project names
+     */
+    private isCrossTeamSpec;
+    /**
+     * Sync cross-team spec to multiple repositories
+     *
+     * Creates issues in multiple repos:
+     * - Frontend repo gets frontend-specific user stories
+     * - Backend repo gets backend-specific user stories
+     * - Shared stories get created in both with cross-links
+     */
+    private syncCrossTeamSpec;
+    /**
+     * Detect related profiles for cross-team spec
+     */
+    private detectRelatedProfiles;
+    /**
+     * Filter user stories relevant to a specific project
+     *
+     * Heuristics:
+     * - Story title/description contains project keywords
+     * - Story tags include project name
+     * - Story implementation references project folder
+     */
+    private filterRelevantUserStories;
+    /**
+     * Enhanced syncUserStories with optional extra labels
+     */
+    private syncUserStories;
     /**
      * Detect GitHub repository from git remote
      */

package/dist/plugins/specweave-github/lib/github-spec-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"github-spec-sync.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-spec-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAGL,cAAc,EAEf,MAAM,0CAA0C,CAAC;AAGlD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAsB;gBAE7B,WAAW,GAAE,MAAsB;IAI/C;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAiF/D;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAwE7D;;OAEG;YACW,mBAAmB;IAkDjC;;OAEG;YACW,mBAAmB;IAgDjC;;OAEG;YACW,eAAe;IAmD7B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA+BlC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;OAEG;YACW,eAAe;IAwB7B;;OAEG;YACW,gBAAgB;IAiB9B;;OAEG;YACW,cAAc;IAgB5B;;OAEG;YACW,UAAU;IAaxB;;OAEG;YACW,kBAAkB;IAiBhC;;OAEG;YACW,gBAAgB;IA0B9B;;OAEG;YACW,WAAW;IA2BzB;;OAEG;YACW,WAAW;IA6BzB;;OAEG;YACW,UAAU;CAuBzB"}
+{"version":3,"file":"github-spec-sync.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-spec-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAKH,OAAO,EAGL,cAAc,EAEf,MAAM,0CAA0C,CAAC;AAKlD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,kBAAkB,GAClB,YAAY,GACZ,aAAa,GACb,aAAa,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,GAAE,MAAsB;IAM/C;;;;;OAKG;YACW,yBAAyB;IAcvC;;OAEG;YACW,yBAAyB;IA8BvC;;;;;;;OAOG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAmE/D;;OAEG;YACW,gBAAgB;IA4B9B;;;;OAIG;YACW,kBAAkB;IA6DhC;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAwE7D;;OAEG;YACW,mBAAmB;IAkDjC;;OAEG;YACW,mBAAmB;IAiDjC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA+BlC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;OAEG;YACW,eAAe;IAwB7B;;OAEG;YACW,gBAAgB;IAiB9B;;OAEG;YACW,cAAc;IAgB5B;;OAEG;YACW,UAAU;IAaxB;;OAEG;YACW,kBAAkB;IAiBhC;;OAEG;YACW,gBAAgB;IA0B9B;;OAEG;YACW,WAAW;IA2BzB;;OAEG;YACW,WAAW;IA6BzB;;;;OAIG;YACW,aAAa;IAqD3B;;;;OAIG;YACW,eAAe;IAgD7B;;;;OAIG;YACW,eAAe;IAsC7B;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IAyBvB;;;;;;;OAOG;YACW,iBAAiB;IAuF/B;;OAEG;YACW,qBAAqB;IA6BnC;;;;;;;OAOG;IACH,OAAO,CAAC,yBAAyB;IAyBjC;;OAEG;YACW,eAAe;IA2D7B;;OAEG;YACW,UAAU;CAuBzB"}