Files
Claude-Code-Monitor/server/__tests__/client-dist-override.test.js
T
nntrivi2001 8a82895c65 feat(plugins): make CCAM installable straight from a Claude Code plugin
Adds a root `ccam` plugin (`.claude-plugin/plugin.json`, `"source": "./"`) so
`/plugin marketplace add` + `/plugin install ccam@...` is enough on a machine
with nothing but Claude Code: no clone, no npm run setup, no manual npm start.

- scripts/plugin-bootstrap.js: SessionStart hook. Fast-path exit, Node >=22.5
  gate (node:sqlite), mkdir lock with stale reclaim, deps installed into
  ~/.claude/agent-dashboard/runtime/ (never the plugin cache), legacy
  checkout-hook cleanup (backed up), ~/.local/bin/ccam launcher, eager UI
  build so client routes like /run work immediately, detached server spawn.
- scripts/plugin-open.js, scripts/plugin-doctor.js: /ccam-open, /ccam-doctor.
- server/index.js: DASHBOARD_CLIENT_DIST override (plugin cache is read-only).
- mcp/build/ is committed (plugin MCP servers start before any bootstrap could
  build them) and kept honest by scripts/check-mcp-build.js (content hash,
  not mtime), enforced by pre-commit when mcp/src changes.
- plugins/ccam-dashboard/.mcp.json moved under plugins/ccam/ with a working
  ${CLAUDE_PLUGIN_ROOT} path (the old relative path never resolved from a
  marketplace-cached subdir).
- Docs: README, INSTALL, SETUP, ARCHITECTURE, CLAUDE.md, docs/PLUGINS.md,
  docs/MCP.md, docs/CLI.md, docs/HOOKS.md.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-10 16:05:37 +07:00

99 lines
3.0 KiB
JavaScript

/**
* @file Tests the DASHBOARD_CLIENT_DIST override in server/index.js. A plugin
* install runs the server from a read-only plugin cache directory, so the
* client bundle is served from the writable runtime dir instead of the
* checkout's client/dist. Also asserts the API still answers when the
* configured bundle directory does not exist yet (the normal state before
* /ccam-open builds it).
* @author Nguyễn Ngọc Trí Vĩ <vinnt@smartgift.vn>
*/
const { describe, it, before, after } = require("node:test");
const assert = require("node:assert/strict");
const fs = require("fs");
const os = require("os");
const path = require("path");
const http = require("http");
const TMP = fs.mkdtempSync(path.join(os.tmpdir(), "ccam-clientdist-"));
const DIST = path.join(TMP, "client-dist");
fs.mkdirSync(DIST);
fs.writeFileSync(path.join(DIST, "index.html"), "<!doctype html><title>from-runtime</title>");
// Must be set BEFORE requiring the server: the data dir, discovery file and
// the static mount are all resolved at startup.
process.env.CLAUDE_HOME = TMP;
process.env.DASHBOARD_DB_PATH = path.join(TMP, "test.db");
process.env.DASHBOARD_LIVENESS_PROBE = "0";
process.env.DASHBOARD_CLIENT_DIST = DIST;
const { createApp, startServer } = require("../index");
const { db } = require("../db");
let server;
let BASE;
function get(urlPath) {
return new Promise((resolve, reject) => {
const req = http.get(new URL(urlPath, BASE), (res) => {
let body = "";
res.on("data", (c) => (body += c));
res.on("end", () => resolve({ status: res.statusCode, body }));
});
req.on("error", reject);
});
}
describe("DASHBOARD_CLIENT_DIST override", () => {
before(async () => {
server = await startServer(createApp(), 0);
BASE = `http://127.0.0.1:${server.address().port}`;
});
after(() => {
if (server) server.close();
if (db) db.close();
fs.rmSync(TMP, { recursive: true, force: true });
delete process.env.DASHBOARD_CLIENT_DIST;
});
it("serves index.html from the configured directory", async () => {
const res = await get("/");
assert.equal(res.status, 200);
assert.match(res.body, /from-runtime/);
});
it("keeps the API working alongside the override", async () => {
const res = await get("/api/health");
assert.equal(res.status, 200);
});
});
describe("DASHBOARD_CLIENT_DIST pointing at a missing directory", () => {
let srv;
let base;
before(async () => {
process.env.DASHBOARD_CLIENT_DIST = path.join(TMP, "not-built-yet");
srv = await startServer(createApp(), 0);
base = `http://127.0.0.1:${srv.address().port}`;
});
after(() => {
if (srv) srv.close();
});
it("answers the API and only 404s the UI route", async () => {
const prevBase = BASE;
BASE = base;
try {
const health = await get("/api/health");
assert.equal(health.status, 200);
const ui = await get("/");
assert.equal(ui.status, 404);
} finally {
BASE = prevBase;
}
});
});