@brucewaynedecoy/make-docs 1.0.0-rc.1 → 2.0.2

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 (187) hide show
  1. package/LICENSE +21 -201
  2. package/README.md +36 -27
  3. package/dist/backup-73HQNKMC.js +20 -0
  4. package/dist/backup-73HQNKMC.js.map +1 -0
  5. package/dist/chunk-3BAJQXGH.js +1575 -0
  6. package/dist/chunk-3BAJQXGH.js.map +1 -0
  7. package/dist/chunk-64CTKJO7.js +4136 -0
  8. package/dist/chunk-64CTKJO7.js.map +1 -0
  9. package/dist/chunk-BENO4IH5.js +875 -0
  10. package/dist/chunk-BENO4IH5.js.map +1 -0
  11. package/dist/chunk-D4HDZEJT.js +37 -0
  12. package/dist/chunk-D4HDZEJT.js.map +1 -0
  13. package/dist/chunk-G5EF63GG.js +1291 -0
  14. package/dist/chunk-G5EF63GG.js.map +1 -0
  15. package/dist/chunk-GNP6HRVP.js +523 -0
  16. package/dist/chunk-GNP6HRVP.js.map +1 -0
  17. package/dist/chunk-HJYIQTMD.js +204 -0
  18. package/dist/chunk-HJYIQTMD.js.map +1 -0
  19. package/dist/chunk-LQ5NSWCJ.js +39 -0
  20. package/dist/chunk-LQ5NSWCJ.js.map +1 -0
  21. package/dist/chunk-LRVV7UDD.js +2340 -0
  22. package/dist/chunk-LRVV7UDD.js.map +1 -0
  23. package/dist/chunk-LVQSJF63.js +24674 -0
  24. package/dist/chunk-LVQSJF63.js.map +1 -0
  25. package/dist/chunk-MXBHCHSM.js +13995 -0
  26. package/dist/chunk-MXBHCHSM.js.map +1 -0
  27. package/dist/chunk-Z5K4FHYP.js +922 -0
  28. package/dist/chunk-Z5K4FHYP.js.map +1 -0
  29. package/dist/index.js +3798 -250
  30. package/dist/index.js.map +1 -1
  31. package/dist/self-YYXOLDKU.js +653 -0
  32. package/dist/self-YYXOLDKU.js.map +1 -0
  33. package/dist/server-O2ZELIMX.js +512 -0
  34. package/dist/server-O2ZELIMX.js.map +1 -0
  35. package/dist/setup-system-HZROFNMP.js +544 -0
  36. package/dist/setup-system-HZROFNMP.js.map +1 -0
  37. package/dist/{skills-command-3ESCZ75U.js → skills-command-MGGHY7HU.js} +190 -32
  38. package/dist/skills-command-MGGHY7HU.js.map +1 -0
  39. package/dist/uninstall-3UXXXNFO.js +223 -0
  40. package/dist/uninstall-3UXXXNFO.js.map +1 -0
  41. package/dist/virtual_make-docs-first-party-skills-ZII74YOB.js +11 -0
  42. package/dist/virtual_make-docs-first-party-skills-ZII74YOB.js.map +1 -0
  43. package/package.json +9 -6
  44. package/skill-registry.json +328 -125
  45. package/skill-registry.schema.json +221 -45
  46. package/template/.make-docs/AGENTS.md +18 -0
  47. package/template/.make-docs/CLAUDE.md +18 -0
  48. package/template/.make-docs/archive/AGENTS.md +11 -0
  49. package/template/.make-docs/archive/CLAUDE.md +11 -0
  50. package/template/.make-docs/system/AGENTS.md +12 -0
  51. package/template/.make-docs/system/CLAUDE.md +12 -0
  52. package/template/.make-docs/system/contracts/AGENTS.md +13 -0
  53. package/template/.make-docs/system/contracts/CLAUDE.md +13 -0
  54. package/template/{docs/assets/references → .make-docs/system/contracts}/commit-message-convention.md +4 -4
  55. package/template/.make-docs/system/contracts/coverage-pass-contract.md +198 -0
  56. package/template/.make-docs/system/contracts/deferred-obligation-contract.md +128 -0
  57. package/template/{docs/assets/references → .make-docs/system/contracts}/design-contract.md +7 -2
  58. package/template/{docs/assets/references → .make-docs/system/contracts}/guide-contract.md +21 -19
  59. package/template/{docs/assets/references → .make-docs/system/contracts}/history-record-contract.md +17 -11
  60. package/template/.make-docs/system/contracts/human-experience-contract.md +134 -0
  61. package/template/.make-docs/system/contracts/naive-uat-contract.md +231 -0
  62. package/template/.make-docs/system/contracts/output-contract.md +277 -0
  63. package/template/.make-docs/system/contracts/performance-evidence-governance.md +257 -0
  64. package/template/.make-docs/system/contracts/system-resource-contract.md +93 -0
  65. package/template/.make-docs/system/prompts/AGENTS.md +12 -0
  66. package/template/.make-docs/system/prompts/CLAUDE.md +12 -0
  67. package/template/.make-docs/system/prompts/coverage-pass-maintainer-guide.prompt.md +20 -0
  68. package/template/.make-docs/system/prompts/coverage-pass-prd-reconciliation.prompt.md +18 -0
  69. package/template/.make-docs/system/prompts/coverage-pass-testing-uat.prompt.md +46 -0
  70. package/template/.make-docs/system/prompts/coverage-pass-user-guide.prompt.md +20 -0
  71. package/template/.make-docs/system/prompts/designs-to-plan-change.prompt.md +18 -0
  72. package/template/.make-docs/system/prompts/designs-to-plan.prompt.md +14 -0
  73. package/template/.make-docs/system/prompts/docs-path-hygiene-cleanup.prompt.md +29 -0
  74. package/template/.make-docs/system/prompts/naive-uat-facilitator.prompt.md +28 -0
  75. package/template/.make-docs/system/prompts/naive-uat-tester.prompt.md +20 -0
  76. package/template/.make-docs/system/prompts/performance-coverage.prompt.md +63 -0
  77. package/template/.make-docs/system/prompts/plan-to-prd-change.prompt.md +12 -0
  78. package/template/.make-docs/system/prompts/plan-to-prd-green-field.prompt.md +10 -0
  79. package/template/.make-docs/system/prompts/prd-change-to-work.prompt.md +14 -0
  80. package/template/.make-docs/system/prompts/prd-to-work-full-prd.prompt.md +10 -0
  81. package/template/.make-docs/system/prompts/prd-to-work-prd-feature.prompt.md +10 -0
  82. package/template/.make-docs/system/prompts/request-to-design.prompt.md +20 -0
  83. package/template/.make-docs/system/prompts/session-to-history-record.prompt.md +23 -0
  84. package/template/{docs/assets → .make-docs/system}/prompts/work-to-commit-message.prompt.md +2 -2
  85. package/template/.make-docs/system/prompts/work-to-guides.prompt.md +22 -0
  86. package/template/.make-docs/system/references/AGENTS.md +14 -0
  87. package/template/.make-docs/system/references/CLAUDE.md +14 -0
  88. package/template/{docs/assets → .make-docs/system}/references/design-workflow.md +15 -2
  89. package/template/.make-docs/system/references/execution-workflow.md +189 -0
  90. package/template/.make-docs/system/references/human-experience.md +138 -0
  91. package/template/.make-docs/system/references/lifecycle.md +153 -0
  92. package/template/.make-docs/system/references/naive-uat-validation.md +65 -0
  93. package/template/.make-docs/system/references/naive-uat-workflow.md +64 -0
  94. package/template/.make-docs/system/references/path-and-link-hygiene.md +101 -0
  95. package/template/.make-docs/system/references/performance-evidence.md +114 -0
  96. package/template/.make-docs/system/references/planning-workflow.md +209 -0
  97. package/template/.make-docs/system/references/prd-change-management.md +165 -0
  98. package/template/{docs/assets → .make-docs/system}/references/wave-model.md +10 -8
  99. package/template/.make-docs/system/templates/AGENTS.md +12 -0
  100. package/template/.make-docs/system/templates/CLAUDE.md +12 -0
  101. package/template/.make-docs/system/templates/design.md +79 -0
  102. package/template/{docs/assets/templates/guide-developer.md → .make-docs/system/templates/guide-maintainer.md} +7 -3
  103. package/template/{docs/assets → .make-docs/system}/templates/guide-user.md +6 -2
  104. package/template/{docs/assets → .make-docs/system}/templates/history-record.md +6 -3
  105. package/template/.make-docs/system/templates/naive-uat-scenario.md +91 -0
  106. package/template/.make-docs/system/templates/performance-evidence-profile.md +252 -0
  107. package/template/.make-docs/system/templates/plan-overview.md +76 -0
  108. package/template/.make-docs/system/templates/plan-prd-change.md +155 -0
  109. package/template/{docs/assets → .make-docs/system}/templates/plan-prd-decompose.md +10 -0
  110. package/template/{docs/assets → .make-docs/system}/templates/plan-prd.md +28 -2
  111. package/template/{docs/assets → .make-docs/system}/templates/prd-architecture.md +13 -0
  112. package/template/.make-docs/system/templates/prd-glossary.md +28 -0
  113. package/template/.make-docs/system/templates/prd-index.md +70 -0
  114. package/template/{docs/assets → .make-docs/system}/templates/prd-overview.md +13 -0
  115. package/template/.make-docs/system/templates/prd-reference.md +30 -0
  116. package/template/{docs/assets → .make-docs/system}/templates/prd-risk-register.md +16 -1
  117. package/template/{docs/assets → .make-docs/system}/templates/prd-subsystem.md +15 -0
  118. package/template/.make-docs/system/templates/work-index.md +58 -0
  119. package/template/.make-docs/system/templates/work-phase.md +107 -0
  120. package/template/.make-docs/system-resources.catalog.json +91 -0
  121. package/template/.make-docs/system-resources.schema.json +204 -0
  122. package/template/AGENTS.md +8 -1
  123. package/template/CLAUDE.md +8 -1
  124. package/template/docs/AGENTS.codex-only.md +22 -0
  125. package/template/docs/AGENTS.md +21 -13
  126. package/template/docs/CLAUDE.claude-only.md +22 -0
  127. package/template/docs/CLAUDE.md +21 -13
  128. package/template/docs/assets/AGENTS.md +11 -7
  129. package/template/docs/assets/CLAUDE.md +11 -7
  130. package/template/docs/designs/AGENTS.md +8 -3
  131. package/template/docs/designs/CLAUDE.md +8 -3
  132. package/template/docs/plans/AGENTS.md +10 -3
  133. package/template/docs/plans/CLAUDE.md +10 -3
  134. package/template/docs/prd/AGENTS.md +14 -4
  135. package/template/docs/prd/CLAUDE.md +14 -4
  136. package/template/docs/work/AGENTS.md +10 -3
  137. package/template/docs/work/CLAUDE.md +10 -3
  138. package/dist/chunk-HP3HBG7F.js +0 -626
  139. package/dist/chunk-HP3HBG7F.js.map +0 -1
  140. package/dist/chunk-QRFH4J6H.js +0 -1194
  141. package/dist/chunk-QRFH4J6H.js.map +0 -1
  142. package/dist/chunk-WM3OXYTW.js +0 -2630
  143. package/dist/chunk-WM3OXYTW.js.map +0 -1
  144. package/dist/skills-command-3ESCZ75U.js.map +0 -1
  145. package/dist/uninstall-GQE4SJF2.js +0 -150
  146. package/dist/uninstall-GQE4SJF2.js.map +0 -1
  147. package/template/.make-docs/scripts/check_path_hygiene.py +0 -435
  148. package/template/docs/assets/archive/AGENTS.md +0 -20
  149. package/template/docs/assets/archive/CLAUDE.md +0 -20
  150. package/template/docs/assets/history/AGENTS.md +0 -12
  151. package/template/docs/assets/history/CLAUDE.md +0 -12
  152. package/template/docs/assets/prompts/AGENTS.md +0 -8
  153. package/template/docs/assets/prompts/CLAUDE.md +0 -8
  154. package/template/docs/assets/prompts/designs-to-plan-change.prompt.md +0 -14
  155. package/template/docs/assets/prompts/designs-to-plan.prompt.md +0 -10
  156. package/template/docs/assets/prompts/docs-path-hygiene-cleanup.prompt.md +0 -27
  157. package/template/docs/assets/prompts/plan-to-prd-change.prompt.md +0 -8
  158. package/template/docs/assets/prompts/plan-to-prd-green-field.prompt.md +0 -6
  159. package/template/docs/assets/prompts/prd-change-to-work.prompt.md +0 -10
  160. package/template/docs/assets/prompts/prd-to-work-full-prd.prompt.md +0 -6
  161. package/template/docs/assets/prompts/prd-to-work-prd-feature.prompt.md +0 -6
  162. package/template/docs/assets/prompts/request-to-design.prompt.md +0 -16
  163. package/template/docs/assets/prompts/session-to-history-record.prompt.md +0 -19
  164. package/template/docs/assets/prompts/work-to-guides.prompt.md +0 -18
  165. package/template/docs/assets/references/AGENTS.md +0 -9
  166. package/template/docs/assets/references/CLAUDE.md +0 -9
  167. package/template/docs/assets/references/execution-workflow.md +0 -157
  168. package/template/docs/assets/references/output-contract.md +0 -221
  169. package/template/docs/assets/references/path-and-link-hygiene.md +0 -49
  170. package/template/docs/assets/references/planning-workflow.md +0 -160
  171. package/template/docs/assets/references/prd-change-management.md +0 -129
  172. package/template/docs/assets/templates/AGENTS.md +0 -8
  173. package/template/docs/assets/templates/CLAUDE.md +0 -8
  174. package/template/docs/assets/templates/design.md +0 -30
  175. package/template/docs/assets/templates/plan-overview.md +0 -32
  176. package/template/docs/assets/templates/plan-prd-change.md +0 -99
  177. package/template/docs/assets/templates/prd-change-addition.md +0 -45
  178. package/template/docs/assets/templates/prd-change-revision.md +0 -45
  179. package/template/docs/assets/templates/prd-glossary.md +0 -15
  180. package/template/docs/assets/templates/prd-index.md +0 -45
  181. package/template/docs/assets/templates/prd-reference.md +0 -17
  182. package/template/docs/assets/templates/work-index.md +0 -21
  183. package/template/docs/assets/templates/work-phase.md +0 -34
  184. package/template/docs/guides/AGENTS.md +0 -15
  185. package/template/docs/guides/CLAUDE.md +0 -15
  186. /package/template/{docs/assets → .make-docs/system}/prompts/update-readme-green-field.prompt.md +0 -0
  187. /package/template/{docs/assets → .make-docs/system}/references/harness-capability-matrix.md +0 -0
