specweave 1.0.301 → 1.0.304

package/dist/src/core/increment/template-creator.js

@@ -67,7 +67,7 @@ export const TEMPLATE_MARKERS = {
  * ```
  */
 export async function createIncrementTemplates(options) {
-    const { incrementId, title, description, projectId, boardId, type = 'feature', priority = 'P1', testMode = 'test-after', coverageTarget = 80, projectRoot = process.cwd(), } = options;
+    const { incrementId, title, description, projectId, boardId, type = 'feature', priority = 'P1', testMode = 'test-after', coverageTarget = 80, projectRoot = process.cwd(), externalSource, } = options;
     const incrementsDir = path.join(projectRoot, '.specweave', 'increments');
     const incrementPath = path.join(incrementsDir, incrementId);
     const createdFiles = [];
@@ -91,21 +91,46 @@ export async function createIncrementTemplates(options) {
             epic_id: null,
             externalLinks: {},
         };
+        // Add external source tracking for imported issues (v1.0.272)
+        if (externalSource) {
+            metadata.origin = 'external';
+            metadata.source_platform = externalSource.platform;
+            metadata.external_ref = externalSource.externalId;
+            metadata.externalLinks = {
+                [externalSource.platform]: {
+                    url: externalSource.externalUrl,
+                    synced: new Date().toISOString(),
+                },
+            };
+        }
         fs.writeFileSync(metadataPath, JSON.stringify(metadata, null, 2));
         createdFiles.push('metadata.json');
-        // 2. Create spec.md TEMPLATE
+        // 2. Create spec.md — pre-filled from external source or template
         const specPath = path.join(incrementPath, 'spec.md');
-        const specContent = generateSpecTemplate({
-            incrementId,
-            title,
-            description,
-            projectId,
-            boardId,
-            type,
-            priority,
-            testMode,
-            coverageTarget,
-        });
+        const specContent = externalSource
+            ? generateExternalSpecContent({
+                incrementId,
+                title,
+                description: externalSource.description || description,
+                projectId,
+                boardId,
+                type,
+                priority: externalSource.priority || priority,
+                testMode,
+                coverageTarget,
+                externalSource,
+            })
+            : generateSpecTemplate({
+                incrementId,
+                title,
+                description,
+                projectId,
+                boardId,
+                type,
+                priority,
+                testMode,
+                coverageTarget,
+            });
         fs.writeFileSync(specPath, specContent);
         createdFiles.push('spec.md');
         // 3. Create plan.md TEMPLATE
@@ -113,20 +138,29 @@ export async function createIncrementTemplates(options) {
         const planContent = generatePlanTemplate({ title });
         fs.writeFileSync(planPath, planContent);
         createdFiles.push('plan.md');
-        // 4. Create tasks.md TEMPLATE
+        // 4. Create tasks.md — derived from external ACs or template
         const tasksPath = path.join(incrementPath, 'tasks.md');
-        const tasksContent = generateTasksTemplate({ title, testMode });
+        const tasksContent = externalSource?.acceptanceCriteria?.length
+            ? generateExternalTasksContent({ title, testMode, acceptanceCriteria: externalSource.acceptanceCriteria })
+            : generateTasksTemplate({ title, testMode });
         fs.writeFileSync(tasksPath, tasksContent);
         createdFiles.push('tasks.md');
+        const nextSteps = externalSource
+            ? [
+                `Imported from ${externalSource.platform}: ${externalSource.externalUrl}`,
+                `Review and refine spec: /sw:do ${incrementId}`,
+                `Start working: /sw:auto ${incrementId}`,
+            ]
+            : [
+                `Complete product specification: Tell Claude "Complete the spec for increment ${incrementId}"`,
+                `Design architecture: Tell Claude "Design architecture for increment ${incrementId}"`,
+                `Generate tasks: Tell Claude "Create tasks for increment ${incrementId}"`,
+            ];
         return {
             success: true,
             incrementPath,
             createdFiles,
-            nextSteps: [
-                `Complete product specification: Tell Claude "Complete the spec for increment ${incrementId}"`,
-                `Design architecture: Tell Claude "Design architecture for increment ${incrementId}"`,
-                `Generate tasks: Tell Claude "Create tasks for increment ${incrementId}"`,
-            ],
+            nextSteps,
         };
     }
     catch (error) {
@@ -471,6 +505,131 @@ This will activate the test-aware planner which will:
 - [ ] [T051] Verify all acceptance criteria
 `;
 }
