sqlew 4.3.0 → 5.0.0

package/dist/types.d.ts

@@ -40,15 +40,6 @@ export declare enum Priority {
     HIGH = 3,
     CRITICAL = 4
 }
-/**
- * File change type enumeration
- * 1 = created, 2 = modified, 3 = deleted
- */
-export declare enum ChangeType {
-    CREATED = 1,
-    MODIFIED = 2,
-    DELETED = 3
-}
 /**
  * Concise validation error for MCP tool parameter validation
  * Designed for token efficiency - references examples via ID instead of embedding full objects
@@ -67,10 +58,6 @@ export interface Agent {
     readonly id: number;
     readonly name: string;
 }
-export interface File {
-    readonly id: number;
-    readonly path: string;
-}
 export interface ContextKey {
     readonly id: number;
     readonly key: string;
@@ -135,15 +122,6 @@ export interface AgentMessage {
     readonly ts: number;
     readonly read: number;
 }
-export interface FileChange {
-    readonly id: number;
-    readonly file_id: number;
-    readonly agent_id: number;
-    readonly layer_id: number | null;
-    readonly change_type: ChangeType;
-    readonly description: string | null;
-    readonly ts: number;
-}
 export interface Constraint {
     readonly id: number;
     readonly category_id: number;
@@ -198,7 +176,6 @@ export interface ActiveContext {
 export interface LayerSummary {
     readonly layer: string;
     readonly decisions_count: number;
-    readonly file_changes_count: number;
     readonly constraints_count: number;
 }
 export interface UnreadMessagesByPriority {
@@ -206,16 +183,8 @@ export interface UnreadMessagesByPriority {
     readonly priority: 'critical' | 'high' | 'medium' | 'low';
     readonly count: number;
 }
-export interface RecentFileChange {
-    readonly path: string;
-    readonly changed_by: string;
-    readonly layer: string | null;
-    readonly change_type: 'created' | 'modified' | 'deleted';
-    readonly description: string | null;
-    readonly changed_at: string;
-}
 export interface TaggedConstraint {
-    readonly id: number;
+    readonly id: number | string;
     readonly category: string;
     readonly layer: string | null;
     readonly constraint_text: string;
@@ -303,43 +272,67 @@ export interface HasUpdatesParams {
     agent_name?: string;
     since_timestamp: string;
 }
-export interface SendMessageParams {
-    from_agent: string;
-    to_agent?: string | null;
-    msg_type: 'decision' | 'warning' | 'request' | 'info';
-    message: string;
-    priority?: 'low' | 'medium' | 'high' | 'critical';
-    payload?: any;
-}
-export interface GetMessagesParams {
-    agent_name: string;
-    unread_only?: boolean;
-    priority_filter?: 'low' | 'medium' | 'high' | 'critical';
-    msg_type_filter?: 'decision' | 'warning' | 'request' | 'info';
-    limit?: number;
-}
-export interface MarkReadParams {
-    message_ids: number[];
-    agent_name: string;
+/**
+ * Output format for decision/constraint export
+ */
+export type ExportFormat = 'blocks' | 'markdown' | 'adr' | 'notion' | 'confluence';
+/**
+ * Parameters for decision:export action
+ * SaaS-only feature for document generation
+ */
+export interface ExportDecisionParams {
+    tags?: string[];
+    layers?: string[];
+    since?: string;
+    status?: StatusString[];
+    group_by?: 'layer' | 'tag' | 'none';
+    format: ExportFormat;
+    include_metadata?: boolean;
+    include_context?: boolean;
 }
