mustflow 2.18.2 → 2.18.3

package/dist/cli/commands/verify.js

@@ -13,6 +13,7 @@ import { createVerifyEvidenceModel } from '../../core/verification-evidence.js';
 import { createScopeDiffRisks } from '../../core/scope-risk.js';
 import { countValidationRatchetVerdictEffects, createValidationRatchetRisks, } from '../../core/validation-ratchet.js';
 import { readCommandContract } from '../../core/config-loading.js';
+import { DEFAULT_VERIFY_PARALLELISM, parseVerifyArgs } from './verify/args.js';
 import { printUsageError, renderHelp } from '../lib/cli-output.js';
 import { t } from '../lib/i18n.js';
 import { readLocalCommandEffectGraph, readLocalPathSurfaces, readLocalSourceAnchorVerdictRisks, } from '../lib/local-index.js';
@@ -20,7 +21,6 @@ import { resolveMustflowRoot } from '../lib/project-root.js';
 const VERIFY_SCHEMA_VERSION = '1';
 const RUN_STATE_DIR = path.join('.mustflow', 'state', 'runs');
 const LATEST_RUN_RECEIPT_PATH = path.join(RUN_STATE_DIR, 'latest.json');
-const DEFAULT_VERIFY_PARALLELISM = 1;
 function createBufferedOutput() {
     const stdout = [];
     const stderr = [];
@@ -73,267 +73,6 @@ export function getVerifyHelp(lang = 'en') {
         ],
     }, lang);
 }
