cmdr-mcp 0.1.0 → 0.1.1

package/plugins/cmdr/bin/cmdr-check.mjs

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+// Kept outside dist so a damaged runtime can still be inspected with Node alone.
+import { readFileSync, existsSync, lstatSync } from 'node:fs';
+import { resolve, join } from 'node:path';
+import { createHash } from 'node:crypto';
+const root = resolve(process.argv[2]);
+const errors = [];
+const read = (path) => JSON.parse(readFileSync(join(root, path), 'utf8'));
+let manifest;
+try {
+  manifest = read('dist/integrity.json');
+} catch {
+  errors.push(
+    'Missing or invalid dist/integrity.json; reinstall this plugin from the built npm package.',
+  );
+}
+const files = {};
+const required = [
+  'dist/cli.mjs',
+  'dist/mcp.mjs',
+  'dist/hook.mjs',
+  'dist/daemon.mjs',
+  'bin/cmdr',
+  'bin/cmdr-node',
+  'bin/cmdr-mcp',
+  'bin/cmdr-hook',
+  'bin/cmdr-daemon',
+  'bin/cmdr-check.mjs',
+  'hooks/hooks.json',
+  '.mcp.json',
+  '.claude-plugin/plugin.json',
+  '.codex-plugin/plugin.json',
+  '.zcode-plugin/plugin.json',
+];
+for (const path of new Set([...required, ...Object.keys(manifest?.files || {})])) {
+  if (
+    !required.includes(path) &&
+    !path.startsWith('skills/') &&
+    !path.startsWith('commands/') &&
+    path !== 'THIRD_PARTY_NOTICES.txt'
+  ) {
+    errors.push(`Unexpected manifest path: ${path}`);
+    continue;
+  }
+  if (path.split('/').some((part) => part === '..' || part === '')) {
+    errors.push('Invalid manifest path');
+    continue;
+  }
+  try {
+    const full = join(root, path);
+    const linked = path
+      .split('/')
+      .some((_, i, parts) => lstatSync(join(root, ...parts.slice(0, i + 1))).isSymbolicLink());
+    const digest = createHash('sha256').update(readFileSync(full)).digest('hex');
+    files[path] = !linked && manifest?.files?.[path] === digest;
+  } catch {
+    files[path] = false;
+  }
+  if (!files[path]) errors.push(`Missing, modified or linked asset: ${path}`);
+}
+const versions = {};
+for (const host of ['claude', 'codex', 'zcode']) {
+  try {
+    versions[host] = read(`.${host}-plugin/plugin.json`).version;
+    if (versions[host] !== manifest?.version) errors.push(`${host} version differs from build`);
+  } catch {
+    errors.push(`Invalid ${host} manifest`);
+  }
+}
+let hooks = {};
+try {
+  hooks = read('hooks/hooks.json').hooks;
+} catch {
+  errors.push('Invalid hooks configuration');
+}
+console.log(
+  JSON.stringify(
+    {
+      ok: errors.length === 0,
+      plugin_root: root,
+      version: manifest?.version,
+      node: process.version,
+      files,
+      versions,
+      hooks: {
+        configured: Object.keys(hooks || {}),
+        observed: 'unknown; configuration alone does not prove execution',
+      },
+      errors,
+      repair:
+        'npm install -g cmdr-mcp; register its package root, then refresh/reinstall the host plugin cache and start a new session. For a source checkout run npm ci && npm run build at repository root. Do not link dist from another installation.',
+    },
+    null,
+    2,
+  ),
+);
+process.exitCode = errors.length ? 1 : 0;

package/plugins/cmdr/bin/cmdr-daemon

@@ -1,4 +1,12 @@
 #!/bin/sh
