chore(oss): audit the server package and resync the SDK mirrors

Split the 657-line operation service into eor, submit, and verify modules, add the AGENT_REVOKED and KEY_RETIRED codes the Backend already emits, and condense every multi-line comment. Mirror Node, Python, and Go at 2.1.0 with the deep-health 503, non-idempotent retry, rotation grace, and path-encoding fixes. Document which routes and response fields the self-hosted server does not provide. Claude-Session: https://claude.ai/code/session_01Agoc9bRVE9KL7mmWtey9Vq
2026-09-03 20:48:20 -04:00
1 parent 2010175a82
commit bc6983a62e
@@ -1,95 +1,40 @@
-import { spawn } from 'node:child_process';
-import { mkdir, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
-import http from 'node:http';
-import os from 'node:os';
 import path from 'node:path';
-import { pathToFileURL } from 'node:url';
+import {
+  createFixtureRoot,
+  distUrl,
+  installConfig as baseInstallConfig,
+  runPlugin as basePlugin,
+  runProcess as baseProcess,
+  writeOptionalJson,
+} from './harness.mjs';

-export const VALID_PRIVATE_KEY = Buffer.alloc(32, 11).toString('base64url');
-export const pluginModuleUrl = pathToFileURL(path.resolve('dist/plugins/kiroide.js')).href;
-export const contractModuleUrl = pathToFileURL(
-  path.resolve('dist/plugins/kiroide-contract.js'),
-).href;
-export const installationModuleUrl = pathToFileURL(
-  path.resolve('dist/plugins/kiroide-installation.js'),
-).href;
-export const ioModuleUrl = pathToFileURL(path.resolve('dist/plugins/kiroide-io.js')).href;
-export const registryModuleUrl = pathToFileURL(path.resolve('dist/plugins/registry.js')).href;
-export const cliPath = path.resolve('dist/cli.js');
+export {
+  VALID_PRIVATE_KEY,
+  cliPath,
+  homeEnvironment as environment,
+  readJson,
+  registryModuleUrl,
+  runNode,
+  runShell,
+  startApiServer,
+} from './harness.mjs';
+
+export const pluginModuleUrl = distUrl('plugins/kiroide.js');
+export const contractModuleUrl = distUrl('plugins/kiroide-contract.js');
+export const installationModuleUrl = distUrl('plugins/kiroide-installation.js');
+export const ioModuleUrl = distUrl('plugins/kiroide-io.js');
+const PLUGIN = { exportName: 'kiroidePlugin', moduleUrl: pluginModuleUrl };

 export function runProcess(command, args, env, cwd, input = '', shell = false) {
-  return new Promise((resolve, reject) => {
-    const childEnvironment = { ...process.env, ...env };
-    for (const [name, value] of Object.entries(env)) {
-      if (value === undefined) delete childEnvironment[name];
-    }
-    const child = spawn(command, args, {
-      cwd,
-      env: childEnvironment,
-      shell,
-      stdio: ['pipe', 'pipe', 'pipe'],
-      windowsHide: true,
-    });
-    let stdout = '';
-    let stderr = '';
-    child.stdout.on('data', (chunk) => { stdout += chunk; });
-    child.stderr.on('data', (chunk) => { stderr += chunk; });
-    child.once('error', reject);
-    child.once('close', (code) => resolve({ code, stdout, stderr }));
-    child.stdin.end(input);
-  });
-}
-
-export function runNode(args, env, cwd, input = '') {
-  return runProcess(process.execPath, args, env, cwd, input);
-}
-
-export function runShell(command, env, cwd, input = '') {
-  return runProcess(command, [], env, cwd, input, true);
-}
-
-export function environment(fixture) {
-  return { HOME: fixture.homeDir, USERPROFILE: fixture.homeDir };
+  return baseProcess(command, args, env, cwd, input, { shell });
 }

 export function installConfig(fixture, overrides = {}) {
-  return {
-    agentName: 'kiroide',
-    orgId: 'org-1',
-    agentId: fixture.agentId,
-    privateKey: VALID_PRIVATE_KEY,
-    kid: 'kid-1',
-    token: 'token-1',
-    baseUrl: fixture.baseUrl,
-    guardScriptPath: fixture.guardScriptPath,
-    hookScriptPath: fixture.hookScriptPath,
-    ...overrides,
-  };
+  return baseInstallConfig('kiroide', fixture, overrides);
 }

-export async function runPlugin(fixture, method, argument) {
-  const source = `
-    import { kiroidePlugin } from ${JSON.stringify(pluginModuleUrl)};
-    const argument = JSON.parse(process.env.ELYDORA_TEST_ARGUMENT);
-    const result = await kiroidePlugin[process.env.ELYDORA_TEST_METHOD](argument);
-    if (result !== undefined) console.log(JSON.stringify(result));
-  `;
-  return runNode(
-    ['--input-type=module', '--eval', source],
-    {
-      ...environment(fixture),
-      ELYDORA_TEST_ARGUMENT: JSON.stringify(argument),
-      ELYDORA_TEST_METHOD: method,
-    },
-    fixture.projectDir,
-  );
-}
-
-async function writeOptional(filePath, value) {
-  if (value === undefined) return;
-  await mkdir(path.dirname(filePath), { recursive: true });
-  const source = typeof value === 'string' ? value : `${JSON.stringify(value, null, 2)}\n`;
-  await writeFile(filePath, source, { mode: 0o600 });
+export function runPlugin(fixture, method, argument) {
+  return basePlugin(PLUGIN, fixture, method, argument);
 }

 export async function createFixture({
@@ -98,73 +43,28 @@ export async function createFixture({
  existingConfig,
  existingLegacy,
 } = {}) {
-  const rootDir = await mkdtemp(path.join(os.tmpdir(), 'elydora-kiroide-'));
-  const homeDir = path.join(rootDir, "home with spaces and 'quote %KIRO%");
-  const projectDir = path.join(rootDir, 'workspace with spaces');
-  const hooksDir = path.join(projectDir, '.kiro', 'hooks');
+  const base = await createFixtureRoot(
+    'elydora-kiroide-',
+    "home with spaces and 'quote %KIRO%",
+    { agentId, projectName: 'workspace with spaces' },
+  );
+  const hooksDir = path.join(base.projectDir, '.kiro', 'hooks');
  const configPath = path.join(hooksDir, 'elydora-audit.json');
-  const legacyConfigPath = path.join(homeDir, '.kiro', 'hooks', 'elydora-audit.kiro.hook');
-  const agentDir = path.join(homeDir, '.elydora', agentId);
-  const guardScriptPath = path.join(agentDir, 'guard.js');
-  const hookScriptPath = path.join(agentDir, 'hook.js');
-  await mkdir(projectDir, { recursive: true });
-  await writeOptional(configPath, existingConfig);
-  await writeOptional(legacyConfigPath, existingLegacy);
-  const fixture = {
-    agentDir,
-    agentId,
+  const legacyConfigPath = path.join(base.homeDir, '.kiro', 'hooks', 'elydora-audit.kiro.hook');
+  await writeOptionalJson(configPath, existingConfig);
+  await writeOptionalJson(legacyConfigPath, existingLegacy);
+  return {
+    ...base,
    baseUrl,
    configPath,
-    guardScriptPath,
-    homeDir,
-    hookScriptPath,
    hooksDir,
    legacyConfigPath,
-    projectDir,
-    rootDir,
    install(overrides = {}) {
      return runPlugin(this, 'install', installConfig(this, overrides));
    },
-    async close() {
-      await rm(rootDir, { recursive: true, force: true });
-    },
  };
-  return fixture;
-}
-
-export async function readJson(filePath) {
-  return JSON.parse(await readFile(filePath, 'utf-8'));
 }

 export function findHook(document, name) {
  return document.hooks.find((hook) => hook.name === name);
 }
-
-export async function startApiServer() {
-  const requests = [];
-  const server = http.createServer(async (request, response) => {
-    const chunks = [];
-    for await (const chunk of request) chunks.push(chunk);
-    const raw = Buffer.concat(chunks).toString('utf-8');
-    requests.push({ method: request.method, url: request.url, raw });
-    if (request.method === 'GET') {
-      response.writeHead(200, { 'Content-Type': 'application/json' });
-      response.end('{"agent":{"status":"active"}}');
-      return;
-    }
-    response.writeHead(201, { 'Content-Type': 'application/json' });
-    response.end('{"operation":{"accepted":true}}');
-  });
-  await new Promise((resolve, reject) => {
-    server.once('error', reject);
-    server.listen(0, '127.0.0.1', resolve);
-  });
-  const address = server.address();
-  return {
-    baseUrl: `http://127.0.0.1:${address.port}`,
-    requests,
-    close: () => new Promise((resolve, reject) => {
-      server.close((error) => error ? reject(error) : resolve());
-    }),
-  };
-}