@aryam/fixmap 0.9.0 → 0.9.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/README.md +109 -9
- package/dist/agent-setup.d.ts +6 -97
- package/dist/agent-setup.js +20 -6
- package/dist/agent-setup.js.map +1 -1
- package/dist/analysis-source.d.ts +1 -0
- package/dist/analysis-source.js +6 -2
- package/dist/analysis-source.js.map +1 -1
- package/dist/annotation-command.d.ts +8 -0
- package/dist/annotation-command.js +187 -0
- package/dist/annotation-command.js.map +1 -0
- package/dist/annotation-tool.d.ts +62 -0
- package/dist/annotation-tool.js +64 -0
- package/dist/annotation-tool.js.map +1 -0
- package/dist/ask-command.d.ts +9 -0
- package/dist/ask-command.js +127 -0
- package/dist/ask-command.js.map +1 -0
- package/dist/capability-command.d.ts +11 -0
- package/dist/capability-command.js +540 -0
- package/dist/capability-command.js.map +1 -0
- package/dist/change-scope-command.d.ts +7 -0
- package/dist/change-scope-command.js +162 -0
- package/dist/change-scope-command.js.map +1 -0
- package/dist/cli-runner.d.ts +2 -1
- package/dist/cli-runner.js +165 -47
- package/dist/cli-runner.js.map +1 -1
- package/dist/cli.js +26 -1
- package/dist/cli.js.map +1 -1
- package/dist/decode-input.d.ts +4 -0
- package/dist/decode-input.js +44 -0
- package/dist/decode-input.js.map +1 -0
- package/dist/doctor.d.ts +1 -0
- package/dist/doctor.js +14 -1
- package/dist/doctor.js.map +1 -1
- package/dist/editor-command.d.ts +8 -0
- package/dist/editor-command.js +46 -0
- package/dist/editor-command.js.map +1 -0
- package/dist/history-command.d.ts +14 -0
- package/dist/history-command.js +145 -0
- package/dist/history-command.js.map +1 -0
- package/dist/mcp.d.ts +20 -0
- package/dist/mcp.js +599 -11
- package/dist/mcp.js.map +1 -1
- package/dist/migration-command.d.ts +15 -0
- package/dist/migration-command.js +142 -0
- package/dist/migration-command.js.map +1 -0
- package/dist/repository-source.d.ts +1 -0
- package/dist/repository-source.js +7 -3
- package/dist/repository-source.js.map +1 -1
- package/dist/reverse-docs-command.d.ts +16 -0
- package/dist/reverse-docs-command.js +114 -0
- package/dist/reverse-docs-command.js.map +1 -0
- package/dist/runtime-command.d.ts +15 -0
- package/dist/runtime-command.js +121 -0
- package/dist/runtime-command.js.map +1 -0
- package/dist/sandbox-command.d.ts +9 -0
- package/dist/sandbox-command.js +158 -0
- package/dist/sandbox-command.js.map +1 -0
- package/dist/supply-chain-command.d.ts +20 -0
- package/dist/supply-chain-command.js +131 -0
- package/dist/supply-chain-command.js.map +1 -0
- package/dist/watch-command.js +7 -5
- package/dist/watch-command.js.map +1 -1
- package/dist/watch.d.ts +1 -0
- package/dist/watch.js +46 -2
- package/dist/watch.js.map +1 -1
- package/dist/workspace-command.d.ts +13 -0
- package/dist/workspace-command.js +267 -0
- package/dist/workspace-command.js.map +1 -0
- package/package.json +4 -4
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
import { writeFile } from "node:fs/promises";
|
|
2
|
+
import { homedir } from "node:os";
|
|
3
|
+
import { resolve } from "node:path";
|
|
4
|
+
import { draftReverseDocumentation } from "@aryam/fixmap-core";
|
|
5
|
+
import { describeInputReadError, readDecodedTextFile } from "./decode-input.js";
|
|
6
|
+
export const REVERSE_DOCS_USAGE = `Usage: fixmap reverse-docs --input <reverse-docs.json> [--format markdown|json] [--output <file>]
|
|
7
|
+
|
|
8
|
+
Builds deterministic, review-only documentation drafts from exact file fingerprints, one architecture snapshot, authored decisions, and explicit targets. FixMap never writes a requested destination or overwrites repository documentation.
|
|
9
|
+
`;
|
|
10
|
+
export async function runReverseDocsCommand(args, dependencies = {}) {
|
|
11
|
+
const stdout = dependencies.stdout ?? ((text) => process.stdout.write(text));
|
|
12
|
+
const stderr = dependencies.stderr ?? ((text) => process.stderr.write(text));
|
|
13
|
+
if (args[0] === "--help" || args[0] === "-h") {
|
|
14
|
+
stdout(REVERSE_DOCS_USAGE);
|
|
15
|
+
return 0;
|
|
16
|
+
}
|
|
17
|
+
const parsed = parseArgs(args);
|
|
18
|
+
if (!parsed.ok) {
|
|
19
|
+
stderr(`${parsed.message}\n\n${REVERSE_DOCS_USAGE}`);
|
|
20
|
+
return 1;
|
|
21
|
+
}
|
|
22
|
+
if (parsed.output && samePath(resolve(parsed.output), resolve(parsed.input))) {
|
|
23
|
+
stderr("Reverse-docs --output must not overwrite the input file.\n");
|
|
24
|
+
return 1;
|
|
25
|
+
}
|
|
26
|
+
try {
|
|
27
|
+
const input = parseReverseDocsInput(JSON.parse(readDecodedTextFile(parsed.input)));
|
|
28
|
+
const drafts = draftReverseDocumentation(input.repo, input.architecture, input.decisions, input.targets);
|
|
29
|
+
const rendered = parsed.format === "json" ? `${JSON.stringify(drafts, null, 2)}\n` : renderReverseDocsMarkdown(drafts);
|
|
30
|
+
if (parsed.output) {
|
|
31
|
+
await (dependencies.writeOutput ?? ((path, contents) => writeFile(path, contents, "utf8")))(parsed.output, rendered);
|
|
32
|
+
}
|
|
33
|
+
else {
|
|
34
|
+
stdout(rendered);
|
|
35
|
+
}
|
|
36
|
+
return 0;
|
|
37
|
+
}
|
|
38
|
+
catch (error) {
|
|
39
|
+
stderr(`Could not build reverse-documentation drafts from "${parsed.input}": ${describeInputReadError(parsed.input, error)}\n`);
|
|
40
|
+
return 1;
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
export function parseReverseDocsInput(value) {
|
|
44
|
+
if (!isRecord(value) || value.reverseDocumentationInputVersion !== 1) {
|
|
45
|
+
throw new Error("Reverse-documentation input reverseDocumentationInputVersion must be 1.");
|
|
46
|
+
}
|
|
47
|
+
if (!isRecord(value.repo) || !isRecord(value.architecture) || !Array.isArray(value.decisions) || !Array.isArray(value.targets)) {
|
|
48
|
+
throw new Error("Reverse-documentation input requires repo, architecture, decisions, and targets.");
|
|
49
|
+
}
|
|
50
|
+
return {
|
|
51
|
+
reverseDocumentationInputVersion: 1,
|
|
52
|
+
repo: value.repo,
|
|
53
|
+
architecture: value.architecture,
|
|
54
|
+
decisions: value.decisions,
|
|
55
|
+
targets: value.targets
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
export function renderReverseDocsMarkdown(drafts) {
|
|
59
|
+
return drafts.map((draft) => [
|
|
60
|
+
`Requested destination: \`${draft.destination.requestedPath.replaceAll("`", "'")}\` (${draft.destination.status}).`,
|
|
61
|
+
"",
|
|
62
|
+
draft.markdown.trimEnd()
|
|
63
|
+
].join("\n")).join("\n\n---\n\n") + "\n";
|
|
64
|
+
}
|
|
65
|
+
function parseArgs(args) {
|
|
66
|
+
let input;
|
|
67
|
+
let format = "markdown";
|
|
68
|
+
let output;
|
|
69
|
+
const seen = new Set();
|
|
70
|
+
for (let index = 0; index < args.length; index += 1) {
|
|
71
|
+
const raw = args[index];
|
|
72
|
+
const separator = raw.indexOf("=");
|
|
73
|
+
const flag = separator === -1 ? raw : raw.slice(0, separator);
|
|
74
|
+
const inline = separator === -1 ? undefined : raw.slice(separator + 1);
|
|
75
|
+
if (!["--input", "--format", "--output"].includes(flag))
|
|
76
|
+
return { ok: false, message: `Unknown reverse-docs option: ${raw}` };
|
|
77
|
+
if (seen.has(flag))
|
|
78
|
+
return { ok: false, message: `Pass ${flag} only once.` };
|
|
79
|
+
seen.add(flag);
|
|
80
|
+
const following = args[index + 1];
|
|
81
|
+
const value = inline ?? (following && !following.startsWith("--") ? following : undefined);
|
|
82
|
+
if (inline === undefined && value !== undefined)
|
|
83
|
+
index += 1;
|
|
84
|
+
if (!value?.trim())
|
|
85
|
+
return { ok: false, message: `${flag} requires a value.` };
|
|
86
|
+
if (flag === "--input")
|
|
87
|
+
input = expandHomePath(value.trim());
|
|
88
|
+
else if (flag === "--output")
|
|
89
|
+
output = expandHomePath(value.trim());
|
|
90
|
+
else {
|
|
91
|
+
const normalized = value.trim().toLowerCase();
|
|
92
|
+
if (normalized !== "markdown" && normalized !== "json")
|
|
93
|
+
return { ok: false, message: "--format must be markdown or json." };
|
|
94
|
+
format = normalized;
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
if (!input)
|
|
98
|
+
return { ok: false, message: "reverse-docs requires --input <reverse-docs.json>." };
|
|
99
|
+
return { ok: true, input, format, ...(output ? { output } : {}) };
|
|
100
|
+
}
|
|
101
|
+
function samePath(left, right) {
|
|
102
|
+
return process.platform === "win32" ? left.toLowerCase() === right.toLowerCase() : left === right;
|
|
103
|
+
}
|
|
104
|
+
function isRecord(value) {
|
|
105
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
106
|
+
}
|
|
107
|
+
function expandHomePath(value) {
|
|
108
|
+
if (value === "~")
|
|
109
|
+
return homedir();
|
|
110
|
+
if (value.startsWith("~/") || value.startsWith("~\\"))
|
|
111
|
+
return resolve(homedir(), value.slice(2));
|
|
112
|
+
return value;
|
|
113
|
+
}
|
|
114
|
+
//# sourceMappingURL=reverse-docs-command.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"reverse-docs-command.js","sourceRoot":"","sources":["../src/reverse-docs-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,yBAAyB,EAM1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEhF,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;CAGjC,CAAC;AAUF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,IAAc,EACd,eAII,EAAE;IAEN,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACrF,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACrF,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7C,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAC3B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,OAAO,kBAAkB,EAAE,CAAC,CAAC;QACrD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAC7E,MAAM,CAAC,4DAA4D,CAAC,CAAC;QACrE,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAY,CAAC,CAAC;QAC9F,MAAM,MAAM,GAAG,yBAAyB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACzG,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC;QACvH,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,CAAC,YAAY,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACvH,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnB,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,sDAAsD,MAAM,CAAC,KAAK,MAAM,sBAAsB,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAChI,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,gCAAgC,KAAK,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC7F,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/H,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;IACtG,CAAC;IACD,OAAO;QACL,gCAAgC,EAAE,CAAC;QACnC,IAAI,EAAE,KAAK,CAAC,IAAyC;QACrD,YAAY,EAAE,KAAK,CAAC,YAA+C;QACnE,SAAS,EAAE,KAAK,CAAC,SAA6B;QAC9C,OAAO,EAAE,KAAK,CAAC,OAAuC;KACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAA4C;IACpF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;QAC3B,4BAA4B,KAAK,CAAC,WAAW,CAAC,aAAa,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,KAAK,CAAC,WAAW,CAAC,MAAM,IAAI;QACnH,EAAE;QACF,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE;KACzB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;AAC3C,CAAC;AAID,SAAS,SAAS,CAAC,IAAc;IAC/B,IAAI,KAAyB,CAAC;IAC9B,IAAI,MAAM,GAAwB,UAAU,CAAC;IAC7C,IAAI,MAA0B,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAE,CAAC;QACzB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QACvE,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,gCAAgC,GAAG,EAAE,EAAE,CAAC;QAC9H,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,IAAI,aAAa,EAAE,CAAC;QAC7E,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC3F,IAAI,MAAM,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;YAAE,KAAK,IAAI,CAAC,CAAC;QAC5D,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC/E,IAAI,IAAI,KAAK,SAAS;YAAE,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;aACxD,IAAI,IAAI,KAAK,UAAU;YAAE,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;aAC/D,CAAC;YACJ,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC9C,IAAI,UAAU,KAAK,UAAU,IAAI,UAAU,KAAK,MAAM;gBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;YAC5H,MAAM,GAAG,UAAU,CAAC;QACtB,CAAC;IACH,CAAC;IACD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC;IAChG,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACpE,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,KAAa;IAC3C,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC;AACpG,CAAC;AACD,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AACD,SAAS,cAAc,CAAC,KAAa;IACnC,IAAI,KAAK,KAAK,GAAG;QAAE,OAAO,OAAO,EAAE,CAAC;IACpC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjG,OAAO,KAAK,CAAC;AACf,CAAC"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { type MappedRuntimeEvidence, type RuntimeRepositorySnapshot } from "@aryam/fixmap-core";
|
|
2
|
+
export declare const RUNTIME_USAGE = "Usage: fixmap runtime --input <runtime.json> [--format markdown|json] [--output <file>]\n\nMaps a redaction-reviewed OpenTelemetry, normalized APM, Speedscope, or pprof bundle to caller-supplied exact repository file fingerprints. Labels and symbols alone never establish identity or causality.\n";
|
|
3
|
+
type RuntimeInput = {
|
|
4
|
+
runtimeInputVersion: 1;
|
|
5
|
+
bundle: unknown;
|
|
6
|
+
snapshots: RuntimeRepositorySnapshot[];
|
|
7
|
+
};
|
|
8
|
+
export declare function runRuntimeCommand(args: string[], dependencies?: {
|
|
9
|
+
stdout?: (text: string) => void;
|
|
10
|
+
stderr?: (text: string) => void;
|
|
11
|
+
writeOutput?: (path: string, contents: string) => Promise<void>;
|
|
12
|
+
}): Promise<number>;
|
|
13
|
+
export declare function parseRuntimeInput(value: unknown): RuntimeInput;
|
|
14
|
+
export declare function renderRuntimeMarkdown(mapped: MappedRuntimeEvidence): string;
|
|
15
|
+
export {};
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
import { writeFile } from "node:fs/promises";
|
|
2
|
+
import { homedir } from "node:os";
|
|
3
|
+
import { resolve } from "node:path";
|
|
4
|
+
import { mapRuntimeEvidence } from "@aryam/fixmap-core";
|
|
5
|
+
import { describeInputReadError, readDecodedTextFile } from "./decode-input.js";
|
|
6
|
+
export const RUNTIME_USAGE = `Usage: fixmap runtime --input <runtime.json> [--format markdown|json] [--output <file>]
|
|
7
|
+
|
|
8
|
+
Maps a redaction-reviewed OpenTelemetry, normalized APM, Speedscope, or pprof bundle to caller-supplied exact repository file fingerprints. Labels and symbols alone never establish identity or causality.
|
|
9
|
+
`;
|
|
10
|
+
export async function runRuntimeCommand(args, dependencies = {}) {
|
|
11
|
+
const stdout = dependencies.stdout ?? ((text) => process.stdout.write(text));
|
|
12
|
+
const stderr = dependencies.stderr ?? ((text) => process.stderr.write(text));
|
|
13
|
+
if (args[0] === "--help" || args[0] === "-h") {
|
|
14
|
+
stdout(RUNTIME_USAGE);
|
|
15
|
+
return 0;
|
|
16
|
+
}
|
|
17
|
+
const parsed = parseArgs(args);
|
|
18
|
+
if (!parsed.ok) {
|
|
19
|
+
stderr(`${parsed.message}\n\n${RUNTIME_USAGE}`);
|
|
20
|
+
return 1;
|
|
21
|
+
}
|
|
22
|
+
if (parsed.output && samePath(resolve(parsed.output), resolve(parsed.input))) {
|
|
23
|
+
stderr("Runtime --output must not overwrite the input file.\n");
|
|
24
|
+
return 1;
|
|
25
|
+
}
|
|
26
|
+
try {
|
|
27
|
+
const input = parseRuntimeInput(JSON.parse(readDecodedTextFile(parsed.input)));
|
|
28
|
+
const mapped = mapRuntimeEvidence(input.bundle, input.snapshots);
|
|
29
|
+
const rendered = parsed.format === "json" ? `${JSON.stringify(mapped, null, 2)}\n` : renderRuntimeMarkdown(mapped);
|
|
30
|
+
if (parsed.output)
|
|
31
|
+
await (dependencies.writeOutput ?? ((path, contents) => writeFile(path, contents, "utf8")))(parsed.output, rendered);
|
|
32
|
+
else
|
|
33
|
+
stdout(rendered);
|
|
34
|
+
return 0;
|
|
35
|
+
}
|
|
36
|
+
catch (error) {
|
|
37
|
+
stderr(`Could not map runtime evidence from "${parsed.input}": ${describeInputReadError(parsed.input, error)}\n`);
|
|
38
|
+
return 1;
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
export function parseRuntimeInput(value) {
|
|
42
|
+
if (!isRecord(value) || value.runtimeInputVersion !== 1 || !isRecord(value.bundle) || !Array.isArray(value.snapshots)) {
|
|
43
|
+
throw new Error("Runtime input requires runtimeInputVersion 1, bundle, and snapshots.");
|
|
44
|
+
}
|
|
45
|
+
return { runtimeInputVersion: 1, bundle: value.bundle, snapshots: value.snapshots };
|
|
46
|
+
}
|
|
47
|
+
export function renderRuntimeMarkdown(mapped) {
|
|
48
|
+
return `${[
|
|
49
|
+
"# FixMap runtime evidence",
|
|
50
|
+
"",
|
|
51
|
+
`Source: \`${mapped.source.format}\` from \`${mapped.source.tool}\` \`${mapped.source.version}\` at \`${mapped.source.documentFingerprint}\``,
|
|
52
|
+
`Capture: ${mapped.source.capturedFrom} to ${mapped.source.capturedTo}`,
|
|
53
|
+
`Redaction review: ${mapped.source.redactionSummary}`,
|
|
54
|
+
"",
|
|
55
|
+
"## Mapped observations",
|
|
56
|
+
"",
|
|
57
|
+
...(mapped.observations.length > 0 ? mapped.observations.map((observation) => {
|
|
58
|
+
const location = `\`${observation.subject.repositoryId}:${observation.subject.path}\` at \`${observation.subject.contentFingerprint}\``;
|
|
59
|
+
const measurement = "durationMs" in observation.measurement
|
|
60
|
+
? `${observation.measurement.durationMs} ms span (${observation.measurement.status})`
|
|
61
|
+
: `${observation.measurement.selfSamples}/${observation.measurement.totalSamples} samples; ${(observation.measurement.sampleShare * 100).toFixed(2)}% self-sample share`;
|
|
62
|
+
return `- ${observation.kind} \`${observation.id}\` ${location}: ${measurement}; evidence \`${observation.evidenceReference}\``;
|
|
63
|
+
}) : ["- No records mapped to exact file fingerprints."]),
|
|
64
|
+
"",
|
|
65
|
+
"## Unresolved",
|
|
66
|
+
"",
|
|
67
|
+
...(mapped.unresolved.length > 0 ? mapped.unresolved.map((entry) => `- \`${entry.id}\`: ${entry.reason}${entry.repositoryId ? ` at \`${entry.repositoryId}:${entry.path ?? ""}\`` : ""}`) : ["- None."]),
|
|
68
|
+
"",
|
|
69
|
+
"> Observations only. Span duration is not CPU time, profile samples are not wall-clock time, and correlation does not establish causality."
|
|
70
|
+
].join("\n")}\n`;
|
|
71
|
+
}
|
|
72
|
+
function parseArgs(args) {
|
|
73
|
+
let input;
|
|
74
|
+
let format = "markdown";
|
|
75
|
+
let output;
|
|
76
|
+
const seen = new Set();
|
|
77
|
+
for (let index = 0; index < args.length; index += 1) {
|
|
78
|
+
const raw = args[index];
|
|
79
|
+
const separator = raw.indexOf("=");
|
|
80
|
+
const flag = separator === -1 ? raw : raw.slice(0, separator);
|
|
81
|
+
const inline = separator === -1 ? undefined : raw.slice(separator + 1);
|
|
82
|
+
if (!["--input", "--format", "--output"].includes(flag))
|
|
83
|
+
return { ok: false, message: `Unknown runtime option: ${raw}` };
|
|
84
|
+
if (seen.has(flag))
|
|
85
|
+
return { ok: false, message: `Pass ${flag} only once.` };
|
|
86
|
+
seen.add(flag);
|
|
87
|
+
const following = args[index + 1];
|
|
88
|
+
const value = inline ?? (following && !following.startsWith("--") ? following : undefined);
|
|
89
|
+
if (inline === undefined && value !== undefined)
|
|
90
|
+
index += 1;
|
|
91
|
+
if (!value?.trim())
|
|
92
|
+
return { ok: false, message: `${flag} requires a value.` };
|
|
93
|
+
if (flag === "--input")
|
|
94
|
+
input = expandHomePath(value.trim());
|
|
95
|
+
else if (flag === "--output")
|
|
96
|
+
output = expandHomePath(value.trim());
|
|
97
|
+
else {
|
|
98
|
+
const normalized = value.trim().toLowerCase();
|
|
99
|
+
if (normalized !== "markdown" && normalized !== "json")
|
|
100
|
+
return { ok: false, message: "--format must be markdown or json." };
|
|
101
|
+
format = normalized;
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
if (!input)
|
|
105
|
+
return { ok: false, message: "runtime requires --input <runtime.json>." };
|
|
106
|
+
return { ok: true, input, format, ...(output ? { output } : {}) };
|
|
107
|
+
}
|
|
108
|
+
function samePath(left, right) {
|
|
109
|
+
return process.platform === "win32" ? left.toLowerCase() === right.toLowerCase() : left === right;
|
|
110
|
+
}
|
|
111
|
+
function isRecord(value) {
|
|
112
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
113
|
+
}
|
|
114
|
+
function expandHomePath(value) {
|
|
115
|
+
if (value === "~")
|
|
116
|
+
return homedir();
|
|
117
|
+
if (value.startsWith("~/") || value.startsWith("~\\"))
|
|
118
|
+
return resolve(homedir(), value.slice(2));
|
|
119
|
+
return value;
|
|
120
|
+
}
|
|
121
|
+
//# sourceMappingURL=runtime-command.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"runtime-command.js","sourceRoot":"","sources":["../src/runtime-command.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { type SandboxRequest, type SandboxResult } from "@aryam/fixmap-core";
|
|
2
|
+
export declare const SANDBOX_USAGE = "Usage: fixmap sandbox --request <sandbox.json> --execute-declared-command [--allow-sandbox-network] [--format markdown|json] [--output <file>]\n\nRuns exactly one declared command in an already-present digest-pinned Docker image. Source and container root are read-only, network is off by default, and the request file cannot self-authorize execution. Network requires a separate command-line consent flag.\n";
|
|
3
|
+
export declare function runSandboxCommand(args: string[], dependencies?: {
|
|
4
|
+
stdout?: (text: string) => void;
|
|
5
|
+
stderr?: (text: string) => void;
|
|
6
|
+
writeOutput?: (path: string, contents: string) => Promise<void>;
|
|
7
|
+
execute?: (request: SandboxRequest) => Promise<SandboxResult>;
|
|
8
|
+
}): Promise<number>;
|
|
9
|
+
export declare function renderSandboxMarkdown(result: SandboxResult): string;
|
|
@@ -0,0 +1,158 @@
|
|
|
1
|
+
import { realpath, stat, writeFile } from "node:fs/promises";
|
|
2
|
+
import { homedir } from "node:os";
|
|
3
|
+
import { resolve } from "node:path";
|
|
4
|
+
import { runSandbox } from "@aryam/fixmap-core";
|
|
5
|
+
import { describeInputReadError, readDecodedTextFile } from "./decode-input.js";
|
|
6
|
+
export const SANDBOX_USAGE = `Usage: fixmap sandbox --request <sandbox.json> --execute-declared-command [--allow-sandbox-network] [--format markdown|json] [--output <file>]
|
|
7
|
+
|
|
8
|
+
Runs exactly one declared command in an already-present digest-pinned Docker image. Source and container root are read-only, network is off by default, and the request file cannot self-authorize execution. Network requires a separate command-line consent flag.
|
|
9
|
+
`;
|
|
10
|
+
export async function runSandboxCommand(args, dependencies = {}) {
|
|
11
|
+
const stdout = dependencies.stdout ?? ((text) => process.stdout.write(text));
|
|
12
|
+
const stderr = dependencies.stderr ?? ((text) => process.stderr.write(text));
|
|
13
|
+
if (args[0] === "--help" || args[0] === "-h") {
|
|
14
|
+
stdout(SANDBOX_USAGE);
|
|
15
|
+
return 0;
|
|
16
|
+
}
|
|
17
|
+
const parsed = parseArgs(args);
|
|
18
|
+
if (!parsed.ok) {
|
|
19
|
+
stderr(`${parsed.message}\n\n${SANDBOX_USAGE}`);
|
|
20
|
+
return 1;
|
|
21
|
+
}
|
|
22
|
+
if (parsed.output && samePath(resolve(parsed.output), resolve(parsed.request))) {
|
|
23
|
+
stderr("Sandbox --output must not overwrite the request file.\n");
|
|
24
|
+
return 1;
|
|
25
|
+
}
|
|
26
|
+
try {
|
|
27
|
+
const requestFile = parseRequestFile(JSON.parse(readDecodedTextFile(parsed.request)));
|
|
28
|
+
if (requestFile.network?.enabled === true && !parsed.allowNetwork) {
|
|
29
|
+
stderr("Sandbox network access requires the separate --allow-sandbox-network consent flag.\n");
|
|
30
|
+
return 1;
|
|
31
|
+
}
|
|
32
|
+
if (parsed.allowNetwork && requestFile.network?.enabled !== true) {
|
|
33
|
+
stderr("--allow-sandbox-network requires network.enabled true in the reviewed request file.\n");
|
|
34
|
+
return 1;
|
|
35
|
+
}
|
|
36
|
+
const requestedRoot = resolve(expandHomePath(requestFile.repoRoot));
|
|
37
|
+
if (!(await stat(requestedRoot)).isDirectory())
|
|
38
|
+
throw new Error("Sandbox repository does not exist or is not a directory.");
|
|
39
|
+
const repoRoot = await realpath(requestedRoot);
|
|
40
|
+
const request = {
|
|
41
|
+
executionId: requestFile.executionId,
|
|
42
|
+
repoRoot,
|
|
43
|
+
image: requestFile.image,
|
|
44
|
+
command: requestFile.command,
|
|
45
|
+
declaredCommands: requestFile.declaredCommands,
|
|
46
|
+
consent: "execute-declared-command",
|
|
47
|
+
...(requestFile.limits ? { limits: requestFile.limits } : {}),
|
|
48
|
+
...(requestFile.network?.enabled === true
|
|
49
|
+
? { network: { enabled: true, consent: "allow-sandbox-network" } }
|
|
50
|
+
: { network: { enabled: false } })
|
|
51
|
+
};
|
|
52
|
+
const result = await (dependencies.execute ?? runSandbox)(request);
|
|
53
|
+
const rendered = parsed.format === "json" ? `${JSON.stringify(result, null, 2)}\n` : renderSandboxMarkdown(result);
|
|
54
|
+
if (parsed.output)
|
|
55
|
+
await (dependencies.writeOutput ?? ((path, contents) => writeFile(path, contents, "utf8")))(parsed.output, rendered);
|
|
56
|
+
else
|
|
57
|
+
stdout(rendered);
|
|
58
|
+
return result.status === "passed" ? 0 : 1;
|
|
59
|
+
}
|
|
60
|
+
catch (error) {
|
|
61
|
+
stderr(`Could not run sandbox request from "${parsed.request}": ${describeInputReadError(parsed.request, error)}\n`);
|
|
62
|
+
return 1;
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
export function renderSandboxMarkdown(result) {
|
|
66
|
+
return `${[
|
|
67
|
+
"# FixMap sandbox result",
|
|
68
|
+
"",
|
|
69
|
+
`Execution: \`${result.executionId}\``,
|
|
70
|
+
`Status: **${result.status}**${result.exitCode === null ? "" : ` (exit ${result.exitCode})`}`,
|
|
71
|
+
`Image: \`${result.image}\``,
|
|
72
|
+
`Command: \`${result.command.replaceAll("`", "'")}\``,
|
|
73
|
+
`Policy: source read-only; root read-only; network ${result.policy.network}; pull ${result.policy.pull}; user ${result.policy.user}; capabilities ${result.policy.capabilitiesDropped}.`,
|
|
74
|
+
`Limits: ${result.limits.timeoutMs}ms, ${result.limits.cpus} CPU, ${result.limits.memoryMb}MB memory, ${result.limits.pids} PIDs, ${result.limits.outputBytes} output bytes.`,
|
|
75
|
+
"",
|
|
76
|
+
"## Standard output",
|
|
77
|
+
"",
|
|
78
|
+
"```text",
|
|
79
|
+
result.stdout,
|
|
80
|
+
"```",
|
|
81
|
+
"",
|
|
82
|
+
"## Standard error",
|
|
83
|
+
"",
|
|
84
|
+
"```text",
|
|
85
|
+
result.stderr,
|
|
86
|
+
"```",
|
|
87
|
+
...(result.outputTruncated ? ["", "> Output was truncated at the configured byte limit."] : [])
|
|
88
|
+
].join("\n")}\n`;
|
|
89
|
+
}
|
|
90
|
+
function parseRequestFile(value) {
|
|
91
|
+
if (!isRecord(value) || value.sandboxRequestVersion !== 1 || typeof value.executionId !== "string" || typeof value.repoRoot !== "string" ||
|
|
92
|
+
typeof value.image !== "string" || typeof value.command !== "string" || !Array.isArray(value.declaredCommands) ||
|
|
93
|
+
(value.network !== undefined && (!isRecord(value.network) || typeof value.network.enabled !== "boolean")) ||
|
|
94
|
+
(value.limits !== undefined && !isRecord(value.limits)) || "consent" in value) {
|
|
95
|
+
throw new Error("Invalid sandbox request file; consent must be supplied only on the command line.");
|
|
96
|
+
}
|
|
97
|
+
return value;
|
|
98
|
+
}
|
|
99
|
+
function parseArgs(args) {
|
|
100
|
+
let request;
|
|
101
|
+
let execute = false;
|
|
102
|
+
let allowNetwork = false;
|
|
103
|
+
let format = "markdown";
|
|
104
|
+
let output;
|
|
105
|
+
const seen = new Set();
|
|
106
|
+
for (let index = 0; index < args.length; index += 1) {
|
|
107
|
+
const raw = args[index];
|
|
108
|
+
if (raw === "--execute-declared-command" || raw === "--allow-sandbox-network") {
|
|
109
|
+
if (seen.has(raw))
|
|
110
|
+
return { ok: false, message: `Pass ${raw} only once.` };
|
|
111
|
+
seen.add(raw);
|
|
112
|
+
if (raw === "--execute-declared-command")
|
|
113
|
+
execute = true;
|
|
114
|
+
else
|
|
115
|
+
allowNetwork = true;
|
|
116
|
+
continue;
|
|
117
|
+
}
|
|
118
|
+
const separator = raw.indexOf("=");
|
|
119
|
+
const flag = separator === -1 ? raw : raw.slice(0, separator);
|
|
120
|
+
const inline = separator === -1 ? undefined : raw.slice(separator + 1);
|
|
121
|
+
if (!["--request", "--format", "--output"].includes(flag))
|
|
122
|
+
return { ok: false, message: `Unknown sandbox option: ${raw}` };
|
|
123
|
+
if (seen.has(flag))
|
|
124
|
+
return { ok: false, message: `Pass ${flag} only once.` };
|
|
125
|
+
seen.add(flag);
|
|
126
|
+
const following = args[index + 1];
|
|
127
|
+
const value = inline ?? (following && !following.startsWith("--") ? following : undefined);
|
|
128
|
+
if (inline === undefined && value !== undefined)
|
|
129
|
+
index += 1;
|
|
130
|
+
if (!value?.trim())
|
|
131
|
+
return { ok: false, message: `${flag} requires a value.` };
|
|
132
|
+
if (flag === "--request")
|
|
133
|
+
request = expandHomePath(value.trim());
|
|
134
|
+
else if (flag === "--output")
|
|
135
|
+
output = expandHomePath(value.trim());
|
|
136
|
+
else {
|
|
137
|
+
const normalized = value.trim().toLowerCase();
|
|
138
|
+
if (normalized !== "markdown" && normalized !== "json")
|
|
139
|
+
return { ok: false, message: "--format must be markdown or json." };
|
|
140
|
+
format = normalized;
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
if (!request)
|
|
144
|
+
return { ok: false, message: "sandbox requires --request <sandbox.json>." };
|
|
145
|
+
if (!execute)
|
|
146
|
+
return { ok: false, message: "Sandbox execution requires the explicit --execute-declared-command consent flag." };
|
|
147
|
+
return { ok: true, request, execute: true, allowNetwork, format, ...(output ? { output } : {}) };
|
|
148
|
+
}
|
|
149
|
+
function samePath(left, right) { return process.platform === "win32" ? left.toLowerCase() === right.toLowerCase() : left === right; }
|
|
150
|
+
function isRecord(value) { return typeof value === "object" && value !== null && !Array.isArray(value); }
|
|
151
|
+
function expandHomePath(value) {
|
|
152
|
+
if (value === "~")
|
|
153
|
+
return homedir();
|
|
154
|
+
if (value.startsWith("~/") || value.startsWith("~\\"))
|
|
155
|
+
return resolve(homedir(), value.slice(2));
|
|
156
|
+
return value;
|
|
157
|
+
}
|
|
158
|
+
//# sourceMappingURL=sandbox-command.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sandbox-command.js","sourceRoot":"","sources":["../src/sandbox-command.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { type SupplyChainEvidenceBundle } from "@aryam/fixmap-core";
|
|
2
|
+
export declare const SUPPLY_CHAIN_USAGE = "Usage: fixmap supply-chain --input <bundle.json> [--format markdown|json] [--output <file>]\n\nValidates a version-1 normalized external scanner/SBOM bundle and renders package-aware vulnerability, outdated-version, and license-policy evidence. FixMap does not fetch advisory data, maintain a CVE corpus, or execute a scanner.\n";
|
|
3
|
+
export type SupplyChainReport = Awaited<ReturnType<typeof buildSupplyChainReport>>;
|
|
4
|
+
export declare function buildSupplyChainReport(candidate: unknown): Promise<{
|
|
5
|
+
supplyChainReportVersion: 1;
|
|
6
|
+
bundle: SupplyChainEvidenceBundle;
|
|
7
|
+
evidence: import("@aryam/fixmap-core").CollectedEvidence;
|
|
8
|
+
claims: {
|
|
9
|
+
externalEvidenceOnly: true;
|
|
10
|
+
fixMapMaintainsVulnerabilityDatabase: false;
|
|
11
|
+
fixMapExecutedScanner: false;
|
|
12
|
+
remediationAuthorized: false;
|
|
13
|
+
};
|
|
14
|
+
}>;
|
|
15
|
+
export declare function runSupplyChainCommand(args: string[], dependencies?: {
|
|
16
|
+
stdout?: (text: string) => void;
|
|
17
|
+
stderr?: (text: string) => void;
|
|
18
|
+
writeOutput?: (path: string, contents: string) => Promise<void>;
|
|
19
|
+
}): Promise<number>;
|
|
20
|
+
export declare function renderSupplyChainMarkdown(report: SupplyChainReport): string;
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
import { writeFile } from "node:fs/promises";
|
|
2
|
+
import { homedir } from "node:os";
|
|
3
|
+
import { resolve } from "node:path";
|
|
4
|
+
import { collectEvidence, createSupplyChainEvidenceProvider, validateSupplyChainEvidenceBundle } from "@aryam/fixmap-core";
|
|
5
|
+
import { describeInputReadError, readDecodedTextFile } from "./decode-input.js";
|
|
6
|
+
export const SUPPLY_CHAIN_USAGE = `Usage: fixmap supply-chain --input <bundle.json> [--format markdown|json] [--output <file>]
|
|
7
|
+
|
|
8
|
+
Validates a version-1 normalized external scanner/SBOM bundle and renders package-aware vulnerability, outdated-version, and license-policy evidence. FixMap does not fetch advisory data, maintain a CVE corpus, or execute a scanner.
|
|
9
|
+
`;
|
|
10
|
+
export async function buildSupplyChainReport(candidate) {
|
|
11
|
+
const bundle = validateSupplyChainEvidenceBundle(candidate);
|
|
12
|
+
const evidence = await collectEvidence([createSupplyChainEvidenceProvider(bundle)], {
|
|
13
|
+
repo: { root: "", files: [], packageScripts: [], changedFiles: [], diffText: "", packageManager: "npm", diagnostics: [] },
|
|
14
|
+
issueText: "",
|
|
15
|
+
diffText: ""
|
|
16
|
+
}, { now: bundle.generatedAt });
|
|
17
|
+
return {
|
|
18
|
+
supplyChainReportVersion: 1,
|
|
19
|
+
bundle,
|
|
20
|
+
evidence,
|
|
21
|
+
claims: {
|
|
22
|
+
externalEvidenceOnly: true,
|
|
23
|
+
fixMapMaintainsVulnerabilityDatabase: false,
|
|
24
|
+
fixMapExecutedScanner: false,
|
|
25
|
+
remediationAuthorized: false
|
|
26
|
+
}
|
|
27
|
+
};
|
|
28
|
+
}
|
|
29
|
+
export async function runSupplyChainCommand(args, dependencies = {}) {
|
|
30
|
+
const stdout = dependencies.stdout ?? ((text) => process.stdout.write(text));
|
|
31
|
+
const stderr = dependencies.stderr ?? ((text) => process.stderr.write(text));
|
|
32
|
+
if (args[0] === "--help" || args[0] === "-h") {
|
|
33
|
+
stdout(SUPPLY_CHAIN_USAGE);
|
|
34
|
+
return 0;
|
|
35
|
+
}
|
|
36
|
+
const parsed = parseArgs(args);
|
|
37
|
+
if (!parsed.ok) {
|
|
38
|
+
stderr(`${parsed.message}\n\n${SUPPLY_CHAIN_USAGE}`);
|
|
39
|
+
return 1;
|
|
40
|
+
}
|
|
41
|
+
if (parsed.output && samePath(resolve(parsed.output), resolve(parsed.input))) {
|
|
42
|
+
stderr("Supply-chain --output must not overwrite the input file.\n");
|
|
43
|
+
return 1;
|
|
44
|
+
}
|
|
45
|
+
try {
|
|
46
|
+
const report = await buildSupplyChainReport(JSON.parse(readDecodedTextFile(parsed.input)));
|
|
47
|
+
const rendered = parsed.format === "json" ? `${JSON.stringify(report, null, 2)}\n` : renderSupplyChainMarkdown(report);
|
|
48
|
+
if (parsed.output)
|
|
49
|
+
await (dependencies.writeOutput ?? ((path, contents) => writeFile(path, contents, "utf8")))(parsed.output, rendered);
|
|
50
|
+
else
|
|
51
|
+
stdout(rendered);
|
|
52
|
+
return 0;
|
|
53
|
+
}
|
|
54
|
+
catch (error) {
|
|
55
|
+
stderr(`Could not import supply-chain evidence from "${parsed.input}": ${describeInputReadError(parsed.input, error)}\n`);
|
|
56
|
+
return 1;
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
export function renderSupplyChainMarkdown(report) {
|
|
60
|
+
const bundle = report.bundle;
|
|
61
|
+
const counts = ["critical", "high", "medium", "low", "info", "unknown"].map((severity) => ({
|
|
62
|
+
severity,
|
|
63
|
+
count: bundle.findings.filter((finding) => finding.severity === severity).length
|
|
64
|
+
})).filter((entry) => entry.count > 0);
|
|
65
|
+
return `${[
|
|
66
|
+
"# FixMap supply-chain evidence",
|
|
67
|
+
"",
|
|
68
|
+
`Source: \`${bundle.source.tool}\` \`${bundle.source.toolVersion}\` at \`${bundle.source.documentFingerprint}\``,
|
|
69
|
+
`Generated: ${bundle.generatedAt}`,
|
|
70
|
+
`Inventory: ${bundle.components.length} component${bundle.components.length === 1 ? "" : "s"}; ${bundle.findings.length} finding${bundle.findings.length === 1 ? "" : "s"}.`,
|
|
71
|
+
...(counts.length > 0 ? [`Severity counts: ${counts.map((entry) => `${entry.severity}=${entry.count}`).join(", ")}.`] : []),
|
|
72
|
+
"",
|
|
73
|
+
"## Findings",
|
|
74
|
+
"",
|
|
75
|
+
...(bundle.findings.length > 0 ? bundle.findings.map((finding) => {
|
|
76
|
+
const component = bundle.components.find((entry) => entry.id === finding.componentId);
|
|
77
|
+
const details = [finding.advisoryId && `advisory \`${finding.advisoryId}\``, finding.fixedVersion && `fixed \`${finding.fixedVersion}\``,
|
|
78
|
+
finding.licenseId && `license \`${finding.licenseId}\``, finding.policy && `policy \`${finding.policy}\``].filter(Boolean).join("; ");
|
|
79
|
+
return `- **${finding.severity}** ${finding.kind} for \`${component.name}${component.version ? `@${component.version}` : ""}\`: ${finding.summary}${details ? ` (${details})` : ""}`;
|
|
80
|
+
}) : ["- No findings were present in the imported bundle."]),
|
|
81
|
+
"",
|
|
82
|
+
"> External evidence only. FixMap did not fetch advisory data, maintain the vulnerability database, execute a scanner, prove exploitability, or authorize remediation."
|
|
83
|
+
].join("\n")}\n`;
|
|
84
|
+
}
|
|
85
|
+
function parseArgs(args) {
|
|
86
|
+
let input;
|
|
87
|
+
let format = "markdown";
|
|
88
|
+
let output;
|
|
89
|
+
const seen = new Set();
|
|
90
|
+
for (let index = 0; index < args.length; index += 1) {
|
|
91
|
+
const raw = args[index];
|
|
92
|
+
const separator = raw.indexOf("=");
|
|
93
|
+
const flag = separator === -1 ? raw : raw.slice(0, separator);
|
|
94
|
+
const inline = separator === -1 ? undefined : raw.slice(separator + 1);
|
|
95
|
+
if (!["--input", "--format", "--output"].includes(flag))
|
|
96
|
+
return { ok: false, message: `Unknown supply-chain option: ${raw}` };
|
|
97
|
+
if (seen.has(flag))
|
|
98
|
+
return { ok: false, message: `Pass ${flag} only once.` };
|
|
99
|
+
seen.add(flag);
|
|
100
|
+
const following = args[index + 1];
|
|
101
|
+
const value = inline ?? (following && !following.startsWith("--") ? following : undefined);
|
|
102
|
+
if (inline === undefined && value !== undefined)
|
|
103
|
+
index += 1;
|
|
104
|
+
if (!value?.trim())
|
|
105
|
+
return { ok: false, message: `${flag} requires a value.` };
|
|
106
|
+
if (flag === "--input")
|
|
107
|
+
input = expandHomePath(value.trim());
|
|
108
|
+
else if (flag === "--output")
|
|
109
|
+
output = expandHomePath(value.trim());
|
|
110
|
+
else {
|
|
111
|
+
const normalized = value.trim().toLowerCase();
|
|
112
|
+
if (normalized !== "markdown" && normalized !== "json")
|
|
113
|
+
return { ok: false, message: "--format must be markdown or json." };
|
|
114
|
+
format = normalized;
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
if (!input)
|
|
118
|
+
return { ok: false, message: "supply-chain requires --input <bundle.json>." };
|
|
119
|
+
return { ok: true, input, format, ...(output ? { output } : {}) };
|
|
120
|
+
}
|
|
121
|
+
function samePath(left, right) {
|
|
122
|
+
return process.platform === "win32" ? left.toLowerCase() === right.toLowerCase() : left === right;
|
|
123
|
+
}
|
|
124
|
+
function expandHomePath(value) {
|
|
125
|
+
if (value === "~")
|
|
126
|
+
return homedir();
|
|
127
|
+
if (value.startsWith("~/") || value.startsWith("~\\"))
|
|
128
|
+
return resolve(homedir(), value.slice(2));
|
|
129
|
+
return value;
|
|
130
|
+
}
|
|
131
|
+
//# sourceMappingURL=supply-chain-command.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"supply-chain-command.js","sourceRoot":"","sources":["../src/supply-chain-command.ts"],"names":[],"mappings":"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"}
|