specweave 1.0.593 → 2.0.0

package/dist/src/sync/github-sync-wrapper.d.ts

@@ -1,195 +0,0 @@
-/**
- * GitHub Sync Wrapper
- *
- * Wraps GitHub sync operations with the SyncInterceptor for permission checks
- * and audit logging. This provides a consistent interface for all GitHub sync
- * operations while ensuring they go through the permission enforcement layer.
- *
- * Usage:
- * ```typescript
- * const wrapper = new GitHubSyncWrapper({
- *   client: GitHubClientV2.fromRepo(owner, repo),
- *   interceptor,
- *   logger
- * });
- *
- * // All operations now go through permission enforcement
- * const issue = await wrapper.createUserStoryIssue(params);
- * ```
- *
- * @module sync/github-sync-wrapper
- */
-import { SyncInterceptor } from '../core/sync/sync-interceptor.js';
-import { GitHubClientV2 } from '../../plugins/specweave/lib/integrations/github/github-client-v2.js';
-import { GitHubIssue } from '../../plugins/specweave/lib/integrations/github/types.js';
-import { Logger } from '../utils/logger.js';
-/**
- * User story issue creation parameters
- */
-export interface CreateUserStoryIssueParams {
-    featureId: string;
-    userStoryId: string;
-    title: string;
-    body: string;
-    labels?: string[];
-    milestone?: number | null;
-}
-/**
- * Wrapper options
- */
-export interface GitHubSyncWrapperOptions {
-    /**
-     * GitHub client instance
-     */
-    client: GitHubClientV2;
-    /**
-     * Sync interceptor for permission checking
-     */
-    interceptor: SyncInterceptor;
-    /**
-     * Logger instance
-     */
-    logger?: Logger;
-}
-/**
- * Operation result with additional metadata
- */
-export interface WrappedOperationResult<T> {
-    /**
-     * Whether the operation was allowed and succeeded
-     */
-    success: boolean;
-    /**
-     * The result of the operation (null if denied or failed)
-     */
-    result: T | null;
-    /**
-     * Reason for denial (if denied)
-     */
-    denialReason?: string;
-    /**
-     * Error message (if failed)
-     */
-    error?: string;
-    /**
-     * Duration of the operation in milliseconds
-     */
-    durationMs: number;
-}
-/**
- * GitHubSyncWrapper - Permission-enforced GitHub sync operations
- *
- * All GitHub sync operations pass through the SyncInterceptor which:
- * 1. Checks permissions before execution
- * 2. Logs all attempts (success, denied, error)
- * 3. Provides consistent error handling
- *
- * This wrapper does NOT modify the underlying GitHubClientV2 - it provides
- * a parallel interface that can be used when permission checking is needed.
- */
-export declare class GitHubSyncWrapper {
-    private readonly client;
-    private readonly interceptor;
-    private readonly logger;
-    constructor(options: GitHubSyncWrapperOptions);
-    /**
-     * Create a GitHub issue for a user story
-     *
-     * @param params - Issue creation parameters
-     * @returns Wrapped operation result
-     */
-    createUserStoryIssue(params: CreateUserStoryIssueParams): Promise<WrappedOperationResult<GitHubIssue>>;
-    /**
-     * Create a generic epic/increment issue
-     *
-     * @param title - Issue title
-     * @param body - Issue body
-     * @param milestone - Optional milestone number or string
-     * @param labels - Issue labels
-     * @returns Wrapped operation result
-     */
-    createEpicIssue(title: string, body: string, milestone?: number | string, labels?: string[]): Promise<WrappedOperationResult<GitHubIssue>>;
-    /**
-     * Update a GitHub issue body
-     *
-     * @param issueNumber - Issue number
-     * @param body - New issue body
-     * @param origin - Item origin (internal or external)
-     * @returns Wrapped operation result
-     */
-    updateIssueBody(issueNumber: number, body: string, origin?: 'internal' | 'external'): Promise<WrappedOperationResult<void>>;
-    /**
-     * Close a GitHub issue
-     *
-     * @param issueNumber - Issue number
-     * @param comment - Optional closing comment
-     * @returns Wrapped operation result
-     */
-    closeIssue(issueNumber: number, comment?: string): Promise<WrappedOperationResult<void>>;
-    /**
-     * Reopen a GitHub issue
-     *
-     * @param issueNumber - Issue number
-     * @param comment - Optional reopening comment
-     * @returns Wrapped operation result
-     */
-    reopenIssue(issueNumber: number, comment?: string): Promise<WrappedOperationResult<void>>;
-    /**
-     * Add a comment to a GitHub issue
-     *
-     * @param issueNumber - Issue number
-     * @param comment - Comment body
-     * @param origin - Item origin
-     * @returns Wrapped operation result
-     */
-    addComment(issueNumber: number, comment: string, origin?: 'internal' | 'external'): Promise<WrappedOperationResult<void>>;
-    /**
-     * Add labels to a GitHub issue
-     *
-     * @param issueNumber - Issue number
-     * @param labels - Labels to add
-     * @returns Wrapped operation result
-     */
-    addLabels(issueNumber: number, labels: string[]): Promise<WrappedOperationResult<void>>;
-    /**
-     * Get a GitHub issue (read-only, always allowed)
-     *
-     * @param issueNumber - Issue number
-     * @returns Wrapped operation result
-     */
-    getIssue(issueNumber: number): Promise<WrappedOperationResult<GitHubIssue | null>>;
-    /**
-     * Search for an issue by title (read-only, always allowed)
-     *
-     * @param title - Title to search for
-     * @returns Wrapped operation result
-     */
-    searchIssueByTitle(title: string): Promise<WrappedOperationResult<GitHubIssue | null>>;
-    /**
-     * Check if an operation would be allowed (pre-flight check)
-     *
-     * @param operation - Operation type
-     * @param itemId - Item ID
-     * @returns true if operation would be allowed
-     */
-    wouldAllow(operation: 'upsert-internal' | 'upsert-external' | 'update-status' | 'read', itemId: string): boolean;
-    /**
-     * Get the underlying client for operations that don't need interception
-     * (e.g., already-checked operations in bulk workflows)
-     */
-    getClient(): GitHubClientV2;
-    /**
-     * Convert interceptor result to wrapped result
-     */
-    private toWrappedResult;
-}
-/**
- * Factory function to create GitHubSyncWrapper
- *
- * @param owner - Repository owner
- * @param repo - Repository name
- * @param interceptor - Sync interceptor
- * @param logger - Optional logger
- */
-export declare function createGitHubSyncWrapper(owner: string, repo: string, interceptor: SyncInterceptor, logger?: Logger): GitHubSyncWrapper;
-//# sourceMappingURL=github-sync-wrapper.d.ts.map

