@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.
- package/README.md +1 -1
- package/dist/{backup-GCM64IPN.js → backup-2OT4A6LR.js} +5 -5
- package/dist/chunk-3EXHM5L2.js +1225 -0
- package/dist/chunk-3EXHM5L2.js.map +1 -0
- package/dist/{chunk-2HNJCJJE.js → chunk-46MGH32G.js} +6 -4
- package/dist/chunk-46MGH32G.js.map +1 -0
- package/dist/{chunk-O2UZ35PV.js → chunk-CCYP5NU2.js} +20 -20
- package/dist/{chunk-O2UZ35PV.js.map → chunk-CCYP5NU2.js.map} +1 -1
- package/dist/{chunk-C2IBRVUA.js → chunk-CLSOY7NV.js} +153 -6
- package/dist/chunk-CLSOY7NV.js.map +1 -0
- package/dist/{chunk-GPVKIBFC.js → chunk-CMNKQM7L.js} +3 -3
- package/dist/{chunk-U25GFKNZ.js → chunk-HXWD2EUD.js} +20 -15
- package/dist/chunk-HXWD2EUD.js.map +1 -0
- package/dist/{chunk-DNDM7DUQ.js → chunk-I4FADOUK.js} +3 -3
- package/dist/{chunk-DNDM7DUQ.js.map → chunk-I4FADOUK.js.map} +1 -1
- package/dist/{chunk-DFQJENNL.js → chunk-ISSMVKIA.js} +224 -20
- package/dist/chunk-ISSMVKIA.js.map +1 -0
- package/dist/{chunk-IHMZ2OCS.js → chunk-UNR4CYVX.js} +116 -37
- package/dist/chunk-UNR4CYVX.js.map +1 -0
- package/dist/{chunk-57GN6ALR.js → chunk-VMKG3H4B.js} +2 -2
- package/dist/{chunk-4LLSMDWJ.js → chunk-XDSWX4Y4.js} +9085 -2912
- package/dist/chunk-XDSWX4Y4.js.map +1 -0
- package/dist/index.js +308 -176
- package/dist/index.js.map +1 -1
- package/dist/registry-PC5GKAKM.js +50 -0
- package/dist/registry-PC5GKAKM.js.map +1 -0
- package/dist/{self-UHPM4A2U.js → self-WYVXO23B.js} +18 -18
- package/dist/{self-UHPM4A2U.js.map → self-WYVXO23B.js.map} +1 -1
- package/dist/server-BQOG6FTA.js +1113 -0
- package/dist/server-BQOG6FTA.js.map +1 -0
- package/dist/{setup-system-JUHGDZJW.js → setup-system-KN7FTTLT.js} +267 -44
- package/dist/setup-system-KN7FTTLT.js.map +1 -0
- package/dist/{skills-command-W3SE3OFP.js → skills-command-KEW7MOEW.js} +39 -29
- package/dist/skills-command-KEW7MOEW.js.map +1 -0
- package/dist/{uninstall-BGMJ6KCI.js → uninstall-45XF4CHD.js} +10 -10
- package/dist/virtual_make-docs-first-party-skills-ECJESFL2.js +11 -0
- package/dist/virtual_make-docs-first-party-skills-ECJESFL2.js.map +1 -0
- package/package.json +8 -8
- package/skill-registry.json +24 -8
- package/skill-registry.schema.json +2 -1
- package/template/.make-docs/system/contracts/output-contract.md +3 -1
- package/template/.make-docs/system/contracts/system-resource-contract.md +16 -0
- package/template/.make-docs/system/references/prd-change-management.md +14 -2
- package/template/.make-docs/system-resources.catalog.json +415 -0
- package/template/.make-docs/system-resources.schema.json +25 -0
- package/dist/chunk-2HNJCJJE.js.map +0 -1
- package/dist/chunk-4LLSMDWJ.js.map +0 -1
- package/dist/chunk-C2IBRVUA.js.map +0 -1
- package/dist/chunk-DFQJENNL.js.map +0 -1
- package/dist/chunk-IHMZ2OCS.js.map +0 -1
- package/dist/chunk-U25GFKNZ.js.map +0 -1
- package/dist/chunk-Z5K4FHYP.js +0 -922
- package/dist/chunk-Z5K4FHYP.js.map +0 -1
- package/dist/server-N7XAAV3X.js +0 -512
- package/dist/server-N7XAAV3X.js.map +0 -1
- package/dist/setup-system-JUHGDZJW.js.map +0 -1
- package/dist/skills-command-W3SE3OFP.js.map +0 -1
- package/dist/virtual_make-docs-first-party-skills-VXSUUHTL.js +0 -11
- package/dist/virtual_make-docs-first-party-skills-VXSUUHTL.js.map +0 -1
- /package/dist/{backup-GCM64IPN.js.map → backup-2OT4A6LR.js.map} +0 -0
- /package/dist/{chunk-GPVKIBFC.js.map → chunk-CMNKQM7L.js.map} +0 -0
- /package/dist/{chunk-57GN6ALR.js.map → chunk-VMKG3H4B.js.map} +0 -0
- /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-
|
|
5
|
+
} from "./chunk-46MGH32G.js";
|
|
6
6
|
import {
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
} from "./chunk-
|
|
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-
|
|
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
|
-
|
|
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
|
-
|
|
75
|
+
outro(
|
|
76
76
|
"No make-docs-managed files required backup. No backup destination was created."
|
|
77
77
|
);
|
|
78
78
|
},
|
|
79
79
|
renderBackupCancelled() {
|
|
80
|
-
|
|
80
|
+
outro("Backup cancelled.");
|
|
81
81
|
},
|
|
82
82
|
renderBackupCompletionSummary(result) {
|
|
83
83
|
if (result.status !== "completed" || !result.destinationDir) {
|
|
84
84
|
return;
|
|
85
85
|
}
|
|
86
|
-
|
|
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
|
-
|
|
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
|
-
|
|
152
|
+
outro("Uninstall cancelled. No files were changed.");
|
|
153
153
|
},
|
|
154
154
|
renderUninstallCompletionSummary(options) {
|
|
155
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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 !(
|
|
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-
|
|
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-
|
|
10
|
+
} from "./chunk-VMKG3H4B.js";
|
|
11
11
|
import {
|
|
12
12
|
NO_ACCESS,
|
|
13
13
|
getFirstPartyHarnessAdapter,
|
|
14
14
|
validateHarnessMethodSelection
|
|
15
|
-
} from "./chunk-
|
|
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-
|
|
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-
|
|
4283
|
+
//# sourceMappingURL=chunk-CLSOY7NV.js.map
|