@pellux/goodvibes-agent 0.1.67 → 0.1.68

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to GoodVibes Agent will be recorded here.
 
+## 0.1.68 - 2026-05-31
+
+- Removed internal foundation-phase language and blocked lifecycle command examples from package-facing docs.
+- Stopped advertising runtime lifecycle and surface-management commands in shell completion while keeping safety blocks for accidental invocations.
+- Added package text guards so shipped docs stay focused on the Agent TUI product path.
+
 ## 0.1.67 - 2026-05-31
 
 - Reworked remote bridge and remote review language from copied runner/control-room wording to Agent-facing worker/review wording.
@@ -377,7 +383,7 @@ All notable changes to GoodVibes Agent will be recorded here.
 ## 0.1.0 - 2026-05-28
 
 - Published the first public alpha package for `@pellux/goodvibes-agent`.
-- Kept the near-fork GoodVibes TUI shell, renderer, input, fullscreen workspace, command registry, and release foundation.
+- Kept the GoodVibes TUI-derived shell, renderer, input, fullscreen workspace, command registry, and release foundation.
 - Preserved Agent product policy: serial/proactive main conversation by default, no local Agent-owned WRFC/spawn fanout, and explicit GoodVibes TUI delegation for build/fix/review work.
 - Moved Agent-owned runtime state to `.goodvibes/agent` surface roots.
 - Updated packaged Agent guidance, reviewer persona, and provider skill to avoid copied TUI WRFC/multi-agent defaults.
@@ -386,7 +392,7 @@ All notable changes to GoodVibes Agent will be recorded here.
 
 ## 0.0.0 - Private Baseline
 
-- Copied the GoodVibes terminal foundation as a near-fork starting point for the Agent product.
+- Adopted the GoodVibes terminal foundation as the starting point for the Agent product.
 - Renamed package identity to `@pellux/goodvibes-agent` and exposed one executable, `goodvibes-agent`.
 - Pinned `@pellux/goodvibes-sdk` to `0.33.35`.
 - Removed packaged runtime-host binaries and blocked Agent-owned runtime/service lifecycle commands.

package/README.md

