specweave 1.0.464 → 1.0.466

package/dist/plugins/specweave/lib/vendor/core/universal-auto-create.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Universal Auto-Create for External Tools
+ *
+ * Creates per-user-story items in ALL enabled providers (JIRA, ADO).
+ * GitHub is handled separately by the existing github-auto-create-handler.sh.
+ *
+ * Called by universal-auto-create-dispatcher.sh when spec.md is written.
+ *
+ * @module universal-auto-create
+ */
+export interface UniversalAutoCreateConfig {
+    sync: {
+        jira?: {
+            enabled?: boolean;
+        };
+        ado?: {
+            enabled?: boolean;
+        };
+    };
+    jira?: {
+        domain?: string;
+        projectKey?: string;
+    };
+    ado?: {
+        organization?: string;
+        project?: string;
+    };
+}
+export interface UserStoryInfo {
+    id: string;
+    title: string;
+}
+export interface ProviderCreateResult {
+    created: Array<{
+        usId: string;
+        ref: string;
+        url: string;
+    }>;
+    skipped: Array<{
+        usId: string;
+        reason: string;
+    }>;
+    errors: Array<{
+        usId: string;
+        error: string;
+    }>;
+}
+export type UniversalAutoCreateResult = {
+    jira?: ProviderCreateResult;
+    ado?: ProviderCreateResult;
+};
+/**
+ * Parse user stories (ID + title) from spec.md content.
+ * Matches patterns like "### US-001: User story title"
+ */
+export declare function parseUserStories(content: string): UserStoryInfo[];
+/**
+ * Create per-user-story items in JIRA and/or ADO for an increment.
+ *
+ * GitHub is NOT handled here (delegated to existing bash handler).
+ * This function is called by the universal-auto-create-dispatcher.sh.
+ */
+export declare function createExternalIssuesForIncrement(incrementId: string, specPath: string, metadataPath: string, config: UniversalAutoCreateConfig): Promise<UniversalAutoCreateResult>;
+//# sourceMappingURL=universal-auto-create.d.ts.map

package/dist/plugins/specweave/lib/vendor/core/universal-auto-create.js

