@brucewaynedecoy/make-docs 2.0.4 → 2.0.5

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 (56) hide show
  1. package/dist/{backup-CM7RL2Q7.js → backup-2OT4A6LR.js} +4 -4
  2. package/dist/{chunk-GERMRLJ2.js → chunk-46MGH32G.js} +6 -4
  3. package/dist/chunk-46MGH32G.js.map +1 -0
  4. package/dist/{chunk-LV3CBXZB.js → chunk-CCYP5NU2.js} +3 -3
  5. package/dist/{chunk-OR5ZVGLG.js → chunk-CLSOY7NV.js} +151 -5
  6. package/dist/chunk-CLSOY7NV.js.map +1 -0
  7. package/dist/{chunk-ADVNSMA7.js → chunk-CMNKQM7L.js} +3 -3
  8. package/dist/{chunk-YVSASZMT.js → chunk-HXWD2EUD.js} +19 -14
  9. package/dist/chunk-HXWD2EUD.js.map +1 -0
  10. package/dist/{chunk-65QWMODG.js → chunk-I4FADOUK.js} +3 -3
  11. package/dist/{chunk-65QWMODG.js.map → chunk-I4FADOUK.js.map} +1 -1
  12. package/dist/{chunk-M7DMFIKU.js → chunk-ISSMVKIA.js} +224 -20
  13. package/dist/chunk-ISSMVKIA.js.map +1 -0
  14. package/dist/{chunk-J5QDGRZ7.js → chunk-UNR4CYVX.js} +116 -37
  15. package/dist/chunk-UNR4CYVX.js.map +1 -0
  16. package/dist/{chunk-7R2PPKTB.js → chunk-VMKG3H4B.js} +2 -2
  17. package/dist/{chunk-52FTNVXS.js → chunk-XDSWX4Y4.js} +8906 -2899
  18. package/dist/chunk-XDSWX4Y4.js.map +1 -0
  19. package/dist/index.js +210 -86
  20. package/dist/index.js.map +1 -1
  21. package/dist/registry-PC5GKAKM.js +50 -0
  22. package/dist/registry-PC5GKAKM.js.map +1 -0
  23. package/dist/{self-36ULRIJ6.js → self-WYVXO23B.js} +10 -10
  24. package/dist/server-BQOG6FTA.js +1113 -0
  25. package/dist/server-BQOG6FTA.js.map +1 -0
  26. package/dist/{setup-system-JI36YJ6D.js → setup-system-KN7FTTLT.js} +263 -40
  27. package/dist/setup-system-KN7FTTLT.js.map +1 -0
  28. package/dist/{skills-command-IGDVLNKY.js → skills-command-KEW7MOEW.js} +17 -7
  29. package/dist/skills-command-KEW7MOEW.js.map +1 -0
  30. package/dist/{uninstall-VBGMQQLA.js → uninstall-45XF4CHD.js} +9 -9
  31. package/dist/virtual_make-docs-first-party-skills-ECJESFL2.js +11 -0
  32. package/dist/virtual_make-docs-first-party-skills-ECJESFL2.js.map +1 -0
  33. package/package.json +5 -5
  34. package/skill-registry.json +24 -8
  35. package/skill-registry.schema.json +2 -1
  36. package/template/.make-docs/system/contracts/system-resource-contract.md +16 -0
  37. package/template/.make-docs/system-resources.catalog.json +415 -0
  38. package/template/.make-docs/system-resources.schema.json +25 -0
  39. package/dist/chunk-52FTNVXS.js.map +0 -1
  40. package/dist/chunk-GERMRLJ2.js.map +0 -1
  41. package/dist/chunk-J5QDGRZ7.js.map +0 -1
  42. package/dist/chunk-M7DMFIKU.js.map +0 -1
  43. package/dist/chunk-OR5ZVGLG.js.map +0 -1
  44. package/dist/chunk-YVSASZMT.js.map +0 -1
  45. package/dist/server-H754TA4Q.js +0 -512
  46. package/dist/server-H754TA4Q.js.map +0 -1
  47. package/dist/setup-system-JI36YJ6D.js.map +0 -1
  48. package/dist/skills-command-IGDVLNKY.js.map +0 -1
  49. package/dist/virtual_make-docs-first-party-skills-H3FC47C2.js +0 -11
  50. package/dist/virtual_make-docs-first-party-skills-H3FC47C2.js.map +0 -1
  51. /package/dist/{backup-CM7RL2Q7.js.map → backup-2OT4A6LR.js.map} +0 -0
  52. /package/dist/{chunk-LV3CBXZB.js.map → chunk-CCYP5NU2.js.map} +0 -0
  53. /package/dist/{chunk-ADVNSMA7.js.map → chunk-CMNKQM7L.js.map} +0 -0
  54. /package/dist/{chunk-7R2PPKTB.js.map → chunk-VMKG3H4B.js.map} +0 -0
  55. /package/dist/{self-36ULRIJ6.js.map → self-WYVXO23B.js.map} +0 -0
  56. /package/dist/{uninstall-VBGMQQLA.js.map → uninstall-45XF4CHD.js.map} +0 -0
package/dist/index.js CHANGED
@@ -1,11 +1,16 @@
1
1
  #!/usr/bin/env node