@@ -3,7 +3,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 [![Status: alpha](https://img.shields.io/badge/status-alpha-orange.svg)](#install)
 
-GoodVibes Agent is the personal operator assistant built on the GoodVibes terminal UI foundation. This repository is intentionally in a near-fork baseline phase: the shell, renderer, input, fullscreen workspace, command, and release bones are copied from the terminal product first, then the coding-specific behavior is removed or reshaped deliberately.
+GoodVibes Agent is the personal operator assistant TUI for GoodVibes. It is built for day-to-day operator work: chat, setup, local profiles, routines, skills, personas, isolated Agent Knowledge, status review, approvals, automation visibility, and explicit build delegation.
 
 The Agent product connects to an already-running GoodVibes runtime. It does not install, start, stop, restart, or own runtime connectivity or service lifecycle.
 
@@ -87,15 +87,7 @@ Starting a routine records local usage and prints its steps; it does not spawn b
 
 Start or restart the GoodVibes runtime from GoodVibes TUI or the owning host before launching Agent. Agent status and companion/knowledge routes connect to that external runtime, normally on `http://127.0.0.1:3421`.
 
-Agent intentionally blocks runtime lifecycle commands:
-
-```sh
-goodvibes-agent serve
-goodvibes-agent service start
-goodvibes-agent surfaces enable web
-```
-
-Those commands should return explicit external-runtime guidance instead of mutating local service posture.
+Agent reports unavailable, unauthenticated, or incompatible runtime state through `goodvibes-agent status`, `goodvibes-agent doctor`, and the TUI status surfaces. It does not provide runtime lifecycle setup commands.
 
 ## Product Boundary
 
@@ -107,10 +99,10 @@ GoodVibes TUI owns coding execution: file edits, git/worktree workflows, coding
 
 ## Package Docs
 
-Package-facing docs are intentionally narrow during the near-fork baseline:
+Package-facing docs:
 
 - [Getting Started](docs/getting-started.md)
 - [Deployment And Services](docs/deployment-and-services.md)
 - [Release And Publishing](docs/release-and-publishing.md)
 
-Broader foundation reference docs may exist in the source tree while the near-fork foundation is being completed, but the package-facing Agent documentation is limited to the docs listed above.
+The package-facing Agent documentation is limited to the docs listed above.

package/docs/README.md

@@ -1,8 +1,6 @@
 # GoodVibes Agent Docs
 
-These are the package-facing docs for GoodVibes Agent.
-
-GoodVibes Agent is a near-fork of the GoodVibes terminal foundation with a different product brain. It uses the copied terminal shell, renderer, input, fullscreen workspace, command, and release bones while the Agent-specific assistant behavior is being rebuilt.
+These are the package-facing docs for GoodVibes Agent, the personal operator assistant TUI for GoodVibes.
 
 Current package docs:
 
@@ -24,4 +22,4 @@ Important baseline constraints:
 - 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.
 
-Copied TUI release and UAT histories are intentionally not part of this repository. The Agent docs above define the supported alpha behavior.
+The Agent docs above define the supported alpha behavior.

package/docs/deployment-and-services.md

@@ -1,8 +1,8 @@
 # Deployment And Services
 
-GoodVibes Agent is a client/operator surface. It does not own runtime or listener deployment.
+GoodVibes Agent is a client/operator TUI. It connects to an already-running GoodVibes runtime and does not own runtime or listener deployment.
 
-## Service Ownership
+## Runtime Ownership
 
 Agent must not:
 
@@ -12,7 +12,7 @@ Agent must not:
 - start, stop, or restart runtime services
 - enable web, listener, control-plane, or channel surface posture
 
-Those operations belong to GoodVibes TUI or the owning runtime host.
+Those operations belong to GoodVibes TUI or the owning runtime host. Agent reports external runtime readiness but does not configure that host.
 
 ## Agent Runtime
 
@@ -40,12 +40,6 @@ http://127.0.0.1:3421
 
 If the runtime is unavailable, unauthenticated, or on an incompatible SDK version, Agent commands should report actionable diagnostics without printing token values.
 
-## Surface Commands
-
-`goodvibes-agent surfaces`, `surfaces check`, and `surfaces show <surfaceId>` are read-only diagnostics.
-
-`surfaces enable` and `surfaces disable` are intentionally blocked in Agent because they can mutate runtime/listener/web/channel posture.
-
 ## Release Rule
 
 Only publish Agent releases that preserve the Agent product policy:

package/docs/getting-started.md

@@ -101,6 +101,6 @@ Agent Knowledge/Wiki is an Agent-owned product segment. Agent commands must not
 
 Agent lifecycle commands that would start or mutate runtime posture are blocked intentionally. Use `goodvibes-agent status`, `goodvibes-agent doctor`, and read-only surface checks for diagnostics.
 
-## Current Baseline Notes
+## Current Product Notes
 
-This repository keeps broad terminal foundation code intentionally so Agent can use the mature shell, renderer, input, fullscreen workspace, command registry, and release bones. The active Agent policy is serial/proactive by default, blocks local Agent-owned WRFC/spawn fanout, and delegates explicit build/fix/review work to GoodVibes TUI instead of turning the Agent into a coding TUI.
+Agent uses the mature GoodVibes terminal shell, renderer, input, fullscreen workspace, command registry, and release foundation. The active Agent policy is serial/proactive by default, blocks local Agent-owned WRFC/spawn fanout, and delegates explicit build/fix/review work to GoodVibes TUI instead of turning the Agent into a coding TUI.

package/docs/release-and-publishing.md

@@ -55,6 +55,6 @@ Do not publish if Agent Knowledge commands can fall back to default Knowledge/Wi
 
 Do not ship runtime host binaries from this package. If Agent later gets compiled artifacts, they must use Agent artifact names and remain separate from runtime ownership.
 
-## Near-Fork Baseline Rule
+## Product Rule
 
-The public alpha can include copied terminal foundation code, but package-facing behavior must follow Agent product policy. Follow-up work should continue pruning or reshaping copied coding-first surfaces while preserving the renderer, input, fullscreen workspace, command registry, and release bones.
+The public alpha can include mature terminal foundation code, but package-facing behavior must follow Agent product policy. Follow-up work should continue pruning or reshaping coding-first surfaces while preserving the renderer, input, fullscreen workspace, command registry, and release bones.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-agent",
-  "version": "0.1.67",
+  "version": "0.1.68",
   "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/cli/completion.ts

@@ -2,9 +2,6 @@ const COMMANDS = [
   'tui',
   'run',
   'exec',
-  'serve',
-  'web',
-  'service',
   'onboarding',
   'setup',
   'doctor',
@@ -25,9 +22,6 @@ const COMMANDS = [
   'tasks',
   'pair',
   'qrcode',
-  'surfaces',
-  'listener',
-  'control-plane',
   'bundle',
   'remote',
   'bridge',
@@ -44,7 +38,6 @@ const OPTIONS = [
   '--agent-profile',
   '--cd',
   '--working-dir',
-  '--daemon-home',
   '--config',
   '--enable',
   '--disable',
@@ -54,8 +47,6 @@ const OPTIONS = [
   '--output-format',
   '--json',
   '--no-alt-screen',
-  '--port',
-  '--hostname',
   '--open',
   '--resume',
   '--session',

package/src/cli/package-verification.ts

@@ -73,6 +73,10 @@ const PACKAGE_FACING_FORBIDDEN_TEXT = [
   ['Her', 'mes'].join(''),
   ['capabilities', ' audit'].join(''),
   ['capabilities', ' command'].join(''),
+  ['near', '-fork'].join(''),
+  ['goodvibes-agent', 'serve'].join(' '),
+  ['goodvibes-agent', 'service start'].join(' '),
+  ['goodvibes-agent', 'surfaces enable'].join(' '),
   'Every plan must have a multi-agent execution strategy',
   'NEVER skip WRFC',
   'ALWAYS work in parallel when implementing a plan',

package/src/runtime/index.ts

@@ -2,7 +2,7 @@
  * Runtime module barrel for GoodVibes Agent.
  *
  * SDK 0.33 intentionally removed private deep imports and the runtime root
- * god-barrel. This file keeps the near-fork Agent app on public SDK seams
+ * god-barrel. This file keeps the Agent app on public SDK seams
  * while preserving the local import surface used by the shell.
  */
 

package/src/tools/wrfc-agent-guard.ts

@@ -783,7 +783,7 @@ function narrowStringEnumProperty(
   property.description = description;
 }
 
-// Compatibility exports for copied TUI tests/imports during the near-fork phase.
+// Compatibility exports for inherited terminal-foundation tests/imports.
 export const installWrfcAgentToolGuard = installAgentToolPolicyGuard;
 export const wrapWrfcAgentTool = wrapAgentToolForAgentPolicy;
 export const validateWrfcAgentToolInvocation = validateAgentToolInvocationForAgentPolicy;

package/src/version.ts

@@ -6,7 +6,7 @@ import { join } from 'node:path';
 // The prebuild script updates the fallback value before compilation.
 // Uses import.meta.dir (Bun) to locate package.json relative to this file,
 // which is correct regardless of the process working directory.
-let _version = '0.1.67';
+let _version = '0.1.68';
 let _sdkVersion = '0.33.35';
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', 'package.json'), 'utf-8')) as {