@@ -0,0 +1,223 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ executePreparedBackup,
4
+ getLifecycleRenderer,
5
+ prepareBackupExecution,
6
+ resolveBackupDestinationPlan
7
+ } from "./chunk-GNP6HRVP.js";
8
+ import {
9
+ createAuditReport,
10
+ getProjectBackupStateRoots,
11
+ isWithinRoot
12
+ } from "./chunk-G5EF63GG.js";
13
+ import {
14
+ resolveProjectIdentity
15
+ } from "./chunk-3BAJQXGH.js";
16
+ import {
17
+ createLifecycleMutationReceipt,
18
+ removeInstallationPath
19
+ } from "./chunk-HJYIQTMD.js";
20
+ import "./chunk-Z5K4FHYP.js";
21
+ import "./chunk-LRVV7UDD.js";
22
+ import {
23
+ getManifestFileHash,
24
+ hashText,
25
+ loadManifest,
26
+ pruneDirectoryIfEmpty,
27
+ recordPlannedFileChange,
28
+ removeInstallationManifest,
29
+ withInstallationOperation
30
+ } from "./chunk-MXBHCHSM.js";
31
+ import "./chunk-D4HDZEJT.js";
32
+
33
+ // src/uninstall.ts
34
+ import os from "os";
35
+ import path from "path";
36
+ import { existsSync, lstatSync, readdirSync, readFileSync } from "fs";
37
+ async function runUninstallCommand(options) {
38
+ const renderer = getLifecycleRenderer();
39
+ const targetDir = path.resolve(options.targetDir);
40
+ const homeDir = path.resolve(options.homeDir ?? os.homedir());
41
+ const backupDestinationPlan = options.backup ? resolveBackupDestinationPlan(targetDir, options.now ?? /* @__PURE__ */ new Date()) : null;
42
+ const backupDestinationDir = backupDestinationPlan?.destinationDir ?? null;
43
+ renderer.beginWorkflow("make-docs setup remove");
44
+ renderer.renderUninstallWarning({
45
+ targetDir,
46
+ backupDestinationDir
47
+ });
48
+ const warningApproved = await renderer.confirmUninstallWarning(
49
+ options.permissions
50
+ );
51
+ if (!warningApproved) {
52
+ renderer.renderUninstallCancelled();
53
+ return {
54
+ status: "cancelled",
55
+ checkpoint: "warning",
56
+ plan: null
57
+ };
58
+ }
59
+ const auditReport = options.auditReport ?? await loadAuditReport({
60
+ targetDir,
61
+ homeDir
62
+ });
63
+ const plan = {
64
+ targetDir,
65
+ backupRequested: options.backup,
66
+ backupDestinationPlan,
67
+ backupDestinationDir,
68
+ auditReport,
69
+ classificationSnapshotId: hashText(JSON.stringify(auditReport))
70
+ };
71
+ renderer.renderUninstallAuditSummary({
72
+ auditReport,
73
+ backupDestinationDir
74
+ });
75
+ const finalApproved = await renderer.confirmUninstallRun({
76
+ permissions: options.permissions,
77
+ backupRequested: options.backup
78
+ });
79
+ if (!finalApproved) {
80
+ renderer.renderUninstallCancelled();
81
+ return {
82
+ status: "cancelled",
83
+ checkpoint: "final",
84
+ plan
85
+ };
86
+ }
87
+ const projectIdentity = resolveProjectIdentity(plan.targetDir);
88
+ const manifest = loadManifest(plan.targetDir);
89
+ const preparedBackup = plan.backupRequested ? await prepareBackupExecution({
90
+ targetDir,
91
+ homeDir,
92
+ now: options.now,
93
+ auditReport: plan.auditReport,
94
+ destinationPlan: plan.backupDestinationPlan
95
+ }) : null;
96
+ return withInstallationOperation(targetDir, "setup.remove", () => {
97
+ removeInstallationManifest(targetDir);
98
+ let backupResult = null;
99
+ if (preparedBackup) {
100
+ try {
101
+ backupResult = executePreparedBackup(preparedBackup);
102
+ } catch (error) {
103
+ throw new Error(`Backup failed before uninstall removal began: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
104
+ }
105
+ }
106
+ const removedFiles = [];
107
+ const prunedDirectories = [];
108
+ try {
109
+ for (const removableFile of plan.auditReport.removableFiles) {
110
+ assertNotInsideBackupRoot(plan.targetDir, removableFile.absolutePath);
111
+ assertRemovalEvidenceCurrent(removableFile);
112
+ const removed = removeInstallationPath(targetDir, removableFile.path);
113
+ if (removed) {
114
+ removedFiles.push(removableFile.path);
115
+ }
116
+ }
117
+ for (const prunableDirectory of plan.auditReport.prunableDirectories) {
118
+ if (path.resolve(prunableDirectory.absolutePath) === path.resolve(homeDir, ".make-docs")) continue;
119
+ assertNotInsideBackupRoot(plan.targetDir, prunableDirectory.absolutePath);
120
+ if (existsSync(prunableDirectory.absolutePath) && readdirSync(prunableDirectory.absolutePath).length === 0) {
121
+ recordPlannedFileChange(targetDir, prunableDirectory.path, { kind: "missing" }, () => {
122
+ if (pruneDirectoryIfEmpty(prunableDirectory.absolutePath)) prunedDirectories.push(prunableDirectory.path);
123
+ });
124
+ }
125
+ }
126
+ } catch (error) {
127
+ renderer.renderUninstallFailureSummary({
128
+ auditReport: plan.auditReport,
129
+ removedFiles,
130
+ prunedDirectories,
131
+ backupResult,
132
+ errorMessage: toErrorMessage(error)
133
+ });
134
+ throw createUninstallError(
135
+ `Uninstall partially completed after removing ${removedFiles.length} file(s) and pruning ${prunedDirectories.length} director${prunedDirectories.length === 1 ? "y" : "ies"}: ${toErrorMessage(error)}`
136
+ );
137
+ }
138
+ renderer.renderUninstallCompletionSummary({
139
+ auditReport: plan.auditReport,
140
+ removedFiles,
141
+ prunedDirectories,
142
+ backupResult
143
+ });
144
+ const storeHandling = {
145
+ status: "preserved",
146
+ reason: "Installation state records removal. Other projects and general lifecycle evidence remain in the Store."
147
+ };
148
+ const receiptActions = [
149
+ ...removedFiles.map((relativePath) => ({ type: "remove-managed", disposition: "remove", relativePath })),
150
+ ...plan.auditReport.preservedPaths.map((entry) => ({ type: "noop", disposition: "preserve", relativePath: entry.path }))
151
+ ];
152
+ const didMutate = removedFiles.length > 0 || prunedDirectories.length > 0 || Boolean(backupResult?.destinationDir);
153
+ const receipt = didMutate ? createLifecycleMutationReceipt({
154
+ operation: "setup.remove",
155
+ projectId: projectIdentity.status === "resolved" ? projectIdentity.projectId : "unresolved",
156
+ manifestSchemaVersion: manifest?.schemaVersion ?? 3,
157
+ profileId: manifest?.profileId ?? "unresolved",
158
+ selectedResourceTypes: manifest?.selections.resourceProjection ?? [],
159
+ actions: receiptActions,
160
+ backupReferences: backupResult?.destinationDir ? [backupResult.destinationDir] : []
161
+ }) : void 0;
162
+ return {
163
+ status: "completed",
164
+ plan,
165
+ backupResult,
166
+ removedFiles,
167
+ prunedDirectories,
168
+ storeHandling,
169
+ ...receipt ? { receipt } : {}
170
+ };
171
+ }, { storeRoot: options.storeRoot, projectId: manifest?.projectId });
172
+ }
173
+ function assertRemovalEvidenceCurrent(entry) {
174
+ let stats;
175
+ try {
176
+ stats = lstatSync(entry.absolutePath);
177
+ } catch (error) {
178
+ if (error.code === "ENOENT") return;
179
+ throw error;
180
+ }
181
+ if (stats.isSymbolicLink()) return;
182
+ if (entry.kind === "directory") {
183
+ if (!stats.isDirectory()) throw new Error(`Removal entry changed type: ${entry.path}`);
184
+ return;
185
+ }
186
+ if (!stats.isFile()) throw new Error(`Removal entry changed type: ${entry.path}`);
187
+ if (entry.currentHash) {
188
+ const content = readFileSync(entry.absolutePath, "utf8");
189
+ const currentHash = getManifestFileHash(entry.path, content) ?? hashText(content);
190
+ if (currentHash !== entry.currentHash) {
191
+ throw new Error(`Removal evidence changed after review: ${entry.path}`);
192
+ }
193
+ }
194
+ }
195
+ async function loadAuditReport(options) {
196
+ const manifest = loadManifest(options.targetDir);
197
+ return createAuditReport({
198
+ targetDir: options.targetDir,
199
+ manifest,
200
+ homeDir: options.homeDir
201
+ });
202
+ }
203
+ function assertNotInsideBackupRoot(targetDir, candidatePath) {
204
+ const normalizedCandidate = path.resolve(candidatePath);
205
+ const backupRoot = getProjectBackupStateRoots(targetDir).find(
206
+ (root) => isWithinRoot(root, normalizedCandidate)
207
+ );
208
+ if (backupRoot) {
209
+ throw new Error(
210
+ `Refusing to remove a path inside project backup payloads (${backupRoot}): ${candidatePath}`
211
+ );
212
+ }
213
+ }
214
+ function createUninstallError(message) {
215
+ return new Error(message);
216
+ }
217
+ function toErrorMessage(error) {
218
+ return error instanceof Error ? error.message : String(error);
219
+ }
220
+ export {
221
+ runUninstallCommand
222
+ };
223
+ //# sourceMappingURL=uninstall-3UXXXNFO.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/uninstall.ts"],"sourcesContent":["import { removeInstallationPath } from \"./installation-files\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { existsSync, lstatSync, readdirSync, readFileSync } from \"node:fs\";\nimport {\n executePreparedBackup,\n prepareBackupExecution,\n resolveBackupDestinationPlan,\n} from \"./backup\";\nimport { getProjectBackupStateRoots, isWithinRoot } from \"./backup-paths\";\nimport { createAuditReport } from \"./audit\";\nimport {\n getLifecycleRenderer,\n} from \"./lifecycle-ui\";\nimport { getManifestFileHash, loadManifest } from \"./manifest\";\nimport { resolveProjectIdentity } from \"./store\";\nimport { recordPlannedFileChange, removeInstallationManifest, withInstallationOperation } from \"./store/installation-state\";\nimport type {\n AuditReport,\n BackupDestinationPlan,\n BackupExecutionResult,\n LifecyclePermissionsMode,\n LifecycleMutationReceipt,\n PlannedAction,\n} from \"./types\";\nimport * as fileUtils from \"./utils\";\nimport { createLifecycleMutationReceipt } from \"./lifecycle-plan\";\n\nexport interface UninstallCommandOptions {\n targetDir: string;\n backup: boolean;\n permissions: LifecyclePermissionsMode;\n auditReport?: AuditReport;\n homeDir?: string;\n now?: Date;\n /** Explicit global Store root override. */\n storeRoot?: string;\n}\n\nexport interface UninstallReviewPlan {\n targetDir: string;\n backupRequested: boolean;\n backupDestinationPlan: BackupDestinationPlan | null;\n backupDestinationDir: string | null;\n auditReport: AuditReport;\n classificationSnapshotId: string;\n}\n\nexport type UninstallExecutionResult =\n | {\n status: \"cancelled\";\n checkpoint: \"warning\" | \"final\";\n plan: UninstallReviewPlan | null;\n }\n | {\n status: \"completed\";\n plan: UninstallReviewPlan;\n backupResult: BackupExecutionResult | null;\n removedFiles: string[];\n prunedDirectories: string[];\n /** Project removal preserves machine-level Store rows in W19 R1 P4. */\n storeHandling: { status: \"preserved\"; reason: string };\n receipt?: LifecycleMutationReceipt;\n };\n\nexport async function runUninstallCommand(\n options: UninstallCommandOptions,\n): Promise<UninstallExecutionResult> {\n const renderer = getLifecycleRenderer();\n const targetDir = path.resolve(options.targetDir);\n const homeDir = path.resolve(options.homeDir ?? os.homedir());\n const backupDestinationPlan = options.backup\n ? resolveBackupDestinationPlan(targetDir, options.now ?? new Date())\n : null;\n const backupDestinationDir = backupDestinationPlan?.destinationDir ?? null;\n\n renderer.beginWorkflow(\"make-docs setup remove\");\n renderer.renderUninstallWarning({\n targetDir,\n backupDestinationDir,\n });\n\n const warningApproved = await renderer.confirmUninstallWarning(\n options.permissions,\n );\n if (!warningApproved) {\n renderer.renderUninstallCancelled();\n return {\n status: \"cancelled\",\n checkpoint: \"warning\",\n plan: null,\n };\n }\n\n const auditReport =\n options.auditReport ??\n (await loadAuditReport({\n targetDir,\n homeDir,\n }));\n\n const plan: UninstallReviewPlan = {\n targetDir,\n backupRequested: options.backup,\n backupDestinationPlan,\n backupDestinationDir,\n auditReport,\n classificationSnapshotId: fileUtils.hashText(JSON.stringify(auditReport)),\n };\n\n renderer.renderUninstallAuditSummary({\n auditReport,\n backupDestinationDir,\n });\n\n const finalApproved = await renderer.confirmUninstallRun({\n permissions: options.permissions,\n backupRequested: options.backup,\n });\n if (!finalApproved) {\n renderer.renderUninstallCancelled();\n return {\n status: \"cancelled\",\n checkpoint: \"final\",\n plan,\n };\n }\n\n // Capture the project identity before removal. The returned receipt uses\n // this identity after the removal loop deletes the manifest.\n const projectIdentity = resolveProjectIdentity(plan.targetDir);\n const manifest = loadManifest(plan.targetDir);\n\n const preparedBackup = plan.backupRequested ? await prepareBackupExecution({\n targetDir, homeDir, now: options.now, auditReport: plan.auditReport,\n destinationPlan: plan.backupDestinationPlan,\n }) : null;\n\n return withInstallationOperation(targetDir, \"setup.remove\", () => {\n removeInstallationManifest(targetDir);\n let backupResult: BackupExecutionResult | null = null;\n if (preparedBackup) {\n try { backupResult = executePreparedBackup(preparedBackup); }\n catch (error) { throw new Error(`Backup failed before uninstall removal began: ${error instanceof Error ? error.message : String(error)}`, { cause: error }); }\n }\n\n const removedFiles: string[] = [];\n const prunedDirectories: string[] = [];\n\n try {\n for (const removableFile of plan.auditReport.removableFiles) {\n assertNotInsideBackupRoot(plan.targetDir, removableFile.absolutePath);\n assertRemovalEvidenceCurrent(removableFile);\n const removed = removeInstallationPath(targetDir, removableFile.path);\n if (removed) {\n removedFiles.push(removableFile.path);\n }\n }\n\n for (const prunableDirectory of plan.auditReport.prunableDirectories) {\n if (path.resolve(prunableDirectory.absolutePath) === path.resolve(homeDir, \".make-docs\")) continue;\n assertNotInsideBackupRoot(plan.targetDir, prunableDirectory.absolutePath);\n if (existsSync(prunableDirectory.absolutePath) && readdirSync(prunableDirectory.absolutePath).length === 0) {\n recordPlannedFileChange(targetDir, prunableDirectory.path, { kind: \"missing\" }, () => {\n if (fileUtils.pruneDirectoryIfEmpty(prunableDirectory.absolutePath)) prunedDirectories.push(prunableDirectory.path);\n });\n }\n }\n } catch (error) {\n renderer.renderUninstallFailureSummary({\n auditReport: plan.auditReport,\n removedFiles,\n prunedDirectories,\n backupResult,\n errorMessage: toErrorMessage(error),\n });\n throw createUninstallError(\n `Uninstall partially completed after removing ${removedFiles.length} file(s) and pruning ${prunedDirectories.length} director${prunedDirectories.length === 1 ? \"y\" : \"ies\"}: ${toErrorMessage(error)}`,\n );\n }\n\n renderer.renderUninstallCompletionSummary({\n auditReport: plan.auditReport,\n removedFiles,\n prunedDirectories,\n backupResult,\n });\n\n // Project removal preserves machine-level Store rows. Machine-level Store\n // removal remains a separate product operation.\n const storeHandling = {\n status: \"preserved\" as const,\n reason: \"Installation state records removal. Other projects and general lifecycle evidence remain in the Store.\",\n };\n const receiptActions: PlannedAction[] = [\n ...removedFiles.map((relativePath) => ({ type: \"remove-managed\" as const, disposition: \"remove\" as const, relativePath })),\n ...plan.auditReport.preservedPaths.map((entry) => ({ type: \"noop\" as const, disposition: \"preserve\" as const, relativePath: entry.path })),\n ];\n const didMutate = removedFiles.length > 0\n || prunedDirectories.length > 0\n || Boolean(backupResult?.destinationDir);\n const receipt = didMutate\n ? createLifecycleMutationReceipt({\n operation: \"setup.remove\",\n projectId: projectIdentity.status === \"resolved\" ? projectIdentity.projectId : \"unresolved\",\n manifestSchemaVersion: manifest?.schemaVersion ?? 3,\n profileId: manifest?.profileId ?? \"unresolved\",\n selectedResourceTypes: manifest?.selections.resourceProjection ?? [],\n actions: receiptActions,\n backupReferences: backupResult?.destinationDir ? [backupResult.destinationDir] : [],\n })\n : undefined;\n\n return {\n status: \"completed\",\n plan,\n backupResult,\n removedFiles,\n prunedDirectories,\n storeHandling,\n ...(receipt ? { receipt } : {}),\n };\n }, { storeRoot: options.storeRoot, projectId: manifest?.projectId });\n}\n\nfunction assertRemovalEvidenceCurrent(entry: AuditReport[\"removableFiles\"][number]): void {\n let stats;\n try {\n stats = lstatSync(entry.absolutePath);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return;\n throw error;\n }\n if (stats.isSymbolicLink()) return;\n if (entry.kind === \"directory\") {\n if (!stats.isDirectory()) throw new Error(`Removal entry changed type: ${entry.path}`);\n return;\n }\n if (!stats.isFile()) throw new Error(`Removal entry changed type: ${entry.path}`);\n if (entry.currentHash) {\n const content = readFileSync(entry.absolutePath, \"utf8\");\n const currentHash = getManifestFileHash(entry.path, content) ?? fileUtils.hashText(content);\n if (currentHash !== entry.currentHash) {\n throw new Error(`Removal evidence changed after review: ${entry.path}`);\n }\n }\n}\n\nasync function loadAuditReport(options: {\n targetDir: string;\n homeDir: string;\n}): Promise<AuditReport> {\n const manifest = loadManifest(options.targetDir);\n return createAuditReport({\n targetDir: options.targetDir,\n manifest,\n homeDir: options.homeDir,\n });\n}\n\nfunction assertNotInsideBackupRoot(targetDir: string, candidatePath: string): void {\n const normalizedCandidate = path.resolve(candidatePath);\n const backupRoot = getProjectBackupStateRoots(targetDir).find((root) =>\n isWithinRoot(root, normalizedCandidate),\n );\n\n if (backupRoot) {\n throw new Error(\n `Refusing to remove a path inside project backup payloads (${backupRoot}): ${candidatePath}`,\n );\n }\n}\n\nfunction createUninstallError(message: string): Error {\n return new Error(message);\n}\n\nfunction toErrorMessage(error: unknown): string {\n return error instanceof Error ? error.message : String(error);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,SAAS,YAAY,WAAW,aAAa,oBAAoB;AA8DjE,eAAsB,oBACpB,SACmC;AACnC,QAAM,WAAW,qBAAqB;AACtC,QAAM,YAAY,KAAK,QAAQ,QAAQ,SAAS;AAChD,QAAM,UAAU,KAAK,QAAQ,QAAQ,WAAW,GAAG,QAAQ,CAAC;AAC5D,QAAM,wBAAwB,QAAQ,SAClC,6BAA6B,WAAW,QAAQ,OAAO,oBAAI,KAAK,CAAC,IACjE;AACJ,QAAM,uBAAuB,uBAAuB,kBAAkB;AAEtE,WAAS,cAAc,wBAAwB;AAC/C,WAAS,uBAAuB;AAAA,IAC9B;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,kBAAkB,MAAM,SAAS;AAAA,IACrC,QAAQ;AAAA,EACV;AACA,MAAI,CAAC,iBAAiB;AACpB,aAAS,yBAAyB;AAClC,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,YAAY;AAAA,MACZ,MAAM;AAAA,IACR;AAAA,EACF;AAEA,QAAM,cACJ,QAAQ,eACP,MAAM,gBAAgB;AAAA,IACrB;AAAA,IACA;AAAA,EACF,CAAC;AAEH,QAAM,OAA4B;AAAA,IAChC;AAAA,IACA,iBAAiB,QAAQ;AAAA,IACzB;AAAA,IACA;AAAA,IACA;AAAA,IACA,0BAAoC,SAAS,KAAK,UAAU,WAAW,CAAC;AAAA,EAC1E;AAEA,WAAS,4BAA4B;AAAA,IACnC;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,gBAAgB,MAAM,SAAS,oBAAoB;AAAA,IACvD,aAAa,QAAQ;AAAA,IACrB,iBAAiB,QAAQ;AAAA,EAC3B,CAAC;AACD,MAAI,CAAC,eAAe;AAClB,aAAS,yBAAyB;AAClC,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,YAAY;AAAA,MACZ;AAAA,IACF;AAAA,EACF;AAIA,QAAM,kBAAkB,uBAAuB,KAAK,SAAS;AAC7D,QAAM,WAAW,aAAa,KAAK,SAAS;AAE5C,QAAM,iBAAiB,KAAK,kBAAkB,MAAM,uBAAuB;AAAA,IACzE;AAAA,IAAW;AAAA,IAAS,KAAK,QAAQ;AAAA,IAAK,aAAa,KAAK;AAAA,IACxD,iBAAiB,KAAK;AAAA,EACxB,CAAC,IAAI;AAEL,SAAO,0BAA0B,WAAW,gBAAgB,MAAM;AAChE,+BAA2B,SAAS;AACpC,QAAI,eAA6C;AACjD,QAAI,gBAAgB;AAClB,UAAI;AAAE,uBAAe,sBAAsB,cAAc;AAAA,MAAG,SACrD,OAAO;AAAE,cAAM,IAAI,MAAM,iDAAiD,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC,IAAI,EAAE,OAAO,MAAM,CAAC;AAAA,MAAG;AAAA,IAChK;AAEA,UAAM,eAAyB,CAAC;AAChC,UAAM,oBAA8B,CAAC;AAErC,QAAI;AACF,iBAAW,iBAAiB,KAAK,YAAY,gBAAgB;AAC3D,kCAA0B,KAAK,WAAW,cAAc,YAAY;AACpE,qCAA6B,aAAa;AAC1C,cAAM,UAAU,uBAAuB,WAAW,cAAc,IAAI;AACpE,YAAI,SAAS;AACX,uBAAa,KAAK,cAAc,IAAI;AAAA,QACtC;AAAA,MACF;AAEA,iBAAW,qBAAqB,KAAK,YAAY,qBAAqB;AACpE,YAAI,KAAK,QAAQ,kBAAkB,YAAY,MAAM,KAAK,QAAQ,SAAS,YAAY,EAAG;AAC1F,kCAA0B,KAAK,WAAW,kBAAkB,YAAY;AACxE,YAAI,WAAW,kBAAkB,YAAY,KAAK,YAAY,kBAAkB,YAAY,EAAE,WAAW,GAAG;AAC1G,kCAAwB,WAAW,kBAAkB,MAAM,EAAE,MAAM,UAAU,GAAG,MAAM;AACpF,gBAAc,sBAAsB,kBAAkB,YAAY,EAAG,mBAAkB,KAAK,kBAAkB,IAAI;AAAA,UACpH,CAAC;AAAA,QACH;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,eAAS,8BAA8B;AAAA,QACrC,aAAa,KAAK;AAAA,QAClB;AAAA,QACA;AAAA,QACA;AAAA,QACA,cAAc,eAAe,KAAK;AAAA,MACpC,CAAC;AACD,YAAM;AAAA,QACJ,gDAAgD,aAAa,MAAM,wBAAwB,kBAAkB,MAAM,YAAY,kBAAkB,WAAW,IAAI,MAAM,KAAK,KAAK,eAAe,KAAK,CAAC;AAAA,MACvM;AAAA,IACF;AAEA,aAAS,iCAAiC;AAAA,MACxC,aAAa,KAAK;AAAA,MAClB;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAID,UAAM,gBAAgB;AAAA,MACpB,QAAQ;AAAA,MACR,QAAQ;AAAA,IACV;AACA,UAAM,iBAAkC;AAAA,MACtC,GAAG,aAAa,IAAI,CAAC,kBAAkB,EAAE,MAAM,kBAA2B,aAAa,UAAmB,aAAa,EAAE;AAAA,MACzH,GAAG,KAAK,YAAY,eAAe,IAAI,CAAC,WAAW,EAAE,MAAM,QAAiB,aAAa,YAAqB,cAAc,MAAM,KAAK,EAAE;AAAA,IAC3I;AACA,UAAM,YAAY,aAAa,SAAS,KACnC,kBAAkB,SAAS,KAC3B,QAAQ,cAAc,cAAc;AACzC,UAAM,UAAU,YACZ,+BAA+B;AAAA,MAC7B,WAAW;AAAA,MACX,WAAW,gBAAgB,WAAW,aAAa,gBAAgB,YAAY;AAAA,MAC/E,uBAAuB,UAAU,iBAAiB;AAAA,MAClD,WAAW,UAAU,aAAa;AAAA,MAClC,uBAAuB,UAAU,WAAW,sBAAsB,CAAC;AAAA,MACnE,SAAS;AAAA,MACT,kBAAkB,cAAc,iBAAiB,CAAC,aAAa,cAAc,IAAI,CAAC;AAAA,IACpF,CAAC,IACD;AAEJ,WAAO;AAAA,MACL,QAAQ;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,IAC/B;AAAA,EACF,GAAG,EAAE,WAAW,QAAQ,WAAW,WAAW,UAAU,UAAU,CAAC;AACrE;AAEA,SAAS,6BAA6B,OAAoD;AACxF,MAAI;AACJ,MAAI;AACF,YAAQ,UAAU,MAAM,YAAY;AAAA,EACtC,SAAS,OAAO;AACd,QAAK,MAAgC,SAAS,SAAU;AACxD,UAAM;AAAA,EACR;AACA,MAAI,MAAM,eAAe,EAAG;AAC5B,MAAI,MAAM,SAAS,aAAa;AAC9B,QAAI,CAAC,MAAM,YAAY,EAAG,OAAM,IAAI,MAAM,+BAA+B,MAAM,IAAI,EAAE;AACrF;AAAA,EACF;AACA,MAAI,CAAC,MAAM,OAAO,EAAG,OAAM,IAAI,MAAM,+BAA+B,MAAM,IAAI,EAAE;AAChF,MAAI,MAAM,aAAa;AACrB,UAAM,UAAU,aAAa,MAAM,cAAc,MAAM;AACvD,UAAM,cAAc,oBAAoB,MAAM,MAAM,OAAO,KAAe,SAAS,OAAO;AAC1F,QAAI,gBAAgB,MAAM,aAAa;AACrC,YAAM,IAAI,MAAM,0CAA0C,MAAM,IAAI,EAAE;AAAA,IACxE;AAAA,EACF;AACF;AAEA,eAAe,gBAAgB,SAGN;AACvB,QAAM,WAAW,aAAa,QAAQ,SAAS;AAC/C,SAAO,kBAAkB;AAAA,IACvB,WAAW,QAAQ;AAAA,IACnB;AAAA,IACA,SAAS,QAAQ;AAAA,EACnB,CAAC;AACH;AAEA,SAAS,0BAA0B,WAAmB,eAA6B;AACjF,QAAM,sBAAsB,KAAK,QAAQ,aAAa;AACtD,QAAM,aAAa,2BAA2B,SAAS,EAAE;AAAA,IAAK,CAAC,SAC7D,aAAa,MAAM,mBAAmB;AAAA,EACxC;AAEA,MAAI,YAAY;AACd,UAAM,IAAI;AAAA,MACR,6DAA6D,UAAU,MAAM,aAAa;AAAA,IAC5F;AAAA,EACF;AACF;AAEA,SAAS,qBAAqB,SAAwB;AACpD,SAAO,IAAI,MAAM,OAAO;AAC1B;AAEA,SAAS,eAAe,OAAwB;AAC9C,SAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;","names":[]}