nimai-mcp 0.1.0

package/dist/contract.d.ts

@@ -0,0 +1,118 @@
+/**
+ * FORGE MCP Tool Contract — v1
+ *
+ * All tool schemas are defined and locked here before server implementation.
+ * Do NOT change tool names or output shapes without a contract version bump.
+ *
+ * Adversarial review notes (stress-tested before locking):
+ * - Tool names prefixed with "nimai_" to avoid collisions with host tool namespaces
+ * - All inputs validated with zod to prevent runtime shape errors
+ * - Outputs are plain serialisable objects (no class instances, no Buffers)
+ * - No LLM calls inside any tool — tools return context/structure only
+ * - specPath / repoPath are absolute or relative to cwd; server does NOT resolve ~
+ * - outputPath for nimai_new: parent directory is created if missing; write errors surface as tool errors
+ */
+import { z } from 'zod';
+import type { LintIssue, ContextItem } from 'nimai-core';
+export declare const ForgeSpecInput: z.ZodObject<{
+    repoPath: z.ZodString;
+    request: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    repoPath: string;
+    request: string;
+}, {
+    repoPath: string;
+    request: string;
+}>;
+export declare const ForgeReviewInput: z.ZodObject<{
+    specPath: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    specPath: string;
+}, {
+    specPath: string;
+}>;
+export declare const ForgeValidateInput: z.ZodObject<{
+    specPath: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    specPath: string;
+}, {
+    specPath: string;
+}>;
+export declare const ForgeNewInput: z.ZodObject<{
+    outputPath: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    outputPath: string;
+}, {
+    outputPath: string;
+}>;
+export interface ForgeSpecOutput {
+    /** The populated FORGE Prompt 1 (Self-Spec Agent), ready to pass to a model */
+    prompt: string;
+    /** Repo context items extracted for the request */
+    context: ContextItem[];
+}
+export interface ForgeReviewOutput {
+    /** The populated FORGE Prompt 2 (Reviewer/Validator), derived from the spec */
+    reviewerPrompt: string;
+}
+export interface ForgeValidateOutput {
+    issues: LintIssue[];
+    /** true if zero issues found */
+    passed: boolean;
+}
+export interface ForgeNewOutput {
+    /** Absolute path where the spec file was written */
+    path: string;
+    /** Content written to the file */
+    content: string;
+}
+export declare const TOOL_DESCRIPTORS: {
+    readonly nimai_spec: {
+        readonly name: "nimai_spec";
+        readonly description: string;
+        readonly inputSchema: z.ZodObject<{
+            repoPath: z.ZodString;
+            request: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            repoPath: string;
+            request: string;
+        }, {
+            repoPath: string;
+            request: string;
+        }>;
+    };
+    readonly nimai_review: {
+        readonly name: "nimai_review";
+        readonly description: string;
+        readonly inputSchema: z.ZodObject<{
+            specPath: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            specPath: string;
+        }, {
+            specPath: string;
+        }>;
+    };
+    readonly nimai_validate: {
+        readonly name: "nimai_validate";
+        readonly description: string;
+        readonly inputSchema: z.ZodObject<{
+            specPath: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            specPath: string;
+        }, {
+            specPath: string;
+        }>;
+    };
+    readonly nimai_new: {
+        readonly name: "nimai_new";
+        readonly description: "Scaffolds a new FORGE spec file from the canonical template at the specified output path.";
+        readonly inputSchema: z.ZodObject<{
+            outputPath: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            outputPath: string;
+        }, {
+            outputPath: string;
+        }>;
+    };
+};
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +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;AAIH,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;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,gCAAgC;IAChC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BnB,CAAC"}

