vgxness 0.1.1-alpha.1 → 1.0.1

package/README.md

@@ -1,12 +1,12 @@
 # VGXNESS
 
-VGXNESS is an alpha CLI and MCP control plane for guided AI-agent workflows, SDD artifacts, local memory, and OpenCode integration.
+VGXNESS is an installable CLI and MCP control plane for guided AI-agent workflows, SDD artifacts, local memory, and OpenCode integration.
 
-## Alpha status and license
+## Release status and license
 
 This package is proprietary software. The npm package ships inspectable JavaScript (`dist/`) so Node can run it, but it is **not open-source licensed** and may not be redistributed unless you have written permission. See [LICENSE](./LICENSE).
 
-OpenCode is the primary supported provider in this alpha. Other providers are preview/manual only. The dashboard is read-only/copy-only; provider config writes require explicit CLI confirmation.
+OpenCode is the primary supported provider. Other providers remain preview/manual only. The dashboard is read-only/copy-only; provider config writes require explicit CLI confirmation.
 
 ## Requirements
 
@@ -22,19 +22,24 @@ vgx --help
 vgxness --help
 ```
 
-Use the `alpha` npm dist-tag for alpha releases when publishing/consuming pre-release builds.
-
 ## First setup with OpenCode
 
-Run the guided setup wizard in a TTY, or preview the same safe setup plan in non-interactive shells:
+Run the guided setup wizard in a TTY:
 
 ```bash
 vgx init
-# equivalent explicit command
+```
+
+In non-TTY shells, `vgx init` prints the same read-only setup plan instead of prompting. For a copyable happy path after installing the package globally:
+
+```bash
 vgx setup plan
+vgx setup apply --yes
+vgx doctor
+vgx sdd next --project <project> --change <change>
 ```
 
-Defaults for the alpha are: package `vgxness`, provider `opencode`, global user data DB, project OpenCode scope, and `mcp-plus-agents` mode. The generated MCP command for the global DB default is:
+Stable defaults are: package `vgxness`, provider `opencode`, global user data DB, user/global OpenCode scope (`$HOME/.config/opencode/opencode.json`), and `mcp-plus-agents` mode. Use `--scope project` only when you intentionally want `<workspace>/.opencode/opencode.json`. The generated MCP command for the global DB default is:
 
 ```bash
 vgxness mcp start
@@ -46,6 +51,27 @@ Apply only after reviewing the plan:
 vgx setup apply --yes
 ```
 
+`vgx setup plan` and `vgx setup status` are human-readable and read-only by default. `vgx doctor`, `vgx sdd status`, `vgx sdd next`, and `vgx sdd accept-artifact` are also human-readable by default. Pass `--json` when you need parseable automation output. `vgx setup apply --yes` is the explicit provider-config write path.
+
+## Safety model
+
+- Preview, status, and plan commands are read-only.
+- Provider config writes require explicit `--yes` confirmation.
+- The dashboard is read-only/copy-only; run copied commands outside the TUI when you choose to act.
+- SDD artifacts are SQLite-backed through VGXNESS services. Do not create or write `openspec/`.
+- `vgx sdd accept-artifact` records explicit human-only acceptance; saving a draft never implies acceptance.
+- OpenCode is the primary supported provider; other providers are preview/manual extension points.
+
+## Dashboard entrypoint
+
+Run `vgx` or `vgxness` with no arguments in an interactive terminal to open the operational dashboard. `vgx dashboard interactive` opens the same read-only/copy-only surface. In non-TTY shells, no-args prints static safe guidance and exits 0 without reading dashboard status or inferring project state.
+
+For scripts, use the read-only status renderer with an explicit project:
+
+```bash
+vgx dashboard status --project <name>
+```
+
 For project-local or custom databases, use `--db project-local` or `--db custom --db-path <path>` with setup commands. Existing low-level commands remain available:
 
 ```bash
