@pellux/goodvibes-agent 0.1.102 → 0.1.104

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to GoodVibes Agent will be recorded here.
 
+## 0.1.104 - 2026-06-01
+
+- 37fe253 Add Agent memory workspace controls
+
+## 0.1.103 - 2026-06-01
+
+- ed9895a Add CLI controls for Agent memory
+- da48bc2 Add CLI controls for local agent libraries
+- ef18975 Use runtime naming in agent workspace
+- c172f38 Rename Agent tool policy guard
+- 7708f3e Prune local agent activity modals
+- 24eae8e Remove local agent activity panel
+- 90dcd58 Remove legacy release test runner
+
 ## 0.1.102 - 2026-06-01
 
 - 34aaea8 Prune hidden copied panel surfaces

package/README.md

@@ -16,6 +16,9 @@ bun add -g @pellux/goodvibes-agent
 goodvibes-agent --help
 goodvibes-agent status
 goodvibes-agent profiles templates
+goodvibes-agent personas list
+goodvibes-agent skills list
+goodvibes-agent memory list
 goodvibes-agent knowledge status
 goodvibes-agent knowledge list --kind sources
 goodvibes-agent knowledge import-urls ./agent-sources.txt --yes
@@ -61,6 +64,9 @@ Use isolated Agent profiles when one machine needs separate operator identities
 ```sh
 goodvibes-agent profiles templates
 goodvibes-agent profiles create household --template household --yes
+goodvibes-agent personas create --name "Travel Planner" --description "Plan trips" --body "Compare options before booking" --use
+goodvibes-agent skills create --name "Daily Brief" --description "Summarize operator state" --procedure "Review Agent Knowledge, work plans, approvals, and routines" --enabled
+goodvibes-agent memory add fact "Prefers concise morning briefings" --scope project --tags preference
 goodvibes-agent profiles templates export research ./research-starter.json --yes
 goodvibes-agent profiles templates import ./research-starter.json --yes
 goodvibes-agent --agent-profile household status
@@ -69,6 +75,8 @@ GOODVIBES_AGENT_HOME=/path/to/agent-home goodvibes-agent status
 
 Profiles isolate Agent-local config, sessions, local memory, personas, skills, routines, and setup state. Starter templates seed local personas, skills, and routines for household, research, travel, operations, and personal productivity profiles; exported starter JSON can be edited and re-imported as a local starter. The GoodVibes runtime is still external and shared unless the owning host is separately configured otherwise.
 
+The same local behavior libraries are available without opening the TUI: `goodvibes-agent personas ...`, `goodvibes-agent skills ...`, `goodvibes-agent memory ...`, and `goodvibes-agent routines ...` list, create, review, enable, stale, export/import where relevant, and delete local Agent records with explicit confirmation for destructive actions.
+
 Local Agent behavior is editable from the TUI:
 
 ```text
@@ -81,6 +89,8 @@ Local Agent behavior is editable from the TUI:
 /schedule reconcile
 /agent-skills create --name "Morning Brief" --description "Daily briefing flow" --procedure "Check tasks, approvals, calendar, and unread state before summarizing." --enabled true
 /skills local list
+/recall add fact Prefers concise morning briefings --scope project --tags preference
+/recall search morning
 ```
 
 Starting a routine records local usage and prints its steps; it does not spawn background agents or automation jobs. Promotion to an external schedule is separate and explicit: it calls the public `schedules.create` route only after `--yes`, can include explicit delivery targets such as `--delivery-channel slack`, records a redacted local receipt, and the generated scheduled prompt keeps Agent Knowledge isolated from default Knowledge/Wiki and non-Agent knowledge segments. Use `/schedule reconcile` to compare those local receipts against live external schedules through public `schedules.list`.

package/docs/README.md

@@ -19,7 +19,7 @@ Important baseline constraints:
 - Agent supports isolated runtime homes with `GOODVIBES_AGENT_HOME=<path>` and named profile homes with `goodvibes-agent profiles create <name> --template <starter> --yes` plus `--agent-profile <name>`.
 - Agent supports external runtime URL overrides with `--runtime-url http://host:port` or `GOODVIBES_AGENT_RUNTIME_URL=http://host:port`; these do not make Agent own runtime hosting.
 - Agent ships starter profile templates for household, research, travel, operations, and personal productivity local state; `profiles templates export/import` and `/agent-profile guide` support local custom starters.