package/dist/src/sync/github-sync-wrapper.d.ts.map

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

package/dist/src/sync/github-sync-wrapper.js

@@ -1,220 +0,0 @@
-/**
- * GitHub Sync Wrapper
- *
- * Wraps GitHub sync operations with the SyncInterceptor for permission checks
- * and audit logging. This provides a consistent interface for all GitHub sync
- * operations while ensuring they go through the permission enforcement layer.
- *
- * Usage:
- * ```typescript
- * const wrapper = new GitHubSyncWrapper({
- *   client: GitHubClientV2.fromRepo(owner, repo),
- *   interceptor,
- *   logger
- * });
- *
- * // All operations now go through permission enforcement
- * const issue = await wrapper.createUserStoryIssue(params);
- * ```
- *
- * @module sync/github-sync-wrapper
- */
-import { GitHubClientV2 } from '../../plugins/specweave/lib/integrations/github/github-client-v2.js';
-import { consoleLogger } from '../utils/logger.js';
-/**
- * GitHubSyncWrapper - Permission-enforced GitHub sync operations
- *
- * All GitHub sync operations pass through the SyncInterceptor which:
- * 1. Checks permissions before execution
- * 2. Logs all attempts (success, denied, error)
- * 3. Provides consistent error handling
- *
- * This wrapper does NOT modify the underlying GitHubClientV2 - it provides
- * a parallel interface that can be used when permission checking is needed.
- */
-export class GitHubSyncWrapper {
-    constructor(options) {
-        this.client = options.client;
-        this.interceptor = options.interceptor;
-        this.logger = options.logger ?? consoleLogger;
-    }
-    /**
-     * Create a GitHub issue for a user story
-     *
-     * @param params - Issue creation parameters
-     * @returns Wrapped operation result
-     */
-    async createUserStoryIssue(params) {
-        const itemId = `${params.featureId}/${params.userStoryId}`;
-        const result = await this.interceptor.intercept('github', 'upsert-internal', itemId, 'internal', () => this.client.createUserStoryIssue({
-            featureId: params.featureId,
-            userStoryId: params.userStoryId,
-            title: params.title,
-            body: params.body,
-            labels: params.labels || [],
-            milestone: params.milestone ?? undefined,
-        }));
-        return this.toWrappedResult(result);
-    }
-    /**
-     * Create a generic epic/increment issue
-     *
-     * @param title - Issue title
-     * @param body - Issue body
-     * @param milestone - Optional milestone number or string
-     * @param labels - Issue labels
-     * @returns Wrapped operation result
-     */
-    async createEpicIssue(title, body, milestone, labels = []) {
-        // Extract item ID from title if possible
-        const match = title.match(/\[([^\]]+)\]/);
-        const itemId = match ? match[1] : 'unknown';
-        const result = await this.interceptor.intercept('github', 'upsert-internal', itemId, 'internal', () => this.client.createEpicIssue(title, body, milestone, labels));
-        return this.toWrappedResult(result);
-    }
-    /**
-     * Update a GitHub issue body
-     *
-     * @param issueNumber - Issue number
-     * @param body - New issue body
-     * @param origin - Item origin (internal or external)
-     * @returns Wrapped operation result
-     */
-    async updateIssueBody(issueNumber, body, origin = 'internal') {
-        const itemId = `issue-${issueNumber}`;
-        const operation = origin === 'external' ? 'upsert-external' : 'upsert-internal';
-        const result = await this.interceptor.intercept('github', operation, itemId, origin, () => this.client.updateIssueBody(issueNumber, body));
-        return this.toWrappedResult(result);
-    }
-    /**
-     * Close a GitHub issue
-     *
-     * @param issueNumber - Issue number
-     * @param comment - Optional closing comment
-     * @returns Wrapped operation result
-     */
-    async closeIssue(issueNumber, comment) {
-        const itemId = `issue-${issueNumber}`;
-        const result = await this.interceptor.interceptStatusUpdate('github', itemId, () => this.client.closeIssue(issueNumber, comment));
-        return this.toWrappedResult(result);
-    }
-    /**
-     * Reopen a GitHub issue
-     *
-     * @param issueNumber - Issue number
-     * @param comment - Optional reopening comment
-     * @returns Wrapped operation result
-     */
-    async reopenIssue(issueNumber, comment) {
-        const itemId = `issue-${issueNumber}`;
-        const result = await this.interceptor.interceptStatusUpdate('github', itemId, () => this.client.reopenIssue(issueNumber, comment));
-        return this.toWrappedResult(result);
-    }
-    /**
-     * Add a comment to a GitHub issue
-     *
-     * @param issueNumber - Issue number
-     * @param comment - Comment body
-     * @param origin - Item origin
-     * @returns Wrapped operation result
-     */
-    async addComment(issueNumber, comment, origin = 'internal') {
-        const itemId = `issue-${issueNumber}`;
-        const operation = origin === 'external' ? 'upsert-external' : 'upsert-internal';
-        const result = await this.interceptor.intercept('github', operation, itemId, origin, () => this.client.addComment(issueNumber, comment));
-        return this.toWrappedResult(result);
-    }
-    /**
-     * Add labels to a GitHub issue
-     *
-     * @param issueNumber - Issue number
-     * @param labels - Labels to add
-     * @returns Wrapped operation result
-     */
-    async addLabels(issueNumber, labels) {
-        const itemId = `issue-${issueNumber}`;
-        const result = await this.interceptor.interceptUpsert('github', itemId, () => this.client.addLabels(issueNumber, labels));
-        return this.toWrappedResult(result);
-    }
-    /**
-     * Get a GitHub issue (read-only, always allowed)
-     *
-     * @param issueNumber - Issue number
-     * @returns Wrapped operation result
-     */
-    async getIssue(issueNumber) {
-        const itemId = `issue-${issueNumber}`;
-        const result = await this.interceptor.interceptRead('github', itemId, () => this.client.getIssue(issueNumber));
-        return this.toWrappedResult(result);
-    }
-    /**
-     * Search for an issue by title (read-only, always allowed)
-     *
-     * @param title - Title to search for
-     * @returns Wrapped operation result
-     */
-    async searchIssueByTitle(title) {
-        const result = await this.interceptor.interceptRead('github', `search:${title}`, () => this.client.searchIssueByTitle(title));
-        return this.toWrappedResult(result);
-    }
-    /**
-     * Check if an operation would be allowed (pre-flight check)
-     *
-     * @param operation - Operation type
-     * @param itemId - Item ID
-     * @returns true if operation would be allowed
-     */
-    wouldAllow(operation, itemId) {
-        return this.interceptor.wouldAllow('github', operation, itemId);
-    }
-    /**
-     * Get the underlying client for operations that don't need interception
-     * (e.g., already-checked operations in bulk workflows)
-     */
-    getClient() {
-        return this.client;
-    }
-    /**
-     * Convert interceptor result to wrapped result
-     */
-    toWrappedResult(result) {
-        if (!result.allowed) {
-            return {
-                success: false,
-                result: null,
-                denialReason: result.permission.reason,
-                durationMs: result.durationMs,
-            };
-        }
-        if (result.error) {
-            return {
-                success: false,
-                result: null,
-                error: result.error.message,
-                durationMs: result.durationMs,
-            };
-        }
-        return {
-            success: true,
-            result: result.result,
-            durationMs: result.durationMs,
-        };
-    }
-}
-/**
- * Factory function to create GitHubSyncWrapper
- *
- * @param owner - Repository owner
- * @param repo - Repository name
- * @param interceptor - Sync interceptor
- * @param logger - Optional logger
- */
-export function createGitHubSyncWrapper(owner, repo, interceptor, logger) {
-    const client = GitHubClientV2.fromRepo(owner, repo);
-    return new GitHubSyncWrapper({
-        client,
-        interceptor,
-        logger,
-    });
-}
-//# sourceMappingURL=github-sync-wrapper.js.map

