@pellux/goodvibes-agent 0.1.116 → 1.0.0

package/src/input/agent-workspace-session-command-editor-submission.ts

@@ -0,0 +1,199 @@
+import type { AgentWorkspaceActionResult, AgentWorkspaceLocalEditor } from './agent-workspace-types.ts';
+import type { AgentWorkspaceSessionCommandEditorKind } from './agent-workspace-session-command-editors.ts';
+import { isAgentWorkspaceSessionCommandEditorKind } from './agent-workspace-session-command-editors.ts';
+import { quoteSlashCommandArg } from './slash-command-parser.ts';
+
+type AgentWorkspaceFieldReader = (fieldId: string) => string;
+
+export type AgentWorkspaceSessionCommandEditorSubmission =
+  | {
+    readonly kind: 'editor';
+    readonly editor: AgentWorkspaceLocalEditor;
+    readonly status: string;
+    readonly actionResult?: AgentWorkspaceActionResult;
+  }
+  | {
+    readonly kind: 'dispatch';
+    readonly command: string;
+    readonly status: string;
+    readonly actionResult: AgentWorkspaceActionResult;
+  };
+
+export function isAgentWorkspaceSessionCommandSubmissionKind(kind: string): kind is AgentWorkspaceSessionCommandEditorKind {
+  return isAgentWorkspaceSessionCommandEditorKind(kind as AgentWorkspaceSessionCommandEditorKind);
+}
+
+function isAffirmative(value: string): boolean {
+  return /^(y|yes|true)$/i.test(value.trim());
+}
+
+function unconfirmed(editor: AgentWorkspaceLocalEditor, message: string): AgentWorkspaceSessionCommandEditorSubmission {
+  return {
+    kind: 'editor',
+    editor: { ...editor, message },
+    status: message,
+  };
+}
+
+function dispatch(command: string, title: string, detail: string, safety: AgentWorkspaceActionResult['safety']): AgentWorkspaceSessionCommandEditorSubmission {
+  return {
+    kind: 'dispatch',
+    command,
+    status: `${title}.`,
+    actionResult: { kind: 'dispatched', title, detail, command, safety },
+  };
+}
+
+export function buildAgentWorkspaceSessionCommandEditorSubmission(
+  editor: AgentWorkspaceLocalEditor,
+  readField: AgentWorkspaceFieldReader,
+): AgentWorkspaceSessionCommandEditorSubmission {
+  if (editor.kind === 'conversation-export') {
+    if (!isAffirmative(readField('confirm'))) return unconfirmed(editor, 'Conversation export not confirmed. Type yes, then press Enter.');
+    return dispatch(
+      `/export ${quoteSlashCommandArg(readField('format'))} ${quoteSlashCommandArg(readField('path'))} --yes`,
+      'Opening conversation export',
+      'The workspace handed a confirmed conversation export command to the shell-owned command router.',
+      'safe',
+    );
+  }
+  if (editor.kind === 'conversation-events' || editor.kind === 'conversation-groups') {
+    const subcommand = editor.kind === 'conversation-groups' ? 'groups' : 'events';
+    const eventKind = readField('kind');
+    const command = eventKind.length > 0
+      ? `/conversation ${subcommand} ${quoteSlashCommandArg(eventKind)}`
+      : `/conversation ${subcommand}`;
+    return dispatch(
+      command,
+      editor.kind === 'conversation-groups' ? 'Opening transcript groups' : 'Opening transcript events',
+      'The workspace handed read-only transcript structure inspection to the shell-owned command router.',
+      'read-only',
+    );
+  }
+  if (editor.kind === 'conversation-find') {
+    const kind = readField('kind');
+    const command = kind.length > 0
+      ? `/conversation find ${quoteSlashCommandArg(readField('query'))} ${quoteSlashCommandArg(kind)}`
+      : `/conversation find ${quoteSlashCommandArg(readField('query'))}`;
+    return dispatch(
+      command,
+      'Opening transcript search',
+      'The workspace handed read-only transcript search to the shell-owned command router.',
+      'read-only',
+    );
+  }
+  if (editor.kind === 'effort-level') {
+    return dispatch(
+      `/effort ${quoteSlashCommandArg(readField('level'))}`,
+      'Opening reasoning effort change',
+      'The workspace handed reasoning effort selection to the shell-owned command router.',
+      'safe',
+    );
+  }
+  if (editor.kind === 'session-save') {
+    if (!isAffirmative(readField('confirm'))) return unconfirmed(editor, 'Session save not confirmed. Type yes, then press Enter.');
+    return dispatch(
+      `/save ${quoteSlashCommandArg(readField('name'))}`,
+      'Opening session save',
+      'The workspace handed a confirmed session save command to the shell-owned command router.',
+      'safe',
+    );
+  }
+  if (editor.kind === 'session-load') {
+    if (!isAffirmative(readField('confirm'))) return unconfirmed(editor, 'Session load not confirmed. Type yes, then press Enter.');
+    return dispatch(
+      `/load ${quoteSlashCommandArg(readField('name'))}`,
+      'Opening session load',
+      'The workspace handed a confirmed session load command to the shell-owned command router.',
+      'safe',
+    );
+  }
+  if (editor.kind === 'session-rename') {
+    return dispatch(
+      `/session rename ${quoteSlashCommandArg(readField('name'))}`,
+      'Opening session rename',
+      'The workspace handed current-session rename to the shell-owned command router.',
+      'safe',
+    );
+  }
+  if (editor.kind === 'session-resume') {
+    return dispatch(
+      `/session resume ${quoteSlashCommandArg(readField('target'))}`,
+      'Opening session resume',
+      'The workspace handed saved-session resume to the shell-owned command router.',
+      'safe',
+    );
+  }
+  if (editor.kind === 'session-info') {
+    return dispatch(
+      `/session info ${quoteSlashCommandArg(readField('target'))}`,
+      'Opening session inspection',
+      'The workspace handed read-only saved-session inspection to the shell-owned command router.',
+      'read-only',
+    );
+  }
+  if (editor.kind === 'session-export-saved') {
+    return dispatch(
+      `/session export ${quoteSlashCommandArg(readField('target'))} ${quoteSlashCommandArg(readField('format'))}`,
+      'Opening saved-session export',
+      'The workspace handed saved-session transcript export to the shell-owned command router.',
+      'read-only',
+    );
+  }
+  if (editor.kind === 'session-search') {
+    return dispatch(
+      `/session search ${quoteSlashCommandArg(readField('query'))}`,
+      'Opening saved-session search',
+      'The workspace handed saved-session search to the shell-owned command router.',
+      'read-only',
+    );
+  }
+  if (editor.kind === 'session-delete') {
+    if (!isAffirmative(readField('confirm'))) return unconfirmed(editor, 'Session delete not confirmed. Type yes, then press Enter.');
+    return dispatch(
+      `/session delete ${quoteSlashCommandArg(readField('target'))} --yes`,
+      'Opening saved-session delete',
+      'The workspace handed confirmed saved-session deletion to the shell-owned command router.',
+      'safe',
+    );
+  }
+  if (editor.kind === 'session-fork') {
+    const name = readField('name');
+    return dispatch(
+      name.length > 0 ? `/session fork ${quoteSlashCommandArg(name)}` : '/session fork',
+      'Opening session fork',
+      'The workspace handed current-session fork to the shell-owned command router.',
+      'safe',
+    );
+  }
+  if (editor.kind === 'session-graph') {
+    const sessionId = readField('sessionId');
+    const format = readField('format');
+    const parts = ['/session', 'graph'];
+    if (sessionId.length > 0) parts.push('--session', quoteSlashCommandArg(sessionId));
+    if (format.length > 0) parts.push('--format', quoteSlashCommandArg(format));
+    const command = parts.join(' ');
+    return dispatch(
+      command,
+      'Opening session graph',
+      'The workspace handed read-only session graph inspection to the shell-owned command router.',
+      'read-only',
+    );
+  }
+  if (editor.kind === 'mode-preset') {
+    if (!isAffirmative(readField('confirm'))) return unconfirmed(editor, 'Interaction mode change not confirmed. Type yes, then press Enter.');
+    return dispatch(
+      `/mode ${quoteSlashCommandArg(readField('preset'))} --yes`,
+      'Opening interaction mode change',
+      'The workspace handed a confirmed interaction mode command to the shell-owned command router.',
+      'safe',
+    );
+  }
+  if (!isAffirmative(readField('confirm'))) return unconfirmed(editor, 'Domain verbosity change not confirmed. Type yes, then press Enter.');
+  return dispatch(
+    `/mode set-domain ${quoteSlashCommandArg(readField('domain'))} ${quoteSlashCommandArg(readField('verbosity'))} --yes`,
+    'Opening domain verbosity change',
+    'The workspace handed a confirmed domain verbosity command to the shell-owned command router.',
+    'safe',
+  );
+}