+/**
+ * Generate spec.md content pre-filled from an external issue.
+ *
+ * Unlike the template version, this generates real content from the
+ * external issue's title, description, and acceptance criteria.
+ *
+ * @since 1.0.272
+ */
+function generateExternalSpecContent(options) {
+    const { incrementId, title, description, projectId, boardId, type, priority, testMode, coverageTarget, externalSource, } = options;
+    const date = new Date().toISOString().split('T')[0];
+    const boardLine = boardId ? `**Board**: ${boardId}\n` : '';
+    const platformLabel = externalSource.platform === 'github' ? 'GitHub'
+        : externalSource.platform === 'jira' ? 'JIRA'
+            : 'Azure DevOps';
+    // Build acceptance criteria from external source
+    const acs = externalSource.acceptanceCriteria ?? [];
+    const acLines = acs.length > 0
+        ? acs.map((ac, i) => `- [ ] **AC-US1-${String(i + 1).padStart(2, '0')}**: ${ac}`).join('\n')
+        : `- [ ] **AC-US1-01**: [Review and define acceptance criteria from imported issue]`;
+    // Build labels section
+    const labelsLine = externalSource.labels?.length
+        ? `\n**Labels**: ${externalSource.labels.join(', ')}`
+        : '';
+    return `---
+increment: ${incrementId}
+title: "${title}"
+type: ${type}
+priority: ${priority}
+status: planned
+created: ${date}
+structure: user-stories
+test_mode: ${testMode}
+coverage_target: ${coverageTarget}
+source_platform: ${externalSource.platform}
+external_ref: "${externalSource.externalId}"
+---
+
+# Feature: ${title}
+
+<!-- IMPORTED FROM ${platformLabel}: ${externalSource.externalUrl} -->
+
+## Overview
+
+${description || `Imported from ${platformLabel}. See original issue for full context.`}
+
+## External Source
+
+- **Platform**: ${platformLabel}
+- **URL**: ${externalSource.externalUrl}
+- **External ID**: ${externalSource.externalId}
+- **Import Date**: ${date}
+
+## User Stories
+
+### US-001: ${title} (${priority})
+**Project**: ${projectId}
+${boardLine}
+**As a** user
+**I want** ${title.toLowerCase()}
+**So that** the issue tracked in ${platformLabel} is resolved${labelsLine}
+
+**Acceptance Criteria**:
+${acLines}
+
+## Functional Requirements
+
+${description ? `### FR-001: ${title}\n${description}` : `### FR-001: [To be defined from imported issue]`}
+
+## Success Criteria
+
+- All acceptance criteria from the imported ${platformLabel} issue are met
+- Original issue can be closed/resolved after verification
+`;
+}
+/**
+ * Generate tasks.md content derived from external acceptance criteria.
+ *
+ * Each AC becomes a task with a BDD test skeleton.
+ *
+ * @since 1.0.272
+ */
+function generateExternalTasksContent(options) {
+    const { title, acceptanceCriteria } = options;
+    const taskEntries = acceptanceCriteria.map((ac, i) => {
+        const taskNum = String(i + 1).padStart(3, '0');
+        return `#### T-${taskNum}: ${ac}
+
+**Description**: Implement and verify: ${ac}
+
+**References**: AC-US1-${String(i + 1).padStart(2, '0')}
+
+**Test Plan**:
+- **Tests**:
+  - **TC-${taskNum}**: Verify ${ac}
+    - Given the system is set up
+    - When the feature is implemented
+    - Then ${ac}
+
+**Status**: [ ] Not Started`;
+    }).join('\n\n');
+    return `# Tasks: ${title}
+
+<!-- IMPORTED — Tasks derived from external acceptance criteria -->
+
+## Task Notation
+
+- \`[T###]\`: Task ID
+- \`[P]\`: Parallelizable
+- \`[ ]\`: Not started
+- \`[x]\`: Completed
+- Model hints: haiku (simple), opus (default)
+
+## Phase 1: Core Implementation
+
+### US-001: ${title} (P1)
+
+${taskEntries}
+
+## Phase 2: Verification
+
+- [ ] [T${String(acceptanceCriteria.length + 1).padStart(3, '0')}] Run all tests
+- [ ] [T${String(acceptanceCriteria.length + 2).padStart(3, '0')}] Verify all acceptance criteria
+`;
+}
 export default {
     createIncrementTemplates,
     isTemplateFile,

package/dist/src/core/increment/template-creator.js.map

@@ -1 +1 @@
-{"version":3,"file":"template-creator.js","sourceRoot":"","sources":["../../../../src/core/increment/template-creator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"template-creator.js","sourceRoot":"","sources":["../../../../src/core/increment/template-creator.ts"],"names":[],"mappings":"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"}

package/dist/src/importers/import-to-increment.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Import-to-Increment Converter
+ *
+ * Bridges the gap between ExternalItem (imported from GitHub/JIRA/ADO)
+ * and SpecWeave increment creation with platform-specific suffixes.
+ *
+ * @module import-to-increment
+ * @since 1.0.272
+ */
+import { type Platform } from '../sync/types.js';
+import type { ExternalItem } from './external-importer.js';
+/**
+ * Result of a single increment import.
+ */
+export interface ImportedIncrement {
+    /** Full increment ID (e.g., "0271G-fix-login-bug") */
+    incrementId: string;
+    /** Absolute path to created increment directory */
+    incrementPath: string;
+    /** Canonical external reference */
+    externalRef: string;
+    /** Source platform */
+    platform: Platform;
+    /** Files created in the increment */
+    createdFiles: string[];
+}
+/**
+ * Result of a skipped (duplicate) import.
+ */
+export interface SkippedImport {
+    /** The external item that was skipped */
+    item: ExternalItem;
+    /** Canonical external reference */
+    externalRef: string;
+    /** Existing increment ID that already has this ref */
+    existingIncrementId: string;
+    /** Reason for skipping */
+    reason: string;
+}
+/**
+ * Result of a batch import operation.
+ */
+export interface BatchImportResult {
+    /** Successfully created increments */
+    created: ImportedIncrement[];
+    /** Skipped duplicate imports */
+    skipped: SkippedImport[];
+    /** Errors encountered */
+    errors: Array<{
+        item: ExternalItem;
+        error: string;
+    }>;
+}
+/**
+ * Options for the import-to-increment converter.
+ */
+export interface ImportToIncrementOptions {
+    /** Project root directory */
+    projectRoot: string;
+    /** Target project ID (for per-project collision prevention) */
+    projectId?: string;
+}
+/**
+ * Converts external items (from GitHub/JIRA/ADO) into SpecWeave increments
+ * with platform-specific suffixes (G/J/A) and duplicate prevention.
+ *
+ * @example
+ * ```typescript
+ * const converter = new ImportToIncrementConverter({
+ *   projectRoot: '/path/to/project',
+ *   projectId: 'my-app',
+ * });
+ *
+ * const result = await converter.createIncrement(externalItem);
+ * console.log(result.incrementId); // "0271G-fix-login-bug"
+ * ```
+ */
+export declare class ImportToIncrementConverter {
+    private projectRoot;
+    private projectId?;
+    private refDetector;
+    constructor(options: ImportToIncrementOptions);
+    /**
+     * Check if an external item has already been imported as an increment.
+     *
+     * @param item - External item to check
+     * @returns Existing increment ID if found, null otherwise
+     */
+    checkDuplicate(item: ExternalItem): string | null;
+    /**
+     * Create a single increment from an external item.
+     *
+     * @param item - External item to import
+     * @returns Created increment details
+     * @throws Error if item is a duplicate (use checkDuplicate first) or creation fails
+     */
+    createIncrement(item: ExternalItem): Promise<ImportedIncrement>;
+    /**
+     * Batch create increments from multiple external items.
+     * Automatically deduplicates and reports skipped items.
+     *
+     * @param items - External items to import
+     * @returns Batch result with created, skipped, and error arrays
+     */
+    createIncrements(items: ExternalItem[]): Promise<BatchImportResult>;
+    /**
+     * Build a canonical external_ref string from an ExternalItem.
+     */
+    private buildExternalRef;
+}
+//# sourceMappingURL=import-to-increment.d.ts.map

package/dist/src/importers/import-to-increment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-to-increment.d.ts","sourceRoot":"","sources":["../../../src/importers/import-to-increment.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,qCAAqC;IACrC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,IAAI,EAAE,YAAY,CAAC;IACnB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,gCAAgC;IAChC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,yBAAyB;IACzB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,WAAW,CAA+B;gBAEtC,OAAO,EAAE,wBAAwB;IAM7C;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI;IAMjD;;;;;;OAMG;IACG,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgErE;;;;;;OAMG;IACG,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0CzE;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAoBzB"}

package/dist/src/importers/import-to-increment.js

@@ -0,0 +1,223 @@
+/**
+ * Import-to-Increment Converter
+ *
+ * Bridges the gap between ExternalItem (imported from GitHub/JIRA/ADO)
+ * and SpecWeave increment creation with platform-specific suffixes.
+ *
+ * @module import-to-increment
+ * @since 1.0.272
+ */
+import { IncrementNumberManager } from '../core/increment/increment-utils.js';
+import { createIncrementTemplates } from '../core/increment/template-creator.js';
+import { IncrementExternalRefDetector, formatExternalRef } from './increment-external-ref-detector.js';
+import { SUFFIX_MAP } from '../sync/types.js';
+/**
+ * Converts external items (from GitHub/JIRA/ADO) into SpecWeave increments
+ * with platform-specific suffixes (G/J/A) and duplicate prevention.
+ *
+ * @example
+ * ```typescript
+ * const converter = new ImportToIncrementConverter({
+ *   projectRoot: '/path/to/project',
+ *   projectId: 'my-app',
+ * });
+ *
+ * const result = await converter.createIncrement(externalItem);
+ * console.log(result.incrementId); // "0271G-fix-login-bug"
+ * ```
+ */
+export class ImportToIncrementConverter {
+    constructor(options) {
+        this.projectRoot = options.projectRoot;
+        this.projectId = options.projectId;
+        this.refDetector = new IncrementExternalRefDetector(options.projectRoot);
+    }
+    /**
+     * Check if an external item has already been imported as an increment.
+     *
+     * @param item - External item to check
+     * @returns Existing increment ID if found, null otherwise
+     */
+    checkDuplicate(item) {
+        const externalRef = this.buildExternalRef(item);
+        const match = this.refDetector.hasRef(externalRef);
+        return match ? match.incrementId : null;
+    }
+    /**
+     * Create a single increment from an external item.
+     *
+     * @param item - External item to import
+     * @returns Created increment details
+     * @throws Error if item is a duplicate (use checkDuplicate first) or creation fails
+     */
+    async createIncrement(item) {
+        const externalRef = this.buildExternalRef(item);
+        // Check for duplicates
+        const existing = this.refDetector.hasRef(externalRef);
+        if (existing) {
+            throw new Error(`Duplicate import: ${externalRef} already imported as ${existing.incrementId} (${existing.location})`);
+        }
+        // Generate increment ID with platform suffix
+        const slug = slugify(item.title);
+        const platformSuffix = SUFFIX_MAP[item.platform];
+        const incrementId = IncrementNumberManager.generateIncrementId(slug, {
+            platformSuffix,
+            projectRoot: this.projectRoot,
+            projectId: this.projectId,
+        });
+        // Build external source info for template creator
+        const externalSource = {
+            platform: item.platform,
+            externalId: externalRef,
+            externalUrl: item.url,
+            title: item.title,
+            description: item.description,
+            acceptanceCriteria: item.acceptanceCriteria,
+            labels: item.labels,
+            priority: item.priority,
+            status: item.status,
+        };
+        // Map external priority to SpecWeave priority
+        const priority = item.priority ?? 'P2';
+        // Map external type to SpecWeave type
+        const type = mapExternalType(item.type);
+        // Create increment via template creator
+        const result = await createIncrementTemplates({
+            incrementId,
+            title: item.title,
+            description: item.description,
+            projectId: this.projectId || 'default',
+            type,
+            priority,
+            projectRoot: this.projectRoot,
+            externalSource,
+        });
+        if (!result.success) {
+            throw new Error(`Failed to create increment ${incrementId}: ${result.error}`);
+        }
+        return {
+            incrementId,
+            incrementPath: result.incrementPath,
+            externalRef,
+            platform: item.platform,
+            createdFiles: result.createdFiles,
+        };
+    }
+    /**
+     * Batch create increments from multiple external items.
+     * Automatically deduplicates and reports skipped items.
+     *
+     * @param items - External items to import
+     * @returns Batch result with created, skipped, and error arrays
+     */
+    async createIncrements(items) {
+        const result = {
+            created: [],
+            skipped: [],
+            errors: [],
+        };
+        // Pre-check all refs at once for efficiency
+        const refs = items.map(item => this.buildExternalRef(item));
+        const existingRefs = this.refDetector.checkRefs(refs);
+        for (let i = 0; i < items.length; i++) {
+            const item = items[i];
+            const ref = refs[i];
+            // Check duplicate
+            const existing = existingRefs.get(ref);
+            if (existing) {
+                result.skipped.push({
+                    item,
+                    externalRef: ref,
+                    existingIncrementId: existing.incrementId,
+                    reason: `Already imported as ${existing.incrementId} (${existing.location})`,
+                });
+                continue;
+            }
+            // Try to create
+            try {
+                const imported = await this.createIncrement(item);
+                result.created.push(imported);
+            }
+            catch (error) {
+                result.errors.push({
+                    item,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        return result;
+    }
+    /**
+     * Build a canonical external_ref string from an ExternalItem.
+     */
+    buildExternalRef(item) {
+        switch (item.platform) {
+            case 'github': {
+                // GitHub IDs are formatted as "github#{owner/repo}#{number}"
+                const repo = item.sourceRepo || extractGitHubRepo(item.id);
+                const issueNumber = extractGitHubNumber(item.id);
+                return formatExternalRef('github', repo, issueNumber);
+            }
+            case 'jira': {
+                // JIRA IDs are the issue key (e.g., "PROJ-123")
+                const project = item.jiraProjectKey || extractJiraProject(item.id);
+                return formatExternalRef('jira', project, item.id);
+            }
+            case 'ado': {
+                // ADO IDs are work item numbers
+                const project = item.adoProjectName || 'default';
+                return formatExternalRef('ado', project, item.id);
+            }
+        }
+    }
+}
+/**
+ * Convert a title to a kebab-case slug suitable for increment folder names.
+ * Limits to 50 chars to keep folder names reasonable.
+ */
+function slugify(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, '') // Remove special chars
+        .replace(/\s+/g, '-') // Spaces to hyphens
+        .replace(/-+/g, '-') // Collapse multiple hyphens
+        .replace(/^-|-$/g, '') // Trim leading/trailing hyphens
+        .slice(0, 50) // Limit length
+        .replace(/-$/, ''); // Clean trailing hyphen after slice
+}
+/**
+ * Map external item type to SpecWeave increment type.
+ */
+function mapExternalType(externalType) {
+    switch (externalType) {
+        case 'bug': return 'bug';
+        case 'feature': return 'feature';
+        case 'epic': return 'feature';
+        case 'user-story': return 'feature';
+        case 'task': return 'feature';
+        default: return 'feature';
+    }
+}
+/**
+ * Extract owner/repo from a GitHub external ID.
+ * Input format: "github#owner/repo#123" or just a number.
+ */
+function extractGitHubRepo(id) {
+    const match = id.match(/github#([^#]+)#/);
+    return match ? match[1] : 'unknown/unknown';
+}
+/**
+ * Extract issue number from a GitHub external ID.
+ */
+function extractGitHubNumber(id) {
+    const match = id.match(/#(\d+)$/);
+    return match ? match[1] : id.replace(/\D/g, '') || '0';
+}
+/**
+ * Extract project key from a JIRA issue ID (e.g., "PROJ-123" → "PROJ").
+ */
+function extractJiraProject(id) {
+    const match = id.match(/^([A-Z]+)-/);
+    return match ? match[1] : 'UNKNOWN';
+}
+//# sourceMappingURL=import-to-increment.js.map

package/dist/src/importers/import-to-increment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-to-increment.js","sourceRoot":"","sources":["../../../src/importers/import-to-increment.ts"],"names":[],"mappings":"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"}