2
+ import {
3
+ COMPLETE_PROJECT_CAPABILITIES,
4
+ describeHarnessSupport,
5
+ resolveUnifiedSetupState
6
+ } from "./chunk-I4FADOUK.js";
2
7
  import {
3
8
  classifyCompatibilityState,
4
9
  formatCompatibilityClassification,
5
10
  importLegacyInstallationState,
6
11
  previewLegacyInstallationState,
7
12
  scopeCompatibilityToInstallPlan
8
- } from "./chunk-ADVNSMA7.js";
13
+ } from "./chunk-CMNKQM7L.js";
9
14
  import {
10
15
  Checkpoint9ReceiptProjectionError,
11
16
  MigrationSafetyError,
@@ -21,36 +26,25 @@ import {
21
26
  operationCliProjection,
22
27
  resolveCliOperationLaunch,
23
28
  serializeOperationError
24
- } from "./chunk-52FTNVXS.js";
25
- import {
26
- runBackupCommand
27
- } from "./chunk-LV3CBXZB.js";
28
- import "./chunk-GERMRLJ2.js";
29
- import {
30
- OperationError,
31
- listLifecycleRuns,
32
- loadGlobalConfig,
33
- previewStoreCompatibilityBridge,
34
- resolveProjectIdentity,
35
- writeGlobalConfig
36
- } from "./chunk-J5QDGRZ7.js";
37
- import {
38
- COMPLETE_PROJECT_CAPABILITIES,
39
- describeHarnessSupport,
40
- resolveUnifiedSetupState
41
- } from "./chunk-65QWMODG.js";
29
+ } from "./chunk-XDSWX4Y4.js";
42
30
  import {
31
+ MCP_SERVER_PROFILES,
43
32
  applyInstallPlan,
44
33
  createDefaultMakeDocsConfig,
45
34
  findReviewableManagedFileConflicts,
46
35
  getConfigRenderingLabels,
47
36
  getDocumentKindLabel,
48
37
  loadMakeDocsConfigOrThrow,
38
+ parseMcpServerProfile,
49
39
  planInstall,
50
40
  planProjectHarnessIntegrationWrite,
51
41
  registerSkillAdoptionRecovery
52
- } from "./chunk-OR5ZVGLG.js";
53
- import "./chunk-7R2PPKTB.js";
42
+ } from "./chunk-CLSOY7NV.js";
43
+ import {
44
+ runBackupCommand
45
+ } from "./chunk-CCYP5NU2.js";
46
+ import "./chunk-46MGH32G.js";
47
+ import "./chunk-VMKG3H4B.js";
54
48
  import {
55
49
  S_BAR,
56
50
  S_BAR_END,
@@ -67,17 +61,29 @@ import {
67
61
  symbol,
68
62
  wrapTextWithPrefix
69
63
  } from "./chunk-3EXHM5L2.js";
64
+ import {
65
+ OperationError,
66
+ listLifecycleRuns,
67
+ loadGlobalConfig,
68
+ previewStoreCompatibilityBridge,
69
+ resolveProjectIdentity,
70
+ writeGlobalConfig
71
+ } from "./chunk-UNR4CYVX.js";
70
72
  import {
71
73
  HARNESS_CALLER_IDENTITY_ARG,
72
74
  HARNESS_CALLER_IDENTITY_ENV,
73
75
  HARNESS_CALLER_REFERENCE_ARG,
76
+ MCP_CONNECTION_ID_ENV,
77
+ MCP_CONNECTION_KEY_ENV,
78
+ createMcpConnection,
74
79
  encodeHarnessCallerIdentity,
75
80
  parseHarnessCallerIdentity,
76
81
  parseHarnessCallerIdentityArgument,
77
82
  parseHarnessCallerReference,
83
+ redactMcpNativeValue,
78
84
  sha256,
79
85
  verifyMakeDocsExecutable
80
- } from "./chunk-M7DMFIKU.js";
86
+ } from "./chunk-ISSMVKIA.js";
81
87
  import {
82
88
  CAPABILITIES,
83
89
  CAPABILITY_DEPENDENCIES,
@@ -106,7 +112,7 @@ import {
106
112
  validateAndMigrateManifest,
107
113
  withStoreDatabase,
108
114
  writeTextFile
109
- } from "./chunk-YVSASZMT.js";
115
+ } from "./chunk-HXWD2EUD.js";
110
116
  import "./chunk-D4HDZEJT.js";
111
117
 
112
118
  // src/cli.ts
@@ -309,10 +315,16 @@ function renderBacklogSnapshot(value) {
309
315
  return lines;
310
316
  }
311
317
  var TEXT_RENDERERS = {
318
+ "backlog.review.open": renderBacklogReview,
319
+ "backlog.review.refresh": renderBacklogReview,
312
320
  "prd.authority.validate": renderPrdAuthorityValidation,
313
321
  "performance.evidence.validate": renderPerformanceEvidenceValidation,
314
322
  "work.backlog.snapshot": renderBacklogSnapshot
315
323
  };
324
+ function renderBacklogReview(value) {
325
+ const content = recordEntries(asRecord(value)?.content);
326
+ return content.length === 1 && text(content[0], "type") === "text" ? [text(content[0], "text") ?? ""] : null;
327
+ }
316
328
  function genericRenderer(value) {
317
329
  const record = asRecord(value);
318
330
  const lines = stringList(record, "lines");
@@ -524,6 +536,14 @@ var RUN_CLI_ADAPTERS = {
524
536
  )
525
537
  }
526
538
  }),