-function parseVerifyArgs(args) {
-    let reason;
-    let fromClassification;
-    let fromPlan;
-    let writePlan;
-    let reproEvidence;
-    let externalEvidence;
-    let json = false;
-    let planOnly = false;
-    let changed = false;
-    let parallelism = DEFAULT_VERIFY_PARALLELISM;
-    for (let index = 0; index < args.length; index += 1) {
-        const arg = args[index];
-        if (arg === '--json') {
-            json = true;
-            continue;
-        }
-        if (arg === '--plan-only') {
-            planOnly = true;
-            continue;
-        }
-        if (arg === '--changed') {
-            changed = true;
-            continue;
-        }
-        if (arg === '--parallel') {
-            const value = args[index + 1];
-            if (!value || value.startsWith('-')) {
-                return { json, planOnly, changed, reason, parallelism, error: 'missing_parallel_value' };
-            }
-            const parsedParallelism = parseVerifyParallelism(value);
-            if (parsedParallelism === null) {
-                return { json, planOnly, changed, reason, parallelism, error: 'invalid_parallel_value' };
-            }
-            parallelism = parsedParallelism;
-            index += 1;
-            continue;
-        }
-        if (arg === '--reason') {
-            const value = args[index + 1];
-            if (!value || value.startsWith('-')) {
-                return { json, planOnly, changed, reason, error: 'missing_reason_value' };
-            }
-            reason = value;
-            index += 1;
-            continue;
-        }
-        if (arg === '--from-plan') {
-            const value = args[index + 1];
-            if (!value || value.startsWith('-')) {
-                return { json, planOnly, changed, reason, fromClassification, fromPlan, error: 'missing_from_plan_value' };
-            }
-            fromPlan = value;
-            index += 1;
-            continue;
-        }
-        if (arg === '--from-classification') {
-            const value = args[index + 1];
-            if (!value || value.startsWith('-')) {
-                return {
-                    json,
-                    planOnly,
-                    changed,
-                    reason,
-                    fromClassification,
-                    fromPlan,
-                    error: 'missing_from_classification_value',
-                };
-            }
-            fromClassification = value;
-            index += 1;
-            continue;
-        }
-        if (arg === '--write-plan') {
-            const value = args[index + 1];
-            if (!value || value.startsWith('-')) {
-                return {
-                    json,
-                    planOnly,
-                    changed,
-                    reason,
-                    fromClassification,
-                    fromPlan,
-                    writePlan,
-                    error: 'missing_write_plan_value',
-                };
-            }
-            writePlan = value;
-            index += 1;
-            continue;
-        }
-        if (arg === '--external-evidence') {
-            const value = args[index + 1];
-            if (!value || value.startsWith('-')) {
-                return {
-                    json,
-                    planOnly,
-                    changed,
-                    reason,
-                    fromClassification,
-                    fromPlan,
-                    writePlan,
-                    externalEvidence,
-                    error: 'missing_external_evidence_value',
-                };
-            }
-            externalEvidence = value;
-            index += 1;
-            continue;
-        }
-        if (arg === '--repro-evidence') {
-            const value = args[index + 1];
-            if (!value || value.startsWith('-')) {
-                return {
-                    json,
-                    planOnly,
-                    changed,
-                    reason,
-                    fromClassification,
-                    fromPlan,
-                    writePlan,
-                    reproEvidence,
-                    externalEvidence,
-                    error: 'missing_repro_evidence_value',
-                };
-            }
-            reproEvidence = value;
-            index += 1;
-            continue;
-        }
-        if (arg.startsWith('--reason=')) {
-            const value = arg.slice('--reason='.length);
-            if (value.length === 0) {
-                return { json, planOnly, changed, reason, error: 'missing_reason_value' };
-            }
-            reason = value;
-            continue;
-        }
-        if (arg.startsWith('--parallel=')) {
-            const value = arg.slice('--parallel='.length);
-            const parsedParallelism = parseVerifyParallelism(value);
-            if (parsedParallelism === null) {
-                return { json, planOnly, changed, reason, parallelism, error: 'invalid_parallel_value' };
-            }
-            parallelism = parsedParallelism;
-            continue;
-        }
-        if (arg.startsWith('--from-plan=')) {
-            const value = arg.slice('--from-plan='.length);
-            if (value.length === 0) {
-                return { json, planOnly, changed, reason, fromClassification, fromPlan, error: 'missing_from_plan_value' };
-            }
-            fromPlan = value;
-            continue;
-        }
-        if (arg.startsWith('--from-classification=')) {
-            const value = arg.slice('--from-classification='.length);
-            if (value.length === 0) {
-                return {
-                    json,
-                    planOnly,
-                    changed,
-                    reason,
-                    fromClassification,
-                    fromPlan,
-                    error: 'missing_from_classification_value',
-                };
-            }
-            fromClassification = value;
-            continue;
-        }
-        if (arg.startsWith('--write-plan=')) {
-            const value = arg.slice('--write-plan='.length);
-            if (value.length === 0) {
-                return {
-                    json,
-                    planOnly,
-                    changed,
-                    reason,
-                    fromClassification,
-                    fromPlan,
-                    writePlan,
-                    error: 'missing_write_plan_value',
-                };
-            }
-            writePlan = value;
-            continue;
-        }
-        if (arg.startsWith('--external-evidence=')) {
-            const value = arg.slice('--external-evidence='.length);
-            if (value.length === 0) {
-                return {
-                    json,
-                    planOnly,
-                    changed,
-                    reason,
-                    fromClassification,
-                    fromPlan,
-                    writePlan,
-                    externalEvidence,
-                    error: 'missing_external_evidence_value',
-                };
-            }
-            externalEvidence = value;
-            continue;
-        }
-        if (arg.startsWith('--repro-evidence=')) {
-            const value = arg.slice('--repro-evidence='.length);
-            if (value.length === 0) {
-                return {
-                    json,
-                    planOnly,
-                    changed,
-                    reason,
-                    fromClassification,
-                    fromPlan,
-                    writePlan,
-                    reproEvidence,
-                    externalEvidence,
-                    error: 'missing_repro_evidence_value',
-                };
-            }
-            reproEvidence = value;
-            continue;
-        }
-        if (arg.startsWith('-')) {
-            return { json, planOnly, changed, reason, fromClassification, fromPlan, writePlan, reproEvidence, externalEvidence, error: arg };
-        }
-        return {
-            json,
-            planOnly,
-            changed,
-            reason,
-            fromClassification,
-            fromPlan,
-            writePlan,
-            reproEvidence,
-            externalEvidence,
-            error: `unexpected:${arg}`,
-        };
-    }
-    return {
-        json,
-        planOnly,
-        changed,
-        reason,
-        fromClassification,
-        fromPlan,
-        writePlan,
-        reproEvidence,
-        externalEvidence,
-        parallelism,
-    };
-}
-function parseVerifyParallelism(value) {
-    if (!/^[1-9][0-9]*$/u.test(value)) {
-        return null;
-    }
-    const parsed = Number(value);
-    return Number.isSafeInteger(parsed) ? parsed : null;
-}
 function uniqueStrings(values) {
     return [...new Set(values.map((value) => value.trim()).filter((value) => value.length > 0))];
 }

package/dist/cli/index.js