@@ -93,7 +119,7 @@ npm run package:dry-run
 npm run package:smoke:install
 ```
 
-Do not publish from CI. Use `npm publish --dry-run --tag alpha` as a final manual gate only.
+Do not publish from CI. Use `npm publish --dry-run --tag latest` as the final manual gate for the stable path before any explicit publish decision.
 
 ## Uninstall
 

package/dist/agents/agent-activation-service.js

@@ -1,3 +1,4 @@
+import { responseByteAccounting, summarizePayloadContent } from '../payload/payload-summary.js';
 import { resolveAgentProfileModel } from './profile-model-routing.js';
 const defaultAgentName = 'vgxness-manager';
 const provider = 'opencode';
@@ -17,7 +18,10 @@ export class AgentActivationService {
             return agent;
         if (agent.value.mode !== 'agent')
             return validationFailure('Agent activation requires a top-level agent');
-        const selection = resolveAgentProfileModel({ agent: agent.value, ...(validated.value.providerAdapter === undefined ? {} : { providerAdapter: validated.value.providerAdapter }) });
+        const selection = resolveAgentProfileModel({
+            agent: agent.value,
+            ...(validated.value.providerAdapter === undefined ? {} : { providerAdapter: validated.value.providerAdapter }),
+        });
         if (!selection.ok)
             return selection;
         if (selection.value.providerAdapter !== provider)
@@ -36,7 +40,7 @@ export class AgentActivationService {
         const payload = this.dependencies.opencodeManagerPayload.build(toPayloadInput(validated.value, agent.value.id));
         if (!payload.ok)
             return this.failAfterRun(run.value.id, payload.error.code, payload.error.message);
-        const envelopeWithoutRun = {
+        const verboseEnvelopeWithoutRun = {
             version: 1,
             agent: { id: agent.value.id, name: agent.value.name, scope: agent.value.scope, mode: 'agent' },
             provider,
@@ -52,10 +56,11 @@ export class AgentActivationService {
                 ...payload.value.warnings,
             ],
         };
+        const envelopeWithoutRun = validated.value.payloadMode === 'compact' ? compactActivationEnvelope(verboseEnvelopeWithoutRun, validated.value) : verboseEnvelopeWithoutRun;
         const checkpoint = this.dependencies.runs.appendCheckpoint({
             runId: run.value.id,
             label: 'agent-activation-initial',
-            state: toJson({ ...envelopeWithoutRun, run: { id: run.value.id, status: 'created', checkpointId: null } }),
+            state: toJson(checkpointState(envelopeWithoutRun, run.value.id, validated.value.payloadMode ?? 'verbose')),
         });
         if (!checkpoint.ok)
             return this.failAfterRun(run.value.id, checkpoint.error.code, checkpoint.error.message);
@@ -82,7 +87,11 @@ export class AgentActivationService {
         if (input.agentId !== undefined)
             return this.dependencies.agents.getAgent(input.agentId);
         if (this.dependencies.managerProfiles !== undefined) {
-            const effective = this.dependencies.managerProfiles.resolveEffectiveManager({ project: input.project, scope: input.scope, managerName: defaultAgentName });
+            const effective = this.dependencies.managerProfiles.resolveEffectiveManager({
+                project: input.project,
+                scope: input.scope,
+                managerName: defaultAgentName,
+            });
             return effective.ok ? ok(effective.value.manager) : effective;
         }
         return this.dependencies.agents.getAgentByName(input.project, input.scope, defaultAgentName);
@@ -105,6 +114,8 @@ function validateActivationInput(input) {
         return validationFailure('userIntent is required');
     if (input.agentId !== undefined && input.agentId.trim().length === 0)
         return validationFailure('agentId must not be empty');
+    if (input.payloadMode !== undefined && input.payloadMode !== 'compact' && input.payloadMode !== 'verbose')
+        return validationFailure('payloadMode must be compact or verbose');
     const validated = {
         project: input.project.trim(),
         scope: input.scope ?? 'project',
@@ -123,6 +134,8 @@ function validateActivationInput(input) {
             return validationFailure('providerAdapter must not be empty');
         validated.providerAdapter = input.providerAdapter.trim();
     }
+    if (input.payloadMode !== undefined)
+        validated.payloadMode = input.payloadMode;
     return ok(validated);
 }
 function toPayloadInput(input, agentId) {
@@ -135,10 +148,103 @@ function toPayloadInput(input, agentId) {
         payload.workspaceRoot = input.workspaceRoot;
     if (input.maxSourceBytes !== undefined)
         payload.maxSourceBytes = input.maxSourceBytes;
+    payload.payloadMode = input.payloadMode ?? 'verbose';
     return payload;
 }
+function checkpointState(envelopeWithoutRun, runId, mode) {
+    const base = { ...envelopeWithoutRun, run: { id: runId, status: 'created', checkpointId: null } };
+    if (mode === 'verbose')
+        return toJson(base);
+    return toJson({
+        version: base.version,
+        run: base.run,
+        agent: base.agent,
+        provider: base.provider,
+        modelSelection: base.modelSelection,
+        providerPayload: {
+            version: base.providerPayload.version,
+            provider: base.providerPayload.provider,
+            payloadMode: base.providerPayload.payloadMode,
+            selection: base.providerPayload.selection,
+            providerArtifacts: base.providerPayload.providerArtifacts,
+            skillDiagnostics: base.providerPayload.skillDiagnostics,
+            safety: base.providerPayload.safety,
+            warnings: base.providerPayload.warnings,
+        },
+        skillsContext: base.skillsContext === undefined
+            ? undefined
+            : {
+                version: base.skillsContext.version,
+                providerAgnostic: base.skillsContext.providerAgnostic,
+                context: base.skillsContext.context,
+                itemCount: base.skillsContext.items.length,
+                skipped: base.skillsContext.skipped,
+                skillDiagnostics: base.skillsContext.skillDiagnostics,
+                warnings: base.skillsContext.warnings,
+            },
+        nextSafeAction: base.nextSafeAction,
+        safety: base.safety,
+        warnings: base.warnings,
+    });
+}
+function compactActivationEnvelope(verbose, input) {
+    const compactProviderPayload = {
+        version: verbose.providerPayload.version,
+        provider: verbose.providerPayload.provider,
+        payloadMode: 'compact',
+        installable: verbose.providerPayload.installable,
+        selection: verbose.providerPayload.selection,
+        providerArtifacts: verbose.providerPayload.providerArtifacts,
+        ...(verbose.providerPayload.skillDiagnostics === undefined ? {} : { skillDiagnostics: verbose.providerPayload.skillDiagnostics }),
+        safety: verbose.providerPayload.safety,
+        warnings: verbose.providerPayload.warnings,
+    };
+    const fullRetrieval = {
+        tool: 'vgxness_agent_activate',
+        payloadMode: 'verbose',
+        input: {
+            project: input.project,
+            scope: input.scope,
+            agentId: verbose.agent.id,
+            userIntent: input.userIntent,
+            workflow: input.workflow,
+            phase: input.phase,
+        },
+    };
+    const omittedSections = [];
+    if (verbose.providerPayload.skillPayload !== undefined)
+        omittedSections.push(omittedSection('providerPayload.skillPayload', 'Duplicate of skillsContext; omitted from compact activation response.', fullRetrieval, verbose.providerPayload.skillPayload));
+    if (verbose.skillsContext !== undefined)
+        omittedSections.push(omittedSection('skillsContext', 'Skill details remain durably retrievable through verbose activation or skill payload calls.', fullRetrieval, verbose.skillsContext));
+    const compact = {
+        version: verbose.version,
+        agent: verbose.agent,
+        provider: verbose.provider,
+        modelSelection: verbose.modelSelection,
+        providerPayload: compactProviderPayload,
+        omittedSections,
+        governanceConstraints: [
+            'Activation is preview-only and does not execute providers.',
+            'No provider configuration, background worker, autonomous step, or secrets expansion is performed.',
+            'Request payloadMode=verbose when full provider payload or skills context is needed.',
+        ],
+        nextSafeAction: verbose.nextSafeAction,
+        safety: verbose.safety,
+        warnings: verbose.warnings,
+    };
+    compact.responseByteAccounting = responseByteAccounting(verbose, compact);
+    return compact;
+}
+function omittedSection(path, reason, retrieval, value) {
+    const summary = summarizePayloadContent(JSON.stringify(value));
+    return { path, reason, hash: summary.contentHash, bytes: summary.contentBytes, retrieval };
+}
 function toJson(value) {
     return JSON.parse(JSON.stringify(value));
 }
-function ok(value) { return { ok: true, value }; }
-function validationFailure(message) { return { ok: false, error: { code: 'validation_failed', message } }; }
+function ok(value) {
+    return { ok: true, value };
+}
+function validationFailure(message) {
+    return { ok: false, error: { code: 'validation_failed', message } };
+}

package/dist/agents/agent-registry-service.js

@@ -28,7 +28,9 @@ export class AgentRegistryService {
     resolveAgents(input) {
         return new AgentResolver(() => this.listAgentDefinitions(input)).resolve(input);
     }
-    close() { this.database.close(); }
+    close() {
+        this.database.close();
+    }
     listAgentDefinitions(input) {
         void input;
         const summaries = this.agents.list();

package/dist/agents/agent-resolver.js

@@ -143,11 +143,9 @@ function workflowMatches(agent, input) {
     return [...matches.broad, ...matches.phaseOnly, ...matches.exactPhase];
 }
 function workflowSignalMatches(agent, input) {
-    const requested = [
-        input.workflow,
-        input.phase,
-        input.workflow !== undefined && input.phase !== undefined ? `${input.workflow}:${input.phase}` : undefined,
-    ].filter((value) => value !== undefined).map(normalizeKey);
+    const requested = [input.workflow, input.phase, input.workflow !== undefined && input.phase !== undefined ? `${input.workflow}:${input.phase}` : undefined]
+        .filter((value) => value !== undefined)
+        .map(normalizeKey);
     if (requested.length === 0)
         return { broad: [], phaseOnly: [], exactPhase: [] };
     const workflow = input.workflow !== undefined ? normalizeKey(input.workflow) : undefined;
@@ -172,13 +170,7 @@ function phaseSemanticMatchesFor(agent, input) {
     if (workflow !== undefined && workflow !== 'sdd')
         return [];
     const inputPhase = input.phase !== undefined ? normalizeKey(input.phase) : undefined;
-    const agentTerms = tokenize([
-        agent.name,
-        agent.description,
-        ...agent.capabilities,
-        ...agent.skills,
-        ...agent.workflows,
-    ].join(' '));
+    const agentTerms = tokenize([agent.name, agent.description, ...agent.capabilities, ...agent.skills, ...agent.workflows].join(' '));
     const requestTerms = new Set(input.terms);
     const matches = [];
     for (const semantic of SDD_PHASE_SEMANTICS) {
@@ -193,13 +185,7 @@ function phaseSemanticMatchesFor(agent, input) {
 function textSignalMatches(agent, terms) {
     if (terms.length === 0)
         return [];
-    const searchable = tokenize([
-        agent.name,
-        agent.description,
-        ...agent.capabilities,
-        ...agent.skills,
-        ...agent.workflows,
-    ].join(' '));
+    const searchable = tokenize([agent.name, agent.description, ...agent.capabilities, ...agent.skills, ...agent.workflows].join(' '));
     return terms.filter((term) => searchable.includes(term));
 }
 function matchingValues(values, requested) {
@@ -213,10 +199,7 @@ function matchingValues(values, requested) {
     return matches;
 }
 function compareCandidates(a, b) {
-    return b.score - a.score
-        || modeRank(a.agent.mode) - modeRank(b.agent.mode)
-        || a.agent.name.localeCompare(b.agent.name)
-        || a.agent.id.localeCompare(b.agent.id);
+    return (b.score - a.score || modeRank(a.agent.mode) - modeRank(b.agent.mode) || a.agent.name.localeCompare(b.agent.name) || a.agent.id.localeCompare(b.agent.id));
 }
 function compareSkipped(a, b) {
     return a.agent.name.localeCompare(b.agent.name) || a.agent.id.localeCompare(b.agent.id);
@@ -239,11 +222,17 @@ function normalizeKey(value) {
 }
 function tokenize(value) {
     const seen = new Set();
-    return value.toLowerCase().split(/[^a-z0-9-]+/).filter(Boolean).filter((term) => {
+    return value
+        .toLowerCase()
+        .split(/[^a-z0-9-]+/)
+        .filter(Boolean)
+        .filter((term) => {
         if (term.length < 3 || seen.has(term))
             return false;
         seen.add(term);
         return true;
     });
 }
-function ok(value) { return { ok: true, value }; }
+function ok(value) {
+    return { ok: true, value };
+}

package/dist/agents/agent-seed-service.js

@@ -85,7 +85,8 @@ export class AgentSeedService {
             seenNames.add(definition.name);
             if (!definition.parentAgentName.trim())
                 return validationFailure(`Subagent ${definition.name} parentAgentName is required`);
-            if (!manifest.agents.some((agent) => agent.name === definition.parentAgentName) && this.resolveExistingParentId(manifest, definition.parentAgentName) === undefined) {
+            if (!manifest.agents.some((agent) => agent.name === definition.parentAgentName) &&
+                this.resolveExistingParentId(manifest, definition.parentAgentName) === undefined) {
                 return validationFailure(`Unresolved parentAgentName: ${definition.parentAgentName}`);
             }
         }

package/dist/agents/manager-profile-overlay-service.js

@@ -30,5 +30,9 @@ export class ManagerProfileOverlayService {
         });
     }
 }
-function ok(value) { return { ok: true, value }; }
-function validationFailure(message) { return { ok: false, error: { code: 'validation_failed', message } }; }
+function ok(value) {
+    return { ok: true, value };
+}
+function validationFailure(message) {
+    return { ok: false, error: { code: 'validation_failed', message } };
+}

package/dist/agents/profile-model-routing.js

@@ -22,5 +22,9 @@ function profileFromAdapter(config) {
     const profile = config?.profile;
     return typeof profile === 'string' && profile.trim().length > 0 ? profile.trim() : undefined;
 }
-function ok(value) { return { ok: true, value }; }
-function validationFailure(message) { return { ok: false, error: { code: 'validation_failed', message } }; }
+function ok(value) {
+    return { ok: true, value };
+}
+function validationFailure(message) {
+    return { ok: false, error: { code: 'validation_failed', message } };
+}

package/dist/agents/renderers/claude-renderer.js

@@ -94,5 +94,9 @@ function claudeAgentKey(value) {
     return pathSegment(value);
 }
 function pathSegment(value) {
-    return value.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '') || 'unnamed';
+    return (value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'unnamed');
 }

package/dist/agents/renderers/index.js

@@ -10,7 +10,5 @@ const renderers = {
 export function getProviderRenderer(provider) {
     const normalized = provider.trim().toLowerCase();
     const renderer = renderers[normalized];
-    return renderer === undefined
-        ? validationFailure(`Unknown provider renderer: ${provider}`)
-        : ok(renderer);
+    return renderer === undefined ? validationFailure(`Unknown provider renderer: ${provider}`) : ok(renderer);
 }

package/dist/agents/renderers/json-renderer.js

@@ -1,4 +1,4 @@
-import { ok, validationFailure } from './provider-adapter.js';
+import { ok, validationFailure, } from './provider-adapter.js';
 const previewSafety = {
     executesProvider: false,
     writesProviderConfig: false,
@@ -6,7 +6,23 @@ const previewSafety = {
     previewOnly: true,
 };
 const jsonCapabilities = {
-    supportedAgentFields: ['id', 'project', 'scope', 'mode', 'name', 'description', 'instructions', 'capabilities', 'permissions', 'memory', 'workflows', 'skills', 'adapters', 'timestamps', 'parentAgentId'],
+    supportedAgentFields: [
+        'id',
+        'project',
+        'scope',
+        'mode',
+        'name',
+        'description',
+        'instructions',
+        'capabilities',
+        'permissions',
+        'memory',
+        'workflows',
+        'skills',
+        'adapters',
+        'timestamps',
+        'parentAgentId',
+    ],
     skillInjectionModes: ['preserved as registry metadata in neutral export'],
     permissionCategories: ['preserved registry permission policy metadata'],
     memoryInjectionModes: ['preserved registry memory scope metadata'],
@@ -41,10 +57,7 @@ export class JsonAgentRenderer {
                 rootAgentId: input.agent.id,
                 rootAgentName: input.agent.name,
                 subagentIds: subagents.map((subagent) => subagent.id),
-                artifacts: [
-                    `${basePath}.agent.json`,
-                    ...subagents.map((subagent) => `${basePath}.subagents/${pathSegment(subagent.name)}.json`),
-                ],
+                artifacts: [`${basePath}.agent.json`, ...subagents.map((subagent) => `${basePath}.subagents/${pathSegment(subagent.name)}.json`)],
             }),
             ...subagents.map((subagent) => jsonArtifact(`${basePath}.subagents/${pathSegment(subagent.name)}.json`, renderedDefinition(subagent, this.provider))),
         ];
@@ -74,7 +87,11 @@ function jsonArtifact(relativePath, value) {
     };
 }
 function pathSegment(value) {
-    return value.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '') || 'unnamed';
+    return (value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'unnamed');
 }
 function firstDuplicate(values) {
     const seen = new Set();

package/dist/agents/renderers/opencode-renderer.js

@@ -8,7 +8,14 @@ const previewSafety = {
     previewOnly: true,
 };
 const openCodeCapabilities = {
-    supportedAgentFields: ['name', 'description', 'instructions', 'mode', 'adapter model', 'adapter config keys: variant, temperature, top_p, hidden, options, color, steps, permission'],
+    supportedAgentFields: [
+        'name',
+        'description',
+        'instructions',
+        'mode',
+        'adapter model',
+        'adapter config keys: variant, temperature, top_p, hidden, options, color, steps, permission',
+    ],
     skillInjectionModes: ['external preview services may inject skill payloads before rendering; renderer does not resolve skills'],
     permissionCategories: ['registry permission metadata mapped from adapter permission config'],
     memoryInjectionModes: ['external preview services may inject memory payloads before rendering; renderer does not load memory'],
@@ -43,7 +50,7 @@ export class OpenCodeAgentRenderer {
         const artifact = {
             relativePath: `rendered/opencode/${pathSegment(input.agent.project)}/${input.agent.scope}/${pathSegment(input.agent.name)}/opencode.json`,
             contentType: 'application/json',
-            contents: `${JSON.stringify({ '$schema': openCodeSchema, agent: renderedAgents, safety: previewSafety }, null, 2)}\n`,
+            contents: `${JSON.stringify({ $schema: openCodeSchema, agent: renderedAgents, safety: previewSafety }, null, 2)}\n`,
         };
         return ok({
             provider: this.provider,
@@ -96,5 +103,9 @@ function openCodeAgentKey(value) {
     return pathSegment(value);
 }
 function pathSegment(value) {
-    return value.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '') || 'unnamed';
+    return (value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'unnamed');
 }

package/dist/agents/repositories/agents.js

@@ -19,7 +19,8 @@ export class AgentRepository {
             const id = existing?.id ?? randomUUID();
             const now = new Date().toISOString();
             const parameters = toRowParameters(input, id, existing?.created_at ?? now, now);
-            this.db.connection.prepare(`
+            this.db.connection
+                .prepare(`
         INSERT INTO agents(id, project, scope, mode, name, description, instructions_json, capabilities_json, permissions_json, memory_json, workflows_json, skills_json, adapters_json, parent_agent_id, created_at, updated_at)
         VALUES (@id, @project, @scope, @mode, @name, @description, @instructionsJson, @capabilitiesJson, @permissionsJson, @memoryJson, @workflowsJson, @skillsJson, @adaptersJson, @parentAgentId, @createdAt, @updatedAt)
         ON CONFLICT(project, scope, name) DO UPDATE SET
@@ -34,7 +35,8 @@ export class AgentRepository {
           adapters_json=excluded.adapters_json,
           parent_agent_id=excluded.parent_agent_id,
           updated_at=excluded.updated_at
-      `).run(parameters);
+      `)
+                .run(parameters);
             const found = this.getById(id);
             if (!found.ok)
                 throw new Error(found.error.message);
@@ -67,18 +69,25 @@ export class AgentRepository {
         try {
             const where = [];
             const parameters = {};
-            for (const [key, column] of [['project', 'project'], ['scope', 'scope'], ['mode', 'mode'], ['parentAgentId', 'parent_agent_id']]) {
+            for (const [key, column] of [
+                ['project', 'project'],
+                ['scope', 'scope'],
+                ['mode', 'mode'],
+                ['parentAgentId', 'parent_agent_id'],
+            ]) {
                 const value = filters[key];
                 if (value !== undefined) {
                     where.push(`${column}=@${key}`);
                     parameters[key] = value;
                 }
             }
-            const rows = this.db.connection.prepare(`
+            const rows = this.db.connection
+                .prepare(`
         SELECT * FROM agents
         ${where.length ? `WHERE ${where.join(' AND ')}` : ''}
         ORDER BY name ASC
-      `).all(parameters);
+      `)
+                .all(parameters);
             return ok(rows.map((row) => toSummary(map(row))));
         }
         catch (cause) {
@@ -172,9 +181,15 @@ function toSummary(agent) {
         value.parentAgentId = agent.parentAgentId;
     return value;
 }
-function ok(value) { return { ok: true, value }; }
-function missing(message) { return { ok: false, error: { code: 'not_found', message } }; }
-function validationFailure(message) { return { ok: false, error: { code: 'validation_failed', message } }; }
+function ok(value) {
+    return { ok: true, value };
+}
+function missing(message) {
+    return { ok: false, error: { code: 'not_found', message } };
+}
+function validationFailure(message) {
+    return { ok: false, error: { code: 'validation_failed', message } };
+}
 function fail(message, cause) {
     const error = { code: 'validation_failed', message };
     if (cause !== undefined)

package/dist/agents/repositories/manager-profile-overlays.js

@@ -12,13 +12,15 @@ export class ManagerProfileOverlayRepository {
             const existing = this.find(input.project, input.scope, input.managerName);
             const id = existing?.id ?? randomUUID();
             const now = new Date().toISOString();
-            this.db.connection.prepare(`
+            this.db.connection
+                .prepare(`
         INSERT INTO manager_profile_overlays(id, project, scope, manager_name, instructions, created_at, updated_at)
         VALUES (@id, @project, @scope, @managerName, @instructions, @createdAt, @updatedAt)
         ON CONFLICT(project, scope, manager_name) DO UPDATE SET
           instructions=excluded.instructions,
           updated_at=excluded.updated_at
-      `).run({
+      `)
+                .run({
                 id,
                 project: input.project.trim(),
                 scope: input.scope,
@@ -46,7 +48,8 @@ export class ManagerProfileOverlayRepository {
         }
     }
     find(project, scope, managerName) {
-        return this.db.connection.prepare('SELECT * FROM manager_profile_overlays WHERE project=? AND scope=? AND manager_name=?')
+        return this.db.connection
+            .prepare('SELECT * FROM manager_profile_overlays WHERE project=? AND scope=? AND manager_name=?')
             .get(project.trim(), scope, managerName.trim());
     }
 }
@@ -70,9 +73,15 @@ function map(row) {
         updatedAt: row.updated_at,
     };
 }
-function ok(value) { return { ok: true, value }; }
-function missing(message) { return { ok: false, error: { code: 'not_found', message } }; }
-function validationFailure(message) { return { ok: false, error: { code: 'validation_failed', message } }; }
+function ok(value) {
+    return { ok: true, value };
+}
+function missing(message) {
+    return { ok: false, error: { code: 'not_found', message } };
+}
+function validationFailure(message) {
+    return { ok: false, error: { code: 'validation_failed', message } };
+}
 function fail(message, cause) {
     const error = { code: 'validation_failed', message };
     if (cause !== undefined)