@pellux/goodvibes-agent 0.1.117 → 1.0.0

package/src/cli/agent-knowledge-format.ts

@@ -6,7 +6,7 @@ export interface AgentKnowledgeFailureLike {
   readonly error: string;
   readonly baseUrl: string;
   readonly route: string;
-  readonly daemonVersion?: string;
+  readonly connectedHostVersion?: string;
   readonly expectedSdkVersion?: string;
 }
 
@@ -42,6 +42,15 @@ function yesNo(value: boolean): string {
   return value ? 'yes' : 'no';
 }
 
+export function formatAgentKnowledgeFailureKind(kind: string): string {
+  if (kind === 'auth_required') return 'authorization required';
+  if (kind === 'connected_host_unavailable') return 'connected host unavailable';
+  if (kind === 'connected_host_route_unavailable') return 'connected host route unavailable';
+  if (kind === 'connected_host_error') return 'connected host error';
+  if (kind === 'version_mismatch') return 'version mismatch';
+  return kind.replace(/[_-]+/g, ' ');
+}
+
 function sourceLine(value: unknown): string {
   const record = isRecord(value) ? value : {};
   const title = cleanInline(record.title)
@@ -65,9 +74,9 @@ function resultLine(value: unknown): string {
   const snippet = cleanInline(record.snippet) || cleanInline(record.summary) || cleanInline(record.text);
   const parts = [
     `[${type}] ${title}`,
-    id && id !== title ? `id=${id}` : '',
-    score !== null ? `score=${score.toFixed(3)}` : '',
-    url ? `url=${url}` : '',
+    id && id !== title ? `id ${id}` : '',
+    score !== null ? `score ${score.toFixed(3)}` : '',
+    url ? `url ${url}` : '',
   ].filter((part) => part.length > 0);
   return snippet ? `${parts.join('  ')}\n    ${snippet}` : parts.join('  ');
 }
@@ -82,9 +91,9 @@ function nodeLine(value: unknown): string {
   const summary = cleanInline(record.summary);
   const parts = [
     `[${kind}] ${title}`,
-    id && id !== title ? `id=${id}` : '',
-    status ? `status=${status}` : '',
-    confidence !== null ? `confidence=${confidence}` : '',
+    id && id !== title ? `id ${id}` : '',
+    status ? `status ${status}` : '',
+    confidence !== null ? `confidence ${confidence}` : '',
   ].filter((part) => part.length > 0);
   return summary ? `${parts.join('  ')}\n    ${summary}` : parts.join('  ');
 }
@@ -96,7 +105,7 @@ function issueLine(value: unknown): string {
   const code = cleanInline(record.code) || 'issue';
   const status = cleanInline(record.status);
   const message = cleanInline(record.message);
-  const suffix = status ? ` status=${status}` : '';
+  const suffix = status ? ` status ${status}` : '';
   return `  - ${id} [${severity}] ${code}${suffix}${message ? ` - ${message}` : ''}`;
 }
 
@@ -106,10 +115,14 @@ function connectorLine(value: unknown): string {
   const name = cleanInline(record.displayName) || id;
   const sourceType = cleanInline(record.sourceType);
   const description = cleanInline(record.description);
-  const suffix = sourceType ? ` sourceType=${sourceType}` : '';
+  const suffix = sourceType ? `  source type ${sourceType}` : '';
   return description ? `  - ${id}  ${name}${suffix}\n    ${description}` : `  - ${id}  ${name}${suffix}`;
 }
 
+function relatedKnowledgeCountsLine(relatedEdges: number, linkedSources: number, linkedNodes: number): string {
+  return `  related edges ${relatedEdges}  linked sources ${linkedSources}  linked nodes ${linkedNodes}`;
+}
+
 export function formatStatus(data: unknown): string {
   const record = isRecord(data) ? data : {};
   const ready = readBoolean(record, 'ready');
@@ -120,13 +133,13 @@ export function formatStatus(data: unknown): string {
   const storagePath = readString(record, 'storagePath');
   return [
     'Agent Knowledge status',
-    `  ready: ${ready === null ? 'unknown' : yesNo(ready)}`,
-    `  sources: ${sourceCount ?? 'unknown'}`,
-    `  nodes: ${nodeCount ?? 'unknown'}`,
-    `  edges: ${edgeCount ?? 'unknown'}`,
-    `  issues: ${issueCount ?? 'unknown'}`,
-    storagePath ? `  storage: ${storagePath}` : null,
-    '  route: /api/goodvibes-agent/knowledge/status',
+    `  ready ${ready === null ? 'unknown' : yesNo(ready)}`,
+    `  sources ${sourceCount ?? 'unknown'}`,
+    `  nodes ${nodeCount ?? 'unknown'}`,
+    `  edges ${edgeCount ?? 'unknown'}`,
+    `  issues ${issueCount ?? 'unknown'}`,
+    storagePath ? `  storage ${storagePath}` : null,
+    '  route /api/goodvibes-agent/knowledge/status',
   ].filter((line): line is string => Boolean(line)).join('\n');
 }
 
@@ -137,7 +150,7 @@ export function formatEntityList(data: unknown, kind: 'sources' | 'nodes' | 'iss
     return [
       `Agent Knowledge ${kind}`,
       '  no records',
-      `  route: /api/goodvibes-agent/knowledge/${kind}`,
+      `  route /api/goodvibes-agent/knowledge/${kind}`,
     ].join('\n');
   }
   const format = kind === 'sources'
@@ -163,29 +176,29 @@ export function formatItem(data: unknown, id: string): string {
   const linkedNodes = readArray(record, 'linkedNodes').length;
   if (source) {
     return [
-      `Agent Knowledge item: ${id}`,
+      `Agent Knowledge item ${id}`,
       `  ${sourceLine(source)}`,
-      `  relatedEdges=${relatedEdges} linkedSources=${linkedSources} linkedNodes=${linkedNodes}`,
+      relatedKnowledgeCountsLine(relatedEdges, linkedSources, linkedNodes),
     ].join('\n');
   }
   if (node) {
     return [
-      `Agent Knowledge item: ${id}`,
+      `Agent Knowledge item ${id}`,
       `  ${nodeLine(node)}`,
-      `  relatedEdges=${relatedEdges} linkedSources=${linkedSources} linkedNodes=${linkedNodes}`,
+      relatedKnowledgeCountsLine(relatedEdges, linkedSources, linkedNodes),
     ].join('\n');
   }
   if (issue) {
     return [
-      `Agent Knowledge item: ${id}`,
+      `Agent Knowledge item ${id}`,
       issueLine(issue),
-      `  relatedEdges=${relatedEdges} linkedSources=${linkedSources} linkedNodes=${linkedNodes}`,
+      relatedKnowledgeCountsLine(relatedEdges, linkedSources, linkedNodes),
     ].join('\n');
   }
   return [
-    `Agent Knowledge item: ${id}`,
+    `Agent Knowledge item ${id}`,
     '  not found',
-    '  route: /api/goodvibes-agent/knowledge/items/{id}',
+    '  route /api/goodvibes-agent/knowledge/items/{id}',
   ].join('\n');
 }
 
@@ -201,7 +214,7 @@ export function formatMap(data: unknown): string {
     `  nodes: ${nodes.length}`,
     `  edges: ${edges.length}`,
     `  issues: ${issues.length}`,
-    '  route: /api/goodvibes-agent/knowledge/map',
+    '  route /api/goodvibes-agent/knowledge/map',
   ].join('\n');
 }
 
@@ -212,7 +225,7 @@ export function formatConnectors(data: unknown): string {
     return [
       'Agent Knowledge connectors',
       '  no connectors',
-      '  route: /api/goodvibes-agent/knowledge/connectors',
+      '  route /api/goodvibes-agent/knowledge/connectors',
     ].join('\n');
   }
   return [
@@ -231,13 +244,13 @@ export function formatConnector(data: unknown, id: string): string {
   const capabilities = readArray(connector, 'capabilities').map(cleanInline).filter(Boolean);
   const examples = readArray(connector, 'examples');
   return [
-    `Agent Knowledge connector: ${connectorId}`,
-    `  name: ${name}`,
-    sourceType ? `  sourceType: ${sourceType}` : null,
-    description ? `  description: ${description}` : null,
+    `Agent Knowledge connector ${connectorId}`,
+    `  name ${name}`,
+    sourceType ? `  source type ${sourceType}` : null,
+    description ? `  description ${description}` : null,
     capabilities.length > 0 ? `  capabilities: ${capabilities.join(', ')}` : null,
-    `  examples: ${examples.length}`,
-    '  route: /api/goodvibes-agent/knowledge/connectors/{id}',
+    `  examples ${examples.length}`,
+    '  route /api/goodvibes-agent/knowledge/connectors/{id}',
   ].filter((line): line is string => Boolean(line)).join('\n');
 }
 
@@ -248,10 +261,10 @@ export function formatConnectorDoctor(data: unknown, id: string): string {
   const checks = readArray(record, 'checks');
   const hints = readArray(record, 'hints').map(cleanInline).filter(Boolean);
   return [
-    `Agent Knowledge connector doctor: ${cleanInline(record.connectorId) || id}`,
-    `  ready: ${ready === null ? 'unknown' : yesNo(ready)}`,
-    summary ? `  summary: ${summary}` : null,
-    checks.length > 0 ? '  checks:' : null,
+    `Agent Knowledge connector doctor ${cleanInline(record.connectorId) || id}`,
+    `  ready ${ready === null ? 'unknown' : yesNo(ready)}`,
+    summary ? `  summary ${summary}` : null,
+    checks.length > 0 ? '  checks' : null,
     ...checks.slice(0, 10).map((check) => {
       const item = isRecord(check) ? check : {};
       const checkId = cleanInline(item.id) || 'check';
@@ -260,9 +273,9 @@ export function formatConnectorDoctor(data: unknown, id: string): string {
       const detail = cleanInline(item.detail);
       return `    - ${checkId} [${status}] ${label}${detail ? ` - ${detail}` : ''}`;
     }),
-    hints.length > 0 ? '  hints:' : null,
+    hints.length > 0 ? '  hints' : null,
     ...hints.slice(0, 8).map((hint) => `    - ${hint}`),
-    '  route: /api/goodvibes-agent/knowledge/connectors/{id}/doctor',
+    '  route /api/goodvibes-agent/knowledge/connectors/{id}/doctor',
   ].filter((line): line is string => Boolean(line)).join('\n');
 }
 
@@ -276,16 +289,16 @@ export function formatAsk(data: unknown, query: string): string {
   const facts = readArray(answer, 'facts');
   const gaps = readArray(answer, 'gaps');
   const lines = [
-    `Agent Knowledge answer: ${query}`,
+    `Agent Knowledge answer ${query}`,
     text,
     '',
-    `confidence: ${confidence ?? 'unknown'}${synthesized === null ? '' : `  synthesized: ${yesNo(synthesized)}`}`,
+    `confidence ${confidence ?? 'unknown'}${synthesized === null ? '' : `  synthesized ${yesNo(synthesized)}`}`,
   ];
   if (sources.length > 0) {
-    lines.push('', 'Sources:', ...sources.slice(0, 8).map((source) => `  - ${sourceLine(source)}`));
+    lines.push('', 'Sources', ...sources.slice(0, 8).map((source) => `  - ${sourceLine(source)}`));
   }
-  if (facts.length > 0) lines.push('', `Facts: ${facts.length}`);
-  if (gaps.length > 0) lines.push('', `Gaps: ${gaps.length}`);
+  if (facts.length > 0) lines.push('', `Facts ${facts.length}`);
+  if (gaps.length > 0) lines.push('', `Gaps ${gaps.length}`);
   return lines.join('\n');
 }
 
@@ -295,13 +308,13 @@ export function formatSearch(data: unknown, query: string): string {
   const results = items.length > 0 ? items : readArray(record, 'results');
   if (results.length === 0) {
     return [
-      `Agent Knowledge search: ${query}`,
+      `Agent Knowledge search ${query}`,
       '  no results',
-      '  route: /api/goodvibes-agent/knowledge/search',
+      '  route /api/goodvibes-agent/knowledge/search',
     ].join('\n');
   }
   return [
-    `Agent Knowledge search: ${query}`,
+    `Agent Knowledge search ${query}`,
     ...results.slice(0, 10).map((result, index) => `  ${index + 1}. ${resultLine(result)}`),
   ].join('\n');
 }
@@ -320,10 +333,10 @@ export function formatIngest(
   const artifactId = cleanInline(record.artifactId);
   return [
     `Agent Knowledge ${label} accepted`,
-    `  source: ${sourceId || '(pending)'}`,
-    `  ${targetLabel}: ${canonicalUri}`,
+    `  knowledge source ${sourceId || '(pending)'}`,
+    `  ${targetLabel} ${canonicalUri}`,
     artifactId ? `  artifact: ${artifactId}` : null,
-    `  route: ${route}`,
+    `  route ${route}`,
   ].filter((line): line is string => Boolean(line)).join('\n');
 }
 
@@ -335,11 +348,11 @@ export function formatBatchIngest(data: unknown, label: string): string {
   const errors = readArray(record, 'errors');
   return [
     `Agent Knowledge ${label} accepted`,
-    `  imported: ${imported ?? sources.length}`,
-    `  failed: ${failed ?? errors.length}`,
-    `  sources: ${sources.length}`,
+    `  imported ${imported ?? sources.length}`,
+    `  failed ${failed ?? errors.length}`,
+    `  sources ${sources.length}`,
     ...sources.slice(0, 5).map((source) => `  - ${sourceLine(source)}`),
-    ...(errors.length > 0 ? ['  errors:', ...errors.slice(0, 5).map((error) => `  - ${cleanInline(error)}`)] : []),
+    ...(errors.length > 0 ? ['  errors', ...errors.slice(0, 5).map((error) => `  - ${cleanInline(error)}`)] : []),
   ].join('\n');
 }
 
@@ -348,29 +361,29 @@ export function formatReindex(data: unknown): string {
   const status = isRecord(record.status) ? record.status : {};
   return [
     'Agent Knowledge reindex complete',
-    `  sources: ${readNumber(status, 'sourceCount') ?? 'unknown'}`,
-    `  nodes: ${readNumber(status, 'nodeCount') ?? 'unknown'}`,
-    `  edges: ${readNumber(status, 'edgeCount') ?? 'unknown'}`,
-    `  issues: ${readNumber(status, 'issueCount') ?? 'unknown'}`,
-    '  route: /api/goodvibes-agent/knowledge/reindex',
+    `  sources ${readNumber(status, 'sourceCount') ?? 'unknown'}`,
+    `  nodes ${readNumber(status, 'nodeCount') ?? 'unknown'}`,
+    `  edges ${readNumber(status, 'edgeCount') ?? 'unknown'}`,
+    `  issues ${readNumber(status, 'issueCount') ?? 'unknown'}`,
+    '  route /api/goodvibes-agent/knowledge/reindex',
   ].join('\n');
 }
 
 export function formatFailure(failure: AgentKnowledgeFailureLike, json: boolean): string {
   if (json) return JSON.stringify(failure, null, 2);
   return [
-    `Agent Knowledge error: ${failure.kind}`,
+    `Agent Knowledge error ${failure.kind} (${formatAgentKnowledgeFailureKind(failure.kind)})`,
     `  ${failure.error}`,
-    `  runtime: ${failure.baseUrl}`,
-    `  route: ${failure.route}`,
-    failure.kind === 'version_mismatch' && failure.daemonVersion && failure.expectedSdkVersion
-      ? `  versions: runtime=${failure.daemonVersion} expected=${failure.expectedSdkVersion}`
+    `  connected host ${failure.baseUrl}`,
+    `  route ${failure.route}`,
+    failure.kind === 'version_mismatch' && failure.connectedHostVersion && failure.expectedSdkVersion
+      ? `  versions connected host ${failure.connectedHostVersion}; expected ${failure.expectedSdkVersion}`
       : null,
     failure.kind === 'version_mismatch'
-      ? '  next: update the connected GoodVibes host so /status matches the Agent SDK pin.'
+      ? '  next update the connected GoodVibes host so /status matches the Agent SDK pin.'
       : null,
-    failure.kind === 'daemon_route_unavailable'
-      ? '  next: update the connected GoodVibes host to the SDK version required by this Agent package.'
+    failure.kind === 'connected_host_route_unavailable'
+      ? '  next update the connected GoodVibes host to the SDK version required by this Agent package.'
       : null,
   ].filter((line): line is string => Boolean(line)).join('\n');
 }

package/src/cli/agent-knowledge-methods.ts

@@ -1,4 +1,4 @@
-export interface DaemonCallMethod {
+export interface ConnectedHostCallMethod {
   readonly kind: string;
   readonly route: string;
 }

package/src/cli/agent-knowledge-runtime.ts

@@ -3,24 +3,30 @@ import { join } from 'node:path';
 import { createBrowserAgentSdk } from '@pellux/goodvibes-sdk/browser/agent';
 import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils';
 import { SDK_VERSION, VERSION } from '../version.ts';
-import type { CliCommandRuntime } from './management.ts';
-import type { DaemonCallMethod } from './agent-knowledge-methods.ts';
+import type { ConnectedHostCallMethod } from './agent-knowledge-methods.ts';
 
 export type JsonRecord = Record<string, unknown>;
 
-export interface AgentDaemonConnection {
+export interface AgentKnowledgeConnection {
   readonly baseUrl: string;
   readonly token: string | null;
   readonly tokenPath: string;
 }
 
+export interface AgentKnowledgeConnectionRuntime {
+  readonly configManager: {
+    get(key: string): unknown;
+  };
+  readonly homeDirectory: string;
+}
+
 export interface AgentKnowledgeFailure {
   readonly ok: false;
-  readonly kind: 'daemon_unavailable' | 'auth_required' | 'version_mismatch' | 'daemon_route_unavailable' | 'daemon_error';
+  readonly kind: 'connected_host_unavailable' | 'auth_required' | 'version_mismatch' | 'connected_host_route_unavailable' | 'connected_host_error';
   readonly error: string;
   readonly baseUrl: string;
   readonly route: string;
-  readonly daemonVersion?: string;
+  readonly connectedHostVersion?: string;
   readonly expectedSdkVersion?: string;
 }
 
@@ -46,7 +52,7 @@ export function readPackageMetadata(): { readonly version: string; readonly sdkV
   return { version: VERSION, sdkVersion: SDK_VERSION };
 }
 
-export function resolveDaemonConnection(runtime: CliCommandRuntime): AgentDaemonConnection {
+export function resolveConnectedHostConnection(runtime: AgentKnowledgeConnectionRuntime): AgentKnowledgeConnection {
   const host = String(runtime.configManager.get('controlPlane.host') ?? '127.0.0.1');
   const port = Number(runtime.configManager.get('controlPlane.port') ?? 3421);
   const baseUrl = `http://${host}:${Number.isFinite(port) ? port : 3421}`;
@@ -61,7 +67,7 @@ export function resolveDaemonConnection(runtime: CliCommandRuntime): AgentDaemon
   }
 }
 
-export async function fetchDaemonStatus(connection: AgentDaemonConnection): Promise<{ readonly ok: boolean; readonly status: number; readonly body: unknown }> {
+export async function fetchConnectedHostStatus(connection: AgentKnowledgeConnection): Promise<{ readonly ok: boolean; readonly status: number; readonly body: unknown }> {
   try {
     const response = await fetch(`${connection.baseUrl}/status`, {
       headers: connection.token ? { authorization: `Bearer ${connection.token}` } : undefined,
@@ -79,7 +85,7 @@ export async function fetchDaemonStatus(connection: AgentDaemonConnection): Prom
   }
 }
 
-export async function classifyKnowledgeError(error: unknown, connection: AgentDaemonConnection, route: string): Promise<AgentKnowledgeFailure> {
+export async function classifyKnowledgeError(error: unknown, connection: AgentKnowledgeConnection, route: string): Promise<AgentKnowledgeFailure> {
   const message = summarizeError(error);
   const lower = message.toLowerCase();
   if (lower.includes('401') || lower.includes('unauthorized') || lower.includes('auth')) {
@@ -87,29 +93,29 @@ export async function classifyKnowledgeError(error: unknown, connection: AgentDa
   }
   if (lower.includes('404') || lower.includes('not found')) {
     const metadata = readPackageMetadata();
-    const daemon = await fetchDaemonStatus(connection);
-    const daemonRecord = isRecord(daemon.body) ? daemon.body : {};
-    const daemonVersion = readString(daemonRecord, 'version') ?? 'unknown';
-    if (daemon.ok && daemonVersion !== metadata.sdkVersion) {
+    const connectedHost = await fetchConnectedHostStatus(connection);
+    const connectedHostRecord = isRecord(connectedHost.body) ? connectedHost.body : {};
+    const connectedHostVersion = readString(connectedHostRecord, 'version') ?? 'unknown';
+    if (connectedHost.ok && connectedHostVersion !== metadata.sdkVersion) {
       return {
         ok: false,
         kind: 'version_mismatch',
-        error: `Connected GoodVibes host SDK version ${daemonVersion} does not match Agent SDK pin ${metadata.sdkVersion}; Agent Knowledge route is unavailable.`,
+        error: `Connected GoodVibes host SDK version ${connectedHostVersion} does not match Agent SDK pin ${metadata.sdkVersion}; Agent Knowledge route is unavailable.`,
         baseUrl: connection.baseUrl,
         route,
-        daemonVersion,
+        connectedHostVersion,
         expectedSdkVersion: metadata.sdkVersion,
       };
     }
-    return { ok: false, kind: 'daemon_route_unavailable', error: message, baseUrl: connection.baseUrl, route };
+    return { ok: false, kind: 'connected_host_route_unavailable', error: message, baseUrl: connection.baseUrl, route };
   }
   if (lower.includes('fetch') || lower.includes('connect') || lower.includes('econnrefused')) {
-    return { ok: false, kind: 'daemon_unavailable', error: message, baseUrl: connection.baseUrl, route };
+    return { ok: false, kind: 'connected_host_unavailable', error: message, baseUrl: connection.baseUrl, route };
   }
-  return { ok: false, kind: 'daemon_error', error: message, baseUrl: connection.baseUrl, route };
+  return { ok: false, kind: 'connected_host_error', error: message, baseUrl: connection.baseUrl, route };
 }
 
-export function createAgentSdk(connection: AgentDaemonConnection) {
+export function createAgentSdk(connection: AgentKnowledgeConnection) {
   return createBrowserAgentSdk({
     baseUrl: connection.baseUrl,
     authToken: connection.token,
@@ -117,7 +123,7 @@ export function createAgentSdk(connection: AgentDaemonConnection) {
 }
 
 export async function postAgentKnowledgeJson<TData>(
-  connection: AgentDaemonConnection,
+  connection: AgentKnowledgeConnection,
   route: string,
   body: JsonRecord,
 ): Promise<TData> {
@@ -164,7 +170,7 @@ function queryRoute(route: string, query: JsonRecord): string {
 }
 
 export async function getAgentKnowledgeJson<TData>(
-  connection: AgentDaemonConnection,
+  connection: AgentKnowledgeConnection,
   route: string,
   query: JsonRecord = {},
 ): Promise<TData> {
@@ -211,22 +217,22 @@ export function findDisallowedKnowledgeScopeFlag(args: readonly string[]): strin
 export function formatScopeFlagRejection(flag: string): string {
   return [
     `Agent Knowledge is isolated; ${flag} is not accepted.`,
-    'GoodVibes Agent must not use default Knowledge/Wiki or non-Agent product spaces.',
+    'GoodVibes Agent must not use default knowledge or non-Agent product spaces.',
     'Use only /api/goodvibes-agent/knowledge/* Agent-owned routes.',
   ].join('\n');
 }
 
 export async function runKnowledgeCall<TData>(
-  runtime: CliCommandRuntime,
-  method: DaemonCallMethod,
-  call: (connection: AgentDaemonConnection) => Promise<TData>,
+  runtime: AgentKnowledgeConnectionRuntime,
+  method: ConnectedHostCallMethod,
+  call: (connection: AgentKnowledgeConnection) => Promise<TData>,
 ): Promise<AgentKnowledgeResult<TData>> {
-  const connection = resolveDaemonConnection(runtime);
+  const connection = resolveConnectedHostConnection(runtime);
   if (!connection.token) {
     return {
       ok: false,
       kind: 'auth_required',
-      error: `No runtime operator token found at ${connection.tokenPath}`,
+      error: `No connected-host operator token found at ${connection.tokenPath}`,
       baseUrl: connection.baseUrl,
       route: method.route,
     };

package/src/cli/bundle-command.ts

@@ -8,7 +8,6 @@ import { createRuntimeStore } from '../runtime/store/index.ts';
 import { getOnboardingCheckMarkerPath } from '../runtime/onboarding/index.ts';
 import { CONFIG_SCHEMA } from '../config/index.ts';
 import { SecretsManager } from '../config/secrets.ts';
-import type { ConfigKey } from '../config/index.ts';
 import type { CliCommandRuntime } from './management.ts';
 import type { CliCommandOutput } from './types.ts';
 import { getPackageVersion } from './help.ts';
@@ -35,14 +34,20 @@ function getNestedValue(source: unknown, key: string): unknown {
   let cursor = source;
   for (const part of key.split('.')) {
     if (cursor == null || typeof cursor !== 'object') return undefined;
-    cursor = (cursor as Record<string, unknown>)[part];
+    cursor = Reflect.get(cursor, part);
   }
   return cursor;
 }
 
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+
 function readJsonFile(path: string): { readonly ok: true; readonly value: Record<string, unknown> } | { readonly ok: false; readonly error: string } {
   try {
-    return { ok: true, value: JSON.parse(readFileSync(path, 'utf-8')) as Record<string, unknown> };
+    const value = JSON.parse(readFileSync(path, 'utf-8')) as unknown;
+    if (!isRecord(value)) return { ok: false, error: 'Bundle file must contain a JSON object.' };
+    return { ok: true, value };
   } catch (error) {
     return { ok: false, error: error instanceof Error ? error.message : String(error) };
   }
@@ -128,7 +133,7 @@ export async function handleBundleCommand(runtime: CliCommandRuntime): Promise<C
     if (!path) return { output: `Usage: ${runtime.cli.binary} bundle inspect <path>`, exitCode: 2 };
     const sourcePath = shellPaths.resolveWorkspacePath(path);
     const parsed = readJsonFile(sourcePath);
-    if (!parsed.ok) return { output: `Invalid bundle JSON: ${parsed.error}`, exitCode: 1 };
+    if (!parsed.ok) return { output: `Invalid bundle JSON ${parsed.error}`, exitCode: 1 };
     const summary = inspectBundle(sourcePath, parsed.value);
     return {
       output: formatJsonOrText(runtime, summary, [
@@ -191,8 +196,8 @@ export async function handleBundleCommand(runtime: CliCommandRuntime): Promise<C
       output: formatJsonOrText(runtime, {
         path: targetPath,
         redactedConfigPaths: redactedConfig.redactedPaths,
-        serviceIssues: service.issues,
-      }, `Bundle exported: ${targetPath}\n  redactedConfigKeys: ${redactedConfig.redactedPaths.length}\n  serviceIssues: ${service.issues.length}`),
+        hostIntegrationIssues: service.issues,
+      }, `Bundle exported: ${targetPath}\n  redactedConfigKeys: ${redactedConfig.redactedPaths.length}\n  hostIntegrationIssues: ${service.issues.length}`),
       exitCode: 0,
     };
   }
@@ -202,7 +207,7 @@ export async function handleBundleCommand(runtime: CliCommandRuntime): Promise<C
     if (!path) return { output: `Usage: ${runtime.cli.binary} bundle import <path>`, exitCode: 2 };
     const sourcePath = shellPaths.resolveWorkspacePath(path);
     const parsed = readJsonFile(sourcePath);
-    if (!parsed.ok) return { output: `Invalid bundle JSON: ${parsed.error}`, exitCode: 1 };
+    if (!parsed.ok) return { output: `Invalid bundle JSON ${parsed.error}`, exitCode: 1 };
     const config = parsed.value['config'];
     if (!config || typeof config !== 'object') return { output: 'Bundle has no config object to import.', exitCode: 1 };
     let count = 0;
@@ -214,7 +219,7 @@ export async function handleBundleCommand(runtime: CliCommandRuntime): Promise<C
         skippedRedacted++;
         continue;
       }
-      runtime.configManager.setDynamic(setting.key as ConfigKey, value as never);
+      runtime.configManager.setDynamic(setting.key, value);
       count++;
     }
     return {