@openlife/cli 1.7.6 → 1.7.9

package/dist/index.js

@@ -338,6 +338,50 @@ program.command('init')
     }
 });
 // ============================================================================
+// OBSERVABILITY — `openlife status`, `openlife logs`
+// ============================================================================
+program.command('status')
+    .description('Consolidated runtime state (heartbeat + executors + governance + queue) as JSON')
+    .option('--watch', 're-print every 5 seconds (Ctrl-C to stop)', false)
+    .action(async (options) => {
+    const { buildStatusReport, renderStatusReport } = require('./cli/StatusCommand');
+    const printOnce = () => {
+        const report = buildStatusReport(process.cwd());
+        console.log(renderStatusReport(report));
+        if (report.overall !== 'healthy')
+            process.exitCode = 1;
+    };
+    if (!options.watch) {
+        printOnce();
+        return;
+    }
+    printOnce();
+    const interval = setInterval(() => {
+        console.log('---');
+        printOnce();
+    }, 5000);
+    process.on('SIGINT', () => {
+        clearInterval(interval);
+        process.exit(0);
+    });
+});
+program.command('logs')
+    .description('Readable tail of .openlife/*.jsonl event streams')
+    .option('--tail <N>', 'number of entries to show', '20')
+    .option('--since <duration>', 'only entries newer than e.g. 5m | 1h | 2d')
+    .option('--filter <subsystem>', 'match subsystem (governance, media-routing, capability-lifecycle, canonization-log)')
+    .option('--json', 'emit one JSON object per line instead of human-readable text', false)
+    .action((options) => {
+    const { collectLogs, renderLogsHuman, renderLogsJson } = require('./cli/LogsCommand');
+    const tail = Number.parseInt(options.tail || '20', 10);
+    const entries = collectLogs({
+        tail: Number.isFinite(tail) && tail > 0 ? tail : 20,
+        since: options.since,
+        filter: options.filter,
+    });
+    console.log(options.json ? renderLogsJson(entries) : renderLogsHuman(entries));
+});
+// ============================================================================
 // AUTENTICAÇÃO (AUTH)
 // ============================================================================
 const authCmd = program.command('auth').description('Gerencia a autenticação nativa sem uso de API Keys');
@@ -2038,32 +2082,196 @@ aiobuilderCmd.command('mode')
     }
     console.log(JSON.stringify(r.setMode(options.set, options.profile), null, 2));
 });
+// Story 5.5 (M5) — real authoring pipeline. Replaces the 6-line placeholder
+// stub. Accepts rich flags + optional --interactive readline prompts, then
+// delegates to AgentCreator / SquadCreator for atomic write.
+const splitCsv = (s) => (s || '')
+    .split(',')
+    .map((v) => v.trim())
+    .filter((v) => v.length > 0);
 aiobuilderCmd.command('create-agent <id>')
