add gstack 2 parity and lifecycle gates

This commit is contained in:
Sinabina
2026-07-17 11:08:32 -07:00
parent b6572ebbb7
commit 9919c4cdd3
212 changed files with 29098 additions and 3845 deletions
+30 -35
View File
@@ -2,59 +2,54 @@ import { describe, test, expect } from 'bun:test';
import * as path from 'path';
import * as fs from 'fs';
// Static tripwires for the C (machine-wide) render in `gstack-config
// gbrain-refresh`. The render mutates the shared global install, so the guards
// that stop it from touching the wrong directory are load-bearing — these fail
// CI if any guard is dropped.
// Static tripwires for the GStack 2 `gstack-config gbrain-refresh` boundary.
// Host placement and skill updates belong to the standard Agent Skills
// installer. This command may refresh managed detection state, but must never
// mutate a host-specific skill directory or regenerate skill content in place.
const ROOT = path.resolve(import.meta.dir, '..');
const SRC = fs.readFileSync(path.join(ROOT, 'bin', 'gstack-config'), 'utf-8');
// Pull out just the gbrain-refresh `ok)` branch so assertions can't be
// satisfied by unrelated text elsewhere in the file.
function okBranch(): string {
const start = SRC.indexOf('gbrain-refresh)');
const ok = SRC.indexOf('ok)', start);
const end = SRC.indexOf(';;', ok);
if (start < 0 || ok < 0 || end < 0) throw new Error('Could not locate gbrain-refresh ok) branch');
return SRC.slice(ok, end);
function refreshFunction(): string {
const start = SRC.indexOf('async function refreshGbrainDetection()');
const end = SRC.indexOf('\nasync function mutateConfigHome', start);
if (start < 0 || end < 0) {
throw new Error('Could not locate refreshGbrainDetection');
}
return SRC.slice(start, end);
}
describe('gstack-config gbrain-refresh: machine-wide render guards', () => {
const branch = okBranch();
describe('gstack-config gbrain-refresh: managed-state-only boundary', () => {
const body = refreshFunction();
test('targets the global install', () => {
expect(branch).toContain('$HOME/.claude/skills/gstack');
test('runs the canonical detector', () => {
expect(body).toContain('gstack-gbrain-detect');
});
test('refuses a symlinked install (would dirty a dev worktree)', () => {
expect(branch).toMatch(/\[ -L "\$INSTALL_DIR" \]/);
test('writes only managed detection state with an atomic rename', () => {
expect(body).toContain('gbrain-detection.json');
expect(body).toContain('.tmp-${process.pid}');
expect(body).toContain('fs.rename(temporary, target)');
expect(body).toContain('mutateConfigHome');
});
test('verifies it is a real gstack clone before mutating it', () => {
expect(branch).toContain('$INSTALL_DIR/VERSION');
expect(branch).toContain('$INSTALL_DIR/package.json');
test('does not own host placement or in-place generation', () => {
expect(body).not.toMatch(/\.claude\/skills|\.agents\/skills/);
expect(body).not.toContain('gen:skill-docs');
expect(body).not.toContain('gstack-relink');
});
test('requires bun on PATH', () => {
expect(branch).toContain('command -v bun');
});
test('renders the :user variant in place into the install', () => {
expect(branch).toContain('gen:skill-docs:user --host claude');
});
test('is self-documenting about the reset --hard / re-run cycle', () => {
expect(branch).toContain('reset --hard');
expect(branch).toContain('gbrain-refresh');
test('directs content updates back through the standard installer', () => {
expect(body).toContain('standard Agent Skills installer');
});
});
describe('CLAUDE.md: deploy section documents the re-run', () => {
test('notes re-running gbrain-refresh after reset --hard', () => {
describe('CLAUDE.md: deploy section preserves the installer boundary', () => {
test('names the standard installer as the host-placement owner', () => {
const claudeMd = fs.readFileSync(path.join(ROOT, 'CLAUDE.md'), 'utf-8');
const idx = claudeMd.indexOf('## Deploying to the active skill');
expect(idx).toBeGreaterThan(-1);
const section = claudeMd.slice(idx, idx + 1200);
expect(section).toContain('gbrain-refresh');
expect(section).toContain('standard Agent Skills installer');
expect(section).not.toContain('renders into the install');
});
});