114 lines
5.3 KiB
JavaScript
114 lines
5.3 KiB
JavaScript
// allow-test-rule: AC2 requires asserting no `runtime === 'cline'` string-equality branch remains in bin/install.js/src — the descriptor-migration contract is a property of the source text, so a source-grep is the only faithful check (#2090)
|
|
'use strict';
|
|
|
|
/**
|
|
* cline imperative reference host — ADR-1239 Phase D / #2090 (EoS/cline).
|
|
*
|
|
* Proves cline is driven through the PUBLIC Host-Integration Interface (the
|
|
* imperative adapter), that its negotiated axes classify + negotiate correctly,
|
|
* that negotiation fails CLOSED on a corrupted descriptor, that the
|
|
* Context7-sourced dispatch classification STAYS degraded/flat (cline subagents
|
|
* are documented as single-level read-only — maxDepth:1 — and must never be
|
|
* silently upgraded to full nested/background dispatch), and that the migration
|
|
* retired the hardcoded `runtime === 'cline'` / `isCline` branches (folded into
|
|
* descriptor-driven `runtime.hostBehaviors`).
|
|
*
|
|
* Contrast with cursor (#2089): cursor's dispatch got an UPGRADE (background +
|
|
* nested). cline's dispatch is a deliberate DEGRADATION that must be preserved —
|
|
* upgrading it would misrepresent a documented host restriction and violate the
|
|
* fail-closed negotiation contract (see dispatch-degradation test).
|
|
*/
|
|
|
|
const { test } = require('node:test');
|
|
const assert = require('node:assert/strict');
|
|
const fs = require('node:fs');
|
|
const path = require('node:path');
|
|
|
|
const { createImperativeAdapter } = require('../gsd-core/bin/lib/adapter-imperative.cjs');
|
|
const {
|
|
profileOf,
|
|
negotiateHostCapabilities,
|
|
PROFILE_BASELINES,
|
|
UNDOCUMENTED,
|
|
} = require('../gsd-core/bin/lib/host-integration.cjs');
|
|
|
|
const CLN_CAP = JSON.parse(
|
|
fs.readFileSync(path.join(__dirname, '..', 'capabilities', 'cline', 'capability.json'), 'utf8'),
|
|
);
|
|
const CLN_AXES = CLN_CAP.runtime.hostIntegration;
|
|
|
|
// -- AC2: driven through the public interface (imperative adapter) -----------
|
|
|
|
test('createImperativeAdapter classifies cline as imperative + composes the registry', () => {
|
|
const adapter = createImperativeAdapter({ runtime: 'cline' });
|
|
assert.equal(adapter.kind, 'imperative');
|
|
assert.equal(adapter.runtime, 'cline');
|
|
assert.ok(adapter.registry && typeof adapter.registry === 'object');
|
|
assert.equal(typeof adapter.install, 'function');
|
|
assert.equal(typeof adapter.uninstall, 'function');
|
|
});
|
|
|
|
test('cline axes classify as the programmatic-cli reference profile (imperative embedding)', () => {
|
|
assert.equal(profileOf(CLN_AXES), 'programmatic-cli');
|
|
});
|
|
|
|
// -- AC3: all axes populated + validated -------------------------------------
|
|
|
|
test('cline descriptor declares all 8 axes + 6 dispatch sub-axes (no undocumented)', () => {
|
|
assert.equal(CLN_AXES.embeddingMode, 'imperative');
|
|
assert.equal(CLN_AXES.commandSurface, 'slash-file');
|
|
assert.equal(CLN_AXES.modelMode, 'active');
|
|
assert.equal(CLN_AXES.hookBus, 'host');
|
|
assert.equal(CLN_AXES.stateIO, 'filesystem');
|
|
assert.equal(CLN_AXES.transport, 'mcp');
|
|
assert.equal(CLN_AXES.runtime, 'node');
|
|
const d = CLN_AXES.dispatch;
|
|
assert.equal(d.namedDispatch, true);
|
|
assert.equal(d.nested, false);
|
|
assert.equal(d.maxDepth, 1);
|
|
assert.equal(d.background, true);
|
|
assert.equal(d.subagentToolkit, 'read-only');
|
|
assert.equal(d.backgroundDispatch, false);
|
|
});
|
|
|
|
// -- AC5: negotiation fails CLOSED on a corrupted descriptor ------------------
|
|
|
|
test('negotiateHostCapabilities never throws for cline, even fully corrupted', () => {
|
|
assert.doesNotThrow(() => negotiateHostCapabilities({}));
|
|
assert.doesNotThrow(() => negotiateHostCapabilities({ ...CLN_AXES, embeddingMode: UNDOCUMENTED }));
|
|
assert.doesNotThrow(() => negotiateHostCapabilities({ ...CLN_AXES, embeddingMode: 'future-unknown' }));
|
|
});
|
|
|
|
test('a partial/empty cline descriptor degrades to the safe floor, not the programmatic-cli baseline', () => {
|
|
const result = negotiateHostCapabilities({});
|
|
assert.equal(result.effective.embeddingMode, 'declarative', 'omitted embeddingMode degrades closed');
|
|
assert.equal(result.effective.hookBus, 'none');
|
|
assert.notDeepEqual(result.effective, PROFILE_BASELINES['programmatic-cli']);
|
|
assert.ok(result.warnings.length > 0);
|
|
});
|
|
|
|
// -- AC2: the hardcoded branches are retired ---------------------------------
|
|
|
|
test('cline descriptor declares runtime.hostBehaviors (the folded-in behaviors)', () => {
|
|
const hb = CLN_CAP.runtime.hostBehaviors;
|
|
assert.ok(hb && typeof hb === 'object');
|
|
assert.equal(hb.reapplyCommand, '/gsd-update --reapply');
|
|
assert.equal(hb.frontmatterDialect, 'cline');
|
|
assert.equal(hb.skipSharedHooksInstall, true);
|
|
assert.equal(hb.localTargetIsProjectRoot, true);
|
|
assert.equal(hb.clineRulesSurface, true);
|
|
assert.equal(hb.localCommandsViaRules, true);
|
|
});
|
|
|
|
test('no `runtime === "cline"` string-equality branch remains in the install source (AC2)', () => {
|
|
const strip = (src) => src
|
|
.replace(/\/\*[\s\S]*?\*\//g, '')
|
|
.replace(/\/\/[^\r\n]*/g, '')
|
|
.replace(/`[^`]*`/g, '');
|
|
for (const rel of ['bin/install.js', 'src/install-engine.cts', 'src/runtime-artifact-conversion.cts', 'src/runtime-hooks-surface.cts']) {
|
|
const src = fs.readFileSync(path.join(__dirname, '..', rel), 'utf8');
|
|
const offenders = strip(src).match(/runtime\s*[!=]==\s*'cline'/g) || [];
|
|
assert.deepEqual(offenders, [], `AC2: no hardcoded runtime==='cline' branch may remain in ${rel}; found: ${offenders.join(', ')}`);
|
|
}
|
|
});
|