mustflow 1.30.0 → 2.11.0

package/dist/cli/index.js

@@ -2,29 +2,6 @@
 import { realpathSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { runAdapters } from './commands/adapters.js';
-import { runCheck } from './commands/check.js';
-import { runClassify } from './commands/classify.js';
-import { runContractLint } from './commands/contract-lint.js';
-import { runContext } from './commands/context.js';
-import { runDashboard } from './commands/dashboard.js';
-import { runDoctor } from './commands/doctor.js';
-import { runDocs } from './commands/docs.js';
-import { runExplain } from './commands/explain.js';
-import { runHelp } from './commands/help.js';
-import { runHandoff } from './commands/handoff.js';
-import { runImpact } from './commands/impact.js';
-import { runInit } from './commands/init.js';
-import { runIndex } from './commands/index.js';
-import { runLineEndings } from './commands/line-endings.js';
-import { runMap } from './commands/map.js';
-import { runRun } from './commands/run.js';
-import { runSearch } from './commands/search.js';
-import { runStatus } from './commands/status.js';
-import { runUpdate } from './commands/update.js';
-import { runVerify } from './commands/verify.js';
-import { runVersion } from './commands/version.js';
-import { runVersionSources } from './commands/version-sources.js';
 import { COMMAND_DEFINITIONS } from './lib/command-registry.js';
 import { renderCliError, renderHelp } from './lib/cli-output.js';
 import { DEFAULT_CLI_LANG, SUPPORTED_CLI_LANGS, isCliLang, t } from './lib/i18n.js';
@@ -59,6 +36,7 @@ function getTopLevelHelp(lang) {
             'mf search mustflow_check',
             'mf explain authority AGENTS.md',
             'mf impact --changed',
+            'mf upgrade --dry-run',
             'mf verify --changed --plan-only --json',
             'mf verify --reason code_change',
             'mf line-endings check',
@@ -125,73 +103,76 @@ export async function runCli(argv, reporter = consoleReporter) {
         return 0;
     }
     if (command === '--version' || command === '-v' || command === 'version') {
-        return runVersion(args, reporter, parsed.lang);
+        return (await import('./commands/version.js')).runVersion(args, reporter, parsed.lang);
     }
     if (command === 'init') {
-        return runInit(args, reporter, parsed.lang);
+        return (await import('./commands/init.js')).runInit(args, reporter, parsed.lang);
     }
     if (command === 'adapters') {
-        return runAdapters(args, reporter, parsed.lang);
+        return (await import('./commands/adapters.js')).runAdapters(args, reporter, parsed.lang);
     }
     if (command === 'check') {
-        return runCheck(args, reporter, parsed.lang);
+        return (await import('./commands/check.js')).runCheck(args, reporter, parsed.lang);
     }
     if (command === 'classify') {
-        return runClassify(args, reporter, parsed.lang);
+        return (await import('./commands/classify.js')).runClassify(args, reporter, parsed.lang);
     }
     if (command === 'contract-lint') {
-        return runContractLint(args, reporter, parsed.lang);
+        return (await import('./commands/contract-lint.js')).runContractLint(args, reporter, parsed.lang);
     }
     if (command === 'status') {
-        return runStatus(args, reporter, parsed.lang);
+        return (await import('./commands/status.js')).runStatus(args, reporter, parsed.lang);
     }
     if (command === 'update') {
-        return runUpdate(args, reporter, parsed.lang);
+        return (await import('./commands/update.js')).runUpdate(args, reporter, parsed.lang);
+    }
+    if (command === 'upgrade') {
+        return (await import('./commands/upgrade.js')).runUpgrade(args, reporter, parsed.lang);
     }
     if (command === 'map') {
-        return runMap(args, reporter, parsed.lang);
+        return (await import('./commands/map.js')).runMap(args, reporter, parsed.lang);
     }
     if (command === 'line-endings') {
-        return runLineEndings(args, reporter, parsed.lang);
+        return (await import('./commands/line-endings.js')).runLineEndings(args, reporter, parsed.lang);
     }
     if (command === 'run') {
-        return runRun(args, reporter, parsed.lang);
+        return (await import('./commands/run.js')).runRun(args, reporter, parsed.lang);
     }
     if (command === 'context') {
-        return runContext(args, reporter, parsed.lang);
+        return (await import('./commands/context.js')).runContext(args, reporter, parsed.lang);
     }
     if (command === 'doctor') {
-        return runDoctor(args, reporter, parsed.lang);
+        return (await import('./commands/doctor.js')).runDoctor(args, reporter, parsed.lang);
     }
     if (command === 'docs') {
-        return runDocs(args, reporter, parsed.lang);
+        return (await import('./commands/docs.js')).runDocs(args, reporter, parsed.lang);
     }
     if (command === 'handoff') {
-        return runHandoff(args, reporter, parsed.lang);
+        return (await import('./commands/handoff.js')).runHandoff(args, reporter, parsed.lang);
     }
     if (command === 'index') {
-        return runIndex(args, reporter, parsed.lang);
+        return (await import('./commands/index.js')).runIndex(args, reporter, parsed.lang);
     }
     if (command === 'search') {
-        return runSearch(args, reporter, parsed.lang);
+        return (await import('./commands/search.js')).runSearch(args, reporter, parsed.lang);
     }
     if (command === 'dashboard') {
-        return runDashboard(args, reporter, parsed.lang);
+        return (await import('./commands/dashboard.js')).runDashboard(args, reporter, parsed.lang);
     }
     if (command === 'version-sources') {
-        return runVersionSources(args, reporter, parsed.lang);
+        return (await import('./commands/version-sources.js')).runVersionSources(args, reporter, parsed.lang);
     }
     if (command === 'verify') {
-        return runVerify(args, reporter, parsed.lang);
+        return (await import('./commands/verify.js')).runVerify(args, reporter, parsed.lang);
     }
     if (command === 'explain') {
-        return runExplain(args, reporter, parsed.lang);
+        return (await import('./commands/explain.js')).runExplain(args, reporter, parsed.lang);
     }
     if (command === 'impact') {
-        return runImpact(args, reporter, parsed.lang);
+        return (await import('./commands/impact.js')).runImpact(args, reporter, parsed.lang);
     }
     if (command === 'help') {
-        return runHelp(args, reporter, parsed.lang);
+        return (await import('./commands/help.js')).runHelp(args, reporter, parsed.lang);
     }
     reporter.stderr(renderCliError(t(parsed.lang, 'cli.error.unknownCommand', { command }), 'mf --help', parsed.lang));
     reporter.stdout(getTopLevelHelp(parsed.lang));

package/dist/cli/lib/command-registry.js

@@ -34,6 +34,11 @@ export const COMMAND_DEFINITIONS = [
         usage: 'mf update',
         summaryKey: 'command.update.summary',
     },
+    {
+        id: 'upgrade',
+        usage: 'mf upgrade',
+        summaryKey: 'command.upgrade.summary',
+    },
     {
         id: 'map',
         usage: 'mf map',

package/dist/cli/lib/dashboard-export.js

@@ -1,5 +1,7 @@
 import { Buffer } from 'node:buffer';
 import path from 'node:path';
+import { createDashboardCompletionVerdict } from '../../core/completion-verdict.js';
+import { createDashboardEvidenceModel } from '../../core/verification-evidence.js';
 import { redactSecretLikeText } from '../../core/secret-redaction.js';
 import { ensureFileTargetInsideWithoutSymlinks, ensureInside, toPosixPath, writeUtf8FileInsideWithoutSymlinks, } from './filesystem.js';
 export class DashboardExportPathError extends Error {
@@ -380,6 +382,56 @@ function createDashboardHarnessReport(statusValue, docsReviewValue) {
         .map((entry) => stringOrNull(entry.intent))
         .filter((entry) => entry !== null)
         .slice(0, DASHBOARD_HARNESS_MAX_ITEMS);
+    const skippedIntents = asArray(verification.skipped)
+        .map(asRecord)
+        .map((entry) => ({
+        intent: text(entry.intent),
+        reason_key: text(entry.reason_key),
+    }))
+        .slice(0, DASHBOARD_HARNESS_MAX_ITEMS);
+    const verificationGaps = createVerificationGaps(verification.decision_graph);
+    const runHistory = createRunHistorySummary(status);
+    const changedFileCount = stringArray(verification.changed_files).length;
+    const changedSurfaces = stringArray(verification.surfaces);
+    const remainingRisks = createRemainingRisks(status, docsReview, decisionGraphSummary);
+    const completionVerdict = createDashboardCompletionVerdict({
+        changedFileCount,
+        runnableIntentCount: runnableIntents.length,
+        skippedIntentCount: skippedIntents.length,
+        gapCount: verificationGaps.length,
+        latestRunExists: runHistory.exists,
+        latestRunValid: runHistory.valid,
+        latestRunStatus: runHistory.status,
+    });
+    const evidenceModel = createDashboardEvidenceModel({
+        changedSurfaces,
+        runnableIntents,
+        skippedChecks: skippedIntents.map((entry) => ({
+            intent: entry.intent || null,
+            reason: entry.reason_key || null,
+            detail: null,
+        })),
+        gaps: verificationGaps.map((gap) => ({
+            reason: gap.reason,
+            intent: gap.intent,
+            status: gap.kind,
+            detail: gap.detail,
+            files: gap.files,
+            surfaces: gap.surfaces,
+        })),
+        latestReceipt: runHistory.exists && runHistory.valid
+            ? {
+                intent: runHistory.intent,
+                status: runHistory.status ?? 'unknown',
+                skipped: false,
+                verification_plan_id: null,
+                receipt_path: runHistory.receipt_path,
+                receipt_sha256: null,
+            }
+            : null,
+        remainingRisks,
+        verdict: completionVerdict,
+    });
     return {
         schema_version: '1',
         generated_from: 'dashboard_status_snapshot',
@@ -392,25 +444,21 @@ function createDashboardHarnessReport(statusValue, docsReviewValue) {
             issues: stringArray(status.issues).length,
         },
         verification: {
-            changed_file_count: stringArray(verification.changed_files).length,
-            changed_surfaces: stringArray(verification.surfaces),
+            completion_verdict: completionVerdict,
+            evidence_model: evidenceModel,
+            changed_file_count: changedFileCount,
+            changed_surfaces: changedSurfaces,
             decision_graph_summary: decisionGraphSummary,
             runnable_intents: runnableIntents,
-            skipped_intents: asArray(verification.skipped)
-                .map(asRecord)
-                .map((entry) => ({
-                intent: text(entry.intent),
-                reason_key: text(entry.reason_key),
-            }))
-                .slice(0, DASHBOARD_HARNESS_MAX_ITEMS),
-            gaps: createVerificationGaps(verification.decision_graph),
+            skipped_intents: skippedIntents,
+            gaps: verificationGaps,
         },
-        run_history: createRunHistorySummary(status),
+        run_history: runHistory,
         docs_review: {
             ledger_path: text(docsReview.ledger_path),
             active_documents: numberOrZero(docsReview.count),
         },
-        remaining_risks: createRemainingRisks(status, docsReview, decisionGraphSummary),
+        remaining_risks: remainingRisks,
     };
 }
 export function resolveDashboardExportPath(projectRoot, outputPath) {
@@ -582,6 +630,7 @@ export function renderDashboardExportHtml(snapshot) {
     const harnessReport = asRecord(snapshot.harness_report);
     const harnessInstall = asRecord(harnessReport.install);
     const harnessVerification = asRecord(harnessReport.verification);
+    const completionVerdict = asRecord(harnessVerification.completion_verdict);
     const graphSummary = asRecord(harnessVerification.decision_graph_summary);
     const harnessRunHistory = asRecord(harnessReport.run_history);
     const harnessDocsReview = asRecord(harnessReport.docs_review);
@@ -676,6 +725,7 @@ ul { margin: 0; padding-left: 22px; }
         renderMetric('Tracked files', harnessInstall.tracked_files),
         renderMetric('Changed files', harnessVerification.changed_file_count),
         renderMetric('Changed surfaces', asArray(harnessVerification.changed_surfaces).join(', ') || 'none'),
+        renderMetric('Completion verdict', completionVerdict.status),
         renderMetric('Runnable verification intents', asArray(harnessVerification.runnable_intents).length),
         renderMetric('Skipped verification intents', asArray(harnessVerification.skipped_intents).length),
         renderMetric('Verification gaps', asArray(harnessVerification.gaps).length),