@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.
- package/LICENSE +21 -201
- package/README.md +36 -27
- package/dist/backup-73HQNKMC.js +20 -0
- package/dist/backup-73HQNKMC.js.map +1 -0
- package/dist/chunk-3BAJQXGH.js +1575 -0
- package/dist/chunk-3BAJQXGH.js.map +1 -0
- package/dist/chunk-64CTKJO7.js +4136 -0
- package/dist/chunk-64CTKJO7.js.map +1 -0
- package/dist/chunk-BENO4IH5.js +875 -0
- package/dist/chunk-BENO4IH5.js.map +1 -0
- package/dist/chunk-D4HDZEJT.js +37 -0
- package/dist/chunk-D4HDZEJT.js.map +1 -0
- package/dist/chunk-G5EF63GG.js +1291 -0
- package/dist/chunk-G5EF63GG.js.map +1 -0
- package/dist/chunk-GNP6HRVP.js +523 -0
- package/dist/chunk-GNP6HRVP.js.map +1 -0
- package/dist/chunk-HJYIQTMD.js +204 -0
- package/dist/chunk-HJYIQTMD.js.map +1 -0
- package/dist/chunk-LQ5NSWCJ.js +39 -0
- package/dist/chunk-LQ5NSWCJ.js.map +1 -0
- package/dist/chunk-LRVV7UDD.js +2340 -0
- package/dist/chunk-LRVV7UDD.js.map +1 -0
- package/dist/chunk-LVQSJF63.js +24674 -0
- package/dist/chunk-LVQSJF63.js.map +1 -0
- package/dist/chunk-MXBHCHSM.js +13995 -0
- package/dist/chunk-MXBHCHSM.js.map +1 -0
- package/dist/chunk-Z5K4FHYP.js +922 -0
- package/dist/chunk-Z5K4FHYP.js.map +1 -0
- package/dist/index.js +3798 -250
- package/dist/index.js.map +1 -1
- package/dist/self-YYXOLDKU.js +653 -0
- package/dist/self-YYXOLDKU.js.map +1 -0
- package/dist/server-O2ZELIMX.js +512 -0
- package/dist/server-O2ZELIMX.js.map +1 -0
- package/dist/setup-system-HZROFNMP.js +544 -0
- package/dist/setup-system-HZROFNMP.js.map +1 -0
- package/dist/{skills-command-3ESCZ75U.js → skills-command-MGGHY7HU.js} +190 -32
- package/dist/skills-command-MGGHY7HU.js.map +1 -0
- package/dist/uninstall-3UXXXNFO.js +223 -0
- package/dist/uninstall-3UXXXNFO.js.map +1 -0
- package/dist/virtual_make-docs-first-party-skills-ZII74YOB.js +11 -0
- package/dist/virtual_make-docs-first-party-skills-ZII74YOB.js.map +1 -0
- package/package.json +9 -6
- package/skill-registry.json +328 -125
- package/skill-registry.schema.json +221 -45
- package/template/.make-docs/AGENTS.md +18 -0
- package/template/.make-docs/CLAUDE.md +18 -0
- package/template/.make-docs/archive/AGENTS.md +11 -0
- package/template/.make-docs/archive/CLAUDE.md +11 -0
- package/template/.make-docs/system/AGENTS.md +12 -0
- package/template/.make-docs/system/CLAUDE.md +12 -0
- package/template/.make-docs/system/contracts/AGENTS.md +13 -0
- package/template/.make-docs/system/contracts/CLAUDE.md +13 -0
- package/template/{docs/assets/references → .make-docs/system/contracts}/commit-message-convention.md +4 -4
- package/template/.make-docs/system/contracts/coverage-pass-contract.md +198 -0
- package/template/.make-docs/system/contracts/deferred-obligation-contract.md +128 -0
- package/template/{docs/assets/references → .make-docs/system/contracts}/design-contract.md +7 -2
- package/template/{docs/assets/references → .make-docs/system/contracts}/guide-contract.md +21 -19
- package/template/{docs/assets/references → .make-docs/system/contracts}/history-record-contract.md +17 -11
- package/template/.make-docs/system/contracts/human-experience-contract.md +134 -0
- package/template/.make-docs/system/contracts/naive-uat-contract.md +231 -0
- package/template/.make-docs/system/contracts/output-contract.md +277 -0
- package/template/.make-docs/system/contracts/performance-evidence-governance.md +257 -0
- package/template/.make-docs/system/contracts/system-resource-contract.md +93 -0
- package/template/.make-docs/system/prompts/AGENTS.md +12 -0
- package/template/.make-docs/system/prompts/CLAUDE.md +12 -0
- package/template/.make-docs/system/prompts/coverage-pass-maintainer-guide.prompt.md +20 -0
- package/template/.make-docs/system/prompts/coverage-pass-prd-reconciliation.prompt.md +18 -0
- package/template/.make-docs/system/prompts/coverage-pass-testing-uat.prompt.md +46 -0
- package/template/.make-docs/system/prompts/coverage-pass-user-guide.prompt.md +20 -0
- package/template/.make-docs/system/prompts/designs-to-plan-change.prompt.md +18 -0
- package/template/.make-docs/system/prompts/designs-to-plan.prompt.md +14 -0
- package/template/.make-docs/system/prompts/docs-path-hygiene-cleanup.prompt.md +29 -0
- package/template/.make-docs/system/prompts/naive-uat-facilitator.prompt.md +28 -0
- package/template/.make-docs/system/prompts/naive-uat-tester.prompt.md +20 -0
- package/template/.make-docs/system/prompts/performance-coverage.prompt.md +63 -0
- package/template/.make-docs/system/prompts/plan-to-prd-change.prompt.md +12 -0
- package/template/.make-docs/system/prompts/plan-to-prd-green-field.prompt.md +10 -0
- package/template/.make-docs/system/prompts/prd-change-to-work.prompt.md +14 -0
- package/template/.make-docs/system/prompts/prd-to-work-full-prd.prompt.md +10 -0
- package/template/.make-docs/system/prompts/prd-to-work-prd-feature.prompt.md +10 -0
- package/template/.make-docs/system/prompts/request-to-design.prompt.md +20 -0
- package/template/.make-docs/system/prompts/session-to-history-record.prompt.md +23 -0
- package/template/{docs/assets → .make-docs/system}/prompts/work-to-commit-message.prompt.md +2 -2
- package/template/.make-docs/system/prompts/work-to-guides.prompt.md +22 -0
- package/template/.make-docs/system/references/AGENTS.md +14 -0
- package/template/.make-docs/system/references/CLAUDE.md +14 -0
- package/template/{docs/assets → .make-docs/system}/references/design-workflow.md +15 -2
- package/template/.make-docs/system/references/execution-workflow.md +189 -0
- package/template/.make-docs/system/references/human-experience.md +138 -0
- package/template/.make-docs/system/references/lifecycle.md +153 -0
- package/template/.make-docs/system/references/naive-uat-validation.md +65 -0
- package/template/.make-docs/system/references/naive-uat-workflow.md +64 -0
- package/template/.make-docs/system/references/path-and-link-hygiene.md +101 -0
- package/template/.make-docs/system/references/performance-evidence.md +114 -0
- package/template/.make-docs/system/references/planning-workflow.md +209 -0
- package/template/.make-docs/system/references/prd-change-management.md +165 -0
- package/template/{docs/assets → .make-docs/system}/references/wave-model.md +10 -8
- package/template/.make-docs/system/templates/AGENTS.md +12 -0
- package/template/.make-docs/system/templates/CLAUDE.md +12 -0
- package/template/.make-docs/system/templates/design.md +79 -0
- package/template/{docs/assets/templates/guide-developer.md → .make-docs/system/templates/guide-maintainer.md} +7 -3
- package/template/{docs/assets → .make-docs/system}/templates/guide-user.md +6 -2
- package/template/{docs/assets → .make-docs/system}/templates/history-record.md +6 -3
- package/template/.make-docs/system/templates/naive-uat-scenario.md +91 -0
- package/template/.make-docs/system/templates/performance-evidence-profile.md +252 -0
- package/template/.make-docs/system/templates/plan-overview.md +76 -0
- package/template/.make-docs/system/templates/plan-prd-change.md +155 -0
- package/template/{docs/assets → .make-docs/system}/templates/plan-prd-decompose.md +10 -0
- package/template/{docs/assets → .make-docs/system}/templates/plan-prd.md +28 -2
- package/template/{docs/assets → .make-docs/system}/templates/prd-architecture.md +13 -0
- package/template/.make-docs/system/templates/prd-glossary.md +28 -0
- package/template/.make-docs/system/templates/prd-index.md +70 -0
- package/template/{docs/assets → .make-docs/system}/templates/prd-overview.md +13 -0
- package/template/.make-docs/system/templates/prd-reference.md +30 -0
- package/template/{docs/assets → .make-docs/system}/templates/prd-risk-register.md +16 -1
- package/template/{docs/assets → .make-docs/system}/templates/prd-subsystem.md +15 -0
- package/template/.make-docs/system/templates/work-index.md +58 -0
- package/template/.make-docs/system/templates/work-phase.md +107 -0
- package/template/.make-docs/system-resources.catalog.json +91 -0
- package/template/.make-docs/system-resources.schema.json +204 -0
- package/template/AGENTS.md +8 -1
- package/template/CLAUDE.md +8 -1
- package/template/docs/AGENTS.codex-only.md +22 -0
- package/template/docs/AGENTS.md +21 -13
- package/template/docs/CLAUDE.claude-only.md +22 -0
- package/template/docs/CLAUDE.md +21 -13
- package/template/docs/assets/AGENTS.md +11 -7
- package/template/docs/assets/CLAUDE.md +11 -7
- package/template/docs/designs/AGENTS.md +8 -3
- package/template/docs/designs/CLAUDE.md +8 -3
- package/template/docs/plans/AGENTS.md +10 -3
- package/template/docs/plans/CLAUDE.md +10 -3
- package/template/docs/prd/AGENTS.md +14 -4
- package/template/docs/prd/CLAUDE.md +14 -4
- package/template/docs/work/AGENTS.md +10 -3
- package/template/docs/work/CLAUDE.md +10 -3
- package/dist/chunk-HP3HBG7F.js +0 -626
- package/dist/chunk-HP3HBG7F.js.map +0 -1
- package/dist/chunk-QRFH4J6H.js +0 -1194
- package/dist/chunk-QRFH4J6H.js.map +0 -1
- package/dist/chunk-WM3OXYTW.js +0 -2630
- package/dist/chunk-WM3OXYTW.js.map +0 -1
- package/dist/skills-command-3ESCZ75U.js.map +0 -1
- package/dist/uninstall-GQE4SJF2.js +0 -150
- package/dist/uninstall-GQE4SJF2.js.map +0 -1
- package/template/.make-docs/scripts/check_path_hygiene.py +0 -435
- package/template/docs/assets/archive/AGENTS.md +0 -20
- package/template/docs/assets/archive/CLAUDE.md +0 -20
- package/template/docs/assets/history/AGENTS.md +0 -12
- package/template/docs/assets/history/CLAUDE.md +0 -12
- package/template/docs/assets/prompts/AGENTS.md +0 -8
- package/template/docs/assets/prompts/CLAUDE.md +0 -8
- package/template/docs/assets/prompts/designs-to-plan-change.prompt.md +0 -14
- package/template/docs/assets/prompts/designs-to-plan.prompt.md +0 -10
- package/template/docs/assets/prompts/docs-path-hygiene-cleanup.prompt.md +0 -27
- package/template/docs/assets/prompts/plan-to-prd-change.prompt.md +0 -8
- package/template/docs/assets/prompts/plan-to-prd-green-field.prompt.md +0 -6
- package/template/docs/assets/prompts/prd-change-to-work.prompt.md +0 -10
- package/template/docs/assets/prompts/prd-to-work-full-prd.prompt.md +0 -6
- package/template/docs/assets/prompts/prd-to-work-prd-feature.prompt.md +0 -6
- package/template/docs/assets/prompts/request-to-design.prompt.md +0 -16
- package/template/docs/assets/prompts/session-to-history-record.prompt.md +0 -19
- package/template/docs/assets/prompts/work-to-guides.prompt.md +0 -18
- package/template/docs/assets/references/AGENTS.md +0 -9
- package/template/docs/assets/references/CLAUDE.md +0 -9
- package/template/docs/assets/references/execution-workflow.md +0 -157
- package/template/docs/assets/references/output-contract.md +0 -221
- package/template/docs/assets/references/path-and-link-hygiene.md +0 -49
- package/template/docs/assets/references/planning-workflow.md +0 -160
- package/template/docs/assets/references/prd-change-management.md +0 -129
- package/template/docs/assets/templates/AGENTS.md +0 -8
- package/template/docs/assets/templates/CLAUDE.md +0 -8
- package/template/docs/assets/templates/design.md +0 -30
- package/template/docs/assets/templates/plan-overview.md +0 -32
- package/template/docs/assets/templates/plan-prd-change.md +0 -99
- package/template/docs/assets/templates/prd-change-addition.md +0 -45
- package/template/docs/assets/templates/prd-change-revision.md +0 -45
- package/template/docs/assets/templates/prd-glossary.md +0 -15
- package/template/docs/assets/templates/prd-index.md +0 -45
- package/template/docs/assets/templates/prd-reference.md +0 -17
- package/template/docs/assets/templates/work-index.md +0 -21
- package/template/docs/assets/templates/work-phase.md +0 -34
- package/template/docs/guides/AGENTS.md +0 -15
- package/template/docs/guides/CLAUDE.md +0 -15
- /package/template/{docs/assets → .make-docs/system}/prompts/update-readme-green-field.prompt.md +0 -0
- /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":"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","names":[]}
|