@makerkit/prd-mcp 0.0.2 → 0.0.3

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 (3) hide show
  1. package/README.md +5 -3
  2. package/bin.mjs +21 -8
  3. package/package.json +3 -3
package/README.md CHANGED
@@ -15,7 +15,7 @@ Any MCP client (stdio):
15
15
  ```json
16
16
  {
17
17
  "mcpServers": {
18
- "prd": { "command": "npx", "args": ["-y", "@makerkit/prd-mcp"] }
18
+ "prd": { "command": "pnpx", "args": ["-y", "@makerkit/prd-mcp"] }
19
19
  }
20
20
  }
21
21
  ```
@@ -23,10 +23,12 @@ Any MCP client (stdio):
23
23
  ## Options
24
24
 
25
25
  ```
26
- makerkit-prd-mcp [--root <dir>] [--check <script>]...
26
+ makerkit-prd-mcp [--root <dir>] [--prds-dir <dir>] [--check-root <dir>] [--check <script>]...
27
27
  ```
28
28
 
29
- - `--root`: project directory (default: current directory). PRDs live in `<root>/.prds`.
29
+ - `--root`: project directory (default: current directory).
30
+ - `--prds-dir`: dedicated PRD directory, absolute or relative to `--root` (default: `.prds`). Use the same path when launching Loop.
31
+ - `--check-root`: working tree for completion checks (default: `--root`). For parallel work, use the same `--root` across workers, give each worker its own worktree as `--check-root`, and invoke `implement_story` with `singleStory: true`.
30
32
  - `--check`: a `package.json` script that must pass before a story can be marked completed. Repeat for several. Default: `typecheck` and `lint` (scripts the project does not have are skipped).
31
33
 
32
34
  ## License
package/bin.mjs CHANGED
@@ -7,17 +7,22 @@ import { createNodePrdDeps, createScriptVerifier } from "@makerkit/prd/node";
7
7
  import { readFileSync } from "node:fs";
8
8
  import { resolve } from "node:path";
9
9
  import { parseArgs } from "node:util";
10
- //#region src/bin.ts
11
- const HELP = `Usage: makerkit-prd-mcp [--root <dir>] [--check <script>]...
10
+ // src/bin.ts
11
+ const HELP = `Usage: makerkit-prd-mcp [--root <dir>] [--prds-dir <dir>] [--check-root <dir>] [--check <script>]...
12
12
 
13
- Serves the PRDs in <dir>/.prds over MCP (stdio).
13
+ Serves a PRD directory over MCP (stdio).
14
14
 
15
- --root Project directory. Defaults to the current directory.
16
- --check package.json script that must pass before a story is completed.
17
- Repeat for several. Defaults to typecheck and lint.
15
+ --root Project directory. Defaults to the current directory.
16
+ --prds-dir PRD directory. Absolute or relative to --root. Defaults to .prds.
17
+ --check-root Working tree where completion checks run. Defaults to --root.
18
+ Workers can share --root and verify their own working trees.
19
+ --check package.json script that must pass before a story is completed.
20
+ Repeat for several. Defaults to typecheck and lint.
18
21
  `;
19
22
  const { values } = parseArgs({ options: {
20
23
  root: { type: "string" },
24
+ "prds-dir": { type: "string" },
25
+ "check-root": { type: "string" },
21
26
  check: {
22
27
  type: "string",
23
28
  multiple: true
@@ -32,7 +37,16 @@ if (values.help) {
32
37
  process.exit(0);
33
38
  }
34
39
  const root = resolve(values.root ?? process.cwd());
35
- const deps = createNodePrdDeps(root, { verifyCompletion: createScriptVerifier(root, values.check) });
40
+ const checkRoot = resolve(values["check-root"] ?? root);
41
+ const prdsDir = values["prds-dir"];
42
+ if (prdsDir !== void 0 && !prdsDir.trim()) {
43
+ process.stderr.write("Missing directory for --prds-dir.\n");
44
+ process.exit(1);
45
+ }
46
+ const deps = createNodePrdDeps(root, {
47
+ prdsDir,
48
+ verifyCompletion: createScriptVerifier(checkRoot, values.check)
49
+ });
36
50
  const { version } = JSON.parse(readFileSync(new URL("./package.json", import.meta.url), "utf8"));
37
51
  const server = new McpServer({
38
52
  name: "makerkit-prd",
@@ -40,5 +54,4 @@ const server = new McpServer({
40
54
  });
41
55
  registerPRDTools(server, createPrdService(deps));
42
56
  await server.connect(new StdioServerTransport());
43
- //#endregion
44
57
  export {};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@makerkit/prd-mcp",
3
- "version": "0.0.2",
3
+ "version": "0.0.3",
4
4
  "description": "MCP server for structured PRDs in .prds/. Lets Claude Code, Codex, OpenCode and other agents read and update PRDs and stories.",
5
5
  "keywords": [
6
6
  "ai-agents",
@@ -21,7 +21,7 @@
21
21
  },
22
22
  "type": "module",
23
23
  "dependencies": {
24
- "@makerkit/prd": "^0.0.3",
25
- "@modelcontextprotocol/sdk": "^1.32.0"
24
+ "@makerkit/prd": "^0.0.5",
25
+ "@modelcontextprotocol/sdk": "^1.32.2"
26
26
  }
27
27
  }