package/dist/src/sync/github-sync-wrapper.js.map

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

package/dist/src/sync/hierarchy.d.ts

@@ -1,52 +0,0 @@
-/**
- * Hierarchy Mapping & Auto-Detection
- *
- * ADR-0237: Flexible hierarchy that collapses gracefully.
- * Core principle: User Story and Task are FIXED; container levels are FLEXIBLE.
- *
- * Collapsing rules:
- * - Flat (Tasks only) → Task = User Story
- * - Standard (Epic/Story/Sub-task) → Epic=Feature, Story=US, Sub-task=Task
- * - SAFe (5 levels) → Top 2 skip/container, Feature→Feature, Story→US
- */
-export type HierarchyPattern = 'flat' | 'standard' | 'safe' | 'custom';
-export type SpecweaveType = 'feature' | 'user-story' | 'task' | 'skip';
-export interface CollapsingRule {
-    externalType: string;
-    specweaveType: SpecweaveType;
-}
-export interface ExternalItem {
-    id: string;
-    type: string;
-    title: string;
-    description: string;
-    parent?: string;
-}
-export interface MappedItem {
-    id: string;
-    type: string;
-    title: string;
-    description: string;
-    parent?: string;
-    specweaveType: SpecweaveType;
-    acceptanceCriteria?: string[];
-}
-/**
- * Map external items to SpecWeave hierarchy using collapsing rules.
- */
-export declare function mapHierarchy(items: ExternalItem[], pattern: HierarchyPattern, customRules?: CollapsingRule[]): MappedItem[];
-/**
- * Look up the SpecWeave type for an external type using collapsing rules.
- */
-export declare function collapseHierarchy(externalType: string, rules: CollapsingRule[]): SpecweaveType | undefined;
-/**
- * Extract acceptance criteria from a task description.
- *
- * Supported patterns:
- * 1. Markdown checklists: `- [ ] item` or `- [x] item`
- * 2. Numbered lists: `1. item`
- * 3. Bullet points: `- item`
- * 4. Fallback: single default AC
- */
-export declare function extractAcceptanceCriteria(description: string): string[];
-//# sourceMappingURL=hierarchy.d.ts.map

