@massa-ai/cursor-plugin 1.59.0 → 1.60.1

package/.cursor-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "massa-ai",
-  "version": "1.59.0",
+  "version": "1.60.1",
   "description": "massa-ai — semantic code search, memory, and context compression for Cursor"
 }

package/hooks/massa-ai-hook

@@ -187,6 +187,93 @@ export function resolveHookApiKey(): string {
   return "";
 }
 
+// ── Session-start drift line (agent-runtime-drift T06) ─────────────────────
+
+/** Same XDG resolution as getHookConfigPath — duplicated for the same
+ *  dependency-freeze reason, pinned by tests on both sides. */
+export function getInstallStatePath(): string {
+  const xdg = process.env.XDG_CONFIG_HOME;
+  const base = xdg && xdg.trim() ? xdg : path.join(homedir(), ".config");
+  return path.join(base, "massa-ai", "install-state.json");
+}
+
+function readJsonAt(filePath: string): Record<string, unknown> | null {
+  try {
+    const parsed = JSON.parse(readFileSync(filePath, "utf8"));
+    return parsed && typeof parsed === "object" && !Array.isArray(parsed)
+      ? (parsed as Record<string, unknown>)
+      : null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Pinned one-key read (`^model:`) — deliberately NOT the shared frontmatter
+ * parser: this binary's dependency freeze (see getHookConfigPath) forbids
+ * importing @massa-ai/shared. The cross-side test pins this regex against the
+ * shared parser's output (spec INV B3), so the writer and this reader cannot
+ * silently disagree about what `model:` means.
+ */
+function readModelLine(filePath: string): string | null {
+  try {
+    const match = /^model:\s*(.+)\r?$/m.exec(readFileSync(filePath, "utf8"));
+    const value = match?.[1]?.trim();
+    return value ? value.replace(/^["']|["']$/g, "") : null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * The ≤2-line session-start drift report (agent-runtime-drift): version
+ * drift (live bundle vs recorded state), agent drift (active investigator
+ * model vs the recorded profile's variant), and the host env override that
+ * nullifies every per-agent model at runtime. Null when every recording
+ * agrees — silent when healthy. Read-only (INV5); every failure degrades to
+ * fewer lines, never a throw. The fix path is the existing profile switch,
+ * never the hook.
+ */
+export function buildSessionStartDoctorLine(
+  pluginRoot: string,
+  env: Readonly<Record<string, string | undefined>>,
+): string | null {
+  const lines: string[] = [];
+
+  const sourceVersion = readJsonAt(path.join(pluginRoot, ".claude-plugin", "plugin.json"))?.version;
+  const state = readJsonAt(getInstallStatePath());
+  const platforms = state?.platforms as Record<string, Record<string, unknown>> | undefined;
+  const claude = platforms?.claude;
+  const stateVersion = claude?.plugin?.version;
+  if (typeof sourceVersion === "string" && typeof stateVersion === "string" && sourceVersion !== stateVersion) {
+    lines.push(
+      `[massa-ai] version drift: live bundle ${sourceVersion} vs recorded ${stateVersion} — update the plugin or re-run the installer`,
+    );
+  }
+
+  const profile = claude?.modelProfile?.profile;
+  if (typeof profile === "string" && profile) {
+    const activeModel = readModelLine(path.join(pluginRoot, "agents", "massa-ai-investigator.md"));
+    const variantModel = readModelLine(
+      path.join(pluginRoot, "agent-profiles", profile, "massa-ai-investigator.md"),
+    );
+    if (activeModel && variantModel && activeModel !== variantModel) {
+      lines.push(
+        `[massa-ai] agent drift: investigator ${activeModel} vs ${profile} variant ${variantModel} — re-run the profile switch`,
+      );
+    }
+  }
+
+  const override = env.CLAUDE_CODE_SUBAGENT_MODEL;
+  if (typeof override === "string" && override.trim()) {
+    lines.push(
+      `[massa-ai] CLAUDE_CODE_SUBAGENT_MODEL=${override.trim()} overrides every per-agent model at runtime`,
+    );
+  }
+
+  return lines.length ? lines.slice(0, 2).join("\n") : null;
+}
+
 // ── POST helper ─────────────────────────────────────────────────────────────
 
 export function postObservation(
@@ -299,6 +386,17 @@ export async function main(stdinInput?: string): Promise<void> {
 
   const projectId = resolveProjectId(sessionId, cwd);
 
+  // agent-runtime-drift (T06): session-start prints a bounded drift line when
+  // the recordings disagree (read-only, silent when healthy — INV5).
+  if (subcommand === "session-start") {
+    try {
+      const doctorLine = buildSessionStartDoctorLine(path.resolve(import.meta.dirname, ".."), process.env);
+      if (doctorLine) process.stdout.write(doctorLine + "\n");
+    } catch {
+      // silent-degrade: drift reporting must never block the agent
+    }
+  }
+
   const baseUrl = process.env.MASSA_AI_API_BASE || "http://localhost:3333";
   const hookUrl = `${baseUrl}/api/v1/hook`;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@massa-ai/cursor-plugin",
-  "version": "1.59.0",
+  "version": "1.60.1",
   "description": "massa-ai plugin for Cursor — semantic code search, memory, and context compression",
   "files": [
     "agents",

package/skills/massa-ai/references/agent-orchestration.md

@@ -303,7 +303,7 @@ like every other dispatch.
 ```md
 🤖 [Agent Started] Investigator — model opus, effort high. Scope: the four emitters.
 🤖 [Agent Started] Designer — model/effort unknown (no installed agent file at
-   ~/.claude/plugins/cache/massa-ai/massa-ai/1.48.0/agents/massa-ai-designer.md). Dispatching anyway.
+   <liveRoot>/agents/massa-ai-designer.md). Dispatching anyway.
 ```
 
 That second line is a measured case, not a hypothetical: on a machine with plugin
@@ -316,7 +316,7 @@ this table so the two cannot drift silently:
 
 | Host | Installed agents directory | Glob | Model / effort keys |
 | --- | --- | --- | --- |
-| Claude — marketplace route | `<marketplaceRoot>/agents` — a *versioned* bundle root, e.g. `~/.claude/plugins/cache/massa-ai/massa-ai/1.48.0/agents` | `massa-ai-*.md` | `model:` / `effort:` |
+| Claude — marketplace route | `<marketplaceRoot>/agents`, where `<marketplaceRoot>` is `resolveClaudeMarketplaceInstall`'s live root: for a **directory-source** marketplace the host loads the plugin LIVE from the source bundle — e.g. `<repo>/apps/claude-plugin/agents`; for any other kind it is the *versioned* cache snapshot, e.g. `~/.claude/plugins/cache/massa-ai/massa-ai/1.48.0/agents` (a stale-able snapshot — never hardcode it; read `profile_list`'s `liveRoot`) | `massa-ai-*.md` | `model:` / `effort:` |
 | Claude — file route | `~/.claude/agents` | `massa-ai-*.md` | `model:` / `effort:` |
 | Codex | `~/.codex/agents` | `massa-ai-*.toml` | `model` / `model_reasoning_effort` |
 | OpenCode | `~/.config/opencode/agents` | `massa-ai-*.md` | `model:` / `reasoningEffort:` |