package/src/input/agent-workspace-session-command-editors.ts

@@ -0,0 +1,249 @@
+import type { AgentWorkspaceEditorKind, AgentWorkspaceLocalEditor } from './agent-workspace-types.ts';
+
+export type AgentWorkspaceSessionCommandEditorKind = Extract<
+  AgentWorkspaceEditorKind,
+  | 'conversation-export'
+  | 'conversation-events'
+  | 'conversation-groups'
+  | 'conversation-find'
+  | 'effort-level'
+  | 'session-save'
+  | 'session-load'
+  | 'session-rename'
+  | 'session-resume'
+  | 'session-info'
+  | 'session-export-saved'
+  | 'session-search'
+  | 'session-delete'
+  | 'session-fork'
+  | 'session-graph'
+  | 'mode-preset'
+  | 'mode-domain'
+>;
+
+export function isAgentWorkspaceSessionCommandEditorKind(kind: AgentWorkspaceEditorKind): kind is AgentWorkspaceSessionCommandEditorKind {
+  return kind === 'conversation-export'
+    || kind === 'conversation-events'
+    || kind === 'conversation-groups'
+    || kind === 'conversation-find'
+    || kind === 'effort-level'
+    || kind === 'session-save'
+    || kind === 'session-load'
+    || kind === 'session-rename'
+    || kind === 'session-resume'
+    || kind === 'session-info'
+    || kind === 'session-export-saved'
+    || kind === 'session-search'
+    || kind === 'session-delete'
+    || kind === 'session-fork'
+    || kind === 'session-graph'
+    || kind === 'mode-preset'
+    || kind === 'mode-domain';
+}
+
+export function createAgentWorkspaceSessionCommandEditor(kind: AgentWorkspaceSessionCommandEditorKind): AgentWorkspaceLocalEditor {
+  if (kind === 'conversation-export') {
+    return {
+      kind,
+      mode: 'create',
+      title: 'Export Conversation',
+      selectedFieldIndex: 0,
+      message: 'Export the current conversation to a workspace file. Type yes on the final field to confirm.',
+      fields: [
+        { id: 'format', label: 'Format', value: 'markdown', required: true, multiline: false, hint: 'markdown or text.' },
+        { id: 'path', label: 'Output path', value: './conversation.md', required: true, multiline: false, hint: 'Workspace-relative output path.' },
+        { id: 'confirm', label: 'Confirm', value: '', required: true, multiline: false, hint: 'Type yes to run /export with --yes.' },
+      ],
+    };
+  }
+  if (kind === 'conversation-events' || kind === 'conversation-groups') {
+    const groups = kind === 'conversation-groups';
+    return {
+      kind,
+      mode: 'create',
+      title: groups ? 'Show Transcript Groups' : 'Show Transcript Events',
+      selectedFieldIndex: 0,
+      message: groups
+        ? 'Inspect grouped transcript structure from the Agent workspace.'
+        : 'Inspect transcript events from the Agent workspace.',
+      fields: [
+        { id: 'kind', label: 'Event kind', value: '', required: false, multiline: false, hint: 'Optional transcript event kind. Blank shows all.' },
+      ],
+    };
+  }
+  if (kind === 'conversation-find') {
+    return {
+      kind,
+      mode: 'create',
+      title: 'Find Transcript Text',
+      selectedFieldIndex: 0,
+      message: 'Search the current Agent transcript from the workspace.',
+      fields: [
+        { id: 'query', label: 'Search query', value: '', required: true, multiline: false, hint: 'Text to find in the current transcript.' },
+        { id: 'kind', label: 'Event kind', value: '', required: false, multiline: false, hint: 'Optional transcript event kind.' },
+      ],
+    };
+  }
+  if (kind === 'effort-level') {
+    return {
+      kind,
+      mode: 'update',
+      title: 'Set Reasoning Effort',
+      selectedFieldIndex: 0,
+      message: 'Set the reasoning effort used by normal Agent chat turns when the selected model supports it.',
+      fields: [
+        { id: 'level', label: 'Effort level', value: 'medium', required: true, multiline: false, hint: 'instant, low, medium, or high.' },
+      ],
+    };
+  }
+  if (kind === 'session-save') {
+    return {
+      kind,
+      mode: 'create',
+      title: 'Save Session',
+      selectedFieldIndex: 0,
+      message: 'Save the current Agent session under a reviewable name. Type yes on the final field to confirm.',
+      fields: [
+        { id: 'name', label: 'Session name', value: '', required: true, multiline: false, hint: 'Local saved-session name.' },
+        { id: 'confirm', label: 'Confirm', value: '', required: true, multiline: false, hint: 'Type yes to run /save.' },
+      ],
+    };
+  }
+  if (kind === 'session-load') {
+    return {
+      kind,
+      mode: 'update',
+      title: 'Load Session',
+      selectedFieldIndex: 0,
+      message: 'Load a saved Agent session into the current conversation. Type yes on the final field to confirm.',
+      fields: [
+        { id: 'name', label: 'Session name', value: '', required: true, multiline: false, hint: 'Existing saved-session name from /sessions.' },
+        { id: 'confirm', label: 'Confirm', value: '', required: true, multiline: false, hint: 'Type yes to run /load.' },
+      ],
+    };
+  }
+  if (kind === 'session-rename') {
+    return {
+      kind,
+      mode: 'update',
+      title: 'Rename Current Session',
+      selectedFieldIndex: 0,
+      message: 'Rename the active Agent session from the workspace.',
+      fields: [
+        { id: 'name', label: 'New session name', value: '', required: true, multiline: false, hint: 'New reviewable name for the current session.' },
+      ],
+    };
+  }
+  if (kind === 'session-resume') {
+    return {
+      kind,
+      mode: 'update',
+      title: 'Resume Saved Session',
+      selectedFieldIndex: 0,
+      message: 'Resume one saved Agent session by id, prefix, or title.',
+      fields: [
+        { id: 'target', label: 'Session id or name', value: '', required: true, multiline: false, hint: 'Use /session list or the Saved sessions action to find ids.' },
+      ],
+    };
+  }
+  if (kind === 'session-info') {
+    return {
+      kind,
+      mode: 'create',
+      title: 'Inspect Saved Session',
+      selectedFieldIndex: 0,
+      message: 'Inspect saved session metadata without changing the current conversation.',
+      fields: [
+        { id: 'target', label: 'Session id or name', value: '', required: true, multiline: false, hint: 'Saved session id, prefix, or name.' },
+      ],
+    };
+  }
+  if (kind === 'session-export-saved') {
+    return {
+      kind,
+      mode: 'create',
+      title: 'Export Saved Session',
+      selectedFieldIndex: 0,
+      message: 'Print one saved session transcript as markdown or text.',
+      fields: [
+        { id: 'target', label: 'Session id or name', value: '', required: true, multiline: false, hint: 'Use . for the current session, or a saved session id/name.' },
+        { id: 'format', label: 'Format', value: 'markdown', required: true, multiline: false, hint: 'markdown or text.' },
+      ],
+    };
+  }
+  if (kind === 'session-search') {
+    return {
+      kind,
+      mode: 'create',
+      title: 'Search Saved Sessions',
+      selectedFieldIndex: 0,
+      message: 'Search saved Agent sessions from the workspace.',
+      fields: [
+        { id: 'query', label: 'Search query', value: '', required: true, multiline: false, hint: 'Keyword or phrase to find in saved sessions.' },
+      ],
+    };
+  }
+  if (kind === 'session-delete') {
+    return {
+      kind,
+      mode: 'delete',
+      title: 'Delete Saved Session',
+      selectedFieldIndex: 0,
+      message: 'Delete one saved Agent session. Type yes on the final field to confirm.',
+      fields: [
+        { id: 'target', label: 'Session id or name', value: '', required: true, multiline: false, hint: 'Saved session id or prefix. The active session cannot be deleted.' },
+        { id: 'confirm', label: 'Confirm', value: '', required: true, multiline: false, hint: 'Type yes to run /session delete with --yes.' },
+      ],
+    };
+  }
+  if (kind === 'session-fork') {
+    return {
+      kind,
+      mode: 'create',
+      title: 'Fork Current Session',
+      selectedFieldIndex: 0,
+      message: 'Fork the current Agent session into a new local saved session.',
+      fields: [
+        { id: 'name', label: 'Fork name', value: '', required: false, multiline: false, hint: 'Optional new session name. Blank uses the default fork name.' },
+      ],
+    };
+  }
+  if (kind === 'session-graph') {
+    return {
+      kind,
+      mode: 'create',
+      title: 'Inspect Session Graph',
+      selectedFieldIndex: 0,
+      message: 'Inspect the read-only cross-session graph. Mutating graph actions remain blocked in Agent.',
+      fields: [
+        { id: 'sessionId', label: 'Session id', value: '', required: false, multiline: false, hint: 'Optional session id filter.' },
+        { id: 'format', label: 'Format', value: 'text', required: false, multiline: false, hint: 'text or json.' },
+      ],
+    };
+  }
+  if (kind === 'mode-preset') {
+    return {
+      kind,
+      mode: 'update',
+      title: 'Set Interaction Mode',
+      selectedFieldIndex: 0,
+      message: 'Set the Agent interaction noise level. Type yes on the final field to confirm.',
+      fields: [
+        { id: 'preset', label: 'Preset', value: 'balanced', required: true, multiline: false, hint: 'quiet, balanced, or operator.' },
+        { id: 'confirm', label: 'Confirm', value: '', required: true, multiline: false, hint: 'Type yes to run /mode <preset> with --yes.' },
+      ],
+    };
+  }
+  return {
+    kind,
+    mode: 'update',
+    title: 'Set Domain Verbosity',
+    selectedFieldIndex: 0,
+    message: 'Set interaction verbosity for one notification domain. Type yes on the final field to confirm.',
+    fields: [
+      { id: 'domain', label: 'Domain', value: '', required: true, multiline: false, hint: 'Domain name from mode output.' },
+      { id: 'verbosity', label: 'Verbosity', value: 'normal', required: true, multiline: false, hint: 'minimal, normal, or verbose.' },
+      { id: 'confirm', label: 'Confirm', value: '', required: true, multiline: false, hint: 'Type yes to run /mode set-domain.' },
+    ],
+  };
+}

