@archrad/deterministic 0.1.4 → 0.1.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archrad/deterministic",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "A deterministic compiler and linter for system architecture. Validate your architecture before you write code. OSS: structural validation + basic architecture lint (rule-based); FastAPI/Express export; OpenAPI document-shape; golden Docker/Makefile — no LLM.",
   "keywords": [
     "archrad",
@@ -14,7 +14,9 @@
     "deterministic",
     "codegen",
     "docker",
-    "cli"
+    "cli",
+    "mcp",
+    "model-context-protocol"
   ],
   "homepage": "https://github.com/archradhq/arch-deterministic#readme",
   "bugs": {
@@ -39,7 +41,8 @@
     }
   },
   "bin": {
-    "archrad": "./dist/cli.js"
+    "archrad": "./dist/cli.js",
+    "archrad-mcp": "./dist/mcp-server.js"
   },
   "files": [
     "dist",
@@ -64,19 +67,22 @@
     "test": "tsc -p tsconfig.build.json --noEmit && vitest run",
     "lint": "biome check ./src",
     "typecheck": "tsc -p tsconfig.build.json --noEmit",
+    "smoke:mcp": "node scripts/smoke-mcp.mjs",
     "record:demo:payment-retry": "vhs scripts/record-demo-payment-retry.tape",
     "record:demo:drift": "vhs scripts/record-demo-drift.tape"
   },
   "dependencies": {
-    "commander": "^12.1.0",
-    "js-yaml": "^4.1.0"
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "commander": "^14.0.3",
+    "js-yaml": "^4.1.0",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@biomejs/biome": "^1.9.4",
+    "@biomejs/biome": "^2.4.9",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^20.19.0",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.15"
+    "@types/node": "^25.5.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
   },
   "engines": {
     "node": ">=20"

package/scripts/npm-postinstall.mjs

@@ -0,0 +1,22 @@
+/**
+ * Optional install notice (not wired from package.json by default).
+ * Skipped in CI and silent installs. Enable only if you want a local console line on `npm install`.
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const root = join(__dirname, '..');
+
+if (process.env.CI === 'true' || process.env.GITHUB_ACTIONS === 'true' || process.env.GITLAB_CI === 'true') {
+  process.exit(0);
+}
+if (process.env.npm_config_loglevel === 'silent') {
+  process.exit(0);
+}
+
+const pkg = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
+const v = pkg.version;
+const url = `https://archrad.com/docs/drift?ref=npm-${encodeURIComponent(v)}`;
+console.log(`\n  ${pkg.name}@${v} — Drift in CI (docs only; no package telemetry): ${url}\n`);

package/scripts/smoke-mcp.mjs

@@ -0,0 +1,44 @@
+/**
+ * Local MCP smoke test: spawns archrad-mcp, lists tools, calls archrad_suggest_fix.
+ * Run from package root: npm run build && npm run smoke:mcp
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const root = join(__dirname, '..');
+const serverJs = join(root, 'dist', 'mcp-server.js');
+
+const transport = new StdioClientTransport({
+  command: process.execPath,
+  args: [serverJs],
+  cwd: root,
+});
+
+const client = new Client({ name: 'archrad-smoke', version: '0.0.0' });
+await client.connect(transport);
+
+const { tools } = await client.listTools();
+const names = tools.map((t) => t.name).sort();
+console.log('Tools (%d):', names.length, names.join(', '));
+
+if (!names.includes('archrad_suggest_fix')) {
+  console.error('FAIL: archrad_suggest_fix not registered');
+  process.exitCode = 1;
+} else {
+  const r = await client.callTool({
+    name: 'archrad_suggest_fix',
+    arguments: { findingCode: 'IR-LINT-MISSING-AUTH-010' },
+  });
+  const text = r.content?.[0]?.text;
+  if (!text || !text.includes('IR-LINT-MISSING-AUTH-010')) {
+    console.error('FAIL: unexpected suggest_fix response', r);
+    process.exitCode = 1;
+  } else {
+    console.log('archrad_suggest_fix OK (snippet):', text.slice(0, 200).replace(/\n/g, ' '), '…');
+  }
+}
+
+await client.close();