@aryam/fixmap 0.2.1 → 0.4.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/README.md ADDED
@@ -0,0 +1,84 @@
1
+ # @aryam/fixmap
2
+
3
+ **Give your coding agent a map before it starts editing.**
4
+
5
+ FixMap turns an issue, prompt, or git diff into ranked context files, test routes, and risk notes — locally, with no account or API key. Nothing leaves your machine.
6
+
7
+ ## Quick start
8
+
9
+ Run from a JavaScript or TypeScript repository:
10
+
11
+ ```bash
12
+ npx @aryam/fixmap plan --issue "password reset emails fail"
13
+ ```
14
+
15
+ Use a real branch diff:
16
+
17
+ ```bash
18
+ npx @aryam/fixmap plan --diff main...HEAD
19
+ ```
20
+
21
+ Machine-readable output:
22
+
23
+ ```bash
24
+ npx @aryam/fixmap plan --base main --head HEAD --format json --output fixmap-report.json
25
+ ```
26
+
27
+ ## MCP server
28
+
29
+ FixMap ships as a Model Context Protocol server, so coding agents can request a plan themselves. One tool is exposed: `fixmap_plan`.
30
+
31
+ Claude Code:
32
+
33
+ ```bash
34
+ claude mcp add fixmap -- npx -y @aryam/fixmap mcp
35
+ ```
36
+
37
+ Cursor, Windsurf, or any MCP client:
38
+
39
+ ```json
40
+ {
41
+ "mcpServers": {
42
+ "fixmap": {
43
+ "command": "npx",
44
+ "args": ["-y", "@aryam/fixmap", "mcp"]
45
+ }
46
+ }
47
+ }
48
+ ```
49
+
50
+ ## Options
51
+
52
+ ```text
53
+ fixmap plan Generate a FixMap report for a task or diff
54
+ fixmap mcp Run FixMap as an MCP server over stdio
55
+
56
+ --issue <text> Issue, prompt, or task description
57
+ --diff <spec> Git diff spec, such as main...HEAD
58
+ --base <ref> Base ref for diffing when --diff is not given
59
+ --head <ref> Head ref for diffing (defaults to HEAD)
60
+ --repo <path> Repository root to scan (defaults to current directory)
61
+ --format <fmt> Output format: markdown (default) or json
62
+ --output <file> Write the report to a file instead of stdout
63
+ ```
64
+
65
+ ## Example output
66
+
67
+ ```text
68
+ ## Context Files
69
+ - src/auth/reset-password.ts (high confidence): path and content match
70
+
71
+ ## Test Route
72
+ - npm --prefix apps/api run test
73
+
74
+ ## Risk Map
75
+ - high authentication: authentication-related files are affected
76
+ ```
77
+
78
+ ## Links
79
+
80
+ - [GitHub repository](https://github.com/aryamthecodebreaker/FixMap)
81
+ - [Live demo](https://fixmap-flax.vercel.app)
82
+ - [Changelog](https://github.com/aryamthecodebreaker/FixMap/blob/main/CHANGELOG.md)
83
+
84
+ MIT © FixMap contributors.
package/dist/cli.js CHANGED
@@ -1,15 +1,20 @@
1
1
  #!/usr/bin/env node
2
2
  import { readFileSync } from "node:fs";
3
- import { writeFile } from "node:fs/promises";
3
+ import { stat, writeFile } from "node:fs/promises";
4
4
  import { dirname, join, resolve } from "node:path";
5
5
  import { fileURLToPath } from "node:url";
6
- import { buildRiskNotes, buildSummary, buildTestRoutes, rankContextFiles, renderJsonReport, renderMarkdownReport, scanRepo } from "@aryam/fixmap-core";
6
+ import { buildFixMapReport, renderJsonReport, renderMarkdownReport } from "@aryam/fixmap-core";
7
7
  const USAGE = `FixMap maps an issue, prompt, or diff to context files, test routes, and review risks.
8
8
 
9
9
  Usage:
10
10
  fixmap plan --issue "Users cannot reset passwords"
11
11
  fixmap plan --diff main...HEAD
12
12
  fixmap plan --base main --head HEAD --format json
13
+ fixmap mcp
14
+
15
+ Commands:
16
+ plan Generate a FixMap report for a task or diff
17
+ mcp Run FixMap as an MCP server over stdio for AI coding agents
13
18
 
14
19
  Options:
15
20
  --issue <text> Issue, prompt, or task description
@@ -32,45 +37,60 @@ if (rawArgs[0] === "--version" || rawArgs[0] === "version") {
32
37
  console.log(packageJson.version);
33
38
  process.exit(0);
34
39
  }
35
- const options = parseArgs(rawArgs);
36
- if (options.command !== "plan") {
37
- console.error(`Unknown command: ${options.command || "(none)"}\n\n${USAGE}`);
38
- process.exit(1);
39
- }
40
- if (options.unknownArgs.length > 0) {
41
- console.error(`Unknown or incomplete option(s): ${options.unknownArgs.join(", ")}\n\n${USAGE}`);
42
- process.exit(1);
40
+ if (rawArgs[0] === "mcp") {
41
+ const { runMcpServer } = await import("./mcp.js");
42
+ await runMcpServer();
43
43
  }
44
- if (!options.issueText && !options.diffSpec && !options.baseRef) {
45
- console.error("Provide --issue, --diff, or --base/--head so FixMap has a task signal.");
46
- process.exit(1);
44
+ else {
45
+ await runPlan(rawArgs);
47
46
  }
48
- const repo = await scanRepo({
49
- repoRoot: options.repoRoot,
50
- diffSpec: options.diffSpec,
51
- baseRef: options.baseRef,
52
- headRef: options.headRef
53
- });
54
- const contextFiles = rankContextFiles(repo, {
55
- issueText: options.issueText,
56
- diffText: repo.diffText
57
- });
58
- const contextPaths = contextFiles.map((file) => file.path);
59
- const testRoutes = buildTestRoutes(repo, contextPaths);
60
- const report = {
61
- summary: buildSummary(contextFiles.length, testRoutes.length),
62
- contextFiles,
63
- testRoutes,
64
- risks: buildRiskNotes(contextPaths),
65
- changedFiles: repo.changedFiles,
66
- diagnostics: repo.diagnostics
67
- };
68
- const rendered = options.format === "json" ? renderJsonReport(report) : renderMarkdownReport(report);
69
- if (options.output) {
70
- await writeFile(options.output, rendered, "utf8");
47
+ async function runPlan(args) {
48
+ const options = parseArgs(args);
49
+ if (options.command !== "plan") {
50
+ console.error(`Unknown command: ${options.command || "(none)"}\n\n${USAGE}`);
51
+ process.exit(1);
52
+ }
53
+ if (options.unknownArgs.length > 0) {
54
+ console.error(`Unknown or incomplete option(s): ${options.unknownArgs.join(", ")}\n\n${USAGE}`);
55
+ process.exit(1);
56
+ }
57
+ if (!options.issueText && !options.diffSpec && !options.baseRef) {
58
+ console.error("Provide --issue, --diff, or --base/--head so FixMap has a task signal.");
59
+ process.exit(1);
60
+ }
61
+ if (!(await isDirectory(options.repoRoot))) {
62
+ console.error(`Repository root "${options.repoRoot}" does not exist or is not a directory. Check the --repo path.`);
63
+ process.exit(1);
64
+ }
65
+ const report = await buildFixMapReport({
66
+ repoRoot: options.repoRoot,
67
+ issueText: options.issueText,
68
+ diffSpec: options.diffSpec,
69
+ baseRef: options.baseRef,
70
+ headRef: options.headRef
71
+ });
72
+ if (!options.issueText) {
73
+ const diffFailure = report.diagnostics.find((diagnostic) => diagnostic.code === "diff-unavailable");
74
+ if (diffFailure) {
75
+ console.error(`${diffFailure.message}\nNo --issue text was provided to fall back to, so this report would be empty. Fix the ref or add --issue.`);
76
+ process.exit(1);
77
+ }
78
+ }
79
+ const rendered = options.format === "json" ? renderJsonReport(report) : renderMarkdownReport(report);
80
+ if (options.output) {
81
+ await writeFile(options.output, rendered, "utf8");
82
+ }
83
+ else {
84
+ process.stdout.write(rendered);
85
+ }
71
86
  }
72
- else {
73
- process.stdout.write(rendered);
87
+ async function isDirectory(path) {
88
+ try {
89
+ return (await stat(path)).isDirectory();
90
+ }
91
+ catch {
92
+ return false;
93
+ }
74
94
  }
75
95
  function parseArgs(args) {
76
96
  const command = args[0] ?? "";
package/dist/cli.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
package/dist/mcp.d.ts ADDED
@@ -0,0 +1,3 @@
1
+ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
2
+ export declare function createFixMapMcpServer(): Server;
3
+ export declare function runMcpServer(): Promise<void>;
package/dist/mcp.js ADDED
@@ -0,0 +1,95 @@
1
+ import { readFileSync } from "node:fs";
2
+ import { stat } from "node:fs/promises";
3
+ import { dirname, join, resolve } from "node:path";
4
+ import { fileURLToPath } from "node:url";
5
+ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
6
+ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
7
+ import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
8
+ import { buildFixMapReport, renderJsonReport, renderMarkdownReport } from "@aryam/fixmap-core";
9
+ const PLAN_TOOL = {
10
+ name: "fixmap_plan",
11
+ title: "FixMap plan",
12
+ description: "Map an issue, prompt, or git diff to the repository files worth reading first, " +
13
+ "the test commands most likely to validate a change, and the areas that deserve review attention. " +
14
+ "Run this before editing code so the change starts from the right context. " +
15
+ "Provide at least one of issue, diff, or base.",
16
+ inputSchema: {
17
+ type: "object",
18
+ properties: {
19
+ issue: { type: "string", description: "Issue, prompt, or task description" },
20
+ diff: { type: "string", description: "Git diff spec, such as main...HEAD" },
21
+ base: { type: "string", description: "Base git ref to diff against when diff is not given" },
22
+ head: { type: "string", description: "Head git ref, defaults to HEAD" },
23
+ repo: {
24
+ type: "string",
25
+ description: "Absolute path to the repository root, defaults to the server working directory"
26
+ },
27
+ format: {
28
+ type: "string",
29
+ enum: ["markdown", "json"],
30
+ description: "Report format, markdown by default"
31
+ }
32
+ }
33
+ }
34
+ };
35
+ export function createFixMapMcpServer() {
36
+ const server = new Server({ name: "fixmap", version: readVersion() }, { capabilities: { tools: {} } });
37
+ server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: [PLAN_TOOL] }));
38
+ server.setRequestHandler(CallToolRequestSchema, async (request) => {
39
+ if (request.params.name !== PLAN_TOOL.name) {
40
+ return {
41
+ isError: true,
42
+ content: [{ type: "text", text: `Unknown tool: ${request.params.name}` }]
43
+ };
44
+ }
45
+ const args = (request.params.arguments ?? {});
46
+ if (!args.issue && !args.diff && !args.base) {
47
+ return {
48
+ isError: true,
49
+ content: [{ type: "text", text: "Provide issue, diff, or base/head so FixMap has a task signal." }]
50
+ };
51
+ }
52
+ const repoRoot = args.repo ? resolve(args.repo) : process.cwd();
53
+ if (!(await isDirectory(repoRoot))) {
54
+ return {
55
+ isError: true,
56
+ content: [{ type: "text", text: `Repository root "${repoRoot}" does not exist or is not a directory.` }]
57
+ };
58
+ }
59
+ const report = await buildFixMapReport({
60
+ repoRoot,
61
+ issueText: args.issue,
62
+ diffSpec: args.diff,
63
+ baseRef: args.base,
64
+ headRef: args.head
65
+ });
66
+ if (!args.issue) {
67
+ const diffFailure = report.diagnostics.find((diagnostic) => diagnostic.code === "diff-unavailable");
68
+ if (diffFailure) {
69
+ return {
70
+ isError: true,
71
+ content: [{ type: "text", text: `${diffFailure.message} No issue text was provided to fall back to.` }]
72
+ };
73
+ }
74
+ }
75
+ const text = args.format === "json" ? renderJsonReport(report) : renderMarkdownReport(report);
76
+ return { content: [{ type: "text", text }] };
77
+ });
78
+ return server;
79
+ }
80
+ export async function runMcpServer() {
81
+ await createFixMapMcpServer().connect(new StdioServerTransport());
82
+ }
83
+ async function isDirectory(path) {
84
+ try {
85
+ return (await stat(path)).isDirectory();
86
+ }
87
+ catch {
88
+ return false;
89
+ }
90
+ }
91
+ function readVersion() {
92
+ const packageJson = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), "..", "package.json"), "utf8"));
93
+ return packageJson.version;
94
+ }
95
+ //# sourceMappingURL=mcp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,8 +1,13 @@
1
1
  {
2
2
  "name": "@aryam/fixmap",
3
- "version": "0.2.1",
4
- "description": "CLI for mapping issues and diffs to relevant files, tests, and review risks.",
3
+ "version": "0.4.0",
4
+ "description": "CLI and MCP server for mapping issues and diffs to relevant files, tests, and review risks.",
5
5
  "license": "MIT",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "git+https://github.com/aryamthecodebreaker/FixMap.git",
9
+ "directory": "packages/cli"
10
+ },
6
11
  "type": "module",
7
12
  "bin": {
8
13
  "fixmap": "dist/cli.js"
@@ -11,10 +16,12 @@
11
16
  "publishConfig": { "access": "public" },
12
17
  "scripts": {
13
18
  "build": "tsc -p tsconfig.json",
19
+ "test": "vitest run",
14
20
  "typecheck": "tsc -p tsconfig.json --noEmit"
15
21
  },
16
22
  "dependencies": {
17
- "@aryam/fixmap-core": "0.2.1"
23
+ "@aryam/fixmap-core": "0.4.0",
24
+ "@modelcontextprotocol/sdk": "^1.29.0"
18
25
  },
19
26
  "engines": {
20
27
  "node": ">=20.11"