@brainfile/cli 0.15.1 → 0.16.0

package/dist/commands/ledger-rebuild.js

@@ -0,0 +1,287 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ledgerRebuildCommand = ledgerRebuildCommand;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const chalk_1 = __importDefault(require("chalk"));
+const dist_1 = require("../../../core/dist");
+const logger_1 = require("../utils/logger");
+const cli_error_1 = require("../utils/cli-error");
+const brainfile_path_1 = require("../utils/brainfile-path");
+const v2_detect_1 = require("../utils/v2-detect");
+const COMMIT_MARKER = '__COMMIT__';
+const REBUILT_SUMMARY = 'Rebuilt from git history';
+function runGit(args, cwd) {
+    const result = (0, child_process_1.spawnSync)('git', args, {
+        cwd,
+        encoding: 'utf-8',
+    });
+    return {
+        ok: !result.error && result.status === 0,
+        stdout: typeof result.stdout === 'string' ? result.stdout : '',
+        stderr: typeof result.stderr === 'string' ? result.stderr : '',
+    };
+}
+function normalizeGitPath(value) {
+    return value.replace(/\\/g, '/').replace(/^\.\//, '').trim();
+}
+function isPathWithinDirectory(filePath, directory) {
+    return filePath === directory || filePath.startsWith(`${directory}/`);
+}
+function isTaskMarkdownInDirectory(filePath, directory) {
+    return filePath.endsWith('.md') && isPathWithinDirectory(filePath, directory);
+}
+function toRepoRelativePath(repoRoot, targetPath) {
+    const relative = normalizeGitPath(path.relative(repoRoot, targetPath));
+    if (!relative || relative.startsWith('..')) {
+        throw (0, cli_error_1.operationFailed)(`Path is outside the git repository: ${targetPath}`);
+    }
+    return relative;
+}
+function resolveRepoRoot(startDir) {
+    const result = runGit(['rev-parse', '--show-toplevel'], startDir);
+    if (!result.ok) {
+        throw (0, cli_error_1.operationFailed)('ledger rebuild requires a git repository');
+    }
+    const repoRoot = result.stdout.trim();
+    if (!repoRoot) {
+        throw (0, cli_error_1.operationFailed)('Failed to resolve git repository root for ledger rebuild');
+    }
+    return path.resolve(repoRoot);
+}
+function parseCompletionEvents(logOutput, boardRel, logsRel) {
+    const events = [];
+    let currentCommit = '';
+    let currentCompletedAt = '';
+    for (const rawLine of logOutput.split('\n')) {
+        const line = rawLine.trim();
+        if (!line) {
+            continue;
+        }
+        if (line.startsWith(COMMIT_MARKER)) {
+            const payload = line.slice(COMMIT_MARKER.length);
+            const separatorIndex = payload.indexOf('|');
+            if (separatorIndex === -1) {
+                currentCommit = '';
+                currentCompletedAt = '';
+                continue;
+            }
+            currentCommit = payload.slice(0, separatorIndex).trim();
+            currentCompletedAt = payload.slice(separatorIndex + 1).trim();
+            continue;
+        }
+        if (!currentCommit) {
+            continue;
+        }
+        const parts = rawLine.split('\t');
+        if (parts.length < 2) {
+            continue;
+        }
+        const status = parts[0].trim();
+        if (status === 'D') {
+            const deletedPath = normalizeGitPath(parts[1] || '');
+            if (!isTaskMarkdownInDirectory(deletedPath, boardRel)) {
+                continue;
+            }
+            events.push({
+                commit: currentCommit,
+                completedAt: currentCompletedAt,
+                sourcePath: deletedPath,
+            });
+            continue;
+        }
+        if (!status.startsWith('R') || parts.length < 3) {
+            continue;
+        }
+        const sourcePath = normalizeGitPath(parts[1] || '');
+        const targetPath = normalizeGitPath(parts[2] || '');
+        if (!isTaskMarkdownInDirectory(sourcePath, boardRel)) {
+            continue;
+        }
+        if (!isTaskMarkdownInDirectory(targetPath, logsRel)) {
+            continue;
+        }
+        events.push({
+            commit: currentCommit,
+            completedAt: currentCompletedAt,
+            sourcePath,
+            targetPath,
+        });
+    }
+    return events;
+}
+function scanCompletionEvents(repoRoot, boardRel, logsRel) {
+    const result = runGit([
+        'log',
+        '--reverse',
+        '--date=iso-strict',
+        `--pretty=format:${COMMIT_MARKER}%H|%cI`,
+        '--name-status',
+        '--find-renames',
+        '--',
+        boardRel,
+        logsRel,
+    ], repoRoot);
+    if (!result.ok) {
+        const details = result.stderr.trim();
+        throw (0, cli_error_1.operationFailed)(details
+            ? `Failed to scan git history for ledger rebuild: ${details}`
+            : 'Failed to scan git history for ledger rebuild');
+    }
+    return parseCompletionEvents(result.stdout, boardRel, logsRel);
+}
+function parseIsoDate(value) {
+    if (!value) {
+        return undefined;
+    }
+    const parsed = Date.parse(value);
+    if (!Number.isFinite(parsed)) {
+        return undefined;
+    }
+    return new Date(parsed).toISOString();
+}
+function readTaskFromHistory(event, repoRoot) {
+    const showSpecs = [`${event.commit}^:${event.sourcePath}`, `${event.commit}:${event.sourcePath}`];
+    if (event.targetPath) {
+        showSpecs.push(`${event.commit}:${event.targetPath}`);
+    }
+    for (const showSpec of showSpecs) {
+        const result = runGit(['show', showSpec], repoRoot);
+        if (!result.ok || !result.stdout) {
+            continue;
+        }
+        const parsed = (0, dist_1.parseTaskContent)(result.stdout);
+        if (parsed) {
+            return parsed;
+        }
+    }
+    return null;
+}
+function inferFilesChangedFromCommit(repoRoot, commit, boardRel, logsRel) {
+    const result = runGit(['show', '--pretty=format:', '--name-only', commit], repoRoot);
+    if (!result.ok) {
+        return [];
+    }
+    const filesChanged = [];
+    const seen = new Set();
+    for (const line of result.stdout.split('\n')) {
+        const normalized = normalizeGitPath(line);
+        if (!normalized || seen.has(normalized)) {
+            continue;
+        }
+        if (isTaskMarkdownInDirectory(normalized, boardRel)) {
+            continue;
+        }
+        if (isTaskMarkdownInDirectory(normalized, logsRel)) {
+            continue;
+        }
+        if (normalized === `${logsRel}/ledger.jsonl`) {
+            continue;
+        }
+        seen.add(normalized);
+        filesChanged.push(normalized);
+    }
+    return filesChanged;
+}
+function buildRebuiltRecord(task, body, completedAt, filesChanged) {
+    const record = (0, dist_1.buildLedgerRecord)(task, body, {
+        completedAt,
+        summary: REBUILT_SUMMARY,
+        filesChanged: filesChanged.length > 0 ? filesChanged : undefined,
+    });
+    // For rebuilds, preserve strict semantics: either inferred files or empty array.
+    record.summary = REBUILT_SUMMARY;
+    record.filesChanged = filesChanged;
+    return record;
+}
+function writeLedger(logsDir, records) {
+    fs.mkdirSync(logsDir, { recursive: true });
+    const ledgerPath = path.join(logsDir, 'ledger.jsonl');
+    const jsonl = records.map((record) => JSON.stringify(record)).join('\n');
+    fs.writeFileSync(ledgerPath, jsonl ? `${jsonl}\n` : '', 'utf-8');
+    return ledgerPath;
+}
+/**
+ * Rebuild `logs/ledger.jsonl` from git history.
+ */
+function ledgerRebuildCommand(options, logger = logger_1.defaultLogger) {
+    const filePath = (0, brainfile_path_1.resolveCliBrainfilePath)(options.file);
+    if (!fs.existsSync(filePath)) {
+        throw (0, cli_error_1.fileNotFound)(filePath);
+    }
+    if (!(0, v2_detect_1.isV2)(filePath)) {
+        throw (0, cli_error_1.operationFailed)('ledger rebuild requires v2 per-task file architecture. Run: brainfile migrate');
+    }
+    const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
+    const repoRoot = resolveRepoRoot(path.dirname(filePath));
+    const boardRel = toRepoRelativePath(repoRoot, dirs.boardDir);
+    const logsRel = toRepoRelativePath(repoRoot, dirs.logsDir);
+    const events = scanCompletionEvents(repoRoot, boardRel, logsRel);
+    const records = [];
+    let skipped = 0;
+    for (const event of events) {
+        const parsedTask = readTaskFromHistory(event, repoRoot);
+        if (!parsedTask) {
+            skipped += 1;
+            continue;
+        }
+        const completedAt = parseIsoDate(event.completedAt) ||
+            parseIsoDate(parsedTask.task.completedAt) ||
+            new Date().toISOString();
+        const filesChanged = inferFilesChangedFromCommit(repoRoot, event.commit, boardRel, logsRel);
+        const record = buildRebuiltRecord(parsedTask.task, parsedTask.body, completedAt, filesChanged);
+        records.push(record);
+    }
+    const ledgerPath = writeLedger(dirs.logsDir, records);
+    const relativeLedgerPath = path.relative(path.dirname(filePath), ledgerPath) || ledgerPath;
+    logger.log(chalk_1.default.green('Ledger rebuild complete.'));
+    logger.log('');
+    logger.log(chalk_1.default.gray(`  Rebuilt: ${records.length}`));
+    logger.log(chalk_1.default.gray(`  Skipped: ${skipped}`));
+    logger.log(chalk_1.default.gray(`  Ledger:  ${relativeLedgerPath}`));
+    return {
+        success: true,
+        rebuilt: records.length,
+        skipped,
+        ledgerPath,
+        records,
+    };
+}
+//# sourceMappingURL=ledger-rebuild.js.map

package/dist/commands/ledger-rebuild.js.map

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

package/dist/commands/ledger.d.ts

@@ -0,0 +1,20 @@
+import { type LedgerRecord } from '../../../core/dist';
+import { type Logger } from '../utils/logger';
+export interface LedgerOptions {
+    file: string;
+    assignee?: string;
+    since?: string;
+    until?: string;
+    tag?: string;
+    contractStatus?: string;
+}
+export interface LedgerResult {
+    success: true;
+    count: number;
+    records: LedgerRecord[];
+}
+/**
+ * Query append-only completion ledger records.
+ */
+export declare function ledgerCommand(options: LedgerOptions, logger?: Logger): LedgerResult;
+//# sourceMappingURL=ledger.d.ts.map

package/dist/commands/ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../../src/commands/ledger.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,iBAAiB,CAAC;AAM7D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAqDD;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,GAAE,MAAsB,GAAG,YAAY,CA0BlG"}

package/dist/commands/ledger.js

@@ -0,0 +1,111 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ledgerCommand = ledgerCommand;
+const fs = __importStar(require("fs"));
+const chalk_1 = __importDefault(require("chalk"));
+const dist_1 = require("../../../core/dist");
+const logger_1 = require("../utils/logger");
+const cli_error_1 = require("../utils/cli-error");
+const brainfile_path_1 = require("../utils/brainfile-path");
+const v2_detect_1 = require("../utils/v2-detect");
+const date_helpers_1 = require("../utils/date-helpers");
+function normalizeContractStatus(value) {
+    if (!value) {
+        return undefined;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (!(0, dist_1.isLedgerContractStatus)(normalized)) {
+        throw (0, cli_error_1.validationError)(`--contract-status must be one of: ${dist_1.LEDGER_CONTRACT_STATUSES.join(', ')} (received: ${value})`);
+    }
+    return normalized;
+}
+function displayLedgerRecords(records, logger) {
+    logger.log('');
+    logger.log(chalk_1.default.bold(`Ledger records (${records.length})`));
+    logger.log(chalk_1.default.gray('─'.repeat(60)));
+    if (records.length === 0) {
+        logger.log(chalk_1.default.gray('  No matching records found.'));
+        logger.log('');
+        return;
+    }
+    for (const record of records) {
+        logger.log(`  ${chalk_1.default.gray(`[${record.id}]`)} ${chalk_1.default.white(record.title)} ${chalk_1.default.cyan(`(${record.type})`)}`);
+        logger.log(`    ${chalk_1.default.gray('Completed:')} ${record.completedAt} ${chalk_1.default.gray('Cycle:')} ${record.cycleTimeHours.toFixed(2)}h`);
+        if (record.assignee) {
+            logger.log(`    ${chalk_1.default.gray('Assignee:')} ${chalk_1.default.white(record.assignee)}`);
+        }
+        if (record.contractStatus) {
+            logger.log(`    ${chalk_1.default.gray('Contract:')} ${chalk_1.default.white(record.contractStatus)}`);
+        }
+        if (record.tags && record.tags.length > 0) {
+            logger.log(`    ${chalk_1.default.gray('Tags:')} ${record.tags.map((tag) => `#${tag}`).join(' ')}`);
+        }
+        if (record.filesChanged.length > 0) {
+            logger.log(`    ${chalk_1.default.gray('Files:')} ${record.filesChanged.join(', ')}`);
+        }
+        logger.log(`    ${chalk_1.default.gray('Summary:')} ${record.summary}`);
+        logger.log('');
+    }
+}
+/**
+ * Query append-only completion ledger records.
+ */
+function ledgerCommand(options, logger = logger_1.defaultLogger) {
+    const filePath = (0, brainfile_path_1.resolveCliBrainfilePath)(options.file);
+    if (!fs.existsSync(filePath)) {
+        throw (0, cli_error_1.fileNotFound)(filePath);
+    }
+    if (!(0, v2_detect_1.isV2)(filePath)) {
+        throw (0, cli_error_1.operationFailed)('Ledger command requires v2 per-task file architecture. Run: brainfile migrate');
+    }
+    const dateRange = (0, date_helpers_1.buildDateRange)(options.since, options.until);
+    const contractStatus = normalizeContractStatus(options.contractStatus);
+    const assignee = options.assignee?.trim();
+    const tag = options.tag?.trim();
+    const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
+    const records = (0, dist_1.queryLedger)(dirs.logsDir, {
+        assignee: assignee || undefined,
+        tags: tag ? [tag] : undefined,
+        dateRange,
+        contractStatus,
+    }).sort((left, right) => right.completedAt.localeCompare(left.completedAt));
+    displayLedgerRecords(records, logger);
+    return { success: true, count: records.length, records };
+}
+//# sourceMappingURL=ledger.js.map

package/dist/commands/ledger.js.map

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

package/dist/commands/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAyEA,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AA4GD,wBAAsB,UAAU,CAAC,OAAO,EAAE,UAAU,iBAuzEnD"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAgFA,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAkMD,wBAAsB,UAAU,CAAC,OAAO,EAAE,UAAU,iBA4oFnD"}