hadara 0.1.0-rc.0

package/dist/services/operations-status-service.js

@@ -0,0 +1,195 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOpsStatusReport = createOpsStatusReport;
+exports.formatOpsStatusReport = formatOpsStatusReport;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const active_run_state_1 = require("./active-run-state");
+const operational_debt_1 = require("./operational-debt");
+const project_read_model_1 = require("./project-read-model");
+const task_capsule_1 = require("../task/task-capsule");
+function createOpsStatusReport(projectRoot) {
+    const sources = (0, project_read_model_1.readProjectSources)(projectRoot);
+    const tasks = (0, task_capsule_1.listTaskCapsules)(projectRoot);
+    const taskCounts = countTaskStatuses(tasks);
+    const handoffSections = {
+        currentState: extractListSection(sources.handoff.content, '## Current State'),
+        knownProblems: extractListSection(sources.handoff.content, '## Current Known Problems'),
+        nextRecommendedStep: extractListSection(sources.handoff.content, '## Next Recommended Step')
+    };
+    const validation = {
+        latestFullCheck: extractValidationLine(sources.handoff.content, 'Latest full check') ?? extractValidationHistoryLine(sources.validationHistory.content, 'Docker check'),
+        latestDoneLevelValidation: extractValidationLine(sources.handoff.content, 'Latest done-level validation') ??
+            extractValidationHistoryLine(sources.validationHistory.content, 'harness validate')
+    };
+    const activeRun = (0, active_run_state_1.safeCreateActiveRunProjection)(projectRoot);
+    const debt = (0, operational_debt_1.createOperationalDebtReport)(projectRoot);
+    const issues = [...collectIssues(sources, validation), ...activeRun.issues];
+    return {
+        schemaVersion: 'hadara.ops.status.v1',
+        command: 'ops.status',
+        ok: true,
+        health: issues.some((issue) => issue.severity === 'error') ? 'error' : issues.length > 0 ? 'degraded' : 'ok',
+        project: {
+            branch: readGitBranch(projectRoot),
+            phase: extractProjectPhase(sources.projectState.content)
+        },
+        tasks: {
+            counts: taskCounts.counts,
+            rawStatusCounts: taskCounts.rawStatusCounts,
+            normalizedStatusCounts: taskCounts.normalizedStatusCounts,
+            lastCompleted: extractLastCompletedTaskIds(sources.handoff.content),
+            nextRecommended: handoffSections.nextRecommendedStep[0] ?? null
+        },
+        handoff: handoffSections,
+        validation,
+        activeRun,
+        debt: debt.aggregate,
+        mcp: {
+            defaultMode: 'read-only',
+            evidenceAttach: {
+                enabledByDefault: false,
+                requiresFlag: '--enable-evidence-attach',
+                requiresApproval: true,
+                audited: true
+            }
+        },
+        issues
+    };
+}
+function formatOpsStatusReport(report) {
+    const counts = Object.entries(report.tasks.counts)
+        .map(([status, count]) => `${status}: ${count}`)
+        .join(', ');
+    return [
+        '[HADARA] Operations Status',
+        `phase: ${report.project.phase}`,
+        `branch: ${report.project.branch}`,
+        `tasks: ${counts}`,
+        `debt: open ${report.debt.open}, highOpen ${report.debt.highOpen}`,
+        `lastCompleted: ${report.tasks.lastCompleted.join(', ') || 'none'}`,
+        `nextRecommended: ${report.tasks.nextRecommended ?? 'none'}`
+    ].join('\n');
+}
+function readGitBranch(projectRoot) {
+    const headPath = node_path_1.default.join(projectRoot, '.git', 'HEAD');
+    if (!node_fs_1.default.existsSync(headPath))
+        return 'unknown';
+    const head = node_fs_1.default.readFileSync(headPath, 'utf8').trim();
+    const refPrefix = 'ref: refs/heads/';
+    if (head.startsWith(refPrefix))
+        return head.slice(refPrefix.length);
+    return head.length > 0 ? 'detached' : 'unknown';
+}
+function extractProjectPhase(projectState) {
+    const section = (0, project_read_model_1.extractSection)(projectState, '## Current Phase');
+    const line = section
+        .split(/\r?\n/)
+        .map((value) => value.trim())
+        .find(Boolean);
+    if (!line)
+        return 'unknown';
+    const explicit = line.match(/^Phase:\s*(.+)$/i);
+    if (explicit)
+        return explicit[1].trim();
+    if (/Phase 0\s*\/\s*Phase 1 boundary/i.test(line))
+        return 'bootstrap-development';
+    return line;
+}
+function countTaskStatuses(tasks) {
+    const counts = {
+        done: 0,
+        draft: 0,
+        partial: 0,
+        superseded: 0,
+        inProgress: 0,
+        unknown: 0
+    };
+    const rawStatusCounts = {};
+    const normalizedStatusCounts = {};
+    for (const task of tasks) {
+        const rawStatus = readTaskStatus(task);
+        const normalizedStatus = normalizeStatus(rawStatus);
+        const aggregate = aggregateStatus(normalizedStatus);
+        counts[aggregate] += 1;
+        rawStatusCounts[rawStatus] = (rawStatusCounts[rawStatus] ?? 0) + 1;
+        normalizedStatusCounts[normalizedStatus] = (normalizedStatusCounts[normalizedStatus] ?? 0) + 1;
+    }
+    return { counts, rawStatusCounts, normalizedStatusCounts };
+}
+function readTaskStatus(task) {
+    const taskPath = node_path_1.default.join(task.dir, 'TASK.md');
+    if (!node_fs_1.default.existsSync(taskPath))
+        return 'Unknown';
+    const content = node_fs_1.default.readFileSync(taskPath, 'utf8');
+    const match = content.match(/^## Status\s*\n+([\s\S]*?)(?:\n## |\s*$)/m);
+    return match?.[1]?.trim().split(/\r?\n/)[0]?.trim() || 'Unknown';
+}
+function normalizeStatus(status) {
+    const value = status.trim().toLowerCase().replace(/[\s_-]+(.)/g, (_match, letter) => letter.toUpperCase());
+    return value || 'unknown';
+}
+function aggregateStatus(status) {
+    if (status === 'done')
+        return 'done';
+    if (status === 'draft')
+        return 'draft';
+    if (status === 'partial')
+        return 'partial';
+    if (status === 'superseded')
+        return 'superseded';
+    if (status === 'inProgress' || status === 'active' || status === 'doing')
+        return 'inProgress';
+    return 'unknown';
+}
+function extractLastCompletedTaskIds(handoff) {
+    return extractListSection(handoff, '## Last 3 Completed Tasks')
+        .map((line) => line.match(/^(T-\d{4})\b/)?.[1])
+        .filter((value) => Boolean(value));
+}
+function extractValidationLine(handoff, label) {
+    const validation = extractListSection(handoff, '## Validation Baseline');
+    const prefix = `${label}:`;
+    const line = validation.find((item) => item.startsWith(prefix));
+    return line ? line.slice(prefix.length).trim().replace(/\.$/, '') : null;
+}
+function extractValidationHistoryLine(validationHistory, pattern) {
+    const lines = validationHistory
+        .split(/\r?\n/)
+        .map((line) => line.trim().replace(/^[-*]\s+/, ''))
+        .filter((line) => line.includes(pattern));
+    return lines.at(-1)?.replace(/\.$/, '') ?? null;
+}
+function collectIssues(sources, validation) {
+    const issues = [];
+    if (!sources.projectState.exists)
+        issues.push(warning('PROJECT_STATE_MISSING', 'docs/PROJECT_STATE.md is missing.'));
+    if (!sources.handoff.exists)
+        issues.push(warning('AGENT_HANDOFF_MISSING', 'docs/AGENT_HANDOFF.md is missing.'));
+    if (!sources.taskBoard.exists)
+        issues.push(warning('TASK_BOARD_MISSING', 'docs/TASK_BOARD.md is missing.'));
+    if (!sources.developmentSlices.exists)
+        issues.push(warning('DEVELOPMENT_SLICES_MISSING', 'docs/DEVELOPMENT_SLICES.md is missing.'));
+    if (!validation.latestFullCheck && !validation.latestDoneLevelValidation) {
+        issues.push(warning('VALIDATION_BASELINE_MISSING', 'No latest validation baseline was found in handoff or validation history.'));
+    }
+    return issues;
+}
+function warning(code, message) {
+    return {
+        severity: 'warning',
+        code,
+        message
+    };
+}
+function extractListSection(content, heading) {
+    return (0, project_read_model_1.extractSection)(content, heading)
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .map((line) => line.replace(/^[-*]\s+/, '').replace(/^\d+\.\s+/, '').trim())
+        .filter(Boolean);
+}