@lannguyensi/harness 0.5.0
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/CHANGELOG.md +552 -0
- package/LICENSE +21 -0
- package/README.md +154 -0
- package/dist/cli/add/index.d.ts +14 -0
- package/dist/cli/add/index.js +71 -0
- package/dist/cli/add/index.js.map +1 -0
- package/dist/cli/add/mutate.d.ts +39 -0
- package/dist/cli/add/mutate.js +36 -0
- package/dist/cli/add/mutate.js.map +1 -0
- package/dist/cli/adopt/derive.d.ts +38 -0
- package/dist/cli/adopt/derive.js +94 -0
- package/dist/cli/adopt/derive.js.map +1 -0
- package/dist/cli/adopt/index.d.ts +20 -0
- package/dist/cli/adopt/index.js +156 -0
- package/dist/cli/adopt/index.js.map +1 -0
- package/dist/cli/apply/apply.d.ts +49 -0
- package/dist/cli/apply/apply.js +333 -0
- package/dist/cli/apply/apply.js.map +1 -0
- package/dist/cli/apply/generate-memory-index.d.ts +17 -0
- package/dist/cli/apply/generate-memory-index.js +167 -0
- package/dist/cli/apply/generate-memory-index.js.map +1 -0
- package/dist/cli/apply/generate-settings.d.ts +15 -0
- package/dist/cli/apply/generate-settings.js +87 -0
- package/dist/cli/apply/generate-settings.js.map +1 -0
- package/dist/cli/apply/index.d.ts +1 -0
- package/dist/cli/apply/index.js +2 -0
- package/dist/cli/apply/index.js.map +1 -0
- package/dist/cli/audit.d.ts +36 -0
- package/dist/cli/audit.js +121 -0
- package/dist/cli/audit.js.map +1 -0
- package/dist/cli/describe.d.ts +13 -0
- package/dist/cli/describe.js +26 -0
- package/dist/cli/describe.js.map +1 -0
- package/dist/cli/diff/engine.d.ts +21 -0
- package/dist/cli/diff/engine.js +161 -0
- package/dist/cli/diff/engine.js.map +1 -0
- package/dist/cli/diff/git.d.ts +6 -0
- package/dist/cli/diff/git.js +32 -0
- package/dist/cli/diff/git.js.map +1 -0
- package/dist/cli/diff/index.d.ts +15 -0
- package/dist/cli/diff/index.js +39 -0
- package/dist/cli/diff/index.js.map +1 -0
- package/dist/cli/diff/since-apply.d.ts +57 -0
- package/dist/cli/diff/since-apply.js +255 -0
- package/dist/cli/diff/since-apply.js.map +1 -0
- package/dist/cli/doctor/format.d.ts +2 -0
- package/dist/cli/doctor/format.js +126 -0
- package/dist/cli/doctor/format.js.map +1 -0
- package/dist/cli/doctor/index.d.ts +14 -0
- package/dist/cli/doctor/index.js +281 -0
- package/dist/cli/doctor/index.js.map +1 -0
- package/dist/cli/doctor/types.d.ts +46 -0
- package/dist/cli/doctor/types.js +2 -0
- package/dist/cli/doctor/types.js.map +1 -0
- package/dist/cli/dry-run.d.ts +46 -0
- package/dist/cli/dry-run.js +168 -0
- package/dist/cli/dry-run.js.map +1 -0
- package/dist/cli/exit-codes.d.ts +10 -0
- package/dist/cli/exit-codes.js +15 -0
- package/dist/cli/exit-codes.js.map +1 -0
- package/dist/cli/explain.d.ts +14 -0
- package/dist/cli/explain.js +97 -0
- package/dist/cli/explain.js.map +1 -0
- package/dist/cli/export.d.ts +31 -0
- package/dist/cli/export.js +84 -0
- package/dist/cli/export.js.map +1 -0
- package/dist/cli/index.d.ts +8 -0
- package/dist/cli/index.js +549 -0
- package/dist/cli/index.js.map +1 -0
- package/dist/cli/init/index.d.ts +17 -0
- package/dist/cli/init/index.js +57 -0
- package/dist/cli/init/index.js.map +1 -0
- package/dist/cli/init/templates.d.ts +4 -0
- package/dist/cli/init/templates.js +175 -0
- package/dist/cli/init/templates.js.map +1 -0
- package/dist/cli/list.d.ts +12 -0
- package/dist/cli/list.js +118 -0
- package/dist/cli/list.js.map +1 -0
- package/dist/cli/loader.d.ts +24 -0
- package/dist/cli/loader.js +74 -0
- package/dist/cli/loader.js.map +1 -0
- package/dist/cli/main.d.ts +2 -0
- package/dist/cli/main.js +6 -0
- package/dist/cli/main.js.map +1 -0
- package/dist/cli/policy/intercept.d.ts +34 -0
- package/dist/cli/policy/intercept.js +172 -0
- package/dist/cli/policy/intercept.js.map +1 -0
- package/dist/cli/remove/index.d.ts +18 -0
- package/dist/cli/remove/index.js +95 -0
- package/dist/cli/remove/index.js.map +1 -0
- package/dist/cli/remove/mutate.d.ts +9 -0
- package/dist/cli/remove/mutate.js +68 -0
- package/dist/cli/remove/mutate.js.map +1 -0
- package/dist/cli/validate/checks.d.ts +23 -0
- package/dist/cli/validate/checks.js +253 -0
- package/dist/cli/validate/checks.js.map +1 -0
- package/dist/cli/validate/index.d.ts +18 -0
- package/dist/cli/validate/index.js +50 -0
- package/dist/cli/validate/index.js.map +1 -0
- package/dist/cli/validate/types.d.ts +7 -0
- package/dist/cli/validate/types.js +5 -0
- package/dist/cli/validate/types.js.map +1 -0
- package/dist/index.d.ts +15 -0
- package/dist/index.js +16 -0
- package/dist/index.js.map +1 -0
- package/dist/io/atomic-write.d.ts +8 -0
- package/dist/io/atomic-write.js +30 -0
- package/dist/io/atomic-write.js.map +1 -0
- package/dist/io/harness-lock.d.ts +33 -0
- package/dist/io/harness-lock.js +260 -0
- package/dist/io/harness-lock.js.map +1 -0
- package/dist/io/last-apply.d.ts +20 -0
- package/dist/io/last-apply.js +123 -0
- package/dist/io/last-apply.js.map +1 -0
- package/dist/io/lock.d.ts +11 -0
- package/dist/io/lock.js +33 -0
- package/dist/io/lock.js.map +1 -0
- package/dist/io/patch.d.ts +10 -0
- package/dist/io/patch.js +8 -0
- package/dist/io/patch.js.map +1 -0
- package/dist/io/restart-hints.d.ts +5 -0
- package/dist/io/restart-hints.js +59 -0
- package/dist/io/restart-hints.js.map +1 -0
- package/dist/io/three-state.d.ts +7 -0
- package/dist/io/three-state.js +20 -0
- package/dist/io/three-state.js.map +1 -0
- package/dist/io/validate-before-write.d.ts +12 -0
- package/dist/io/validate-before-write.js +23 -0
- package/dist/io/validate-before-write.js.map +1 -0
- package/dist/overrides/index.d.ts +2 -0
- package/dist/overrides/index.js +3 -0
- package/dist/overrides/index.js.map +1 -0
- package/dist/overrides/machines.d.ts +12 -0
- package/dist/overrides/machines.js +46 -0
- package/dist/overrides/machines.js.map +1 -0
- package/dist/overrides/merge.d.ts +6 -0
- package/dist/overrides/merge.js +173 -0
- package/dist/overrides/merge.js.map +1 -0
- package/dist/policies/duration.d.ts +5 -0
- package/dist/policies/duration.js +50 -0
- package/dist/policies/duration.js.map +1 -0
- package/dist/policies/extract.d.ts +50 -0
- package/dist/policies/extract.js +190 -0
- package/dist/policies/extract.js.map +1 -0
- package/dist/policies/index.d.ts +5 -0
- package/dist/policies/index.js +6 -0
- package/dist/policies/index.js.map +1 -0
- package/dist/policies/ledger-client.d.ts +39 -0
- package/dist/policies/ledger-client.js +378 -0
- package/dist/policies/ledger-client.js.map +1 -0
- package/dist/policies/requires.d.ts +44 -0
- package/dist/policies/requires.js +146 -0
- package/dist/policies/requires.js.map +1 -0
- package/dist/policies/timestamp.d.ts +14 -0
- package/dist/policies/timestamp.js +36 -0
- package/dist/policies/timestamp.js.map +1 -0
- package/dist/probes/mcp.d.ts +29 -0
- package/dist/probes/mcp.js +226 -0
- package/dist/probes/mcp.js.map +1 -0
- package/dist/probes/memory.d.ts +24 -0
- package/dist/probes/memory.js +89 -0
- package/dist/probes/memory.js.map +1 -0
- package/dist/runtime/index.d.ts +3 -0
- package/dist/runtime/index.js +4 -0
- package/dist/runtime/index.js.map +1 -0
- package/dist/runtime/intercept.d.ts +53 -0
- package/dist/runtime/intercept.js +181 -0
- package/dist/runtime/intercept.js.map +1 -0
- package/dist/runtime/ledger-record.d.ts +43 -0
- package/dist/runtime/ledger-record.js +239 -0
- package/dist/runtime/ledger-record.js.map +1 -0
- package/dist/runtime/session-id.d.ts +10 -0
- package/dist/runtime/session-id.js +37 -0
- package/dist/runtime/session-id.js.map +1 -0
- package/dist/schema/extract.d.ts +5 -0
- package/dist/schema/extract.js +23 -0
- package/dist/schema/extract.js.map +1 -0
- package/dist/schema/grounding.d.ts +65 -0
- package/dist/schema/grounding.js +21 -0
- package/dist/schema/grounding.js.map +1 -0
- package/dist/schema/hooks.d.ts +86 -0
- package/dist/schema/hooks.js +42 -0
- package/dist/schema/hooks.js.map +1 -0
- package/dist/schema/index.d.ts +961 -0
- package/dist/schema/index.js +55 -0
- package/dist/schema/index.js.map +1 -0
- package/dist/schema/memory.d.ts +131 -0
- package/dist/schema/memory.js +38 -0
- package/dist/schema/memory.js.map +1 -0
- package/dist/schema/policies.d.ts +412 -0
- package/dist/schema/policies.js +53 -0
- package/dist/schema/policies.js.map +1 -0
- package/dist/schema/requires.d.ts +115 -0
- package/dist/schema/requires.js +57 -0
- package/dist/schema/requires.js.map +1 -0
- package/dist/schema/tools.d.ts +283 -0
- package/dist/schema/tools.js +66 -0
- package/dist/schema/tools.js.map +1 -0
- package/package.json +63 -0
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import { type LockEntry } from "../../io/harness-lock.js";
|
|
2
|
+
export declare const GENERATED_DIRNAME = "harness.generated";
|
|
3
|
+
export interface SinceApplyOptions {
|
|
4
|
+
configPath?: string;
|
|
5
|
+
homeDir?: string;
|
|
6
|
+
memoryDetail?: boolean;
|
|
7
|
+
json?: boolean;
|
|
8
|
+
}
|
|
9
|
+
export interface FileDriftEntry {
|
|
10
|
+
basename: string;
|
|
11
|
+
diff: string;
|
|
12
|
+
}
|
|
13
|
+
export interface AssetDriftEntry {
|
|
14
|
+
path: string;
|
|
15
|
+
reason: "missing" | "modified";
|
|
16
|
+
expectedSha: string;
|
|
17
|
+
currentSha?: string;
|
|
18
|
+
}
|
|
19
|
+
export type MemoryFileChange = {
|
|
20
|
+
kind: "added";
|
|
21
|
+
basename: string;
|
|
22
|
+
sha256: string;
|
|
23
|
+
} | {
|
|
24
|
+
kind: "removed";
|
|
25
|
+
basename: string;
|
|
26
|
+
previousSha256: string;
|
|
27
|
+
} | {
|
|
28
|
+
kind: "modified";
|
|
29
|
+
basename: string;
|
|
30
|
+
previousSha256: string;
|
|
31
|
+
sha256: string;
|
|
32
|
+
};
|
|
33
|
+
export interface MemoryDirDriftEntry {
|
|
34
|
+
path: string;
|
|
35
|
+
reason: "missing" | "modified";
|
|
36
|
+
/** Populated when --memory-detail is set and the directory is reachable. */
|
|
37
|
+
files?: MemoryFileChange[];
|
|
38
|
+
}
|
|
39
|
+
export interface SinceApplyResult {
|
|
40
|
+
hasDrift: boolean;
|
|
41
|
+
files: FileDriftEntry[];
|
|
42
|
+
assets: AssetDriftEntry[];
|
|
43
|
+
memories: MemoryDirDriftEntry[];
|
|
44
|
+
/** Diagnostic warnings (non-fatal); surfaced to stderr by the CLI. */
|
|
45
|
+
warnings: string[];
|
|
46
|
+
/** Human-readable formatted report. */
|
|
47
|
+
output: string;
|
|
48
|
+
/** Structured payload (also serialised when --json is set). */
|
|
49
|
+
json: {
|
|
50
|
+
files: FileDriftEntry[];
|
|
51
|
+
assets: AssetDriftEntry[];
|
|
52
|
+
memories: MemoryDirDriftEntry[];
|
|
53
|
+
};
|
|
54
|
+
}
|
|
55
|
+
declare function diffAssets(lockEntries: LockEntry[]): AssetDriftEntry[];
|
|
56
|
+
export declare function diffSinceApply(opts?: SinceApplyOptions): SinceApplyResult;
|
|
57
|
+
export { diffAssets };
|
|
@@ -0,0 +1,255 @@
|
|
|
1
|
+
// `harness diff --since-apply [--memory-detail]`. Read-only.
|
|
2
|
+
//
|
|
3
|
+
// Sources:
|
|
4
|
+
// - `<homeDir>/harness.generated/.last-apply` (Phase 3 #1, extended in #4
|
|
5
|
+
// and #5): generated-file content + manifest snapshot + per-memory-dir
|
|
6
|
+
// per-file index.
|
|
7
|
+
// - `<manifestDir>/harness.lock` (Phase 3 #1): asset SHAs + memory-dir
|
|
8
|
+
// Merkle aggregates.
|
|
9
|
+
// - On-disk current state: `harness.generated/<file>` + every locked
|
|
10
|
+
// asset path + memory dirs.
|
|
11
|
+
//
|
|
12
|
+
// Three sections in the output:
|
|
13
|
+
// `# Generated files` unified diff per generated file (last-apply ↔ on-disk)
|
|
14
|
+
// `# Asset drift` per-asset SHA mismatch summary (lock ↔ on-disk)
|
|
15
|
+
// `# Memory directories` per-dir Merkle drift; --memory-detail expands
|
|
16
|
+
// to per-file added / removed / modified.
|
|
17
|
+
//
|
|
18
|
+
// Exit code:
|
|
19
|
+
// 0 → no drift across all sections
|
|
20
|
+
// 1 → at least one section reported drift (so CI can branch)
|
|
21
|
+
import * as crypto from "node:crypto";
|
|
22
|
+
import * as fs from "node:fs";
|
|
23
|
+
import * as os from "node:os";
|
|
24
|
+
import * as path from "node:path";
|
|
25
|
+
import { LOCK_BASENAME, computeMemoryDirEntry, readLock, } from "../../io/harness-lock.js";
|
|
26
|
+
import { LAST_APPLY_BASENAME, readLastApply, } from "../../io/last-apply.js";
|
|
27
|
+
import { unifiedDiff } from "../../io/patch.js";
|
|
28
|
+
import { EX_NOINPUT, HarnessExitError } from "../exit-codes.js";
|
|
29
|
+
export const GENERATED_DIRNAME = "harness.generated";
|
|
30
|
+
function defaultHome(opts) {
|
|
31
|
+
return opts.homeDir ?? path.join(os.homedir(), ".claude");
|
|
32
|
+
}
|
|
33
|
+
function resolveManifestPath(opts) {
|
|
34
|
+
if (opts.configPath)
|
|
35
|
+
return path.resolve(opts.configPath);
|
|
36
|
+
return path.join(defaultHome(opts), "harness.yaml");
|
|
37
|
+
}
|
|
38
|
+
function resolveGeneratedDir(opts, manifestPath) {
|
|
39
|
+
if (opts.homeDir !== undefined)
|
|
40
|
+
return path.join(opts.homeDir, GENERATED_DIRNAME);
|
|
41
|
+
return path.join(path.dirname(manifestPath), GENERATED_DIRNAME);
|
|
42
|
+
}
|
|
43
|
+
function sha256OfBuffer(buf) {
|
|
44
|
+
return crypto.createHash("sha256").update(buf).digest("hex");
|
|
45
|
+
}
|
|
46
|
+
function readOnDisk(filePath) {
|
|
47
|
+
try {
|
|
48
|
+
return fs.readFileSync(filePath, "utf8");
|
|
49
|
+
}
|
|
50
|
+
catch {
|
|
51
|
+
return null;
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
function diffGeneratedFiles(lastApply, generatedDir) {
|
|
55
|
+
const out = [];
|
|
56
|
+
for (const basename of Object.keys(lastApply.files).sort()) {
|
|
57
|
+
const recorded = lastApply.files[basename];
|
|
58
|
+
if (recorded === undefined)
|
|
59
|
+
continue;
|
|
60
|
+
const onDisk = readOnDisk(path.join(generatedDir, basename));
|
|
61
|
+
if (onDisk === recorded.content)
|
|
62
|
+
continue;
|
|
63
|
+
out.push({
|
|
64
|
+
basename,
|
|
65
|
+
diff: unifiedDiff({
|
|
66
|
+
fileName: basename,
|
|
67
|
+
oldText: recorded.content,
|
|
68
|
+
newText: onDisk ?? "",
|
|
69
|
+
oldHeader: "last-apply",
|
|
70
|
+
newHeader: "on-disk",
|
|
71
|
+
}),
|
|
72
|
+
});
|
|
73
|
+
}
|
|
74
|
+
return out;
|
|
75
|
+
}
|
|
76
|
+
function diffAssets(lockEntries) {
|
|
77
|
+
const out = [];
|
|
78
|
+
for (const e of lockEntries) {
|
|
79
|
+
if (e.kind !== "asset")
|
|
80
|
+
continue;
|
|
81
|
+
let buf;
|
|
82
|
+
try {
|
|
83
|
+
buf = fs.readFileSync(e.path);
|
|
84
|
+
}
|
|
85
|
+
catch {
|
|
86
|
+
out.push({ path: e.path, reason: "missing", expectedSha: e.sha256 });
|
|
87
|
+
continue;
|
|
88
|
+
}
|
|
89
|
+
const currentSha = sha256OfBuffer(buf);
|
|
90
|
+
if (currentSha !== e.sha256) {
|
|
91
|
+
out.push({
|
|
92
|
+
path: e.path,
|
|
93
|
+
reason: "modified",
|
|
94
|
+
expectedSha: e.sha256,
|
|
95
|
+
currentSha,
|
|
96
|
+
});
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
return out;
|
|
100
|
+
}
|
|
101
|
+
function diffMemoryDirs(lockEntries, lastApply, memoryDetail, warnings) {
|
|
102
|
+
const out = [];
|
|
103
|
+
for (const e of lockEntries) {
|
|
104
|
+
if (e.kind !== "memory-dir")
|
|
105
|
+
continue;
|
|
106
|
+
let stat = null;
|
|
107
|
+
try {
|
|
108
|
+
stat = fs.statSync(e.path);
|
|
109
|
+
}
|
|
110
|
+
catch {
|
|
111
|
+
out.push({ path: e.path, reason: "missing" });
|
|
112
|
+
continue;
|
|
113
|
+
}
|
|
114
|
+
if (!stat.isDirectory()) {
|
|
115
|
+
out.push({ path: e.path, reason: "missing" });
|
|
116
|
+
continue;
|
|
117
|
+
}
|
|
118
|
+
let current;
|
|
119
|
+
try {
|
|
120
|
+
current = computeMemoryDirEntry(e.path);
|
|
121
|
+
}
|
|
122
|
+
catch {
|
|
123
|
+
// Treat read failure as missing rather than crashing the whole
|
|
124
|
+
// diff. Matches the stat-failure branch above (TOCTOU-safe).
|
|
125
|
+
out.push({ path: e.path, reason: "missing" });
|
|
126
|
+
continue;
|
|
127
|
+
}
|
|
128
|
+
if (current.sha256 === e.sha256)
|
|
129
|
+
continue;
|
|
130
|
+
const entry = { path: e.path, reason: "modified" };
|
|
131
|
+
if (memoryDetail) {
|
|
132
|
+
const snapshot = lastApply?.memoryDirs?.[e.path];
|
|
133
|
+
if (snapshot === undefined) {
|
|
134
|
+
// .last-apply was written before Phase 3 #5's schema extension.
|
|
135
|
+
// Without a per-file index, --memory-detail can't say what changed
|
|
136
|
+
// without reporting every file as "added". Skip the per-file
|
|
137
|
+
// expansion and tell the user how to enable it.
|
|
138
|
+
warnings.push(`${e.path}: no per-file index recorded (pre-Phase-3-#5 .last-apply); re-run \`harness apply\` to enable --memory-detail`);
|
|
139
|
+
}
|
|
140
|
+
else {
|
|
141
|
+
entry.files = expandMemoryDetail(e.path, snapshot);
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
out.push(entry);
|
|
145
|
+
}
|
|
146
|
+
return out;
|
|
147
|
+
}
|
|
148
|
+
function expandMemoryDetail(dirPath, snapshot) {
|
|
149
|
+
const previous = snapshot?.fileHashes ?? {};
|
|
150
|
+
const current = {};
|
|
151
|
+
let dirents;
|
|
152
|
+
try {
|
|
153
|
+
dirents = fs.readdirSync(dirPath, { withFileTypes: true });
|
|
154
|
+
}
|
|
155
|
+
catch {
|
|
156
|
+
return [];
|
|
157
|
+
}
|
|
158
|
+
for (const d of dirents) {
|
|
159
|
+
if (!d.isFile() || !d.name.endsWith(".md"))
|
|
160
|
+
continue;
|
|
161
|
+
current[d.name] = sha256OfBuffer(fs.readFileSync(path.join(dirPath, d.name)));
|
|
162
|
+
}
|
|
163
|
+
const allNames = new Set([...Object.keys(previous), ...Object.keys(current)]);
|
|
164
|
+
const changes = [];
|
|
165
|
+
for (const name of [...allNames].sort()) {
|
|
166
|
+
const prevSha = previous[name];
|
|
167
|
+
const curSha = current[name];
|
|
168
|
+
if (prevSha === undefined && curSha !== undefined) {
|
|
169
|
+
changes.push({ kind: "added", basename: name, sha256: curSha });
|
|
170
|
+
}
|
|
171
|
+
else if (prevSha !== undefined && curSha === undefined) {
|
|
172
|
+
changes.push({ kind: "removed", basename: name, previousSha256: prevSha });
|
|
173
|
+
}
|
|
174
|
+
else if (prevSha !== undefined && curSha !== undefined && prevSha !== curSha) {
|
|
175
|
+
changes.push({
|
|
176
|
+
kind: "modified",
|
|
177
|
+
basename: name,
|
|
178
|
+
previousSha256: prevSha,
|
|
179
|
+
sha256: curSha,
|
|
180
|
+
});
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
return changes;
|
|
184
|
+
}
|
|
185
|
+
function formatReport(result) {
|
|
186
|
+
const lines = [];
|
|
187
|
+
lines.push("# Generated files");
|
|
188
|
+
if (result.files.length === 0) {
|
|
189
|
+
lines.push(" no drift");
|
|
190
|
+
}
|
|
191
|
+
else {
|
|
192
|
+
for (const f of result.files) {
|
|
193
|
+
lines.push(f.diff.trimEnd());
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
lines.push("");
|
|
197
|
+
lines.push("# Asset drift");
|
|
198
|
+
if (result.assets.length === 0) {
|
|
199
|
+
lines.push(" no drift");
|
|
200
|
+
}
|
|
201
|
+
else {
|
|
202
|
+
for (const a of result.assets) {
|
|
203
|
+
if (a.reason === "missing") {
|
|
204
|
+
lines.push(` missing: ${a.path}`);
|
|
205
|
+
}
|
|
206
|
+
else {
|
|
207
|
+
lines.push(` modified: ${a.path}`);
|
|
208
|
+
lines.push(` expected sha256: ${a.expectedSha}`);
|
|
209
|
+
lines.push(` current sha256: ${a.currentSha}`);
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
lines.push("");
|
|
214
|
+
lines.push("# Memory directories");
|
|
215
|
+
if (result.memories.length === 0) {
|
|
216
|
+
lines.push(" no drift");
|
|
217
|
+
}
|
|
218
|
+
else {
|
|
219
|
+
for (const m of result.memories) {
|
|
220
|
+
if (m.reason === "missing") {
|
|
221
|
+
lines.push(` missing: ${m.path}`);
|
|
222
|
+
continue;
|
|
223
|
+
}
|
|
224
|
+
lines.push(` modified: ${m.path}`);
|
|
225
|
+
if (m.files && m.files.length > 0) {
|
|
226
|
+
for (const ch of m.files) {
|
|
227
|
+
lines.push(` ${ch.kind}: ${ch.basename}`);
|
|
228
|
+
}
|
|
229
|
+
}
|
|
230
|
+
}
|
|
231
|
+
}
|
|
232
|
+
return `${lines.join("\n")}\n`;
|
|
233
|
+
}
|
|
234
|
+
export function diffSinceApply(opts = {}) {
|
|
235
|
+
const manifestPath = resolveManifestPath(opts);
|
|
236
|
+
const generatedDir = resolveGeneratedDir(opts, manifestPath);
|
|
237
|
+
const lockPath = path.join(path.dirname(manifestPath), LOCK_BASENAME);
|
|
238
|
+
const lastApply = readLastApply(generatedDir);
|
|
239
|
+
if (lastApply === null) {
|
|
240
|
+
throw new HarnessExitError(`no \`.last-apply\` found at ${path.join(generatedDir, LAST_APPLY_BASENAME)}; run \`harness apply\` first`, EX_NOINPUT);
|
|
241
|
+
}
|
|
242
|
+
const lockEntries = readLock(lockPath) ?? [];
|
|
243
|
+
const warnings = [];
|
|
244
|
+
const files = diffGeneratedFiles(lastApply, generatedDir);
|
|
245
|
+
const assets = diffAssets(lockEntries);
|
|
246
|
+
const memories = diffMemoryDirs(lockEntries, lastApply, opts.memoryDetail ?? false, warnings);
|
|
247
|
+
const summary = { files, assets, memories };
|
|
248
|
+
const hasDrift = files.length > 0 || assets.length > 0 || memories.length > 0;
|
|
249
|
+
const output = formatReport(summary);
|
|
250
|
+
return { ...summary, warnings, hasDrift, output, json: summary };
|
|
251
|
+
}
|
|
252
|
+
// Re-exported so Phase 3 #6 (asset-drift detection inside `apply`) can
|
|
253
|
+
// reuse the pure projection without depending on the CLI side.
|
|
254
|
+
export { diffAssets };
|
|
255
|
+
//# sourceMappingURL=since-apply.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"since-apply.js","sourceRoot":"","sources":["../../../src/cli/diff/since-apply.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
const VERSION = "0.4.0";
|
|
2
|
+
function mcpLine(r, shallow) {
|
|
3
|
+
switch (r.outcome.kind) {
|
|
4
|
+
case "healthy":
|
|
5
|
+
return shallow
|
|
6
|
+
? ` ~ ${r.name} manifest-only (probe skipped)`
|
|
7
|
+
: ` ✓ ${r.name} healthy in ${r.outcome.latencyMs}ms`;
|
|
8
|
+
case "error":
|
|
9
|
+
return ` ✗ ${r.name} FAILED: ${r.outcome.message}`;
|
|
10
|
+
case "missing-verb":
|
|
11
|
+
return ` ? ${r.name} unknown — no health verb declared`;
|
|
12
|
+
case "disabled":
|
|
13
|
+
return ` ✓ ${r.name} disabled (skipped)`;
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
function describeStaleness(date) {
|
|
17
|
+
const iso = date.toISOString().slice(0, 10);
|
|
18
|
+
return `last touched ${iso}`;
|
|
19
|
+
}
|
|
20
|
+
function formatHeader(report) {
|
|
21
|
+
const project = report.project ? `, project: ${report.project}` : "";
|
|
22
|
+
const shallow = report.shallow ? " [shallow]" : "";
|
|
23
|
+
return `harness ${VERSION} — checking ${report.manifestPath} (version ${report.manifestVersion}${project})${shallow}`;
|
|
24
|
+
}
|
|
25
|
+
function formatManifestSection(report) {
|
|
26
|
+
const out = ["", "Manifest"];
|
|
27
|
+
out.push(` ${report.manifest.syntaxValid ? "✓" : "✗"} syntax valid`);
|
|
28
|
+
out.push(` ${report.manifest.schemaValid ? "✓" : "✗"} schema valid (${report.manifest.topLevelKeysPresent} top-level keys, all required present)`);
|
|
29
|
+
for (const w of report.manifest.warnings) {
|
|
30
|
+
out.push(` ⚠ ${w}`);
|
|
31
|
+
}
|
|
32
|
+
return out;
|
|
33
|
+
}
|
|
34
|
+
function formatToolsSection(report) {
|
|
35
|
+
const out = ["", "Tools"];
|
|
36
|
+
out.push(` MCP servers (${report.tools.mcp.length} declared)`);
|
|
37
|
+
for (const m of report.tools.mcp)
|
|
38
|
+
out.push(mcpLine(m, report.shallow));
|
|
39
|
+
const cliCount = report.tools.cli.length;
|
|
40
|
+
out.push(` CLI tools (${cliCount} declared)`);
|
|
41
|
+
for (const c of report.tools.cli) {
|
|
42
|
+
const marker = c.status === "ok" ? "✓" : c.status === "warn" ? "⚠" : "✗";
|
|
43
|
+
out.push(` ${marker} ${c.name} ${c.message}`);
|
|
44
|
+
}
|
|
45
|
+
const skillsLine = report.tools.skillsEnabled.join(", ") || "(none)";
|
|
46
|
+
out.push(` Skills (${report.tools.skillsEnabled.length} enabled${report.tools.skillsRequiredMissing.length === 0 ? ", all required by manifest" : `, ${report.tools.skillsRequiredMissing.length} required missing`})`);
|
|
47
|
+
if (report.tools.skillsRequiredMissing.length === 0) {
|
|
48
|
+
out.push(` ✓ ${skillsLine}`);
|
|
49
|
+
}
|
|
50
|
+
else {
|
|
51
|
+
out.push(` ✗ missing: ${report.tools.skillsRequiredMissing.join(", ")}`);
|
|
52
|
+
out.push(` enabled: ${skillsLine}`);
|
|
53
|
+
}
|
|
54
|
+
return out;
|
|
55
|
+
}
|
|
56
|
+
function formatMemorySection(report) {
|
|
57
|
+
const out = ["", "Memory"];
|
|
58
|
+
if (report.memory.routerExecutable) {
|
|
59
|
+
if (report.memory.routerExecutable.exists) {
|
|
60
|
+
out.push(` ✓ memory-router executable found (${report.memory.routerExecutable.path})`);
|
|
61
|
+
}
|
|
62
|
+
else {
|
|
63
|
+
out.push(` ✗ memory-router not found at ${report.memory.routerExecutable.path}`);
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
else {
|
|
67
|
+
out.push(` ⚠ no memory router declared`);
|
|
68
|
+
}
|
|
69
|
+
for (const d of report.memory.directories) {
|
|
70
|
+
if (!d.exists) {
|
|
71
|
+
out.push(` ⚠ memory directory missing: ${d.path}`);
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
if (report.memory.staleMemories.length > 0) {
|
|
75
|
+
out.push(` ⚠ ${report.memory.staleMemories.length} memories haven't been touched in > retention.staleness_days threshold`);
|
|
76
|
+
for (const m of report.memory.staleMemories) {
|
|
77
|
+
out.push(` ${m.path} (${describeStaleness(m.lastTouched)})`);
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
if (report.memory.routerExecutable?.exists &&
|
|
81
|
+
report.memory.directories.every((d) => d.exists) &&
|
|
82
|
+
report.memory.staleMemories.length === 0) {
|
|
83
|
+
// OK section already rendered the router line; nothing else to add
|
|
84
|
+
}
|
|
85
|
+
return out;
|
|
86
|
+
}
|
|
87
|
+
function formatHooksSection(report) {
|
|
88
|
+
const out = ["", "Hooks"];
|
|
89
|
+
for (const h of report.hooks) {
|
|
90
|
+
const marker = h.status === "ok" ? "✓" : h.status === "warn" ? "⚠" : "✗";
|
|
91
|
+
const tail = h.message ? ` ${h.message}` : "";
|
|
92
|
+
out.push(` ${marker} ${h.name} ${h.event}, blocking: ${h.blocking}${tail}`);
|
|
93
|
+
}
|
|
94
|
+
if (report.hooks.length === 0)
|
|
95
|
+
out.push(` (no hooks declared)`);
|
|
96
|
+
return out;
|
|
97
|
+
}
|
|
98
|
+
function formatPoliciesSection(report) {
|
|
99
|
+
const out = ["", "Policies"];
|
|
100
|
+
for (const p of report.policies) {
|
|
101
|
+
out.push(` ✓ ${p.name} ${p.caveat}`);
|
|
102
|
+
}
|
|
103
|
+
if (report.policies.length === 0)
|
|
104
|
+
out.push(` (no policies declared)`);
|
|
105
|
+
return out;
|
|
106
|
+
}
|
|
107
|
+
function formatSummary(report) {
|
|
108
|
+
const out = ["", "Summary"];
|
|
109
|
+
const errLabel = report.errorCount === 1 ? "error" : "errors";
|
|
110
|
+
const warnLabel = report.warningCount === 1 ? "warning" : "warnings";
|
|
111
|
+
out.push(` ${report.errorCount} ${errLabel}`);
|
|
112
|
+
out.push(` ${report.warningCount} ${warnLabel}`);
|
|
113
|
+
return out;
|
|
114
|
+
}
|
|
115
|
+
export function format(report) {
|
|
116
|
+
const lines = [formatHeader(report)];
|
|
117
|
+
lines.push(...formatManifestSection(report));
|
|
118
|
+
lines.push(...formatToolsSection(report));
|
|
119
|
+
lines.push(...formatMemorySection(report));
|
|
120
|
+
lines.push(...formatHooksSection(report));
|
|
121
|
+
lines.push(...formatPoliciesSection(report));
|
|
122
|
+
lines.push(...formatSummary(report));
|
|
123
|
+
lines.push("");
|
|
124
|
+
return lines.join("\n");
|
|
125
|
+
}
|
|
126
|
+
//# sourceMappingURL=format.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/cli/doctor/format.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { type McpProbe } from "../../probes/mcp.js";
|
|
2
|
+
import { type LoaderOptions } from "../loader.js";
|
|
3
|
+
import type { DoctorReport } from "./types.js";
|
|
4
|
+
export interface DoctorOptions extends LoaderOptions {
|
|
5
|
+
shallow?: boolean;
|
|
6
|
+
mcpProbe?: McpProbe;
|
|
7
|
+
pathEnv?: string;
|
|
8
|
+
versionProbe?: (cmd: string[]) => string | null;
|
|
9
|
+
now?: Date;
|
|
10
|
+
homeOverride?: string;
|
|
11
|
+
}
|
|
12
|
+
export declare function doctor(opts?: DoctorOptions): Promise<DoctorReport>;
|
|
13
|
+
export { format } from "./format.js";
|
|
14
|
+
export type * from "./types.js";
|