539
+ "backlog.review.open": (options) => ({ input: { report: parseJsonPayload(
540
+ requiredValue(options, "report-json", operationPath("backlog.review.open")),
541
+ "report-json"
542
+ ) } }),
543
+ "backlog.review.refresh": (options) => ({ input: { envelope: parseJsonPayload(
544
+ requiredValue(options, "envelope-json", operationPath("backlog.review.refresh")),
545
+ "envelope-json"
546
+ ) } }),
527
547
  "work.backlog-cache.lookup": (options) => ({
528
548
  input: {
529
549
  targetRoot: path.resolve(
@@ -1186,6 +1206,10 @@ var HARNESS_METADATA = {
1186
1206
  codex: {
1187
1207
  label: "Codex",
1188
1208
  hint: "AGENTS.md + .agents/"
1209
+ },
1210
+ "github-copilot": {
1211
+ label: "GitHub Copilot CLI",
1212
+ hint: "AGENTS.md + .agents/"
1189
1213
  }
1190
1214
  };
1191
1215
  var MANAGED_FILE_CONFLICT_GROUP_ORDER = [
@@ -1650,7 +1674,7 @@ function createClackWizardRenderer() {
1650
1674
  intro(title);
1651
1675
  },
1652
1676
  showProjectState(state) {
1653
- note(`Project state: ${state}.`, "Project state");
1677
+ note(`${state}.`, "Project state");
1654
1678
  },
1655
1679
  async editCapabilities(state) {
1656
1680
  return promptForCapabilities(state.selections, state.config);
@@ -2240,7 +2264,6 @@ function renderSetupProjectRecovery(review) {
2240
2264
  }
2241
2265
 
2242
2266
  // src/generic-mcp-setup.ts
2243
- import { randomBytes } from "crypto";
2244
2267
  import os from "os";
2245
2268
  import path3 from "path";
2246
2269
  function validateGenericMcpClientLabel(label) {
@@ -2257,17 +2280,18 @@ function prepareGenericMcpSetup(options) {
2257
2280
  const storeRoot = options.storeRoot ?? resolveStoreRoot();
2258
2281
  const existing = loadGlobalConfig(storeRoot).config.settings.harnesses[harnessId];
2259
2282
  const active = isCurrentGenericIntent(existing, clientLabel);
2260
- const accessCeiling = { store: "write", project: "write", hostConfig: "none" };
2283
+ const accessCeiling = existing?.accessCeiling ? { ...existing.accessCeiling } : { store: "write", project: "write", hostConfig: "none" };
2261
2284
  if (action === "remove") {
2285
+ const enabled = Boolean(existing?.selected || existing?.mcpConnection?.active);
2262
2286
  return {
2263
2287
  schemaVersion: 1,
2264
2288
  clientLabel,
2265
2289
  harnessId,
2266
2290
  action,
2267
- changed: Boolean(existing),
2268
- state: existing ? "planned" : "missing",
2291
+ changed: enabled,
2292
+ state: enabled ? "planned" : "missing",
2269
2293
  accessCeiling,
2270
- review: existing ? `Remove the Make Docs-owned generic MCP profile '${clientLabel}'. No client-owned file changes.` : `Generic MCP profile '${clientLabel}' is already absent. No client-owned file changes.`,
2294
+ review: enabled ? `Remove the Make Docs-owned generic MCP profile '${clientLabel}'. No client-owned file changes.` : `Generic MCP profile '${clientLabel}' is already absent. No client-owned file changes.`,
2271
2295
  nextAction: null,
2272
2296
  configuration: null,
2273
2297
  configurationDigest: null,
@@ -2295,40 +2319,30 @@ function prepareGenericMcpSetup(options) {
2295
2319
  const executable = options.executable ?? verifyMakeDocsExecutable({
2296
2320
  executablePath: path3.resolve(process.argv[1] ?? "")
2297
2321
  });
2298
- const proof = randomBytes(32).toString("base64url");
2299
2322
  const machineRoot = path3.resolve(options.machineRoot ?? os.homedir());
2300
- const identity = {
2301
- schemaVersion: 1,
2302
- kind: "make-docs-generic-mcp-caller",
2303
- adapterId: "generic-mcp",
2304
- adapterVersion: 1,
2305
- harnessId,
2306
- connectionMethod: "mcp",
2307
- scope: "machine",
2308
- root: machineRoot,
2309
- executable,
2310
- proof
2311
- };
2323
+ const connection = createMcpConnection(harnessId);
2312
2324
  const configuration = {
2313
2325
  mcpServers: {
2314
2326
  "make-docs": {
2315
2327
  command: executable.path,
2316
2328
  args: ["mcp"],
2317
- env: { MAKE_DOCS_HARNESS_CALLER_IDENTITY: encodeHarnessCallerIdentity(identity) }
2329
+ env: {
2330
+ [MCP_CONNECTION_ID_ENV]: connection.id,
2331
+ [MCP_CONNECTION_KEY_ENV]: connection.key
2332
+ }
2318
2333
  }
2319
2334
  }
2320
2335
  };
2321
2336
  const configurationDigest = sha256(JSON.stringify(configuration));
2322
- const priorRevision = typeof existing?.identityRevision === "number" ? existing.identityRevision : 0;
2323
2337
  const intent = {
2338
+ ...existing,
2324
2339
  selected: true,
2325
2340
  maximumMethod: "mcp",
2326
2341
  accessCeiling: { ...accessCeiling },
2327
2342
  profileKind: "generic-mcp",
2328
2343
  clientLabel,
2329
2344
  machineRoot,
2330
- proofSha256: sha256(proof),
2331
- identityRevision: priorRevision + 1,
2345
+ mcpConnection: connection.record,
2332
2346
  configurationDigest,
2333
2347
  lifecycleState: "active"
2334
2348
  };
@@ -2352,7 +2366,16 @@ function applyGenericMcpSetup(plan) {
2352
2366
  if (!plan.changed) return { ...plan, state: plan.state === "missing" ? "missing" : "current" };
2353
2367
  const loaded = loadGlobalConfig(plan.storeRoot);
2354
2368
  if (plan.action === "remove") {
2355
- delete loaded.config.settings.harnesses[plan.harnessId];
2369
+ const prior = loaded.config.settings.harnesses[plan.harnessId];
2370
+ if (prior) {
2371
+ loaded.config.settings.harnesses[plan.harnessId] = {
2372
+ ...prior,
2373
+ selected: false,
2374
+ maximumMethod: null,
2375
+ mcpConnection: prior.mcpConnection ? { ...prior.mcpConnection, active: false } : void 0,
2376
+ lifecycleState: "disabled"
2377
+ };
2378
+ }
2356
2379
  } else if (plan.intent) {
2357
2380
  loaded.config.settings.harnesses[plan.harnessId] = {
2358
2381
  ...plan.intent,
@@ -2377,7 +2400,8 @@ function renderGenericMcpSetupResult(plan) {
2377
2400
  plan.review
2378
2401
  ];
2379
2402
  if (plan.configuration) {
2380
- lines.push("Client-owned configuration object:", JSON.stringify(plan.configuration, null, 2));
2403
+ const configuration = plan.state === "planned" ? redactMcpNativeValue(plan.configuration) : plan.configuration;
2404
+ lines.push("Client-owned configuration object:", JSON.stringify(configuration, null, 2));
2381
2405
  }
2382
2406
  if (plan.nextAction) lines.push(`Next: ${plan.nextAction}`);
2383
2407
  return `${lines.join("\n")}
@@ -2385,7 +2409,7 @@ function renderGenericMcpSetupResult(plan) {
2385
2409
  }
2386
2410
  function isCurrentGenericIntent(value, clientLabel) {
2387
2411
  return Boolean(
2388
- value?.selected === true && value.maximumMethod === "mcp" && value.profileKind === "generic-mcp" && value.clientLabel === clientLabel && value.lifecycleState === "active" && typeof value.proofSha256 === "string" && /^[a-f0-9]{64}$/.test(value.proofSha256) && typeof value.configurationDigest === "string" && /^[a-f0-9]{64}$/.test(value.configurationDigest)
2412
+ value?.selected === true && value.maximumMethod === "mcp" && value.profileKind === "generic-mcp" && value.clientLabel === clientLabel && value.lifecycleState === "active" && value.mcpConnection?.active === true && value.mcpConnection.owner === `generic-mcp-${clientLabel}` && typeof value.mcpConnection.keySha256 === "string" && /^[a-f0-9]{64}$/.test(value.mcpConnection.keySha256)
2389
2413
  );
2390
2414
  }
2391
2415
 
@@ -2538,12 +2562,12 @@ async function runCli(argv = process.argv.slice(2), priorProjectRecovery = null,
2538
2562
  return;
2539
2563
  }
2540
2564
  if (parsed.command === "mcp") {
2541
- const { runMcpServer } = await import("./server-H754TA4Q.js");
2542
- await runMcpServer();
2565
+ const { runMcpServer } = await import("./server-BQOG6FTA.js");
2566
+ await runMcpServer({ profile: parsed.mcpProfile ?? "all" });
2543
2567
  return;
2544
2568
  }
2545
2569
  if (parsed.command === "update") {
2546
- const { runToolUpdateCommand } = await import("./self-36ULRIJ6.js");
2570
+ const { runToolUpdateCommand } = await import("./self-WYVXO23B.js");
2547
2571
  await runToolUpdateCommand({
2548
2572
  yes: parsed.yes,
2549
2573
  ...parsed.targetDir ? { targetDir: path4.resolve(parsed.targetDir) } : {}
@@ -2551,25 +2575,28 @@ async function runCli(argv = process.argv.slice(2), priorProjectRecovery = null,
2551
2575
  return;
2552
2576
  }
2553
2577
  if (parsed.command === "uninstall") {
2554
- const { runToolUninstallCommand } = await import("./self-36ULRIJ6.js");
2578
+ const { runToolUninstallCommand } = await import("./self-WYVXO23B.js");
2555
2579
  await runToolUninstallCommand({ yes: parsed.yes, removeStore: parsed.removeStore });
2556
2580
  return;
2557
2581
  }
2558
2582
  validateParsedArgs(parsed);
2559
2583
  if (parsed.setupSubcommand === "system") {
2560
- const { runSystemSetupCommand } = await import("./setup-system-JI36YJ6D.js");
2584
+ const { runSystemSetupCommand } = await import("./setup-system-KN7FTTLT.js");
2561
2585
  const result = await runSystemSetupCommand({
2562
2586
  dryRun: parsed.dryRun,
2563
2587
  yes: parsed.yes,
2588
+ rotateMcp: parsed.rotateMcp,
2564
2589
  promptForMethods: !parsed.yes && !parsed.dryRun && !parsed.json && Boolean(input.isTTY && output.isTTY),
2565
2590
  targetRoot: path4.resolve(parsed.targetDir ?? process.cwd()),
2566
2591
  methods: {
2567
2592
  ...parsed.codexMethod !== void 0 ? { codex: parsed.codexMethod } : {},
2568
- ...parsed.claudeCodeMethod !== void 0 ? { "claude-code": parsed.claudeCodeMethod } : {}
2593
+ ...parsed.claudeCodeMethod !== void 0 ? { "claude-code": parsed.claudeCodeMethod } : {},
2594
+ ...parsed.githubCopilotMethod !== void 0 ? { "github-copilot": parsed.githubCopilotMethod } : {}
2569
2595
  },
2570
2596
  harnesses: {
2571
2597
  "claude-code": parsed.claudeCodeMethod !== void 0 || !parsed.noClaudeCode,
2572
- codex: parsed.codexMethod !== void 0 || !parsed.noCodex
2598
+ codex: parsed.codexMethod !== void 0 || !parsed.noCodex,
2599
+ "github-copilot": parsed.githubCopilotMethod !== void 0 && !parsed.noGithubCopilot
2573
2600
  },
2574
2601
  ...!parsed.json && output.isTTY ? { onReview: (review) => note(review, "This computer") } : {}
2575
2602
  });
@@ -2634,6 +2661,7 @@ async function runCli(argv = process.argv.slice(2), priorProjectRecovery = null,
2634
2661
  remove: parsed.remove,
2635
2662
  noCodex: parsed.noCodex,
2636
2663
  noClaudeCode: parsed.noClaudeCode,
2664
+ ...parsed.noGithubCopilot ? { noGithubCopilot: true } : {},
2637
2665
  skillScope: parsed.skillScope,
2638
2666
  selectedSkills: parsed.selectedSkills === void 0 ? void 0 : [...parsed.selectedSkills],
2639
2667
  skillsManifest: parsed.skillsManifest,
@@ -2833,7 +2861,7 @@ async function runCli(argv = process.argv.slice(2), priorProjectRecovery = null,
2833
2861
  });
2834
2862
  }
2835
2863
  if (!freshInstallTarget) {
2836
- const { detectPreV2Install, promptPreV2Choice } = await import("./self-36ULRIJ6.js");
2864
+ const { detectPreV2Install, promptPreV2Choice } = await import("./self-WYVXO23B.js");
2837
2865
  const preV2 = detectPreV2Install({
2838
2866
  targetDir,
2839
2867
  classification: compatibilityClassification
@@ -2885,7 +2913,7 @@ async function runCli(argv = process.argv.slice(2), priorProjectRecovery = null,
2885
2913
  }
2886
2914
  let interactiveMethodSelections = {};
2887
2915
  if (interactive) {
2888
- const { inspectSystemHarnesses, promptForSystemSetupMethods } = await import("./setup-system-JI36YJ6D.js");
2916
+ const { inspectSystemHarnesses, promptForSystemSetupMethods } = await import("./setup-system-KN7FTTLT.js");
2889
2917
  const harnessSupport = inspectSystemHarnesses();
2890
2918
  const afterHarnessSelection = async (wizardSelections) => {
2891
2919
  interactiveMethodSelections = await promptForSystemSetupMethods({
@@ -2894,11 +2922,13 @@ async function runCli(argv = process.argv.slice(2), priorProjectRecovery = null,
2894
2922
  promptForMethods: true,
2895
2923
  methods: {
2896
2924
  ...parsed.codexMethod !== void 0 ? { codex: parsed.codexMethod } : {},
2897
- ...parsed.claudeCodeMethod !== void 0 ? { "claude-code": parsed.claudeCodeMethod } : {}
2925
+ ...parsed.claudeCodeMethod !== void 0 ? { "claude-code": parsed.claudeCodeMethod } : {},
2926
+ ...parsed.githubCopilotMethod !== void 0 ? { "github-copilot": parsed.githubCopilotMethod } : {}
2898
2927
  },
2899
2928
  harnesses: {
2900
2929
  codex: wizardSelections.harnesses.codex,
2901
- "claude-code": wizardSelections.harnesses["claude-code"]
2930
+ "claude-code": wizardSelections.harnesses["claude-code"],
2931
+ "github-copilot": wizardSelections.harnesses["github-copilot"]
2902
2932
  },
2903
2933
  projectHarnessIntegrations: makeDocsConfig.harnessIntegrations,
2904
2934
  targetRoot: targetDir,
@@ -2961,7 +2991,7 @@ async function runCli(argv = process.argv.slice(2), priorProjectRecovery = null,
2961
2991
  applyPreparedSystemSetup,
2962
2992
  prepareSystemSetupCommand,
2963
2993
  resumePendingSystemSetupCommand
2964
- } = await import("./setup-system-JI36YJ6D.js");
2994
+ } = await import("./setup-system-KN7FTTLT.js");
2965
2995
  const systemOptions = {
2966
2996
  dryRun: parsed.dryRun,
2967
2997
  yes: parsed.yes,
@@ -2969,13 +2999,16 @@ async function runCli(argv = process.argv.slice(2), priorProjectRecovery = null,
2969
2999
  methods: {
2970
3000
  ...interactiveMethodSelections,
2971
3001
  ...parsed.codexMethod !== void 0 ? { codex: parsed.codexMethod } : {},
2972
- ...parsed.claudeCodeMethod !== void 0 ? { "claude-code": parsed.claudeCodeMethod } : {}
3002
+ ...parsed.claudeCodeMethod !== void 0 ? { "claude-code": parsed.claudeCodeMethod } : {},
3003
+ ...parsed.githubCopilotMethod !== void 0 ? { "github-copilot": parsed.githubCopilotMethod } : {}
2973
3004
  },
2974
3005
  harnesses: {
2975
3006
  "claude-code": selections.harnesses["claude-code"],
2976
- codex: selections.harnesses.codex
3007
+ codex: selections.harnesses.codex,
3008
+ "github-copilot": selections.harnesses["github-copilot"]
2977
3009
  },
2978
3010
  projectHarnessIntegrations: makeDocsConfig.harnessIntegrations,
3011
+ manualMcpOutput: !jsonOutput,
2979
3012
  targetRoot: targetDir,
2980
3013
  persistIntent: true
2981
3014
  };
@@ -3479,9 +3512,9 @@ Next: ${nextAction}
3479
3512
  if (!jsonOutput && appliedGenericMcpPlan?.configuration) {
3480
3513
  output.write(renderGenericMcpSetupResult(appliedGenericMcpPlan));
3481
3514
  }
3482
- if (["blocked", "failed", "recovery"].includes(systemSetup.status)) {
3483
- if (jsonOutput) writeCanonicalSetupResult({ status: "blocked", dryRun: false, targetRoot: targetDir, system: systemSetup, prepared: preparedSystemSetup, genericMcp: appliedGenericMcpPlan, storeBridge: appliedStoreBridge, projectRecovery: priorProjectRecovery, projectChanged: recoveredProjectChanged, projectMutationState: recoveredProjectChanged ? "applied" : "none", projectActions: plan.actions, failedCondition: systemSetup.blocked[0]?.reason ?? systemSetup.status, nextAction: systemSetup.recoveryAction });
3484
- else output.write(`Setup stopped at machine scope. ${systemSetup.recoveryAction ?? "Review the machine state."}
3515
+ if (systemSetup.projectMayProceed === false || systemSetup.projectMayProceed === void 0 && ["blocked", "failed", "recovery"].includes(systemSetup.status)) {
3516
+ if (jsonOutput) writeCanonicalSetupResult({ status: "blocked", dryRun: false, targetRoot: targetDir, system: systemSetup, prepared: preparedSystemSetup, genericMcp: appliedGenericMcpPlan, storeBridge: appliedStoreBridge, projectRecovery: priorProjectRecovery, projectChanged: recoveredProjectChanged, projectMutationState: recoveredProjectChanged ? "applied" : "none", projectActions: plan.actions, failedCondition: systemSetup.blocked[0]?.reason ?? systemSetup.status, nextAction: systemSetup.nextAction });
3517
+ else output.write(`Setup stopped at machine scope. ${systemSetup.nextAction ?? "Review the machine state."}
3485
3518
  `);
3486
3519
  return;
3487
3520
  }
@@ -3644,7 +3677,7 @@ Next: ${nextAction}
3644
3677
  }
3645
3678
  if (jsonOutput) {
3646
3679
  writeCanonicalSetupResult({
3647
- status: "complete",
3680
+ status: systemSetup.status === "partial" ? "partial" : "complete",
3648
3681
  dryRun: false,
3649
3682
  targetRoot: targetDir,
3650
3683
  system: systemSetup,
@@ -3656,8 +3689,24 @@ Next: ${nextAction}
3656
3689
  projectMutationState: projectPrerequisiteChanged || applied.mutationApplied ? "applied" : "none",
3657
3690
  projectActions: applied.appliedActions,
3658
3691
  failedCondition: null,
3659
- nextAction: null
3692
+ nextAction: systemSetup.blocked[0]?.nextAction ?? null
3660
3693
  });
3694
+ } else if (systemSetup.status === "partial") {
3695
+ output.write("Project setup: ready. MCP setup still needs manual work for these platforms:\n");
3696
+ for (const item of systemSetup.blocked) {
3697
+ output.write(`- ${item.harness}: pending. ${item.reason}
3698
+ `);
3699
+ output.write(` Next: ${item.nextAction}
3700
+ `);
3701
+ const manual = systemSetup.manualInstructions?.find((entry) => entry.harness === item.harness);
3702
+ if (manual) {
3703
+ output.write(` Add this one-time MCP entry in ${manual.path} (${manual.entryId}):
3704
+ `);
3705
+ output.write(`${manual.text}
3706
+ `);
3707
+ output.write(" The client may still block this entry by policy. Run setup again after you add it.\n");
3708
+ }
3709
+ }
3661
3710
  }
3662
3711
  }
3663
3712
  async function runProjectPathHygieneCommand(argv, repair = false, launch = resolveCliOperationLaunch()) {
@@ -3833,12 +3882,14 @@ function resolveSelections(options) {
3833
3882
  if (parsed.noClaudeCode) {
3834
3883
  selections.harnesses["claude-code"] = false;
3835
3884
  }
3885
+ if (parsed.noGithubCopilot) selections.harnesses["github-copilot"] = false;
3836
3886
  if (parsed.codexMethod !== void 0) {
3837
3887
  selections.harnesses.codex = true;
3838
3888
  }
3839
3889
  if (parsed.claudeCodeMethod !== void 0) {
3840
3890
  selections.harnesses["claude-code"] = true;
3841
3891
  }
3892
+ if (parsed.githubCopilotMethod !== void 0) selections.harnesses["github-copilot"] = true;
3842
3893
  if (parsed.noSkills) {
3843
3894
  selections.skills = false;
3844
3895
  selections.selectedSkills = [];
@@ -3909,7 +3960,7 @@ function reconcileExistingInstallSkillSelection(options) {
3909
3960
  }
3910
3961
  function hasSelectionOverrides(parsed) {
3911
3962
  return Boolean(
3912
- parsed.noDesigns || parsed.noPlans || parsed.noPrd || parsed.noWork || parsed.noCodex || parsed.noClaudeCode || parsed.codexMethod !== void 0 || parsed.claudeCodeMethod !== void 0 || parsed.noSkills || parsed.skillsManifest || parsed.skillScope || parsed.selectedSkills !== void 0 || parsed.projectResources !== void 0
3963
+ parsed.noDesigns || parsed.noPlans || parsed.noPrd || parsed.noWork || parsed.noCodex || parsed.noClaudeCode || parsed.noGithubCopilot || parsed.codexMethod !== void 0 || parsed.claudeCodeMethod !== void 0 || parsed.githubCopilotMethod !== void 0 || parsed.noSkills || parsed.skillsManifest || parsed.skillScope || parsed.selectedSkills !== void 0 || parsed.projectResources !== void 0
3913
3964
  );
3914
3965
  }
3915
3966
  function isLifecycleCommand(parsed) {
@@ -3919,7 +3970,7 @@ async function loadUninstallCommand() {
3919
3970
  if (uninstallCommandLoaderOverride) {
3920
3971
  return uninstallCommandLoaderOverride();
3921
3972
  }
3922
- const uninstallModule = await import("./uninstall-VBGMQQLA.js");
3973
+ const uninstallModule = await import("./uninstall-45XF4CHD.js");
3923
3974
  if (typeof uninstallModule.runUninstallCommand !== "function") {
3924
3975
  throw new Error(
3925
3976
  "The `uninstall` command module must export `runUninstallCommand(options)`."
@@ -3932,7 +3983,7 @@ async function runSkillsCommand(options) {
3932
3983
  await skillsCommandRunnerOverride(options);
3933
3984
  return;
3934
3985
  }
3935
- const skillsModule = await import("./skills-command-IGDVLNKY.js");
3986
+ const skillsModule = await import("./skills-command-KEW7MOEW.js");
3936
3987
  await skillsModule.runSkillsCommand(options);
3937
3988
  }
3938
3989
  function getSelectionOverrideFlags(parsed) {
@@ -3955,12 +4006,14 @@ function getSelectionOverrideFlags(parsed) {
3955
4006
  if (parsed.noClaudeCode) {
3956
4007
  flags.push("--no-claude-code");
3957
4008
  }
4009
+ if (parsed.noGithubCopilot) flags.push("--no-github-copilot");
3958
4010
  if (parsed.codexMethod !== void 0) {
3959
4011
  flags.push("--codex-method");
3960
4012
  }
3961
4013
  if (parsed.claudeCodeMethod !== void 0) {
3962
4014
  flags.push("--claude-code-method");
3963
4015
  }
4016
+ if (parsed.githubCopilotMethod !== void 0) flags.push("--github-copilot-method");
3964
4017
  if (parsed.genericMcpClient !== void 0) flags.push("--generic-mcp-client");
3965
4018
  if (parsed.genericMcpAction !== void 0) flags.push("--generic-mcp-action");
3966
4019
  if (parsed.noSkills) {
@@ -3993,6 +4046,7 @@ function parseArgs(argv) {
3993
4046
  noWork: false,
3994
4047
  noCodex: false,
3995
4048
  noClaudeCode: false,
4049
+ noGithubCopilot: false,
3996
4050
  json: false,
3997
4051
  noSkills: false,
3998
4052
  runArgs: []
@@ -4039,11 +4093,23 @@ function parseArgs(argv) {
4039
4093
  return parsed;
4040
4094
  }
4041
4095
  if (parsed.command === "mcp") {
4042
- for (const arg of args) {
4096
+ while (args.length > 0) {
4097
+ const arg = args.shift();
4043
4098
  if (arg === "--help" || arg === "-h") {
4044
4099
  parsed.help = true;
4045
4100
  continue;
4046
4101
  }
4102
+ if (arg === "--profile") {
4103
+ if (parsed.mcpProfile !== void 0) {
4104
+ throw new Error("--profile can be supplied only once.");
4105
+ }
4106
+ const profile = args.shift();
4107
+ if (profile === void 0 || profile.startsWith("-")) {
4108
+ throw new Error(`--profile requires a name. Allowed profiles: ${MCP_SERVER_PROFILES.join(", ")}.`);
4109
+ }
4110
+ parsed.mcpProfile = parseMcpServerProfile(profile);
4111
+ continue;
4112
+ }
4047
4113
  throw new Error(`Unknown argument: ${arg}`);
4048
4114
  }
4049
4115
  return parsed;
@@ -4101,6 +4167,9 @@ function parseArgs(argv) {
4101
4167
  case "--no-claude":
4102
4168
  parsed.noClaudeCode = true;
4103
4169
  break;
4170
+ case "--no-github-copilot":
4171
+ parsed.noGithubCopilot = true;
4172
+ break;
4104
4173
  case "--codex-method": {
4105
4174
  const value = args.shift();
4106
4175
  if (value !== "none" && value !== "mcp" && value !== "command-rules") {
@@ -4117,6 +4186,12 @@ function parseArgs(argv) {
4117
4186
  parsed.claudeCodeMethod = value;
4118
4187
  break;
4119
4188
  }
4189
+ case "--github-copilot-method": {
4190
+ const value = args.shift();
4191
+ if (value !== "none" && value !== "mcp") throw new Error("`--github-copilot-method` must be none or mcp.");
4192
+ parsed.githubCopilotMethod = value;
4193
+ break;
4194
+ }
4120
4195
  case "--generic-mcp-client": {
4121
4196
  const value = args.shift();
4122
4197
  if (!value) throw new Error("`--generic-mcp-client` requires a stable local client label.");
@@ -4131,6 +4206,9 @@ function parseArgs(argv) {
4131
4206
  parsed.genericMcpAction = value;
4132
4207
  break;
4133
4208
  }
4209
+ case "--rotate-mcp":
4210
+ parsed.rotateMcp = true;
4211
+ break;
4134
4212
  case "--no-skills":
4135
4213
  parsed.noSkills = true;
4136
4214
  break;
@@ -4296,7 +4374,8 @@ function renderSystemSetupResult(result) {
4296
4374
  const lines = [
4297
4375
  `Machine setup: ${result.status}.`,
4298
4376
  `Codex method: ${result.selections.codex}.`,
4299
- `Claude Code method: ${result.selections["claude-code"]}.`
4377
+ `Claude Code method: ${result.selections["claude-code"]}.`,
4378
+ `GitHub Copilot method: ${result.selections["github-copilot"] ?? "none"}.`
4300
4379
  ];
4301
4380
  for (const blocked of result.blocked) {
4302
4381
  lines.push(`${blocked.harness}: ${blocked.reason}`);
@@ -4324,7 +4403,7 @@ function storePrerequisiteFailureAction(error) {
4324
4403
  return "Correct the reported Store prerequisite, then run `make-docs setup` again to review a new exact bridge plan.";
4325
4404
  }
4326
4405
  function writeCanonicalSetupResult(input2) {
4327
- const selections = input2.system?.selections ?? input2.prepared?.selections ?? { codex: "none", "claude-code": "none" };
4406
+ const selections = input2.system?.selections ?? input2.prepared?.selections ?? { codex: "none", "claude-code": "none", "github-copilot": "none" };
4328
4407
  const plans = input2.prepared?.plans ?? [];
4329
4408
  output.write(`${JSON.stringify({
4330
4409
  schemaVersion: 2,
@@ -4334,16 +4413,31 @@ function writeCanonicalSetupResult(input2) {
4334
4413
  targetRoot: input2.targetRoot,
4335
4414
  machine: {
4336
4415
  selections,
4337
- states: plans.map((plan) => ({
4338
- harness: plan.harness,
4339
- method: plan.method,
4340
- state: plan.status,
4341
- attemptedWork: [...plan.operations],
4342
- mutationState: input2.system ? input2.system.mutationState === "partial" ? "partial" : input2.system.mutationState === "verified" && plan.changed && input2.system.configured.includes(plan.harness) ? "applied" : "none" : plan.changed ? input2.dryRun ? "planned" : "none" : "none",
4343
- detail: plan.detail
4344
- })),
4416
+ projectMayProceed: input2.system?.projectMayProceed ?? null,
4417
+ states: plans.map((plan) => {
4418
+ const pending = input2.status === "partial" && input2.system?.projectMayProceed === true && !input2.system.recoveryAction && input2.system.blocked.some((item) => item.harness === plan.harness);
4419
+ const state = input2.system?.configured.includes(plan.harness) ? "current" : pending ? "pending" : plan.status;
4420
+ return {
4421
+ harness: plan.harness,
4422
+ method: plan.method,
4423
+ state,
4424
+ ...plan.harness === "github-copilot" ? { clients: [
4425
+ { client: "cli", state },
4426
+ { client: "app", state: "blocked", nextAction: "Open a real app session and verify the effective Make Docs entry. App-installed entries are user-owned." }
4427
+ ] } : {},
4428
+ attemptedWork: [...plan.operations],
4429
+ mutationState: input2.system ? input2.system.configured.includes(plan.harness) && plan.changed ? "applied" : input2.system.manualInstructions?.some((item) => item.harness === plan.harness) ? "partial" : input2.system.recoveryAction && plan.pendingOperation?.() ? "partial" : "none" : plan.changed ? input2.dryRun ? "planned" : "none" : "none",
4430
+ detail: plan.detail,
4431
+ ...input2.system?.blocked.find((item) => item.harness === plan.harness) ? {
4432
+ nextAction: input2.system.blocked.find((item) => item.harness === plan.harness).nextAction
4433
+ } : {}
4434
+ };
4435
+ }),
4345
4436
  configured: input2.system?.configured ?? [],
4346
- ...input2.genericMcp ? { genericMcp: input2.genericMcp } : {}
4437
+ ...input2.genericMcp ? { genericMcp: {
4438
+ ...input2.genericMcp,
4439
+ configuration: input2.genericMcp.configuration ? redactMcpNativeValue(input2.genericMcp.configuration) : null
4440
+ } } : {}
4347
4441
  },
4348
4442
  store: input2.storeBridge ? {
4349
4443
  state: input2.storeBridge.storeState,
@@ -4357,6 +4451,7 @@ function writeCanonicalSetupResult(input2) {
4357
4451
  } : null,
4358
4452
  projectRecovery: input2.projectRecovery ?? null,
4359
4453
  project: {
4454
+ state: input2.status === "complete" || input2.status === "partial" ? "ready" : input2.status,
4360
4455
  changed: input2.projectChanged,
4361
4456
  mutationState: input2.projectMutationState ?? (input2.projectChanged ? input2.dryRun ? "planned" : "applied" : "none"),
4362
4457
  actions: [...input2.projectActions].sort((left, right) => left.relativePath.localeCompare(right.relativePath)).map((action) => ({ path: action.relativePath, action: action.type }))
@@ -4367,13 +4462,19 @@ function writeCanonicalSetupResult(input2) {
4367
4462
  `);
4368
4463
  }
4369
4464
  function validateParsedArgs(parsed) {
4465
+ if (parsed.rotateMcp && (parsed.command !== "setup" || parsed.setupSubcommand !== "system")) {
4466
+ throw new Error("`--rotate-mcp` is valid only with `make-docs setup system`.");
4467
+ }
4370
4468
  if (parsed.codexMethod !== void 0 && parsed.noCodex) {
4371
4469
  throw new Error("`--codex-method` cannot be combined with `--no-codex`.");
4372
4470
  }
4373
4471
  if (parsed.claudeCodeMethod !== void 0 && parsed.noClaudeCode) {
4374
4472
  throw new Error("`--claude-code-method` cannot be combined with `--no-claude-code`.");
4375
4473
  }
4376
- if ((parsed.codexMethod !== void 0 || parsed.claudeCodeMethod !== void 0 || parsed.genericMcpClient !== void 0 || parsed.genericMcpAction !== void 0) && (parsed.command !== "setup" || ["skills", "backup", "remove"].includes(parsed.setupSubcommand ?? ""))) {
4474
+ if (parsed.githubCopilotMethod !== void 0 && parsed.noGithubCopilot) {
4475
+ throw new Error("`--github-copilot-method` cannot be combined with `--no-github-copilot`.");
4476
+ }
4477
+ if ((parsed.codexMethod !== void 0 || parsed.claudeCodeMethod !== void 0 || parsed.githubCopilotMethod !== void 0 || parsed.genericMcpClient !== void 0 || parsed.genericMcpAction !== void 0) && (parsed.command !== "setup" || ["skills", "backup", "remove"].includes(parsed.setupSubcommand ?? ""))) {
4377
4478
  throw new Error("Harness and generic MCP flags are valid only with setup, setup reconfigure, or setup system.");
4378
4479
  }
4379
4480
  if (parsed.json && (parsed.command !== "setup" || ["skills", "backup", "remove"].includes(parsed.setupSubcommand ?? ""))) {
@@ -4785,11 +4886,13 @@ var SETUP_SHARED_OPTIONS = `General options:
4785
4886
  Harness options:
4786
4887
  --codex-method <none|mcp|command-rules>
4787
4888
  --claude-code-method <none|mcp|permission-rules>
4889
+ --github-copilot-method <none|mcp>
4788
4890
  --generic-mcp-client <label> Add one bounded generic MCP client profile.
4789
4891
  --generic-mcp-action <configure|rotate|repair|remove>
4790
4892
  Choose its repeat-safe lifecycle action.
4791
4893
  --no-codex Skip the Codex harness.
4792
4894
  --no-claude-code Skip the Claude Code harness.
4895
+ --no-github-copilot Skip the GitHub Copilot CLI harness.
4793
4896
  Deprecated aliases: --no-agents, --no-claude
4794
4897
 
4795
4898
  Skill options:
@@ -4821,11 +4924,13 @@ Content options:
4821
4924
  Harness options:
4822
4925
  --codex-method <none|mcp|command-rules>
4823
4926
  --claude-code-method <none|mcp|permission-rules>
4927
+ --github-copilot-method <none|mcp>
4824
4928
  --generic-mcp-client <label> Add one bounded generic MCP client profile.
4825
4929
  --generic-mcp-action <configure|rotate|repair|remove>
4826
4930
  Choose its repeat-safe lifecycle action.
4827
4931
  --no-codex Skip the Codex harness.
4828
4932
  --no-claude-code Skip the Claude Code harness.
4933
+ --no-github-copilot Skip the GitHub Copilot CLI harness.
4829
4934
  Deprecated aliases: --no-agents, --no-claude
4830
4935
 
4831
4936
  Skill selections:
@@ -4841,7 +4946,7 @@ function printHelp(command, setupSubcommand) {
4841
4946
  case "system":
4842
4947
  output.write(`make-docs setup system
4843
4948
 
4844
- Review and configure machine-level support for Codex and Claude Code.
4949
+ Review and configure machine-level support for Codex, Claude Code, and GitHub Copilot CLI.
4845
4950
  Harness detection is a hint. It does not prove support and does not limit choice.
4846
4951
  Each planned method names the operations it enables and the machine files it changes.
4847
4952
 
@@ -4855,15 +4960,19 @@ Options:
4855
4960
  --json Emit only the canonical setup result JSON.
4856
4961
  --codex-method <none|mcp|command-rules>
4857
4962
  --claude-code-method <none|mcp|permission-rules>
4963
+ --github-copilot-method <none|mcp>
4858
4964
  --generic-mcp-client <label> Print a bounded client-owned MCP configuration.
4859
4965
  --generic-mcp-action <configure|rotate|repair|remove>
4860
4966
  --no-codex Skip Codex support.
4861
4967
  --no-claude-code Skip Claude Code support.
4968
+ --no-github-copilot Skip GitHub Copilot CLI support.
4969
+ --rotate-mcp Replace keys for selected first-party MCP methods.
4862
4970
  --help, -h Show help for this command.
4863
4971
 
4864
4972
  Examples:
4865
4973
  make-docs setup system --codex-method mcp --claude-code-method none --dry-run
4866
4974
  make-docs setup system --codex-method command-rules --no-claude-code --yes
4975
+ make-docs setup system --github-copilot-method mcp --no-codex --no-claude-code --dry-run
4867
4976
  `);
4868
4977
  return;
4869
4978
  case "reconfigure":
@@ -5090,14 +5199,29 @@ Examples:
5090
5199
  Run the TypeScript-owned make-docs MCP server over stdio.
5091
5200
 
5092
5201
  Usage:
5093
- make-docs mcp [--help]
5202
+ make-docs mcp [--profile <name>] [--help]
5203
+
5204
+ Options:
5205
+ --profile <name> Choose tools and native resources for one task. Default: all.
5206
+ --help, -h Show help for this command.
5207
+
5208
+ Profiles:
5209
+ core Installed state, config, common resource tools, and operation domains.
5210
+ setup Install plans, repair, compatibility, and layout.
5211
+ workflow Lifecycle, project context, and work evidence.
5212
+ quality Requirements, performance evidence, and user test checks.
5213
+ backlog Backlog snapshots and the review cache.
5214
+ all All ready tools and native resources.
5094
5215
 
5095
5216
  Behavior:
5217
+ The default all profile keeps the existing single-server connection working.
5218
+ Native resource lists and reads use the selected profile.
5096
5219
  The MCP server exposes read-first and plan-first tools for installed-state inspection, manifest/config reads, compatibility classification, dry-run install planning, and deterministic registry operations.
5097
5220
  MCP tools delegate to the same operation registry and core used by \`make-docs run\`; write operations require allowWrite=true, enforced uniformly by the operation core.
5098
5221
 
5099
5222
  Examples:
5100
5223
  make-docs mcp
5224
+ make-docs mcp --profile backlog
5101
5225
  `);
5102
5226
  return;
5103
5227
  case "update":