-    .option('--role <role>', 'papel', 'specialist')
-    .option('--notes <notes>', 'notas', '')
-    .action((id, options) => {
-    const base = path.join(process.cwd(), '.catalog', 'agents', id);
-    fs.mkdirSync(base, { recursive: true });
-    const out = path.join(base, 'AGENT.md');
-    fs.writeFileSync(out, `---\nid: ${id}\nname: ${id}\nrole: ${options.role}\nsource: aiobuilder\n---\n\n# ${id}\n\n${options.notes || 'Criado pelo AIOBUILDER.'}\n`, 'utf-8');
-    console.log(JSON.stringify({ ok: true, type: 'agent', path: out }, null, 2));
+    .description('Author a new agent in .catalog/agents/<id>/AGENT.md (status: draft)')
+    .option('--role <role>', 'role label (e.g. specialist, planner)', 'specialist')
+    .option('--name <name>', 'display name (defaults to id)')
+    .option('--domain <domain>', 'business domain')
+    .option('--expertise <csv>', 'comma-separated expertise tags')
+    .option('--skills <csv>', 'comma-separated primary skill ids (must exist in .catalog/skills/)')
+    .option('--parent-squad <id>', 'parent squad id (must exist in .catalog/squads/)')
+    .option('--persona <text>', 'free-form persona description')
+    .option('--when-to-use <text>', 'goal / when-to-use sentence')
+    .option('--status <status>', 'active | draft | archived', 'draft')
+    .option('--interactive', 'prompt for missing fields via readline', false)
+    .action(async (id, options) => {
+    const { AgentCreator } = require('./orchestrator/AgentCreator');
+    let name = options.name || id;
+    let role = options.role;
+    let domain = options.domain;
+    let expertise = splitCsv(options.expertise);
+    let primarySkills = splitCsv(options.skills);
+    let parentSquad = options.parentSquad;
+    let persona = options.persona;
+    let whenToUse = options.whenToUse;
+    if (options.interactive && process.stdin.isTTY) {
+        const { ReadlineAnswerProvider } = require('./cli/InstallWizard');
+        const provider = new ReadlineAnswerProvider();
+        try {
+            console.log(`\n📝 Authoring agent: ${id}\n`);
+            name = await provider.text('Display name', name);
+            role = await provider.text('Role (e.g. specialist, planner, reviewer)', role);
+            domain = await provider.text('Business domain (optional, Enter to skip)', domain || '');
+            const expertiseRaw = await provider.text('Expertise tags (comma-separated, optional)', expertise.join(','));
+            expertise = splitCsv(expertiseRaw);
+            const skillsRaw = await provider.text('Primary skill ids (comma-separated, optional)', primarySkills.join(','));
+            primarySkills = splitCsv(skillsRaw);
+            parentSquad = await provider.text('Parent squad id (optional)', parentSquad || '');
+            whenToUse = await provider.text('When to use this agent (one sentence)', whenToUse || `Execute the ${role} role on demand.`);
+        }
+        finally {
+            provider.close?.();
+        }
+    }
+    else if (options.interactive) {
+        console.error('⚠️  --interactive ignored (no TTY). Using flag values + defaults.');
+    }
+    const creator = new AgentCreator();
+    const result = creator.create({
+        id,
+        name,
+        role,
+        domain: domain || undefined,
+        expertise: expertise.length ? expertise : undefined,
+        primarySkills: primarySkills.length ? primarySkills : undefined,
+        parentSquad: parentSquad || undefined,
+        persona,
+        whenToUse,
+        status: options.status,
+    });
+    if (!result.ok) {
+        console.log(JSON.stringify({ ok: false, type: 'agent', ...result }, null, 2));
+        process.exitCode = 1;
+        return;
+    }
+    const validation = creator.validate(id);
+    console.log(JSON.stringify({
+        ok: true,
+        type: 'agent',
+        agentId: result.agentId,
+        path: result.filePath,
+        warnings: validation.warnings,
+    }, null, 2));
 });
 aiobuilderCmd.command('create-squad <id>')
-    .option('--domain <domain>', 'domínio', 'general')
-    .option('--notes <notes>', 'notas', '')
-    .action((id, options) => {
-    const base = path.join(process.cwd(), '.catalog', 'squads', id);
-    fs.mkdirSync(base, { recursive: true });
-    const out = path.join(base, 'SQUAD.md');
-    fs.writeFileSync(out, `---\nid: ${id}\ndomain: ${options.domain}\nsource: aiobuilder\n---\n\n# ${id}\n\n${options.notes || 'Criada pelo AIOBUILDER.'}\n`, 'utf-8');
-    console.log(JSON.stringify({ ok: true, type: 'squad', path: out }, null, 2));
+    .description('Author a new squad in .catalog/squads/<id>/ with at least one agent')
+    .option('--name <name>', 'display name (defaults to id)')
+    .option('--domain <domain>', 'business domain', 'general')
+    .option('--description <text>', 'short description', '')
+    .option('--agents <csv>', 'comma-separated initial agent ids', '')
+    .option('--status <status>', 'active | draft', 'draft')
+    .option('--interactive', 'prompt for missing fields via readline', false)
+    .action(async (id, options) => {
+    const { SquadCreator } = require('./orchestrator/SquadCreator');
+    let name = options.name || id;
+    let domain = options.domain;
+    let description = options.description;
+    let agentIds = splitCsv(options.agents);
+    if (options.interactive && process.stdin.isTTY) {
+        const { ReadlineAnswerProvider } = require('./cli/InstallWizard');
+        const provider = new ReadlineAnswerProvider();
+        try {
+            console.log(`\n📝 Authoring squad: ${id}\n`);
+            name = await provider.text('Display name', name);
+            domain = await provider.text('Domain', domain);
+            description = await provider.text('Description (one sentence)', description || `${name} squad — ${domain} domain`);
+            const agentsRaw = await provider.text('Initial agent ids (comma-separated, at least one)', agentIds.join(','));
+            agentIds = splitCsv(agentsRaw);
+        }
+        finally {
+            provider.close?.();
+        }
+    }
+    else if (options.interactive) {
+        console.error('⚠️  --interactive ignored (no TTY). Using flag values + defaults.');
+    }
+    if (agentIds.length === 0) {
+        agentIds = [`${id}-lead`];
+    }
+    const creator = new SquadCreator();
+    const result = creator.create({
+        id,
+        name,
+        description: description || `${name} squad`,
+        agents: agentIds.map((agentId) => ({
+            id: agentId,
+            name: agentId,
+            role: 'specialist',
+        })),
+        status: options.status,
+        source: 'aiobuilder',
+    });
+    if (!result.ok) {
+        console.log(JSON.stringify({ ok: false, type: 'squad', ...result }, null, 2));
+        process.exitCode = 1;
+        return;
+    }
+    console.log(JSON.stringify({
+        ok: true,
+        type: 'squad',
+        squadId: result.squadId,
+        squadDir: result.squadDir,
+        filesCreated: result.filesCreated.length,
+    }, null, 2));
 });
-aiobuilderCmd.command('validate-catalog').action(() => {
-    const agents = countCatalogFiles('agents', 'AGENT.md');
-    const squads = countCatalogFiles('squads', 'SQUAD.md');
-    const ok = agents.total >= 300 && squads.total >= 2;
-    console.log(JSON.stringify({ ok, agents, squads }, null, 2));
-    if (!ok)
+aiobuilderCmd.command('validate-catalog')
+    .description('Semantic validation of .catalog/ agents + squads (JSON by default)')
+    .option('--human', 'emit human-readable text instead of JSON', false)
+    .option('--json', 'emit machine-readable JSON only (backward-compatible no-op; JSON is default)', false)
+    .action((options) => {
+    const { AgentCreator } = require('./orchestrator/AgentCreator');
+    const { SquadCreator } = require('./orchestrator/SquadCreator');
+    const agentCreator = new AgentCreator();
+    const squadCreator = new SquadCreator();
+    const agentList = agentCreator.list();
+    const squadList = squadCreator.list();
+    const errors = [];
+    const warnings = [];
+    for (const a of agentList) {
+        const v = agentCreator.validate(a.id);
+        for (const err of v.errors)
+            errors.push({ kind: 'agent', id: a.id, error: err });
+        for (const w of v.warnings)
+            warnings.push({ kind: 'agent', id: a.id, warning: w });
+    }
+    for (const s of squadList) {
+        const v = squadCreator.validate(s.id);
+        for (const err of v.errors)
+            errors.push({ kind: 'squad', id: s.id, error: err });
+        for (const w of v.warnings)
+            warnings.push({ kind: 'squad', id: s.id, warning: w });
+    }
+    const report = {
+        ok: errors.length === 0,
+        parsed: { agents: agentList.length, squads: squadList.length },
+        // Back-compat shape (consumed by test_openlife_evolution_surface and
+        // any operator script that grew up under the old threshold output).
+        agents: { total: agentList.length },
+        squads: { total: squadList.length },
+        errors,
+        warnings,
+    };
+    if (options.human) {
+        console.log(`Catalog validation — agents: ${agentList.length}, squads: ${squadList.length}`);
+        console.log(`  errors: ${errors.length}, warnings: ${warnings.length}`);
+        for (const e of errors)
+            console.log(`  ❌ [${e.kind}/${e.id}] ${e.error}`);
+        for (const w of warnings.slice(0, 10))
+            console.log(`  ⚠️  [${w.kind}/${w.id}] ${w.warning}`);
+        if (warnings.length > 10)
+            console.log(`  ... and ${warnings.length - 10} more warnings`);
+    }
+    else {
+        console.log(JSON.stringify(report, null, 2));
+    }
+    if (!report.ok)
         process.exitCode = 1;
 });
 aiobuilderCmd.command('generate-ui <featureName>')
@@ -2227,16 +2435,6 @@ aiobuilderCmd.command('test')
     if (r.status !== 0)
         process.exitCode = 1;
 });
-aiobuilderCmd.command('preview')
-    .description('Prepare a preview URL for the current branch (v1.3 will wire to Vercel/Railway)')
-    .action(() => {
-    console.log(JSON.stringify({
-        ok: true,
-        action: 'aiobuilder.preview',
-        note: 'preview deployment integration deferred to v1.3 capability genesis epic',
-        next: 'manually push to feature branch + open PR for now',
-    }, null, 2));
-});
 aiobuilderCmd.command('release')
     .description('Run QA loop + open PR (delegates to qa-loop workflow)')
     .action(async () => {
@@ -2253,16 +2451,6 @@ aiobuilderCmd.command('release')
     const state = await engine.run(r.workflow);
     console.log(JSON.stringify({ ok: state.status === 'completed', action: 'aiobuilder.release', state }, null, 2));
 });
-aiobuilderCmd.command('infra')
-    .description('Infrastructure report (placeholder — real integration v1.3)')
-    .action(() => {
-    console.log(JSON.stringify({
-        ok: true,
-        action: 'aiobuilder.infra',
-        note: 'infra integration deferred to v1.3',
-        checks: ['supabase: TBD', 'railway: TBD', 'env: TBD'],
-    }, null, 2));
-});
 aiobuilderCmd.command('score')
     .description('Show squad/skill scores from .artifacts/squad-scores.json')
     .action(() => {

package/dist/orchestrator/AgentCreator.js

@@ -0,0 +1,362 @@
+"use strict";
+/**
+ * AgentCreator — authoring system for standalone agents under `.catalog/agents/`.
+ *
+ * Story 5.5 — OpenLife v1.8 (M5 of Hit-10 sprint).
+ *
+ * Replaces the 6-line placeholder previously inlined in
+ * `aiobuilder create-agent` with a real authoring pipeline that produces
+ * an AGENT.md with complete frontmatter + structured sections (Goal,
+ * Commands, Dependencies, Persona, Guardrails). Mirrors SkillCreator
+ * (single-file output) rather than SquadCreator (multi-file directory),
+ * since standalone agents live as one AGENT.md inside their own directory.
+ *
+ * Methods:
+ *   - create(proposal)   — render full AGENT.md from a proposal
+ *   - validate(id)       — semantic frontmatter + cross-ref check
+ *   - list(filter?)      — direct read of `.catalog/agents/`
+ *   - analyze(id)        — surface missing/orphan references
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentCreator = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const AtomicWriter_1 = require("./util/AtomicWriter");
+const ID_PATTERN = /^[a-z0-9][a-z0-9._-]+$/i;
+const VALID_STATUSES = new Set(['active', 'draft', 'archived']);
+class AgentCreator {
+    catalogRoot;
+    skillsCatalogRoot;
+    squadsCatalogRoot;
+    constructor(opts = {}) {
+        const cwd = process.cwd();
+        this.catalogRoot = opts.catalogRoot || path.join(cwd, '.catalog', 'agents');
+        this.skillsCatalogRoot = opts.skillsCatalogRoot || path.join(cwd, '.catalog', 'skills');
+        this.squadsCatalogRoot = opts.squadsCatalogRoot || path.join(cwd, '.catalog', 'squads');
+    }
+    // ─────────────────────────────────────────────────────────
+    // create
+    // ─────────────────────────────────────────────────────────
+    create(proposal) {
+        if (!proposal.id || !ID_PATTERN.test(proposal.id)) {
+            return { ok: false, error: 'invalid_agent_id', detail: 'must match /^[a-z0-9][a-z0-9._-]+$/i' };
+        }
+        if (!proposal.name?.trim()) {
+            return { ok: false, error: 'missing_name' };
+        }
+        if (!proposal.role?.trim()) {
+            return { ok: false, error: 'missing_role' };
+        }
+        if (proposal.status && !VALID_STATUSES.has(proposal.status)) {
+            return { ok: false, error: 'invalid_status', detail: `must be one of: ${Array.from(VALID_STATUSES).join(', ')}` };
+        }
+        const agentDir = path.join(this.catalogRoot, proposal.id);
+        if (fs.existsSync(agentDir)) {
+            return { ok: false, error: 'agent_already_exists', detail: agentDir };
+        }
+        try {
+            fs.mkdirSync(agentDir, { recursive: true });
+            const content = this.renderAgentMd(proposal);
+            const filePath = path.join(agentDir, 'AGENT.md');
+            (0, AtomicWriter_1.writeStringAtomic)(filePath, content);
+            return { ok: true, agentId: proposal.id, agentDir, filePath };
+        }
+        catch (err) {
+            try {
+                fs.rmSync(agentDir, { recursive: true, force: true });
+            }
+            catch { /* ignore */ }
+            return { ok: false, error: 'render_failed', detail: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    // ─────────────────────────────────────────────────────────
+    // validate
+    // ─────────────────────────────────────────────────────────
+    validate(agentId) {
+        const errors = [];
+        const warnings = [];
+        const agentDir = path.join(this.catalogRoot, agentId);
+        const agentFile = path.join(agentDir, 'AGENT.md');
+        if (!fs.existsSync(agentDir)) {
+            errors.push(`agent directory not found: ${agentDir}`);
+            return { ok: false, agentId, errors, warnings };
+        }
+        if (!fs.existsSync(agentFile)) {
+            errors.push('AGENT.md missing');
+            return { ok: false, agentId, errors, warnings };
+        }
+        const content = fs.readFileSync(agentFile, 'utf-8');
+        const fm = this.parseFrontmatter(content);
+        if (!fm.id)
+            errors.push('frontmatter missing id');
+        if (!fm.name)
+            errors.push('frontmatter missing name');
+        if (!fm.role)
+            errors.push('frontmatter missing role');
+        if (fm.id && fm.id !== agentId) {
+            errors.push(`frontmatter id '${fm.id}' does not match directory '${agentId}'`);
+        }
+        if (fm.status && !VALID_STATUSES.has(fm.status)) {
+            errors.push(`invalid status '${fm.status}' (must be active|draft|archived)`);
+        }
+        // Cross-reference: parent squad
+        if (fm.parentSquad) {
+            const squadPath = path.join(this.squadsCatalogRoot, fm.parentSquad);
+            if (!fs.existsSync(squadPath)) {
+                warnings.push(`parent squad '${fm.parentSquad}' not found in catalog`);
+            }
+        }
+        // Cross-reference: primary skills
+        const skillRefs = this.parseListField(content, 'primarySkills');
+        for (const skillId of skillRefs) {
+            const skillPath = path.join(this.skillsCatalogRoot, skillId);
+            if (!fs.existsSync(skillPath)) {
+                warnings.push(`primary skill '${skillId}' not found in catalog`);
+            }
+        }
+        return { ok: errors.length === 0, agentId, errors, warnings };
+    }
+    // ─────────────────────────────────────────────────────────
+    // list
+    // ─────────────────────────────────────────────────────────
+    list(filter) {
+        if (!fs.existsSync(this.catalogRoot))
+            return [];
+        const out = [];
+        for (const entry of fs.readdirSync(this.catalogRoot)) {
+            const agentFile = path.join(this.catalogRoot, entry, 'AGENT.md');
+            if (!fs.existsSync(agentFile))
+                continue;
+            const fm = this.parseFrontmatter(fs.readFileSync(agentFile, 'utf-8'));
+            const item = {
+                id: fm.id || entry,
+                name: fm.name || entry,
+                role: fm.role || 'unknown',
+                status: fm.status || 'unknown',
+                parentSquad: fm.parentSquad || null,
+            };
+            if (filter?.status && item.status !== filter.status)
+                continue;
+            if (filter?.squad && item.parentSquad !== filter.squad)
+                continue;
+            out.push(item);
+        }
+        return out;
+    }
+    // ─────────────────────────────────────────────────────────
+    // analyze
+    // ─────────────────────────────────────────────────────────
+    analyze(agentId) {
+        const agentDir = path.join(this.catalogRoot, agentId);
+        const agentFile = path.join(agentDir, 'AGENT.md');
+        if (!fs.existsSync(agentFile))
+            return null;
+        const content = fs.readFileSync(agentFile, 'utf-8');
+        const fm = this.parseFrontmatter(content);
+        const hasPersona = /^## Persona\b/m.test(content);
+        const commandLines = content.match(/^\s*-\s*name:\s*[\w-]+/gm) || [];
+        const skillRefs = this.parseListField(content, 'primarySkills');
+        const orphanSkills = [];
+        for (const skillId of skillRefs) {
+            if (!fs.existsSync(path.join(this.skillsCatalogRoot, skillId))) {
+                orphanSkills.push(skillId);
+            }
+        }
+        const squadReference = fm.parentSquad || null;
+        const squadExists = squadReference
+            ? fs.existsSync(path.join(this.squadsCatalogRoot, squadReference))
+            : null;
+        const suggestions = [];
+        if (!hasPersona)
+            suggestions.push('add a Persona section to clarify behavior under load');
+        if (commandLines.length === 0)
+            suggestions.push('declare at least one command so operators know how to invoke');
+        if (orphanSkills.length > 0)
+            suggestions.push(`${orphanSkills.length} skill reference(s) not in catalog`);
+        if (squadReference && squadExists === false)
+            suggestions.push(`parent squad '${squadReference}' not in catalog`);
+        return {
+            agentId,
+            hasPersona,
+            commandCount: commandLines.length,
+            skillReferences: skillRefs.length,
+            orphanSkills,
+            squadReference,
+            squadExists,
+            suggestions,
+        };
+    }
+    // ─────────────────────────────────────────────────────────
+    // render — AGENT.md body
+    // ─────────────────────────────────────────────────────────
+    renderAgentMd(p) {
+        const status = p.status || 'draft';
+        const version = p.version || '0.1.0';
+        const source = p.source || 'aiobuilder';
+        const createdAt = new Date().toISOString();
+        const frontmatterLines = [
+            '---',
+            `id: ${p.id}`,
+            `name: ${p.name}`,
+            `role: ${p.role}`,
+        ];
+        if (p.domain)
+            frontmatterLines.push(`domain: ${p.domain}`);
+        if (p.parentSquad)
+            frontmatterLines.push(`parentSquad: ${p.parentSquad}`);
+        if (p.expertise?.length) {
+            frontmatterLines.push('expertise:');
+            for (const tag of p.expertise)
+                frontmatterLines.push(`  - ${tag}`);
+        }
+        if (p.primarySkills?.length) {
+            frontmatterLines.push('primarySkills:');
+            for (const skillId of p.primarySkills)
+                frontmatterLines.push(`  - ${skillId}`);
+        }
+        frontmatterLines.push(`status: ${status}`);
+        frontmatterLines.push(`version: ${version}`);
+        frontmatterLines.push(`source: ${source}`);
+        frontmatterLines.push(`createdAt: ${createdAt}`);
+        frontmatterLines.push('---');
+        const commands = p.commands?.length
+            ? p.commands
+            : [{ name: 'help', description: 'Show available commands and capabilities' }];
+        const dependencies = p.dependencies?.length
+            ? p.dependencies
+            : ['(none declared yet — list skills, tools, or services this agent relies on)'];
+        const guardrails = p.guardrails?.length
+            ? p.guardrails
+            : [
+                'Respect toolset boundaries from parent squad policies',
+                'Emit audit events for state-changing actions',
+                'Defer to human approval for actions outside autonomy budget',
+            ];
+        const sections = [];
+        sections.push(`# ${p.name}`);
+        sections.push('');
+        sections.push(`> Role: ${p.role}${p.domain ? `  ·  Domain: ${p.domain}` : ''}`);
+        sections.push('');
+        sections.push('## Goal');
+        sections.push('');
+        sections.push(p.whenToUse || `Define and execute work in the ${p.role} role.`);
+        sections.push('');
+        sections.push('## Commands');
+        sections.push('');
+        sections.push('```yaml');
+        sections.push('commands:');
+        for (const c of commands) {
+            sections.push(`  - name: ${c.name}`);
+            sections.push(`    description: ${JSON.stringify(c.description)}`);
+        }
+        sections.push('```');
+        sections.push('');
+        sections.push('## Dependencies');
+        sections.push('');
+        for (const d of dependencies)
+            sections.push(`- ${d}`);
+        sections.push('');
+        sections.push('## Persona');
+        sections.push('');
+        if (p.identity || p.style || p.focus || p.persona) {
+            if (p.identity)
+                sections.push(`- **Identity:** ${p.identity}`);
+            if (p.style)
+                sections.push(`- **Style:** ${p.style}`);
+            if (p.focus)
+                sections.push(`- **Focus:** ${p.focus}`);
+            if (p.persona) {
+                sections.push('');
+                sections.push(p.persona);
+            }
+        }
+        else {
+            sections.push(`Embodies the ${p.role} discipline with rigor and clarity. Speaks in concrete steps,`);
+            sections.push('not abstractions. Defers to operator judgment on irreversible decisions.');
+        }
+        sections.push('');
+        sections.push('## Guardrails');
+        sections.push('');
+        for (const g of guardrails)
+            sections.push(`- ${g}`);
+        sections.push('');
+        sections.push('---');
+        sections.push('*Generated by OpenLife AgentCreator.*');
+        return frontmatterLines.join('\n') + '\n\n' + sections.join('\n') + '\n';
+    }
+    // ─────────────────────────────────────────────────────────
+    // parsing helpers
+    // ─────────────────────────────────────────────────────────
+    parseFrontmatter(content) {
+        const match = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!match)
+            return {};
+        const out = {};
+        for (const line of match[1].split('\n')) {
+            const m = line.match(/^([a-zA-Z][a-zA-Z0-9_]*):\s*(.+)$/);
+            if (m)
+                out[m[1]] = m[2].trim();
+        }
+        return out;
+    }
+    parseListField(content, field) {
+        const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!fmMatch)
+            return [];
+        const lines = fmMatch[1].split('\n');
+        const out = [];
+        let capturing = false;
+        const fieldRe = new RegExp(`^${field}:\\s*$`);
+        for (const line of lines) {
+            if (fieldRe.test(line)) {
+                capturing = true;
+                continue;
+            }
+            if (capturing) {
+                const m = line.match(/^\s+-\s+(.+)$/);
+                if (m) {
+                    out.push(m[1].trim());
+                    continue;
+                }
+                // any non-list line ends the capture
+                if (/^[a-zA-Z]/.test(line))
+                    capturing = false;
+            }
+        }
+        return out;
+    }
+}
+exports.AgentCreator = AgentCreator;