@pellux/goodvibes-agent 0.1.116 → 1.0.0

package/src/input/commands/recall-query.ts

@@ -1,6 +1,7 @@
 import type { CommandContext } from '../command-registry.ts';
 import type { MemoryApi } from '@pellux/goodvibes-sdk/platform/knowledge';
 import type { MemorySearchFilter } from '@pellux/goodvibes-sdk/platform/state';
+import { formatAgentRecordReference, formatAgentRecordReferences } from '../../agent/record-labels.ts';
 import { VALID_CLASSES, VALID_SCOPES, isValidClass, isValidScope } from './recall-shared.ts';
 import { requireYesFlag, stripYesFlag } from './confirmation.ts';
 
@@ -8,7 +9,7 @@ export function getMemoryApi(context: CommandContext): MemoryApi | null {
   const memoryApi = context.clients?.agentKnowledgeApi?.memory;
   if (!memoryApi) {
     context.print('[memory] Agent Memory API is not available in this runtime.');
-    context.print('[memory] Refusing to use default Knowledge/Wiki or non-Agent knowledge fallback.');
+    context.print('[memory] Refusing to use default knowledge or non-Agent knowledge fallback.');
     return null;
   }
   return memoryApi;
@@ -29,7 +30,7 @@ export function handleRecallSearch(args: string[], context: CommandContext): voi
     const cls = args[clsIdx + 1];
     if (isValidClass(cls)) filter.cls = cls;
     else {
-      context.print(`[memory] Unknown class "${cls}". Valid: ${VALID_CLASSES.join(', ')}`);
+      context.print(`[memory] Unknown class "${cls}". Valid values ${VALID_CLASSES.join(', ')}.`);
       return;
     }
   }
@@ -39,7 +40,7 @@ export function handleRecallSearch(args: string[], context: CommandContext): voi
     const scope = args[scopeIdx + 1];
     if (isValidScope(scope)) filter.scope = scope;
     else {
-      context.print(`[memory] Unknown scope "${scope}". Valid: ${VALID_SCOPES.join(', ')}`);
+      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES.join(', ')}.`);
       return;
     }
   }
@@ -63,7 +64,7 @@ export function handleRecallSearch(args: string[], context: CommandContext): voi
     return;
   }
 
-  context.print(`[memory] ${results.length} ${semantic ? 'semantic ' : ''}record(s):`);
+  context.print(`[memory] ${results.length} ${semantic ? 'semantic ' : ''}record(s)`);
   for (const record of results) {
     const semanticEntry = semanticResults.find((entry) => entry.record.id === record.id);
     const ts = new Date(record.createdAt).toISOString().slice(0, 16).replace('T', ' ');
@@ -72,7 +73,7 @@ export function handleRecallSearch(args: string[], context: CommandContext): voi
     context.print(`  ${record.id}  [${record.cls}]${tagStr}  ${ts}${scoreStr}`);
     context.print(`    ${record.summary}`);
     if (record.provenance.length) {
-      context.print(`    via: ${record.provenance.map((entry) => `${entry.kind}:${entry.ref}`).join(', ')}`);
+      context.print(`    origin ${formatAgentRecordReferences(record.provenance)}`);
     }
   }
 }
@@ -124,29 +125,28 @@ export function handleRecallGet(args: string[], context: CommandContext): void {
   }
   const record = memory.get(id);
   if (!record) {
-    context.print(`[memory] Record not found: ${id}`);
+    context.print(`[memory] Record not found ${id}`);
     return;
   }
   const ts = new Date(record.createdAt).toISOString().slice(0, 19).replace('T', ' ');
   context.print(`[memory] ${record.id}`);
-  context.print(`  Scope:   ${record.scope}`);
-  context.print(`  Class:   ${record.cls}`);
-  context.print(`  Summary: ${record.summary}`);
-  if (record.detail) context.print(`  Detail:  ${record.detail}`);
-  if (record.tags.length) context.print(`  Tags:    ${record.tags.join(', ')}`);
-  context.print(`  Created: ${ts}`);
+  context.print(`  scope ${record.scope}`);
+  context.print(`  class ${record.cls}`);
+  context.print(`  summary ${record.summary}`);
+  if (record.detail) context.print(`  detail ${record.detail}`);
+  if (record.tags.length) context.print(`  tags ${record.tags.join(', ')}`);
+  context.print(`  created ${ts}`);
 
   if (record.provenance.length) {
-    context.print('  Provenance:');
+    context.print('  origin');
     for (const provenance of record.provenance) {
-      const label = provenance.label ? ` (${provenance.label})` : '';
-      context.print(`    ${provenance.kind}: ${provenance.ref}${label}`);
+      context.print(`    ${formatAgentRecordReference(provenance)}`);
     }
   }
 
   const links = memory.linksFor(id);
   if (links.length) {
-    context.print('  Links:');
+    context.print('  links');
     for (const link of links) {
       const dir = link.fromId === id ? '->' : '<-';
       const other = link.fromId === id ? link.toId : link.fromId;
@@ -175,7 +175,12 @@ export async function handleRecallLink(args: string[], context: CommandContext):
     context.print('[memory] Link failed — check that both IDs exist.');
     return;
   }
-  context.print(`[memory] Linked: ${fromId} -> ${toId} [${relation}]`);
+  context.print([
+    '[memory] Linked',
+    `  from ${fromId}`,
+    `  to ${toId}`,
+    `  relation ${relation}`,
+  ].join('\n'));
 }
 
 export function handleRecallRemove(args: string[], context: CommandContext): void {
@@ -195,10 +200,13 @@ export function handleRecallRemove(args: string[], context: CommandContext): voi
   }
   const removed = memory.delete(id);
   if (!removed) {
-    context.print(`[memory] Record not found: ${id}`);
+    context.print(`[memory] Record not found ${id}`);
     return;
   }
-  context.print(`[memory] Deleted: ${id}`);
+  context.print([
+    '[memory] Deleted',
+    `  id ${id}`,
+  ].join('\n'));
 }
 
 export function handleRecallList(args: string[], context: CommandContext): void {
@@ -213,7 +221,7 @@ export function handleRecallList(args: string[], context: CommandContext): void
   if (scopeIdx !== -1 && args[scopeIdx + 1]) {
     const scope = args[scopeIdx + 1];
     if (!isValidScope(scope)) {
-      context.print(`[memory] Unknown scope "${scope}". Valid: ${VALID_SCOPES.join(', ')}`);
+      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES.join(', ')}.`);
       return;
     }
     filter.scope = scope;
