specweave 0.17.16 → 0.18.0

package/dist/src/utils/github-url.js

@@ -0,0 +1,90 @@
+/**
+ * GitHub URL Utilities
+ *
+ * Utilities for converting local file paths to GitHub URLs.
+ */
+/**
+ * Convert local file path to GitHub URL
+ *
+ * @param localPath - Local file path (can start with ./ or be absolute)
+ * @param options - GitHub repository options
+ * @returns Full GitHub URL
+ *
+ * @example
+ * ```typescript
+ * toGitHubUrl('.specweave/docs/internal/specs/default/FS-001/FEATURE.md', {
+ *   owner: 'anton-abyzov',
+ *   repo: 'specweave',
+ *   branch: 'develop'
+ * });
+ * // => 'https://github.com/anton-abyzov/specweave/blob/develop/.specweave/docs/internal/specs/default/FS-001/FEATURE.md'
+ * ```
+ */
+export function toGitHubUrl(localPath, options) {
+    const { owner, repo, branch = 'develop' } = options;
+    // Remove leading ./ but keep .specweave folder name
+    let cleanPath = localPath.replace(/^\.\//, '');
+    // If path doesn't start with .specweave, add it
+    if (!cleanPath.startsWith('.specweave')) {
+        cleanPath = `.specweave/${cleanPath}`;
+    }
+    return `https://github.com/${owner}/${repo}/blob/${branch}/${cleanPath}`;
+}
+/**
+ * Convert local directory path to GitHub tree URL
+ *
+ * @param localPath - Local directory path
+ * @param options - GitHub repository options
+ * @returns Full GitHub tree URL
+ *
+ * @example
+ * ```typescript
+ * toGitHubTreeUrl('.specweave/increments/0001-feature', {
+ *   owner: 'anton-abyzov',
+ *   repo: 'specweave',
+ *   branch: 'develop'
+ * });
+ * // => 'https://github.com/anton-abyzov/specweave/tree/develop/.specweave/increments/0001-feature'
+ * ```
+ */
+export function toGitHubTreeUrl(localPath, options) {
+    const { owner, repo, branch = 'develop' } = options;
+    // Remove leading ./ but keep .specweave folder name
+    let cleanPath = localPath.replace(/^\.\//, '');
+    // If path doesn't start with .specweave, add it
+    if (!cleanPath.startsWith('.specweave')) {
+        cleanPath = `.specweave/${cleanPath}`;
+    }
+    return `https://github.com/${owner}/${repo}/tree/${branch}/${cleanPath}`;
+}
+/**
+ * Get GitHub URL options from git remote
+ *
+ * @returns GitHub URL options or null if not a GitHub repository
+ */
+export async function getGitHubOptions() {
+    try {
+        const { execFile } = await import('child_process');
+        const { promisify } = await import('util');
+        const execFileAsync = promisify(execFile);
+        // Get remote URL
+        const { stdout } = await execFileAsync('git', ['remote', 'get-url', 'origin']);
+        const remoteUrl = stdout.trim();
+        // Parse GitHub URL (supports both HTTPS and SSH)
+        // HTTPS: https://github.com/owner/repo.git
+        // SSH: git@github.com:owner/repo.git
+        const match = remoteUrl.match(/github\.com[:/]([^/]+)\/(.+?)(?:\.git)?$/);
+        if (!match) {
+            return null;
+        }
+        const [, owner, repo] = match;
+        // Get current branch
+        const { stdout: branchOutput } = await execFileAsync('git', ['branch', '--show-current']);
+        const branch = branchOutput.trim() || 'develop';
+        return { owner, repo, branch };
+    }
+    catch (error) {
+        return null;
+    }
+}
+//# sourceMappingURL=github-url.js.map

package/dist/src/utils/github-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-url.js","sourceRoot":"","sources":["../../../src/utils/github-url.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,OAAyB;IACtE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,OAAO,CAAC;IAEpD,oDAAoD;IACpD,IAAI,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAE/C,gDAAgD;IAChD,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACxC,SAAS,GAAG,cAAc,SAAS,EAAE,CAAC;IACxC,CAAC;IAED,OAAO,sBAAsB,KAAK,IAAI,IAAI,SAAS,MAAM,IAAI,SAAS,EAAE,CAAC;AAC3E,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,OAAyB;IAC1E,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,OAAO,CAAC;IAEpD,oDAAoD;IACpD,IAAI,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAE/C,gDAAgD;IAChD,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACxC,SAAS,GAAG,cAAc,SAAS,EAAE,CAAC;IACxC,CAAC;IAED,OAAO,sBAAsB,KAAK,IAAI,IAAI,SAAS,MAAM,IAAI,SAAS,EAAE,CAAC;AAC3E,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QACnD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QAE1C,iBAAiB;QACjB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC/E,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAEhC,iDAAiD;QACjD,2CAA2C;QAC3C,qCAAqC;QACrC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAE1E,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;QAE9B,qBAAqB;QACrB,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAC1F,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;QAEhD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/src/utils/spec-parser.d.ts

@@ -0,0 +1,145 @@
+/**
+ * SpecWeave Spec Parser Utilities
+ *
+ * Parses increment and living docs specifications to extract structured data.
+ *
+ * Key responsibilities:
+ * - Extract user stories from markdown
+ * - Parse increment specs (temporary, implementation-focused)
+ * - Parse living docs specs (permanent, epic-level)
+ * - Generate links to related documentation (avoid duplication)
+ * - Merge user stories intelligently
+ *
+ * @author SpecWeave Team
+ * @version 2.0.0
+ */
+/**
+ * User story with acceptance criteria
+ */
+export interface UserStory {
+    id: string;
+    title: string;
+    description: string;
+    acceptanceCriteria: AcceptanceCriterion[];
+    implementedIn?: string;
+    status: 'pending' | 'in-progress' | 'complete';
+    epic?: string;
+    priority?: string;
+}
+/**
+ * Acceptance criterion
+ */
+export interface AcceptanceCriterion {
+    id: string;
+    description: string;
+    priority?: string;
+    testable: boolean;
+    completed: boolean;
+}
+/**
+ * Implementation history entry
+ */
+export interface ImplementationHistoryEntry {
+    increment: string;
+    stories: string[];
+    status: 'complete' | 'in-progress' | 'planned';
+    date?: string;
+    notes?: string;
+}
+/**
+ * Related documentation links
+ */
+export interface RelatedDocs {
+    architecture: string[];
+    adrs: string[];
+    strategy: string[];
+    operations: string[];
+    delivery: string[];
+}
+/**
+ * External tool links
+ */
+export interface ExternalLinks {
+    github?: string;
+    jira?: string;
+    ado?: string;
+}
+/**
+ * Increment spec structure (temporary, implementation-focused)
+ */
+export interface IncrementSpec {
+    id: string;
+    title: string;
+    overview: string;
+    implementsSpec?: string;
+    userStories: UserStory[];
+    outOfScope?: string[];
+    architecture?: string;
+    adrs?: string[];
+    priority?: string;
+    status?: string;
+}
+/**
+ * Living docs spec structure (permanent, epic-level)
+ */
+export interface LivingDocsSpec {
+    id: string;
+    title: string;
+    featureArea: string;
+    overview: string;
+    userStories: UserStory[];
+    implementationHistory: ImplementationHistoryEntry[];
+    relatedDocs: RelatedDocs;
+    externalLinks: ExternalLinks;
+    priority?: string;
+    status?: string;
+    created?: string;
+    lastUpdated?: string;
+}
+/**
+ * Parse increment spec.md into structured data
+ *
+ * Extracts user stories, acceptance criteria, and metadata.
+ * Discards architecture details (those belong in architecture/ folder).
+ */
+export declare function parseIncrementSpec(filePath: string): Promise<IncrementSpec>;
+/**
+ * Parse living docs spec.md into structured data
+ */
+export declare function parseLivingDocsSpec(filePath: string): Promise<LivingDocsSpec>;
+/**
+ * Extract user stories from markdown content
+ *
+ * Supports formats:
+ * - **US-001**: Description
+ * - ### US-001: Title
+ * - **US1**: Description (legacy)
+ */
+export declare function extractUserStories(markdown: string): UserStory[];
+/**
+ * Generate links to related documentation (avoid duplication)
+ *
+ * Analyzes increment spec to find architecture references and generates
+ * proper links instead of duplicating content.
+ */
+export declare function generateRelatedDocsLinks(spec: IncrementSpec, projectRoot?: string): RelatedDocs;
+/**
+ * Extract spec ID from increment ID
+ *
+ * Examples:
+ * - 0001-core-framework → SPEC-001
+ * - 0002-core-enhancements → SPEC-002 (if part of same spec)
+ * - 0005-cross-platform-cli → SPEC-001 (if part of core spec)
+ */
+export declare function extractSpecId(incrementId: string): string;
+/**
+ * Merge user stories from increment into living docs
+ *
+ * Adds new stories, updates existing stories with completion status.
+ */
+export declare function mergeUserStories(existingStories: UserStory[], newStories: UserStory[], incrementId: string): UserStory[];
+/**
+ * Write living docs spec to file
+ */
+export declare function writeLivingDocsSpec(filePath: string, spec: LivingDocsSpec): Promise<void>;
+//# sourceMappingURL=spec-parser.d.ts.map

package/dist/src/utils/spec-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-parser.d.ts","sourceRoot":"","sources":["../../../src/utils/spec-parser.ts"],"names":[],"mappings":"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"}