@lwelliott/cortex-cli 1.0.3

package/dist/cli/formatters/table.js

@@ -0,0 +1,726 @@
+"use strict";
+// Table formatter using cli-table3
+// Implements AD-0013: Strategy Pattern for Output Formatters
+// + FS-SS-007-0005 (table output formatter)
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatAsTable = formatAsTable;
+const cli_table3_1 = __importDefault(require("cli-table3"));
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Render sprint result as a table.
+ */
+function formatSprintAsTable(data) {
+    const table = new cli_table3_1.default({
+        head: [chalk_1.default.bold('Field'), chalk_1.default.bold('Value')],
+        colWidths: [20, 60],
+    });
+    for (const [key, value] of Object.entries(data)) {
+        const displayValue = value === null ? chalk_1.default.dim('(null)') : value === undefined ? chalk_1.default.dim('(undefined)') : String(value);
+        table.push([key, displayValue]);
+    }
+    return table.toString();
+}
+/**
+ * Render task result as a table.
+ */
+function formatTaskAsTable(data) {
+    const table = new cli_table3_1.default({
+        head: [chalk_1.default.bold('Field'), chalk_1.default.bold('Value')],
+        colWidths: [20, 60],
+    });
+    // Order fields for readability
+    const orderedKeys = ['id', 'sprint_id', 'parent_id', 'description', 'status', 'owner', 'task_type', 'priority', 'points', 'session_key', 'stage', 'started_at', 'completed_at'];
+    const seen = new Set();
+    for (const key of orderedKeys) {
+        if (key in data) {
+            const value = data[key];
+            const displayValue = value === null ? chalk_1.default.dim('(null)') : value === undefined ? '' : String(value);
+            table.push([key, displayValue]);
+            seen.add(key);
+        }
+    }
+    for (const [key, value] of Object.entries(data)) {
+        if (seen.has(key))
+            continue;
+        const displayValue = value === null ? chalk_1.default.dim('(null)') : String(value);
+        table.push([key, displayValue]);
+    }
+    return table.toString();
+}
+/**
+ * Render a document list as a table.
+ * Columns: ID, Type, Title, Updated
+ */
+function formatDocumentListAsTable(docs) {
+    if (docs.length === 0) {
+        return chalk_1.default.dim('No documents found.');
+    }
+    const table = new cli_table3_1.default({
+        head: [
+            chalk_1.default.bold('ID'),
+            chalk_1.default.bold('Type'),
+            chalk_1.default.bold('Title'),
+            chalk_1.default.bold('Updated'),
+        ],
+        colWidths: [20, 12, 35, 24],
+        wordWrap: true,
+    });
+    for (const doc of docs) {
+        table.push([
+            String(doc.id ?? ''),
+            String(doc.type ?? ''),
+            String(doc.title ?? ''),
+            String(doc.updated_at ?? ''),
+        ]);
+    }
+    return table.toString();
+}
+/**
+ * Render a task list as a table.
+ */
+const MAX_DESC_LENGTH = 50;
+function formatTaskListAsTable(tasks) {
+    if (tasks.length === 0) {
+        return chalk_1.default.dim('No tasks found.');
+    }
+    const table = new cli_table3_1.default({
+        head: [
+            chalk_1.default.bold('ID'),
+            chalk_1.default.bold('Status'),
+            chalk_1.default.bold('Owner'),
+            chalk_1.default.bold('Description'),
+        ],
+        colWidths: [15, 14, 10, 55],
+    });
+    for (const task of tasks) {
+        const rawDesc = task.description;
+        const displayDesc = typeof rawDesc === 'string'
+            ? (rawDesc.length > MAX_DESC_LENGTH
+                ? rawDesc.substring(0, MAX_DESC_LENGTH) + '...'
+                : rawDesc)
+            : String(rawDesc ?? '');
+        table.push([
+            String(task.id ?? ''),
+            String(task.status ?? ''),
+            String(task.owner ?? ''),
+            displayDesc,
+        ]);
+    }
+    return table.toString();
+}
+/**
+ * Render search results as a table.
+ * Columns: Document ID, Title, Type, Rank
+ */
+function formatSearchResultAsTable(results) {
+    if (results.length === 0) {
+        return chalk_1.default.dim('No results found.');
+    }
+    const table = new cli_table3_1.default({
+        head: [
+            chalk_1.default.bold('Document ID'),
+            chalk_1.default.bold('Title'),
+            chalk_1.default.bold('Type'),
+            chalk_1.default.bold('Rank'),
+        ],
+        colWidths: [20, 40, 12, 10],
+        wordWrap: true,
+    });
+    for (const result of results) {
+        table.push([
+            String(result.documentId ?? ''),
+            String(result.title ?? ''),
+            String(result.type ?? ''),
+            String(result.rank ?? ''),
+        ]);
+    }
+    return table.toString();
+}
+/**
+ * Render a sprint overview as a table.
+ */
+function formatSprintOverviewAsTable(data) {
+    const lines = [];
+    lines.push(chalk_1.default.bold(`Sprint: ${data.id}`));
+    lines.push(`  Name:     ${data.name}`);
+    lines.push(`  Status:   ${data.status}`);
+    if (data.goal) {
+        lines.push(`  Goal:     ${data.goal}`);
+    }
+    lines.push(`  Created:  ${data.created_at}`);
+    if (data.closed_at) {
+        lines.push(`  Closed:   ${data.closed_at}`);
+    }
+    lines.push('');
+    // Task counts by status
+    const taskCounts = data.taskCounts;
+    if (taskCounts) {
+        lines.push(chalk_1.default.bold('Tasks'));
+        const table = new cli_table3_1.default({
+            head: [
+                chalk_1.default.bold('Status'),
+                chalk_1.default.bold('Count'),
+            ],
+            colWidths: [20, 10],
+        });
+        for (const [status, count] of Object.entries(taskCounts)) {
+            table.push([status, String(count)]);
+        }
+        table.push([chalk_1.default.bold('Total'), chalk_1.default.bold(String(data.totalTasks ?? 0))]);
+        lines.push(table.toString());
+    }
+    return lines.join('\n');
+}
+/**
+ * Render entity type list as a table.
+ * Columns: Name, Documents
+ */
+function formatEntityTypeListAsTable(entities) {
+    if (entities.length === 0) {
+        return chalk_1.default.dim('No entity types found.');
+    }
+    const table = new cli_table3_1.default({
+        head: [
+            chalk_1.default.bold('Name'),
+            chalk_1.default.bold('Documents'),
+        ],
+        colWidths: [24, 12],
+        wordWrap: true,
+    });
+    for (const e of entities) {
+        table.push([
+            String(e.name ?? ''),
+            String(e.doc_count ?? 0),
+        ]);
+    }
+    return table.toString();
+}
+/**
+ * Render review list as a table.
+ * Columns: Review#, Sprint, Asset, Type, Verdict, Created
+ */
+function formatReviewListAsTable(reviews) {
+    if (reviews.length === 0) {
+        return chalk_1.default.dim('No reviews found.');
+    }
+    const table = new cli_table3_1.default({
+        head: [
+            chalk_1.default.bold('Review#'),
+            chalk_1.default.bold('Sprint'),
+            chalk_1.default.bold('Asset'),
+            chalk_1.default.bold('Type'),
+            chalk_1.default.bold('Verdict'),
+            chalk_1.default.bold('Created'),
+        ],
+        colWidths: [12, 18, 20, 12, 12, 24],
+        wordWrap: true,
+    });
+    for (const r of reviews) {
+        // asset_name renders as empty string when null (not '(null)')
+        const assetName = r.asset_name === null || r.asset_name === undefined ? '' : String(r.asset_name);
+        table.push([
+            String(r.review_num ?? ''),
+            String(r.sprint_id ?? ''),
+            assetName,
+            String(r.review_type ?? ''),
+            String(r.verdict ?? ''),
+            String(r.created_at ?? ''),
+        ]);
+    }
+    return table.toString();
+}
+/**
+ * Render lesson list as a table.
+ * Columns: Category, Severity, Title, Created
+ */
+function formatLessonListAsTable(lessons) {
+    if (lessons.length === 0) {
+        return chalk_1.default.dim('No lessons found.');
+    }
+    const table = new cli_table3_1.default({
+        head: [
+            chalk_1.default.bold('Category'),
+            chalk_1.default.bold('Severity'),
+            chalk_1.default.bold('Title'),
+            chalk_1.default.bold('Created'),
+        ],
+        colWidths: [16, 12, 40, 24],
+        wordWrap: true,
+    });
+    for (const l of lessons) {
+        table.push([
+            String(l.category ?? ''),
+            String(l.severity ?? ''),
+            String(l.title ?? ''),
+            String(l.created_at ?? ''),
+        ]);
+    }
+    return table.toString();
+}
+/**
+ * Render test report list as a table.
+ * SAD-0031 Part B: Task column removed. Columns: ID, Sprint, Result, Total, Pass, Fail, Blocked, Skip, Created
+ */
+function formatTestReportListAsTable(reports) {
+    if (reports.length === 0) {
+        return chalk_1.default.dim('No test reports found.');
+    }
+    const table = new cli_table3_1.default({
+        head: [
+            chalk_1.default.bold('ID'),
+            chalk_1.default.bold('Sprint'),
+            chalk_1.default.bold('Result'),
+            chalk_1.default.bold('Total'),
+            chalk_1.default.bold('Pass'),
+            chalk_1.default.bold('Fail'),
+            chalk_1.default.bold('Blocked'),
+            chalk_1.default.bold('Skip'),
+            chalk_1.default.bold('Created'),
+        ],
+        colWidths: [8, 18, 10, 8, 8, 8, 8, 8, 24],
+        wordWrap: true,
+    });
+    for (const r of reports) {
+        table.push([
+            String(r.id ?? ''),
+            String(r.sprint_id ?? ''),
+            String(r.result ?? ''),
+            String(r.total ?? ''),
+            String(r.passed ?? ''),
+            String(r.failed ?? ''),
+            String(r.blocked ?? ''),
+            String(r.skipped ?? ''),
+            String(r.created_at ?? ''),
+        ]);
+    }
+    return table.toString();
+}
+/**
+ * Render entity list as a table.
+ * Columns: ID, Type, Properties, Created, Updated
+ */
+function formatEntityListAsTable(entities) {
+    if (entities.length === 0) {
+        return chalk_1.default.dim('No entities found.');
+    }
+    const table = new cli_table3_1.default({
+        head: [
+            chalk_1.default.bold('ID'),
+            chalk_1.default.bold('Type'),
+            chalk_1.default.bold('Properties'),
+            chalk_1.default.bold('Created'),
+            chalk_1.default.bold('Updated'),
+        ],
+        colWidths: [20, 16, 24, 24, 24],
+        wordWrap: true,
+    });
+    for (const e of entities) {
+        // properties: render as "{n} props" or "{}"
+        let propsDisplay;
+        const rawProps = e.properties;
+        if (rawProps === null || rawProps === undefined) {
+            propsDisplay = '{}';
+        }
+        else if (typeof rawProps === 'string') {
+            // properties may be stored as JSON string
+            try {
+                const parsed = JSON.parse(rawProps);
+                if (parsed && typeof parsed === 'object' && Object.keys(parsed).length > 0) {
+                    propsDisplay = `${Object.keys(parsed).length} props`;
+                }
+                else {
+                    propsDisplay = '{}';
+                }
+            }
+            catch {
+                propsDisplay = '{}';
+            }
+        }
+        else if (typeof rawProps === 'object' && Object.keys(rawProps).length > 0) {
+            propsDisplay = `${Object.keys(rawProps).length} props`;
+        }
+        else {
+            propsDisplay = '{}';
+        }
+        table.push([
+            String(e.id ?? ''),
+            String(e.type_name ?? ''),
+            propsDisplay,
+            String(e.created_at ?? ''),
+            String(e.updated_at ?? ''),
+        ]);
+    }
+    return table.toString();
+}
+/**
+ * Render relation list as a table.
+ * Columns: ID, From, Type, To, Created
+ */
+function formatRelationListAsTable(relations) {
+    if (relations.length === 0) {
+        return chalk_1.default.dim('No relations found.');
+    }
+    const table = new cli_table3_1.default({
+        head: [
+            chalk_1.default.bold('ID'),
+            chalk_1.default.bold('From'),
+            chalk_1.default.bold('Type'),
+            chalk_1.default.bold('To'),
+            chalk_1.default.bold('Created'),
+        ],
+        colWidths: [8, 20, 18, 20, 24],
+        wordWrap: true,
+    });
+    for (const r of relations) {
+        table.push([
+            String(r.id ?? ''),
+            String(r.from_id ?? ''),
+            String(r.rel_type ?? ''),
+            String(r.to_id ?? ''),
+            String(r.created_at ?? ''),
+        ]);
+    }
+    return table.toString();
+}
+/**
+ * Render related documents as a table.
+ * SAD-0035: Updated to use docId/docType (documents table) instead of entity.id/entity.type_name.
+ * Columns: Doc ID, Type, Relation, Direction
+ */
+function formatRelationRelatedAsTable(related, parentEntityId) {
+    if (related.length === 0) {
+        return chalk_1.default.dim('No relations found.');
+    }
+    const table = new cli_table3_1.default({
+        head: [
+            chalk_1.default.bold('Doc ID'),
+            chalk_1.default.bold('Type'),
+            chalk_1.default.bold('Relation'),
+            chalk_1.default.bold('Direction'),
+        ],
+        colWidths: [20, 16, 18, 12],
+        wordWrap: true,
+    });
+    for (const item of related) {
+        const rel = item.relation;
+        // Compute direction from parentEntityId
+        let direction;
+        if (parentEntityId === undefined || parentEntityId === null) {
+            direction = '?';
+        }
+        else if (rel && String(rel.from_id) === parentEntityId) {
+            direction = 'outgoing';
+        }
+        else {
+            direction = 'incoming';
+        }
+        table.push([
+            String(item.docId ?? ''),
+            String(item.docType ?? ''),
+            String(rel?.rel_type ?? ''),
+            direction,
+        ]);
+    }
+    return table.toString();
+}
+/**
+ * Render relation type list as a table.
+ * Columns: Name, From Types, To Types, Cardinality, Inverse Of, Description
+ */
+function formatRelationTypeListAsTable(relations) {
+    if (relations.length === 0) {
+        return chalk_1.default.dim('No relation types found.');
+    }
+    const table = new cli_table3_1.default({
+        head: [
+            chalk_1.default.bold('Name'),
+            chalk_1.default.bold('From Types'),
+            chalk_1.default.bold('To Types'),
+            chalk_1.default.bold('Cardinality'),
+            chalk_1.default.bold('Inverse Of'),
+            chalk_1.default.bold('Description'),
+        ],
+        colWidths: [18, 22, 22, 16, 16, 24],
+        wordWrap: true,
+    });
+    for (const r of relations) {
+        let fromTypes = r.from_types;
+        let toTypes = r.to_types;
+        if (typeof fromTypes === 'string') {
+            try {
+                fromTypes = JSON.parse(fromTypes);
+            }
+            catch {
+                fromTypes = [];
+            }
+        }
+        if (typeof toTypes === 'string') {
+            try {
+                toTypes = JSON.parse(toTypes);
+            }
+            catch {
+                toTypes = [];
+            }
+        }
+        table.push([
+            String(r.name ?? ''),
+            Array.isArray(fromTypes) ? fromTypes.join(', ') : String(fromTypes ?? ''),
+            Array.isArray(toTypes) ? toTypes.join(', ') : String(toTypes ?? ''),
+            String(r.cardinality ?? ''),
+            String(r.inverse_of ?? ''),
+            String(r.description ?? ''),
+        ]);
+    }
+    return table.toString();
+}
+/**
+ * Render a sprint list as a table.
+ */
+function formatSprintListAsTable(sprints) {
+    if (sprints.length === 0) {
+        return chalk_1.default.dim('No sprints found.');
+    }
+    const table = new cli_table3_1.default({
+        head: [
+            chalk_1.default.bold('ID'),
+            chalk_1.default.bold('Name'),
+            chalk_1.default.bold('Status'),
+            chalk_1.default.bold('Created'),
+        ],
+        colWidths: [20, 20, 16, 24],
+    });
+    for (const sprint of sprints) {
+        table.push([
+            String(sprint.id ?? ''),
+            String(sprint.name ?? ''),
+            String(sprint.status ?? ''),
+            String(sprint.created_at ?? ''),
+        ]);
+    }
+    return table.toString();
+}
+/**
+ * Render a single project object as a 2-column key-value table.
+ */
+function formatSingleProjectAsTable(data) {
+    const table = new cli_table3_1.default({
+        head: [chalk_1.default.bold('Property'), chalk_1.default.bold('Value')],
+        colWidths: [20, 60],
+        wordWrap: true,
+    });
+    const rows = [];
+    if ('name' in data)
+        rows.push(['Name', String(data.name ?? '')]);
+    if ('folder' in data)
+        rows.push(['Folder', String(data.folder ?? '')]);
+    if ('dbPath' in data)
+        rows.push(['Database', String(data.dbPath ?? '')]);
+    if ('isNew' in data)
+        rows.push(['New', data.isNew ? 'Yes' : 'No']);
+    if ('isDefault' in data)
+        rows.push(['Default', data.isDefault ? 'Yes' : 'No']);
+    if ('sprintCount' in data) {
+        const sprintCount = data.sprintCount ?? 0;
+        const activeCount = data.activeSprintCount ?? 0;
+        rows.push(['Sprints', `${sprintCount} (${activeCount} active)`]);
+    }
+    if ('taskCount' in data)
+        rows.push(['Tasks', String(data.taskCount ?? 0)]);
+    if ('docCount' in data)
+        rows.push(['Documents', String(data.docCount ?? 0)]);
+    if ('preserved' in data)
+        rows.push(['Database Preserved', 'Yes']);
+    if ('defaultProject' in data) {
+        rows.push(['Default Project', String(data.defaultProject ?? chalk_1.default.dim('(none)'))]);
+    }
+    for (const [key, value] of rows) {
+        table.push([key, value]);
+    }
+    return table.toString();
+}
+/**
+ * Render a project list array as a 3-column table.
+ * Columns: Name, Folder, Default (✓ for default).
+ */
+function formatProjectListAsTable(projects) {
+    if (projects.length === 0) {
+        return chalk_1.default.dim('No projects registered.');
+    }
+    const table = new cli_table3_1.default({
+        head: [chalk_1.default.bold('Name'), chalk_1.default.bold('Folder'), chalk_1.default.bold('Default')],
+        colWidths: [20, 50, 10],
+        wordWrap: true,
+    });
+    for (const p of projects) {
+        table.push([
+            String(p.name ?? ''),
+            String(p.folder ?? ''),
+            p.isDefault ? '✓' : '',
+        ]);
+    }
+    return table.toString();
+}
+/**
+ * Render validation results as a table.
+ */
+function formatValidationAsTable(data) {
+    const lines = [];
+    const isValid = data.isValid === true;
+    lines.push(chalk_1.default.bold(`Sprint: ${data.sprint_id}`));
+    lines.push(`  Valid: ${isValid ? chalk_1.default.green('✓ Yes') : chalk_1.default.red('✗ No')}`);
+    lines.push('');
+    const issues = data.issues;
+    if (!issues || issues.length === 0) {
+        lines.push(chalk_1.default.green('  No issues found.'));
+        return lines.join('\n');
+    }
+    const table = new cli_table3_1.default({
+        head: [
+            chalk_1.default.bold('Severity'),
+            chalk_1.default.bold('Category'),
+            chalk_1.default.bold('Entity'),
+            chalk_1.default.bold('Message'),
+        ],
+        colWidths: [10, 14, 14, 50],
+        wordWrap: true,
+    });
+    for (const issue of issues) {
+        const severity = issue.severity === 'error' ? chalk_1.default.red(String(issue.severity)) :
+            issue.severity === 'warning' ? chalk_1.default.yellow(String(issue.severity)) :
+                chalk_1.default.blue(String(issue.severity));
+        table.push([
+            severity,
+            String(issue.category ?? ''),
+            String(issue.entity ?? ''),
+            String(issue.message ?? ''),
+        ]);
+    }
+    lines.push(table.toString());
+    return lines.join('\n');
+}
+/**
+ * Format structured data as a table, dispatching on entity type.
+ */
+function formatAsTable(data, entityType, options) {
+    if (data === null || data === undefined) {
+        return chalk_1.default.dim('No data.');
+    }
+    if (typeof data === 'string') {
+        return data;
+    }
+    if (Array.isArray(data)) {
+        if (data.length === 0) {
+            // Determine entity type from content
+            if (entityType === 'document-search')
+                return chalk_1.default.dim('No results found.');
+            if (entityType === 'tasks')
+                return chalk_1.default.dim('No tasks found.');
+            if (entityType === 'sprints')
+                return chalk_1.default.dim('No sprints found.');
+            if (entityType === 'review')
+                return chalk_1.default.dim('No reviews found.');
+            if (entityType === 'lesson')
+                return chalk_1.default.dim('No lessons found.');
+            if (entityType === 'test-report')
+                return chalk_1.default.dim('No test reports found.');
+            if (entityType === 'entity')
+                return chalk_1.default.dim('No entities found.');
+            if (entityType === 'relation')
+                return chalk_1.default.dim('No relations found.');
+            if (entityType === 'relation-related')
+                return chalk_1.default.dim('No relations found.');
+            if (entityType === 'entity-types')
+                return chalk_1.default.dim('No entity types found.');
+            if (entityType === 'relation-types')
+                return chalk_1.default.dim('No relation types found.');
+            if (entityType === 'project')
+                return chalk_1.default.dim('No projects registered.');
+            return chalk_1.default.dim('No results.');
+        }
+        // Check first item to determine type
+        const first = data[0];
+        // Priority 0: explicit entity type for project list
+        if (entityType === 'project') {
+            return formatProjectListAsTable(data);
+        }
+        // Priority 1: explicit entity type for search results
+        if (entityType === 'document-search') {
+            return formatSearchResultAsTable(data);
+        }
+        // Priority 2: explicit entity type for document list
+        if (entityType === 'document') {
+            return formatDocumentListAsTable(data);
+        }
+        // Priority 3: explicit entity type for entity-type list
+        if (entityType === 'entity-types') {
+            return formatEntityTypeListAsTable(data);
+        }
+        // Priority 4: explicit entity type for relation-type list
+        if (entityType === 'relation-types') {
+            return formatRelationTypeListAsTable(data);
+        }
+        // Priority 5: explicit entity type for review list
+        if (entityType === 'review') {
+            return formatReviewListAsTable(data);
+        }
+        // Priority 6: explicit entity type for lesson list
+        if (entityType === 'lesson') {
+            return formatLessonListAsTable(data);
+        }
+        // Priority 7: explicit entity type for test-report list
+        if (entityType === 'test-report') {
+            return formatTestReportListAsTable(data);
+        }
+        // Priority 8: explicit entity type for entity list
+        if (entityType === 'entity') {
+            return formatEntityListAsTable(data);
+        }
+        // Priority 9: explicit entity type for relation list
+        if (entityType === 'relation') {
+            return formatRelationListAsTable(data);
+        }
+        // Priority 10: explicit entity type for relation-related list
+        if (entityType === 'relation-related') {
+            return formatRelationRelatedAsTable(data, options?.parentEntityId);
+        }
+        if ('owner' in first || 'task_type' in first) {
+            return formatTaskListAsTable(data);
+        }
+        if ('status' in first && ('goal' in first || first.status === 'PLANNING' || first.status === 'IN EXECUTION')) {
+            return formatSprintListAsTable(data);
+        }
+        // Priority 4 (fallback): array introspection for search results
+        if ('documentId' in first && 'rank' in first) {
+            return formatSearchResultAsTable(data);
+        }
+        // Generic table for other arrays
+        return formatTaskListAsTable(data);
+    }
+    // Single object
+    if (typeof data === 'object') {
+        const obj = data;
+        // Explicit entity type for project single-object
+        if (entityType === 'project') {
+            return formatSingleProjectAsTable(obj);
+        }
+        if ('isValid' in obj && 'issues' in obj) {
+            return formatValidationAsTable(obj);
+        }
+        if ('taskCounts' in obj) {
+            return formatSprintOverviewAsTable(obj);
+        }
+        if ('owner' in obj && 'task_type' in obj && 'description' in obj) {
+            return formatTaskAsTable(obj);
+        }
+        // Check for sprint data
+        if ('status' in obj && ('goal' in obj || !('owner' in obj))) {
+            return formatSprintAsTable(obj);
+        }
+        return formatSprintAsTable(obj);
+    }
+    return String(data);
+}
+//# sourceMappingURL=table.js.map