specweave 0.28.67 → 0.29.0

package/dist/src/core/sync/sync-interceptor.d.ts

@@ -0,0 +1,190 @@
+/**
+ * Sync Interceptor
+ *
+ * Central control point for all sync operations. Wraps sync operations with
+ * permission checks and audit logging. Implements the interceptor pattern to
+ * ensure consistent enforcement across all platforms (GitHub, JIRA, ADO).
+ *
+ * Pattern:
+ *   Request → Interceptor → Permission Check → Execute/Deny → Log → Response
+ *
+ * @module core/sync/sync-interceptor
+ */
+import { PermissionEnforcer, SyncOperation, ItemOrigin, PermissionResult } from './permission-enforcer.js';
+import { SyncAuditLogger } from './sync-audit-logger.js';
+import { SyncPlatform } from '../types/sync-config.js';
+import { Logger } from '../../utils/logger.js';
+/**
+ * Interceptor result - wraps the operation result with metadata
+ */
+export interface InterceptorResult<T> {
+    /**
+     * Whether the operation was allowed
+     */
+    allowed: boolean;
+    /**
+     * The result of the operation (null if denied or error)
+     */
+    result: T | null;
+    /**
+     * Permission check result
+     */
+    permission: PermissionResult;
+    /**
+     * Duration of the operation in milliseconds
+     */
+    durationMs: number;
+    /**
+     * Error if operation failed
+     */
+    error?: Error;
+}
+/**
+ * Sync interceptor options
+ */
+export interface SyncInterceptorOptions {
+    /**
+     * Permission enforcer instance
+     */
+    permissionEnforcer: PermissionEnforcer;
+    /**
+     * Audit logger instance
+     */
+    auditLogger: SyncAuditLogger;
+    /**
+     * Logger instance
+     */
+    logger?: Logger;
+    /**
+     * Enable strict mode - throw on permission denial instead of returning null
+     * @default false
+     */
+    strictMode?: boolean;
+}
+/**
+ * Permission denied error
+ */
+export declare class PermissionDeniedError extends Error {
+    readonly permission: PermissionResult;
+    readonly platform: SyncPlatform;
+    readonly operation: SyncOperation;
+    constructor(permission: PermissionResult, platform: SyncPlatform, operation: SyncOperation);
+}
+/**
+ * SyncInterceptor - Central control point for sync operations
+ *
+ * All sync operations must pass through this interceptor to ensure:
+ * 1. Permissions are checked before execution
+ * 2. All attempts are logged (success, denied, error)
+ * 3. Consistent behavior across all platforms
+ *
+ * Usage:
+ * ```typescript
+ * const result = await interceptor.intercept(
+ *   'github',
+ *   'upsert-internal',
+ *   'FS-001',
+ *   'internal',
+ *   () => this.githubClient.createIssue(item)
+ * );
+ *
+ * if (result.allowed) {
+ *   return result.result;
+ * } else {
+ *   console.log(`Denied: ${result.permission.reason}`);
+ * }
+ * ```
+ */
+export declare class SyncInterceptor {
+    private readonly permissionEnforcer;
+    private readonly auditLogger;
+    private readonly logger;
+    private readonly strictMode;
+    constructor(options: SyncInterceptorOptions);
+    /**
+     * Intercept a sync operation
+     *
+     * Checks permissions, executes if allowed, logs the result.
+     *
+     * @param platform - Target platform (github, jira, ado)
+     * @param operation - Operation type (read, update-status, upsert-internal, upsert-external)
+     * @param itemId - Item ID being operated on
+     * @param origin - Item origin (internal or external)
+     * @param execute - Function to execute if permitted
+     * @returns Interceptor result with operation outcome
+     */
+    intercept<T>(platform: SyncPlatform, operation: SyncOperation, itemId: string, origin: ItemOrigin, execute: () => Promise<T>): Promise<InterceptorResult<T>>;
+    /**
+     * Intercept with automatic origin detection
+     *
+     * Convenience method that auto-detects item origin from itemId.
+     * External items end with 'E' or contain '-E-'.
+     *
+     * @param platform - Target platform
+     * @param operation - Operation type
+     * @param itemId - Item ID (origin auto-detected)
+     * @param execute - Function to execute
+     */
+    interceptAuto<T>(platform: SyncPlatform, operation: SyncOperation, itemId: string, execute: () => Promise<T>): Promise<InterceptorResult<T>>;
+    /**
+     * Intercept a read operation (always allowed)
+     *
+     * Convenience method for read operations. Still logs for audit.
+     *
+     * @param platform - Target platform
+     * @param itemId - Item ID
+     * @param execute - Function to execute
+     */
+    interceptRead<T>(platform: SyncPlatform, itemId: string, execute: () => Promise<T>): Promise<InterceptorResult<T>>;
+    /**
+     * Intercept a status update operation
+     *
+     * @param platform - Target platform
+     * @param itemId - Item ID
+     * @param execute - Function to execute
+     */
+    interceptStatusUpdate<T>(platform: SyncPlatform, itemId: string, execute: () => Promise<T>): Promise<InterceptorResult<T>>;
+    /**
+     * Intercept an upsert operation
+     *
+     * Automatically determines operation type based on item origin.
+     *
+     * @param platform - Target platform
+     * @param itemId - Item ID
+     * @param execute - Function to execute
+     */
+    interceptUpsert<T>(platform: SyncPlatform, itemId: string, execute: () => Promise<T>): Promise<InterceptorResult<T>>;
+    /**
+     * Check if an operation would be allowed (without executing)
+     *
+     * Useful for pre-flight checks before expensive operations.
+     *
+     * @param platform - Target platform
+     * @param operation - Operation type
+     * @param itemId - Item ID
+     * @returns true if operation would be allowed
+     */
+    wouldAllow(platform: SyncPlatform, operation: SyncOperation, itemId: string): boolean;
+    /**
+     * Get permission summary for a platform
+     *
+     * @param platform - Target platform
+     * @returns Human-readable summary
+     */
+    getPermissionsSummary(): string;
+    /**
+     * Detect item origin from ID
+     *
+     * External items end with 'E' or contain '-E-'.
+     */
+    private detectOrigin;
+}
+/**
+ * Create a SyncInterceptor with default configuration
+ *
+ * @param permissionEnforcer - Permission enforcer instance
+ * @param specweavePath - Path to .specweave directory
+ * @param logger - Optional logger
+ */
+export declare function createSyncInterceptor(permissionEnforcer: PermissionEnforcer, specweavePath: string, logger?: Logger): Promise<SyncInterceptor>;
+//# sourceMappingURL=sync-interceptor.d.ts.map

