@pellux/goodvibes-agent 0.1.47 → 0.1.49

package/src/operator/capability-benchmark.ts

@@ -1,244 +0,0 @@
-export type CompetitorProduct = 'openclaw' | 'hermes';
-
-export type CapabilityPosture =
-  | 'ready'
-  | 'configurable'
-  | 'external-daemon'
-  | 'explicit-delegation'
-  | 'guarded'
-  | 'in-progress';
-
-export interface OperatorCapabilityBenchmark {
-  readonly id: string;
-  readonly title: string;
-  readonly posture: CapabilityPosture;
-  readonly competitors: readonly CompetitorProduct[];
-  readonly competitorBaseline: string;
-  readonly goodvibesDaemon?: string;
-  readonly goodvibesAgent: string;
-  readonly configure: readonly string[];
-  readonly use: readonly string[];
-  readonly exceedsBy: readonly string[];
-  readonly next: readonly string[];
-}
-
-export interface OperatorCapabilityBenchmarkReport {
-  readonly generatedAt: string;
-  readonly packageName: '@pellux/goodvibes-agent';
-  readonly benchmarkSources: readonly string[];
-  readonly capabilities: readonly OperatorCapabilityBenchmark[];
-}
-
-export const OPERATOR_CAPABILITY_BENCHMARK_SOURCES = [
-  'https://github.com/openclaw/openclaw/blob/main/README.md',
-  'https://docs.openclaw.ai/',
-  'https://docs.openclaw.ai/concepts/features',
-  'https://docs.openclaw.ai/help/faq',
-  'https://docs.openclaw.ai/concepts/memory',
-  'https://github.com/NousResearch/hermes-agent',
-  'https://hermes-agent.nousresearch.com/docs/user-guide/features/overview/',
-  'https://hermes-agent.nousresearch.com/docs/user-guide/features/tools/',
-  'https://hermes-agent.nousresearch.com/docs/user-guide/features/skills/',
-  'https://hermes-agent.nousresearch.com/docs/user-guide/features/cron/',
-  'https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp/',
-  'https://hermes-agent.nousresearch.com/docs/user-guide/features/voice-mode/',
-  'https://hermes-agent.nousresearch.com/docs/user-guide/features/api-server/',
-  'https://hermes-agent.nousresearch.com/docs/user-guide/profiles/',
-  '@pellux/goodvibes-sdk@0.33.35 public operator contract and /api/goodvibes-agent/knowledge routes',
-] as const;
-
-export const OPERATOR_CAPABILITY_BENCHMARKS: readonly OperatorCapabilityBenchmark[] = [
-  {
-    id: 'terminal-operator-ui',
-    title: 'Terminal Operator UI',
-    posture: 'ready',
-    competitors: ['openclaw', 'hermes'],
-    competitorBaseline: 'Interactive CLI/TUI entry point with command discovery and persistent sessions.',
-    goodvibesAgent: 'Near-fork GoodVibes TUI shell, renderer, compositor, input, fullscreen workspace, history, command registry, and release gates.',
-    configure: ['goodvibes-agent onboarding', 'goodvibes-agent status', 'goodvibes-agent --no-alt-screen'],
-    use: ['goodvibes-agent', '/agent', '/help'],
-    exceedsBy: ['Diff-rendered GoodVibes compositor foundation', 'fullscreen operator workspace', 'strict TypeScript/Bun release gates'],
-    next: ['Continue porting more GoodVibes TUI modal/workspace affordances into Agent-first setup flows.'],
-  },
-  {
-    id: 'external-gateway',
-    title: 'Always-On Gateway / Daemon',
-    posture: 'external-daemon',
-    competitors: ['openclaw', 'hermes'],
-    competitorBaseline: 'Always-on gateway/service provides channel ingress, sessions, tools, events, and scheduled execution.',
-    goodvibesDaemon: 'Daemon exposes status/auth/control, sessions, companion chat, channels, remote peers, approvals, automation, schedules, artifacts, MCP, providers, voice, media, web search, and isolated Agent Knowledge routes.',
-    goodvibesAgent: 'Connects to the GoodVibes daemon owned by GoodVibes TUI/daemon tooling; Agent never starts, stops, or owns daemon lifecycle.',
-    configure: ['goodvibes-agent compat', 'goodvibes-agent service check', 'goodvibes-agent control-plane status'],
-    use: ['goodvibes-agent status', 'goodvibes-agent doctor'],
-    exceedsBy: ['Typed SDK/operator contracts', 'explicit external-daemon boundary', 'no hidden lifecycle mutation from Agent'],
-    next: ['Improve daemon route readiness dashboard and setup diagnostics for first-run users.'],
-  },
-  {
-    id: 'multi-channel',
-    title: 'Channels And Companion Surfaces',
-    posture: 'configurable',
-    competitors: ['openclaw', 'hermes'],
-    competitorBaseline: 'Messaging gateway for WhatsApp, Telegram, Slack, Discord, Signal, iMessage, web chat, and related platforms.',
-    goodvibesDaemon: 'Public channel routes include channels.status, channels.capabilities.*, channels.accounts.*, channels.setup.*, channels.directory.*, channels.actions.*, channels.tools.*, channels.targets.resolve, pairing, and companion chat routes.',
-    goodvibesAgent: 'Uses GoodVibes daemon channel, companion, pairing, QR, communication, and session surfaces while keeping side effects behind explicit user action. The Agent workspace exposes channel setup, per-channel readiness, default-target posture, and risk labels as a first-class operator area.',
-    configure: ['goodvibes-agent pair', 'goodvibes-agent qrcode', 'goodvibes-agent surfaces check', '/agent → Channels'],
-    use: ['/agent → Channels', '/communication', '/pair'],
-    exceedsBy: ['Agent-owned safety policy over shared channel routes', 'read-only inspection by default', 'explicit approval path for external side effects', 'channel setup discoverable from the fullscreen operator workspace', 'per-channel readiness and delivery defaults shown without leaking token values'],
-    next: ['Pull live daemon account health and last delivery errors into the Channels workspace when a stable read-only route is available.'],
-  },
-  {
-    id: 'isolated-knowledge-wiki',
-    title: 'Isolated Agent Knowledge / Wiki',
-    posture: 'ready',
-    competitors: ['openclaw', 'hermes'],
-    competitorBaseline: 'Persistent memory and knowledge/wiki layers with search, recall, provenance, and freshness checks.',
-    goodvibesDaemon: 'Agent-specific daemon routes cover /api/goodvibes-agent/knowledge/status, ask, search, ingest, source/node/issue/candidate/refinement/report/job/schedule, projection, GraphQL, and usage surfaces.',
-    goodvibesAgent: 'Uses only /api/goodvibes-agent/knowledge/*; never falls back to default Knowledge/Wiki, HomeGraph, or Home Assistant routes. The Agent workspace exposes isolated ask/search/status, URL/bookmark ingestion, review queue, and consolidation workflows.',
-    configure: ['goodvibes-agent compat', 'goodvibes-agent knowledge status', '/agent → Knowledge'],
-    use: ['goodvibes-agent ask <question>', 'goodvibes-agent search <query>', '/knowledge ask <question>', '/knowledge ingest-url <url> --yes', '/knowledge queue'],
-    exceedsBy: ['Dedicated product segment for Agent knowledge', 'route-level isolation', 'package gates that reject default wiki/HomeGraph fallback', 'fullscreen review/ingest workflow that keeps writes explicit'],
-    next: ['Add artifact and multimodal Agent Knowledge ingest affordances once the Agent-specific route is stable.'],
-  },
-  {
-    id: 'local-memory-skills-personas',
-    title: 'Local Memory, Skills, Personas, And Routines',
-    posture: 'ready',
-    competitors: ['openclaw', 'hermes'],
-    competitorBaseline: 'Skills/procedural memory, persona files, profile state, durable memory, and recurring workflows.',
-    goodvibesAgent: 'Typed local registries for Agent personas, skills, routines, and local memory; active items are injected into the serial main conversation. Runtime profile starters seed curated persona, skill, and routine bundles, and users can export/edit/import local starters.',
-    configure: ['/personas create ...', '/agent-skills create ...', '/routines create ...', '/memory add ...', 'goodvibes-agent profiles create research --template research --yes', 'goodvibes-agent profiles templates import ./starter.json --yes'],
-    use: ['/personas use <id>', '/skills local list', '/routines start <id>', '/memory search <query>', 'goodvibes-agent profiles templates'],
-    exceedsBy: ['Review/stale lifecycle fields', 'secret-value rejection', 'Agent-local state that does not contaminate wiki or HomeGraph', 'starter bundles that remain local and reviewable', 'editable starter JSON for repeatable operator lanes'],
-    next: ['Add guided starter authoring inside the fullscreen Agent workspace.'],
-  },
-  {
-    id: 'automation-schedules',
-    title: 'Automation, Schedules, And Routines',
-    posture: 'configurable',
-    competitors: ['openclaw', 'hermes'],
-    competitorBaseline: 'Cron/scheduler can create, pause, resume, run, remove, and deliver recurring tasks from natural language.',
-    goodvibesDaemon: 'Public daemon routes cover automation.integration.snapshot, automation.jobs.*, automation.runs.*, automation.heartbeat.*, scheduler.capacity, schedules.create/list/run/enable/disable/delete, and delivery policy fields.',
-    goodvibesAgent: 'Observes public automation/schedule routes, keeps local routines separate from daemon jobs, and promotes a local routine into an external daemon schedules.create record only through an exact user command with --yes and optional explicit delivery targets.',
-    configure: ['/schedule list', '/routines create ...', '/schedule promote-routine <id> --cron "0 8 * * *" --delivery-surface slack --yes', 'goodvibes-agent routines promote <id> --every 1d --delivery-webhook https://example.test/hook --yes'],
-    use: ['/schedule list', '/routines start <id>', '/schedule promote-routine <id> --cron <expr> [--delivery-surface slack] --yes', '/schedule receipts', '/schedule reconcile'],
-    exceedsBy: ['No recursive hidden scheduler creation from model tools', 'explicit confirmation for side effects', 'local routines separate from daemon jobs', 'explicit delivery target selection', 'redacted promotion receipts', 'scheduled prompts preserve isolated Agent Knowledge and forbid default wiki/HomeGraph fallback'],
-    next: ['Add deeper live run/delivery history for promoted routines and expose delivery attempt errors in the operator workspace.'],
-  },
-  {
-    id: 'tool-gateway-mcp',
-    title: 'Tools, MCP, And Managed Integrations',
-    posture: 'configurable',
-    competitors: ['openclaw', 'hermes'],
-    competitorBaseline: 'Broad toolsets, MCP integration, browser/web/media tools, and configurable platform-specific tool availability.',
-    goodvibesDaemon: 'Daemon public routes include mcp.servers/tools/config, artifacts.create/get/list/content, web_search.providers/query, providers/model surfaces, media.analyze/generate/transform, multimodal providers, and channel tool/action registries.',
-    goodvibesAgent: 'Uses GoodVibes SDK tool registry, MCP inspection, provider tools, web search, media, plugins, and policy-gated model-visible tools.',
-    configure: ['/mcp servers', '/plugin list', 'goodvibes-agent providers', 'goodvibes-agent models'],
-    use: ['/mcp tools', '/provider current', 'goodvibes-agent search <query>'],
-    exceedsBy: ['Model-visible tool policies for read/write/network boundaries', 'typed contract gates', 'per-tool denial messages aligned with Agent product policy'],
-    next: ['Add a task-intent tool picker so only relevant tools are exposed per turn, reducing schema noise while preserving capability breadth.'],
-  },
-  {
-    id: 'voice-media-canvas',
-    title: 'Voice, Media, Canvas, And Nodes',
-    posture: 'configurable',
-    competitors: ['openclaw', 'hermes'],
-    competitorBaseline: 'Voice/TTS, mobile nodes, live canvas, browser automation, image/video generation, and multimodal analysis.',
-    goodvibesDaemon: 'Daemon public routes include voice.status/providers/voices/tts/stt/realtime, media providers/analyze/generate/transform, multimodal providers, artifacts, remote.snapshot/peers/work, and channel media-capable surfaces.',
-    goodvibesAgent: 'Uses GoodVibes voice/media/browser/node primitives and exposes an Agent workspace for TTS setup, image input, browser/web posture, MCP browser tools, and node/remote inspection.',
-    configure: ['/agent → Voice, Media & Nodes', '/config tts', '/voice review', '/mcp servers'],
-    use: ['/tts <prompt>', '/image <path> <prompt>', '/remote list'],
-    exceedsBy: ['Shared GoodVibes media/provider substrate', 'fullscreen setup visibility', 'read-only browser/node posture by default', 'template commands that cannot run without real target values'],
-    next: ['Add artifact and multimodal Agent Knowledge ingestion once the isolated Agent knowledge route accepts artifact-backed media.'],
-  },
-  {
-    id: 'explicit-build-delegation',
-    title: 'Build/Fix/Review Delegation',
-    posture: 'explicit-delegation',
-    competitors: ['openclaw', 'hermes'],
-    competitorBaseline: 'Terminal/file/code tools and subagents can execute software tasks directly.',
-    goodvibesDaemon: 'Daemon shared-session routes cover sessions.create/list/get/messages/followUp/steer/close/reopen and task/workflow visibility used by GoodVibes TUI-owned execution.',
-    goodvibesAgent: 'Main assistant stays serial. Explicit build/fix/review/code work is delegated to GoodVibes TUI/shared-session contracts; WRFC is opt-in only.',
-    configure: ['goodvibes-agent delegate --help', 'goodvibes-agent compat'],
-    use: ['goodvibes-agent delegate "fix the failing tests"', 'goodvibes-agent delegate --wrfc "implement and review the feature"'],
-    exceedsBy: ['Keeps personal operator brain separate from coding execution', 'delegates one authoritative TUI-owned execution chain', 'blocks local sibling agent fanout'],
-    next: ['Expose delegation receipts and artifacts in the operator workspace, with status recovery and user steering.'],
-  },
-  {
-    id: 'profiles-isolation',
-    title: 'Profiles And Isolated Operator State',
-    posture: 'ready',
-    competitors: ['hermes'],
-    competitorBaseline: 'Profiles run independent agents with isolated configs, sessions, skills, memory, cron jobs, and gateway state.',
-    goodvibesAgent: 'Supports GOODVIBES_AGENT_HOME and named --agent-profile homes for isolated Agent-local config, sessions, memory, personas, skills, routines, setup, and bundles; daemon remains shared/external by design. The Agent workspace exposes runtime profile posture, config profiles, profile sync, setup transfer shortcuts, starter profile templates, and local starter authoring.',
-    configure: ['GOODVIBES_AGENT_HOME=<path> goodvibes-agent status', 'goodvibes-agent profiles create household --template household --yes', 'goodvibes-agent profiles templates export research ./starter.json --yes', '/agent-profile guide', '/agent → Profiles & Portability'],
-    use: ['goodvibes-agent --agent-profile household', '/agent-profile templates', '/profiles', '/profilesync list', '/setup transfer export <path> --yes'],
-    exceedsBy: ['Typed support bundles', 'explicit daemon boundary', 'no accidental cross-product knowledge fallback', 'profile isolation without hidden daemon lifecycle ownership', 'fullscreen profile and portability workflow discovery', 'curated local starter packs', 'editable starter templates', 'TUI-guided starter authoring'],
-    next: ['Add visual starter-template editing inside the fullscreen Agent workspace.'],
-  },
-  {
-    id: 'security-approvals',
-    title: 'Security, Approvals, And Policy',
-    posture: 'ready',
-    competitors: ['openclaw', 'hermes'],
-    competitorBaseline: 'Command approval, DM pairing, sandboxing, allowlists, and safety defaults for exposed channels.',
-    goodvibesDaemon: 'Daemon public routes include approvals.list/claim/approve/deny/cancel, channel policies/allowlists, local auth/session controls, secrets, and route danger metadata in the operator contract.',
-    goodvibesAgent: 'Uses daemon approvals, local auth diagnostics, secret refs, explicit confirmation gates, and Agent model-tool policy guards.',
-    configure: ['goodvibes-agent auth status', 'goodvibes-agent secrets providers', '/approvals list'],
-    use: ['/policy status', '/approvals list', 'goodvibes-agent doctor'],
-    exceedsBy: ['No token printing', 'secret-value rejection in local registries', 'policy tests for hidden spawn/lifecycle/default-knowledge failures'],
-    next: ['Add user-facing approval center in the Agent workspace with route risk labels and saved policy presets.'],
-  },
-] as const;
-
-export function buildOperatorCapabilityBenchmarkReport(now = new Date()): OperatorCapabilityBenchmarkReport {
-  return {
-    generatedAt: now.toISOString(),
-    packageName: '@pellux/goodvibes-agent',
-    benchmarkSources: OPERATOR_CAPABILITY_BENCHMARK_SOURCES,
-    capabilities: OPERATOR_CAPABILITY_BENCHMARKS,
-  };
-}
-
-export function filterOperatorCapabilities(
-  capabilities: readonly OperatorCapabilityBenchmark[],
-  query: string | undefined,
-): readonly OperatorCapabilityBenchmark[] {
-  const normalized = query?.trim().toLowerCase();
-  if (!normalized) return capabilities;
-  return capabilities.filter((capability) => {
-    if (capability.id.includes(normalized)) return true;
-    if (capability.title.toLowerCase().includes(normalized)) return true;
-    if (capability.posture.includes(normalized)) return true;
-    if (capability.competitors.some((competitor) => competitor === normalized)) return true;
-    return capability.goodvibesAgent.toLowerCase().includes(normalized)
-      || capability.goodvibesDaemon?.toLowerCase().includes(normalized) === true
-      || capability.competitorBaseline.toLowerCase().includes(normalized);
-  });
-}
-
-export function renderOperatorCapabilityBenchmark(
-  capabilities: readonly OperatorCapabilityBenchmark[] = OPERATOR_CAPABILITY_BENCHMARKS,
-): string {
-  const lines: string[] = [
-    'GoodVibes Agent capability benchmark',
-    '  Goal: match and exceed OpenClaw/Hermes personal-operator capabilities without default wiki/HomeGraph fallback or hidden local agent fanout.',
-    '',
-  ];
-
-  for (const capability of capabilities) {
-    lines.push(`${capability.title} [${capability.posture}]`);
-    lines.push(`  competitors: ${capability.competitors.join(', ')}`);
-    lines.push(`  baseline: ${capability.competitorBaseline}`);
-    if (capability.goodvibesDaemon) lines.push(`  daemon: ${capability.goodvibesDaemon}`);
-    lines.push(`  Agent: ${capability.goodvibesAgent}`);
-    lines.push(`  configure: ${capability.configure.join(' | ')}`);
-    lines.push(`  use: ${capability.use.join(' | ')}`);
-    lines.push(`  exceeds: ${capability.exceedsBy.join(' | ')}`);
-    lines.push(`  next: ${capability.next.join(' | ')}`);
-    lines.push('');
-  }
-
-  lines.push('Sources:');
-  for (const source of OPERATOR_CAPABILITY_BENCHMARK_SOURCES) lines.push(`  ${source}`);
-  return lines.join('\n');
-}