@jaybeeuu/agent-cortex 1.38.1 → 1.39.0

package/skills/workflow/run-pipeline-stage/scripts/node_modules/.bin/tsc

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/agent-cortex/agent-cortex/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/runner/work/agent-cortex/agent-cortex/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/runner/work/agent-cortex/agent-cortex/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/runner/work/agent-cortex/agent-cortex/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/runner/work/agent-cortex/agent-cortex/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/runner/work/agent-cortex/agent-cortex/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsc" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsc" "$@"
+fi

package/skills/workflow/run-pipeline-stage/scripts/node_modules/.bin/tsserver

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/agent-cortex/agent-cortex/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/runner/work/agent-cortex/agent-cortex/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/runner/work/agent-cortex/agent-cortex/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/runner/work/agent-cortex/agent-cortex/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/runner/work/agent-cortex/agent-cortex/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/runner/work/agent-cortex/agent-cortex/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsserver" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsserver" "$@"
+fi

package/skills/workflow/run-pipeline-stage/scripts/node_modules/.bin/tsx

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/agent-cortex/agent-cortex/node_modules/.pnpm/tsx@4.22.4/node_modules/tsx/node_modules:/home/runner/work/agent-cortex/agent-cortex/node_modules/.pnpm/tsx@4.22.4/node_modules:/home/runner/work/agent-cortex/agent-cortex/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/runner/work/agent-cortex/agent-cortex/node_modules/.pnpm/tsx@4.22.4/node_modules/tsx/node_modules:/home/runner/work/agent-cortex/agent-cortex/node_modules/.pnpm/tsx@4.22.4/node_modules:/home/runner/work/agent-cortex/agent-cortex/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../tsx/dist/cli.mjs" "$@"
+else
+  exec node  "$basedir/../tsx/dist/cli.mjs" "$@"
+fi

package/test/claude-installer.test.mjs