@@ -0,0 +1,228 @@
+/**
+ * Universal Auto-Create for External Tools
+ *
+ * Creates per-user-story items in ALL enabled providers (JIRA, ADO).
+ * GitHub is handled separately by the existing github-auto-create-handler.sh.
+ *
+ * Called by universal-auto-create-dispatcher.sh when spec.md is written.
+ *
+ * @module universal-auto-create
+ */
+import { readFile, writeFile } from 'fs/promises';
+import { existsSync } from 'fs';
+import { deriveFeatureId } from '../utils/feature-id-derivation.js';
+// ============================================================================
+// Helpers
+// ============================================================================
+function emptyResult() {
+    return { created: [], skipped: [], errors: [] };
+}
+/**
+ * Parse user stories (ID + title) from spec.md content.
+ * Matches patterns like "### US-001: User story title"
+ */
+export function parseUserStories(content) {
+    const stories = [];
+    const pattern = /###\s+(US-(?:[A-Z]+-)*\d+):\s*(.+)/g;
+    let match;
+    while ((match = pattern.exec(content)) !== null) {
+        stories.push({ id: match[1], title: match[2].trim() });
+    }
+    return stories;
+}
+// ============================================================================
+// Provider Functions
+// ============================================================================
+async function createJiraUserStories(incrementId, featureId, userStories, existingLinks, config) {
+    const result = emptyResult();
+    const { JiraClient } = await import('../integrations/jira/jira-client.js');
+    const domain = config.jira?.domain || '';
+    const projectKey = config.jira?.projectKey || '';
+    if (!domain || !projectKey) {
+        result.errors.push({ usId: 'config', error: 'JIRA domain or projectKey not configured' });
+        return result;
+    }
+    const client = new JiraClient();
+    for (const us of userStories) {
+        // Idempotency: skip if already linked
+        if (existingLinks[us.id]) {
+            result.skipped.push({ usId: us.id, reason: 'already-linked' });
+            continue;
+        }
+        try {
+            const summary = `[${featureId}][${us.id}] ${us.title}`;
+            const issue = await client.createIssue({
+                issueType: 'Story',
+                summary,
+                labels: ['specweave', 'auto-created'],
+            }, projectKey);
+            const issueUrl = `https://${domain}/browse/${issue.key}`;
+            result.created.push({ usId: us.id, ref: issue.key, url: issueUrl });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            result.errors.push({ usId: us.id, error: msg });
+        }
+    }
+    return result;
+}
+async function createAdoUserStories(incrementId, featureId, userStories, existingLinks, config) {
+    const result = emptyResult();
+    const { AdoClient } = await import('../integrations/ado/ado-client.js');
+    const { getAdoPat } = await import('../integrations/ado/ado-pat-provider.js');
+    const organization = config.ado?.organization || '';
+    const project = config.ado?.project || '';
+    if (!organization || !project) {
+        result.errors.push({ usId: 'config', error: 'ADO organization or project not configured' });
+        return result;
+    }
+    const pat = getAdoPat(organization);
+    if (!pat) {
+        result.errors.push({ usId: 'config', error: 'AZURE_DEVOPS_PAT not set' });
+        return result;
+    }
+    const client = new AdoClient({ pat, organization, project });
+    for (const us of userStories) {
+        // Idempotency: skip if already linked
+        if (existingLinks[us.id]) {
+            result.skipped.push({ usId: us.id, reason: 'already-linked' });
+            continue;
+        }
+        try {
+            const title = `[${featureId}][${us.id}] ${us.title}`;
+            const workItem = await client.createWorkItem({
+                workItemType: 'User Story',
+                title,
+                tags: ['specweave', 'auto-created'],
+            });
+            result.created.push({
+                usId: us.id,
+                ref: String(workItem.id),
+                url: workItem.url,
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            result.errors.push({ usId: us.id, error: msg });
+        }
+    }
+    return result;
+}
+// ============================================================================
+// Metadata Update
+// ============================================================================
+async function updateMetadata(metadataPath, results) {
+    if (!existsSync(metadataPath))
+        return;
+    const raw = await readFile(metadataPath, 'utf-8');
+    const metadata = JSON.parse(raw);
+    if (!metadata.externalLinks) {
+        metadata.externalLinks = {};
+    }
+    const now = new Date().toISOString();
+    // Update JIRA links
+    if (results.jira && results.jira.created.length > 0) {
+        if (!metadata.externalLinks.jira) {
+            metadata.externalLinks.jira = { userStories: {} };
+        }
+        if (!metadata.externalLinks.jira.userStories) {
+            metadata.externalLinks.jira.userStories = {};
+        }
+        for (const item of results.jira.created) {
+            metadata.externalLinks.jira.userStories[item.usId] = {
+                issueKey: item.ref,
+                issueUrl: item.url,
+                syncedAt: now,
+            };
+        }
+    }
+    // Update ADO links
+    if (results.ado && results.ado.created.length > 0) {
+        if (!metadata.externalLinks.ado) {
+            metadata.externalLinks.ado = { userStories: {} };
+        }
+        if (!metadata.externalLinks.ado.userStories) {
+            metadata.externalLinks.ado.userStories = {};
+        }
+        for (const item of results.ado.created) {
+            metadata.externalLinks.ado.userStories[item.usId] = {
+                workItemId: parseInt(item.ref, 10),
+                workItemUrl: item.url,
+                syncedAt: now,
+            };
+        }
+    }
+    await writeFile(metadataPath, JSON.stringify(metadata, null, 2) + '\n', 'utf-8');
+}
+// ============================================================================
+// Main Entry Point
+// ============================================================================
+/**
+ * Create per-user-story items in JIRA and/or ADO for an increment.
+ *
+ * GitHub is NOT handled here (delegated to existing bash handler).
+ * This function is called by the universal-auto-create-dispatcher.sh.
+ */
+export async function createExternalIssuesForIncrement(incrementId, specPath, metadataPath, config) {
+    const result = {};
+    // Parse user stories from spec.md
+    const content = await readFile(specPath, 'utf-8');
+    const userStories = parseUserStories(content);
+    if (userStories.length === 0) {
+        return result;
+    }
+    // Derive feature ID
+    let featureId;
+    try {
+        featureId = deriveFeatureId(incrementId);
+    }
+    catch {
+        const numMatch = incrementId.match(/^(\d+)/);
+        featureId = numMatch ? `FS-${parseInt(numMatch[1], 10)}` : `FS-${incrementId.substring(0, 3)}`;
+    }
+    // Load existing external links from metadata (for idempotency)
+    let existingJiraLinks = {};
+    let existingAdoLinks = {};
+    if (existsSync(metadataPath)) {
+        try {
+            const metaRaw = await readFile(metadataPath, 'utf-8');
+            const metadata = JSON.parse(metaRaw);
+            existingJiraLinks = metadata.externalLinks?.jira?.userStories || {};
+            existingAdoLinks = metadata.externalLinks?.ado?.userStories || {};
+        }
+        catch {
+            // Metadata parse error — proceed without existing links
+        }
+    }
+    // Create in each enabled provider (isolated errors)
+    if (config.sync?.jira?.enabled) {
+        try {
+            result.jira = await createJiraUserStories(incrementId, featureId, userStories, existingJiraLinks, config);
+        }
+        catch (err) {
+            const providerResult = emptyResult();
+            providerResult.errors.push({
+                usId: 'unknown',
+                error: err instanceof Error ? err.message : String(err),
+            });
+            result.jira = providerResult;
+        }
+    }
+    if (config.sync?.ado?.enabled) {
+        try {
+            result.ado = await createAdoUserStories(incrementId, featureId, userStories, existingAdoLinks, config);
+        }
+        catch (err) {
+            const providerResult = emptyResult();
+            providerResult.errors.push({
+                usId: 'unknown',
+                error: err instanceof Error ? err.message : String(err),
+            });
+            result.ado = providerResult;
+        }
+    }
+    // Update metadata with new links
+    await updateMetadata(metadataPath, result);
+    return result;
+}
+//# sourceMappingURL=universal-auto-create.js.map

package/dist/plugins/specweave/lib/vendor/core/universal-auto-create.js.map

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

package/dist/plugins/specweave/lib/vendor/generators/spec/task-parser.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Task Parser with US-Task Linkage Support
+ *
+ * Parses tasks.md files to extract task metadata including new US linkage fields:
+ * - userStory: US-ID this task implements (e.g., "US-001")
+ * - satisfiesACs: List of AC-IDs this task satisfies (e.g., ["AC-US1-01", "AC-US1-02"])
+ *
+ * Supports hierarchical task structure grouped by User Story.
+ */
+/**
+ * Task metadata extracted from tasks.md
+ */
+export interface Task {
+    /** Task ID (e.g., "T-001") */
+    id: string;
+    /** Task title */
+    title: string;
+    /** User Story this task implements (optional for backward compatibility) */
+    userStory?: string;
+    /** Acceptance Criteria IDs this task satisfies (optional) */
+    satisfiesACs?: string[];
+    /** Task completion status */
+    status: TaskStatus;
+    /** Priority level (P0, P1, P2, P3) */
+    priority?: string;
+    /** Estimated effort (e.g., "4 hours", "2 days") */
+    estimatedEffort?: string;
+    /** Task dependencies (task IDs this depends on) */
+    dependencies?: string[];
+    /** Full task description */
+    description?: string;
+    /** Files affected by this task */
+    filesAffected?: string[];
+    /** Line number in tasks.md (for error reporting) */
+    lineNumber?: number;
+}
+/**
+ * Task completion status
+ */
+export type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'transferred' | 'canceled';
+/**
+ * Tasks grouped by User Story
+ */
+export interface TasksByUserStory {
+    [usId: string]: Task[];
+}
+/**
+ * Validation error for task linkage
+ */
+export interface TaskLinkageError {
+    taskId: string;
+    field: 'userStory' | 'satisfiesACs';
+    value: string;
+    message: string;
+    suggestedFix?: string;
+}
+/**
+ * Parse tasks.md and extract all tasks with US linkage
+ *
+ * @param tasksPath - Path to tasks.md file
+ * @returns Map of User Story ID → Tasks
+ * @throws Error if tasks.md cannot be read or is malformed
+ */
+export declare function parseTasksWithUSLinks(tasksPath: string): TasksByUserStory;
+/**
+ * Validate task US and AC linkage
+ *
+ * @param task - Task to validate
+ * @param validUSIds - List of valid US-IDs from spec.md
+ * @param validACIds - List of valid AC-IDs from spec.md
+ * @returns Array of validation errors (empty if valid)
+ */
+export declare function validateTaskLinkage(task: Task, validUSIds: string[], validACIds: string[]): TaskLinkageError[];
+/**
+ * Get all tasks (flattened, not grouped by US)
+ *
+ * @param tasksByUS - Tasks grouped by User Story
+ * @returns Array of all tasks
+ */
+export declare function getAllTasks(tasksByUS: TasksByUserStory): Task[];
+/**
+ * Count tasks by status
+ *
+ * @param tasksByUS - Tasks grouped by User Story
+ * @returns Map of status → count
+ */
+export declare function countTasksByStatus(tasksByUS: TasksByUserStory): Record<TaskStatus, number>;
+/**
+ * Calculate completion percentage
+ *
+ * @param tasksByUS - Tasks grouped by User Story
+ * @returns Completion percentage (0-100)
+ */
+export declare function calculateCompletionPercentage(tasksByUS: TasksByUserStory): number;
+//# sourceMappingURL=task-parser.d.ts.map