@popmelt.com/core 0.21.1 → 0.22.1

package/claude-plugin/scripts/locate-cli.mjs

@@ -0,0 +1,44 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, parse, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+export function locatePopmeltCli(start = process.cwd()) {
+  try {
+    const runtimePath = join(dirname(fileURLToPath(import.meta.url)), '..', 'runtime.json');
+    const runtime = JSON.parse(readFileSync(runtimePath, 'utf8'));
+    if (typeof runtime.cliPath === 'string' && existsSync(runtime.cliPath)) {
+      return { command: process.execPath, prefix: [runtime.cliPath] };
+    }
+  } catch {
+    // Source checkouts do not have an installed-runtime pointer yet.
+  }
+  // Prefer the package that supplied this plugin when loaded with --plugin-dir.
+  const packaged = join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'dist', 'cli.mjs');
+  if (existsSync(packaged)) return { command: process.execPath, prefix: [packaged] };
+  let current = resolve(start);
+  const root = parse(current).root;
+  while (true) {
+    const candidates = [
+      join(current, 'node_modules', '@popmelt.com', 'core', 'dist', 'cli.mjs'),
+      join(current, 'packages', 'popmelt', 'dist', 'cli.mjs'),
+    ];
+    for (const candidate of candidates) {
+      if (existsSync(candidate)) return { command: process.execPath, prefix: [candidate] };
+    }
+    const packagePath = join(current, 'package.json');
+    if (existsSync(packagePath)) {
+      try {
+        const pkg = JSON.parse(readFileSync(packagePath, 'utf8'));
+        if (pkg.name === '@popmelt.com/core') {
+          const local = join(current, 'dist', 'cli.mjs');
+          if (existsSync(local)) return { command: process.execPath, prefix: [local] };
+        }
+      } catch {
+        // Ignore malformed package metadata and continue searching upward.
+      }
+    }
+    if (current === root) break;
+    current = dirname(current);
+  }
+  return { command: 'popmelt', prefix: [] };
+}

package/claude-plugin/scripts/mcp.mjs

@@ -0,0 +1,13 @@
+import { spawn } from 'node:child_process';
+import { locatePopmeltCli } from './locate-cli.mjs';
+import { pluginEnvironment } from './environment.mjs';
+
+const cli = locatePopmeltCli();
+const child = spawn(cli.command, [...cli.prefix, 'claude', 'mcp'], {
+  cwd: process.cwd(), env: pluginEnvironment(), stdio: 'inherit',
+});
+child.on('error', () => process.exit(1));
+child.on('exit', (code, signal) => {
+  if (signal) process.kill(process.pid, signal);
+  else process.exit(code ?? 1);
+});

package/claude-plugin/skills/popmelt-core/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: popmelt-core
+description: Use Popmelt Core when the user asks to inspect project memory, expand relevant product context, review a surfaced decision candidate, ground a surfaced Imprint explanation, or discuss the current Popmelt thread.
+---
+
+# Popmelt Core
+
+Popmelt pairs the current Claude Code conversation with a durable project thread. Ambient hooks already retrieve context and capture ordinary turns, so do not call tools merely to announce or duplicate that automatic work.
+
+Use the tools deliberately:
+
+- Pass the exact `tool session` ID supplied by the Ambient Popmelt Core context as `sessionId` on every tool call. This routes the call to the correct project even when the MCP process has a different working directory.
+
+- Use `popmelt_orient_stores` only after the human explicitly chooses the writable primary store and any mounted read stores from an ambient orientation packet. Save that choice as the workspace default unless the human explicitly requests a session-only override. Store proximity, nesting, size, or recency never implies that choice.
+- Use `popmelt_expand_context` when the automatically supplied packet is truncated or the user explicitly asks for broader history.
+- Use `popmelt_inspect_thread` when the user asks to inspect the paired thread or its evidence.
+- Use `popmelt_review_decision` only after the human explicitly resolves the exact surfaced candidate. Preserve the actions `accept`, `edit_and_accept`, `reject`, and `defer`. Never infer acceptance from implementation, praise, silence, or ambiguity.
+- Use `popmelt_ground_imprint` only after the human explicitly answers a surfaced grounding question. Preserve the actions `yes`, `this_time`, and `no`.
+- Use `popmelt_assess_turn` only when the current collaboration changed reusable shared understanding. Ordinary completion and tool evidence are captured automatically.
+
+Accepted product decisions are authoritative within scope. Imprint explanations are provisional and advisory. The human remains the authority for both decision acceptance and Imprint grounding.
+
+If Popmelt reports `already_managed_by_bridge`, stop calling Popmelt Core tools for that run; the toolbar bridge owns the turn lifecycle.

package/codex-plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "popmelt-core",
-  "version": "0.21.1",
+  "version": "0.22.1",
   "description": "Point out what you mean, talk through changes, and keep your AI on the same page.",
   "author": {
     "name": "Popmelt",