specweave 0.30.9 → 0.30.11

package/plugins/specweave-github/lib/github-feature-sync.ts

@@ -277,10 +277,22 @@ export class GitHubFeatureSync {
    * Find Feature folder in specs directory
    */
   private async findFeatureFolder(featureId: string): Promise<string | null> {
-    // Check _features folder first
-    const featuresFolder = path.join(this.specsDir, '_features', featureId);
-    if (existsSync(featuresFolder)) {
-      return featuresFolder;
+    // v5.0.0+: NO _features folder - features live in project folders
+    // Search all project folders for the feature
+    const projectFolders = await this.findProjectFolders();
+
+    for (const projectFolder of projectFolders) {
+      const featureFolder = path.join(projectFolder, featureId);
+      if (existsSync(featureFolder) && existsSync(path.join(featureFolder, 'FEATURE.md'))) {
+        return featureFolder;
+      }
+    }
+
+    // Legacy fallback: Check _features folder (for brownfield migration)
+    const legacyFolder = path.join(this.specsDir, '_features', featureId);
+    if (existsSync(legacyFolder)) {
+      console.log(`   ⚠️  Found feature in legacy _features folder - consider migrating to project folder`);
+      return legacyFolder;
     }
 
     return null;

package/plugins/specweave-github/lib/user-story-content-builder.js

@@ -43,7 +43,9 @@ class UserStoryContentBuilder {
     const priority = this.extractPriorityFromACs(content.acceptanceCriteria);
     const repo = githubRepo || await this.detectGitHubRepo();
     if (repo) {
-      body += `**Feature**: [${content.featureId}](https://github.com/${repo}/tree/develop/.specweave/docs/internal/specs/_features/${content.featureId})
+      const pathMatch = this.userStoryPath.match(/specs\/([^/]+)\/FS-\d+\//);
+      const projectFolder = pathMatch ? pathMatch[1] : "default";
+      body += `**Feature**: [${content.featureId}](https://github.com/${repo}/tree/develop/.specweave/docs/internal/specs/${projectFolder}/${content.featureId})
 `;
     } else {
       body += `**Feature**: ${content.featureId}

package/plugins/specweave-github/lib/user-story-content-builder.ts

@@ -123,8 +123,12 @@ export class UserStoryContentBuilder {
     const repo = githubRepo || await this.detectGitHubRepo();
 
     // Header with metadata
+    // v5.0.0+: Features live in project folders, NOT _features
+    // Extract project from path: specs/{project}/FS-XXX/us-*.md
     if (repo) {
-      body += `**Feature**: [${content.featureId}](https://github.com/${repo}/tree/develop/.specweave/docs/internal/specs/_features/${content.featureId})\n`;
+      const pathMatch = this.userStoryPath.match(/specs\/([^/]+)\/FS-\d+\//);
+      const projectFolder = pathMatch ? pathMatch[1] : 'default';
+      body += `**Feature**: [${content.featureId}](https://github.com/${repo}/tree/develop/.specweave/docs/internal/specs/${projectFolder}/${content.featureId})\n`;
     } else {
       body += `**Feature**: ${content.featureId}\n`;
     }

package/plugins/specweave-github/lib/user-story-issue-builder.js

@@ -329,7 +329,9 @@ User Story ID: ${frontmatter.id}`
     sections.push("");
     if (this.repoOwner && this.repoName) {
       const baseUrl = `https://github.com/${this.repoOwner}/${this.repoName}/blob/${this.branch}`;
-      sections.push(`- **Feature Spec**: [${this.featureId}](${baseUrl}/.specweave/docs/internal/specs/_features/${this.featureId}/FEATURE.md)`);
+      const pathMatch = this.userStoryPath.match(/specs\/([^/]+)\/FS-\d+\//);
+      const projectFolder = pathMatch ? pathMatch[1] : "default";
+      sections.push(`- **Feature Spec**: [${this.featureId}](${baseUrl}/.specweave/docs/internal/specs/${projectFolder}/${this.featureId}/FEATURE.md)`);
       const relativeUSPath = path.relative(this.projectRoot, this.userStoryPath);
       sections.push(`- **User Story File**: [${path.basename(this.userStoryPath)}](${baseUrl}/${relativeUSPath})`);
       const incrementMatch = implMatch?.[1]?.match(/\*\*Increment\*\*:\s*\[([^\]]+)\]/);
@@ -338,7 +340,9 @@ User Story ID: ${frontmatter.id}`
         sections.push(`- **Increment**: [${incrementId}](${baseUrl}/.specweave/increments/${incrementId})`);
       }
     } else {
-      sections.push(`- **Feature Spec**: [${this.featureId}](../.specweave/docs/internal/specs/_features/${this.featureId}/FEATURE.md)`);
+      const pathMatch = this.userStoryPath.match(/specs\/([^/]+)\/FS-\d+\//);
+      const projectFolder = pathMatch ? pathMatch[1] : "default";
+      sections.push(`- **Feature Spec**: [${this.featureId}](../.specweave/docs/internal/specs/${projectFolder}/${this.featureId}/FEATURE.md)`);
       sections.push(`- **User Story File**: [${path.basename(this.userStoryPath)}](${this.userStoryPath})`);
     }
     sections.push("");

package/plugins/specweave-github/lib/user-story-issue-builder.ts

@@ -525,11 +525,16 @@ export class UserStoryIssueBuilder {
     sections.push('');
 
     // Generate proper GitHub blob URLs
+    // v5.0.0+: Features live in project folders, NOT _features
     if (this.repoOwner && this.repoName) {
       const baseUrl = `https://github.com/${this.repoOwner}/${this.repoName}/blob/${this.branch}`;
 
+      // Extract project from user story path: specs/{project}/FS-XXX/us-*.md
+      const pathMatch = this.userStoryPath.match(/specs\/([^/]+)\/FS-\d+\//);
+      const projectFolder = pathMatch ? pathMatch[1] : 'default';
+
       // Feature Spec link
-      sections.push(`- **Feature Spec**: [${this.featureId}](${baseUrl}/.specweave/docs/internal/specs/_features/${this.featureId}/FEATURE.md)`);
+      sections.push(`- **Feature Spec**: [${this.featureId}](${baseUrl}/.specweave/docs/internal/specs/${projectFolder}/${this.featureId}/FEATURE.md)`);
 
       // User Story File link (relative to project root)
       const relativeUSPath = path.relative(this.projectRoot, this.userStoryPath);
@@ -543,7 +548,10 @@ export class UserStoryIssueBuilder {
       }
     } else {
       // Fallback to relative links if repo info not provided
-      sections.push(`- **Feature Spec**: [${this.featureId}](../.specweave/docs/internal/specs/_features/${this.featureId}/FEATURE.md)`);
+      // v5.0.0+: Features live in project folders, NOT _features
+      const pathMatch = this.userStoryPath.match(/specs\/([^/]+)\/FS-\d+\//);
+      const projectFolder = pathMatch ? pathMatch[1] : 'default';
+      sections.push(`- **Feature Spec**: [${this.featureId}](../.specweave/docs/internal/specs/${projectFolder}/${this.featureId}/FEATURE.md)`);
       sections.push(`- **User Story File**: [${path.basename(this.userStoryPath)}](${this.userStoryPath})`);
     }
 

package/plugins/specweave-github/skills/github-issue-standard/SKILL.md

@@ -70,12 +70,14 @@ Every GitHub issue MUST include:
    - Use GitHub task checkbox format
    - Example: `- [x] [T-008: Title](https://github.com/owner/repo/tree/develop/.specweave/increments/0031/tasks.md#t-008-title)`
 
-3. **Working GitHub URLs**
-   - Feature links: `https://github.com/owner/repo/tree/develop/.specweave/docs/internal/specs/_features/FS-031`
-   - User story links: `https://github.com/owner/repo/tree/develop/.specweave/docs/internal/specs/default/FS-031/us-004-*.md`
+3. **Working GitHub URLs** (v5.0.0+ - NO _features folder)
+   - Feature links: `https://github.com/owner/repo/tree/develop/.specweave/docs/internal/specs/{project}/FS-031`
+   - User story links: `https://github.com/owner/repo/tree/develop/.specweave/docs/internal/specs/{project}/FS-031/us-004-*.md`
    - Task links: `https://github.com/owner/repo/tree/develop/.specweave/increments/0031/tasks.md#task-anchor`
    - Increment links: `https://github.com/owner/repo/tree/develop/.specweave/increments/0031`
 
+   **Note**: Feature ID is DERIVED from increment (0031 → FS-031)
+
 4. **Extracted Priority**
    - Extract from ACs (highest priority wins: P1 > P2 > P3)
    - Show ONLY if priority exists (don't show "undefined")
@@ -87,7 +89,7 @@ Every GitHub issue MUST include:
 
 ### ❌ Never Use
 
-- ❌ Relative paths (`../../_features/FS-031`)
+- ❌ Relative paths (`../../{project}/FS-031`)
 - ❌ Undefined values (`**Priority**: undefined`)
 - ❌ Project field in metadata
 - ❌ Plain bullet points for ACs (must be checkboxes)
@@ -112,8 +114,8 @@ private async detectGitHubRepo(): Promise<string | null>
 // 3. Extract priority from ACs
 private extractPriorityFromACs(criteria: AcceptanceCriterion[]): string | null
 
-// 4. Generate GitHub URLs (not relative)
-const featureUrl = `https://github.com/${repo}/tree/develop/.specweave/docs/internal/specs/_features/${featureId}`;
+// 4. Generate GitHub URLs (not relative) - v5.0.0+: No _features folder
+const featureUrl = `https://github.com/${repo}/tree/develop/.specweave/docs/internal/specs/${project}/${featureId}`;
 
 // 5. Convert task links to GitHub URLs
 if (repo && taskLink.startsWith('../../')) {
@@ -125,7 +127,7 @@ if (repo && taskLink.startsWith('../../')) {
 ### Template
 
 ```markdown
-**Feature**: [FS-031](https://github.com/owner/repo/tree/develop/.specweave/docs/internal/specs/_features/FS-031)
+**Feature**: [FS-031](https://github.com/owner/repo/tree/develop/.specweave/docs/internal/specs/{project}/FS-031)
 **Status**: complete
 **Priority**: P1
 
@@ -137,7 +139,7 @@ if (repo && taskLink.startsWith('../../')) {
 **I want** feature
 **So that** benefit
 
-📄 View full story: [`us-004-name.md`](https://github.com/owner/repo/tree/develop/.specweave/docs/internal/specs/default/_archive/FS-031/us-004-name.md)
+📄 View full story: [`us-004-name.md`](https://github.com/owner/repo/tree/develop/.specweave/docs/internal/specs/{project}/FS-031/us-004-name.md)
 
 ---