@arimakouyou/spec-workflow-mcp 2.2.7

package/dist/dashboard/approval-storage.d.ts

@@ -0,0 +1,139 @@
+import { EventEmitter } from 'events';
+export interface ApprovalComment {
+    type: 'selection' | 'general';
+    selectedText?: string;
+    comment: string;
+    timestamp: string;
+    lineNumber?: number;
+    characterPosition?: number;
+    highlightColor?: string;
+}
+export interface DocumentSnapshot {
+    id: string;
+    approvalId: string;
+    approvalTitle: string;
+    version: number;
+    timestamp: string;
+    trigger: 'initial' | 'revision_requested' | 'approved' | 'manual';
+    status: 'pending' | 'approved' | 'rejected' | 'needs-revision';
+    content: string;
+    fileStats: {
+        size: number;
+        lines: number;
+        lastModified: string;
+    };
+    comments?: ApprovalComment[];
+    annotations?: string;
+}
+export interface SnapshotMetadata {
+    approvalId: string;
+    currentVersion: number;
+    snapshots: {
+        version: number;
+        filename: string;
+        timestamp: string;
+        trigger: string;
+    }[];
+}
+export interface FileSnapshotMetadata {
+    filePath: string;
+    currentVersion: number;
+    snapshots: {
+        version: number;
+        filename: string;
+        timestamp: string;
+        trigger: string;
+        approvalId: string;
+        approvalTitle: string;
+    }[];
+}
+export interface DiffResult {
+    additions: number;
+    deletions: number;
+    changes: number;
+    chunks: DiffChunk[];
+}
+export interface DiffChunk {
+    oldStart: number;
+    oldLines: number;
+    newStart: number;
+    newLines: number;
+    lines: DiffLine[];
+}
+export interface DiffLine {
+    type: 'add' | 'delete' | 'normal';
+    oldLineNumber?: number;
+    newLineNumber?: number;
+    content: string;
+}
+export interface ApprovalRequest {
+    id: string;
+    title: string;
+    filePath: string;
+    type: 'document' | 'action';
+    status: 'pending' | 'approved' | 'rejected' | 'needs-revision';
+    createdAt: string;
+    respondedAt?: string;
+    response?: string;
+    annotations?: string;
+    comments?: ApprovalComment[];
+    revisionHistory?: {
+        version: number;
+        content: string;
+        timestamp: string;
+        reason?: string;
+    }[];
+    metadata?: Record<string, any>;
+    category: 'spec' | 'steering';
+    categoryName: string;
+}
+export declare class ApprovalStorage extends EventEmitter {
+    projectPath: string;
+    originalProjectPath: string;
+    fileResolutionPath: string;
+    private approvalsDir;
+    private watcher?;
+    private pendingEmit;
+    private readonly DEBOUNCE_MS;
+    constructor(translatedPath: string, options?: {
+        originalPath?: string;
+        fileResolutionPath?: string;
+    });
+    start(): Promise<void>;
+    /**
+     * Schedule a debounced approval-change event emission
+     * Coalesces rapid changes to prevent event flooding
+     */
+    private scheduleApprovalChangeEmit;
+    stop(): Promise<void>;
+    /**
+     * Candidate resolution order for relative approval file paths:
+     * 1) Workspace/worktree base (fileResolutionPath)
+     * 2) Shared workflow root (projectPath)
+     */
+    private getFilePathCandidates;
+    private resolveExistingFilePath;
+    private resolveFilePathForWrite;
+    createApproval(title: string, filePath: string, category: 'spec' | 'steering', categoryName: string, type?: 'document' | 'action', metadata?: Record<string, any>): Promise<string>;
+    getApproval(id: string): Promise<ApprovalRequest | null>;
+    private findApprovalPath;
+    updateApproval(id: string, status: 'approved' | 'rejected' | 'needs-revision', response: string, annotations?: string, comments?: ApprovalComment[]): Promise<void>;
+    /**
+     * Revert an approval back to pending status, clearing response and timestamp
+     * Used for undo operations after batch approvals/rejections
+     */
+    revertToPending(id: string): Promise<void>;
+    createRevision(originalId: string, newContent: string, reason?: string): Promise<string>;
+    getAllPendingApprovals(): Promise<ApprovalRequest[]>;
+    getAllApprovals(): Promise<ApprovalRequest[]>;
+    deleteApproval(id: string): Promise<boolean>;
+    cleanupOldApprovals(maxAgeDays?: number): Promise<void>;
+    captureSnapshot(approvalId: string, trigger: 'initial' | 'revision_requested' | 'approved' | 'manual'): Promise<void>;
+    getSnapshots(approvalId: string): Promise<DocumentSnapshot[]>;
+    getSnapshot(approvalId: string, version: number): Promise<DocumentSnapshot | null>;
+    getCurrentFileContent(approvalId: string): Promise<string | null>;
+    compareSnapshots(approvalId: string, fromVersion: number, toVersion: number | 'current'): Promise<DiffResult>;
+    private generateSnapshotId;
+    private generateId;
+}
+//# sourceMappingURL=approval-storage.d.ts.map

package/dist/dashboard/approval-storage.d.ts.map

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