package/dist/src/sync/hierarchy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hierarchy.d.ts","sourceRoot":"","sources":["../../../src/sync/hierarchy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;AACvE,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,aAAa,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAsCD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,EAAE,gBAAgB,EACzB,WAAW,CAAC,EAAE,cAAc,EAAE,GAC7B,UAAU,EAAE,CAkBd;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,cAAc,EAAE,GACtB,aAAa,GAAG,SAAS,CAG3B;AAMD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAyBvE"}

package/dist/src/sync/hierarchy.js

@@ -1,101 +0,0 @@
-/**
- * Hierarchy Mapping & Auto-Detection
- *
- * ADR-0237: Flexible hierarchy that collapses gracefully.
- * Core principle: User Story and Task are FIXED; container levels are FLEXIBLE.
- *
- * Collapsing rules:
- * - Flat (Tasks only) → Task = User Story
- * - Standard (Epic/Story/Sub-task) → Epic=Feature, Story=US, Sub-task=Task
- * - SAFe (5 levels) → Top 2 skip/container, Feature→Feature, Story→US
- */
-// ---------------------------------------------------------------------------
-// Predefined collapsing rules per pattern
-// ---------------------------------------------------------------------------
-const FLAT_RULES = [
-    { externalType: 'Task', specweaveType: 'user-story' },
-];
-const STANDARD_RULES = [
-    { externalType: 'Epic', specweaveType: 'feature' },
-    { externalType: 'Story', specweaveType: 'user-story' },
-    { externalType: 'Sub-task', specweaveType: 'task' },
-    { externalType: 'Task', specweaveType: 'task' },
-];
-const SAFE_RULES = [
-    { externalType: 'Initiative', specweaveType: 'skip' },
-    { externalType: 'Theme', specweaveType: 'skip' },
-    { externalType: 'Epic', specweaveType: 'feature' },
-    { externalType: 'Feature', specweaveType: 'feature' },
-    { externalType: 'Story', specweaveType: 'user-story' },
-    { externalType: 'Task', specweaveType: 'task' },
-    { externalType: 'Sub-task', specweaveType: 'task' },
-];
-const PATTERN_RULES = {
-    flat: FLAT_RULES,
-    standard: STANDARD_RULES,
-    safe: SAFE_RULES,
-    custom: [], // user-provided
-};
-// ---------------------------------------------------------------------------
-// Hierarchy mapping
-// ---------------------------------------------------------------------------
-/**
- * Map external items to SpecWeave hierarchy using collapsing rules.
- */
-export function mapHierarchy(items, pattern, customRules) {
-    const rules = pattern === 'custom' && customRules ? customRules : PATTERN_RULES[pattern];
-    return items.map(item => {
-        const specweaveType = collapseHierarchy(item.type, rules) || 'user-story';
-        const mapped = {
-            ...item,
-            specweaveType,
-        };
-        // Auto-extract ACs for flat tasks mapped to user stories
-        if (specweaveType === 'user-story' && item.description) {
-            mapped.acceptanceCriteria = extractAcceptanceCriteria(item.description);
-        }
-        return mapped;
-    });
-}
-/**
- * Look up the SpecWeave type for an external type using collapsing rules.
- */
-export function collapseHierarchy(externalType, rules) {
-    const rule = rules.find(r => r.externalType.toLowerCase() === externalType.toLowerCase());
-    return rule?.specweaveType;
-}
-// ---------------------------------------------------------------------------
-// AC Auto-Extraction
-// ---------------------------------------------------------------------------
-/**
- * Extract acceptance criteria from a task description.
- *
- * Supported patterns:
- * 1. Markdown checklists: `- [ ] item` or `- [x] item`
- * 2. Numbered lists: `1. item`
- * 3. Bullet points: `- item`
- * 4. Fallback: single default AC
- */
-export function extractAcceptanceCriteria(description) {
-    if (!description || !description.trim()) {
-        return ['Task completed as described'];
-    }
-    // Try checklists first: - [ ] item or - [x] item
-    const checklistItems = description.match(/^[-*]\s*\[[ xX]\]\s*(.+)$/gm);
-    if (checklistItems && checklistItems.length > 0) {
-        return checklistItems.map(line => line.replace(/^[-*]\s*\[[ xX]\]\s*/, '').trim());
-    }
-    // Try numbered lists: 1. item
-    const numberedItems = description.match(/^\d+\.\s+(.+)$/gm);
-    if (numberedItems && numberedItems.length > 0) {
-        return numberedItems.map(line => line.replace(/^\d+\.\s+/, '').trim());
-    }
-    // Try bullet points: - item (but not checklists)
-    const bulletItems = description.match(/^[-*]\s+(?!\[[ xX]\])(.+)$/gm);
-    if (bulletItems && bulletItems.length > 0) {
-        return bulletItems.map(line => line.replace(/^[-*]\s+/, '').trim());
-    }
-    // Fallback
-    return ['Task completed as described'];
-}
-//# sourceMappingURL=hierarchy.js.map

package/dist/src/sync/hierarchy.js.map

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