@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.
Files changed (69) hide show
  1. package/README.md +109 -9
  2. package/dist/agent-setup.d.ts +6 -97
  3. package/dist/agent-setup.js +20 -6
  4. package/dist/agent-setup.js.map +1 -1
  5. package/dist/analysis-source.d.ts +1 -0
  6. package/dist/analysis-source.js +6 -2
  7. package/dist/analysis-source.js.map +1 -1
  8. package/dist/annotation-command.d.ts +8 -0
  9. package/dist/annotation-command.js +187 -0
  10. package/dist/annotation-command.js.map +1 -0
  11. package/dist/annotation-tool.d.ts +62 -0
  12. package/dist/annotation-tool.js +64 -0
  13. package/dist/annotation-tool.js.map +1 -0
  14. package/dist/ask-command.d.ts +9 -0
  15. package/dist/ask-command.js +127 -0
  16. package/dist/ask-command.js.map +1 -0
  17. package/dist/capability-command.d.ts +11 -0
  18. package/dist/capability-command.js +540 -0
  19. package/dist/capability-command.js.map +1 -0
  20. package/dist/change-scope-command.d.ts +7 -0
  21. package/dist/change-scope-command.js +162 -0
  22. package/dist/change-scope-command.js.map +1 -0
  23. package/dist/cli-runner.d.ts +2 -1
  24. package/dist/cli-runner.js +165 -47
  25. package/dist/cli-runner.js.map +1 -1
  26. package/dist/cli.js +26 -1
  27. package/dist/cli.js.map +1 -1
  28. package/dist/decode-input.d.ts +4 -0
  29. package/dist/decode-input.js +44 -0
  30. package/dist/decode-input.js.map +1 -0
  31. package/dist/doctor.d.ts +1 -0
  32. package/dist/doctor.js +14 -1
  33. package/dist/doctor.js.map +1 -1
  34. package/dist/editor-command.d.ts +8 -0
  35. package/dist/editor-command.js +46 -0
  36. package/dist/editor-command.js.map +1 -0
  37. package/dist/history-command.d.ts +14 -0
  38. package/dist/history-command.js +145 -0
  39. package/dist/history-command.js.map +1 -0
  40. package/dist/mcp.d.ts +20 -0
  41. package/dist/mcp.js +599 -11
  42. package/dist/mcp.js.map +1 -1
  43. package/dist/migration-command.d.ts +15 -0
  44. package/dist/migration-command.js +142 -0
  45. package/dist/migration-command.js.map +1 -0
  46. package/dist/repository-source.d.ts +1 -0
  47. package/dist/repository-source.js +7 -3
  48. package/dist/repository-source.js.map +1 -1
  49. package/dist/reverse-docs-command.d.ts +16 -0
  50. package/dist/reverse-docs-command.js +114 -0
  51. package/dist/reverse-docs-command.js.map +1 -0
  52. package/dist/runtime-command.d.ts +15 -0
  53. package/dist/runtime-command.js +121 -0
  54. package/dist/runtime-command.js.map +1 -0
  55. package/dist/sandbox-command.d.ts +9 -0
  56. package/dist/sandbox-command.js +158 -0
  57. package/dist/sandbox-command.js.map +1 -0
  58. package/dist/supply-chain-command.d.ts +20 -0
  59. package/dist/supply-chain-command.js +131 -0
  60. package/dist/supply-chain-command.js.map +1 -0
  61. package/dist/watch-command.js +7 -5
  62. package/dist/watch-command.js.map +1 -1
  63. package/dist/watch.d.ts +1 -0
  64. package/dist/watch.js +46 -2
  65. package/dist/watch.js.map +1 -1
  66. package/dist/workspace-command.d.ts +13 -0
  67. package/dist/workspace-command.js +267 -0
  68. package/dist/workspace-command.js.map +1 -0
  69. package/package.json +4 -4