@@ -2,7 +2,7 @@
 import { realpathSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { COMMAND_DEFINITIONS } from './lib/command-registry.js';
+import { COMMAND_DEFINITIONS, findCommandDefinition } 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';
 import { consoleReporter } from './lib/reporter.js';
@@ -102,77 +102,11 @@ export async function runCli(argv, reporter = consoleReporter) {
         reporter.stdout(getTopLevelHelp(parsed.lang));
         return 0;
     }
-    if (command === '--version' || command === '-v' || command === 'version') {
-        return (await import('./commands/version.js')).runVersion(args, reporter, parsed.lang);
-    }
-    if (command === 'init') {
-        return (await import('./commands/init.js')).runInit(args, reporter, parsed.lang);
-    }
-    if (command === 'adapters') {
-        return (await import('./commands/adapters.js')).runAdapters(args, reporter, parsed.lang);
-    }
-    if (command === 'check') {
-        return (await import('./commands/check.js')).runCheck(args, reporter, parsed.lang);
-    }
-    if (command === 'classify') {
-        return (await import('./commands/classify.js')).runClassify(args, reporter, parsed.lang);
-    }
-    if (command === 'contract-lint') {
-        return (await import('./commands/contract-lint.js')).runContractLint(args, reporter, parsed.lang);
-    }
-    if (command === 'status') {
-        return (await import('./commands/status.js')).runStatus(args, reporter, parsed.lang);
-    }
-    if (command === 'update') {
-        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 (await import('./commands/map.js')).runMap(args, reporter, parsed.lang);
-    }
-    if (command === 'line-endings') {
-        return (await import('./commands/line-endings.js')).runLineEndings(args, reporter, parsed.lang);
-    }
-    if (command === 'run') {
-        return (await import('./commands/run.js')).runRun(args, reporter, parsed.lang);
-    }
-    if (command === 'context') {
-        return (await import('./commands/context.js')).runContext(args, reporter, parsed.lang);
-    }
-    if (command === 'doctor') {
-        return (await import('./commands/doctor.js')).runDoctor(args, reporter, parsed.lang);
-    }
-    if (command === 'docs') {
-        return (await import('./commands/docs.js')).runDocs(args, reporter, parsed.lang);
-    }
-    if (command === 'handoff') {
-        return (await import('./commands/handoff.js')).runHandoff(args, reporter, parsed.lang);
-    }
-    if (command === 'index') {
-        return (await import('./commands/index.js')).runIndex(args, reporter, parsed.lang);
-    }
-    if (command === 'search') {
-        return (await import('./commands/search.js')).runSearch(args, reporter, parsed.lang);
-    }
-    if (command === 'dashboard') {
-        return (await import('./commands/dashboard.js')).runDashboard(args, reporter, parsed.lang);
-    }
-    if (command === 'version-sources') {
-        return (await import('./commands/version-sources.js')).runVersionSources(args, reporter, parsed.lang);
-    }
-    if (command === 'verify') {
-        return (await import('./commands/verify.js')).runVerify(args, reporter, parsed.lang);
-    }
-    if (command === 'explain') {
-        return (await import('./commands/explain.js')).runExplain(args, reporter, parsed.lang);
-    }
-    if (command === 'impact') {
-        return (await import('./commands/impact.js')).runImpact(args, reporter, parsed.lang);
-    }
-    if (command === 'help') {
-        return (await import('./commands/help.js')).runHelp(args, reporter, parsed.lang);
+    const commandId = command === '--version' || command === '-v' ? 'version' : command;
+    const commandDefinition = findCommandDefinition(commandId);
+    if (commandDefinition) {
+        const runner = await commandDefinition.loadRunner();
+        return runner(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

@@ -3,120 +3,147 @@ export const COMMAND_DEFINITIONS = [
         id: 'adapters',
         usage: 'mf adapters',
         summaryKey: 'command.adapters.summary',
+        loadRunner: async () => (await import('../commands/adapters.js')).runAdapters,
     },
     {
         id: 'init',
         usage: 'mf init',
         summaryKey: 'command.init.summary',
+        loadRunner: async () => (await import('../commands/init.js')).runInit,
     },
     {
         id: 'check',
         usage: 'mf check',
         summaryKey: 'command.check.summary',
+        loadRunner: async () => (await import('../commands/check.js')).runCheck,
     },
     {
         id: 'classify',
         usage: 'mf classify',
         summaryKey: 'command.classify.summary',
+        loadRunner: async () => (await import('../commands/classify.js')).runClassify,
     },
     {
         id: 'contract-lint',
         usage: 'mf contract-lint',
         summaryKey: 'command.contractLint.summary',
+        loadRunner: async () => (await import('../commands/contract-lint.js')).runContractLint,
     },
     {
         id: 'status',
         usage: 'mf status',
         summaryKey: 'command.status.summary',
+        loadRunner: async () => (await import('../commands/status.js')).runStatus,
     },
     {
         id: 'update',
         usage: 'mf update',
         summaryKey: 'command.update.summary',
+        loadRunner: async () => (await import('../commands/update.js')).runUpdate,
     },
     {
         id: 'upgrade',
         usage: 'mf upgrade',
         summaryKey: 'command.upgrade.summary',
+        loadRunner: async () => (await import('../commands/upgrade.js')).runUpgrade,
     },
     {
         id: 'map',
         usage: 'mf map',
         summaryKey: 'command.map.summary',
+        loadRunner: async () => (await import('../commands/map.js')).runMap,
     },
     {
         id: 'line-endings',
         usage: 'mf line-endings',
         summaryKey: 'command.lineEndings.summary',
+        loadRunner: async () => (await import('../commands/line-endings.js')).runLineEndings,
     },
     {
         id: 'run',
         usage: 'mf run',
         summaryKey: 'command.run.summary',
+        loadRunner: async () => (await import('../commands/run.js')).runRun,
     },
     {
         id: 'context',
         usage: 'mf context',
         summaryKey: 'command.context.summary',
+        loadRunner: async () => (await import('../commands/context.js')).runContext,
     },
     {
         id: 'doctor',
         usage: 'mf doctor',
         summaryKey: 'command.doctor.summary',
+        loadRunner: async () => (await import('../commands/doctor.js')).runDoctor,
     },
     {
         id: 'docs',
         usage: 'mf docs',
         summaryKey: 'command.docs.summary',
+        loadRunner: async () => (await import('../commands/docs.js')).runDocs,
     },
     {
         id: 'handoff',
         usage: 'mf handoff',
         summaryKey: 'command.handoff.summary',
+        loadRunner: async () => (await import('../commands/handoff.js')).runHandoff,
     },
     {
         id: 'index',
         usage: 'mf index',
         summaryKey: 'command.index.summary',
+        loadRunner: async () => (await import('../commands/index.js')).runIndex,
     },
     {
         id: 'search',
         usage: 'mf search',
         summaryKey: 'command.search.summary',
+        loadRunner: async () => (await import('../commands/search.js')).runSearch,
     },
     {
         id: 'dashboard',
         usage: 'mf dashboard',
         summaryKey: 'command.dashboard.summary',
+        loadRunner: async () => (await import('../commands/dashboard.js')).runDashboard,
     },
     {
         id: 'version',
         usage: 'mf version',
         summaryKey: 'command.version.summary',
+        loadRunner: async () => (await import('../commands/version.js')).runVersion,
     },
     {
         id: 'version-sources',
         usage: 'mf version-sources',
         summaryKey: 'command.versionSources.summary',
+        loadRunner: async () => (await import('../commands/version-sources.js')).runVersionSources,
     },
     {
         id: 'verify',
         usage: 'mf verify',
         summaryKey: 'command.verify.summary',
+        loadRunner: async () => (await import('../commands/verify.js')).runVerify,
     },
     {
         id: 'explain',
         usage: 'mf explain',
         summaryKey: 'command.explain.summary',
+        loadRunner: async () => (await import('../commands/explain.js')).runExplain,
     },
     {
         id: 'impact',
         usage: 'mf impact',
         summaryKey: 'command.impact.summary',
+        loadRunner: async () => (await import('../commands/impact.js')).runImpact,
     },
     {
         id: 'help',
         usage: 'mf help',
         summaryKey: 'command.help.summary',
+        loadRunner: async () => (await import('../commands/help.js')).runHelp,
     },
 ];
+export function findCommandDefinition(command) {
+    return COMMAND_DEFINITIONS.find((definition) => definition.id === command);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mustflow",
-  "version": "2.18.2",
+  "version": "2.18.3",
   "description": "Agent workflow documents and CLI for mustflow repository roots.",
   "type": "module",
   "license": "MIT-0",

package/templates/default/i18n.toml

@@ -56,7 +56,7 @@ translations = {}
 [documents."skills.index"]
 source = "locales/en/.mustflow/skills/INDEX.md"
 source_locale = "en"
-revision = 54
+revision = 55
 translations = {}
 
 [documents."skill.adapter-boundary"]
@@ -274,6 +274,12 @@ source_locale = "en"
 revision = 2
 translations = {}
 
+[documents."skill.source-anchor-authoring"]
+source = "locales/en/.mustflow/skills/source-anchor-authoring/SKILL.md"
+source_locale = "en"
+revision = 1
+translations = {}
+
 [documents."skill.project-context-authoring"]
 source = "locales/en/.mustflow/skills/project-context-authoring/SKILL.md"
 source_locale = "en"

package/templates/default/locales/en/.mustflow/skills/INDEX.md

@@ -2,7 +2,7 @@
 mustflow_doc: skills.index
 locale: en
 canonical: true
-revision: 54
+revision: 55
 authority: router
 lifecycle: mustflow-owned
 ---
@@ -94,6 +94,7 @@ stay inactive until their event occurs.
 | --- | --- | --- | --- | --- | --- | --- |
 | Code changes need review before report | `.mustflow/skills/code-review/SKILL.md` | Diff and task goal | Changed files | behavior and regression | `test`, `test_related`, `test_audit`, `lint` | Findings or no-issue note |
 | An unfamiliar codebase area needs an evidence-based map before planning, implementation, or reporting | `.mustflow/skills/codebase-orientation/SKILL.md` | User request, target area, relevant instructions, and current source, test, schema, template, configuration, or documentation files | Read-only orientation notes and any smallest follow-up edit chosen from inspected evidence | stale documentation, wrong ownership boundary, or invented architecture claim | `changes_status`, `changes_diff_summary`, `mustflow_check` | Scope inspected, entrypoints, flow map, ownership boundaries, verification options, risks, unknowns, and smallest safe next step |
+| Source anchors are added, revised, reviewed, or used to mark a module boundary | `.mustflow/skills/source-anchor-authoring/SKILL.md` | Target files, anchor reason, nearby anchors, source-anchor policy, and validation surface | Source anchors and directly related workflow docs or comments | comment bloat, authority drift, false verification claims, or hidden module pressure | `mustflow_check`, `docs_validate_fast` | Anchor placement decision, field choices, module-boundary handoff, and verification |
 | Changed files need risk classification and verification selection | `.mustflow/skills/diff-risk-review/SKILL.md` | Changed-file list, diff summary, and task goal | Changed surfaces and verification report | under- or over-verification | `changes_status`, `changes_diff_summary`, `test`, `test_related`, `test_audit`, `lint`, `build`, `docs_validate`, `mustflow_check` | Risk level, verification choice, rollback notes |
 | Performance budgets, bundle size, page weight, startup time, command duration, memory use, asset size, throughput, latency, benchmark output, or performance claims are planned, edited, reviewed, or reported | `.mustflow/skills/performance-budget-check/SKILL.md` | Performance surface, budget source, measurement method, environment boundary, and command contract entries | Budget checks, thresholds, measurements, dependency tradeoff notes, tests, docs, package metadata, and reports | invented budgets, stale measurements, hidden performance cost, or unverified speed claim | `changes_status`, `changes_diff_summary`, `build`, `test_related`, `docs_validate_fast`, `test_release`, `mustflow_check` | Performance surface, budget source, measurement boundary, synchronized claims, skipped measurements, and remaining performance risk |
 | New feature, module, folder layout, architecture, scaffold, refactor, routing, data model, or external service integration may require hidden structure decisions before coding | `.mustflow/skills/structure-discovery-gate/SKILL.md` | User request, intended capability, hidden assumptions, named technologies or services, and relevant local patterns | Questions, assumptions, proposed file boundaries, and the smallest resulting implementation | brittle structure, vendor-name leakage, over-questioning, or speculative abstraction | `changes_status`, `changes_diff_summary`, `docs_validate_fast`, `test_release`, `mustflow_check` | Blocking questions, assumptions, proposed files and responsibilities, dependency direction, local pattern, verification, and remaining structure risk |

package/templates/default/locales/en/.mustflow/skills/routes.toml

@@ -90,6 +90,12 @@ route_type = "primary"
 priority = 20
 applies_to_reasons = ["unknown_change", "code_change"]
 
+[routes."source-anchor-authoring"]
+category = "general_code"
+route_type = "primary"
+priority = 60
+applies_to_reasons = ["code_change", "mustflow_docs_change"]
+
 [routes."repo-improvement-loop"]
 category = "workflow_contracts"
 route_type = "primary"