@@ -232,7 +240,7 @@ export function handleRecallList(args: string[], context: CommandContext): void
   }
 
   for (const [clsName, group] of Object.entries(grouped)) {
-    context.print(`\n[memory] ${clsName.toUpperCase()} (${group.length}):`);
+    context.print(`\n[memory] ${clsName.toUpperCase()} (${group.length})`);
     for (const record of group) {
       const tagStr = record.tags.length ? ` [${record.tags.join(', ')}]` : '';
       context.print(`  ${record.id} [${record.scope}]${tagStr}  ${record.summary}`);

package/src/input/commands/recall-review.ts

@@ -1,4 +1,5 @@
 import type { CommandContext } from '../command-registry.ts';
+import { formatAgentRecordReviewState } from '../../agent/record-labels.ts';
 import { VALID_REVIEW_STATES, VALID_SCOPES, isValidReviewState, isValidScope } from './recall-shared.ts';
 import { getMemoryApi } from './recall-query.ts';
 import { requireYesFlag, stripYesFlag } from './confirmation.ts';
@@ -17,7 +18,7 @@ export function handleRecallQueue(args: string[], context: CommandContext): void
   context.print(`[memory] Review queue (${queue.length}):`);
   for (const record of queue) {
     const reason = record.staleReason ? ` — ${record.staleReason}` : '';
-    context.print(`  ${record.id} [${record.scope}/${record.cls}] ${record.reviewState} ${record.confidence}%  ${record.summary}${reason}`);
+    context.print(`  ${record.id} [${record.scope}/${record.cls}] ${formatAgentRecordReviewState(record.reviewState)} ${record.confidence}%  ${record.summary}${reason}`);
   }
 }
 

package/src/input/commands/routines-runtime.ts

@@ -1,9 +1,11 @@
 import { discoverRoutines, type DiscoveredRoutineRecord } from '../../agent/routine-discovery.ts';
-import { AgentRoutineRegistry, type AgentRoutineRecord } from '../../agent/routine-registry.ts';
+import { AgentRoutineRegistry, evaluateAgentRoutineReadiness, type AgentRoutineRecord } from '../../agent/routine-registry.ts';
+import { formatAgentRecordOrigin, formatAgentRecordReviewState } from '../../agent/record-labels.ts';
+import { buildAgentSkillRequirements, formatAgentSkillRequirement } from '../../agent/skill-registry.ts';
 import {
   buildRoutineSchedulePreview,
-  promoteRoutineToDaemonSchedule,
-  resolveAgentDaemonConnection,
+  promoteRoutineToConnectedSchedule,
+  resolveAgentConnectedHostConnection,
 } from '../../agent/routine-schedule-promotion.ts';
 import { parseRoutineSchedulePromotionArgs } from '../../agent/routine-schedule-args.ts';
 import {
@@ -72,39 +74,57 @@ function requiredFlag(flags: ReadonlyMap<string, string>, key: string): string {
   return value;
 }
 
+function formatRoutineReceipt(title: string, routine: Pick<AgentRoutineRecord, 'id' | 'name'>, extra: readonly string[] = []): string {
+  const enabled = extra.some((line) => line.trim() === 'enabled yes');
+  return [
+    `${title} ${routine.id}: ${routine.name}${enabled ? ' (enabled)' : ''}`,
+    `  id ${routine.id}`,
+    `  name ${routine.name}`,
+    ...extra,
+  ].join('\n');
+}
+
 function summarizeRoutine(routine: AgentRoutineRecord): string {
   const enabled = routine.enabled ? 'enabled' : 'disabled';
-  const tags = routine.tags.length > 0 ? ` tags=${routine.tags.join(',')}` : '';
-  return `  ${routine.id}  ${enabled}  ${routine.reviewState}  starts=${routine.startCount}  ${routine.name} - ${routine.description}${tags}`;
+  const tags = routine.tags.length > 0 ? ` tags ${routine.tags.join(', ')}` : '';
+  const readiness = evaluateAgentRoutineReadiness(routine);
+  const review = formatAgentRecordReviewState(routine.reviewState);
+  const ready = readiness.ready ? 'ready' : `needs ${readiness.missing.map(formatAgentSkillRequirement).join(',')}`;
+  return `  ${routine.id}  ${enabled}  ${review}  ${ready}  starts ${routine.startCount}  ${routine.name} - ${routine.description}${tags}`;
 }
 
-function renderList(title: string, registry: AgentRoutineRegistry, routines: readonly AgentRoutineRecord[]): string {
+function renderList(title: string, registry: AgentRoutineRegistry, routines: readonly AgentRoutineRecord[], emptyMessage?: string): string {
   const snapshot = registry.snapshot();
   if (routines.length === 0) {
-    return `${title}\n  No local Agent routines yet. Create one with /routines create --name <name> --description <summary> --steps <steps>.`;
+    return emptyMessage
+      ? `${title}\n  ${emptyMessage}`
+      : `${title}\n  No local Agent routines yet.\n  No Agent-local routines yet. Create one with /routines create --name <name> --description <summary> --steps <steps>.`;
   }
   return [
     `${title} (${routines.length})`,
-    `  store: ${snapshot.path}`,
-    `  enabled: ${snapshot.enabledRoutines.length}`,
+    `  store ${snapshot.path}`,
+    `  enabled ${snapshot.enabledRoutines.length}`,
     ...routines.map(summarizeRoutine),
   ].join('\n');
 }
 
 function renderRoutine(routine: AgentRoutineRecord): string {
+  const readiness = evaluateAgentRoutineReadiness(routine);
   return [
     `Routine ${routine.name}`,
-    `  id: ${routine.id}`,
-    `  enabled: ${routine.enabled ? 'yes' : 'no'}`,
-    `  review: ${routine.reviewState}`,
-    `  source: ${routine.source}`,
-    `  provenance: ${routine.provenance}`,
+    `  id ${routine.id}`,
+    `  enabled ${routine.enabled ? 'yes' : 'no'}`,
+    `  readiness: ${readiness.ready ? 'ready' : 'needs setup'}`,
+    `  requirements ${routine.requirements.map(formatAgentSkillRequirement).join(', ') || '(none)'}`,
+    readiness.missing.length > 0 ? `  missing: ${readiness.missing.map(formatAgentSkillRequirement).join(', ')}` : '',
+    `  review ${formatAgentRecordReviewState(routine.reviewState)}`,
+    `  origin ${formatAgentRecordOrigin(routine.source, routine.provenance)}`,
     `  tags: ${routine.tags.join(', ') || '(none)'}`,
     `  triggers: ${routine.triggers.join(', ') || '(manual)'}`,
-    `  started: ${routine.startCount}${routine.lastStartedAt ? `; last ${routine.lastStartedAt}` : ''}`,
-    `  created: ${routine.createdAt}`,
-    `  updated: ${routine.updatedAt}`,
-    routine.staleReason ? `  stale reason: ${routine.staleReason}` : '',
+    `  started ${routine.startCount}${routine.lastStartedAt ? `; last ${routine.lastStartedAt}` : ''}`,
+    `  created ${routine.createdAt}`,
+    `  updated ${routine.updatedAt}`,
+    routine.staleReason ? `  stale reason ${routine.staleReason}` : '',
     '',
     routine.description,
     '',
@@ -114,7 +134,7 @@ function renderRoutine(routine: AgentRoutineRecord): string {
 
 function summarizeDiscoveredRoutine(routine: DiscoveredRoutineRecord): string {
   const description = routine.description ? ` - ${routine.description}` : '';
-  return `  ${routine.name}  ${routine.origin}${description}\n    path: ${routine.path}`;
+  return `  ${routine.name}  ${routine.origin}${description}\n    path ${routine.path}`;
 }
 
 function renderDiscoveredRoutines(routines: readonly DiscoveredRoutineRecord[]): string {
@@ -151,8 +171,19 @@ function frontmatterList(routine: DiscoveredRoutineRecord, key: string): readonl
   return splitList(value);
 }
 
+function frontmatterAnyList(routine: DiscoveredRoutineRecord, keys: readonly string[]): readonly string[] {
+  for (const key of keys) {
+    const values = frontmatterList(routine, key);
+    if (values.length > 0) return values;
+  }
+  return [];
+}
+
 function printError(ctx: CommandContext, error: unknown): void {
-  ctx.print(`Error: ${error instanceof Error ? error.message : String(error)}`);
+  ctx.print([
+    'Error',
+    `  message ${error instanceof Error ? error.message : String(error)}`,
+  ].join('\n'));
 }
 
 async function importDiscoveredRoutine(args: readonly string[], ctx: CommandContext, routineRegistry: AgentRoutineRegistry): Promise<void> {
@@ -164,18 +195,18 @@ async function importDiscoveredRoutine(args: readonly string[], ctx: CommandCont
   }
   const discovered = findDiscoveredRoutine(await discoverRoutines(requireShellPaths(ctx)), name);
   if (!discovered) {
-    ctx.print(`Unknown discovered Agent routine: ${name}\nRun /routines discover to inspect available routine files.`);
+    ctx.print(`Unknown discovered Agent routine ${name}\nRun /routines discover to inspect available routine files.`);
     return;
   }
   if (!parsed.yes) {
     ctx.print([
       'Agent routine import preview',
-      `  name: ${discovered.name}`,
-      `  origin: ${discovered.origin}`,
-      `  path: ${discovered.path}`,
-      `  description: ${discovered.description || '(none)'}`,
-      `  steps characters: ${discovered.steps.length}`,
-      '  next: rerun with --yes to import into the Agent-local routine registry',
+      `  name ${discovered.name}`,
+      `  origin ${discovered.origin}`,
+      `  path ${discovered.path}`,
+      `  description ${discovered.description || '(none)'}`,
+      `  steps characters ${discovered.steps.length}`,
+      '  next rerun with --yes to import into the Agent-local routine registry',
     ].join('\n'));
     return;
   }
@@ -185,11 +216,15 @@ async function importDiscoveredRoutine(args: readonly string[], ctx: CommandCont
     steps: discovered.steps,
     tags: frontmatterList(discovered, 'tags'),
     triggers: frontmatterList(discovered, 'triggers'),
+    requirements: buildAgentSkillRequirements({
+      env: frontmatterAnyList(discovered, ['requiresEnv', 'requires-env', 'requires_env']),
+      commands: frontmatterAnyList(discovered, ['requiresCommands', 'requires-commands', 'requires_commands', 'commands']),
+    }),
     enabled: parsed.flags.get('enabled') === 'true',
     source: 'imported',
     provenance: `discovered:${discovered.origin}:${discovered.path}`,
   });
-  ctx.print(`Imported Agent routine ${routine.id}: ${routine.name}${routine.enabled ? ' (enabled)' : ''}`);
+  ctx.print(formatRoutineReceipt('Imported Agent routine', routine, [`  enabled ${routine.enabled ? 'yes' : 'no'}`]));
 }
 
 async function promoteRoutine(args: readonly string[], routineRegistry: AgentRoutineRegistry, ctx: CommandContext): Promise<void> {
@@ -212,8 +247,8 @@ async function promoteRoutine(args: readonly string[], routineRegistry: AgentRou
     return;
   }
   const shellPaths = requireShellPaths(ctx);
-  const connection = resolveAgentDaemonConnection(ctx.platform.configManager, shellPaths.homeDirectory);
-  const result = await promoteRoutineToDaemonSchedule(connection, preview);
+  const connection = resolveAgentConnectedHostConnection(ctx.platform.configManager, shellPaths.homeDirectory);
+  const result = await promoteRoutineToConnectedSchedule(connection, preview);
   const receipt = receiptStoreFromContext(ctx).append(connection, preview, result);
   ctx.print(result.ok ? `${formatRoutineScheduleSuccess(result)}\n  receipt: ${receipt.id}` : `${formatRoutineScheduleFailure(result)}\n  receipt: ${receipt.id}`);
 }
@@ -231,6 +266,11 @@ export async function runRoutinesRuntimeCommand(args: readonly string[], ctx: Co
       ctx.print(renderList('Enabled Agent Routines', routineRegistry, snapshot.enabledRoutines));
       return;
     }
+    if (sub === 'attention' || sub === 'needs-setup') {
+      const routines = routineRegistry.list().filter((routine) => !evaluateAgentRoutineReadiness(routine).ready);
+      ctx.print(renderList('Agent Routines needing setup', routineRegistry, routines, 'No Agent-local routines need setup.'));
+      return;
+    }
     if (sub === 'discover' || sub === 'discovered') {
       ctx.print(renderDiscoveredRoutines(await discoverRoutines(requireShellPaths(ctx))));
       return;
@@ -260,7 +300,7 @@ export async function runRoutinesRuntimeCommand(args: readonly string[], ctx: Co
     }
     if (sub === 'reconcile' || sub === 'sync' || sub === 'status') {
       const shellPaths = requireShellPaths(ctx);
-      const connection = resolveAgentDaemonConnection(ctx.platform.configManager, shellPaths.homeDirectory);
+      const connection = resolveAgentConnectedHostConnection(ctx.platform.configManager, shellPaths.homeDirectory);
       const result = await reconcileRoutineScheduleReceipts(connection, receiptStoreFromContext(ctx).snapshot());
       ctx.print(formatRoutineScheduleCorrelation(result));
       return;
@@ -272,7 +312,7 @@ export async function runRoutinesRuntimeCommand(args: readonly string[], ctx: Co
         return;
       }
       const receipt = receiptStoreFromContext(ctx).get(id);
-      ctx.print(receipt ? formatRoutineScheduleReceipt(receipt) : `Unknown routine schedule receipt: ${id}`);
+      ctx.print(receipt ? formatRoutineScheduleReceipt(receipt) : `Unknown routine schedule receipt ${id}`);
       return;
     }
     if (sub === 'create') {
@@ -284,11 +324,15 @@ export async function runRoutinesRuntimeCommand(args: readonly string[], ctx: Co
         steps,
         triggers: splitList(parsed.flags.get('triggers')),
         tags: splitList(parsed.flags.get('tags')),
+        requirements: buildAgentSkillRequirements({
+          env: splitList(parsed.flags.get('requires-env')),
+          commands: splitList(parsed.flags.get('requires-command') ?? parsed.flags.get('requires-commands')),
+        }),
         enabled: parsed.flags.get('enabled') === 'true',
         source: 'user',
-        provenance: 'slash-command',
+        provenance: 'Command',
       });
-      ctx.print(`Created Agent routine ${routine.id}: ${routine.name}`);
+      ctx.print(formatRoutineReceipt('Created Agent routine', routine));
       return;
     }
     if (sub === 'update') {
@@ -304,9 +348,15 @@ export async function runRoutinesRuntimeCommand(args: readonly string[], ctx: Co
         steps: parsed.flags.get('steps'),
         triggers: parsed.flags.has('triggers') ? splitList(parsed.flags.get('triggers')) : undefined,
         tags: parsed.flags.has('tags') ? splitList(parsed.flags.get('tags')) : undefined,
-        provenance: 'slash-command',
+        requirements: parsed.flags.has('requires-env') || parsed.flags.has('requires-command') || parsed.flags.has('requires-commands')
+          ? buildAgentSkillRequirements({
+            env: splitList(parsed.flags.get('requires-env')),
+            commands: splitList(parsed.flags.get('requires-command') ?? parsed.flags.get('requires-commands')),
+          })
+          : undefined,
+        provenance: 'Command',
       });
-      ctx.print(`Updated Agent routine ${updated.id}: ${updated.name}`);
+      ctx.print(formatRoutineReceipt('Updated Agent routine', updated));
       return;
     }
     if (sub === 'enable' || sub === 'disable') {
@@ -316,7 +366,7 @@ export async function runRoutinesRuntimeCommand(args: readonly string[], ctx: Co
         return;
       }
       const routine = routineRegistry.setEnabled(id, sub === 'enable');
-      ctx.print(`${sub === 'enable' ? 'Enabled' : 'Disabled'} Agent routine ${routine.id}: ${routine.name}`);
+      ctx.print(formatRoutineReceipt(`${sub === 'enable' ? 'Enabled' : 'Disabled'} Agent routine`, routine));
       return;
     }
     if (sub === 'start' || sub === 'run') {
@@ -326,9 +376,13 @@ export async function runRoutinesRuntimeCommand(args: readonly string[], ctx: Co
         return;
       }
       const routine = routineRegistry.markStarted(id);
+      const readiness = evaluateAgentRoutineReadiness(routine);
       ctx.print([
-        `Started Agent routine ${routine.id}: ${routine.name}`,
-        '  policy: same main conversation; no hidden job, runtime mutation, or external side effect was started',
+        `Started Agent routine ${routine.id}`,
+        `  id ${routine.id}`,
+        `  name ${routine.name}`,
+        `  readiness: ${readiness.ready ? 'ready' : `needs setup (${readiness.missing.map(formatAgentSkillRequirement).join(', ')})`}`,
+        '  policy same main conversation; no hidden job, runtime mutation, or external side effect was started',
         '',
         routine.steps,
       ].join('\n'));
@@ -341,7 +395,7 @@ export async function runRoutinesRuntimeCommand(args: readonly string[], ctx: Co
         return;
       }
       const routine = routineRegistry.markReviewed(id);
-      ctx.print(`Reviewed Agent routine ${routine.id}.`);
+      ctx.print(formatRoutineReceipt('Reviewed Agent routine', routine));
       return;
     }
     if (sub === 'stale') {
@@ -351,7 +405,7 @@ export async function runRoutinesRuntimeCommand(args: readonly string[], ctx: Co
         return;
       }
       const routine = routineRegistry.markStale(id, args.slice(2).join(' '));
-      ctx.print(`Marked Agent routine ${routine.id} stale.`);
+      ctx.print(formatRoutineReceipt('Marked Agent routine stale', routine));
       return;
     }
     if (sub === 'promote' || sub === 'schedule' || sub === 'promote-schedule') {
@@ -370,10 +424,10 @@ export async function runRoutinesRuntimeCommand(args: readonly string[], ctx: Co
         return;
       }
       const removed = routineRegistry.deleteRoutine(id);
-      ctx.print(`Deleted Agent routine ${removed.id}: ${removed.name}`);
+      ctx.print(formatRoutineReceipt('Deleted Agent routine', removed));
       return;
     }
-    ctx.print('Usage: /routines [list|enabled|discover|import-discovered|search|show|receipts|reconcile|receipt|create|update|enable|disable|start|review|stale|promote|delete]');
+    ctx.print('Usage: /routines [list|enabled|attention|discover|import-discovered|search|show|receipts|reconcile|receipt|create|update|enable|disable|start|review|stale|promote|delete]');
   } catch (error) {
     printError(ctx, error);
   }
@@ -383,8 +437,8 @@ export function registerRoutinesRuntimeCommands(registry: CommandRegistry): void
   registry.register({
     name: 'routines',
     aliases: ['routine'],
-    description: 'Manage local GoodVibes Agent routines',
-    usage: '[list|enabled|discover|import-discovered <name> --yes|search <query>|show <id>|receipts|reconcile|receipt <id>|create --name <name> --description <summary> --steps <steps>|update <id> [--name ...] [--description ...] [--steps ...]|enable <id>|disable <id>|start <id>|review <id>|stale <id> <reason...>|promote <id> --cron <expr> [--delivery-channel slack] --yes|delete <id> --yes]',
+    description: 'Manage Agent-local routines',
+    usage: '[list|enabled|attention|discover|import-discovered <name> --yes|search <query>|show <id>|receipts|reconcile|receipt <id>|create --name <name> --description <summary> --steps <steps> [--requires-env A,B] [--requires-command gh,jq]|update <id> [--name ...] [--description ...] [--steps ...]|enable <id>|disable <id>|start <id>|review <id>|stale <id> <reason...>|promote <id> --cron <expr> [--delivery-channel slack] --yes|delete <id> --yes]',
     handler: runRoutinesRuntimeCommand,
   });
 }

package/src/input/commands/runtime-services.ts

@@ -22,7 +22,6 @@ import { GOODVIBES_AGENT_SURFACE_ROOT } from '../../config/surface.ts';
 import type { ProviderApi } from '@pellux/goodvibes-sdk/platform/providers';
 import type {
   ShellAgentManagerService,
-  ShellAcpManagerService,
   ShellAutomationManagerService,
   ShellAutomationManagerRuntimeService,
   ShellModeManagerService,
@@ -32,7 +31,7 @@ import type {
 
 function requireContextValue<T>(value: T | null | undefined, name: string): T {
   if (value == null) {
-    throw new Error(`commandContext.${name} is required but was not wired at bootstrap`);
+    throw new Error(`commandContext.${name} is unavailable in this Agent runtime`);
   }
   return value;
 }
@@ -274,10 +273,6 @@ export function requireAgentManager(context: CommandContext): ShellAgentManagerS
   return requireContextValue(context.ops.agentManager, 'ops.agentManager') as ShellAgentManagerService;
 }
 
-export function requireAcpManager(context: CommandContext): ShellAcpManagerService {
-  return requireContextValue(context.ops.acpManager, 'ops.acpManager') as ShellAcpManagerService;
-}
-
 export function requireModeManager(context: CommandContext): ShellModeManagerService {
   return requireContextValue(context.ops.modeManager, 'ops.modeManager') as ShellModeManagerService;
 }
@@ -285,11 +280,3 @@ export function requireModeManager(context: CommandContext): ShellModeManagerSer
 export function requireAutomationManager(context: CommandContext): ShellAutomationManagerRuntimeService {
   return requireContextValue(context.ops.automationManager, 'ops.automationManager') as ShellAutomationManagerRuntimeService;
 }
-
-export function requireSandboxSessionRegistry(context: CommandContext) {
-  return requireContextValue(context.workspace.sandboxSessionRegistry, 'workspace.sandboxSessionRegistry');
-}
-
-export function requireWorktreeRegistry(context: CommandContext) {
-  return requireContextValue(context.workspace.worktreeRegistry, 'workspace.worktreeRegistry');
-}

package/src/input/commands/schedule-runtime.ts

@@ -8,7 +8,7 @@ import {
   buildReminderSchedulePreview,
   createReminderSchedule,
   parseReminderScheduleArgs,
-  resolveReminderDaemonConnection,
+  resolveReminderConnectedHostConnection,
 } from '../../agent/reminder-schedule.ts';
 import {
   formatReminderScheduleFailure,
@@ -18,8 +18,8 @@ import {
 import { AgentRoutineRegistry } from '../../agent/routine-registry.ts';
 import {
   buildRoutineSchedulePreview,
-  promoteRoutineToDaemonSchedule,
-  resolveAgentDaemonConnection,
+  promoteRoutineToConnectedSchedule,
+  resolveAgentConnectedHostConnection,
 } from '../../agent/routine-schedule-promotion.ts';
 import { parseRoutineSchedulePromotionArgs } from '../../agent/routine-schedule-args.ts';
 import {
@@ -36,6 +36,7 @@ import {
 } from '../../agent/routine-schedule-receipts.ts';
 import type { CommandContext } from '../command-registry.ts';
 import { requireShellPaths } from './runtime-services.ts';
+import { executeConfirmedOperatorAction } from './operator-actions-runtime.ts';
 
 function formatSchedule(schedule: AutomationScheduleDefinition): string {
   switch (schedule.kind) {
@@ -64,10 +65,11 @@ function formatPrompt(job: AutomationJob): string {
 function printReadOnlyScheduleBoundary(print: (text: string) => void, requestedAction: string): void {
   print([
     'GoodVibes Agent local schedule commands are read-only in this runtime.',
-    `  requested: ${requestedAction}`,
-    '  policy: no local Agent automation jobs, scheduled spawns, or immediate automation runs',
-    '  use: /schedule list',
-    '  schedule route: use /schedule promote-routine <routine> --cron <expr> --yes to create a connected schedule explicitly',
+    `  requested ${requestedAction}`,
+    '  policy no hidden local Agent automation jobs or immediate automation runs',
+    '  use /schedule list',
+    '  connected run route /automation schedule run <schedule-id> --yes',
+    '  schedule route use /schedule promote-routine <routine> --cron <expr> --yes to create a connected schedule explicitly',
   ].join('\n'));
 }
 
@@ -83,7 +85,7 @@ async function promoteRoutineSchedule(args: readonly string[], ctx: CommandConte
   const shellPaths = requireShellPaths(ctx);
   const routine = AgentRoutineRegistry.fromShellPaths(shellPaths).get(parsed.routineId ?? '');
   if (!routine) {
-    ctx.print(`Unknown Agent routine: ${parsed.routineId ?? ''}`);
+    ctx.print(`Unknown Agent routine ${parsed.routineId ?? ''}`);
     return;
   }
   const preview = buildRoutineSchedulePreview(routine, parsed);
@@ -91,8 +93,8 @@ async function promoteRoutineSchedule(args: readonly string[], ctx: CommandConte
     ctx.print(formatRoutineSchedulePreview(preview));
     return;
   }
-  const connection = resolveAgentDaemonConnection(ctx.platform.configManager, shellPaths.homeDirectory);
-  const result = await promoteRoutineToDaemonSchedule(connection, preview);
+  const connection = resolveAgentConnectedHostConnection(ctx.platform.configManager, shellPaths.homeDirectory);
+  const result = await promoteRoutineToConnectedSchedule(connection, preview);
   const receipt = RoutineScheduleReceiptStore.fromShellPaths(shellPaths).append(connection, preview, result);
   ctx.print(result.ok ? `${formatRoutineScheduleSuccess(result)}\n  receipt: ${receipt.id}` : `${formatRoutineScheduleFailure(result)}\n  receipt: ${receipt.id}`);
 }
@@ -112,7 +114,7 @@ async function createReminder(args: readonly string[], ctx: CommandContext): Pro
     return;
   }
   const shellPaths = requireShellPaths(ctx);
-  const connection = resolveReminderDaemonConnection(ctx.platform.configManager, shellPaths.homeDirectory);
+  const connection = resolveReminderConnectedHostConnection(ctx.platform.configManager, shellPaths.homeDirectory);
   const result = await createReminderSchedule(connection, preview);
   ctx.print(result.ok ? formatReminderScheduleSuccess(result) : formatReminderScheduleFailure(result));
 }
@@ -121,7 +123,7 @@ export function registerScheduleRuntimeCommands(registry: CommandRegistry): void
   registry.register({
     name: 'schedule',
     aliases: ['sched'],
-    description: 'Inspect schedules, create confirmed reminders, and explicitly promote local Agent routines to connected schedules',
+    description: 'Inspect schedules, create confirmed reminders, and explicitly promote Agent-local routines to connected schedules',
     usage: 'list | remind --at <iso> --message <text> --yes | receipts | reconcile | receipt <id> | promote-routine <routine-id> --cron <expr> [--delivery-channel slack] --yes',
     argsHint: 'list | remind --at <iso> --message <text> --yes | receipts | reconcile | receipt <id> | promote-routine <routine-id> --cron <expr> [--delivery-channel slack] --yes',
     async handler(args, ctx) {
@@ -144,7 +146,7 @@ export function registerScheduleRuntimeCommands(registry: CommandRegistry): void
 
       if (sub === 'reconcile' || sub === 'sync' || sub === 'status') {
         const shellPaths = requireShellPaths(ctx);
-        const connection = resolveAgentDaemonConnection(ctx.platform.configManager, shellPaths.homeDirectory);
+        const connection = resolveAgentConnectedHostConnection(ctx.platform.configManager, shellPaths.homeDirectory);
         const result = await reconcileRoutineScheduleReceipts(connection, RoutineScheduleReceiptStore.fromShellPaths(shellPaths).snapshot());
         ctx.print(formatRoutineScheduleCorrelation(result));
         return;
@@ -157,7 +159,7 @@ export function registerScheduleRuntimeCommands(registry: CommandRegistry): void
           return;
         }
         const receipt = RoutineScheduleReceiptStore.fromShellPaths(requireShellPaths(ctx)).get(id);
-        ctx.print(receipt ? formatRoutineScheduleReceipt(receipt) : `Unknown routine schedule receipt: ${id}`);
+        ctx.print(receipt ? formatRoutineScheduleReceipt(receipt) : `Unknown routine schedule receipt ${id}`);
         return;
       }
 
@@ -176,20 +178,30 @@ export function registerScheduleRuntimeCommands(registry: CommandRegistry): void
           );
           return;
         }
-        const lines = ['Automation jobs:', ''];
+        const lines = ['Automation jobs', ''];
         for (const job of jobs) {
           const status = job.enabled ? '● enabled ' : '○ paused  ';
           const next = formatNextRun(job.nextRunAt);
           const last = job.lastRunAt ? new Date(job.lastRunAt).toLocaleString() : 'never';
-          lines.push(`  ${job.id.slice(0, 12)}  ${status} runs:${job.runCount}  next:${next}  last:${last}`);
-          lines.push(`    name: ${job.name}  schedule: ${formatSchedule(job.schedule)}`);
-          lines.push(`    prompt: ${formatPrompt(job)}`);
+          lines.push(`  ${job.id.slice(0, 12)}  ${status} runs ${job.runCount}  next ${next}  last ${last}`);
+          lines.push(`    name ${job.name}  schedule ${formatSchedule(job.schedule)}`);
+          lines.push(`    prompt ${formatPrompt(job)}`);
         }
         ctx.print(lines.join('\n'));
         return;
       }
 
-      if (sub === 'add' || sub === 'remove' || sub === 'enable' || sub === 'disable' || sub === 'run') {
+      if (sub === 'run') {
+        const scheduleId = args[1] ?? '';
+        if (!scheduleId) {
+          ctx.print('Usage: /schedule run <schedule-id> --yes');
+          return;
+        }
+        await executeConfirmedOperatorAction(ctx, 'schedules.run', 'scheduleId', scheduleId, args.slice(2), '/schedule run <schedule-id> --yes');
+        return;
+      }
+
+      if (sub === 'add' || sub === 'remove' || sub === 'enable' || sub === 'disable') {
         printReadOnlyScheduleBoundary(ctx.print, `/schedule ${args.join(' ')}`.trim());
         return;
       }
@@ -200,9 +212,10 @@ export function registerScheduleRuntimeCommands(registry: CommandRegistry): void
         + '  /schedule receipts\n'
         + '  /schedule reconcile\n'
         + '  /schedule receipt <receipt-id>\n'
+        + '  /schedule run <schedule-id> --yes\n'
         + '  /schedule remind (--cron <expr>|--every <interval>|--at <iso-time>) (--message <text>|<text...>) [--delivery-channel <channel>|--delivery-route <route>|--delivery-webhook <url>] --yes\n'
         + '  /schedule promote-routine <routine-id> (--cron <expr>|--every <interval>|--at <iso-time>) [--delivery-channel <channel>|--delivery-route <route>|--delivery-webhook <url>] --yes\n'
-        + '  Local schedule mutations and runs remain blocked.'
+        + '  Local schedule mutations remain blocked; schedule run is a confirmed connected-host action.'
       );
     },
   });