nimai-mcp 0.3.5 → 0.3.7
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/dist/contract.d.ts
CHANGED
|
@@ -88,10 +88,14 @@ export interface ForgeNewOutput {
|
|
|
88
88
|
export interface ForgeSpecReviewOutput {
|
|
89
89
|
/**
|
|
90
90
|
* FORGE Prompt 1.5 — Spec-Quality Reviewer prompt.
|
|
91
|
-
*
|
|
92
|
-
* containing {passed: boolean, issues: string[]}.
|
|
91
|
+
* Must be evaluated by an independent reviewer — NOT the agent that created the spec.
|
|
93
92
|
*/
|
|
94
93
|
specReviewerPrompt: string;
|
|
94
|
+
/**
|
|
95
|
+
* Ready-to-display instructions for the user on how to complete the independent review.
|
|
96
|
+
* The agent should present this to the user verbatim and wait for them to return the verdict.
|
|
97
|
+
*/
|
|
98
|
+
reviewer_instructions: string;
|
|
95
99
|
}
|
|
96
100
|
export declare const TOOL_DESCRIPTORS: {
|
|
97
101
|
readonly nimai_spec: {
|
package/dist/contract.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAIzD,eAAO,MAAM,cAAc;;;;;;;;;EAGzB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;EAE3B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;EAE7B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;EAExB,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;EAE/B,CAAC;AAIH,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB;;;;OAIG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,oDAAoD;IACpD,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC
|
|
1
|
+
{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAIzD,eAAO,MAAM,cAAc;;;;;;;;;EAGzB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;EAE3B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;EAE7B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;EAExB,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;EAE/B,CAAC;AAIH,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB;;;;OAIG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,oDAAoD;IACpD,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAID,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDnB,CAAC"}
|
package/dist/contract.js
CHANGED
|
@@ -66,14 +66,14 @@ exports.TOOL_DESCRIPTORS = {
|
|
|
66
66
|
},
|
|
67
67
|
nimai_spec_review: {
|
|
68
68
|
name: 'nimai_spec_review',
|
|
69
|
-
description: 'USE THIS BEFORE BUILDING: returns a Prompt 1.5 spec-quality reviewer. ' +
|
|
69
|
+
description: 'USE THIS BEFORE BUILDING: returns a Prompt 1.5 spec-quality reviewer prompt plus reviewer_instructions. ' +
|
|
70
70
|
'Only call this after nimai_validate passes. ' +
|
|
71
|
-
'
|
|
72
|
-
'
|
|
73
|
-
'
|
|
74
|
-
'
|
|
75
|
-
'
|
|
76
|
-
'If passed=false, fix the spec, re-run nimai_validate, then call this again. ' +
|
|
71
|
+
'CRITICAL: do NOT evaluate the specReviewerPrompt yourself. ' +
|
|
72
|
+
'The agent that built the spec must not be its own reviewer — this defeats the purpose of the review. ' +
|
|
73
|
+
'After calling this tool, present the reviewer_instructions to the user verbatim and stop. ' +
|
|
74
|
+
'The user will take the specReviewerPrompt to an independent reviewer (fresh session, different model). ' +
|
|
75
|
+
'Wait for the user to return the verdict block: {"passed": true/false, "schema_version": "2", "issues": [...]}. ' +
|
|
76
|
+
'If passed=false, fix the spec using the issues list, re-run nimai_validate, then call this again. ' +
|
|
77
77
|
'For reviewing an implementation against an approved spec, use nimai_review instead.',
|
|
78
78
|
inputSchema: exports.ForgeSpecReviewInput,
|
|
79
79
|
},
|
package/dist/contract.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAEH,6BAAwB;AAGxB,iFAAiF;AAEpE,QAAA,cAAc,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACrE,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;CACpF,CAAC,CAAC;AAEU,QAAA,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;CACzE,CAAC,CAAC;AAEU,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;CACxE,CAAC,CAAC;AAEU,QAAA,aAAa,GAAG,OAAC,CAAC,MAAM,CAAC;IACpC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gDAAgD,CAAC;CACzF,CAAC,CAAC;AAEU,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CAClF,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAEH,6BAAwB;AAGxB,iFAAiF;AAEpE,QAAA,cAAc,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACrE,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;CACpF,CAAC,CAAC;AAEU,QAAA,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;CACzE,CAAC,CAAC;AAEU,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;CACxE,CAAC,CAAC;AAEU,QAAA,aAAa,GAAG,OAAC,CAAC,MAAM,CAAC;IACpC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gDAAgD,CAAC;CACzF,CAAC,CAAC;AAEU,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CAClF,CAAC,CAAC;AAsDH,iFAAiF;AAEpE,QAAA,gBAAgB,GAAG;IAC9B,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,2FAA2F;YAC3F,+FAA+F;YAC/F,sFAAsF;YACtF,oHAAoH;YACpH,mEAAmE;YACnE,6DAA6D;QAC/D,WAAW,EAAE,sBAAc;KAC5B;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,8FAA8F;YAC9F,6CAA6C;YAC7C,2EAA2E;QAC7E,WAAW,EAAE,wBAAgB;KAC9B;IACD,cAAc,EAAE;QACd,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,wFAAwF;YACxF,oHAAoH;YACpH,6FAA6F;QAC/F,WAAW,EAAE,0BAAkB;KAChC;IACD,SAAS,EAAE;QACT,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,2FAA2F;QAC7F,WAAW,EAAE,qBAAa;KAC3B;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,0GAA0G;YAC1G,8CAA8C;YAC9C,6DAA6D;YAC7D,uGAAuG;YACvG,4FAA4F;YAC5F,yGAAyG;YACzG,iHAAiH;YACjH,oGAAoG;YACpG,qFAAqF;QACvF,WAAW,EAAE,4BAAoB;KAClC;CACO,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"spec-review.d.ts","sourceRoot":"","sources":["../../src/tools/spec-review.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wBAAsB,cAAc,CAClC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,GAC1C,OAAO,CAAC,qBAAqB,CAAC,
|
|
1
|
+
{"version":3,"file":"spec-review.d.ts","sourceRoot":"","sources":["../../src/tools/spec-review.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wBAAsB,cAAc,CAClC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,GAC1C,OAAO,CAAC,qBAAqB,CAAC,CAqDhC"}
|
|
@@ -46,6 +46,45 @@ async function toolSpecReview(input) {
|
|
|
46
46
|
catch (err) {
|
|
47
47
|
throw new Error(`Cannot read spec at "${specPath}": ${err.message}`);
|
|
48
48
|
}
|
|
49
|
-
|
|
49
|
+
const specReviewerPrompt = (0, nimai_core_1.buildPrompt15)(specContent);
|
|
50
|
+
const reviewer_instructions = [
|
|
51
|
+
'⚠️ INDEPENDENT REVIEW REQUIRED',
|
|
52
|
+
'',
|
|
53
|
+
'The spec-quality review must be done by an independent reviewer —',
|
|
54
|
+
'NOT the agent that created or edited the spec.',
|
|
55
|
+
'',
|
|
56
|
+
'── STEP 1: Send to independent reviewer ──────────────────────────',
|
|
57
|
+
'1. Copy the specReviewerPrompt string from this response.',
|
|
58
|
+
'2. Open a FRESH SESSION with a different model or agent',
|
|
59
|
+
' (e.g. paste into Claude, a new Codex thread, or any LLM).',
|
|
60
|
+
'3. Paste the prompt and let the reviewer evaluate the spec.',
|
|
61
|
+
'4. The reviewer will end their response with a JSON verdict block:',
|
|
62
|
+
' {"passed": true/false, "schema_version": "2", "issues": [...]}',
|
|
63
|
+
'',
|
|
64
|
+
'── STEP 2: Return the verdict ────────────────────────────────────',
|
|
65
|
+
'Bring the full verdict back to THIS session.',
|
|
66
|
+
'',
|
|
67
|
+
' If passed: true',
|
|
68
|
+
' → The spec is approved. Proceed to implementation.',
|
|
69
|
+
'',
|
|
70
|
+
' If passed: false',
|
|
71
|
+
' → Do NOT re-run nimai_spec (that would discard all spec work).',
|
|
72
|
+
` → Give the builder this message (fill in the verdict):`,
|
|
73
|
+
'',
|
|
74
|
+
` ┌─ BUILDER FIX BRIEF ──────────────────────────────────────────`,
|
|
75
|
+
` │ The independent spec review found issues in: ${specPath}`,
|
|
76
|
+
` │`,
|
|
77
|
+
` │ Fix each HARD_FAIL and SOFT_FAIL in the verdict below by`,
|
|
78
|
+
` │ editing the spec directly. Do not regenerate from scratch.`,
|
|
79
|
+
` │`,
|
|
80
|
+
` │ [PASTE VERDICT HERE]`,
|
|
81
|
+
` │`,
|
|
82
|
+
` │ After fixing:`,
|
|
83
|
+
` │ 1. Run nimai_validate — must return passed: true`,
|
|
84
|
+
` │ 2. Run nimai_spec_review — get new reviewer_instructions`,
|
|
85
|
+
` │ 3. Send to an independent reviewer again (do not self-review)`,
|
|
86
|
+
` └──────────────────────────────────────────────────────────────`,
|
|
87
|
+
].join('\n');
|
|
88
|
+
return { specReviewerPrompt, reviewer_instructions };
|
|
50
89
|
}
|
|
51
90
|
//# sourceMappingURL=spec-review.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"spec-review.js","sourceRoot":"","sources":["../../src/tools/spec-review.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,
|
|
1
|
+
{"version":3,"file":"spec-review.js","sourceRoot":"","sources":["../../src/tools/spec-review.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,wCAuDC;AA7DD,uCAAyB;AACzB,2CAA6B;AAC7B,2CAA2C;AAIpC,KAAK,UAAU,cAAc,CAClC,KAA2C;IAE3C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,WAAmB,CAAC;IACxB,IAAI,CAAC;QACH,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,wBAAwB,QAAQ,MAAO,GAA6B,CAAC,OAAO,EAAE,CAC/E,CAAC;IACJ,CAAC;IAED,MAAM,kBAAkB,GAAG,IAAA,0BAAa,EAAC,WAAW,CAAC,CAAC;IAEtD,MAAM,qBAAqB,GAAG;QAC5B,iCAAiC;QACjC,EAAE;QACF,mEAAmE;QACnE,gDAAgD;QAChD,EAAE;QACF,oEAAoE;QACpE,2DAA2D;QAC3D,yDAAyD;QACzD,8DAA8D;QAC9D,6DAA6D;QAC7D,oEAAoE;QACpE,mEAAmE;QACnE,EAAE;QACF,oEAAoE;QACpE,8CAA8C;QAC9C,EAAE;QACF,mBAAmB;QACnB,sDAAsD;QACtD,EAAE;QACF,oBAAoB;QACpB,kEAAkE;QAClE,0DAA0D;QAC1D,EAAE;QACF,mEAAmE;QACnE,oDAAoD,QAAQ,EAAE;QAC9D,KAAK;QACL,8DAA8D;QAC9D,gEAAgE;QAChE,KAAK;QACL,0BAA0B;QAC1B,KAAK;QACL,mBAAmB;QACnB,sDAAsD;QACtD,8DAA8D;QAC9D,mEAAmE;QACnE,mEAAmE;KACpE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,CAAC;AACvD,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "nimai-mcp",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.7",
|
|
4
4
|
"description": "Nimai MCP server — exposes nimai_spec, nimai_review, nimai_validate, nimai_new as tools. No internal LLM calls.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"nimai",
|
|
@@ -36,7 +36,7 @@
|
|
|
36
36
|
"dependencies": {
|
|
37
37
|
"@modelcontextprotocol/sdk": "^1.0.0",
|
|
38
38
|
"zod": "^3.23.8",
|
|
39
|
-
"nimai-core": "0.3.
|
|
39
|
+
"nimai-core": "0.3.7"
|
|
40
40
|
},
|
|
41
41
|
"scripts": {
|
|
42
42
|
"build": "tsc",
|