arkgate 4.6.6 → 4.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/CHANGELOG.md +139 -2
  2. package/README.md +22 -10
  3. package/SECURITY.md +1 -1
  4. package/bin/ark-check-runtime.mjs +21 -341
  5. package/bin/ark-mcp-runtime.mjs +71 -325
  6. package/bin/ark-shared.mjs +24 -158
  7. package/bin/lib/adapter-contract.mjs +17 -36
  8. package/bin/lib/analysis-engine.mjs +6 -6
  9. package/bin/lib/ark-run-doctor.mjs +144 -0
  10. package/bin/lib/ark-run-facts.mjs +472 -0
  11. package/bin/lib/ark-run-report.mjs +57 -0
  12. package/bin/lib/ark-run-sensors.mjs +309 -0
  13. package/bin/lib/check-args.mjs +173 -0
  14. package/bin/lib/check-config-detect.mjs +101 -0
  15. package/bin/lib/check-watch.mjs +80 -0
  16. package/bin/lib/config-contract.mjs +86 -11
  17. package/bin/lib/deep-module-coach.mjs +3 -0
  18. package/bin/lib/diagnostic-catalog.mjs +8 -0
  19. package/bin/lib/doctor-advisories.mjs +45 -8
  20. package/bin/lib/doctor-human.mjs +519 -0
  21. package/bin/lib/doctor-plan.mjs +62 -445
  22. package/bin/lib/extra-merge-teeth.mjs +187 -0
  23. package/bin/lib/github-enforcement.mjs +22 -9
  24. package/bin/lib/html-report-advisories.mjs +2 -0
  25. package/bin/lib/html-report-depth.mjs +22 -2
  26. package/bin/lib/html-report.mjs +40 -7
  27. package/bin/lib/mcp-hook-payload.mjs +328 -0
  28. package/bin/lib/package-manager.mjs +174 -0
  29. package/bin/lib/policy-delta-io.mjs +4 -0
  30. package/bin/lib/remediation.mjs +132 -0
  31. package/bin/lib/resolved-candidate-facts.mjs +67 -2
  32. package/bin/lib/rules-under-contract.mjs +37 -89
  33. package/bin/lib/snippet-analysis.mjs +43 -2
  34. package/bin/lib/status-command.mjs +28 -0
  35. package/bin/lib/status-manifest.mjs +23 -0
  36. package/bin/lib/team-parliament-io.mjs +4 -0
  37. package/dist/{configTypes-l6XiwiC1.d.ts → configTypes-CgJimx9o.d.ts} +17 -3
  38. package/dist/eslint/index.cjs +6 -2
  39. package/dist/eslint/index.d.ts +70 -2
  40. package/dist/eslint/index.js +6 -2
  41. package/dist/index.cjs +35 -35
  42. package/dist/index.d.ts +787 -272
  43. package/dist/index.js +35 -35
  44. package/docs/README.md +4 -3
  45. package/docs/agent-guide.md +21 -15
  46. package/docs/ai-gates.md +13 -0
  47. package/docs/configuration.md +24 -11
  48. package/docs/develop.md +12 -3
  49. package/docs/diagnostics.md +75 -0
  50. package/docs/enthusiast/README.md +4 -3
  51. package/docs/package-surface.md +17 -13
  52. package/docs/product-voice.md +6 -3
  53. package/docs/threat-model.md +1 -1
  54. package/docs/use.md +5 -4
  55. package/package.json +1 -1
  56. package/schemas/ark.config.schema.json +41 -2
  57. package/schemas/ark.resolved-candidate-facts.schema.json +1 -1
  58. package/schemas/ark.status-manifest.schema.json +47 -0
  59. package/server.json +2 -2
  60. package/templates/agent-skills/README.md +1 -1
  61. package/templates/agent-skills/ark-adopt/SKILL.md +23 -2
  62. package/templates/agent-skills/ark-place/SKILL.md +26 -2
  63. package/templates/agent-skills/ark-runtime/SKILL.md +66 -24
  64. package/templates/skills/ark-adopt.md +23 -2
  65. package/templates/skills/ark-place.md +26 -2
  66. package/templates/skills/ark-runtime.md +66 -24