@@ -0,0 +1,187 @@
1
+ import { constants } from "node:fs";
2
+ import { access, realpath, stat } from "node:fs/promises";
3
+ import { isAbsolute, relative, resolve } from "node:path";
4
+ import { addAnnotation, createAnnotation, readAnnotationStore, updateAnnotationStore, removeAnnotation } from "@aryam/fixmap-core";
5
+ export const ANNOTATE_USAGE = `Usage:
6
+ fixmap annotate <file> --note <text> [--owner <name>] [--expires <ISO-date>] [--repo <path>]
7
+ fixmap annotate <file> --symbol <name> --note <text> [--repo <path>]
8
+ fixmap annotate --service <name> --note <text> [--repo <path>]
9
+ fixmap annotate [<file>] --contract <name> --note <text> [--repo <path>]
10
+ fixmap annotate --list [--format markdown|json] [--repo <path>]
11
+ fixmap annotate --remove <annotation:id> [--repo <path>]
12
+
13
+ Writes a reviewable .fixmap/annotations.json store. File targets must exist inside the repository.
14
+ `;
15
+ export async function runAnnotateCommand(args, io) {
16
+ if (args[0] === "--help" || args[0] === "-h") {
17
+ io.stdout(ANNOTATE_USAGE);
18
+ return 0;
19
+ }
20
+ const parsed = parseAnnotationArgs(args, io.stderr);
21
+ if (!parsed)
22
+ return 1;
23
+ try {
24
+ const repoRoot = await realpath(parsed.repoRoot);
25
+ const rootStat = await stat(repoRoot);
26
+ if (!rootStat.isDirectory())
27
+ throw new Error(`Annotation repository is not a directory: ${parsed.repoRoot}`);
28
+ if (parsed.action === "list") {
29
+ const store = await readAnnotationStore(repoRoot);
30
+ io.stdout(renderAnnotations(store, parsed.format));
31
+ return 0;
32
+ }
33
+ let message = "";
34
+ await updateAnnotationStore(repoRoot, async (store) => {
35
+ if (parsed.action === "remove") {
36
+ const updated = removeAnnotation(store, parsed.removeId);
37
+ message = `Removed ${parsed.removeId} from .fixmap/annotations.json.\n`;
38
+ return updated;
39
+ }
40
+ const scope = await buildScope(repoRoot, parsed);
41
+ const annotation = createAnnotation({
42
+ scope,
43
+ note: parsed.note,
44
+ ...(parsed.owner ? { owner: parsed.owner } : {}),
45
+ createdAt: (io.now?.() ?? new Date()).toISOString(),
46
+ ...(parsed.expiresAt ? { expiresAt: parsed.expiresAt } : {})
47
+ });
48
+ const updated = addAnnotation(store, annotation);
49
+ message = `Added ${annotation.id} to .fixmap/annotations.json (${describeScope(annotation.scope)}).\n`;
50
+ return updated;
51
+ });
52
+ io.stdout(message);
53
+ return 0;
54
+ }
55
+ catch (error) {
56
+ io.stderr(`${error instanceof Error ? error.message : String(error)}\n`);
57
+ return 1;
58
+ }
59
+ }
60
+ function parseAnnotationArgs(args, stderr) {
61
+ const values = new Map();
62
+ const booleanFlags = new Set();
63
+ let target;
64
+ const valueFlags = new Set(["--note", "--owner", "--expires", "--repo", "--symbol", "--service", "--contract", "--remove", "--format"]);
65
+ for (let index = 0; index < args.length; index += 1) {
66
+ const raw = args[index];
67
+ if (raw === "--list") {
68
+ if (booleanFlags.has(raw))
69
+ return annotationArgError(stderr, "Pass --list only once.");
70
+ booleanFlags.add(raw);
71
+ continue;
72
+ }
73
+ const separator = raw.indexOf("=");
74
+ const flag = separator === -1 ? raw : raw.slice(0, separator);
75
+ if (flag.startsWith("--")) {
76
+ if (!valueFlags.has(flag))
77
+ return annotationArgError(stderr, `Unknown annotate option: ${raw}`);
78
+ if (values.has(flag))
79
+ return annotationArgError(stderr, `Pass ${flag} only once.`);
80
+ const inline = separator === -1 ? undefined : raw.slice(separator + 1);
81
+ const following = args[index + 1];
82
+ const value = inline ?? (following && !following.startsWith("--") ? following : undefined);
83
+ if (inline === undefined && value !== undefined)
84
+ index += 1;
85
+ if (!value?.trim())
86
+ return annotationArgError(stderr, `${flag} requires a non-blank value.`);
87
+ values.set(flag, value.trim());
88
+ continue;
89
+ }
90
+ if (target)
91
+ return annotationArgError(stderr, "Annotate accepts at most one file target.");
92
+ target = raw;
93
+ }
94
+ const formatValue = values.get("--format")?.toLowerCase() ?? "markdown";
95
+ if (formatValue !== "markdown" && formatValue !== "json")
96
+ return annotationArgError(stderr, "--format must be markdown or json.");
97
+ const repoRoot = resolve(values.get("--repo") ?? process.cwd());
98
+ if (booleanFlags.has("--list")) {
99
+ if (target || values.has("--note") || values.has("--remove") || values.has("--symbol") || values.has("--service") || values.has("--contract")) {
100
+ return annotationArgError(stderr, "--list cannot be combined with an annotation target, note, scope, or --remove.");
101
+ }
102
+ return { action: "list", repoRoot, format: formatValue };
103
+ }
104
+ if (values.has("--remove")) {
105
+ if (target || values.has("--note") || values.has("--symbol") || values.has("--service") || values.has("--contract")) {
106
+ return annotationArgError(stderr, "--remove cannot be combined with an annotation target, note, or scope.");
107
+ }
108
+ return { action: "remove", repoRoot, removeId: values.get("--remove"), format: formatValue };
109
+ }
110
+ if (!values.has("--note"))
111
+ return annotationArgError(stderr, "Adding an annotation requires --note <text>.");
112
+ const scopeCount = [values.has("--symbol"), values.has("--service"), values.has("--contract")].filter(Boolean).length;
113
+ if (scopeCount > 1)
114
+ return annotationArgError(stderr, "Choose only one of --symbol, --service, or --contract.");
115
+ if (values.has("--service") && target)
116
+ return annotationArgError(stderr, "A service annotation does not take a file target.");
117
+ if (values.has("--symbol") && !target)
118
+ return annotationArgError(stderr, "A symbol annotation requires its file target.");
119
+ if (!target && !values.has("--service") && !values.has("--contract"))
120
+ return annotationArgError(stderr, "Add a file target, --service, or --contract.");
121
+ return {
122
+ action: "add",
123
+ repoRoot,
124
+ ...(target ? { target } : {}),
125
+ note: values.get("--note"),
126
+ ...(values.has("--owner") ? { owner: values.get("--owner") } : {}),
127
+ ...(values.has("--expires") ? { expiresAt: values.get("--expires") } : {}),
128
+ ...(values.has("--symbol") ? { symbol: values.get("--symbol") } : {}),
129
+ ...(values.has("--service") ? { service: values.get("--service") } : {}),
130
+ ...(values.has("--contract") ? { contract: values.get("--contract") } : {}),
131
+ format: formatValue
132
+ };
133
+ }
134
+ function annotationArgError(stderr, message) {
135
+ stderr(`${message}\n\n${ANNOTATE_USAGE}`);
136
+ return undefined;
137
+ }
138
+ async function buildScope(repoRoot, options) {
139
+ if (options.service)
140
+ return { kind: "service", name: options.service };
141
+ if (options.contract && !options.target)
142
+ return { kind: "contract", name: options.contract };
143
+ const path = await containedFile(repoRoot, options.target);
144
+ if (options.symbol)
145
+ return { kind: "symbol", path, symbol: options.symbol };
146
+ if (options.contract)
147
+ return { kind: "contract", name: options.contract, path };
148
+ return { kind: "file", path };
149
+ }
150
+ async function containedFile(repoRoot, target) {
151
+ const absolute = resolve(repoRoot, target);
152
+ const lexical = relative(repoRoot, absolute);
153
+ if (!lexical || lexical === ".." || lexical.startsWith(`..${process.platform === "win32" ? "\\" : "/"}`) || isAbsolute(lexical)) {
154
+ throw new Error(`Annotation target must be a file inside the repository: ${target}`);
155
+ }
156
+ await access(absolute, constants.R_OK);
157
+ const targetStat = await stat(absolute);
158
+ if (!targetStat.isFile())
159
+ throw new Error(`Annotation target is not a file: ${target}`);
160
+ const realTarget = await realpath(absolute);
161
+ const realRelative = relative(repoRoot, realTarget);
162
+ if (!realRelative || realRelative === ".." || realRelative.startsWith(`..${process.platform === "win32" ? "\\" : "/"}`) || isAbsolute(realRelative)) {
163
+ throw new Error(`Annotation target resolves outside the repository: ${target}`);
164
+ }
165
+ return lexical.replace(/\\/g, "/");
166
+ }
167
+ function renderAnnotations(store, format) {
168
+ if (format === "json")
169
+ return `${JSON.stringify(store, null, 2)}\n`;
170
+ if (store.annotations.length === 0)
171
+ return "# FixMap Annotations\n\nNo annotations found.\n";
172
+ const lines = ["# FixMap Annotations", ""];
173
+ for (const annotation of store.annotations) {
174
+ lines.push(`- ${annotation.id} (${describeScope(annotation.scope)}): ${annotation.note}`);
175
+ }
176
+ return `${lines.join("\n")}\n`;
177
+ }
178
+ function describeScope(scope) {
179
+ if (scope.kind === "file")
180
+ return `file ${scope.path}`;
181
+ if (scope.kind === "symbol")
182
+ return `symbol ${scope.symbol} in ${scope.path}`;
183
+ if (scope.kind === "service")
184
+ return `service ${scope.name}`;
185
+ return `contract ${scope.name}${scope.path ? ` in ${scope.path}` : ""}`;
186
+ }
187
+ //# sourceMappingURL=annotation-command.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"annotation-command.js","sourceRoot":"","sources":["../src/annotation-command.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,62 @@
1
+ export declare const ANNOTATION_TOOL: {
2
+ name: string;
3
+ title: string;
4
+ description: string;
5
+ annotations: {
6
+ readOnlyHint: boolean;
7
+ destructiveHint: boolean;
8
+ openWorldHint: boolean;
9
+ };
10
+ inputSchema: {
11
+ type: "object";
12
+ properties: {
13
+ action: {
14
+ type: string;
15
+ enum: string[];
16
+ };
17
+ repo: {
18
+ type: string;
19
+ description: string;
20
+ };
21
+ target: {
22
+ type: string;
23
+ description: string;
24
+ };
25
+ note: {
26
+ type: string;
27
+ };
28
+ owner: {
29
+ type: string;
30
+ };
31
+ expires: {
32
+ type: string;
33
+ };
34
+ symbol: {
35
+ type: string;
36
+ };
37
+ service: {
38
+ type: string;
39
+ };
40
+ contract: {
41
+ type: string;
42
+ };
43
+ id: {
44
+ type: string;
45
+ description: string;
46
+ };
47
+ format: {
48
+ type: string;
49
+ enum: string[];
50
+ };
51
+ };
52
+ required: string[];
53
+ additionalProperties: boolean;
54
+ };
55
+ };
56
+ export declare function runAnnotationTool(value: unknown, defaultRepo: string): Promise<{
57
+ content: {
58
+ type: "text";
59
+ text: string;
60
+ }[];
61
+ isError?: boolean;
62
+ }>;
@@ -0,0 +1,64 @@
1
+ import { runAnnotateCommand } from "./annotation-command.js";
2
+ export const ANNOTATION_TOOL = {
3
+ name: "fixmap_annotate",
4
+ title: "FixMap annotations",
5
+ description: "Explicitly add, list, or remove reviewable local annotations. Add/remove writes .fixmap/annotations.json; use only when the user requests that change. Never executes repository code.",
6
+ annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
7
+ inputSchema: {
8
+ type: "object",
9
+ properties: {
10
+ action: { type: "string", enum: ["add", "list", "remove"] },
11
+ repo: { type: "string", description: "Local repository directory" },
12
+ target: { type: "string", description: "Repository-relative file target" },
13
+ note: { type: "string" }, owner: { type: "string" }, expires: { type: "string" },
14
+ symbol: { type: "string" }, service: { type: "string" }, contract: { type: "string" },
15
+ id: { type: "string", description: "Exact annotation ID to remove" },
16
+ format: { type: "string", enum: ["markdown", "json"] }
17
+ },
18
+ required: ["action"], additionalProperties: false
19
+ }
20
+ };
21
+ export async function runAnnotationTool(value, defaultRepo) {
22
+ const failure = (message) => ({ isError: true, content: [{ type: "text", text: `Invalid arguments: ${message}` }] });
23
+ if (!value || typeof value !== "object" || Array.isArray(value))
24
+ return failure("expected an object.");
25
+ const args = value;
26
+ if (!["add", "list", "remove"].includes(String(args.action)))
27
+ return failure("action must be add, list, or remove.");
28
+ const allowed = args.action === "add"
29
+ ? ["action", "repo", "target", "note", "owner", "expires", "symbol", "service", "contract"]
30
+ : args.action === "list" ? ["action", "repo", "format"] : ["action", "repo", "id"];
31
+ for (const [key, entry] of Object.entries(args)) {
32
+ if (!allowed.includes(key))
33
+ return failure(`field ${key} is not allowed for this action.`);
34
+ if (typeof entry !== "string" || !entry.trim() || entry.length > 10_000)
35
+ return failure(`${key} must be a bounded non-empty string.`);
36
+ }
37
+ if (args.action === "add" && args.note === undefined)
38
+ return failure("note is required for add.");
39
+ if (args.action === "remove" && args.id === undefined)
40
+ return failure("id is required for remove.");
41
+ if (args.repo && /^[a-z][a-z0-9+.-]*:\/\//i.test(String(args.repo)))
42
+ return failure("repo must be a local directory.");
43
+ const cliArgs = [`--repo=${args.repo ?? defaultRepo}`];
44
+ if (args.action === "list")
45
+ cliArgs.push("--list", `--format=${args.format ?? "json"}`);
46
+ else if (args.action === "remove")
47
+ cliArgs.push(`--remove=${args.id}`);
48
+ else {
49
+ if (args.target !== undefined) {
50
+ if (String(args.target).startsWith("-"))
51
+ return failure("target cannot begin with '-'.");
52
+ cliArgs.push(String(args.target));
53
+ }
54
+ for (const key of ["note", "owner", "expires", "symbol", "service", "contract"]) {
55
+ if (args[key] !== undefined)
56
+ cliArgs.push(`--${key}=${args[key]}`);
57
+ }
58
+ }
59
+ const output = [];
60
+ const errors = [];
61
+ const code = await runAnnotateCommand(cliArgs, { stdout: (text) => { output.push(text); }, stderr: (text) => { errors.push(text); } });
62
+ return { ...(code ? { isError: true } : {}), content: [{ type: "text", text: (code ? errors : output).join("") }] };
63
+ }
64
+ //# sourceMappingURL=annotation-tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"annotation-tool.js","sourceRoot":"","sources":["../src/annotation-tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ import { type FixMapAnswer } from "@aryam/fixmap-core";
2
+ export declare const ASK_USAGE = "Usage: fixmap ask --report <plan.json> --question <text> [--format markdown|json] [--output <file>]\n\nAnswers structural questions from a saved report's ranked context, impact, tests, risks, diagnostics, annotations, ADRs, and architecture policy. The deterministic CLI mode reads no source content, calls no model, and preserves citations and unknowns instead of guessing.\n";
3
+ export type AskCommandDependencies = {
4
+ stdout?: (text: string) => void;
5
+ stderr?: (text: string) => void;
6
+ writeOutput?: (path: string, contents: string) => Promise<void>;
7
+ };
8
+ export declare function runAskCommand(args: string[], dependencies?: AskCommandDependencies): Promise<number>;
9
+ export declare function renderAskMarkdown(answer: FixMapAnswer): string;
@@ -0,0 +1,127 @@
1
+ import { writeFile } from "node:fs/promises";
2
+ import { homedir } from "node:os";
3
+ import { resolve } from "node:path";
4
+ import { answerFixMapQuestion } from "@aryam/fixmap-core";
5
+ import { describeInputReadError, readDecodedTextFile } from "./decode-input.js";
6
+ export const ASK_USAGE = `Usage: fixmap ask --report <plan.json> --question <text> [--format markdown|json] [--output <file>]
7
+
8
+ Answers structural questions from a saved report's ranked context, impact, tests, risks, diagnostics, annotations, ADRs, and architecture policy. The deterministic CLI mode reads no source content, calls no model, and preserves citations and unknowns instead of guessing.
9
+ `;
10
+ export async function runAskCommand(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(ASK_USAGE);
15
+ return 0;
16
+ }
17
+ const parsed = parseAskArgs(args);
18
+ if (!parsed.ok) {
19
+ stderr(`${parsed.message}\n\n${ASK_USAGE}`);
20
+ return 1;
21
+ }
22
+ if (parsed.output && samePath(resolve(parsed.output), resolve(parsed.report))) {
23
+ stderr("Ask --output must not overwrite the input report.\n");
24
+ return 1;
25
+ }
26
+ try {
27
+ const report = JSON.parse(readDecodedTextFile(parsed.report));
28
+ const answer = await answerFixMapQuestion(report, parsed.question);
29
+ const rendered = parsed.format === "json"
30
+ ? `${JSON.stringify(answer, null, 2)}\n`
31
+ : renderAskMarkdown(answer);
32
+ if (parsed.output) {
33
+ await (dependencies.writeOutput ?? ((path, contents) => writeFile(path, contents, "utf8")))(parsed.output, rendered);
34
+ }
35
+ else {
36
+ stdout(rendered);
37
+ }
38
+ return 0;
39
+ }
40
+ catch (error) {
41
+ stderr(`Could not answer from "${parsed.report}": ${describeInputReadError(parsed.report, error)}\n`);
42
+ return 1;
43
+ }
44
+ }
45
+ function parseAskArgs(args) {
46
+ let report;
47
+ let question;
48
+ let format = "markdown";
49
+ let output;
50
+ const seen = new Set();
51
+ for (let index = 0; index < args.length; index += 1) {
52
+ const raw = args[index];
53
+ const separator = raw.indexOf("=");
54
+ const flag = separator === -1 ? raw : raw.slice(0, separator);
55
+ const inline = separator === -1 ? undefined : raw.slice(separator + 1);
56
+ if (!["--report", "--question", "--format", "--output"].includes(flag)) {
57
+ return { ok: false, message: `Unknown ask option: ${raw}` };
58
+ }
59
+ if (seen.has(flag))
60
+ return { ok: false, message: `Pass ${flag} only once.` };
61
+ seen.add(flag);
62
+ const following = args[index + 1];
63
+ const value = inline ?? (following && !following.startsWith("--") ? following : undefined);
64
+ if (inline === undefined && value !== undefined)
65
+ index += 1;
66
+ if (!value?.trim())
67
+ return { ok: false, message: `${flag} requires a value.` };
68
+ if (flag === "--report")
69
+ report = expandHomePath(value.trim());
70
+ else if (flag === "--question")
71
+ question = value.trim();
72
+ else if (flag === "--output")
73
+ output = expandHomePath(value.trim());
74
+ else {
75
+ const normalized = value.trim().toLowerCase();
76
+ if (normalized !== "markdown" && normalized !== "json") {
77
+ return { ok: false, message: "--format must be markdown or json." };
78
+ }
79
+ format = normalized;
80
+ }
81
+ }
82
+ if (!report)
83
+ return { ok: false, message: "ask requires --report <plan.json>." };
84
+ if (!question)
85
+ return { ok: false, message: "ask requires --question <text>." };
86
+ if (question.length > 5_000 || question.includes("\0")) {
87
+ return { ok: false, message: "--question must contain at most 5,000 characters and no null bytes." };
88
+ }
89
+ return { ok: true, report, question, format, ...(output ? { output } : {}) };
90
+ }
91
+ export function renderAskMarkdown(answer) {
92
+ const lines = [
93
+ "# FixMap answer",
94
+ "",
95
+ `Question: ${answer.question}`,
96
+ "",
97
+ answer.answer,
98
+ "",
99
+ "## Evidence",
100
+ "",
101
+ ...(answer.citations.length > 0
102
+ ? answer.citations.map((citation) => `- ${code(citation.id)} **${citation.kind}**${citation.path ? ` ${code(citation.path)}` : ""} — ${citation.detail}`)
103
+ : ["No report evidence answered this question."]),
104
+ "",
105
+ "## Unknowns",
106
+ "",
107
+ ...(answer.unknowns.length > 0 ? answer.unknowns.map((unknown) => `- ${unknown}`) : ["No additional unknown was recorded."]),
108
+ "",
109
+ ...answer.diagnostics.map((diagnostic) => `> ${diagnostic}`),
110
+ "> Claims verified: no. Evidence scope: report only; no source content."
111
+ ];
112
+ return `${lines.join("\n")}\n`;
113
+ }
114
+ function code(value) {
115
+ return `\`${value.replaceAll("`", "'")}\``;
116
+ }
117
+ function samePath(left, right) {
118
+ return process.platform === "win32" ? left.toLowerCase() === right.toLowerCase() : left === right;
119
+ }
120
+ function expandHomePath(value) {
121
+ if (value === "~")
122
+ return homedir();
123
+ if (value.startsWith("~/") || value.startsWith("~\\"))
124
+ return resolve(homedir(), value.slice(2));
125
+ return value;
126
+ }
127
+ //# sourceMappingURL=ask-command.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ask-command.js","sourceRoot":"","sources":["../src/ask-command.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ export declare const CAPABILITIES_USAGE = "Usage: fixmap capabilities [--repo <path>] [--format markdown|json] [--output <file>] [--no-cache]\n\nLists the human-owned product capabilities declared in .fixmap/capabilities.json.\n";
2
+ export declare const CAPABILITY_USAGE = "Usage:\n fixmap capability <id> [--repo <path>] [--format markdown|json] [--output <file>] [--no-cache]\n fixmap capability diff <id> <from>..<to> [--repo <path>] [--format markdown|json] [--output <file>]\n fixmap capability create <id> [--name <name>] --touch <path> [--touch <path> ...] [--add <path> ...] [options]\n fixmap capability update <id> [--name <name>] [--touch <path> ...] [--add <path> ...] [options]\n fixmap capability remove <id> [--repo <path>] [--format markdown|json]\n\nCapabilities persist reviewed names, explicit anchors, and traversal bounds\u2014not generated conclusions.\nNo LLM, hosted API, account, semantic inference, or network service is used.\n\nOptions:\n --name <name> Human-facing capability name (create/update)\n --touch <path> Existing implementation anchor (repeatable)\n --add <path> Planned path anchor; missing paths remain unresolved (repeatable)\n --direction <value> dependencies, dependents, or both\n --depth <0-8> Maximum structural traversal depth\n --max-nodes <1-2000> Maximum selected plus affected nodes\n --workspace <id> Store identity when creating the first capability (default local)\n --repository <id> Store repository identity when creating it (default checkout name)\n --repo <path> Local checkout (default current directory)\n --format <value> markdown (default) or json\n --output <file> Show/list output file\n --no-cache Bypass repository scan caches for show/list\n --help, -h Show this help\n";
3
+ type CommandIO = {
4
+ stdout?: (text: string) => void;
5
+ stderr?: (text: string) => void;
6
+ writeOutput?: (path: string, contents: string) => Promise<void>;
7
+ now?: () => string;
8
+ };
9
+ export declare function runCapabilitiesCommand(args: string[], io?: CommandIO): Promise<number>;
10
+ export declare function runCapabilityCommand(args: string[], io?: CommandIO): Promise<number>;
11
+ export {};