package/dist/contract.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * FORGE MCP Tool Contract — v1
+ *
+ * All tool schemas are defined and locked here before server implementation.
+ * Do NOT change tool names or output shapes without a contract version bump.
+ *
+ * Adversarial review notes (stress-tested before locking):
+ * - Tool names prefixed with "nimai_" to avoid collisions with host tool namespaces
+ * - All inputs validated with zod to prevent runtime shape errors
+ * - Outputs are plain serialisable objects (no class instances, no Buffers)
+ * - No LLM calls inside any tool — tools return context/structure only
+ * - specPath / repoPath are absolute or relative to cwd; server does NOT resolve ~
+ * - outputPath for nimai_new: parent directory is created if missing; write errors surface as tool errors
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_DESCRIPTORS = exports.ForgeNewInput = exports.ForgeValidateInput = exports.ForgeReviewInput = exports.ForgeSpecInput = void 0;
+const zod_1 = require("zod");
+// ─── Input Schemas ────────────────────────────────────────────────────────────
+exports.ForgeSpecInput = zod_1.z.object({
+    repoPath: zod_1.z.string().describe('Absolute path to the repository root'),
+    request: zod_1.z.string().min(1).describe('The loose request to turn into a spec prompt'),
+});
+exports.ForgeReviewInput = zod_1.z.object({
+    specPath: zod_1.z.string().describe('Path to the approved spec markdown file'),
+});
+exports.ForgeValidateInput = zod_1.z.object({
+    specPath: zod_1.z.string().describe('Path to the spec markdown file to lint'),
+});
+exports.ForgeNewInput = zod_1.z.object({
+    outputPath: zod_1.z.string().describe('Path where the new spec file should be written'),
+});
+// ─── Tool Descriptors (used to register tools in the MCP server) ──────────────
+exports.TOOL_DESCRIPTORS = {
+    nimai_spec: {
+        name: 'nimai_spec',
+        description: 'Returns a populated FORGE Self-Spec Agent prompt (Prompt 1) plus extracted repo context. ' +
+            'The host model uses this bundle to generate a draft spec — no LLM call is made inside this tool.',
+        inputSchema: exports.ForgeSpecInput,
+    },
+    nimai_review: {
+        name: 'nimai_review',
+        description: 'Returns a populated FORGE Reviewer/Validator prompt (Prompt 2) derived from an approved spec file. ' +
+            'The host model uses this to validate agent output against the spec.',
+        inputSchema: exports.ForgeReviewInput,
+    },
+    nimai_validate: {
+        name: 'nimai_validate',
+        description: 'Lints a spec file for unresolved placeholder fields (___), [NEEDS HUMAN INPUT] flags, ' +
+            'and missing required sections. Returns structured issues and a pass/fail result.',
+        inputSchema: exports.ForgeValidateInput,
+    },
+    nimai_new: {
+        name: 'nimai_new',
+        description: 'Scaffolds a new FORGE spec file from the canonical template at the specified output path.',
+        inputSchema: exports.ForgeNewInput,
+    },
+};
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +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,QAAQ,CAAC,gDAAgD,CAAC;CAClF,CAAC,CAAC;AA6BH,iFAAiF;AAEpE,QAAA,gBAAgB,GAAG;IAC9B,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,2FAA2F;YAC3F,kGAAkG;QACpG,WAAW,EAAE,sBAAc;KAC5B;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,qGAAqG;YACrG,qEAAqE;QACvE,WAAW,EAAE,wBAAgB;KAC9B;IACD,cAAc,EAAE;QACd,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,wFAAwF;YACxF,kFAAkF;QACpF,WAAW,EAAE,0BAAkB;KAChC;IACD,SAAS,EAAE;QACT,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,2FAA2F;QAC7F,WAAW,EAAE,qBAAa;KAC3B;CACO,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+export { FORGE_ROOT } from './prompts';
+export { createServer, startServer } from './server';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startServer = exports.createServer = exports.FORGE_ROOT = void 0;
+var prompts_1 = require("./prompts");
+Object.defineProperty(exports, "FORGE_ROOT", { enumerable: true, get: function () { return prompts_1.FORGE_ROOT; } });
+var server_1 = require("./server");
+Object.defineProperty(exports, "createServer", { enumerable: true, get: function () { return server_1.createServer; } });
+Object.defineProperty(exports, "startServer", { enumerable: true, get: function () { return server_1.startServer; } });
+// Start server when run directly
+if (require.main === module) {
+    const { startServer: start } = require('./server');
+    start().catch((err) => {
+        console.error('Nimai MCP server failed to start:', err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;AACA,qCAAuC;AAA9B,qGAAA,UAAU,OAAA;AACnB,mCAAqD;AAA5C,sGAAA,YAAY,OAAA;AAAE,qGAAA,WAAW,OAAA;AAElC,iCAAiC;AACjC,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACnD,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;QAC3B,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,GAAG,CAAC,CAAC;QACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,2 @@
+export declare const FORGE_ROOT: string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,UAAU,QAAkB,CAAC"}

package/dist/prompts.js

@@ -0,0 +1,56 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FORGE_ROOT = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Locate the FORGE docs root by walking up from __dirname until we find
+ * FORGE-quickref.md. Works regardless of where the package is installed.
+ */
+function findForgeRoot() {
+    let dir = __dirname;
+    for (let i = 0; i < 10; i++) {
+        if (fs.existsSync(path.join(dir, 'FORGE-quickref.md')))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    throw new Error('Cannot locate FORGE-quickref.md. Ensure the FORGE docs are present at the repo root.');
+}
+exports.FORGE_ROOT = findForgeRoot();
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAE7B;;;GAGG;AACH,SAAS,aAAa;IACpB,IAAI,GAAG,GAAG,SAAS,CAAC;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QACnE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,MAAM,IAAI,KAAK,CACb,sFAAsF,CACvF,CAAC;AACJ,CAAC;AAEY,QAAA,UAAU,GAAG,aAAa,EAAE,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export declare function createServer(): Server;
+export declare function startServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAYnE,wBAAgB,YAAY,IAAI,MAAM,CAkErC;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAIjD"}

package/dist/server.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createServer = createServer;
+exports.startServer = startServer;
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const contract_1 = require("./contract");
+const spec_1 = require("./tools/spec");
+const review_1 = require("./tools/review");
+const validate_1 = require("./tools/validate");
+const new_1 = require("./tools/new");
+function createServer() {
+    const server = new index_js_1.Server({ name: 'nimai', version: '0.1.0' }, { capabilities: { tools: {} } });
+    server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
+        tools: Object.values(contract_1.TOOL_DESCRIPTORS).map(descriptor => ({
+            name: descriptor.name,
+            description: descriptor.description,
+            inputSchema: {
+                type: 'object',
+                properties: Object.fromEntries(Object.entries(descriptor.inputSchema.shape).map(([key, schema]) => [
+                    key,
+                    { type: 'string', description: schema.description ?? '' },
+                ])),
+                required: Object.keys(descriptor.inputSchema.shape),
+            },
+        })),
+    }));
+    server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            let result;
+            switch (name) {
+                case 'nimai_spec': {
+                    const input = contract_1.ForgeSpecInput.parse(args);
+                    result = await (0, spec_1.toolSpec)(input);
+                    break;
+                }
+                case 'nimai_review': {
+                    const input = contract_1.ForgeReviewInput.parse(args);
+                    result = await (0, review_1.toolReview)(input);
+                    break;
+                }
+                case 'nimai_validate': {
+                    const input = contract_1.ForgeValidateInput.parse(args);
+                    result = await (0, validate_1.toolValidate)(input);
+                    break;
+                }
+                case 'nimai_new': {
+                    const input = contract_1.ForgeNewInput.parse(args);
+                    result = await (0, new_1.toolNew)(input);
+                    break;
+                }
+                default:
+                    throw new Error(`Unknown tool: ${name}`);
+            }
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Error: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+async function startServer() {
+    const server = createServer();
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/new.d.ts

@@ -0,0 +1,4 @@
+import { ForgeNewInput, ForgeNewOutput } from '../contract';
+import { z } from 'zod';
+export declare function toolNew(input: z.infer<typeof ForgeNewInput>): Promise<ForgeNewOutput>;
+//# sourceMappingURL=new.d.ts.map

package/dist/tools/new.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../src/tools/new.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wBAAsB,OAAO,CAC3B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,GACnC,OAAO,CAAC,cAAc,CAAC,CAYzB"}

package/dist/tools/new.js

@@ -0,0 +1,52 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolNew = toolNew;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const nimai_core_1 = require("nimai-core");
+const prompts_1 = require("../prompts");
+async function toolNew(input) {
+    const templatePath = path.join(prompts_1.FORGE_ROOT, 'FORGE-spec-template.md');
+    const template = (0, nimai_core_1.loadTemplate)(templatePath);
+    const outputPath = path.resolve(input.outputPath);
+    const dir = path.dirname(outputPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(outputPath, template.raw, 'utf-8');
+    return { path: outputPath, content: template.raw };
+}
+//# sourceMappingURL=new.js.map

package/dist/tools/new.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"new.js","sourceRoot":"","sources":["../../src/tools/new.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,0BAcC;AArBD,uCAAyB;AACzB,2CAA6B;AAC7B,2CAA0C;AAE1C,wCAAwC;AAGjC,KAAK,UAAU,OAAO,CAC3B,KAAoC;IAEpC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,oBAAU,EAAE,wBAAwB,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,IAAA,yBAAY,EAAC,YAAY,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAElD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACpD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC;AACrD,CAAC"}

package/dist/tools/review.d.ts

@@ -0,0 +1,4 @@
+import { ForgeReviewInput, ForgeReviewOutput } from '../contract';
+import { z } from 'zod';
+export declare function toolReview(input: z.infer<typeof ForgeReviewInput>): Promise<ForgeReviewOutput>;
+//# sourceMappingURL=review.d.ts.map

package/dist/tools/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/tools/review.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wBAAsB,UAAU,CAC9B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,GACtC,OAAO,CAAC,iBAAiB,CAAC,CAW5B"}

package/dist/tools/review.js

@@ -0,0 +1,51 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolReview = toolReview;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const nimai_core_1 = require("nimai-core");
+async function toolReview(input) {
+    const specPath = path.resolve(input.specPath);
+    let specContent;
+    try {
+        specContent = fs.readFileSync(specPath, 'utf-8');
+    }
+    catch (err) {
+        throw new Error(`Cannot read spec at "${specPath}": ${err.message}`);
+    }
+    return { reviewerPrompt: (0, nimai_core_1.buildPrompt2)(specContent) };
+}
+//# sourceMappingURL=review.js.map

package/dist/tools/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/tools/review.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,gCAaC;AAnBD,uCAAyB;AACzB,2CAA6B;AAC7B,2CAA0C;AAInC,KAAK,UAAU,UAAU,CAC9B,KAAuC;IAEvC,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;IACD,OAAO,EAAE,cAAc,EAAE,IAAA,yBAAY,EAAC,WAAW,CAAC,EAAE,CAAC;AACvD,CAAC"}

package/dist/tools/spec.d.ts

@@ -0,0 +1,4 @@
+import { ForgeSpecInput, ForgeSpecOutput } from '../contract';
+import { z } from 'zod';
+export declare function toolSpec(input: z.infer<typeof ForgeSpecInput>): Promise<ForgeSpecOutput>;
+//# sourceMappingURL=spec.d.ts.map

package/dist/tools/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/tools/spec.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,GACpC,OAAO,CAAC,eAAe,CAAC,CAW1B"}

package/dist/tools/spec.js

@@ -0,0 +1,48 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolSpec = toolSpec;
+const path = __importStar(require("path"));
+const nimai_core_1 = require("nimai-core");
+async function toolSpec(input) {
+    const repoPath = path.resolve(input.repoPath);
+    const context = (0, nimai_core_1.extractContext)(repoPath, input.request);
+    const contextSummary = context
+        .map(item => `[${item.file}]\n${item.snippet}`)
+        .join('\n\n---\n\n');
+    const prompt = (0, nimai_core_1.buildPrompt1)(input.request, contextSummary);
+    return { prompt, context };
+}
+//# sourceMappingURL=spec.js.map

package/dist/tools/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../src/tools/spec.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKA,4BAaC;AAlBD,2CAA6B;AAC7B,2CAA0D;AAInD,KAAK,UAAU,QAAQ,CAC5B,KAAqC;IAErC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAA,2BAAc,EAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAExD,MAAM,cAAc,GAAG,OAAO;SAC3B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;SAC9C,IAAI,CAAC,aAAa,CAAC,CAAC;IAEvB,MAAM,MAAM,GAAG,IAAA,yBAAY,EAAC,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAE3D,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC"}

package/dist/tools/validate.d.ts

@@ -0,0 +1,4 @@
+import { ForgeValidateInput, ForgeValidateOutput } from '../contract';
+import { z } from 'zod';
+export declare function toolValidate(input: z.infer<typeof ForgeValidateInput>): Promise<ForgeValidateOutput>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/tools/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/tools/validate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wBAAsB,YAAY,CAChC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GACxC,OAAO,CAAC,mBAAmB,CAAC,CAG9B"}

package/dist/tools/validate.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolValidate = toolValidate;
+const nimai_core_1 = require("nimai-core");
+async function toolValidate(input) {
+    const issues = (0, nimai_core_1.lintSpec)(input.specPath);
+    return { issues, passed: issues.length === 0 };
+}
+//# sourceMappingURL=validate.js.map

package/dist/tools/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/tools/validate.ts"],"names":[],"mappings":";;AAIA,oCAKC;AATD,2CAAsC;AAI/B,KAAK,UAAU,YAAY,CAChC,KAAyC;IAEzC,MAAM,MAAM,GAAG,IAAA,qBAAQ,EAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;AACjD,CAAC"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "nimai-mcp",
+  "version": "0.1.0",
+  "description": "Nimai MCP server — exposes nimai_spec, nimai_review, nimai_validate, nimai_new as tools. No internal LLM calls.",
+  "keywords": ["nimai", "forge", "mcp", "model-context-protocol", "ai", "llm", "specification", "claude", "codex"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Balagopalaji/nimai.git",
+    "directory": "packages/mcp"
+  },
+  "files": ["dist/"],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "nimai-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.4.5",
+    "vitest": "^1.6.0"
+  },
+  "dependencies": {
+    "nimai-core": "workspace:*",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.8"
+  }
+}