@@ -12,9 +12,10 @@ import {
12
12
  import * as arkShared from '../ark-shared.mjs';
13
13
  import { summarizeRulesUnderContract } from './rules-under-contract.mjs';
14
14
  import { describePackageVersionDualTruth } from './field-install.mjs';
15
- import { detectAgentHomeGaps, agentHomeConcernIsActive } from './agent-homes.mjs';
16
- import { operatingModeTitle } from './product-copy.mjs';
15
+ import { detectAgentHomeGaps } from './agent-homes.mjs';
17
16
  import { collectDoctorNextActions } from './doctor-next-actions.mjs';
17
+ import { printDoctorCompactHuman, printDoctorDetailsHuman } from './doctor-human.mjs';
18
+ export { printDoctorCompactHuman, printDoctorDetailsHuman };
18
19
  export { summarizeRulesUnderContract };
19
20
 
20
21
  /** Optional S3 dual-match classifier when ark-shared exports it (soft dep for S5 landing). */
@@ -30,7 +31,6 @@ import {
30
31
  detectWritePathCapabilities,
31
32
  missingGates,
32
33
  staleRunnerGateFiles,
33
- skillGapsForActiveHost,
34
34
  } from './agent-gates.mjs';
35
35
  import {
36
36
  baselineOccurrenceKeys,
@@ -47,7 +47,6 @@ import {
47
47
  } from './design-smells.mjs';
48
48
  import {
49
49
  buildPostGreenNextAction,
50
- isDoctorHealthyNothingToDo,
51
50
  DESIGN_WEAK_HONESTY_FLAGS,
52
51
  } from './post-green-path.mjs';
53
52
  import {
@@ -60,10 +59,7 @@ import {
60
59
  summarizeGoldenPattern,
61
60
  } from './golden-pattern.mjs';
62
61
  import { summarizePilotLoop } from './pilot-loop.mjs';
63
- import { computeDoctorAdvisories, printDoctorAdvisories } from './doctor-advisories.mjs';
64
- import { printParseHealthSection } from './parse-health.mjs';
65
- import { designDeltaDoctorLines } from './design-delta.mjs';
66
- import { enforcementDoctorLines } from './enforcement-state.mjs';
62
+ import { computeDoctorAdvisories } from './doctor-advisories.mjs';
67
63
  import { ANALYSIS_COMPLETENESS, analysisIncompleteStatement, normalizeAnalysisCompleteness } from './analysis-completeness.mjs';
68
64
  import { buildDoctorImprovementCompass } from './improvement-compass-doctor.mjs';
69
65
  import { buildDeepModuleCoachAdvisory } from './deep-module-coach.mjs';
@@ -603,21 +599,22 @@ export function runDoctor(root, config, files, rules, violations, asJson, option
603
599
  patternBets: patternBetsForLoop,
604
600
  designSmells,
605
601
  });
606
- const doctorAdvisories = computeDoctorAdvisories(root, config, cov, rules, files, options.ts, options.parseHealth);
607
- // AR12 compute once for JSON + product honesty + human lines.
608
- // P1M: classification gate on extraMergeTeeth (no teeth at empty graph).
609
- const rulesUnderContract = summarizeRulesUnderContract(
602
+ const activeViolations = baseline.exists
603
+ ? violations.filter((_, index) => !baseline.keys.has(occurrenceKeys[index]))
604
+ : violations;
605
+ const doctorAdvisories = computeDoctorAdvisories(
610
606
  root,
611
607
  config,
608
+ cov,
609
+ rules,
610
+ files,
611
+ options.ts,
612
+ options.parseHealth,
612
613
  options.facts ?? options.architectureFacts,
613
- {
614
- governedPercent: cov.governed?.percent ?? null,
615
- populatedLayerCount: Array.isArray(cov.layers)
616
- ? cov.layers.filter((row) => (row?.files ?? 0) > 0).length
617
- : null,
618
- classifiedFiles: cov.governed?.classifiedFiles ?? null,
619
- }
614
+ activeViolations
620
615
  );
616
+ const rulesUnderContract = doctorAdvisories.rulesUnderContract;
617
+ const arkRun = doctorAdvisories.arkRun;
621
618
  // Single residual expression (nextPilot || extractionCard) — HTML report uses the same.
622
619
  const residualPilot = pilotLoop?.nextPilot || pilotLoop?.extractionCard || null;
623
620
  // Evidence-backed hard only (never capabilities-from-hook-files alone).
@@ -657,9 +654,12 @@ export function runDoctor(root, config, files, rules, violations, asJson, option
657
654
  residualPilots: Boolean(residualPilot) && designFitness.designWeak === true,
658
655
  pilotTarget: residualPilot?.pilotTarget ?? residualPilot?.pilot ?? null,
659
656
  arkRulesMergeHonesty: rulesUnderContract?.mergePlanes
660
- ? { active: rulesUnderContract.active === true, ...rulesUnderContract.mergePlanes }
661
- : rulesUnderContract?.active === true
662
- ? { active: true, extraMergeTeeth: false }
657
+ ? {
658
+ active: rulesUnderContract.active === true || arkRun?.active === true,
659
+ ...rulesUnderContract.mergePlanes,
660
+ }
661
+ : rulesUnderContract?.active === true || arkRun?.active === true
662
+ ? { active: true, extraMergeTeeth: arkRun?.extraMergeTeeth === true }
663
663
  : null,
664
664
  primaryNextAction:
665
665
  adopted === 'not-adopted' ? NOT_ADOPTED_NEXT_ACTION : postGreenPath?.action ?? dualTruthNext,
@@ -750,10 +750,10 @@ export function runDoctor(root, config, files, rules, violations, asJson, option
750
750
  // Dual-truth: managed CLI vs package.json pin (not a gate fail).
751
751
  packageVersionTruth,
752
752
  // Advisories, never a verdict: W01/U05/X04/Y03 + graph-blind spots.
753
- // (rulesUnderContract is also in advisories; re-assert after spread so mergePlanes wins.)
753
+ // Re-assert after spread so mergePlanes from this scan wins.
754
754
  ...doctorAdvisories,
755
- // AR12 + P1-M mergePlanes (authoritative; after advisories spread).
756
755
  rulesUnderContract,
756
+ arkRun,
757
757
  // P0-B — single anti-false-green honesty surface (never a score).
758
758
  productHonesty,
759
759
  governed: cov.governed,
@@ -859,52 +859,7 @@ export function runDoctor(root, config, files, rules, violations, asJson, option
859
859
  return;
860
860
  }
861
861
 
862
- const ok = color.green('✓');
863
- const warn = color.yellow('!');
864
- const bad = color.red('✗');
865
- const line = (mark, text) => console.log(` ${mark} ${text}`);
866
- console.log(color.bold(`Ark doctor — ${path.basename(path.resolve(root)) || '.'}`));
867
- if (!analysisComplete) line(warn, analysisIncompleteStatement(completeness));
868
- printParseHealthSection(doctorAdvisories.parseHealth, { color, warn, line });
869
-
870
862
  const emptyScope = emptyScopeEarly;
871
- const mode = operatingMode;
872
- console.log('');
873
- console.log(color.bold('Operating mode'));
874
- // Modes are detected states, not user-picked settings. Plain-language "what you do next".
875
- // Never paint green (ok) under design residual — edges clean ≠ design done (product-voice).
876
- const modeMark =
877
- mode === 'enforce' &&
878
- !designFitness.designWeak &&
879
- adopted !== 'not-adopted' &&
880
- !stewardUnfinished
881
- ? ok
882
- : warn;
883
- // modeTitle alone names the light — bodies must not re-prefix Suggest/Adapt/Enforce.
884
- const modeHelp = {
885
- suggest: 'thin or new tree. Next: ark start --apply, then doctor.',
886
- adapt: 'config and tree still disagree. Next: do #1.',
887
- enforce:
888
- adopted === 'not-adopted'
889
- ? 'import rules check out; merge boundary not adopted.'
890
- : 'import rules check out. Keep host + CI.',
891
- };
892
- const modeTitle = operatingModeTitle(mode, designFitness.designWeak, stewardUnfinished);
893
- line(
894
- modeMark,
895
- `${modeTitle} — ${
896
- designFitness.designWeak
897
- ? 'import rules check out; leftover design work remains.'
898
- : modeHelp[mode]
899
- }`
900
- );
901
- if (emptyScope) {
902
- line(
903
- bad,
904
- 'Empty scope: include paths match 0 source files — a green check is meaningless until include/layers match the tree (monorepo → apps/packages, or /ark-adopt).'
905
- );
906
- }
907
-
908
863
  const safetyHasEntries = Boolean(
909
864
  options.safety &&
910
865
  [
@@ -943,381 +898,43 @@ export function runDoctor(root, config, files, rules, violations, asJson, option
943
898
  adopted,
944
899
  stewardNudge: doctorAdvisories.stewardNudge,
945
900
  });
946
- console.log('');
947
- if (ciMergeBoundary?.ci?.state) {
948
- line(
949
- ciMergeBoundary.ci.state === 'required' ? ok : warn,
950
- `CI merge: ${ciMergeBoundary.ci.state}`
951
- );
952
- }
953
- if (adopted === 'advisory-only-acked') {
954
- line(warn, 'Adoption: advisory-only ack — not a required GitHub status.');
955
- }
956
- if (isDoctorHealthyNothingToDo(designFitness, uniqueActions, adopted)) {
957
- console.log(color.green('✔ Healthy — nothing to do.'));
958
- console.log(color.dim(' Keep write path + CI.'));
959
- } else {
960
- console.log(color.bold('Primary next action'));
961
- console.log(` 1. ${uniqueActions[0]}`);
962
- }
963
-
964
- console.log('');
965
- console.log(color.bold('Coverage'));
966
- const govMark =
967
- emptyScope || cov.governed.percent < 50
968
- ? bad
969
- : cov.governed.percent >= 80
970
- ? ok
971
- : warn;
972
- line(govMark, `Governed: ${cov.governed.percent}% (${cov.governed.classifiedFiles}/${cov.governed.totalFiles} files)`);
973
-
974
- const hostRed =
975
- gatesMissing.length > 0 ||
976
- Boolean(writePath.gap) ||
977
- writePathHonesty?.softWriteHost === true;
978
- if (hostRed) {
979
- console.log('');
980
- console.log(color.bold('Host / CI'));
981
- if (writePath.activeHost) line(' ', `Active host: ${writePath.activeHost}`);
982
- if (gatesMissing.length > 0) line(bad, `Missing gates: ${gatesMissing.join(', ')}`);
983
- else if (writePath.gap || writePathHonesty?.softWriteHost) {
984
- line(warn, 'Local writes are advisory; required CI is the merge boundary.');
985
- }
986
- }
987
-
988
- const nudge = doctorAdvisories.stewardNudge;
989
- if ((nudge?.needsStewards || nudge?.drift || nudge?.emptyStewardsPastGrace) && nudge.ask) {
990
- console.log('');
991
- console.log(color.bold('Stewards'));
992
- line(warn, nudge.ask);
993
- }
994
-
995
- if (violations.length === 0) {
996
- if (!analysisComplete) {
997
- console.log('');
998
- line(
999
- warn,
1000
- 'No reported violations — contract compliance is not verified until analysis is complete'
1001
- );
1002
- } else if (emptyScope || cov.governed.percent < 50) {
1003
- console.log('');
1004
- line(
1005
- warn,
1006
- 'No active violations — coverage is still thin, so green is not yet honest enforcement'
1007
- );
1008
- }
1009
- }
1010
-
1011
- if (!options.all) {
1012
- console.log('');
1013
- console.log(color.dim('More: --doctor --all'));
1014
- return;
1015
- }
1016
-
1017
- console.log('');
1018
- console.log(color.dim('---'));
1019
- console.log(color.bold('Details'));
1020
-
1021
- if (coverageHonesty.greenIsNotEnforcement) {
1022
- line(coverageHonesty.worseThanNoGate ? bad : warn, coverageHonesty.message);
1023
- }
1024
- if (cov.suggestions.length > 0) {
1025
- line(warn, `${cov.suggestions.length} ungoverned director(y/ies) — proposals: ${arkCommand(root, 'ark-check', '--coverage')}`);
1026
- }
1027
- if (cov.emptyLayers.length > 0) line(warn, `Empty layers (pattern matches nothing): ${cov.emptyLayers.join(', ')}`);
1028
- if (cov.layersWithoutRules.length > 0) line(warn, `Layers with no rule edge: ${cov.layersWithoutRules.join(', ')}`);
1029
- if (cov.dualMembership?.count > 0) {
1030
- line(
1031
- warn,
1032
- `Dual-match: ${cov.dualMembership.count} file(s) match multiple layers — ${cov.dualMembership.note ?? 'review overlapping globs'}`
1033
- );
1034
- }
1035
- if (cov.suggestions.length === 0 && cov.emptyLayers.length === 0) line(ok, 'Every layer classifies files; no empty layers');
1036
-
1037
- if (packageVersionTruth?.dualTruth) {
1038
- console.log('');
1039
- console.log(color.bold('Package pin (dual-truth)'));
1040
- line(warn, packageVersionTruth.note);
1041
- } else if (packageVersionTruth?.code === 'PACKAGE_PIN_ABSENT') {
1042
- console.log('');
1043
- console.log(color.bold('Package pin'));
1044
- line(warn, packageVersionTruth.note);
1045
- }
1046
- if (options.configWalkedUp && options.configRoot) {
1047
- line(
1048
- ok,
1049
- `Config walk-up: using monorepo root ${options.configRoot} (ark.config.json not in cwd package)`
1050
- );
1051
- }
1052
-
1053
- console.log('');
1054
- console.log(color.bold('Design fitness'));
1055
- if (designSmells.length === 0) {
1056
- line(analysisComplete ? ok : warn, designFitness.label);
1057
- } else {
1058
- line(designFitness.designWeak ? warn : warn, designFitness.label);
1059
- for (const smell of designSmells.slice(0, 5)) {
1060
- const outcome = smell.outcome || smell.message;
1061
- line(' ', `[${smell.id}] ${outcome}`);
1062
- if (smell.outcome && smell.message && smell.message !== smell.outcome) {
1063
- line(' ', color.dim(`detail: ${smell.message}`));
1064
- }
1065
- if (smell.evidence?.length) {
1066
- line(' ', color.dim(`evidence: ${smell.evidence.slice(0, 4).join(', ')}`));
1067
- }
1068
- }
1069
- if (pilotLoop?.active && pilotLoop.nextPilot) {
1070
- const np = pilotLoop.nextPilot;
1071
- line(
1072
- warn,
1073
- `Next pilot (one at a time): ${np.pilotTarget || np.pilot} [${np.smellId}] → re-doctor after change`
1074
- );
1075
- line(' ', color.dim(`success: ${np.successSignal}`));
1076
- line(' ', color.dim('never multi-pilot batch; pattern bets are never auto-applied'));
1077
- }
1078
- }
1079
-
1080
- if (options.designDelta) {
1081
- console.log('');
1082
- console.log(color.bold('Design delta (opt-in)'));
1083
- for (const row of designDeltaDoctorLines(options.designDelta))
1084
- line(row.level === 'bad' ? bad : row.level === 'ok' ? ok : ' ', row.level === 'dim' ? color.dim(row.text) : row.text);
1085
- }
1086
-
1087
- if (goldenPattern.present) {
1088
- console.log('');
1089
- console.log(color.bold('Golden pattern (new code)'));
1090
- line(
1091
- ok,
1092
- `"${goldenPattern.name}" — ${goldenPattern.norm}` +
1093
- (goldenPattern.newCodeHome ? ` Prefer: ${goldenPattern.newCodeHome}.` : '') +
1094
- ' Advisory only — does not clear leftover design work or replace the gate.'
1095
- );
1096
- } else if (goldenPattern.invalid) {
1097
- console.log('');
1098
- console.log(color.bold('Golden pattern (new code)'));
1099
- line(
1100
- warn,
1101
- `${goldenPattern.path} is present but invalid (${goldenPattern.error || 'invalid'}). ` +
1102
- 'Fix or remove it — absence is fine; a bad file is not guidance.'
1103
- );
1104
- }
1105
- if (pureLayerOptIn) {
1106
- line(' ', color.dim(pureLayerOptIn.message));
1107
- }
1108
-
1109
- printDoctorAdvisories(doctorAdvisories, { line, warn, color });
1110
-
1111
- console.log('');
1112
- console.log(color.bold('Violations'));
1113
- if (violations.length === 0) {
1114
- if (!analysisComplete) line(warn, 'No reported violations — contract compliance is not verified until analysis is complete');
1115
- else if (emptyScope || cov.governed.percent < 50) {
1116
- line(
1117
- warn,
1118
- 'No active violations — coverage is still thin, so green is not yet honest enforcement'
1119
- );
1120
- } else if (designFitness.designWeak) {
1121
- line(warn, `None on checked imports — import rules match the config; leftover design work remains (${modeTitle}). Not healthy finished.`);
1122
- } else {
1123
- line(ok, 'None — the code matches the contract on checked edges');
1124
- }
1125
- } else {
1126
- const typeNote = summary.typeOnlyCount > 0 ? ` (${summary.valueCount} value · ${summary.typeOnlyCount} type-only)` : '';
1127
- const supNote = suppressed > 0 ? `, ${suppressed} frozen` : '';
1128
- line(
1129
- activeCount > 0 ? warn : ok,
1130
- `${violations.length} total${typeNote}${supNote}${activeCount > 0 ? ` — ${activeCount} NOT baselined` : ''}`
1131
- );
1132
- for (const edge of summary.edges.slice(0, 3)) line(' ', color.dim(`${edge.count} ${edge.edge}`));
1133
- if (summary.concentrated) {
1134
- line(warn, color.dim(`${Math.round(summary.dominantShare * 100)}% on one edge (${summary.dominant}) — likely a contract fix, not debt`));
1135
- }
1136
- }
1137
-
1138
- console.log('');
1139
- console.log(color.bold('Write path (agent)'));
1140
- const capabilities = writePath.capabilities;
1141
- const writePathLabels = {
1142
- repair: 'repair-capable — hard block + machine-readable autoPatch / ARK_REPAIR_JSON',
1143
- 'reject-only': 'reject-only — hard block with prose; no repair payload',
1144
- 'mcp-only': 'MCP tools only — prepare-write/autoPatch available; no PreToolUse hook',
1145
- none: 'no write gate hook and no Ark MCP',
901
+ const humanView = {
902
+ root,
903
+ analysisComplete,
904
+ completeness,
905
+ doctorAdvisories,
906
+ operatingMode,
907
+ designFitness,
908
+ adopted,
909
+ stewardUnfinished,
910
+ emptyScope,
911
+ options,
912
+ uniqueActions,
913
+ ciMergeBoundary,
914
+ cov,
915
+ writePath,
916
+ writePathHonesty,
917
+ gatesMissing,
918
+ violations,
919
+ coverageHonesty,
920
+ packageVersionTruth,
921
+ designSmells,
922
+ pilotLoop,
923
+ goldenPattern,
924
+ pureLayerOptIn,
925
+ summary,
926
+ suppressed,
927
+ activeCount,
928
+ skillGaps,
929
+ agentHomeGaps,
930
+ baseline,
931
+ baselineHonesty,
932
+ staleBaseline,
933
+ staleRunners,
934
+ adoption,
935
+ color,
1146
936
  };
1147
- const wpMark =
1148
- capabilities['hard-write']
1149
- ? ok
1150
- : capabilities['advisory-write'] || capabilities['merge-gate']
1151
- ? warn
1152
- : bad;
1153
- line(' ', `Active host: ${writePath.activeHost}`);
1154
- line(' ', `Supported profile: ${writePath.supportSummary}`);
1155
- line(wpMark, `Mode: ${writePath.mode} — ${writePathLabels[writePath.mode] || writePath.mode}`);
1156
- if (writePathHonesty.message) line(warn, writePathHonesty.message);
1157
- if (writePath.sessionNote) {
1158
- line(warn, writePath.sessionNote);
1159
- }
1160
- const enforcement = writePath.enforcementState;
1161
- for (const row of enforcementDoctorLines(enforcement)) line(row.level === 'ok' ? ok : row.level === 'bad' ? bad : warn, row.text);
1162
- const supportCaps = writePath.support?.capabilities || {};
1163
- const repairReinjection = supportCaps['repair-reinjection-guaranteed'] === true;
1164
- const repairEnvelope = supportCaps['repair-envelope-emitted'] === true || supportCaps['repair-payload'] === true;
1165
- line(
1166
- repairReinjection ? ok : warn,
1167
- repairReinjection
1168
- ? 'Repair: envelope + reinjection guaranteed on hard path when installed + trusted'
1169
- : repairEnvelope
1170
- ? 'Repair: envelope may emit (`--hook-repair`); reinjection not guaranteed (advisory host)'
1171
- : 'Repair: no hard-boundary payload'
1172
- );
1173
- if (writePath.gap) {
1174
- line(writePath.gap.severity === 'warn' ? warn : warn, writePath.gap.message);
1175
- if (writePath.gap.fix) {
1176
- line(' ', color.dim(`Fix: ${writePath.gap.fix}`));
1177
- }
1178
- }
1179
-
1180
- console.log('');
1181
- console.log(color.bold('Gates & skills'));
1182
- if (gatesMissing.length === 0) line(ok, 'Shared gate artifacts found on disk (AGENTS.md, .mcp.json, CI); runtime activation is reported separately');
1183
- else {
1184
- line(bad, `Missing gates: ${gatesMissing.join(', ')}`);
1185
- }
1186
- const humanSkillGaps = skillGapsForActiveHost(skillGaps);
1187
- const legacyCodex = humanSkillGaps.some((g) => g.tool === 'codex' && g.legacyPromptsOnly);
1188
- const codexLegacySafeDelete = humanSkillGaps.some(
1189
- (g) => g.tool === 'codex' && g.legacyAdvisory && g.catalogComplete
1190
- );
1191
- const remainingGaps = humanSkillGaps.filter(
1192
- (g) => !(g.tool === 'codex' && (g.legacyPromptsOnly || g.legacyAdvisory))
1193
- );
1194
- const remMiss = remainingGaps.reduce((s, g) => s + g.missing, 0);
1195
- const remStale = remainingGaps.reduce((s, g) => s + g.stale, 0);
1196
- if (remMiss + remStale === 0 && !legacyCodex) line(ok, '/ark-* skills current for detected tools');
1197
- if (legacyCodex) {
1198
- line(warn, 'Codex: legacy flat .codex/prompts only (not a loadable skill catalog)');
1199
- }
1200
- if (codexLegacySafeDelete) {
1201
- line(
1202
- ' ',
1203
- color.dim(
1204
- 'Codex catalog complete — leftover .codex/prompts/ark-*.md are safe to delete (not loadable; not required).'
1205
- )
1206
- );
1207
- }
1208
- if (remMiss + remStale > 0) {
1209
- line(
1210
- warn,
1211
- `${remMiss} missing / ${remStale} content-behind-package /ark-* skill(s) for ${remainingGaps.map((g) => g.tool).join(', ')}`
1212
- );
1213
- }
1214
- const codexHomeGap = detectCodexHomeGap(root);
1215
- if (codexHomeGap) {
1216
- const parts = [
1217
- codexHomeGap.legacyPromptsOnly ? 'legacy-prompts-only' : null,
1218
- codexHomeGap.missing > 0 ? `${codexHomeGap.missing} missing` : null,
1219
- codexHomeGap.stale > 0 ? `${codexHomeGap.stale} content-behind-package` : null, codexHomeGap.catalogStateReason,
1220
- ].filter(Boolean);
1221
- const deferred = !codexConcernIsActive();
1222
- if (deferred) {
1223
- line(color.dim('·'), color.dim(`Codex home skills ${parts.join(', ')} (deferred — not on Codex session)`));
1224
- } else {
1225
- line(warn, `Codex home skills ${parts.join(', ')}`);
1226
- }
1227
- }
1228
- for (const gap of agentHomeGaps) {
1229
- const parts = [
1230
- gap.missing > 0 ? `${gap.missing} missing` : null,
1231
- gap.stale > 0 ? `${gap.stale} content-behind-package` : null,
1232
- gap.catalogStateReason,
1233
- ].filter(Boolean);
1234
- const deferred = !agentHomeConcernIsActive(gap.host);
1235
- const summary = `${gap.label} shared agent skills ${parts.join(', ')}`;
1236
- if (deferred) {
1237
- line(color.dim('·'), color.dim(`${summary} (deferred — not this session)`));
1238
- } else {
1239
- line(warn, summary);
1240
- }
1241
- }
1242
-
1243
- console.log('');
1244
- console.log(color.bold('Baseline'));
1245
- if (!baseline.exists) {
1246
- line(!analysisComplete || violations.length > 0 ? warn : ok, !analysisComplete ? 'No baseline — current violations were not fully evaluated' : violations.length > 0 ? 'No baseline — adopting a dirty repo? freeze with --update-baseline' : 'No baseline (nothing to freeze)');
1247
- } else {
1248
- const baseMark = !analysisComplete || baselineHonesty.dirtyBaselineRisk ? warn : ok;
1249
- line(baseMark, `${baseline.keys.size} frozen key(s)${analysisComplete ? '' : ' — stale comparison not verified'}`);
1250
- if (analysisComplete && baselineHonesty.dirtyBaselineRisk) {
1251
- line(warn, baselineHonesty.message);
1252
- }
1253
- if (analysisComplete && staleBaseline > 0) {
1254
- line(warn, `${staleBaseline} stale entr(y/ies) no longer occur — tighten with --update-baseline`);
1255
- }
1256
- }
1257
-
1258
- console.log('');
1259
- console.log(color.bold('Command runners'));
1260
- if (staleRunners.length === 0) line(ok, 'Emitted commands match the package manager');
1261
- else {
1262
- line(warn, `Stale runner in ${staleRunners.join(', ')}`);
1263
- }
1264
-
1265
- console.log('');
1266
- console.log(color.bold('Adoption (separate from fitness score)'));
1267
- if (adoption.gaps.length === 0 && !adoption.layerBalance) {
1268
- line(
1269
- ok,
1270
- 'Hosts, MCP argv, core optionality, origin report, baseline policy, and deploy-path lint/types look complete'
1271
- );
1272
- } else {
1273
- for (const gap of adoption.gaps) {
1274
- const mark = gap.deferred
1275
- ? color.dim('·')
1276
- : gap.severity === 'warn'
1277
- ? warn
1278
- : gap.severity === 'info'
1279
- ? warn
1280
- : bad;
1281
- line(mark, gap.message);
1282
- if (gap.fix) {
1283
- line(' ', color.dim(gap.deferred ? `When using Codex: ${gap.fix}` : `Fix: ${gap.fix}`));
1284
- }
1285
- }
1286
- if (adoption.layerBalance) {
1287
- line(warn, color.dim(adoption.layerBalance.educational));
1288
- }
1289
- }
1290
- if (adoption.baseline) {
1291
- line(
1292
- ' ',
1293
- color.dim(
1294
- `Baseline policy: ${adoption.baseline.signal}` +
1295
- (adoption.baseline.primaryPathUsesBaseline
1296
- ? ' · primary path uses --baseline'
1297
- : ' · primary path does not use --baseline')
1298
- )
1299
- );
1300
- }
1301
- if (adoption.originReport.present) {
1302
- line(ok, 'Origin architecture snapshot present (.ark/reports/origin.json)');
1303
- }
1304
-
1305
- console.log('');
1306
- console.log(color.bold('Safety / bypass resistance'));
1307
- const safety = options.safety;
1308
- if (!safety) {
1309
- line(warn, 'Safety diagnostics unavailable');
1310
- } else {
1311
- const rows = [
1312
- ['Non-literal dynamic dependencies', safety.nonLiteralDynamicImports],
1313
- ['@ts-ignore / @ts-nocheck', safety.tsSuppressions],
1314
- ['Explicit any casts', safety.anyCasts],
1315
- ['InMemory stores in production source', safety.inMemoryProductionStores],
1316
- ['Rules with peerIsolation: false', safety.disabledPeerIsolationRules],
1317
- ];
1318
- for (const [label, entries] of rows) {
1319
- line(entries.length === 0 ? ok : warn, `${label}: ${entries.length}`);
1320
- }
1321
- }
1322
-
937
+ printDoctorCompactHuman(humanView);
938
+ if (options.all) printDoctorDetailsHuman(humanView);
1323
939
  }
940
+