-export interface RecordFileChangeParams {
-    file_path: string;
-    agent_name?: string;
-    change_type: 'created' | 'modified' | 'deleted';
+/**
+ * Individual item in export blocks
+ */
+export interface ExportBlockItem {
+    key: string;
+    value: string;
     layer?: string;
-    description?: string;
+    tags?: string[];
+    version?: string;
+    updated?: string;
+    rationale?: string;
+    alternatives?: string[];
+    tradeoffs?: string;
 }
-export interface GetFileChangesParams {
-    file_path?: string;
-    agent_name?: string;
-    layer?: string;
-    change_type?: 'created' | 'modified' | 'deleted';
-    since?: string;
-    limit?: number;
+/**
+ * Section block in export response
+ */
+export interface ExportBlockSection {
+    type: 'section';
+    title: string;
+    items: ExportBlockItem[];
 }
-export interface CheckFileLockParams {
-    file_path: string;
-    lock_duration?: number;
+/**
+ * Constraint in export response
+ */
+export interface ExportBlockConstraint {
+    category: string;
+    rule: string;
+    priority: string;
+    tags?: string[];
+}
+/**
+ * Structured blocks response from SaaS
+ */
+export interface ExportBlocks {
+    metadata: {
+        exported_at: string;
+        total_decisions: number;
+        total_constraints: number;
+        filters_applied: Record<string, unknown>;
+    };
+    blocks: ExportBlockSection[];
+    constraints?: ExportBlockConstraint[];
 }
 export interface AddConstraintParams {
     category: string;
@@ -360,49 +353,12 @@ export interface GetConstraintsParams {
     limit?: number;
 }
 export interface DeactivateConstraintParams {
-    constraint_id: number;
-}
-export interface GetLayerSummaryParams {
-}
-export interface ClearOldDataParams {
-    messages_older_than_hours?: number;
-    file_changes_older_than_days?: number;
-}
-export interface GetStatsParams {
-}
-export interface GetActivityLogParams {
-    since?: string;
-    agent_names?: string[];
-    actions?: string[];
-    limit?: number;
-}
-/**
- * Acceptance check types for automated task validation
- */
-export type AcceptanceCheckType = 'tests_pass' | 'code_removed' | 'code_contains' | 'file_exists';
-/**
- * Acceptance check definition
- */
-export interface AcceptanceCheck {
-    type: AcceptanceCheckType;
-    command?: string;
-    expected_pattern?: string;
-    file?: string;
-    pattern?: string;
-    timeout?: number;
+    id: number | string;
 }
 export interface SetDecisionBatchParams {
     decisions: SetDecisionParams[];
     atomic?: boolean;
 }
-export interface SendMessageBatchParams {
-    messages: SendMessageParams[];
-    atomic?: boolean;
-}
-export interface RecordFileChangeBatchParams {
-    file_changes: RecordFileChangeParams[];
-    atomic?: boolean;
-}
 export interface SetFromTemplateParams {
     template: string;
     key: string;
@@ -469,6 +425,7 @@ export interface SetDecisionResponse {
         layer?: string;
         tags?: string[];
     }>;
+    warnings?: string[];
 }
 export interface QuickSetDecisionResponse {
     success: boolean;
@@ -481,6 +438,7 @@ export interface QuickSetDecisionResponse {
         scope?: string;
     };
     message?: string;
+    warnings?: string[];
 }
 export interface GetContextResponse {
     decisions: TaggedDecision[];
@@ -499,6 +457,7 @@ export interface GetDecisionResponse {
         related_task_id: number | null;
         related_constraint_id: number | null;
     }>;
+    warnings?: string[];
 }
 export interface HardDeleteDecisionResponse {
     success: boolean;
@@ -532,98 +491,47 @@ export interface HasUpdatesResponse {
     has_updates: boolean;
     counts: {
         decisions: number;
-        messages: number;
-        files: number;
     };
 }
-export interface SendMessageResponse {
-    success: boolean;
-    message_id: number;
-}
-export interface GetMessagesResponse {
-    messages: Array<{
-        id: number;
-        from_agent: string;
-        msg_type: string;
-        priority: string;
-        payload: any;
-        timestamp: string;
-        read: boolean;
-    }>;
-    count: number;
-}
-export interface MarkReadResponse {
-    success: boolean;
-}
-export interface RecordFileChangeResponse {
+/**
+ * Response for decision:export action
+ * SaaS-only feature for document generation (v5.0.0)
+ */
+export interface ExportDecisionResponse {
     success: boolean;
-    change_id: number;
-    timestamp: string;
-}
-export interface GetFileChangesResponse {
-    changes: RecentFileChange[];
-    count: number;
-}
-export interface CheckFileLockResponse {
-    locked: boolean;
-    last_agent?: string;
-    last_change?: string;
-    change_type?: string;
+    format: ExportFormat;
+    content: string | ExportBlocks;
+    metadata: {
+        total_decisions: number;
+        total_constraints: number;
+        exported_at: string;
+    };
+    warnings?: string[];
 }
 export interface AddConstraintResponse {
     success: boolean;
-    constraint_id: number;
+    constraint_id: number | string;
     already_exists?: boolean;
+    warnings?: string[];
 }
 export interface GetConstraintsResponse {
     constraints: TaggedConstraint[];
     count: number;
+    warnings?: string[];
 }
 export interface DeactivateConstraintResponse {
     success: boolean;
 }
-export interface GetLayerSummaryResponse {
-    summary: LayerSummary[];
-}
-export interface ClearOldDataResponse {
-    success: boolean;
-    messages_deleted: number;
-    file_changes_deleted: number;
-    activity_logs_deleted: number;
-    agents_released: number;
-}
 export interface GetStatsResponse {
     agents: number;
-    files: number;
     context_keys: number;
     active_decisions: number;
     total_decisions: number;
-    file_changes: number;
     active_constraints: number;
     total_constraints: number;
     tags: number;
     scopes: number;
     layers: number;
-    total_tasks: number;
-    active_tasks: number;
-    tasks_by_status: {
-        todo: number;
-        in_progress: number;
-        waiting_review: number;
-        blocked: number;
-        done: number;
-        archived: number;
-    };
-    tasks_by_priority: {
-        low: number;
-        medium: number;
-        high: number;
-        critical: number;
-    };
-    review_status: {
-        awaiting_commit: number;
-        overdue_review: number;
-    };
 }
 export interface FlushWALResponse {
     success: boolean;
@@ -640,10 +548,6 @@ export interface ActivityLogEntry {
     layer: string | null;
     details: any;
 }
-export interface GetActivityLogResponse {
-    activities: ActivityLogEntry[];
-    count: number;
-}
 export interface SetDecisionBatchResponse {
     success: boolean;
     inserted: number;
@@ -656,31 +560,6 @@ export interface SetDecisionBatchResponse {
         error?: string;
     }>;
 }
-export interface SendMessageBatchResponse {
-    success: boolean;
-    inserted: number;
-    failed: number;
-    results: Array<{
-        from_agent: string;
-        to_agent: string | null;
-        message_id?: number;
-        timestamp?: string;
-        success: boolean;
-        error?: string;
-    }>;
-}
-export interface RecordFileChangeBatchResponse {
-    success: boolean;
-    inserted: number;
-    failed: number;
-    results: Array<{
-        file_path: string;
-        change_id?: number;
-        timestamp?: string;
-        success: boolean;
-        error?: string;
-    }>;
-}
 export interface SetFromTemplateResponse {
     success: boolean;
     key: string;
@@ -710,21 +589,6 @@ export interface ListTemplatesResponse {
     }>;
     count: number;
 }
-/**
- * Batch validation error for batch operations (legacy)
- * @deprecated Use BatchValidationError from batch-validation.ts instead
- * Reports validation failures across multiple items
- */
-export interface LegacyBatchValidationError {
-    error: string;
-    batch_param: string;
-    item_errors: Array<{
-        index: number;
-        error: string | ValidationError;
-    }>;
-    total_items: number;
-    failed_items: number;
-}
 /**
  * Action not found error
  * Thrown when an invalid action is specified
@@ -740,17 +604,7 @@ export interface ActionNotFoundError {
  * Decision tool actions
  * Provides compile-time type checking for action parameters without breaking MCP wire protocol
  */
-export type DecisionAction = 'set' | 'get' | 'list' | 'search_tags' | 'search_layer' | 'versions' | 'quick_set' | 'search_advanced' | 'set_batch' | 'has_updates' | 'set_from_template' | 'create_template' | 'list_templates' | 'hard_delete' | 'add_decision_context' | 'list_decision_contexts' | 'create_policy' | 'list_policies' | 'set_from_policy' | 'analytics' | 'help' | 'example' | 'use_case';
-/**
- * Task tool actions
- * Provides compile-time type checking for action parameters
- */
-export type TaskAction = 'create' | 'update' | 'get' | 'list' | 'move' | 'link' | 'archive' | 'create_batch' | 'add_dependency' | 'remove_dependency' | 'get_dependencies' | 'watch_files' | 'get_pruned_files' | 'link_pruned_file' | 'watcher' | 'help' | 'example' | 'use_case';
-/**
- * File tool actions
- * Provides compile-time type checking for action parameters
- */
-export type FileAction = 'record' | 'get' | 'check_lock' | 'record_batch' | 'sqlite_flush' | 'help' | 'example' | 'use_case';
+export type DecisionAction = 'set' | 'get' | 'list' | 'search_tags' | 'search_layer' | 'versions' | 'quick_set' | 'search_advanced' | 'set_batch' | 'has_updates' | 'set_from_template' | 'create_template' | 'list_templates' | 'hard_delete' | 'add_decision_context' | 'list_decision_contexts' | 'create_policy' | 'list_policies' | 'set_from_policy' | 'analytics' | 'export' | 'help' | 'example' | 'use_case';
 /**
  * Constraint tool actions
  * Provides compile-time type checking for action parameters
@@ -766,135 +620,6 @@ export type ConfigAction = 'get' | 'update' | 'help' | 'example' | 'use_case';
  * Provides compile-time type checking for action parameters
  */
 export type ExampleAction = 'get' | 'search' | 'list_all' | 'help' | 'example';
-/**
- * Message tool actions
- * @deprecated Messaging system removed in v3.8.0. Message tool has been completely removed.
- * This type is kept only for backward compatibility with existing code references.
- */
-export type MessageAction = never;
-/**
- * Options for JSON import operation
- */
-export interface JsonImportOptions {
-    /** Optional: Target project name (if not provided, uses name from JSON) */
-    targetProjectName?: string;
-    /** Optional: Skip import if project already exists (default: true) */
-    skipIfExists?: boolean;
-    /** Optional: Dry run mode - validate only, don't import (default: false) */
-    dryRun?: boolean;
-}
-/**
- * JSON import validation result
- */
-export interface ImportValidationResult {
-    valid: boolean;
-    errors: string[];
-    warnings: string[];
-    schema_version?: number;
-    sqlew_version?: string;
-    export_mode?: 'single_project' | 'all_projects';
-}
-/**
- * ID mapping for a single master table
- * Maps old IDs (from export) to new IDs (in target database)
- */
-export interface IdMapping extends Map<number, number> {
-}
-/**
- * Complete ID mapping context for all master tables
- * Note: agents removed in v4.0 (agent system deleted)
- */
-export interface ImportIdMappings {
-    projects: IdMapping;
-    files: IdMapping;
-    context_keys: IdMapping;
-    tags: IdMapping;
-    scopes: IdMapping;
-    constraint_categories: IdMapping;
-    layers: IdMapping;
-    task_statuses: IdMapping;
-    tasks: IdMapping;
-    decision_policies: IdMapping;
-}
-/**
- * Import context - holds all state during import operation
- */
-export interface ImportContext {
-    /** Knex instance for database operations */
-    knex: any;
-    /** ID mappings for all tables */
-    mappings: ImportIdMappings;
-    /** Target project ID (created during import) */
-    projectId: number;
-    /** Source JSON data */
-    jsonData: any;
-    /** Import options */
-    options: JsonImportOptions;
-    /** Statistics (updated during import) */
-    stats: ImportStats;
-}
-/**
- * Import statistics
- * Note: agents_created, activity_log_created removed in v4.0
- */
-export interface ImportStats {
-    project_created: boolean;
-    master_tables: {
-        files_created: number;
-        files_reused: number;
-        context_keys_created: number;
-        tags_created: number;
-        tags_reused: number;
-        scopes_created: number;
-        scopes_reused: number;
-    };
-    transaction_tables: {
-        decisions_created: number;
-        decisions_numeric_created: number;
-        decision_history_created: number;
-        decision_context_created: number;
-        file_changes_created: number;
-        constraints_created: number;
-        tasks_created: number;
-        task_details_created: number;
-        decision_policies_created: number;
-        tag_index_created: number;
-    };
-    junction_tables: {
-        decision_tags_created: number;
-        decision_scopes_created: number;
-        constraint_tags_created: number;
-        task_tags_created: number;
-        task_file_links_created: number;
-        task_decision_links_created: number;
-        task_dependencies_created: number;
-    };
-}
-/**
- * Task dependency graph for topological sorting
- */
-export interface TaskDependencyGraph {
-    /** Task IDs with no dependencies (roots) */
-    roots: number[];
-    /** Map from blocker_task_id to array of blocked_task_ids */
-    children: Map<number, number[]>;
-    /** Map from blocked_task_id to array of blocker_task_ids */
-    parents: Map<number, number[]>;
-    /** All task IDs in the graph */
-    allTaskIds: Set<number>;
-}
-/**
- * JSON import result
- */
-export interface JsonImportResult {
-    success: boolean;
-    project_id?: number;
-    project_name?: string;
-    stats?: ImportStats;
-    error?: string;
-    skipped?: boolean;
-    skip_reason?: string;
-}
 /**
  * Options for JSON import operation
  */
@@ -925,18 +650,15 @@ export interface IdMapping extends Map<number, number> {
 }
 /**
  * Complete ID mapping context for all master tables
- * Note: agents removed in v4.0 (agent system deleted)
+ * Note: agents removed in v4.0, files/tasks removed in v5.0
  */
 export interface ImportIdMappings {
     projects: IdMapping;
-    files: IdMapping;
     context_keys: IdMapping;
     tags: IdMapping;
     scopes: IdMapping;
     constraint_categories: IdMapping;
     layers: IdMapping;
-    task_statuses: IdMapping;
-    tasks: IdMapping;
     decision_policies: IdMapping;
 }
 /**
@@ -959,12 +681,11 @@ export interface ImportContext {
 /**
  * Import statistics
  * Note: agents_created, activity_log_created removed in v4.0
+ * Note: files/tasks related stats removed in v5.0
  */
 export interface ImportStats {
     project_created: boolean;
     master_tables: {
-        files_created: number;
-        files_reused: number;
         context_keys_created: number;
         tags_created: number;
         tags_reused: number;
@@ -976,10 +697,7 @@ export interface ImportStats {
         decisions_numeric_created: number;
         decision_history_created: number;
         decision_context_created: number;
-        file_changes_created: number;
         constraints_created: number;
-        tasks_created: number;
-        task_details_created: number;
         decision_policies_created: number;
         tag_index_created: number;
     };
@@ -987,25 +705,8 @@ export interface ImportStats {
         decision_tags_created: number;
         decision_scopes_created: number;
         constraint_tags_created: number;
-        task_tags_created: number;
-        task_file_links_created: number;
-        task_decision_links_created: number;
-        task_dependencies_created: number;
     };
 }
-/**
- * Task dependency graph for topological sorting
- */
-export interface TaskDependencyGraph {
-    /** Task IDs with no dependencies (roots) */
-    roots: number[];
-    /** Map from blocker_task_id to array of blocked_task_ids */
-    children: Map<number, number[]>;
-    /** Map from blocked_task_id to array of blocker_task_ids */
-    parents: Map<number, number[]>;
-    /** All task IDs in the graph */
-    allTaskIds: Set<number>;
-}
 /**
  * JSON import result
  */