@brucewaynedecoy/make-docs 2.0.3 → 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 (63) hide show
  1. package/README.md +1 -1
  2. package/dist/{backup-GCM64IPN.js → backup-2OT4A6LR.js} +5 -5
  3. package/dist/chunk-3EXHM5L2.js +1225 -0
  4. package/dist/chunk-3EXHM5L2.js.map +1 -0
  5. package/dist/{chunk-2HNJCJJE.js → chunk-46MGH32G.js} +6 -4
  6. package/dist/chunk-46MGH32G.js.map +1 -0
  7. package/dist/{chunk-O2UZ35PV.js → chunk-CCYP5NU2.js} +20 -20
  8. package/dist/{chunk-O2UZ35PV.js.map → chunk-CCYP5NU2.js.map} +1 -1
  9. package/dist/{chunk-C2IBRVUA.js → chunk-CLSOY7NV.js} +153 -6
  10. package/dist/chunk-CLSOY7NV.js.map +1 -0
  11. package/dist/{chunk-GPVKIBFC.js → chunk-CMNKQM7L.js} +3 -3
  12. package/dist/{chunk-U25GFKNZ.js → chunk-HXWD2EUD.js} +20 -15
  13. package/dist/chunk-HXWD2EUD.js.map +1 -0
  14. package/dist/{chunk-DNDM7DUQ.js → chunk-I4FADOUK.js} +3 -3
  15. package/dist/{chunk-DNDM7DUQ.js.map → chunk-I4FADOUK.js.map} +1 -1
  16. package/dist/{chunk-DFQJENNL.js → chunk-ISSMVKIA.js} +224 -20
  17. package/dist/chunk-ISSMVKIA.js.map +1 -0
  18. package/dist/{chunk-IHMZ2OCS.js → chunk-UNR4CYVX.js} +116 -37
  19. package/dist/chunk-UNR4CYVX.js.map +1 -0
  20. package/dist/{chunk-57GN6ALR.js → chunk-VMKG3H4B.js} +2 -2
  21. package/dist/{chunk-4LLSMDWJ.js → chunk-XDSWX4Y4.js} +9085 -2912
  22. package/dist/chunk-XDSWX4Y4.js.map +1 -0
  23. package/dist/index.js +308 -176
  24. package/dist/index.js.map +1 -1
  25. package/dist/registry-PC5GKAKM.js +50 -0
  26. package/dist/registry-PC5GKAKM.js.map +1 -0
  27. package/dist/{self-UHPM4A2U.js → self-WYVXO23B.js} +18 -18
  28. package/dist/{self-UHPM4A2U.js.map → self-WYVXO23B.js.map} +1 -1
  29. package/dist/server-BQOG6FTA.js +1113 -0
  30. package/dist/server-BQOG6FTA.js.map +1 -0
  31. package/dist/{setup-system-JUHGDZJW.js → setup-system-KN7FTTLT.js} +267 -44
  32. package/dist/setup-system-KN7FTTLT.js.map +1 -0
  33. package/dist/{skills-command-W3SE3OFP.js → skills-command-KEW7MOEW.js} +39 -29
  34. package/dist/skills-command-KEW7MOEW.js.map +1 -0
  35. package/dist/{uninstall-BGMJ6KCI.js → uninstall-45XF4CHD.js} +10 -10
  36. package/dist/virtual_make-docs-first-party-skills-ECJESFL2.js +11 -0
  37. package/dist/virtual_make-docs-first-party-skills-ECJESFL2.js.map +1 -0
  38. package/package.json +8 -8
  39. package/skill-registry.json +24 -8
  40. package/skill-registry.schema.json +2 -1
  41. package/template/.make-docs/system/contracts/output-contract.md +3 -1
  42. package/template/.make-docs/system/contracts/system-resource-contract.md +16 -0
  43. package/template/.make-docs/system/references/prd-change-management.md +14 -2
  44. package/template/.make-docs/system-resources.catalog.json +415 -0
  45. package/template/.make-docs/system-resources.schema.json +25 -0
  46. package/dist/chunk-2HNJCJJE.js.map +0 -1
  47. package/dist/chunk-4LLSMDWJ.js.map +0 -1
  48. package/dist/chunk-C2IBRVUA.js.map +0 -1
  49. package/dist/chunk-DFQJENNL.js.map +0 -1
  50. package/dist/chunk-IHMZ2OCS.js.map +0 -1
  51. package/dist/chunk-U25GFKNZ.js.map +0 -1
  52. package/dist/chunk-Z5K4FHYP.js +0 -922
  53. package/dist/chunk-Z5K4FHYP.js.map +0 -1
  54. package/dist/server-N7XAAV3X.js +0 -512
  55. package/dist/server-N7XAAV3X.js.map +0 -1
  56. package/dist/setup-system-JUHGDZJW.js.map +0 -1
  57. package/dist/skills-command-W3SE3OFP.js.map +0 -1
  58. package/dist/virtual_make-docs-first-party-skills-VXSUUHTL.js +0 -11
  59. package/dist/virtual_make-docs-first-party-skills-VXSUUHTL.js.map +0 -1
  60. /package/dist/{backup-GCM64IPN.js.map → backup-2OT4A6LR.js.map} +0 -0
  61. /package/dist/{chunk-GPVKIBFC.js.map → chunk-CMNKQM7L.js.map} +0 -0
  62. /package/dist/{chunk-57GN6ALR.js.map → chunk-VMKG3H4B.js.map} +0 -0
  63. /package/dist/{uninstall-BGMJ6KCI.js.map → uninstall-45XF4CHD.js.map} +0 -0
@@ -2,21 +2,21 @@
2
2
  import {
3
3
  createAuditReport,
4
4
  getProjectBackupRoot
5
- } from "./chunk-2HNJCJJE.js";
5
+ } from "./chunk-46MGH32G.js";
6
6
  import {
7
- Ct,
8
- Gt,
9
- Rt,
10
- Vt,
11
- Wt
12
- } from "./chunk-Z5K4FHYP.js";
7
+ confirm,
8
+ intro,
9
+ isCancel,
10
+ note,
11
+ outro
12
+ } from "./chunk-3EXHM5L2.js";
13
13
  import {
14
14
  ensureParentDir,
15
15
  loadManifest,
16
16
  preparePlannedFileChange,
17
17
  sealInstallationOperation,
18
18
  withInstallationOperation
19
- } from "./chunk-U25GFKNZ.js";
19
+ } from "./chunk-HXWD2EUD.js";
20
20
 
21
21
  // src/backup.ts
