beadboard/scripts/bb-init.mjs
2026-03-03 16:43:42 -08:00

140 lines
No EOL
4.3 KiB
JavaScript

#!/usr/bin/env node
/**
* bb-init.mjs - Agent Session Bootstrapper (Lease-Based)
*
* Part of Operative Protocol v1 (bb-u6f.6.3)
*
* Responsibility:
* 1. Resolve bb.ps1 path.
* 2. Identify agent (adopt or register).
* 3. Start the initial activity lease.
*
* Note: No background processes are spawned. Liveness is maintained
* via passive side-effects of CLI commands (Activity-based model).
*/
import { parseArgs } from 'node:util';
import fs from 'node:fs/promises';
import path from 'node:path';
import os from 'node:os';
import { execSync, execFileSync } from 'node:child_process';
function log(obj) {
process.stdout.write(`${JSON.stringify(obj, null, 2)}
`);
}
function error(code, message) {
log({ ok: false, error: { code, message } });
process.exit(1);
}
async function getUncommittedChanges(projectRoot) {
try {
const out = execSync('git status --porcelain', { cwd: projectRoot, encoding: 'utf8' });
return out.split('\n')
.filter(Boolean)
.map(line => line.slice(3).trim())
.filter(p => !p.startsWith('.beadboard') && !p.startsWith('.beads'));
} catch {
return [];
}
}
async function resolveBbPath() {
const envRepo = process.env.BB_REPO;
const tsEntry = path.join(process.cwd(), 'tools', 'bb.ts');
try {
await fs.access(tsEntry);
return { type: 'tsx', path: tsEntry };
} catch {}
if (envRepo) {
const p = path.join(envRepo, 'bb.ps1');
try {
await fs.access(p);
return { type: 'powershell', path: p };
} catch {}
const envTs = path.join(envRepo, 'tools', 'bb.ts');
try {
await fs.access(envTs);
return { type: 'tsx', path: envTs };
} catch {}
}
return null;
}
async function main() {
const { values } = parseArgs({
options: {
'non-interactive': { type: 'boolean' },
adopt: { type: 'string' },
register: { type: 'string' },
role: { type: 'string' },
json: { type: 'boolean' },
'project-root': { type: 'string' }
}
});
const isNonInteractive = values['non-interactive'];
const projectRoot = values['project-root'] || process.cwd();
const bbResult = await resolveBbPath();
if (!bbResult) {
error('BB_NOT_FOUND', 'Could not resolve bb.ps1 or tools/bb.ts');
}
let agentId = values.adopt || values.register;
let mode = values.adopt ? 'adopt' : (values.register ? 'register' : 'auto');
if (mode === 'auto' && isNonInteractive) {
error('AMBIGUOUS_SESSION', 'In non-interactive mode, --adopt or --register is required.');
}
if (mode === 'adopt') {
const changes = await getUncommittedChanges(projectRoot);
if (changes.length === 0 && isNonInteractive) {
error('ADOPTION_REJECTED', 'No evidence (uncommitted changes) to support identity adoption.');
}
}
try {
// Compose environment fingerprint (Rig)
const rigId = `${os.platform()}-${os.arch()}-${os.hostname()}`;
const env = { ...process.env, BD_DB: path.join(projectRoot, '.beads', 'beads.db') };
if (mode === 'register') {
const role = values.role || 'agent';
const registerArgs = bbResult.type === 'tsx'
? ['tsx', bbResult.path, 'agent', 'register', '--name', agentId, '--role', role, '--rig', rigId, '--json']
: ['agent', 'register', '--name', agentId, '--role', role, '--rig', rigId, '--json'];
const registerCmd = bbResult.type === 'tsx' ? 'npx' : bbResult.path;
execFileSync(registerCmd, registerArgs, { stdio: 'ignore', cwd: projectRoot, env });
} else {
// Start/Extend the lease to show we are now active
const leaseArgs = bbResult.type === 'tsx'
? ['tsx', bbResult.path, 'agent', 'activity-lease', '--agent', agentId, '--json']
: ['agent', 'activity-lease', '--agent', agentId, '--json'];
const leaseCmd = bbResult.type === 'tsx' ? 'npx' : bbResult.path;
execFileSync(leaseCmd, leaseArgs, { stdio: 'ignore', cwd: projectRoot, env });
}
log({
ok: true,
agent_id: agentId,
mode,
lease: { status: 'active', note: 'Activity lease started. Liveness maintained via real work.' },
timestamp: new Date().toISOString()
});
} catch (err) {
error('INIT_FAILED', err.message);
}
}
main();