@miadi/stateloom-mcp 0.1.1

package/dist/tests/projectSwitch.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/projectSwitch.test.js

@@ -0,0 +1,41 @@
+/**
+ * Path power (HANDOFF v2, Phase 2 deliverable 1): the pure logic behind the
+ * `set_project_file` MCP tool. An agent may point the loom at any `.json`
+ * document path; the switch must absolute-resolve the path, report whether a
+ * file is already there (missing is legitimate — create_state_machine writes
+ * it next), and refuse non-JSON paths outright.
+ */
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { mkdtempSync, writeFileSync, rmSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { tmpdir } from "node:os";
+import { resolveProjectSwitch } from "../projectSwitch.js";
+test("projectSwitch: relative path resolves absolute and previous is carried", () => {
+    const r = resolveProjectSwitch("./some/machine.smdf.json", "/prev/doc.smdf.json");
+    assert.equal(r.path, resolve("./some/machine.smdf.json"));
+    assert.equal(r.previous, "/prev/doc.smdf.json");
+    assert.equal(r.exists, false);
+});
+test("projectSwitch: reports exists=true for a file already on disk", () => {
+    const dir = mkdtempSync(join(tmpdir(), "loom-switch-"));
+    const file = join(dir, "episode.smdf.json");
+    writeFileSync(file, JSON.stringify({ stateMachine: { settings: {}, events: [], state: { name: "Root" } } }));
+    try {
+        const r = resolveProjectSwitch(file, "/prev/doc.smdf.json");
+        assert.equal(r.path, file);
+        assert.equal(r.exists, true);
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+});
+test("projectSwitch: refuses a non-.json path", () => {
+    assert.throws(() => resolveProjectSwitch("/tmp/machine.yaml", "/prev/doc.smdf.json"), /\.json/);
+});
+test("projectSwitch: switching to the same path is allowed and reports it", () => {
+    const r = resolveProjectSwitch("/prev/doc.smdf.json", "/prev/doc.smdf.json");
+    assert.equal(r.path, "/prev/doc.smdf.json");
+    assert.equal(r.previous, "/prev/doc.smdf.json");
+    assert.equal(r.unchanged, true);
+});

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@miadi/stateloom-mcp",
+  "version": "0.1.1",
+  "description": "MCP server for miadi-stateloom (formerly smcraft-mcp) — lets LLM agents design state machines through conversation",
+  "type": "module",
+  "main": "dist/server.js",
+  "bin": {
+    "stateloom-mcp": "dist/server.js",
+    "smcraft-mcp": "dist/server.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "test": "node --test dist/tests/*.test.js"
+  },
+  "dependencies": {
+    "@miadi/stateloom-client": "^0.1.0",
+    "@miadi/stateloom-protocol": "^0.1.1",
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.13",
+    "typescript": "^5.7.0"
+  }
+}

package/src/projectSwitch.ts

@@ -0,0 +1,32 @@
+/**
+ * Pure logic behind the `set_project_file` MCP tool (path power — the agent
+ * chooses which `.smdf.json` document the loom weaves).
+ */
+import { existsSync } from "fs";
+import { resolve } from "path";
+
+export interface SwitchResult {
+  /** Absolute path of the newly active document. */
+  path: string;
+  /** The previously active absolute path. */
+  previous: string;
+  /** Whether a file already exists at the new path (missing is fine). */
+  exists: boolean;
+  /** True when the new path equals the previous one. */
+  unchanged: boolean;
+}
+
+export function resolveProjectSwitch(next: string, previous: string): SwitchResult {
+  const path = resolve(next);
+  if (!path.endsWith(".json")) {
+    throw new Error(
+      `project file must be a .json document (got '${path}') — the loom weaves .smdf.json files`,
+    );
+  }
+  return {
+    path,
+    previous,
+    exists: existsSync(path),
+    unchanged: path === previous,
+  };
+}