22
22
  import {
@@ -35,7 +35,7 @@ var lifecycleRenderer = createClackLifecycleRenderer();
35
35
  function createClackLifecycleRenderer() {
36
36
  return {
37
37
  beginWorkflow(title) {
38
- Wt(title);
38
+ intro(title);
39
39
  },
40
40
  renderBackupAuditSummary(options) {
41
41
  renderAuditNote({
@@ -72,18 +72,18 @@ function createClackLifecycleRenderer() {
72
72
  });
73
73
  },
74
74
  renderBackupNoopSummary() {
75
- Gt(
75
+ outro(
76
76
  "No make-docs-managed files required backup. No backup destination was created."
77
77
  );
78
78
  },
79
79
  renderBackupCancelled() {
80
- Gt("Backup cancelled.");
80
+ outro("Backup cancelled.");
81
81
  },
82
82
  renderBackupCompletionSummary(result) {
83
83
  if (result.status !== "completed" || !result.destinationDir) {
84
84
  return;
85
85
  }
86
- Vt(
86
+ note(
87
87
  [
88
88
  `Destination: ${result.destinationDir}`,
89
89
  `Copied files: ${result.copiedFiles.length}`,
@@ -103,7 +103,7 @@ function createClackLifecycleRenderer() {
103
103
  lines.push("Safer alternative: make-docs setup backup");
104
104
  lines.push("Safer destructive flow: make-docs setup remove --backup");
105
105
  }
106
- Vt(lines.join("\n"), "WARNING");
106
+ note(lines.join("\n"), "WARNING");
107
107
  },
108
108
  confirmUninstallWarning(permissions) {
109
109
  return confirmLifecycleCheckpoint({
@@ -149,10 +149,10 @@ function createClackLifecycleRenderer() {
149
149
  });
150
150
  },
151
151
  renderUninstallCancelled() {
152
- Gt("Uninstall cancelled. No files were changed.");
152
+ outro("Uninstall cancelled. No files were changed.");
153
153
  },
154
154
  renderUninstallCompletionSummary(options) {
155
- Vt(
155
+ note(
156
156
  [
157
157
  `Files removed: ${options.removedFiles.length}`,
158
158
  `Directories pruned: ${options.prunedDirectories.length}`,
@@ -164,7 +164,7 @@ function createClackLifecycleRenderer() {
164
164
  );
165
165
  },
166
166
  renderUninstallFailureSummary(options) {
167
- Vt(
167
+ note(
168
168
  [
169
169
  `Files removed before failure: ${options.removedFiles.length}`,
170
170
  `Directories pruned before failure: ${options.prunedDirectories.length}`,
@@ -208,7 +208,7 @@ function buildUninstallAuditSummaryLines(options) {
208
208
  ];
209
209
  }
210
210
  function renderAuditNote(options) {
211
- Vt(
211
+ note(
212
212
  [...options.lines, "", ...formatEntryGroups(options.groups)].join("\n"),
213
213
  options.title
214
214
  );
@@ -310,14 +310,14 @@ async function confirmLifecycleCheckpoint(options) {
310
310
  if (!input.isTTY || !output.isTTY) {
311
311
  throw new Error(options.ttyError);
312
312
  }
313
- const proceed = await Rt({
313
+ const proceed = await confirm({
314
314
  message: options.message,
315
315
  initialValue: true,
316
316
  active: "Yes",
317
317
  inactive: "No",
318
318
  withGuide: true
319
319
  });
320
- return !(Ct(proceed) || !proceed);
320
+ return !(isCancel(proceed) || !proceed);
321
321
  }
322
322
 
323
323
  // src/backup.ts
@@ -520,4 +520,4 @@ export {
520
520
  executePreparedBackup,
521
521
  resolveBackupDestinationPlan
522
522
  };
523
- //# sourceMappingURL=chunk-O2UZ35PV.js.map
523
+ //# sourceMappingURL=chunk-CCYP5NU2.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/backup.ts","../src/lifecycle-ui.ts"],"sourcesContent":["import {\n copyFileSync,\n existsSync,\n mkdirSync,\n readdirSync,\n readFileSync,\n} from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { preparePlannedFileChange, sealInstallationOperation, withInstallationOperation } from \"./store/installation-state\";\nimport { createAuditReport } from \"./audit\";\nimport { getProjectBackupRoot } from \"./backup-paths\";\nimport { getLifecycleRenderer } from \"./lifecycle-ui\";\nimport { loadManifest } from \"./manifest\";\nimport type {\n AuditReport,\n AuditPrunableDirectory,\n AuditRemovableFile,\n BackupCommandOptions,\n BackupDestinationPlan,\n BackupExecutionResult,\n} from \"./types\";\nimport { ensureParentDir } from \"./utils\";\n\ntype CopyableAuditRemovableFile = AuditRemovableFile & {\n backupRelativePath: string;\n};\n\ntype MaterializableAuditDirectory = AuditPrunableDirectory & {\n backupRelativePath: string;\n};\n\nexport type PrepareBackupExecutionOptions = {\n targetDir: string;\n homeDir?: string;\n now?: Date;\n auditReport?: AuditReport;\n destinationPlan?: BackupDestinationPlan | null;\n};\n\nexport type PreparedBackupExecution = {\n targetDir: string;\n auditReport: AuditReport;\n destinationPlan: BackupDestinationPlan | null;\n copyableFiles: CopyableAuditRemovableFile[];\n materializableDirectories: MaterializableAuditDirectory[];\n};\n\nexport function compareBackupRelativePathDepth(\n left: string,\n right: string,\n): number {\n const depth = (value: string) => value.split(/[\\\\/]+/u).filter(Boolean).length;\n return depth(left) - depth(right);\n}\n\nexport async function runBackupCommand(\n options: BackupCommandOptions,\n): Promise<BackupExecutionResult> {\n const renderer = getLifecycleRenderer();\n renderer.beginWorkflow(\"make-docs setup backup\");\n const preparedBackup = await prepareBackupExecution(options);\n\n renderer.renderBackupAuditSummary({\n auditReport: preparedBackup.auditReport,\n destinationDir: preparedBackup.destinationPlan?.destinationDir ?? null,\n copyableFiles: preparedBackup.copyableFiles,\n materializableDirectories: preparedBackup.materializableDirectories,\n });\n\n if (!hasBackupWork(preparedBackup)) {\n renderer.renderBackupNoopSummary();\n return createNoopBackupResult(preparedBackup);\n }\n\n const destinationPlan = preparedBackup.destinationPlan;\n if (!destinationPlan) {\n throw new Error(\n \"Backup destination plan is required when audited entries are copyable.\",\n );\n }\n\n const shouldProceed = await renderer.confirmBackupRun(options.permissions);\n if (!shouldProceed) {\n renderer.renderBackupCancelled();\n return {\n status: \"cancelled\",\n targetDir: preparedBackup.targetDir,\n destinationDir: destinationPlan.destinationDir,\n auditReport: preparedBackup.auditReport,\n copiedFiles: [],\n materializedDirectories: [],\n };\n }\n\n const result = executePreparedBackup(preparedBackup);\n renderer.renderBackupCompletionSummary(result);\n return result;\n}\n\nexport async function prepareBackupExecution(\n options: PrepareBackupExecutionOptions,\n): Promise<PreparedBackupExecution> {\n const targetDir = path.resolve(options.targetDir);\n const homeDir = path.resolve(options.homeDir ?? os.homedir());\n const auditReport =\n options.auditReport ??\n (await createAuditReport({\n targetDir,\n manifest: loadManifest(targetDir),\n homeDir,\n }));\n\n const copyableFiles = auditReport.removableFiles.filter(hasBackupRelativePath);\n const materializableDirectories = auditReport.prunableDirectories.filter(\n hasBackupRelativePath,\n );\n const materializableManagedDirectories = auditReport.removableFiles\n .filter((entry) => entry.kind === \"directory\")\n .filter(hasBackupRelativePath)\n .map((entry): MaterializableAuditDirectory => ({\n ...entry,\n kind: \"directory\",\n removableDescendantPaths: [],\n preservedDescendantPaths: [],\n }));\n const hasCopyableEntries =\n copyableFiles.length > 0 ||\n materializableDirectories.length > 0 ||\n materializableManagedDirectories.length > 0;\n const hasProvidedDestinationPlan = Object.hasOwn(options, \"destinationPlan\");\n const destinationPlan = hasCopyableEntries\n ? hasProvidedDestinationPlan\n ? options.destinationPlan ?? null\n : resolveBackupDestinationPlan(targetDir, options.now ?? new Date())\n : null;\n\n if (hasCopyableEntries && !destinationPlan) {\n throw new Error(\n \"Backup destination plan is required when audited entries are copyable.\",\n );\n }\n\n return {\n targetDir,\n auditReport,\n destinationPlan,\n copyableFiles: copyableFiles.filter((entry) => entry.kind === \"file\"),\n materializableDirectories: [\n ...materializableDirectories,\n ...materializableManagedDirectories,\n ],\n };\n}\n\nexport function executePreparedBackup(\n preparedBackup: PreparedBackupExecution,\n): BackupExecutionResult {\n if (!hasBackupWork(preparedBackup)) {\n return createNoopBackupResult(preparedBackup);\n }\n\n if (!preparedBackup.destinationPlan) {\n throw new Error(\n \"Backup destination plan is required before copying audited backup entries.\",\n );\n }\n\n return withInstallationOperation(preparedBackup.targetDir, \"setup.backup\", () => {\n const targetDir = preparedBackup.targetDir;\n const destination = preparedBackup.destinationPlan!.destinationDir;\n if (preparedBackup.destinationPlan!.promotion) throw new Error(\"Create a fresh backup plan. Existing backup paths must remain stable.\");\n if (existsSync(destination)) throw new Error(`Backup destination already exists: ${destination}. Re-run the command to resolve a fresh destination.`);\n const changes: Array<() => void> = [preparePlannedFileChange(targetDir, path.relative(targetDir, destination), { kind: \"directory\" }, () => mkdirSync(destination, { recursive: true }))];\n const copiedFiles: string[] = [];\n const materializedDirectories: string[] = [];\n for (const directory of [...preparedBackup.materializableDirectories].sort((a, b) =>\n compareBackupRelativePathDepth(a.backupRelativePath, b.backupRelativePath))) {\n const relative = directory.backupRelativePath;\n if (!relative || relative === \".\") continue;\n const absolute = path.join(destination, relative);\n changes.push(preparePlannedFileChange(targetDir, path.relative(targetDir, absolute), { kind: \"directory\" }, () => mkdirSync(absolute, { recursive: true })));\n materializedDirectories.push(relative);\n }\n for (const file of preparedBackup.copyableFiles) {\n const destinationPath = path.join(destination, file.backupRelativePath);\n const content = readFileSync(file.absolutePath);\n changes.push(preparePlannedFileChange(targetDir, path.relative(targetDir, destinationPath), { kind: \"file\", content }, () => {\n ensureParentDir(destinationPath);\n copyFileSync(file.absolutePath, destinationPath);\n }));\n copiedFiles.push(file.backupRelativePath);\n }\n sealInstallationOperation(targetDir);\n for (const change of changes) change();\n\n return {\n status: \"completed\",\n targetDir: preparedBackup.targetDir,\n destinationDir: preparedBackup.destinationPlan!.destinationDir,\n auditReport: preparedBackup.auditReport,\n copiedFiles,\n materializedDirectories,\n };\n });\n}\n\nexport function resolveBackupDestinationPlan(\n targetDir: string,\n now: Date,\n): BackupDestinationPlan {\n const backupRoot = getProjectBackupRoot(targetDir);\n const dateStamp = formatDateStamp(now);\n const plainDirectory = path.join(backupRoot, dateStamp);\n const existingOrdinals = collectExistingOrdinals(backupRoot, dateStamp);\n const hasPlainDirectory = existsSync(plainDirectory);\n\n if (!hasPlainDirectory && existingOrdinals.length === 0) {\n return {\n backupRoot,\n dateStamp,\n directoryName: dateStamp,\n destinationDir: plainDirectory,\n };\n }\n\n const usedOrdinals = new Set(existingOrdinals);\n let promotion: BackupDestinationPlan[\"promotion\"];\n\n // A completed backup path is a durable payload reference. Never rename it.\n if (hasPlainDirectory) usedOrdinals.add(0);\n\n const nextOrdinal = Math.max(...usedOrdinals, 0) + 1;\n const directoryName = `${dateStamp}-${formatOrdinal(nextOrdinal)}`;\n\n return {\n backupRoot,\n dateStamp,\n directoryName,\n destinationDir: path.join(backupRoot, directoryName),\n promotion,\n };\n}\n\nfunction collectExistingOrdinals(backupRoot: string, dateStamp: string): number[] {\n if (!existsSync(backupRoot)) {\n return [];\n }\n\n const pattern = new RegExp(`^${escapeRegExp(dateStamp)}-(\\\\d+)$`);\n return readdirSync(backupRoot)\n .map((entryName) => {\n const match = pattern.exec(entryName);\n if (!match) {\n return null;\n }\n\n return Number.parseInt(match[1] ?? \"\", 10);\n })\n .filter((value): value is number => Number.isInteger(value))\n .sort((left, right) => left - right);\n}\n\nfunction findLowestAvailableOrdinal(usedOrdinals: Set<number>): number {\n let ordinal = 1;\n while (usedOrdinals.has(ordinal)) {\n ordinal += 1;\n }\n return ordinal;\n}\n\nfunction hasBackupRelativePath<T extends { backupRelativePath: string | null }>(\n entry: T,\n): entry is T & { backupRelativePath: string } {\n return typeof entry.backupRelativePath === \"string\";\n}\n\nfunction hasBackupWork(preparedBackup: PreparedBackupExecution): boolean {\n return (\n preparedBackup.copyableFiles.length > 0 ||\n preparedBackup.materializableDirectories.length > 0\n );\n}\n\nfunction createNoopBackupResult(\n preparedBackup: PreparedBackupExecution,\n): BackupExecutionResult {\n return {\n status: \"noop\",\n targetDir: preparedBackup.targetDir,\n destinationDir: null,\n auditReport: preparedBackup.auditReport,\n copiedFiles: [],\n materializedDirectories: [],\n };\n}\n\nfunction formatDateStamp(now: Date): string {\n const year = now.getFullYear();\n const month = String(now.getMonth() + 1).padStart(2, \"0\");\n const day = String(now.getDate()).padStart(2, \"0\");\n return `${year}-${month}-${day}`;\n}\n\nfunction formatOrdinal(ordinal: number): string {\n return String(ordinal).padStart(2, \"0\");\n}\n\nfunction escapeRegExp(value: string): string {\n return value.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n","import { stdin as input, stdout as output } from \"node:process\";\nimport { confirm, intro, isCancel, note, outro } from \"@clack/prompts\";\nimport type {\n AuditPathMetadata,\n AuditPluginSelectionReview,\n AuditPreservedPath,\n AuditPrunableDirectory,\n AuditRemovableFile,\n AuditReport,\n AuditSkillSelectionReview,\n AuditSkippedPath,\n BackupExecutionResult,\n LifecyclePermissionsMode,\n PluginManifestSelectionSource,\n SkillManifestSelectionSource,\n} from \"./types\";\n\ntype LifecycleRenderableEntry =\n | AuditRemovableFile\n | AuditPrunableDirectory\n | AuditPreservedPath\n | AuditSkippedPath;\n\nexport type LifecycleAuditSummaryOptions = {\n auditReport: AuditReport;\n destinationDir: string | null;\n copyableFiles: AuditRemovableFile[];\n materializableDirectories: AuditPrunableDirectory[];\n};\n\nexport type LifecycleUninstallWarningOptions = {\n targetDir: string;\n backupDestinationDir: string | null;\n};\n\nexport type LifecycleUninstallAuditSummaryOptions = {\n auditReport: AuditReport;\n backupDestinationDir: string | null;\n};\n\nexport type LifecycleUninstallRunConfirmationOptions = {\n permissions: LifecyclePermissionsMode;\n backupRequested: boolean;\n};\n\nexport type LifecycleUninstallCompletionSummaryOptions = {\n auditReport: AuditReport;\n removedFiles: string[];\n prunedDirectories: string[];\n backupResult: BackupExecutionResult | null;\n};\n\nexport type LifecycleUninstallFailureSummaryOptions =\n LifecycleUninstallCompletionSummaryOptions & {\n errorMessage: string;\n };\n\nexport interface LifecycleRenderer {\n beginWorkflow(title: string): void;\n renderBackupAuditSummary(options: LifecycleAuditSummaryOptions): void;\n confirmBackupRun(permissions: LifecyclePermissionsMode): Promise<boolean>;\n renderBackupNoopSummary(): void;\n renderBackupCancelled(): void;\n renderBackupCompletionSummary(result: BackupExecutionResult): void;\n renderUninstallWarning(options: LifecycleUninstallWarningOptions): void;\n confirmUninstallWarning(\n permissions: LifecyclePermissionsMode,\n ): Promise<boolean>;\n renderUninstallAuditSummary(\n options: LifecycleUninstallAuditSummaryOptions,\n ): void;\n confirmUninstallRun(\n options: LifecycleUninstallRunConfirmationOptions,\n ): Promise<boolean>;\n renderUninstallCancelled(): void;\n renderUninstallCompletionSummary(\n options: LifecycleUninstallCompletionSummaryOptions,\n ): void;\n renderUninstallFailureSummary(\n options: LifecycleUninstallFailureSummaryOptions,\n ): void;\n}\n\nlet lifecycleRenderer: LifecycleRenderer = createClackLifecycleRenderer();\n\nexport function createClackLifecycleRenderer(): LifecycleRenderer {\n return {\n beginWorkflow(title) {\n intro(title);\n },\n renderBackupAuditSummary(options) {\n renderAuditNote({\n title: \"make-docs setup backup\",\n lines: buildBackupAuditSummaryLines(options),\n groups: [\n formatEntryGroup(\n \"Files to copy\",\n options.copyableFiles,\n (entry) => `${formatPath(entry)} (${entry.reason})`,\n ),\n formatEntryGroup(\n \"Directories to materialize\",\n options.materializableDirectories,\n ),\n formatEntryGroup(\n \"Retained paths\",\n options.auditReport.preservedPaths,\n (entry) => `${formatPath(entry)} (${entry.reason})`,\n ),\n formatEntryGroup(\n \"Skipped paths\",\n options.auditReport.skippedPaths,\n (entry) => `${formatPath(entry)} (${entry.reason})`,\n ),\n ],\n });\n },\n confirmBackupRun(permissions) {\n return confirmLifecycleCheckpoint({\n permissions,\n message: \"Create this backup?\",\n ttyError:\n \"Backup confirmation requires a TTY. Re-run with `make-docs setup backup --yes`.\",\n });\n },\n renderBackupNoopSummary() {\n outro(\n \"No make-docs-managed files required backup. No backup destination was created.\",\n );\n },\n renderBackupCancelled() {\n outro(\"Backup cancelled.\");\n },\n renderBackupCompletionSummary(result) {\n if (result.status !== \"completed\" || !result.destinationDir) {\n return;\n }\n\n note(\n [\n `Destination: ${result.destinationDir}`,\n `Copied files: ${result.copiedFiles.length}`,\n `Materialized directories: ${result.materializedDirectories.length}`,\n `Retained paths surfaced: ${result.auditReport.preservedPaths.length}`,\n `Skipped paths surfaced: ${result.auditReport.skippedPaths.length}`,\n ].join(\"\\n\"),\n \"Backup complete\",\n );\n },\n renderUninstallWarning(options) {\n const lines = [\"This command removes audited make-docs-managed paths\", \"\"];\n\n if (options.backupDestinationDir) {\n lines.push(\"A backup will be created before removal begins.\");\n lines.push(`Backup destination: ${options.backupDestinationDir}`);\n } else {\n lines.push(\"Safer alternative: make-docs setup backup\");\n lines.push(\"Safer destructive flow: make-docs setup remove --backup\");\n }\n\n note(lines.join(\"\\n\"), \"WARNING\");\n },\n confirmUninstallWarning(permissions) {\n return confirmLifecycleCheckpoint({\n permissions,\n message: \"Continue with uninstall review?\",\n ttyError:\n \"Uninstall confirmation requires a TTY. Re-run with `make-docs setup remove --yes`.\",\n });\n },\n renderUninstallAuditSummary(options) {\n renderAuditNote({\n title: \"make-docs setup remove\",\n lines: buildUninstallAuditSummaryLines(options),\n groups: [\n formatEntryGroup(\n \"Files to remove\",\n options.auditReport.removableFiles,\n (entry) => `${formatPath(entry)} (${entry.reason})`,\n ),\n formatEntryGroup(\n \"Directories to prune\",\n options.auditReport.prunableDirectories,\n (entry) => `${formatPath(entry)} (${entry.reason})`,\n ),\n formatEntryGroup(\n \"Preserved paths\",\n options.auditReport.preservedPaths,\n (entry) => `${formatPath(entry)} (${entry.reason})`,\n ),\n formatEntryGroup(\n \"Skipped paths\",\n options.auditReport.skippedPaths,\n (entry) => `${formatPath(entry)} (${entry.reason})`,\n ),\n ],\n });\n },\n confirmUninstallRun(options) {\n const message = options.backupRequested\n ? \"Create the backup and then remove these audited paths? This action cannot be undone.\"\n : \"Remove these audited paths? This action cannot be undone.\";\n\n return confirmLifecycleCheckpoint({\n permissions: options.permissions,\n message,\n ttyError:\n \"Uninstall confirmation requires a TTY. Re-run with `make-docs setup remove --yes`.\",\n });\n },\n renderUninstallCancelled() {\n outro(\"Uninstall cancelled. No files were changed.\");\n },\n renderUninstallCompletionSummary(options) {\n note(\n [\n `Files removed: ${options.removedFiles.length}`,\n `Directories pruned: ${options.prunedDirectories.length}`,\n `Preserved paths: ${options.auditReport.preservedPaths.length}`,\n `Skipped paths: ${options.auditReport.skippedPaths.length}`,\n `Backup: ${formatBackupStatus(options.backupResult)}`,\n ].join(\"\\n\"),\n \"Uninstall complete\",\n );\n },\n renderUninstallFailureSummary(options) {\n note(\n [\n `Files removed before failure: ${options.removedFiles.length}`,\n `Directories pruned before failure: ${options.prunedDirectories.length}`,\n `Preserved paths: ${options.auditReport.preservedPaths.length}`,\n `Skipped paths: ${options.auditReport.skippedPaths.length}`,\n `Backup: ${formatBackupStatus(options.backupResult)}`,\n `Error: ${options.errorMessage}`,\n ].join(\"\\n\"),\n \"Uninstall partially completed\",\n );\n },\n };\n}\n\nexport function getLifecycleRenderer(): LifecycleRenderer {\n return lifecycleRenderer;\n}\n\nexport function __setLifecycleRendererForTests(\n renderer: LifecycleRenderer | null,\n): void {\n lifecycleRenderer = renderer ?? createClackLifecycleRenderer();\n}\n\nexport function beginLifecycleWorkflow(title: string): void {\n getLifecycleRenderer().beginWorkflow(title);\n}\n\nexport function renderBackupAuditSummary(\n options: LifecycleAuditSummaryOptions,\n): void {\n getLifecycleRenderer().renderBackupAuditSummary(options);\n}\n\nexport async function confirmBackupRun(\n permissions: LifecyclePermissionsMode,\n): Promise<boolean> {\n return getLifecycleRenderer().confirmBackupRun(permissions);\n}\n\nexport function renderUninstallWarning(\n options: LifecycleUninstallWarningOptions,\n): void {\n getLifecycleRenderer().renderUninstallWarning(options);\n}\n\nexport async function confirmUninstallWarning(\n permissions: LifecyclePermissionsMode,\n): Promise<boolean> {\n return getLifecycleRenderer().confirmUninstallWarning(permissions);\n}\n\nexport function renderUninstallAuditSummary(\n options: LifecycleUninstallAuditSummaryOptions,\n): void {\n getLifecycleRenderer().renderUninstallAuditSummary(options);\n}\n\nexport async function confirmUninstallRun(\n options: LifecycleUninstallRunConfirmationOptions,\n): Promise<boolean> {\n return getLifecycleRenderer().confirmUninstallRun(options);\n}\n\nexport function renderUninstallCancelled(): void {\n getLifecycleRenderer().renderUninstallCancelled();\n}\n\nexport function renderUninstallCompletionSummary(\n options: LifecycleUninstallCompletionSummaryOptions,\n): void {\n getLifecycleRenderer().renderUninstallCompletionSummary(options);\n}\n\nexport function renderUninstallFailureSummary(\n options: LifecycleUninstallFailureSummaryOptions,\n): void {\n getLifecycleRenderer().renderUninstallFailureSummary(options);\n}\n\nexport function renderBackupNoopSummary(): void {\n getLifecycleRenderer().renderBackupNoopSummary();\n}\n\nexport function renderBackupCancelled(): void {\n getLifecycleRenderer().renderBackupCancelled();\n}\n\nexport function renderBackupCompletionSummary(\n result: BackupExecutionResult,\n): void {\n getLifecycleRenderer().renderBackupCompletionSummary(result);\n}\n\nfunction buildBackupAuditSummaryLines(options: LifecycleAuditSummaryOptions): string[] {\n const { auditReport, destinationDir } = options;\n return [\n `Target: ${auditReport.targetDir}`,\n `Destination: ${destinationDir ?? \"(no backup directory will be created)\"}`,\n ...formatSkillSelectionReview(auditReport.skillSelectionReview),\n ...formatPluginSelectionReview(auditReport.pluginSelectionReview),\n `Files to copy: ${options.copyableFiles.length}`,\n `Directories to materialize: ${options.materializableDirectories.length}`,\n `Retained: ${auditReport.preservedPaths.length}`,\n `Skipped: ${auditReport.skippedPaths.length}`,\n ];\n}\n\nfunction buildUninstallAuditSummaryLines(\n options: LifecycleUninstallAuditSummaryOptions,\n): string[] {\n const { auditReport, backupDestinationDir } = options;\n return [\n `Target: ${auditReport.targetDir}`,\n `Backup before removal: ${backupDestinationDir ?? \"not requested\"}`,\n ...formatSkillSelectionReview(auditReport.skillSelectionReview),\n ...formatPluginSelectionReview(auditReport.pluginSelectionReview),\n `Files to remove: ${auditReport.removableFiles.length}`,\n `Directories to prune: ${auditReport.prunableDirectories.length}`,\n `Preserved: ${auditReport.preservedPaths.length}`,\n `Skipped: ${auditReport.skippedPaths.length}`,\n ];\n}\n\nfunction renderAuditNote(options: {\n title: string;\n lines: string[];\n groups: string[][];\n}): void {\n note(\n [...options.lines, \"\", ...formatEntryGroups(options.groups)].join(\"\\n\"),\n options.title,\n );\n}\n\nfunction formatEntryGroups(groups: string[][]): string[] {\n return groups.flatMap((group, index) =>\n index === 0 ? group : [\"\", ...group],\n );\n}\n\nfunction formatEntryGroup(\n title: string,\n entries: LifecycleRenderableEntry[],\n formatter: (entry: LifecycleRenderableEntry) => string = formatPath,\n): string[] {\n if (entries.length === 0) {\n return [`${title}:`, \"- none\"];\n }\n\n return [`${title}:`, ...entries.map((entry) => `- ${formatter(entry)}`)];\n}\n\nfunction formatPath(entry: Pick<AuditPathMetadata, \"path\">): string {\n return entry.path;\n}\n\nfunction formatBackupStatus(result: BackupExecutionResult | null): string {\n if (!result) {\n return \"not requested\";\n }\n\n if (result.status === \"completed\" && result.destinationDir) {\n return `created at ${result.destinationDir}`;\n }\n\n if (result.status === \"noop\") {\n return \"requested, but no backup files or directories needed to be created\";\n }\n\n return \"requested\";\n}\n\nfunction formatSkillSelectionReview(\n review: AuditSkillSelectionReview | undefined,\n): string[] {\n if (!review) {\n return [];\n }\n\n if (!review.skillsEnabled) {\n return [\"Skills: disabled\"];\n }\n\n const provenance =\n review.skillSelectionProvenance.length === 0\n ? \"(no saved provenance metadata)\"\n : review.skillSelectionProvenance\n .map(\n (entry) =>\n `${entry.skillName}: ${entry.provenanceLabel} (${entry.provenanceKind})`,\n )\n .join(\"; \");\n\n return [\n `Skills: enabled (${review.skillScope})`,\n `Skills manifest: ${formatSkillManifestSource(review.skillManifest)}`,\n `Selected skills: ${formatSelectedSkills(review.selectedSkills)}`,\n `Skill provenance: ${provenance}`,\n ];\n}\n\nfunction formatSkillManifestSource(\n source: SkillManifestSelectionSource | undefined,\n): string {\n if (!source) {\n return \"(legacy selections; no manifest provenance)\";\n }\n\n if (source.source === \"file\") {\n return `${source.displayName} (local file: ${source.path ?? \"unknown path\"})`;\n }\n\n if (source.source === \"remote-pinned\") {\n return `${source.displayName} (remote pinned: ${source.digest ?? \"missing digest\"})`;\n }\n\n return `${source.displayName} (built-in)`;\n}\n\nfunction formatSelectedSkills(selectedSkills: string[]): string {\n return selectedSkills.length === 0 ? \"(none)\" : selectedSkills.join(\", \");\n}\n\nfunction formatPluginSelectionReview(\n review: AuditPluginSelectionReview | undefined,\n): string[] {\n if (!review) {\n return [];\n }\n\n if (!review.pluginsEnabled) {\n return [\"Plugins: disabled\"];\n }\n\n const provenance =\n review.pluginSelectionProvenance.length === 0\n ? \"(no saved provenance metadata)\"\n : review.pluginSelectionProvenance\n .map(\n (entry) =>\n `${entry.pluginId}: ${entry.provenanceLabel} (${entry.provenanceKind})`,\n )\n .join(\"; \");\n\n return [\n `Plugins: enabled (${review.pluginScope})`,\n `Plugin manifest: ${formatPluginManifestSource(review.pluginManifest)}`,\n `Selected plugins: ${formatSelectedPlugins(review.selectedPlugins)}`,\n `Plugin provenance: ${provenance}`,\n ];\n}\n\nfunction formatPluginManifestSource(\n source: PluginManifestSelectionSource | undefined,\n): string {\n if (!source) {\n return \"(legacy selections; no manifest provenance)\";\n }\n\n if (source.source === \"file\") {\n return `${source.displayName} (local file: ${source.path ?? \"unknown path\"})`;\n }\n\n if (source.source === \"remote-pinned\") {\n return `${source.displayName} (remote pinned: ${source.digest ?? \"missing digest\"})`;\n }\n\n return `${source.displayName} (built-in)`;\n}\n\nfunction formatSelectedPlugins(selectedPlugins: string[]): string {\n return selectedPlugins.length === 0 ? \"(none)\" : selectedPlugins.join(\", \");\n}\n\nasync function confirmLifecycleCheckpoint(options: {\n permissions: LifecyclePermissionsMode;\n message: string;\n ttyError: string;\n}): Promise<boolean> {\n if (options.permissions === \"allow-all\") {\n return true;\n }\n\n if (!input.isTTY || !output.isTTY) {\n throw new Error(options.ttyError);\n }\n\n const proceed = await confirm({\n message: options.message,\n initialValue: true,\n active: \"Yes\",\n inactive: \"No\",\n withGuide: true,\n });\n\n return !(isCancel(proceed) || !proceed);\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../src/backup.ts","../src/lifecycle-ui.ts"],"sourcesContent":["import {\n copyFileSync,\n existsSync,\n mkdirSync,\n readdirSync,\n readFileSync,\n} from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { preparePlannedFileChange, sealInstallationOperation, withInstallationOperation } from \"./store/installation-state\";\nimport { createAuditReport } from \"./audit\";\nimport { getProjectBackupRoot } from \"./backup-paths\";\nimport { getLifecycleRenderer } from \"./lifecycle-ui\";\nimport { loadManifest } from \"./manifest\";\nimport type {\n AuditReport,\n AuditPrunableDirectory,\n AuditRemovableFile,\n BackupCommandOptions,\n BackupDestinationPlan,\n BackupExecutionResult,\n} from \"./types\";\nimport { ensureParentDir } from \"./utils\";\n\ntype CopyableAuditRemovableFile = AuditRemovableFile & {\n backupRelativePath: string;\n};\n\ntype MaterializableAuditDirectory = AuditPrunableDirectory & {\n backupRelativePath: string;\n};\n\nexport type PrepareBackupExecutionOptions = {\n targetDir: string;\n homeDir?: string;\n now?: Date;\n auditReport?: AuditReport;\n destinationPlan?: BackupDestinationPlan | null;\n};\n\nexport type PreparedBackupExecution = {\n targetDir: string;\n auditReport: AuditReport;\n destinationPlan: BackupDestinationPlan | null;\n copyableFiles: CopyableAuditRemovableFile[];\n materializableDirectories: MaterializableAuditDirectory[];\n};\n\nexport function compareBackupRelativePathDepth(\n left: string,\n right: string,\n): number {\n const depth = (value: string) => value.split(/[\\\\/]+/u).filter(Boolean).length;\n return depth(left) - depth(right);\n}\n\nexport async function runBackupCommand(\n options: BackupCommandOptions,\n): Promise<BackupExecutionResult> {\n const renderer = getLifecycleRenderer();\n renderer.beginWorkflow(\"make-docs setup backup\");\n const preparedBackup = await prepareBackupExecution(options);\n\n renderer.renderBackupAuditSummary({\n auditReport: preparedBackup.auditReport,\n destinationDir: preparedBackup.destinationPlan?.destinationDir ?? null,\n copyableFiles: preparedBackup.copyableFiles,\n materializableDirectories: preparedBackup.materializableDirectories,\n });\n\n if (!hasBackupWork(preparedBackup)) {\n renderer.renderBackupNoopSummary();\n return createNoopBackupResult(preparedBackup);\n }\n\n const destinationPlan = preparedBackup.destinationPlan;\n if (!destinationPlan) {\n throw new Error(\n \"Backup destination plan is required when audited entries are copyable.\",\n );\n }\n\n const shouldProceed = await renderer.confirmBackupRun(options.permissions);\n if (!shouldProceed) {\n renderer.renderBackupCancelled();\n return {\n status: \"cancelled\",\n targetDir: preparedBackup.targetDir,\n destinationDir: destinationPlan.destinationDir,\n auditReport: preparedBackup.auditReport,\n copiedFiles: [],\n materializedDirectories: [],\n };\n }\n\n const result = executePreparedBackup(preparedBackup);\n renderer.renderBackupCompletionSummary(result);\n return result;\n}\n\nexport async function prepareBackupExecution(\n options: PrepareBackupExecutionOptions,\n): Promise<PreparedBackupExecution> {\n const targetDir = path.resolve(options.targetDir);\n const homeDir = path.resolve(options.homeDir ?? os.homedir());\n const auditReport =\n options.auditReport ??\n (await createAuditReport({\n targetDir,\n manifest: loadManifest(targetDir),\n homeDir,\n }));\n\n const copyableFiles = auditReport.removableFiles.filter(hasBackupRelativePath);\n const materializableDirectories = auditReport.prunableDirectories.filter(\n hasBackupRelativePath,\n );\n const materializableManagedDirectories = auditReport.removableFiles\n .filter((entry) => entry.kind === \"directory\")\n .filter(hasBackupRelativePath)\n .map((entry): MaterializableAuditDirectory => ({\n ...entry,\n kind: \"directory\",\n removableDescendantPaths: [],\n preservedDescendantPaths: [],\n }));\n const hasCopyableEntries =\n copyableFiles.length > 0 ||\n materializableDirectories.length > 0 ||\n materializableManagedDirectories.length > 0;\n const hasProvidedDestinationPlan = Object.hasOwn(options, \"destinationPlan\");\n const destinationPlan = hasCopyableEntries\n ? hasProvidedDestinationPlan\n ? options.destinationPlan ?? null\n : resolveBackupDestinationPlan(targetDir, options.now ?? new Date())\n : null;\n\n if (hasCopyableEntries && !destinationPlan) {\n throw new Error(\n \"Backup destination plan is required when audited entries are copyable.\",\n );\n }\n\n return {\n targetDir,\n auditReport,\n destinationPlan,\n copyableFiles: copyableFiles.filter((entry) => entry.kind === \"file\"),\n materializableDirectories: [\n ...materializableDirectories,\n ...materializableManagedDirectories,\n ],\n };\n}\n\nexport function executePreparedBackup(\n preparedBackup: PreparedBackupExecution,\n): BackupExecutionResult {\n if (!hasBackupWork(preparedBackup)) {\n return createNoopBackupResult(preparedBackup);\n }\n\n if (!preparedBackup.destinationPlan) {\n throw new Error(\n \"Backup destination plan is required before copying audited backup entries.\",\n );\n }\n\n return withInstallationOperation(preparedBackup.targetDir, \"setup.backup\", () => {\n const targetDir = preparedBackup.targetDir;\n const destination = preparedBackup.destinationPlan!.destinationDir;\n if (preparedBackup.destinationPlan!.promotion) throw new Error(\"Create a fresh backup plan. Existing backup paths must remain stable.\");\n if (existsSync(destination)) throw new Error(`Backup destination already exists: ${destination}. Re-run the command to resolve a fresh destination.`);\n const changes: Array<() => void> = [preparePlannedFileChange(targetDir, path.relative(targetDir, destination), { kind: \"directory\" }, () => mkdirSync(destination, { recursive: true }))];\n const copiedFiles: string[] = [];\n const materializedDirectories: string[] = [];\n for (const directory of [...preparedBackup.materializableDirectories].sort((a, b) =>\n compareBackupRelativePathDepth(a.backupRelativePath, b.backupRelativePath))) {\n const relative = directory.backupRelativePath;\n if (!relative || relative === \".\") continue;\n const absolute = path.join(destination, relative);\n changes.push(preparePlannedFileChange(targetDir, path.relative(targetDir, absolute), { kind: \"directory\" }, () => mkdirSync(absolute, { recursive: true })));\n materializedDirectories.push(relative);\n }\n for (const file of preparedBackup.copyableFiles) {\n const destinationPath = path.join(destination, file.backupRelativePath);\n const content = readFileSync(file.absolutePath);\n changes.push(preparePlannedFileChange(targetDir, path.relative(targetDir, destinationPath), { kind: \"file\", content }, () => {\n ensureParentDir(destinationPath);\n copyFileSync(file.absolutePath, destinationPath);\n }));\n copiedFiles.push(file.backupRelativePath);\n }\n sealInstallationOperation(targetDir);\n for (const change of changes) change();\n\n return {\n status: \"completed\",\n targetDir: preparedBackup.targetDir,\n destinationDir: preparedBackup.destinationPlan!.destinationDir,\n auditReport: preparedBackup.auditReport,\n copiedFiles,\n materializedDirectories,\n };\n });\n}\n\nexport function resolveBackupDestinationPlan(\n targetDir: string,\n now: Date,\n): BackupDestinationPlan {\n const backupRoot = getProjectBackupRoot(targetDir);\n const dateStamp = formatDateStamp(now);\n const plainDirectory = path.join(backupRoot, dateStamp);\n const existingOrdinals = collectExistingOrdinals(backupRoot, dateStamp);\n const hasPlainDirectory = existsSync(plainDirectory);\n\n if (!hasPlainDirectory && existingOrdinals.length === 0) {\n return {\n backupRoot,\n dateStamp,\n directoryName: dateStamp,\n destinationDir: plainDirectory,\n };\n }\n\n const usedOrdinals = new Set(existingOrdinals);\n let promotion: BackupDestinationPlan[\"promotion\"];\n\n // A completed backup path is a durable payload reference. Never rename it.\n if (hasPlainDirectory) usedOrdinals.add(0);\n\n const nextOrdinal = Math.max(...usedOrdinals, 0) + 1;\n const directoryName = `${dateStamp}-${formatOrdinal(nextOrdinal)}`;\n\n return {\n backupRoot,\n dateStamp,\n directoryName,\n destinationDir: path.join(backupRoot, directoryName),\n promotion,\n };\n}\n\nfunction collectExistingOrdinals(backupRoot: string, dateStamp: string): number[] {\n if (!existsSync(backupRoot)) {\n return [];\n }\n\n const pattern = new RegExp(`^${escapeRegExp(dateStamp)}-(\\\\d+)$`);\n return readdirSync(backupRoot)\n .map((entryName) => {\n const match = pattern.exec(entryName);\n if (!match) {\n return null;\n }\n\n return Number.parseInt(match[1] ?? \"\", 10);\n })\n .filter((value): value is number => Number.isInteger(value))\n .sort((left, right) => left - right);\n}\n\nfunction findLowestAvailableOrdinal(usedOrdinals: Set<number>): number {\n let ordinal = 1;\n while (usedOrdinals.has(ordinal)) {\n ordinal += 1;\n }\n return ordinal;\n}\n\nfunction hasBackupRelativePath<T extends { backupRelativePath: string | null }>(\n entry: T,\n): entry is T & { backupRelativePath: string } {\n return typeof entry.backupRelativePath === \"string\";\n}\n\nfunction hasBackupWork(preparedBackup: PreparedBackupExecution): boolean {\n return (\n preparedBackup.copyableFiles.length > 0 ||\n preparedBackup.materializableDirectories.length > 0\n );\n}\n\nfunction createNoopBackupResult(\n preparedBackup: PreparedBackupExecution,\n): BackupExecutionResult {\n return {\n status: \"noop\",\n targetDir: preparedBackup.targetDir,\n destinationDir: null,\n auditReport: preparedBackup.auditReport,\n copiedFiles: [],\n materializedDirectories: [],\n };\n}\n\nfunction formatDateStamp(now: Date): string {\n const year = now.getFullYear();\n const month = String(now.getMonth() + 1).padStart(2, \"0\");\n const day = String(now.getDate()).padStart(2, \"0\");\n return `${year}-${month}-${day}`;\n}\n\nfunction formatOrdinal(ordinal: number): string {\n return String(ordinal).padStart(2, \"0\");\n}\n\nfunction escapeRegExp(value: string): string {\n return value.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n","import { stdin as input, stdout as output } from \"node:process\";\nimport { confirm, intro, isCancel, note, outro } from \"@clack/prompts\";\nimport type {\n AuditPathMetadata,\n AuditPluginSelectionReview,\n AuditPreservedPath,\n AuditPrunableDirectory,\n AuditRemovableFile,\n AuditReport,\n AuditSkillSelectionReview,\n AuditSkippedPath,\n BackupExecutionResult,\n LifecyclePermissionsMode,\n PluginManifestSelectionSource,\n SkillManifestSelectionSource,\n} from \"./types\";\n\ntype LifecycleRenderableEntry =\n | AuditRemovableFile\n | AuditPrunableDirectory\n | AuditPreservedPath\n | AuditSkippedPath;\n\nexport type LifecycleAuditSummaryOptions = {\n auditReport: AuditReport;\n destinationDir: string | null;\n copyableFiles: AuditRemovableFile[];\n materializableDirectories: AuditPrunableDirectory[];\n};\n\nexport type LifecycleUninstallWarningOptions = {\n targetDir: string;\n backupDestinationDir: string | null;\n};\n\nexport type LifecycleUninstallAuditSummaryOptions = {\n auditReport: AuditReport;\n backupDestinationDir: string | null;\n};\n\nexport type LifecycleUninstallRunConfirmationOptions = {\n permissions: LifecyclePermissionsMode;\n backupRequested: boolean;\n};\n\nexport type LifecycleUninstallCompletionSummaryOptions = {\n auditReport: AuditReport;\n removedFiles: string[];\n prunedDirectories: string[];\n backupResult: BackupExecutionResult | null;\n};\n\nexport type LifecycleUninstallFailureSummaryOptions =\n LifecycleUninstallCompletionSummaryOptions & {\n errorMessage: string;\n };\n\nexport interface LifecycleRenderer {\n beginWorkflow(title: string): void;\n renderBackupAuditSummary(options: LifecycleAuditSummaryOptions): void;\n confirmBackupRun(permissions: LifecyclePermissionsMode): Promise<boolean>;\n renderBackupNoopSummary(): void;\n renderBackupCancelled(): void;\n renderBackupCompletionSummary(result: BackupExecutionResult): void;\n renderUninstallWarning(options: LifecycleUninstallWarningOptions): void;\n confirmUninstallWarning(\n permissions: LifecyclePermissionsMode,\n ): Promise<boolean>;\n renderUninstallAuditSummary(\n options: LifecycleUninstallAuditSummaryOptions,\n ): void;\n confirmUninstallRun(\n options: LifecycleUninstallRunConfirmationOptions,\n ): Promise<boolean>;\n renderUninstallCancelled(): void;\n renderUninstallCompletionSummary(\n options: LifecycleUninstallCompletionSummaryOptions,\n ): void;\n renderUninstallFailureSummary(\n options: LifecycleUninstallFailureSummaryOptions,\n ): void;\n}\n\nlet lifecycleRenderer: LifecycleRenderer = createClackLifecycleRenderer();\n\nexport function createClackLifecycleRenderer(): LifecycleRenderer {\n return {\n beginWorkflow(title) {\n intro(title);\n },\n renderBackupAuditSummary(options) {\n renderAuditNote({\n title: \"make-docs setup backup\",\n lines: buildBackupAuditSummaryLines(options),\n groups: [\n formatEntryGroup(\n \"Files to copy\",\n options.copyableFiles,\n (entry) => `${formatPath(entry)} (${entry.reason})`,\n ),\n formatEntryGroup(\n \"Directories to materialize\",\n options.materializableDirectories,\n ),\n formatEntryGroup(\n \"Retained paths\",\n options.auditReport.preservedPaths,\n (entry) => `${formatPath(entry)} (${entry.reason})`,\n ),\n formatEntryGroup(\n \"Skipped paths\",\n options.auditReport.skippedPaths,\n (entry) => `${formatPath(entry)} (${entry.reason})`,\n ),\n ],\n });\n },\n confirmBackupRun(permissions) {\n return confirmLifecycleCheckpoint({\n permissions,\n message: \"Create this backup?\",\n ttyError:\n \"Backup confirmation requires a TTY. Re-run with `make-docs setup backup --yes`.\",\n });\n },\n renderBackupNoopSummary() {\n outro(\n \"No make-docs-managed files required backup. No backup destination was created.\",\n );\n },\n renderBackupCancelled() {\n outro(\"Backup cancelled.\");\n },\n renderBackupCompletionSummary(result) {\n if (result.status !== \"completed\" || !result.destinationDir) {\n return;\n }\n\n note(\n [\n `Destination: ${result.destinationDir}`,\n `Copied files: ${result.copiedFiles.length}`,\n `Materialized directories: ${result.materializedDirectories.length}`,\n `Retained paths surfaced: ${result.auditReport.preservedPaths.length}`,\n `Skipped paths surfaced: ${result.auditReport.skippedPaths.length}`,\n ].join(\"\\n\"),\n \"Backup complete\",\n );\n },\n renderUninstallWarning(options) {\n const lines = [\"This command removes audited make-docs-managed paths\", \"\"];\n\n if (options.backupDestinationDir) {\n lines.push(\"A backup will be created before removal begins.\");\n lines.push(`Backup destination: ${options.backupDestinationDir}`);\n } else {\n lines.push(\"Safer alternative: make-docs setup backup\");\n lines.push(\"Safer destructive flow: make-docs setup remove --backup\");\n }\n\n note(lines.join(\"\\n\"), \"WARNING\");\n },\n confirmUninstallWarning(permissions) {\n return confirmLifecycleCheckpoint({\n permissions,\n message: \"Continue with uninstall review?\",\n ttyError:\n \"Uninstall confirmation requires a TTY. Re-run with `make-docs setup remove --yes`.\",\n });\n },\n renderUninstallAuditSummary(options) {\n renderAuditNote({\n title: \"make-docs setup remove\",\n lines: buildUninstallAuditSummaryLines(options),\n groups: [\n formatEntryGroup(\n \"Files to remove\",\n options.auditReport.removableFiles,\n (entry) => `${formatPath(entry)} (${entry.reason})`,\n ),\n formatEntryGroup(\n \"Directories to prune\",\n options.auditReport.prunableDirectories,\n (entry) => `${formatPath(entry)} (${entry.reason})`,\n ),\n formatEntryGroup(\n \"Preserved paths\",\n options.auditReport.preservedPaths,\n (entry) => `${formatPath(entry)} (${entry.reason})`,\n ),\n formatEntryGroup(\n \"Skipped paths\",\n options.auditReport.skippedPaths,\n (entry) => `${formatPath(entry)} (${entry.reason})`,\n ),\n ],\n });\n },\n confirmUninstallRun(options) {\n const message = options.backupRequested\n ? \"Create the backup and then remove these audited paths? This action cannot be undone.\"\n : \"Remove these audited paths? This action cannot be undone.\";\n\n return confirmLifecycleCheckpoint({\n permissions: options.permissions,\n message,\n ttyError:\n \"Uninstall confirmation requires a TTY. Re-run with `make-docs setup remove --yes`.\",\n });\n },\n renderUninstallCancelled() {\n outro(\"Uninstall cancelled. No files were changed.\");\n },\n renderUninstallCompletionSummary(options) {\n note(\n [\n `Files removed: ${options.removedFiles.length}`,\n `Directories pruned: ${options.prunedDirectories.length}`,\n `Preserved paths: ${options.auditReport.preservedPaths.length}`,\n `Skipped paths: ${options.auditReport.skippedPaths.length}`,\n `Backup: ${formatBackupStatus(options.backupResult)}`,\n ].join(\"\\n\"),\n \"Uninstall complete\",\n );\n },\n renderUninstallFailureSummary(options) {\n note(\n [\n `Files removed before failure: ${options.removedFiles.length}`,\n `Directories pruned before failure: ${options.prunedDirectories.length}`,\n `Preserved paths: ${options.auditReport.preservedPaths.length}`,\n `Skipped paths: ${options.auditReport.skippedPaths.length}`,\n `Backup: ${formatBackupStatus(options.backupResult)}`,\n `Error: ${options.errorMessage}`,\n ].join(\"\\n\"),\n \"Uninstall partially completed\",\n );\n },\n };\n}\n\nexport function getLifecycleRenderer(): LifecycleRenderer {\n return lifecycleRenderer;\n}\n\nexport function __setLifecycleRendererForTests(\n renderer: LifecycleRenderer | null,\n): void {\n lifecycleRenderer = renderer ?? createClackLifecycleRenderer();\n}\n\nexport function beginLifecycleWorkflow(title: string): void {\n getLifecycleRenderer().beginWorkflow(title);\n}\n\nexport function renderBackupAuditSummary(\n options: LifecycleAuditSummaryOptions,\n): void {\n getLifecycleRenderer().renderBackupAuditSummary(options);\n}\n\nexport async function confirmBackupRun(\n permissions: LifecyclePermissionsMode,\n): Promise<boolean> {\n return getLifecycleRenderer().confirmBackupRun(permissions);\n}\n\nexport function renderUninstallWarning(\n options: LifecycleUninstallWarningOptions,\n): void {\n getLifecycleRenderer().renderUninstallWarning(options);\n}\n\nexport async function confirmUninstallWarning(\n permissions: LifecyclePermissionsMode,\n): Promise<boolean> {\n return getLifecycleRenderer().confirmUninstallWarning(permissions);\n}\n\nexport function renderUninstallAuditSummary(\n options: LifecycleUninstallAuditSummaryOptions,\n): void {\n getLifecycleRenderer().renderUninstallAuditSummary(options);\n}\n\nexport async function confirmUninstallRun(\n options: LifecycleUninstallRunConfirmationOptions,\n): Promise<boolean> {\n return getLifecycleRenderer().confirmUninstallRun(options);\n}\n\nexport function renderUninstallCancelled(): void {\n getLifecycleRenderer().renderUninstallCancelled();\n}\n\nexport function renderUninstallCompletionSummary(\n options: LifecycleUninstallCompletionSummaryOptions,\n): void {\n getLifecycleRenderer().renderUninstallCompletionSummary(options);\n}\n\nexport function renderUninstallFailureSummary(\n options: LifecycleUninstallFailureSummaryOptions,\n): void {\n getLifecycleRenderer().renderUninstallFailureSummary(options);\n}\n\nexport function renderBackupNoopSummary(): void {\n getLifecycleRenderer().renderBackupNoopSummary();\n}\n\nexport function renderBackupCancelled(): void {\n getLifecycleRenderer().renderBackupCancelled();\n}\n\nexport function renderBackupCompletionSummary(\n result: BackupExecutionResult,\n): void {\n getLifecycleRenderer().renderBackupCompletionSummary(result);\n}\n\nfunction buildBackupAuditSummaryLines(options: LifecycleAuditSummaryOptions): string[] {\n const { auditReport, destinationDir } = options;\n return [\n `Target: ${auditReport.targetDir}`,\n `Destination: ${destinationDir ?? \"(no backup directory will be created)\"}`,\n ...formatSkillSelectionReview(auditReport.skillSelectionReview),\n ...formatPluginSelectionReview(auditReport.pluginSelectionReview),\n `Files to copy: ${options.copyableFiles.length}`,\n `Directories to materialize: ${options.materializableDirectories.length}`,\n `Retained: ${auditReport.preservedPaths.length}`,\n `Skipped: ${auditReport.skippedPaths.length}`,\n ];\n}\n\nfunction buildUninstallAuditSummaryLines(\n options: LifecycleUninstallAuditSummaryOptions,\n): string[] {\n const { auditReport, backupDestinationDir } = options;\n return [\n `Target: ${auditReport.targetDir}`,\n `Backup before removal: ${backupDestinationDir ?? \"not requested\"}`,\n ...formatSkillSelectionReview(auditReport.skillSelectionReview),\n ...formatPluginSelectionReview(auditReport.pluginSelectionReview),\n `Files to remove: ${auditReport.removableFiles.length}`,\n `Directories to prune: ${auditReport.prunableDirectories.length}`,\n `Preserved: ${auditReport.preservedPaths.length}`,\n `Skipped: ${auditReport.skippedPaths.length}`,\n ];\n}\n\nfunction renderAuditNote(options: {\n title: string;\n lines: string[];\n groups: string[][];\n}): void {\n note(\n [...options.lines, \"\", ...formatEntryGroups(options.groups)].join(\"\\n\"),\n options.title,\n );\n}\n\nfunction formatEntryGroups(groups: string[][]): string[] {\n return groups.flatMap((group, index) =>\n index === 0 ? group : [\"\", ...group],\n );\n}\n\nfunction formatEntryGroup(\n title: string,\n entries: LifecycleRenderableEntry[],\n formatter: (entry: LifecycleRenderableEntry) => string = formatPath,\n): string[] {\n if (entries.length === 0) {\n return [`${title}:`, \"- none\"];\n }\n\n return [`${title}:`, ...entries.map((entry) => `- ${formatter(entry)}`)];\n}\n\nfunction formatPath(entry: Pick<AuditPathMetadata, \"path\">): string {\n return entry.path;\n}\n\nfunction formatBackupStatus(result: BackupExecutionResult | null): string {\n if (!result) {\n return \"not requested\";\n }\n\n if (result.status === \"completed\" && result.destinationDir) {\n return `created at ${result.destinationDir}`;\n }\n\n if (result.status === \"noop\") {\n return \"requested, but no backup files or directories needed to be created\";\n }\n\n return \"requested\";\n}\n\nfunction formatSkillSelectionReview(\n review: AuditSkillSelectionReview | undefined,\n): string[] {\n if (!review) {\n return [];\n }\n\n if (!review.skillsEnabled) {\n return [\"Skills: disabled\"];\n }\n\n const provenance =\n review.skillSelectionProvenance.length === 0\n ? \"(no saved provenance metadata)\"\n : review.skillSelectionProvenance\n .map(\n (entry) =>\n `${entry.skillName}: ${entry.provenanceLabel} (${entry.provenanceKind})`,\n )\n .join(\"; \");\n\n return [\n `Skills: enabled (${review.skillScope})`,\n `Skills manifest: ${formatSkillManifestSource(review.skillManifest)}`,\n `Selected skills: ${formatSelectedSkills(review.selectedSkills)}`,\n `Skill provenance: ${provenance}`,\n ];\n}\n\nfunction formatSkillManifestSource(\n source: SkillManifestSelectionSource | undefined,\n): string {\n if (!source) {\n return \"(legacy selections; no manifest provenance)\";\n }\n\n if (source.source === \"file\") {\n return `${source.displayName} (local file: ${source.path ?? \"unknown path\"})`;\n }\n\n if (source.source === \"remote-pinned\") {\n return `${source.displayName} (remote pinned: ${source.digest ?? \"missing digest\"})`;\n }\n\n return `${source.displayName} (built-in)`;\n}\n\nfunction formatSelectedSkills(selectedSkills: string[]): string {\n return selectedSkills.length === 0 ? \"(none)\" : selectedSkills.join(\", \");\n}\n\nfunction formatPluginSelectionReview(\n review: AuditPluginSelectionReview | undefined,\n): string[] {\n if (!review) {\n return [];\n }\n\n if (!review.pluginsEnabled) {\n return [\"Plugins: disabled\"];\n }\n\n const provenance =\n review.pluginSelectionProvenance.length === 0\n ? \"(no saved provenance metadata)\"\n : review.pluginSelectionProvenance\n .map(\n (entry) =>\n `${entry.pluginId}: ${entry.provenanceLabel} (${entry.provenanceKind})`,\n )\n .join(\"; \");\n\n return [\n `Plugins: enabled (${review.pluginScope})`,\n `Plugin manifest: ${formatPluginManifestSource(review.pluginManifest)}`,\n `Selected plugins: ${formatSelectedPlugins(review.selectedPlugins)}`,\n `Plugin provenance: ${provenance}`,\n ];\n}\n\nfunction formatPluginManifestSource(\n source: PluginManifestSelectionSource | undefined,\n): string {\n if (!source) {\n return \"(legacy selections; no manifest provenance)\";\n }\n\n if (source.source === \"file\") {\n return `${source.displayName} (local file: ${source.path ?? \"unknown path\"})`;\n }\n\n if (source.source === \"remote-pinned\") {\n return `${source.displayName} (remote pinned: ${source.digest ?? \"missing digest\"})`;\n }\n\n return `${source.displayName} (built-in)`;\n}\n\nfunction formatSelectedPlugins(selectedPlugins: string[]): string {\n return selectedPlugins.length === 0 ? \"(none)\" : selectedPlugins.join(\", \");\n}\n\nasync function confirmLifecycleCheckpoint(options: {\n permissions: LifecyclePermissionsMode;\n message: string;\n ttyError: string;\n}): Promise<boolean> {\n if (options.permissions === \"allow-all\") {\n return true;\n }\n\n if (!input.isTTY || !output.isTTY) {\n throw new Error(options.ttyError);\n }\n\n const proceed = await confirm({\n message: options.message,\n initialValue: true,\n active: \"Yes\",\n inactive: \"No\",\n withGuide: true,\n });\n\n return !(isCancel(proceed) || !proceed);\n}\n"],"mappings":"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","names":[]}
@@ -7,12 +7,12 @@ import {
7
7
  prepareInstallationRemoval,
8
8
  pruneInstallationParents,
9
9
  removeInstallationPath
10
- } from "./chunk-57GN6ALR.js";
10
+ } from "./chunk-VMKG3H4B.js";
11
11
  import {
12
12
  NO_ACCESS,
13
13
  getFirstPartyHarnessAdapter,
14
14
  validateHarnessMethodSelection
15
- } from "./chunk-DFQJENNL.js";
15
+ } from "./chunk-ISSMVKIA.js";
16
16
  import {
17
17
  CONFLICTS_RELATIVE_DIR,
18
18
  DEFAULT_SYSTEM_ASSET_MATERIALIZATION_MODE,
@@ -75,7 +75,7 @@ import {
75
75
  withInstallationOperation,
76
76
  writeContentFile,
77
77
  writeManifest
78
- } from "./chunk-U25GFKNZ.js";
78
+ } from "./chunk-HXWD2EUD.js";
79
79
 
80
80
  // src/config.ts
81
81
  import { existsSync, readFileSync } from "fs";
@@ -114,7 +114,8 @@ var TOP_LEVEL_KEYS = /* @__PURE__ */ new Set([
114
114
  "personas",
115
115
  "generatedProse",
116
116
  "harnessCapabilities",
117
- "harnessIntegrations"
117
+ "harnessIntegrations",
118
+ "prd_authority"
118
119
  ]);
119
120
  var LABEL_GROUP_KEYS = /* @__PURE__ */ new Set(["lifecycle", "documentKinds", "coordinates"]);
120
121
  var PERSONA_KEYS = /* @__PURE__ */ new Set(["slug", "label", "description", "primitive"]);
@@ -964,6 +965,49 @@ function formatLabelEntries(labels) {
964
965
  return Object.entries(labels).map(([key, value]) => `${key}=${value}`).join(", ");
965
966
  }
966
967
 
968
+ // src/operations/mcp-metadata.ts
969
+ var MCP_PROFILES = ["core", "setup", "workflow", "quality", "backlog"];
970
+ var MCP_SERVER_PROFILES = [...MCP_PROFILES, "all"];
971
+ function parseMcpServerProfile(value = "all") {
972
+ if (MCP_SERVER_PROFILES.some((profile) => profile === value)) {
973
+ return value;
974
+ }
975
+ throw new Error(
976
+ `Unknown make-docs MCP profile: ${String(value)}. Allowed profiles: ${MCP_SERVER_PROFILES.join(", ")}.`
977
+ );
978
+ }
979
+ function assertMcpToolMetadata(owner, metadata) {
980
+ if (typeof metadata !== "object" || metadata === null || Array.isArray(metadata)) {
981
+ throw new Error(`MCP tool ${owner} must declare profile metadata.`);
982
+ }
983
+ const { profiles, defaultExposure } = metadata;
984
+ if (!Array.isArray(profiles) || profiles.length === 0) {
985
+ throw new Error(`MCP tool ${owner} must declare a nonempty profile set.`);
986
+ }
987
+ for (const profile of profiles) {
988
+ if (!MCP_PROFILES.some((known) => known === profile)) {
989
+ throw new Error(`MCP tool ${owner} declares unknown profile: ${String(profile)}.`);
990
+ }
991
+ }
992
+ if (new Set(profiles).size !== profiles.length) {
993
+ throw new Error(`MCP tool ${owner} declares duplicate profiles.`);
994
+ }
995
+ if (defaultExposure !== "eager" && defaultExposure !== "deferred") {
996
+ throw new Error(`MCP tool ${owner} must declare eager or deferred default exposure.`);
997
+ }
998
+ const uri = metadata.uiResourceUri;
999
+ if (uri !== void 0 && (typeof uri !== "string" || !/^ui:\/\/[a-z0-9][a-z0-9.-]*(?:\/[a-z0-9][a-z0-9-]*)*\/v[1-9][0-9]*\.html$/.test(uri))) {
1000
+ throw new Error(`MCP tool ${owner} must reference a versioned UI resource URI.`);
1001
+ }
1002
+ }
1003
+ function cloneMcpToolMetadata(metadata) {
1004
+ return {
1005
+ profiles: [...metadata.profiles],
1006
+ defaultExposure: metadata.defaultExposure,
1007
+ ...metadata.uiResourceUri ? { uiResourceUri: metadata.uiResourceUri } : {}
1008
+ };
1009
+ }
1010
+
967
1011
  // src/install.ts
968
1012
  import { isDeepStrictEqual as isDeepStrictEqual2 } from "util";
969
1013
  import { existsSync as existsSync5, mkdirSync, readFileSync as readFileSync5, symlinkSync } from "fs";
@@ -1182,6 +1226,93 @@ function invalidUri(value, message) {
1182
1226
  };
1183
1227
  }
1184
1228
 
1229
+ // src/operations/resource/mcp-profiles.ts
1230
+ function getSystemResourceMcpProfiles(provider) {
1231
+ if (!provider || !Array.isArray(provider.resources)) {
1232
+ return invalidProfiles("The native MCP provider inventory is invalid.");
1233
+ }
1234
+ const uris = [];
1235
+ for (const resource of provider.resources) {
1236
+ if (!resource || typeof resource.identity?.uri !== "string") {
1237
+ return invalidProfiles("Each native MCP provider resource must have a canonical URI.");
1238
+ }
1239
+ uris.push(resource.identity.uri);
1240
+ }
1241
+ const assignments = validateSystemResourceMcpAssignments(provider.mcpResources, uris);
1242
+ if (!assignments.ok) return assignments;
1243
+ const profiles = {};
1244
+ for (const assignment of assignments.value) profiles[assignment.uri] = assignment.profiles;
1245
+ return { ok: true, value: Object.freeze(profiles) };
1246
+ }
1247
+ function validateSystemResourceMcpAssignments(value, resourceUris) {
1248
+ const inventory = /* @__PURE__ */ new Set();
1249
+ for (const uri of resourceUris) {
1250
+ if (typeof uri !== "string" || !parseSystemResourceUri(uri).ok) {
1251
+ return invalidProfiles("The native MCP provider inventory contains an invalid URI.");
1252
+ }
1253
+ if (inventory.has(uri)) {
1254
+ return invalidProfiles(`The native MCP provider inventory repeats URI ${uri}.`, uri);
1255
+ }
1256
+ inventory.add(uri);
1257
+ }
1258
+ if (!Array.isArray(value)) {
1259
+ return invalidProfiles("The system-resource catalog must declare native MCP profile assignments.");
1260
+ }
1261
+ const assignments = [];
1262
+ const assigned = /* @__PURE__ */ new Set();
1263
+ for (const entry of value) {
1264
+ if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
1265
+ return invalidProfiles("Each native MCP resource assignment must be an object.");
1266
+ }
1267
+ if (Object.keys(entry).some((key) => key !== "uri" && key !== "profiles")) {
1268
+ return invalidProfiles("Native MCP resource assignments accept only uri and profiles fields.");
1269
+ }
1270
+ const { uri, profiles } = entry;
1271
+ if (typeof uri !== "string" || !parseSystemResourceUri(uri).ok) {
1272
+ return invalidProfiles("Each native MCP resource assignment must name a canonical system URI.");
1273
+ }
1274
+ if (assigned.has(uri)) {
1275
+ return invalidProfiles(`The system-resource catalog repeats native MCP URI ${uri}.`, uri);
1276
+ }
1277
+ if (!inventory.has(uri)) {
1278
+ return invalidProfiles(`Native MCP URI ${uri} is outside the provider inventory.`, uri);
1279
+ }
1280
+ if (!Array.isArray(profiles) || profiles.length === 0) {
1281
+ return invalidProfiles(`Native MCP resource ${uri} must declare a nonempty profile set.`, uri);
1282
+ }
1283
+ for (const profile of profiles) {
1284
+ if (!MCP_PROFILES.some((known) => known === profile)) {
1285
+ return invalidProfiles(`Native MCP resource ${uri} declares unknown profile: ${String(profile)}.`, uri);
1286
+ }
1287
+ }
1288
+ if (new Set(profiles).size !== profiles.length) {
1289
+ return invalidProfiles(`Native MCP resource ${uri} declares duplicate profiles.`, uri);
1290
+ }
1291
+ assigned.add(uri);
1292
+ assignments.push(Object.freeze({
1293
+ uri,
1294
+ profiles: Object.freeze([...profiles])
1295
+ }));
1296
+ }
1297
+ const missing2 = [...inventory].find((uri) => !assigned.has(uri));
1298
+ if (missing2) {
1299
+ return invalidProfiles(`Native MCP resource ${missing2} has no profile assignment.`, missing2);
1300
+ }
1301
+ assignments.sort((left, right) => left.uri < right.uri ? -1 : left.uri > right.uri ? 1 : 0);
1302
+ return { ok: true, value: Object.freeze(assignments) };
1303
+ }
1304
+ function invalidProfiles(message, uri) {
1305
+ return {
1306
+ ok: false,
1307
+ error: {
1308
+ code: "provider-catalog-invalid",
1309
+ message,
1310
+ recovery: "Restore the shipped catalog with one nonempty intent profile set for each provider URI.",
1311
+ ...uri ? { uri } : {}
1312
+ }
1313
+ };
1314
+ }
1315
+
1185
1316
  // src/operations/resource/provider.ts
1186
1317
  var DEFAULT_CATALOG_PATH = ".make-docs/system-resources.catalog.json";
1187
1318
  function loadSystemResourceProvider(input) {
@@ -1264,6 +1395,8 @@ function loadSystemResourceProvider(input) {
1264
1395
  }
1265
1396
  }
1266
1397
  resources.sort((left, right) => compareCodeUnits(left.identity.uri, right.identity.uri));
1398
+ const mcpResources = Object.hasOwn(catalog, "mcpResources") ? validateSystemResourceMcpAssignments(catalog.mcpResources, resources.map((entry) => entry.identity.uri)) : void 0;
1399
+ if (mcpResources && !mcpResources.ok) return mcpResources;
1267
1400
  const inventoryDigest = sha256(
1268
1401
  Buffer.from(resources.map((entry) => `${entry.identity.uri}\0${entry.digest}`).join("\n"))
1269
1402
  );
@@ -1287,7 +1420,8 @@ function loadSystemResourceProvider(input) {
1287
1420
  });
1288
1421
  const inventory = Object.freeze({
1289
1422
  provider: providerMetadata,
1290
- resources: Object.freeze([...resources])
1423
+ resources: Object.freeze([...resources]),
1424
+ ...mcpResources?.ok ? { mcpResources: mcpResources.value } : {}
1291
1425
  });
1292
1426
  return {
1293
1427
  ok: true,
@@ -1662,11 +1796,14 @@ function buildSelectedResourceProjection(options) {
1662
1796
  }
1663
1797
  function createThinRouterAssets(profile) {
1664
1798
  const assets = [];
1799
+ const added = /* @__PURE__ */ new Set();
1665
1800
  for (const [harness, instructionKind] of Object.entries(HARNESS_TO_INSTRUCTION)) {
1666
1801
  if (!profile.selections.harnesses[harness]) {
1667
1802
  continue;
1668
1803
  }
1669
1804
  for (const relativePath of getConfiguredRouterPaths(profile, instructionKind)) {
1805
+ if (added.has(relativePath)) continue;
1806
+ added.add(relativePath);
1670
1807
  assets.push({
1671
1808
  relativePath,
1672
1809
  assetClass: "scoped-static",
@@ -1748,6 +1885,7 @@ function createProjectSurfaceRouterAssets(profile, surface) {
1748
1885
  artifacts: "docs/assets",
1749
1886
  assets: "docs/assets"
1750
1887
  }[surface];
1888
+ const added = /* @__PURE__ */ new Set();
1751
1889
  return Object.entries(HARNESS_TO_INSTRUCTION).filter(([harness]) => profile.selections.harnesses[harness]).map(([harness, instructionKind]) => {
1752
1890
  const relativePath = `${directory}/${instructionKind}`;
1753
1891
  return {
@@ -1756,6 +1894,10 @@ function createProjectSurfaceRouterAssets(profile, surface) {
1756
1894
  sourceId: `router:${harness}:${relativePath}`,
1757
1895
  content: readThinRouterContent(relativePath, profile)
1758
1896
  };
1897
+ }).filter((asset) => {
1898
+ if (added.has(asset.relativePath)) return false;
1899
+ added.add(asset.relativePath);
1900
+ return true;
1759
1901
  }).sort((left, right) => compareCodeUnits2(left.relativePath, right.relativePath));
1760
1902
  }
1761
1903
  function applyP4ManifestOwnership(relativePath, entry) {
@@ -4118,6 +4260,11 @@ export {
4118
4260
  createSystemResourceIdentity,
4119
4261
  parseSystemResourceUri,
4120
4262
  canonicalSystemResourcePath,
4263
+ MCP_SERVER_PROFILES,
4264
+ parseMcpServerProfile,
4265
+ assertMcpToolMetadata,
4266
+ cloneMcpToolMetadata,
4267
+ getSystemResourceMcpProfiles,
4121
4268
  loadInstalledSystemResourceProvider,
4122
4269
  matchesSystemResourceCatalogPath,
4123
4270
  createRouterOwnershipManifestEntry,
@@ -4133,4 +4280,4 @@ export {
4133
4280
  registerSkillAdoptionRecovery,
4134
4281
  applySkillAdoptionReview
4135
4282
  };
4136
- //# sourceMappingURL=chunk-C2IBRVUA.js.map
4283
+ //# sourceMappingURL=chunk-CLSOY7NV.js.map