-CMDR_BIN_DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+CMDR_SCRIPT=$0
+while [ -L "$CMDR_SCRIPT" ]; do
+  CMDR_LINK=$(readlink "$CMDR_SCRIPT") || exit 1
+  case "$CMDR_LINK" in
+    /*) CMDR_SCRIPT=$CMDR_LINK ;;
+    *) CMDR_SCRIPT=$(dirname -- "$CMDR_SCRIPT")/$CMDR_LINK ;;
+  esac
+done
+CMDR_BIN_DIR=$(CDPATH= cd -- "$(dirname -- "$CMDR_SCRIPT")" && pwd)
 export CMDR_BIN_DIR
 exec "$CMDR_BIN_DIR/cmdr-node" daemon "$@"

package/plugins/cmdr/bin/cmdr-hook

@@ -1,4 +1,12 @@
 #!/bin/sh
-CMDR_BIN_DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+CMDR_SCRIPT=$0
+while [ -L "$CMDR_SCRIPT" ]; do
+  CMDR_LINK=$(readlink "$CMDR_SCRIPT") || exit 1
+  case "$CMDR_LINK" in
+    /*) CMDR_SCRIPT=$CMDR_LINK ;;
+    *) CMDR_SCRIPT=$(dirname -- "$CMDR_SCRIPT")/$CMDR_LINK ;;
+  esac
+done
+CMDR_BIN_DIR=$(CDPATH= cd -- "$(dirname -- "$CMDR_SCRIPT")" && pwd)
 export CMDR_BIN_DIR
 exec "$CMDR_BIN_DIR/cmdr-node" hook "$@"

package/plugins/cmdr/bin/cmdr-mcp

@@ -1,4 +1,12 @@
 #!/bin/sh
-CMDR_BIN_DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+CMDR_SCRIPT=$0
+while [ -L "$CMDR_SCRIPT" ]; do
+  CMDR_LINK=$(readlink "$CMDR_SCRIPT") || exit 1
+  case "$CMDR_LINK" in
+    /*) CMDR_SCRIPT=$CMDR_LINK ;;
+    *) CMDR_SCRIPT=$(dirname -- "$CMDR_SCRIPT")/$CMDR_LINK ;;
+  esac
+done
+CMDR_BIN_DIR=$(CDPATH= cd -- "$(dirname -- "$CMDR_SCRIPT")" && pwd)
 export CMDR_BIN_DIR
 exec "$CMDR_BIN_DIR/cmdr-node" mcp "$@"

package/plugins/cmdr/bin/cmdr-node

@@ -3,6 +3,20 @@
 CMDR_ENTRY=$1
 shift
 CMDR_RUNTIME_HOME=${CMDR_HOME:-"$HOME/.cmdr"}
+cmdr_failure() {
+  # One fixed-size record per failure type, rate limited across hook processes.
+  (umask 077
+    CMDR_LOG_DIR="$CMDR_RUNTIME_HOME/logs/diagnostics"
+    mkdir -p "$CMDR_LOG_DIR" || exit 0
+    CMDR_LOG_FILE="$CMDR_LOG_DIR/bootstrap-$1.json"
+    CMDR_NOW=$(date +%s)
+    CMDR_LAST=$(cat "$CMDR_LOG_DIR/bootstrap-$1.time" 2>/dev/null || true)
+    case "$CMDR_LAST" in ''|*[!0-9]*) CMDR_LAST=0 ;; esac
+    [ $((CMDR_NOW - CMDR_LAST)) -lt 60 ] && exit 0
+    printf '%s\n' "$CMDR_NOW" > "$CMDR_LOG_DIR/bootstrap-$1.time"
+    printf '{"code":"bootstrap-%s","at":%s000}\n' "$1" "$CMDR_NOW" > "$CMDR_LOG_FILE"
+  ) 2>/dev/null || true
+}
 CMDR_NODE=''
 if [ -r "$CMDR_RUNTIME_HOME/node-path" ]; then
   IFS= read -r CMDR_NODE < "$CMDR_RUNTIME_HOME/node-path"
@@ -22,13 +36,22 @@ if [ -z "$CMDR_NODE" ]; then
   fi
 fi
 if [ -z "$CMDR_NODE" ]; then
+  cmdr_failure node
   [ "$CMDR_ENTRY" = hook ] && exit 0
   echo 'cmdr requires Node.js >=22.5 (24 recommended). Install Node and retry.' >&2
   exit 1
 fi
 if [ ! -f "$CMDR_BIN_DIR/../dist/$CMDR_ENTRY.mjs" ]; then
+  cmdr_failure runtime
   [ "$CMDR_ENTRY" = hook ] && exit 0
-  echo 'cmdr runtime is not built. Run npm ci && npm run build in the repository, or install the built npm package.' >&2
+  if [ "$CMDR_ENTRY" = cli ] && [ "$1" = doctor ] && [ -f "$CMDR_BIN_DIR/cmdr-check.mjs" ]; then
+    exec "$CMDR_NODE" "$CMDR_BIN_DIR/cmdr-check.mjs" "$CMDR_BIN_DIR/.."
+  fi
+  echo 'cmdr runtime is not built. Run npm ci && npm run build in the repository, or install cmdr-mcp from npm, refresh/reinstall the host plugin cache and start a new session. Do not symlink another installation. Inspect this plugin with a working cmdr doctor --plugin-root PATH.' >&2
   exit 1
 fi
+if [ "$CMDR_ENTRY" = hook ]; then
+  "$CMDR_NODE" --experimental-sqlite --disable-warning=ExperimentalWarning "$CMDR_BIN_DIR/../dist/hook.mjs" "$@" 2>/dev/null || cmdr_failure runtime
+  exit 0
+fi
 exec "$CMDR_NODE" --experimental-sqlite --disable-warning=ExperimentalWarning "$CMDR_BIN_DIR/../dist/$CMDR_ENTRY.mjs" "$@"

package/plugins/cmdr/commands/cmdr.md

@@ -5,3 +5,5 @@ argument-hint: <name>
 Call the cmdr join tool with squad_name="$ARGUMENTS". This is an atomic find-or-create operation; do not list then create. If no name was provided, ask for one. Do not invent a name.
 If the squad is orphaned, ask whether to take over as commander or join as executor and then use explicit role and squad ID.
 Follow the returned protocol_hint. An executor reports ready with cwd, capabilities and context before replying. Translate user_reply into the user's language, keep the join line unchanged, and reply with only that text. Then use read(wait=me.recommended_wait) to participate.
+
+If cmdr tools are unavailable, follow the using-cmdr installation diagnostics and member CLI fallback. Do not invent native session IDs or access raw sockets.