Net-new EoS/pi installable runtime — purely additive (no prior runtime==='pi'
branches). pi is a bun-runtime programmatic-CLI whose /gsd command is registered
by a native ExtensionAPI extension and dispatches through the embedded engine.
Stage 1 (install plumbing):
- capabilities/pi/capability.json: full hostIntegration descriptor (imperative /
slash-programmatic / active-model / native-extension / bun) + hostBehaviors
{nativePlugin, pluginOnlyInstall}.
- --pi flag + interactive-menu renumber (All 17->18); pi added to RUNTIME_FLAG_IDS,
RUNTIME_LABELS, RUNTIME_META, allRuntimes/runtimeMap, model-catalog defaults.
- Install mirrors OpenCode: pi installs the gsd.cjs extension + the shared engine
payload (gsd-core + scripts + config markers) + the shared hooks bundle (spawned
by the extension at lifecycle events, like OpenCode's plugin). pluginOnlyInstall
EXCLUDES declarative command/agent/skill markdown, which pi has no host-read
surface for (its /gsd is programmatic). _installNativePluginIfDeclared (extracted
from the opencode-family path) copies pi/gsd.cjs -> ~/.pi/agent/extensions/gsd.cjs
(global) / .pi/extensions/ (local). pi added to package.json files.
- Golden: new pi.json (320 files: extension + engine + 27-file hooks bundle, no
markdown); the 16 other fixtures + claude-local change only by the shared
model-catalog hash line.
Stage 2 (real dispatch + upgrades):
- Shared dispatchGsdCommand() (shell-command-projection): bounded, no-throw
subprocess-shim to gsd-tools.cjs (the only full-surface dispatch path; no
in-process full-hub factory exists). Fixes pi/gsd.cjs's createHub()-no-args bug
(every dispatch was UnknownCommand) AND the identical bug in mcp-server.cts's
gsd_invoke_command, which a vacuous unknown-family-only test had masked (now has
a real dispatch regression test).
- pi/gsd.cjs: /gsd handler now (args, ctx) - tokenizes (quote-aware, via the
shipped hooks/lib/git-cmd.js) + dispatches real family/subcommand (not hardcoded
query/help); gsd_invoke gets a TypeBox (JSON-schema-fallback) parameters schema +
consumes params; getArgumentCompletions; before_provider_request active-model
steering (fail-open on null resolution); functional session_start /
before_agent_start / session_before_compact hook bridges (spawn the shipped GSD
hook scripts).
- EXTENSION_EVENT_SURFACES.pi expanded from ['tool_call'] to the full 30-event
vocabulary.
Docs (host-integration matrix + how-to) + changeset (Added).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
55 lines
2.5 KiB
JavaScript
55 lines
2.5 KiB
JavaScript
'use strict';
|
|
/**
|
|
* Tests for runtimeFlags (ADR-1239 Phase B / #1679 AC2). Collapses the four
|
|
* duplicated `const isX = runtime === 'x'` declaration blocks in bin/install.js
|
|
* into one helper. Pins: all flags present, exactly one true per known runtime,
|
|
* claude/unknown/empty → all false, frozen.
|
|
*/
|
|
|
|
const { test } = require('node:test');
|
|
const assert = require('node:assert/strict');
|
|
const { runtimeFlags } = require('../gsd-core/bin/lib/runtime-name-policy.cjs');
|
|
const registry = require('../gsd-core/bin/lib/capability-registry.cjs');
|
|
|
|
const EXPECTED_FLAGS = [
|
|
'isOpencode', 'isKilo', 'isCodex', 'isCopilot', 'isAntigravity',
|
|
'isCursor', 'isWindsurf', 'isAugment', 'isTrae', 'isQwen', 'isHermes',
|
|
'isCodebuddy', 'isCline', 'isKimi', 'isZcode', 'isPi',
|
|
];
|
|
|
|
test('runtimeFlags: every known non-claude runtime sets exactly its own flag true', () => {
|
|
const ids = EXPECTED_FLAGS.map((f) => f.slice(2).toLowerCase());
|
|
for (const id of ids) {
|
|
const flags = runtimeFlags(id);
|
|
const trues = EXPECTED_FLAGS.filter((f) => flags[f] === true);
|
|
assert.deepStrictEqual(trues, ['is' + id.charAt(0).toUpperCase() + id.slice(1)], `runtime '${id}' must set exactly its own flag`);
|
|
}
|
|
});
|
|
|
|
test('runtimeFlags: claude / unknown / empty → all flags false (fail-closed)', () => {
|
|
for (const id of ['claude', 'unknown', '', 'claude-code']) {
|
|
const flags = runtimeFlags(id);
|
|
for (const f of EXPECTED_FLAGS) {
|
|
assert.strictEqual(flags[f], false, `runtime '${id}': ${f} must be false`);
|
|
}
|
|
}
|
|
});
|
|
|
|
test('runtimeFlags: all 16 flags present + boolean + the object is frozen', () => {
|
|
const flags = runtimeFlags('opencode');
|
|
for (const f of EXPECTED_FLAGS) {
|
|
assert.strictEqual(typeof flags[f], 'boolean', `${f} must be boolean`);
|
|
}
|
|
assert.deepStrictEqual(Object.keys(flags).sort(), [...EXPECTED_FLAGS].sort(), 'exactly the 16 flags');
|
|
assert.ok(Object.isFrozen(flags), 'flags object must be frozen');
|
|
});
|
|
|
|
test('runtimeFlags drift guard: covers every registry runtime except claude', () => {
|
|
// Adding a registry runtime that is not claude must get a flag or be added to
|
|
// RUNTIME_FLAG_IDS — pin the set so a new runtime forces a deliberate update.
|
|
const registryNonClaude = Object.keys(registry.runtimes).filter((r) => r !== 'claude').sort();
|
|
const flagIds = EXPECTED_FLAGS.map((f) => f.slice(2).toLowerCase()).sort();
|
|
const missing = registryNonClaude.filter((r) => !flagIds.includes(r));
|
|
assert.deepEqual(missing, [], `registry runtimes missing a runtimeFlags entry: ${missing.join(', ')} — add to RUNTIME_FLAG_IDS`);
|
|
});
|