-- Local personas, routines, and Agent skills are stored under the Agent home and are injected only into the serial Agent conversation.
+- Local memory, personas, routines, and Agent skills are stored under the Agent home and are injected only into the serial Agent conversation.
 - Normal assistant chat is not coding-session delegation.
 - Build/fix/review delegation to GoodVibes TUI must be explicit; WRFC is not the default Agent behavior.
 

package/docs/getting-started.md

@@ -16,6 +16,9 @@ Agent does not launch the runtime for you.
 bun add -g @pellux/goodvibes-agent
 goodvibes-agent --help
 goodvibes-agent status
+goodvibes-agent personas list
+goodvibes-agent skills list
+goodvibes-agent memory list
 ```
 
 If the installed command is not found, add Bun's global bin directory to `PATH`:
@@ -48,6 +51,15 @@ Use `/agent-profile guide` inside that workspace to walk through starter-profile
 
 Use `/schedule receipts` to review redacted local routine promotion history and `/schedule reconcile` to compare those receipts with live external schedules through public `schedules.list`.
 
+The local behavior libraries are also available from the installed CLI:
+
+```sh
+goodvibes-agent personas create --name "Research Analyst" --description "Source-backed research" --body "Check sources and call out uncertainty" --use
+goodvibes-agent skills create --name "Morning Brief" --description "Daily briefing flow" --procedure "Check tasks, approvals, routines, and Agent Knowledge before summarizing" --enabled
+goodvibes-agent memory add fact "Prefers concise morning briefings" --scope project --tags preference
+goodvibes-agent routines list
+```
+
 ## Isolated Agent Profiles
 
 Use a separate Agent home when you want isolated local state:
@@ -69,9 +81,9 @@ goodvibes-agent --agent-profile household
 
 Named profiles isolate Agent-local config, sessions, memory, personas, skills, routines, and setup state under a profile-specific home. Starter templates seed local personas, skills, and routines for household, research, travel, operations, and personal productivity profiles; exported starter JSON can be edited and re-imported as a local starter. They do not start or isolate the external GoodVibes runtime by themselves.
 
-## Local Personas, Routines, And Skills
+## Local Memory, Personas, Routines, And Skills
 
-Personas, routines, and reusable Agent skills are local to GoodVibes Agent. They do not write into default Knowledge/Wiki or non-Agent knowledge segments.
+Memory, personas, routines, and reusable Agent skills are local to GoodVibes Agent. They do not write into default Knowledge/Wiki or non-Agent knowledge segments.
 
 ```text
 /personas list
@@ -83,9 +95,11 @@ Personas, routines, and reusable Agent skills are local to GoodVibes Agent. They
 /agent-skills create --name "Morning Brief" --description "Daily briefing flow" --procedure "Check tasks, approvals, calendar, and unread state before summarizing." --enabled true
 /agent-skills enabled
 /skills local list
