/** * Qoder native plugin contract tests. * * These tests intentionally execute the declared hook entry point instead of * only inspecting JSON. Qoder launches hooks without a shell when `command` * and `args` are separate, which keeps the same contract on Windows, macOS, * and Linux. */ 'use strict'; const assert = require('assert'); const fs = require('fs'); const path = require('path'); const { spawnSync } = require('child_process'); const repoRoot = path.resolve(__dirname, '..'); const manifestPath = path.join(repoRoot, '.qoder-plugin', 'plugin.json'); const hooksPath = path.join(repoRoot, 'hooks', 'qoder-hooks.json'); const packageJson = JSON.parse(fs.readFileSync(path.join(repoRoot, 'package.json'), 'utf8')); const releaseScript = fs.readFileSync(path.join(repoRoot, 'scripts', 'release.sh'), 'utf8'); let passed = 0; let failed = 0; function test(name, fn) { try { fn(); console.log(` ✓ ${name}`); passed += 1; } catch (error) { console.log(` ✗ ${name}`); console.log(` Error: ${error.message}`); failed += 1; } } console.log('\n=== Qoder native plugin ===\n'); test('manifest and hook projection exist', () => { assert.ok(fs.existsSync(manifestPath), 'Expected .qoder-plugin/plugin.json'); assert.ok(fs.existsSync(hooksPath), 'Expected hooks/qoder-hooks.json'); }); if (fs.existsSync(manifestPath) && fs.existsSync(hooksPath)) { const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8')); const hooks = JSON.parse(fs.readFileSync(hooksPath, 'utf8')); test('manifest stays versioned with the npm package', () => { assert.strictEqual(manifest.name, 'ecc'); assert.strictEqual(manifest.version, packageJson.version); }); test('release tooling updates and stages the Qoder manifest', () => { assert.ok(releaseScript.includes('QODER_PLUGIN_JSON=".qoder-plugin/plugin.json"')); assert.ok(releaseScript.includes('update_version "$QODER_PLUGIN_JSON"')); assert.ok(releaseScript.includes('git add ') && releaseScript.includes('"$QODER_PLUGIN_JSON"')); }); test('manifest reuses canonical plugin resources', () => { assert.strictEqual(manifest.skills, './skills/'); assert.strictEqual(manifest.commands, './commands/'); assert.strictEqual(manifest.mcpServers, './.mcp.json'); assert.strictEqual(manifest.hooks, './hooks/qoder-hooks.json'); }); test('agent colors are accepted by Qoder', () => { const allowedColors = new Set([ 'red', 'blue', 'green', 'yellow', 'purple', 'orange', 'pink', 'cyan', ]); for (const fileName of fs.readdirSync(path.join(repoRoot, 'agents'))) { if (!fileName.endsWith('.md')) continue; const source = fs.readFileSync(path.join(repoRoot, 'agents', fileName), 'utf8'); const match = source.match(/^color:\s*(\S+)$/m); if (match) { assert.ok(allowedColors.has(match[1]), `${fileName} uses unsupported Qoder color ${match[1]}`); } } }); test('Qoder hook is a minimal SessionStart projection using exec form', () => { assert.deepStrictEqual(Object.keys(hooks.hooks), ['SessionStart']); const registrations = hooks.hooks.SessionStart; assert.strictEqual(registrations.length, 1); assert.strictEqual(registrations[0].matcher, 'startup|resume|clear|compact|new'); assert.strictEqual(registrations[0].hooks.length, 1); const hook = registrations[0].hooks[0]; assert.strictEqual(hook.type, 'command'); assert.strictEqual(hook.command, 'node'); assert.ok(Array.isArray(hook.args)); assert.strictEqual(hook.args[0], '${QODER_PLUGIN_ROOT}/scripts/hooks/plugin-hook-bootstrap.js'); assert.deepStrictEqual(hook.args.slice(1), [ 'node', 'scripts/hooks/session-start-bootstrap.js', ]); }); test('declared Qoder SessionStart launcher executes from QODER_PLUGIN_ROOT', () => { const hook = hooks.hooks.SessionStart[0].hooks[0]; const args = hook.args.map(value => value.replace('${QODER_PLUGIN_ROOT}', repoRoot)); const result = spawnSync(hook.command, args, { cwd: repoRoot, env: { ...process.env, QODER_PLUGIN_ROOT: repoRoot, ECC_HOOKS_ENABLED: 'false', }, input: JSON.stringify({ hook_event_name: 'SessionStart', source: 'startup', cwd: repoRoot, }), encoding: 'utf8', timeout: 10000, windowsHide: true, }); assert.ifError(result.error); assert.strictEqual(result.signal, null); assert.strictEqual(result.status, 0, result.stderr); }); } console.log(`\nPassed: ${passed}`); console.log(`Failed: ${failed}`); process.exit(failed > 0 ? 1 : 0);