package/src/input/agent-workspace-setup.ts

@@ -17,12 +17,16 @@ export interface AgentWorkspaceSetupChecklistInput {
   readonly sessionMemoryCount: number;
   readonly localMemoryCount: number;
   readonly localMemoryReviewQueueCount: number;
+  readonly localNoteCount: number;
+  readonly localNoteReviewQueueCount: number;
   readonly routineCount: number;
   readonly enabledRoutineCount: number;
+  readonly missingRoutineRequirementCount: number;
   readonly skillCount: number;
   readonly enabledSkillCount: number;
   readonly skillBundleCount: number;
   readonly enabledSkillBundleCount: number;
+  readonly missingSkillRequirementCount: number;
   readonly activePersonaName: string;
   readonly discoveredPersonas: AgentBehaviorDiscoverySummary;
   readonly discoveredSkills: AgentBehaviorDiscoverySummary;
@@ -51,10 +55,10 @@ export function buildAgentWorkspaceSetupChecklist(input: AgentWorkspaceSetupChec
   return [
     {
       id: 'runtime',
-      label: 'Connected services',
+      label: 'Connected host',
       status: 'ready',
-      detail: `Agent will connect to ${input.runtimeBaseUrl}; service ownership stays outside this product.`,
-      command: '/health',
+      detail: `Agent will connect to ${input.runtimeBaseUrl}; connected-host ownership stays outside this product.`,
+      command: 'Home -> Review health',
     },
     {
       id: 'provider-model',
@@ -63,14 +67,14 @@ export function buildAgentWorkspaceSetupChecklist(input: AgentWorkspaceSetupChec
       detail: providerReady
         ? `Current chat route is ${input.provider} / ${input.model}.`
         : 'Choose a provider and model before relying on assistant turns.',
-      command: '/model',
+      command: 'Setup -> Provider and model',
     },
     {
       id: 'agent-knowledge',
       label: 'Agent Knowledge',
       status: 'recommended',
       detail: 'Check isolated Agent Knowledge status, then ingest source-backed material into the Agent segment only.',
-      command: '/knowledge status',
+      command: 'Knowledge',
     },
     {
       id: 'profile',
@@ -81,7 +85,7 @@ export function buildAgentWorkspaceSetupChecklist(input: AgentWorkspaceSetupChec
         : discoveredBehaviorCount > 0
           ? `${discoveredBehaviorCount} discovered behavior file(s) can seed an isolated Agent profile from the Profiles workspace.`
         : `${input.runtimeStarterTemplateCount} starter template(s) are available if this machine needs separate operator identities.`,
-      command: discoveredBehaviorCount > 0 && input.runtimeProfileCount === 0 ? '/agent-profile guide' : '/agent-profile templates',
+      command: 'Profiles',
     },
     {
       id: 'persona',
@@ -92,29 +96,37 @@ export function buildAgentWorkspaceSetupChecklist(input: AgentWorkspaceSetupChec
         : input.discoveredPersonas.count > 0
           ? `${input.discoveredPersonas.count} discovered persona file(s) can be imported into the Agent-local registry.${sampleNames(input.discoveredPersonas)}`
           : 'Create or choose a persona to make the assistant voice and policy explicit.',
-      command: input.discoveredPersonas.count > 0 ? '/personas discover' : '/personas',
+      command: 'Personas',
     },
     {
       id: 'skills',
       label: 'Skills',
-      status: input.enabledSkillCount > 0 || input.enabledSkillBundleCount > 0 ? 'ready' : input.skillCount > 0 || input.skillBundleCount > 0 || input.discoveredSkills.count > 0 ? 'recommended' : 'optional',
+      status: input.missingSkillRequirementCount > 0
+        ? 'recommended'
+        : input.enabledSkillCount > 0 || input.enabledSkillBundleCount > 0
+          ? 'ready'
+          : input.skillCount > 0 || input.skillBundleCount > 0 || input.discoveredSkills.count > 0
+            ? 'recommended'
+            : 'optional',
       detail: input.skillCount > 0 || input.skillBundleCount > 0
-        ? `${input.enabledSkillCount}/${input.skillCount} local skill(s) enabled; ${input.enabledSkillBundleCount}/${input.skillBundleCount} bundle(s) enabled.${input.discoveredSkills.count > 0 ? ` ${input.discoveredSkills.count} discovered skill file(s) are still available to import.` : ''}`
+        ? `${input.enabledSkillCount}/${input.skillCount} local skill(s) enabled; ${input.enabledSkillBundleCount}/${input.skillBundleCount} bundle(s) enabled.${input.missingSkillRequirementCount > 0 ? ` ${input.missingSkillRequirementCount} missing setup requirement(s).` : ''}${input.discoveredSkills.count > 0 ? ` ${input.discoveredSkills.count} discovered skill file(s) are still available to import.` : ''}`
         : input.discoveredSkills.count > 0
           ? `${input.discoveredSkills.count} discovered skill file(s) can be imported as local reusable procedures.${sampleNames(input.discoveredSkills)}`
           : 'Create reusable local skills and bundles for repeated workflows.',
-      command: input.discoveredSkills.count > 0 ? '/agent-skills discover' : '/agent-skills',
+      command: 'Skills',
     },
     {
       id: 'routines',
       label: 'Routines',
-      status: setupStatusForCount(input.enabledRoutineCount, 'ready', input.routineCount > 0 || input.discoveredRoutines.count > 0 ? 'recommended' : 'optional'),
+      status: input.missingRoutineRequirementCount > 0
+        ? 'recommended'
+        : setupStatusForCount(input.enabledRoutineCount, 'ready', input.routineCount > 0 || input.discoveredRoutines.count > 0 ? 'recommended' : 'optional'),
       detail: input.routineCount > 0
-        ? `${input.enabledRoutineCount}/${input.routineCount} local routine(s) enabled.${input.discoveredRoutines.count > 0 ? ` ${input.discoveredRoutines.count} discovered routine file(s) are still available to import.` : ''}`
+        ? `${input.enabledRoutineCount}/${input.routineCount} local routine(s) enabled.${input.missingRoutineRequirementCount > 0 ? ` ${input.missingRoutineRequirementCount} missing setup requirement(s).` : ''}${input.discoveredRoutines.count > 0 ? ` ${input.discoveredRoutines.count} discovered routine file(s) are still available to import.` : ''}`
         : input.discoveredRoutines.count > 0
           ? `${input.discoveredRoutines.count} discovered routine file(s) can be imported as main-conversation workflows.${sampleNames(input.discoveredRoutines)}`
           : 'Create local routines first; promote schedules only with explicit confirmation.',
-      command: input.discoveredRoutines.count > 0 ? '/routines discover' : '/routines',
+      command: 'Routines',
     },
     {
       id: 'memory',
@@ -123,7 +135,16 @@ export function buildAgentWorkspaceSetupChecklist(input: AgentWorkspaceSetupChec
       detail: input.localMemoryCount > 0
         ? `${input.localMemoryCount} Agent memory record(s) are available; ${input.localMemoryReviewQueueCount} need review.`
         : 'Memory starts empty; durable facts should be stored deliberately and never include secrets.',
-      command: '/memory',
+      command: 'Memory',
+    },
+    {
+      id: 'notes',
+      label: 'Scratchpad notes',
+      status: setupStatusForCount(input.localNoteCount, 'ready', 'optional'),
+      detail: input.localNoteCount > 0
+        ? `${input.localNoteCount} Agent scratchpad note(s) are available; ${input.localNoteReviewQueueCount} need review.`
+        : 'Notes start empty; use them for source triage, temporary decisions, and handoff before promoting anything durable.',
+      command: 'Notes',
     },
     {
       id: 'channels',
@@ -132,14 +153,14 @@ export function buildAgentWorkspaceSetupChecklist(input: AgentWorkspaceSetupChec
       detail: input.readyChannelCount > 0
         ? `${input.readyChannelCount} external channel(s) are ready.`
         : 'Pair or review channels only when you want the assistant reachable outside this terminal.',
-      command: '/pair',
+      command: 'Channels',
     },
     {
       id: 'voice-media',
       label: 'Voice and media',
       status: input.voiceProviderCount > 0 || input.mediaProviderCount > 0 ? 'ready' : 'optional',
       detail: `${input.voiceProviderCount} voice provider(s), ${input.mediaProviderCount} media provider(s). Configure these only when useful.`,
-      command: '/config tts',
+      command: 'Voice & Media',
     },
   ];
 }