@@ -0,0 +1,248 @@
+// Tests for `agent-cortex install claude` runtime registration: after
+// regenerating the claude/ subtree, the plain install registers the plugin
+// with Claude Code by driving the `claude plugin` CLI (marketplace add →
+// install → marketplace update → plugin update). The real CLI is a genuine
+// external system, so these tests drive a fake `claudeBin` script that records
+// every invocation; the real repo's marketplace.json supplies the manifest.
+
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { execFile } from "node:child_process";
+import {
+  mkdtempSync,
+  mkdirSync,
+  writeFileSync,
+  rmSync,
+  readFileSync,
+  chmodSync,
+  existsSync,
+} from "node:fs";
+import { tmpdir } from "node:os";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { registerClaude } from "../bin/installers/claude.mjs";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = join(__dirname, "..");
+const CLI_PATH = join(ROOT, "bin", "agent-cortex.mjs");
+
+function runCli(args) {
+  return new Promise((resolve) => {
+    execFile(process.execPath, [CLI_PATH, ...args], (error, stdout, stderr) => {
+      resolve({ exitCode: error ? error.code ?? 1 : 0, stdout, stderr });
+    });
+  });
+}
+
+// ─── Fake claude CLI ─────────────────────────────────────────────────────────
+
+/**
+ * A fake `claude` binary recording every argv line to `log` (one line per
+ * invocation, space-joined). Set `failWhen` to a substring: any invocation
+ * whose argv contains it exits 1. Exits 0 otherwise.
+ */
+function makeFakeClaude(dir, { failWhen = null } = {}) {
+  const bin = join(dir, "claude");
+  const log = join(dir, "calls.log");
+  const script = [
+    "#!/bin/sh",
+    `echo "$*" >> "${log}"`,
+    ...(failWhen
+      ? [`if printf '%s' "$*" | grep -q -- "${failWhen}"; then exit 1; fi`]
+      : []),
+    "exit 0",
+  ].join("\n");
+  writeFileSync(bin, `${script}\n`);
+  chmodSync(bin, 0o755);
+  return { bin, log };
+}
+
+function makeTmp() {
+  return mkdtempSync(join(tmpdir(), "agent-cortex-claude-installer-"));
+}
+
+/** A minimal marketplace tree (as seen in the real repo) at a scratch path. */
+function makeMarketplaceRoot({ name = "jaybeeuu", plugin = "agent-cortex" } = {}) {
+  const root = mkdtempSync(join(tmpdir(), "agent-cortex-marketplace-"));
+  mkdirSync(join(root, ".claude-plugin"), { recursive: true });
+  writeFileSync(
+    join(root, ".claude-plugin", "marketplace.json"),
+    JSON.stringify({
+      name,
+      owner: { name: "tester" },
+      plugins: [{ name: plugin, source: "./claude", description: "test plugin" }],
+    }),
+  );
+  return root;
+}
+
+// ─── registerClaude ──────────────────────────────────────────────────────────
+
+describe("registerClaude", () => {
+  it("drives claude plugin marketplace add → install → marketplace update → plugin update", () => {
+    const tmp = makeTmp();
+    const root = makeMarketplaceRoot();
+    const fake = makeFakeClaude(tmp);
+    try {
+      const result = registerClaude({ root, claudeBin: fake.bin });
+      assert.equal(result.marketplace, "jaybeeuu");
+      assert.equal(result.plugin, "agent-cortex");
+      assert.equal(result.dryRun, false);
+
+      const calls = readFileSync(fake.log, "utf-8").trim().split("\n");
+      // The availability probe (`plugin --help`) is a spawn, but the registration
+      // surface is the four commands below — assert those, in order.
+      const registration = calls.filter((c) => !c.startsWith("plugin --help"));
+      assert.deepEqual(registration, [
+        `plugin marketplace add ${root}`,
+        "plugin install agent-cortex@jaybeeuu -y",
+        "plugin marketplace update jaybeeuu",
+        "plugin update agent-cortex -y",
+      ]);
+    } finally {
+      rmSync(tmp, { recursive: true, force: true });
+      rmSync(root, { recursive: true, force: true });
+    }
+  });
+
+  it("derives marketplace and plugin names from the manifest", () => {
+    const tmp = makeTmp();
+    const root = makeMarketplaceRoot({ name: "scratchmkt", plugin: "scratchplug" });
+    const fake = makeFakeClaude(tmp);
+    try {
+      const result = registerClaude({ root, claudeBin: fake.bin });
+      assert.equal(result.marketplace, "scratchmkt");
+      assert.equal(result.plugin, "scratchplug");
+      const calls = readFileSync(fake.log, "utf-8").trim().split("\n");
+      const registration = calls.filter((c) => !c.startsWith("plugin --help"));
+      assert.ok(registration.some((c) => c === "plugin install scratchplug@scratchmkt -y"));
+      assert.ok(registration.some((c) => c === "plugin update scratchplug -y"));
+    } finally {
+      rmSync(tmp, { recursive: true, force: true });
+      rmSync(root, { recursive: true, force: true });
+    }
+  });
+
+  it("--dry-run plans the commands without spawning claude at all", () => {
+    const tmp = makeTmp();
+    const root = makeMarketplaceRoot();
+    const fake = makeFakeClaude(tmp);
+    try {
+      const result = registerClaude({ root, claudeBin: fake.bin, dryRun: true });
+      assert.equal(result.dryRun, true);
+      assert.deepEqual(
+        result.commands,
+        [
+          ["plugin", "marketplace", "add", root],
+          ["plugin", "install", "agent-cortex@jaybeeuu", "-y"],
+          ["plugin", "marketplace", "update", "jaybeeuu"],
+          ["plugin", "update", "agent-cortex", "-y"],
+        ],
+      );
+      // No registration spawns happened at all in dry-run mode.
+      assert.equal(existsSync(fake.log), false);
+    } finally {
+      rmSync(tmp, { recursive: true, force: true });
+      rmSync(root, { recursive: true, force: true });
+    }
+  });
+
+  it("defaults the claude binary to `claude` from PATH (dry-run only — no spawn)", () => {
+    const root = makeMarketplaceRoot();
+    try {
+      const result = registerClaude({ root, dryRun: true });
+      assert.equal(result.commands.length, 4);
+      assert.ok(result.commands[0][0] === "plugin");
+    } finally {
+      rmSync(root, { recursive: true, force: true });
+    }
+  });
+
+  it("fails with upgrade guidance when the claude binary lacks the plugin subcommand", () => {
+    const tmp = makeTmp();
+    const root = makeMarketplaceRoot();
+    const fake = makeFakeClaude(tmp, { failWhen: "plugin --help" });
+    try {
+      assert.throws(
+        () => registerClaude({ root, claudeBin: fake.bin }),
+        /plugin.*subcommand.*update/i,
+      );
+    } finally {
+      rmSync(tmp, { recursive: true, force: true });
+      rmSync(root, { recursive: true, force: true });
+    }
+  });
+
+  it("fails, naming the failing command, when a claude plugin command errors", () => {
+    const tmp = makeTmp();
+    const root = makeMarketplaceRoot();
+    const fake = makeFakeClaude(tmp, { failWhen: "plugin install" });
+    try {
+      assert.throws(
+        () => registerClaude({ root, claudeBin: fake.bin }),
+        /claude plugin install agent-cortex@jaybeeuu -y/,
+      );
+    } finally {
+      rmSync(tmp, { recursive: true, force: true });
+      rmSync(root, { recursive: true, force: true });
+    }
+  });
+
+  it("fails when the checkout has no marketplace manifest", () => {
+    const tmp = makeTmp();
+    const root = mkdtempSync(join(tmpdir(), "agent-cortex-no-market-"));
+    const fake = makeFakeClaude(tmp);
+    try {
+      assert.throws(
+        () => registerClaude({ root, claudeBin: fake.bin }),
+        /marketplace\.json/,
+      );
+      // The failed manifest read happens before any claude invocation.
+      assert.equal(existsSync(fake.log), false);
+    } finally {
+      rmSync(tmp, { recursive: true, force: true });
+      rmSync(root, { recursive: true, force: true });
+    }
+  });
+
+  it("works against the real repo checkout and its marketplace manifest", () => {
+    const tmp = makeTmp();
+    const fake = makeFakeClaude(tmp);
+    try {
+      const result = registerClaude({ root: ROOT, claudeBin: fake.bin });
+      assert.equal(result.marketplace, "jaybeeuu");
+      assert.equal(result.plugin, "agent-cortex");
+      const calls = readFileSync(fake.log, "utf-8").trim().split("\n");
+      const registration = calls.filter((c) => !c.startsWith("plugin --help"));
+      assert.equal(registration.length, 4);
+    } finally {
+      rmSync(tmp, { recursive: true, force: true });
+    }
+  });
+});
+
+// ─── CLI wiring ───────────────────────────────────────────────────────────────
+
+describe("install claude CLI: registration", () => {
+  it("--dry-run without --output prints the registration plan and writes nothing", async () => {
+    const { exitCode, stdout } = await runCli(["install", "claude", "--dry-run"]);
+    assert.equal(exitCode, 0);
+    assert.ok(stdout.includes("would run: claude plugin marketplace add"));
+    assert.ok(stdout.includes("claude plugin install agent-cortex@jaybeeuu"));
+    assert.ok(stdout.includes("claude plugin marketplace update jaybeeuu"));
+    assert.ok(stdout.includes("claude plugin update agent-cortex"));
+    assert.ok(/dry-run/i.test(stdout));
+  });
+
+  it("--output <dir> generates only — no registration plan is printed", async () => {
+    const out = mkdtempSync(join(tmpdir(), "agent-cortex-cli-out-"));
+    try {
+      const { exitCode, stdout } = await runCli(["install", "claude", "--output", out]);
+      assert.equal(exitCode, 0);
+      assert.doesNotMatch(stdout, /claude plugin/);
+      assert.ok(stdout.includes("Generated"));
+    } finally {
+      rmSync(out, { recursive: true, force: true });
+    }
+  });
+});

package/token-map.README.md

@@ -119,9 +119,11 @@ The full contract is embedded in `token-map.json` under `contract`. In summary,
   `{{PATH:...}}` against the map and `{{SECTION:...}}` from the per-harness section
   files; `bin/installers/copilot.mjs` is the shared generator both `pnpm build:copilot`
   and `agent-cortex install copilot` run.
-- `bin/installers/claude.mjs` — the single Claude generator, behind both
-  `agent-cortex install claude` and the `pnpm build:claude` alias (no build-time
-  counterpart; the committed `claude/` subtree is regenerated by it and drift-checked).
+- `bin/installers/claude.mjs` — the single Claude generator, behind plain
+  `agent-cortex install claude` (which also registers the plugin with Claude Code) and
+  its generate-only `pnpm build:claude` alias (`install claude --output claude`; no
+  build-time counterpart — the committed `claude/` subtree is regenerated by it and
+  drift-checked).
 - `bin/installers/pi.mjs` — the pi harness installer (`agent-cortex install pi`), an
   install-time consumer of the map's contract.
 - `lib/cli.mjs` — `SUPPORTED_HARNESSES`, the install command surface the harness ids come