package/dist/src/core/sync/sync-interceptor.d.ts.map

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

package/dist/src/core/sync/sync-interceptor.js

@@ -0,0 +1,224 @@
+/**
+ * Sync Interceptor
+ *
+ * Central control point for all sync operations. Wraps sync operations with
+ * permission checks and audit logging. Implements the interceptor pattern to
+ * ensure consistent enforcement across all platforms (GitHub, JIRA, ADO).
+ *
+ * Pattern:
+ *   Request → Interceptor → Permission Check → Execute/Deny → Log → Response
+ *
+ * @module core/sync/sync-interceptor
+ */
+import { consoleLogger } from '../../utils/logger.js';
+/**
+ * Permission denied error
+ */
+export class PermissionDeniedError extends Error {
+    constructor(permission, platform, operation) {
+        super(`Permission denied: ${permission.reason}`);
+        this.permission = permission;
+        this.platform = platform;
+        this.operation = operation;
+        this.name = 'PermissionDeniedError';
+    }
+}
+/**
+ * SyncInterceptor - Central control point for sync operations
+ *
+ * All sync operations must pass through this interceptor to ensure:
+ * 1. Permissions are checked before execution
+ * 2. All attempts are logged (success, denied, error)
+ * 3. Consistent behavior across all platforms
+ *
+ * Usage:
+ * ```typescript
+ * const result = await interceptor.intercept(
+ *   'github',
+ *   'upsert-internal',
+ *   'FS-001',
+ *   'internal',
+ *   () => this.githubClient.createIssue(item)
+ * );
+ *
+ * if (result.allowed) {
+ *   return result.result;
+ * } else {
+ *   console.log(`Denied: ${result.permission.reason}`);
+ * }
+ * ```
+ */
+export class SyncInterceptor {
+    constructor(options) {
+        this.permissionEnforcer = options.permissionEnforcer;
+        this.auditLogger = options.auditLogger;
+        this.logger = options.logger ?? consoleLogger;
+        this.strictMode = options.strictMode ?? false;
+    }
+    /**
+     * Intercept a sync operation
+     *
+     * Checks permissions, executes if allowed, logs the result.
+     *
+     * @param platform - Target platform (github, jira, ado)
+     * @param operation - Operation type (read, update-status, upsert-internal, upsert-external)
+     * @param itemId - Item ID being operated on
+     * @param origin - Item origin (internal or external)
+     * @param execute - Function to execute if permitted
+     * @returns Interceptor result with operation outcome
+     */
+    async intercept(platform, operation, itemId, origin, execute) {
+        const startTime = Date.now();
+        // Check permission
+        const permission = await this.permissionEnforcer.checkAndLog(platform, operation, itemId, origin);
+        // Handle denial
+        if (!permission.allowed) {
+            const durationMs = Date.now() - startTime;
+            await this.auditLogger.logDenied(platform, operation, itemId, permission.reason);
+            this.logger.debug(`[SyncInterceptor] Denied: ${platform}/${operation} for ${itemId} - ${permission.reason}`);
+            // Strict mode throws instead of returning
+            if (this.strictMode) {
+                throw new PermissionDeniedError(permission, platform, operation);
+            }
+            return {
+                allowed: false,
+                result: null,
+                permission,
+                durationMs,
+            };
+        }
+        // Execute the operation
+        try {
+            const result = await execute();
+            const durationMs = Date.now() - startTime;
+            await this.auditLogger.logSuccess(platform, operation, itemId, durationMs);
+            this.logger.debug(`[SyncInterceptor] Success: ${platform}/${operation} for ${itemId} (${durationMs}ms)`);
+            return {
+                allowed: true,
+                result,
+                permission,
+                durationMs,
+            };
+        }
+        catch (error) {
+            const durationMs = Date.now() - startTime;
+            const err = error instanceof Error ? error : new Error(String(error));
+            await this.auditLogger.logError(platform, operation, itemId, err);
+            this.logger.debug(`[SyncInterceptor] Error: ${platform}/${operation} for ${itemId} - ${err.message}`);
+            return {
+                allowed: true, // Was allowed, but failed
+                result: null,
+                permission,
+                durationMs,
+                error: err,
+            };
+        }
+    }
+    /**
+     * Intercept with automatic origin detection
+     *
+     * Convenience method that auto-detects item origin from itemId.
+     * External items end with 'E' or contain '-E-'.
+     *
+     * @param platform - Target platform
+     * @param operation - Operation type
+     * @param itemId - Item ID (origin auto-detected)
+     * @param execute - Function to execute
+     */
+    async interceptAuto(platform, operation, itemId, execute) {
+        const origin = this.detectOrigin(itemId);
+        return this.intercept(platform, operation, itemId, origin, execute);
+    }
+    /**
+     * Intercept a read operation (always allowed)
+     *
+     * Convenience method for read operations. Still logs for audit.
+     *
+     * @param platform - Target platform
+     * @param itemId - Item ID
+     * @param execute - Function to execute
+     */
+    async interceptRead(platform, itemId, execute) {
+        return this.intercept(platform, 'read', itemId, 'internal', execute);
+    }
+    /**
+     * Intercept a status update operation
+     *
+     * @param platform - Target platform
+     * @param itemId - Item ID
+     * @param execute - Function to execute
+     */
+    async interceptStatusUpdate(platform, itemId, execute) {
+        const origin = this.detectOrigin(itemId);
+        return this.intercept(platform, 'update-status', itemId, origin, execute);
+    }
+    /**
+     * Intercept an upsert operation
+     *
+     * Automatically determines operation type based on item origin.
+     *
+     * @param platform - Target platform
+     * @param itemId - Item ID
+     * @param execute - Function to execute
+     */
+    async interceptUpsert(platform, itemId, execute) {
+        const origin = this.detectOrigin(itemId);
+        const operation = origin === 'external' ? 'upsert-external' : 'upsert-internal';
+        return this.intercept(platform, operation, itemId, origin, execute);
+    }
+    /**
+     * Check if an operation would be allowed (without executing)
+     *
+     * Useful for pre-flight checks before expensive operations.
+     *
+     * @param platform - Target platform
+     * @param operation - Operation type
+     * @param itemId - Item ID
+     * @returns true if operation would be allowed
+     */
+    wouldAllow(platform, operation, itemId) {
+        const origin = this.detectOrigin(itemId);
+        const permission = this.permissionEnforcer.checkPermission(platform, operation, itemId, origin);
+        return permission.allowed;
+    }
+    /**
+     * Get permission summary for a platform
+     *
+     * @param platform - Target platform
+     * @returns Human-readable summary
+     */
+    getPermissionsSummary() {
+        return this.permissionEnforcer.getPermissionsSummary().summary;
+    }
+    /**
+     * Detect item origin from ID
+     *
+     * External items end with 'E' or contain '-E-'.
+     */
+    detectOrigin(itemId) {
+        if (itemId.endsWith('E') || itemId.includes('-E-')) {
+            return 'external';
+        }
+        return 'internal';
+    }
+}
+/**
+ * Create a SyncInterceptor with default configuration
+ *
+ * @param permissionEnforcer - Permission enforcer instance
+ * @param specweavePath - Path to .specweave directory
+ * @param logger - Optional logger
+ */
+export async function createSyncInterceptor(permissionEnforcer, specweavePath, logger) {
+    const { SyncAuditLogger: AuditLoggerClass } = await import('./sync-audit-logger.js');
+    const auditLogger = new AuditLoggerClass({
+        specweavePath,
+        logger,
+    });
+    return new SyncInterceptor({
+        permissionEnforcer,
+        auditLogger,
+        logger,
+    });
+}
+//# sourceMappingURL=sync-interceptor.js.map

package/dist/src/core/sync/sync-interceptor.js.map

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

package/dist/src/core/types/increment-metadata.d.ts

@@ -247,6 +247,11 @@ export interface ExternalContainerContext {
 }
 /**
  * Extended increment metadata with multi-project support (v0.29.0+)
+ *
+ * NOTE (v0.29.0): featureId field was REMOVED
+ * Feature ID is derived from increment number: 0081 → FS-081
+ * Use deriveFeatureId() from src/utils/feature-id-derivation.ts
+ * See ADR-0140 for rationale
  */
 export interface IncrementMetadataV2 extends IncrementMetadata {
     /** Single project ID (backward compatible) */
@@ -255,8 +260,6 @@ export interface IncrementMetadataV2 extends IncrementMetadata {
     multiProject?: MultiProjectUserStory;
     /** External container context for 2-level directory structure */
     externalContainer?: ExternalContainerContext;
-    /** Feature ID this increment belongs to */
-    featureId?: string;
     /** Epic ID if part of an epic */
     epicId?: string;
 }

package/dist/src/core/types/increment-metadata.d.ts.map

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