+/recall add fact Prefers concise morning briefings --scope project --tags preference
+/recall search morning
 ```
 
-The active persona plus enabled Agent routines and skills are injected into the main serial assistant conversation. Starting a routine records local usage and prints its steps; it does not spawn background agents or automation jobs. Promoting a routine to a schedule is an explicit `schedules.create` call, requires `--yes`, writes a local redacted promotion receipt, and preserves the rule that Agent Knowledge never falls back to default Knowledge/Wiki or non-Agent knowledge segments.
+The active persona plus enabled Agent routines, reviewed memory, and skills are injected into the main serial assistant conversation. Starting a routine records local usage and prints its steps; it does not spawn background agents or automation jobs. Promoting a routine to a schedule is an explicit `schedules.create` call, requires `--yes`, writes a local redacted promotion receipt, and preserves the rule that Agent Knowledge never falls back to default Knowledge/Wiki or non-Agent knowledge segments.
 
 ## External Runtime
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-agent",
-  "version": "0.1.102",
+  "version": "0.1.104",
   "private": false,
   "description": "GoodVibes personal operator assistant TUI with a proactive Agent product brain, isolated Agent Knowledge, local profiles, routines, skills, personas, and explicit build delegation.",
   "type": "module",

package/src/agent/memory-safety.ts

@@ -0,0 +1,16 @@
+const SECRET_PATTERNS: readonly RegExp[] = [
+  /-----BEGIN [A-Z ]*PRIVATE KEY-----/i,
+  /\bsk-[A-Za-z0-9_-]{16,}\b/,
+  /\bgh[pousr]_[A-Za-z0-9_]{16,}\b/i,
+  /\b(?:password|passwd|api[_-]?key|token|secret)\s*[:=]\s*\S{6,}/i,
+];
+
+export function containsSecretLikeText(text: string): boolean {
+  return SECRET_PATTERNS.some((pattern) => pattern.test(text));
+}
+
+export function assertNoSecretLikeMemoryText(fields: readonly string[]): void {
+  if (fields.some((field) => containsSecretLikeText(field))) {
+    throw new Error('Agent memory cannot store secret-looking values. Store a secret reference or remove the sensitive text.');
+  }
+}

package/src/cli/help.ts

@@ -37,6 +37,9 @@ export function renderGoodVibesHelp(binary = 'goodvibes-agent'): string {
     '  models [provider]          List/use/pin selectable models and recent model history',
     '  providers                  List/inspect/use provider config/auth posture',
     '  profiles                   Manage isolated Agent profile homes',
+    '  personas                   Manage local Agent personas',
+    '  skills                     Manage local Agent skills and skill bundles',
+    '  memory                     Manage Agent-owned durable memory records',
     '  routines                   Inspect local routines and explicitly promote one to an external schedule',
     '  auth                       Inspect Agent auth posture and external runtime token state',
     '  compat                     Inspect Agent SDK pin, runtime version, and Agent knowledge route readiness',
@@ -89,6 +92,10 @@ export function renderGoodVibesHelp(binary = 'goodvibes-agent'): string {
     `  ${binary} providers inspect openai`,
     `  ${binary} profiles create household --template household --yes`,
     `  ${binary} --agent-profile household`,
+    `  ${binary} personas create --name "Travel Planner" --description "Plan trips" --body "Compare options before booking"`,
+    `  ${binary} skills create --name "Daily Brief" --description "Summarize operator state" --procedure "Review Agent Knowledge, work plans, approvals, and routines" --enabled`,
+    `  ${binary} memory add fact "Prefers concise morning briefings" --scope project --tags preference`,
+    `  ${binary} memory search "morning briefings"`,
     `  ${binary} routines promote daily-operations-sweep --cron "0 9 * * *" --timezone America/Chicago --yes`,
     `  ${binary} compat`,
     `  ${binary} knowledge status`,
@@ -146,6 +153,80 @@ const COMMAND_HELP: Record<string, CommandHelp> = {
     summary: 'Create and inspect isolated Agent profile homes, with starter templates for household, research, travel, operations, personal productivity, and local imported starters. A profile changes Agent-local config, sessions, memory, personas, skills, routines, and setup paths without changing the shared GoodVibes runtime.',
     examples: ['profiles templates', 'profiles templates export research ./research-starter.json --yes', 'profiles templates import ./research-starter.json --yes', 'profiles create household --template household --yes', '--agent-profile household status'],
   },
+  personas: {
+    usage: [
+      'personas list',
+      'personas active',
+      'personas search <query>',
+      'personas show <id>',
+      'personas create --name <name> --description <summary> --body <instructions> [--tags a,b] [--triggers a,b] [--use]',
+      'personas update <id> [--name <name>] [--description <summary>] [--body <instructions>] [--tags a,b] [--triggers a,b]',
+      'personas use <id>',
+      'personas clear',
+      'personas review <id>',
+      'personas stale <id> <reason>',
+      'personas delete <id> --yes',
+    ],
+    summary: 'Manage Agent-local personas for the serial main conversation. Personas do not spawn worker agents.',
+    examples: [
+      'personas list',
+      'personas create --name "Travel Planner" --description "Plan trips" --body "Compare options before booking" --use',
+      'personas review travel-planner',
+      'personas delete travel-planner --yes',
+    ],
+  },
+  skills: {
+    usage: [
+      'skills list',
+      'skills enabled',
+      'skills active',
+      'skills search <query>',
+      'skills show <id>',
+      'skills create --name <name> --description <summary> --procedure <steps> [--tags a,b] [--triggers a,b] [--enabled]',
+      'skills update <id> [--name <name>] [--description <summary>] [--procedure <steps>] [--tags a,b] [--triggers a,b]',
+      'skills enable <id>',
+      'skills disable <id>',
+      'skills review <id>',
+      'skills stale <id> <reason>',
+      'skills delete <id> --yes',
+      'skills bundle [list|enabled|show|create|update|enable|disable|review|stale|delete]',
+    ],
+    summary: 'Manage reusable Agent-local procedures and skill bundles for the main conversation.',
+    examples: [
+      'skills list',
+      'skills create --name "Daily Brief" --description "Summarize operator state" --procedure "Review Agent Knowledge, work plans, approvals, and routines" --enabled',
+      'skills bundle create --name "Ops Pack" --description "Daily operations bundle" --skills daily-brief --enabled',
+      'skills delete daily-brief --yes',
+    ],
+  },
+  memory: {
+    usage: [
+      'memory list [class] [--scope session|project|team] [--limit <n>]',
+      'memory search <query> [--semantic] [--cls <class>] [--scope <scope>] [--limit <n>]',
+      'memory add <class> <summary> [--scope <scope>] [--detail <text>] [--tags a,b] [--confidence <0-100>]',
+      'memory show <id>',
+      'memory queue [limit]',
+      'memory review <id> <fresh|reviewed|stale|contradicted> [--confidence <0-100>] [--by <name>] [--reason <text>]',
+      'memory stale <id> <reason>',
+      'memory contradict <id> <reason>',
+      'memory promote <id> <session|project|team> --yes',
+      'memory link <fromId> <toId> <relation> --yes',
+      'memory delete <id> --yes',
+      'memory export <path> [--scope <scope>] [--cls <class>] --yes',
+      'memory import <path> --yes',
+      'memory handoff-inspect <path>',
+      'memory vector [status|doctor|rebuild]',
+    ],
+    summary: 'Manage Agent-owned durable memory. This uses the Agent memory store only; it never falls back to default Knowledge/Wiki or non-Agent knowledge segments.',
+    examples: [
+      'memory list',
+      'memory add fact "Prefers concise morning briefings" --scope project --tags preference',
+      'memory search "morning briefings"',
+      'memory review mem-1 reviewed --confidence 92',
+      'memory export ./agent-memory.json --scope project --yes',
+      'memory delete mem-1 --yes',
+    ],
+  },
   routines: {
     usage: [
       'routines list',
@@ -267,6 +348,11 @@ const HELP_ALIASES: Record<string, string> = {
   provider: 'providers',
   model: 'models',
   profile: 'profiles',
+  persona: 'personas',
+  skill: 'skills',
+  'agent-skills': 'skills',
+  memories: 'memory',
+  recall: 'memory',
   subscriptions: 'subscription',
   secret: 'secrets',
   session: 'sessions',