@lwelliott/cortex-cli 1.0.3

package/dist/cli/entity.js

@@ -0,0 +1,135 @@
+"use strict";
+// CLI subcommands for entity group
+// SAD-0003: MOD-009 Entity CRUD
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEntityGroup = createEntityGroup;
+const commander_1 = require("commander");
+const graph_service_1 = require("../services/graph-service");
+const graph_service_2 = require("../services/graph-service");
+const connection_1 = require("../db/connection");
+const migration_1 = require("../db/migration");
+const project_resolver_1 = require("./project-resolver");
+const format_selector_1 = require("./format-selector");
+function run(fn, optsOrCmd) {
+    try {
+        const opts = optsOrCmd instanceof commander_1.Command ? optsOrCmd.optsWithGlobals() : optsOrCmd;
+        console.log(fn(opts));
+    }
+    catch (err) {
+        const opts = optsOrCmd instanceof commander_1.Command ? optsOrCmd.optsWithGlobals() : optsOrCmd;
+        const format = (0, format_selector_1.selectFormat)(opts);
+        console.error((0, format_selector_1.formatErrorOutput)(err instanceof Error ? err : new Error(String(err)), format));
+        process.exit(1);
+    }
+}
+function createEntityGroup() {
+    const group = new commander_1.Command('entity').description('Graph entity CRUD');
+    // entity create
+    group.command('create')
+        .description('Create a new entity')
+        .argument('<id>', 'Entity ID')
+        .requiredOption('--type <type>', 'Entity type name')
+        .option('--props <json>', 'Properties as JSON')
+        .action((id, _opts, cmd) => run((o) => handleCreate(id, o), cmd));
+    // entity get
+    group.command('get')
+        .description('Get an entity by ID')
+        .argument('<id>', 'Entity ID')
+        .action((id, _opts, cmd) => run((o) => handleGet(id, o), cmd));
+    // entity query
+    group.command('query')
+        .description('Query entities with optional filters')
+        .option('--type <type>', 'Filter by entity type')
+        .option('--limit <n>', 'Max results', '100')
+        .option('--offset <n>', 'Offset', '0')
+        .action((_opts, cmd) => run(handleQuery, cmd));
+    // entity update
+    group.command('update')
+        .description('Update entity properties (merge)')
+        .argument('<id>', 'Entity ID')
+        .requiredOption('--props <json>', 'Properties to merge (JSON)')
+        .action((id, _opts, cmd) => run((o) => handleUpdate(id, o), cmd));
+    // entity delete
+    group.command('delete')
+        .description('Delete an entity (cascades to relations)')
+        .argument('<id>', 'Entity ID')
+        .action((id, _opts, cmd) => run((o) => handleDelete(id, o), cmd));
+    return group;
+}
+function handleCreate(id, opts) {
+    const typeName = opts.type;
+    const props = opts.props ? JSON.parse(opts.props) : undefined;
+    const format = (0, format_selector_1.selectFormat)(opts);
+    const resolved = (0, project_resolver_1.resolveFromCLI)(opts);
+    const db = (0, connection_1.openConnection)(resolved.dbPath);
+    try {
+        (0, migration_1.initializeSchema)(db);
+        (0, graph_service_2.ensureBuiltinSchemaInitialized)(db);
+        const entity = (0, graph_service_1.createEntity)(db, id, typeName, props);
+        return (0, format_selector_1.formatOutput)(entity, format);
+    }
+    finally {
+        db.close();
+    }
+}
+function handleGet(id, opts) {
+    const format = (0, format_selector_1.selectFormat)(opts);
+    const resolved = (0, project_resolver_1.resolveFromCLI)(opts);
+    const db = (0, connection_1.openConnection)(resolved.dbPath);
+    try {
+        (0, migration_1.initializeSchema)(db);
+        (0, graph_service_2.ensureBuiltinSchemaInitialized)(db);
+        const entity = (0, graph_service_1.getEntity)(db, id);
+        return (0, format_selector_1.formatOutput)(entity, format);
+    }
+    finally {
+        db.close();
+    }
+}
+function handleQuery(opts) {
+    const format = (0, format_selector_1.selectFormat)(opts);
+    const resolved = (0, project_resolver_1.resolveFromCLI)(opts);
+    const db = (0, connection_1.openConnection)(resolved.dbPath);
+    try {
+        (0, migration_1.initializeSchema)(db);
+        (0, graph_service_2.ensureBuiltinSchemaInitialized)(db);
+        const entities = (0, graph_service_1.queryEntities)(db, {
+            typeName: opts.type,
+            limit: parseInt(opts.limit, 10),
+            offset: parseInt(opts.offset, 10),
+        });
+        return (0, format_selector_1.formatOutput)(entities, format, 'entity');
+    }
+    finally {
+        db.close();
+    }
+}
+function handleUpdate(id, opts) {
+    const props = JSON.parse(opts.props);
+    const format = (0, format_selector_1.selectFormat)(opts);
+    const resolved = (0, project_resolver_1.resolveFromCLI)(opts);
+    const db = (0, connection_1.openConnection)(resolved.dbPath);
+    try {
+        (0, migration_1.initializeSchema)(db);
+        (0, graph_service_2.ensureBuiltinSchemaInitialized)(db);
+        const entity = (0, graph_service_1.updateEntity)(db, id, props);
+        return (0, format_selector_1.formatOutput)(entity, format);
+    }
+    finally {
+        db.close();
+    }
+}
+function handleDelete(id, opts) {
+    const resolved = (0, project_resolver_1.resolveFromCLI)(opts);
+    const db = (0, connection_1.openConnection)(resolved.dbPath);
+    try {
+        (0, migration_1.initializeSchema)(db);
+        (0, graph_service_2.ensureBuiltinSchemaInitialized)(db);
+        (0, graph_service_1.deleteEntity)(db, id);
+        return `Entity "${id}" deleted (cascaded to relations)`;
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=entity.js.map

package/dist/cli/entity.js.map

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

package/dist/cli/format-selector.d.ts

@@ -0,0 +1,30 @@
+import type { OutputFormat } from '../models/common';
+import type { FormattableData } from './formatters/table';
+/** Flags that determine which formatter to use */
+export interface FormatFlags {
+    json?: boolean;
+    quiet?: boolean;
+    format?: string;
+}
+/**
+ * Resolve the effective output format from CLI flags.
+ * --quiet takes precedence over --format and --json.
+ * --json takes precedence over --format (default).
+ *
+ * @param flags - CLI format flags
+ * @param isShowCommand - If true, default to 'markdown' and reject '--format table'
+ * @throws CliShowFormatError if isShowCommand and --format table is requested
+ * @throws CliFormatError if --format value is invalid
+ */
+export declare function selectFormat(flags: FormatFlags, isShowCommand?: boolean): OutputFormat;
+/**
+ * Format data using the appropriate formatter.
+ */
+export declare function formatOutput(data: FormattableData, format: OutputFormat, entityType?: string, options?: {
+    parentEntityId?: string;
+}): string;
+/**
+ * Format an error for output.
+ */
+export declare function formatErrorOutput(err: Error, format: OutputFormat): string;
+//# sourceMappingURL=format-selector.d.ts.map

package/dist/cli/format-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-selector.d.ts","sourceRoot":"","sources":["../../src/cli/format-selector.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAO1D,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,YAAY,CA8BtF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,YAAY,EACpB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC,MAAM,CAYR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,KAAK,EACV,MAAM,EAAE,YAAY,GACnB,MAAM,CAuBR"}

package/dist/cli/format-selector.js

@@ -0,0 +1,101 @@
+"use strict";
+// Format selector
+// Selects the appropriate formatter based on --format and --quiet flags
+// Implements AD-0013: Strategy Pattern for Output Formatters
+// + FS-SS-007-0002 (format option), FS-SS-007-0003 (quiet option)
+// + SAD-0010: MarkdownFormatter as default for show commands
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectFormat = selectFormat;
+exports.formatOutput = formatOutput;
+exports.formatErrorOutput = formatErrorOutput;
+const table_1 = require("./formatters/table");
+const json_1 = require("./formatters/json");
+const quiet_1 = require("./formatters/quiet");
+const markdown_1 = require("./formatters/markdown");
+const errors_1 = require("../utils/errors");
+/**
+ * Resolve the effective output format from CLI flags.
+ * --quiet takes precedence over --format and --json.
+ * --json takes precedence over --format (default).
+ *
+ * @param flags - CLI format flags
+ * @param isShowCommand - If true, default to 'markdown' and reject '--format table'
+ * @throws CliShowFormatError if isShowCommand and --format table is requested
+ * @throws CliFormatError if --format value is invalid
+ */
+function selectFormat(flags, isShowCommand) {
+    // --quiet takes precedence (FS-SS-007-0003)
+    if (flags.quiet) {
+        return 'quiet';
+    }
+    // --json flag (check before --format since format may have defaults)
+    if (flags.json) {
+        return 'json';
+    }
+    // --format flag
+    const fmt = flags.format ? flags.format.toLowerCase() : '';
+    if (fmt) {
+        // --format table is invalid for show commands (ERR-CLI-FORMAT)
+        if (isShowCommand && fmt === 'table') {
+            throw new errors_1.CliShowFormatError('table');
+        }
+        if (fmt === 'json')
+            return 'json';
+        if (fmt === 'table')
+            return 'table';
+        if (fmt === 'markdown')
+            return 'markdown';
+        if (fmt === 'quiet')
+            return 'quiet';
+        throw new errors_1.CliFormatError(fmt);
+    }
+    // Default: markdown for show commands, table for list commands
+    if (isShowCommand) {
+        return 'markdown';
+    }
+    return 'table';
+}
+/**
+ * Format data using the appropriate formatter.
+ */
+function formatOutput(data, format, entityType, options) {
+    switch (format) {
+        case 'json':
+            return (0, json_1.formatAsJson)(data, entityType);
+        case 'quiet':
+            return (0, quiet_1.formatAsQuiet)(data, entityType);
+        case 'markdown':
+            return (0, markdown_1.formatAsMarkdown)(data, entityType);
+        case 'table':
+        default:
+            return (0, table_1.formatAsTable)(data, entityType, options);
+    }
+}
+/**
+ * Format an error for output.
+ */
+function formatErrorOutput(err, format) {
+    switch (format) {
+        case 'json':
+            return JSON.stringify({
+                error: {
+                    name: err.name,
+                    message: err.message,
+                    code: 'code' in err ? err.code : undefined,
+                },
+            }, null, 2);
+        case 'quiet':
+            return err.message;
+        case 'markdown':
+        case 'table':
+        default:
+            if ('code' in err) {
+                const code = err.code;
+                // Strip embedded code prefix from message if present (e.g. "ERR-TASK-001: Task not found" → "Task not found")
+                const msg = err.message.replace(/^ERR-[A-Z]+-[0-9]+:\s*/, '');
+                return `Error ${code}: ${msg}`;
+            }
+            return `Error: ${err.message}`;
+    }
+}
+//# sourceMappingURL=format-selector.js.map

package/dist/cli/format-selector.js.map

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

package/dist/cli/formatters/audit-formatter.d.ts

@@ -0,0 +1,33 @@
+import type { AuditReport } from '../../services/audit-checks/types';
+/** Format selection priority: --format flag > file extension > default 'terminal' */
+export declare function resolveFormat(formatOverride?: string, reportFile?: string): 'terminal' | 'json' | 'markdown';
+export declare class AuditReportFormatter {
+    /**
+     * Format an audit report and optionally write to file.
+     * @param report - The audit report
+     * @param format - Output format ('terminal', 'json', 'markdown')
+     * @param color - Whether to use ANSI colors (terminal only)
+     * @returns Formatted string
+     */
+    format(report: AuditReport, format: 'terminal' | 'json' | 'markdown', color?: boolean): string;
+    /**
+     * Format as JSON (FS-SS-023-0009).
+     */
+    private formatJson;
+    /**
+     * Format as terminal color-coded table (FS-SS-023-0007).
+     */
+    private formatTerminal;
+    /**
+     * Format as Markdown (FS-SS-023-0010).
+     */
+    private formatMarkdown;
+    /**
+     * Write report to file.
+     * @throws AuditReportFileError on write failure
+     */
+    writeToFile(report: AuditReport, filePath: string, formatOverride?: string): void;
+    private statusIcon;
+    private statusEmoji;
+}
+//# sourceMappingURL=audit-formatter.d.ts.map

package/dist/cli/formatters/audit-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-formatter.d.ts","sourceRoot":"","sources":["../../../src/cli/formatters/audit-formatter.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,mCAAmC,CAAC;AAIjF,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CAY5G;AAED,qBAAa,oBAAoB;IAC/B;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,UAAU,EAAE,KAAK,GAAE,OAAc,GAAG,MAAM;IAYpG;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,cAAc;IAmDtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAwDtB;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAYjF,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,WAAW;CAGpB"}

package/dist/cli/formatters/audit-formatter.js

@@ -0,0 +1,204 @@
+"use strict";
+// AuditReportFormatter: formats audit reports for terminal/JSON/Markdown
+// FS-SS-023-0007: terminal table with color-coded pass/fail/skip
+// FS-SS-023-0009: JSON structured output
+// FS-SS-023-0010: Markdown documented sections
+// MOD-023: CLI Audit Command
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditReportFormatter = void 0;
+exports.resolveFormat = resolveFormat;
+const errors_1 = require("../../utils/errors");
+const fs_1 = require("fs");
+/** Format selection priority: --format flag > file extension > default 'terminal' */
+function resolveFormat(formatOverride, reportFile) {
+    if (formatOverride) {
+        const fmt = formatOverride.toLowerCase();
+        if (fmt === 'json')
+            return 'json';
+        if (fmt === 'markdown')
+            return 'markdown';
+        if (fmt === 'terminal' || fmt === 'table')
+            return 'terminal';
+    }
+    if (reportFile) {
+        if (reportFile.endsWith('.json'))
+            return 'json';
+        if (reportFile.endsWith('.md'))
+            return 'markdown';
+    }
+    return 'terminal';
+}
+class AuditReportFormatter {
+    /**
+     * Format an audit report and optionally write to file.
+     * @param report - The audit report
+     * @param format - Output format ('terminal', 'json', 'markdown')
+     * @param color - Whether to use ANSI colors (terminal only)
+     * @returns Formatted string
+     */
+    format(report, format, color = true) {
+        switch (format) {
+            case 'json':
+                return this.formatJson(report);
+            case 'markdown':
+                return this.formatMarkdown(report);
+            case 'terminal':
+            default:
+                return this.formatTerminal(report, color);
+        }
+    }
+    /**
+     * Format as JSON (FS-SS-023-0009).
+     */
+    formatJson(report) {
+        return JSON.stringify(report, null, 2);
+    }
+    /**
+     * Format as terminal color-coded table (FS-SS-023-0007).
+     */
+    formatTerminal(report, color) {
+        const lines = [];
+        // Header
+        lines.push('');
+        lines.push('=== Audit Report ===');
+        lines.push(`Generated: ${report.generatedAt}`);
+        if (report.sprintFilter) {
+            lines.push(`Sprint: ${report.sprintFilter}`);
+        }
+        lines.push('');
+        // Per-check results
+        for (const result of report.checks) {
+            const icon = this.statusIcon(result.status, color);
+            const name = result.checkName.padEnd(22);
+            const status = result.status.padEnd(6);
+            lines.push(`${icon} ${name} ${status} ${result.summary}`);
+            // Show issues if any
+            if (result.issues.length > 0) {
+                for (const issue of result.issues) {
+                    const severityTag = issue.severity === 'warning' ? ' [WARNING]' : issue.severity === 'info' ? ' [INFO]' : '';
+                    const detailLines = issue.detail.split('\n');
+                    lines.push(`     ${detailLines[0]}${severityTag}`);
+                    for (let i = 1; i < detailLines.length; i++) {
+                        lines.push(`     ${detailLines[i]}`);
+                    }
+                }
+            }
+            if (result.fixApplied) {
+                lines.push(`     → ${result.fixApplied}`);
+            }
+            // Show fixCount per check when defined (SAD-0036: --fix-dry-run)
+            if (result.fixCount !== undefined && result.fixCount > 0) {
+                lines.push(`     → [dry-run] ${result.fixCount} item(s) would be fixed for this check`);
+            }
+        }
+        lines.push('');
+        const passed = report.checks.filter(c => c.status === 'PASS').length;
+        const failed = report.checks.filter(c => c.status === 'FAIL').length;
+        const skipped = report.checks.filter(c => c.status === 'SKIP').length;
+        lines.push(`Summary: ${report.checks.length} checks run | ${passed} passed | ${skipped} skipped | ${failed} failed | ${report.fixApplied ? 'fixes applied' : '0 fixed'}`);
+        lines.push(`Exit: ${report.exitCode}`);
+        return lines.join('\n');
+    }
+    /**
+     * Format as Markdown (FS-SS-023-0010).
+     */
+    formatMarkdown(report) {
+        const lines = [];
+        lines.push('# Audit Report');
+        lines.push('');
+        lines.push(`**Generated:** ${report.generatedAt}`);
+        if (report.sprintFilter) {
+            lines.push(`**Sprint:** ${report.sprintFilter}`);
+        }
+        lines.push('');
+        // Summary table
+        const passed = report.checks.filter(c => c.status === 'PASS').length;
+        const failed = report.checks.filter(c => c.status === 'FAIL').length;
+        const skipped = report.checks.filter(c => c.status === 'SKIP').length;
+        lines.push('## Summary');
+        lines.push('');
+        lines.push(`| Checks Run | Passed | Skipped | Failed | Fixes Applied |`);
+        lines.push(`|------------|--------|---------|--------|---------------|`);
+        lines.push(`| ${report.checks.length} | ${passed} | ${skipped} | ${failed} | ${report.fixApplied ? 'Yes' : 'No'} |`);
+        lines.push('');
+        // Per-check sections
+        for (const result of report.checks) {
+            lines.push(`## ${this.statusEmoji(result.status)} ${result.checkName} — ${result.status}`);
+            lines.push('');
+            lines.push(`**Summary:** ${result.summary}`);
+            if (result.issues.length > 0) {
+                lines.push('');
+                lines.push('### Affected Items');
+                lines.push('');
+                for (const issue of sortIssues(result.issues)) {
+                    lines.push(`- ${formatMarkdownIssue(issue)}`);
+                }
+            }
+            if (result.fixApplied) {
+                lines.push('');
+                lines.push(`**Fixes:** ${result.fixApplied}`);
+            }
+            if (result.fixCount !== undefined && result.fixCount > 0) {
+                lines.push('');
+                lines.push(`**Would Fix:** ${result.fixCount} item(s) would be fixed for this check`);
+            }
+            lines.push('');
+        }
+        lines.push('---');
+        lines.push(`**Exit Code:** ${report.exitCode}`);
+        return lines.join('\n');
+    }
+    /**
+     * Write report to file.
+     * @throws AuditReportFileError on write failure
+     */
+    writeToFile(report, filePath, formatOverride) {
+        const format = resolveFormat(formatOverride, filePath);
+        const content = this.format(report, format, false);
+        try {
+            (0, fs_1.writeFileSync)(filePath, content, 'utf-8');
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            throw new errors_1.AuditReportFileError(filePath, message);
+        }
+    }
+    statusIcon(status, color) {
+        if (!color) {
+            return status === 'PASS' ? '✓' : status === 'FAIL' ? '✗' : '⚠';
+        }
+        return status === 'PASS' ? '\x1b[32m✓\x1b[0m' : status === 'FAIL' ? '\x1b[31m✗\x1b[0m' : '\x1b[33m⚠\x1b[0m';
+    }
+    statusEmoji(status) {
+        return status === 'PASS' ? '✅' : status === 'FAIL' ? '❌' : '⚠️';
+    }
+}
+exports.AuditReportFormatter = AuditReportFormatter;
+/**
+ * Sort issues by ID for deterministic output (NFS-SS-023-0002).
+ */
+function sortIssues(issues) {
+    return [...issues].sort((a, b) => {
+        const aId = a.entityId ?? a.docId ?? String(a.relationId ?? '');
+        const bId = b.entityId ?? b.docId ?? String(b.relationId ?? '');
+        return aId.localeCompare(bId);
+    });
+}
+function formatMarkdownIssue(issue) {
+    const idRef = issue.entityId
+        ? `Entity \`${issue.entityId}\``
+        : issue.docId
+            ? `Document \`${issue.docId}\``
+            : issue.relationId
+                ? `Relation \`${issue.relationId}\``
+                : '';
+    const typeInfo = issue.entityTypeFound && issue.entityTypeExpected
+        ? ` (found: \`${issue.entityTypeFound}\`, expected: \`${issue.entityTypeExpected}\`)`
+        : issue.docType
+            ? ` (type: \`${issue.docType}\`)`
+            : '';
+    const fixable = issue.fixable ? ' [fixable]' : '';
+    const severity = issue.severity === 'warning' ? ' **⚠ warning**' : issue.severity === 'info' ? ' ℹ️ info' : '';
+    return `${idRef}${typeInfo} — ${issue.issueId}${severity}${fixable}`;
+}
+//# sourceMappingURL=audit-formatter.js.map

package/dist/cli/formatters/audit-formatter.js.map

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

package/dist/cli/formatters/json.d.ts

@@ -0,0 +1,10 @@
+import type { FormattableData } from './table';
+/**
+ * Format structured data as JSON.
+ *
+ * @param data - The data to format
+ * @param entityType - Optional entity type hint for the JSON wrapper key
+ * @returns Formatted JSON string
+ */
+export declare function formatAsJson(data: FormattableData, entityType?: string): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/cli/formatters/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/cli/formatters/json.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,eAAe,EACrB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAmBR"}

package/dist/cli/formatters/json.js

@@ -0,0 +1,31 @@
+"use strict";
+// JSON formatter
+// Renders structured data as valid JSON documents
+// Implements AD-0013: Strategy Pattern for Output Formatters
+// + FS-SS-007-0006 (JSON output formatter)
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatAsJson = formatAsJson;
+/**
+ * Format structured data as JSON.
+ *
+ * @param data - The data to format
+ * @param entityType - Optional entity type hint for the JSON wrapper key
+ * @returns Formatted JSON string
+ */
+function formatAsJson(data, entityType) {
+    if (data === null || data === undefined) {
+        return JSON.stringify({ result: null });
+    }
+    if (typeof data === 'string') {
+        return JSON.stringify({ result: data });
+    }
+    if (entityType) {
+        return JSON.stringify({ [entityType]: data }, null, 2);
+    }
+    // Wrap array or object in a result key
+    if (Array.isArray(data)) {
+        return JSON.stringify({ results: data, count: data.length }, null, 2);
+    }
+    return JSON.stringify({ result: data }, null, 2);
+}
+//# sourceMappingURL=json.js.map

package/dist/cli/formatters/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/cli/formatters/json.ts"],"names":[],"mappings":";AAAA,iBAAiB;AACjB,kDAAkD;AAClD,6DAA6D;AAC7D,2CAA2C;;AAW3C,oCAsBC;AA7BD;;;;;;GAMG;AACH,SAAgB,YAAY,CAC1B,IAAqB,EACrB,UAAmB;IAEnB,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,uCAAuC;IACvC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/cli/formatters/markdown.d.ts

@@ -0,0 +1,12 @@
+import type { FormattableData } from './table';
+/**
+ * Format structured entity data as Markdown, dispatching on entity type.
+ * All five entity show commands share this formatter.
+ *
+ * @param data - Entity data to format
+ * @param entityType - Entity type hint ('document', 'review', 'task', 'test-report', 'lesson')
+ * @returns Formatted Markdown string
+ * @throws CortexError if entityType is not one of the five supported types
+ */
+export declare function formatAsMarkdown(data: FormattableData, entityType?: string): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/cli/formatters/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../src/cli/formatters/markdown.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAqT/C;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,eAAe,EACrB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAyCR"}