@pellux/goodvibes-agent 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to GoodVibes Agent will be recorded here.
 
+## 0.1.7 - 2026-05-31
+
+- Replaced active planning-loop output and tests that still described planning as TUI-owned with Agent-owned planning state and planning namespace language.
+- Added `LICENSE` to the explicit package file contract and release verification so npm tarballs cannot omit license text.
+- Prevented the operator workspace from dispatching placeholder delegation commands such as `/delegate --wrfc <task>`; those actions now provide guidance until the user supplies real task text.
+
+## 0.1.6 - 2026-05-31
+
+- Made the publish helper use exported `NODE_AUTH_TOKEN` or `NPM_TOKEN` automatically by writing a temporary npm user config for publish commands.
+- Rewrote source docs for tools, commands, knowledge, artifacts, and multimodal behavior so they describe Agent-only Knowledge/Wiki and never teach default Knowledge/Wiki or HomeGraph fallback.
+- Updated `/plan` command and Planning panel language from copied TUI-owned wording to Agent-owned workspace planning state.
+- Added regression tests that keep source docs and active planning surfaces aligned with Agent Knowledge isolation and Agent product language.
+
 ## 0.1.5 - 2026-05-31
 
 - Hardened package-facing release checks so shipped docs and Agent guidance cannot reintroduce default Knowledge/Wiki, HomeGraph, Home Assistant, copied TUI daemon, or copied WRFC-first policy text.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Michael Davis and GoodVibes contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/docs/getting-started.md

@@ -1,6 +1,6 @@
 # Getting Started
 
-GoodVibes Agent `0.1.5` is the current installable public alpha of the personal operator assistant built on the GoodVibes TUI foundation.
+GoodVibes Agent `0.1.7` is the current installable public alpha of the personal operator assistant built on the GoodVibes TUI foundation.
 
 ## Requirements
 

package/docs/release-and-publishing.md

@@ -1,6 +1,6 @@
 # Release And Publishing
 
-GoodVibes Agent `0.1.5` is the current installable public alpha release.
+GoodVibes Agent `0.1.7` is the current installable public alpha release.
 
 ## Package Identity
 
@@ -25,6 +25,8 @@ npm pack --dry-run
 git diff --check
 ```
 
+`bun run publish:package` publishes from a staged package directory. If `NPM_CONFIG_USERCONFIG` is already set, npm uses it. Otherwise the script creates a temporary 0600 npm userconfig from `NODE_AUTH_TOKEN` or `NPM_TOKEN`, uses it for that publish command, and removes it with the staging directory.
+
 Also run the package install smoke from a packed artifact. It must prove:
 
 - the installed command is on `PATH`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-agent",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "private": false,
   "description": "Near-fork GoodVibes operator assistant with the GoodVibes TUI shell, renderer, input, fullscreen workspace, and daemon-connected Agent product brain.",
   "type": "module",
@@ -11,6 +11,7 @@
   },
   "files": [
     "bin",
+    "LICENSE",
     ".goodvibes/agents",
     ".goodvibes/skills",
     ".goodvibes/GOODVIBES.md",

package/src/cli/package-verification.ts

@@ -32,6 +32,7 @@ const REQUIRED_BIN_COMMANDS = ['goodvibes-agent'] as const;
 const REQUIRED_TARBALL_PATHS = [
   'README.md',
   'CHANGELOG.md',
+  'LICENSE',
   'package.json',
   'src/main.ts',
   'bin/goodvibes-agent.ts',

package/src/input/agent-workspace.ts

@@ -233,7 +233,7 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
     detail: 'Agent does not become the coding TUI. Build, implement, fix, patch, and review work must be handed to GoodVibes TUI with the full original ask and WRFC only when explicitly requested.',
     actions: [
       { id: 'delegate-guidance', label: 'Delegation rule', detail: 'For build/fix/review work, delegate one request to GoodVibes TUI instead of spawning local Engineer/Reviewer/Tester roots.', kind: 'guidance', safety: 'delegates' },
-      { id: 'review-command', label: 'Review delegation command', detail: 'Use /delegate --wrfc only when the user explicitly asks for code review/build execution.', command: '/delegate --wrfc <task>', kind: 'command', safety: 'delegates' },
+      { id: 'review-command', label: 'Review delegation command', detail: 'Use /delegate --wrfc <task> only when the user explicitly asks for code review/build execution. Close this workspace and include the actual task text.', kind: 'guidance', safety: 'delegates' },
       { id: 'remote-policy', label: 'Remote runner policy', detail: 'Remote dispatch/rerun is blocked in Agent; TUI owns runner topology for delegated build work.', command: '/remote dispatch', kind: 'command', safety: 'blocked' },
     ],
   },
@@ -395,6 +395,17 @@ export class AgentWorkspace {
       };
       return;
     }
+    if (/<[^>\s]+(?:\s+[^>]*)?>/.test(action.command)) {
+      this.status = `Placeholder command not dispatched: ${action.command}.`;
+      this.lastActionResult = {
+        kind: 'guidance',
+        title: `${action.label} needs details`,
+        detail: 'This action is a command template. Close the workspace and run it with real task text instead of placeholder values.',
+        command: action.command,
+        safety: action.safety,
+      };
+      return;
+    }
     if (!this.context?.executeCommand || !this.dispatchCommand) {
       this.status = `Command dispatch is not available for ${action.command}.`;
       this.lastActionResult = {

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

@@ -43,14 +43,14 @@ function formatNextQuestion(question: ProjectPlanningQuestion | undefined): stri
   if (!question) return 'No next question recorded.';
   const lines = [`Next question: ${question.prompt}`];
   if (question.recommendedAnswer) lines.push(`Recommended answer: ${question.recommendedAnswer}`);
-  lines.push('Answer in the prompt, or focus the Planning panel to choose/type an answer.');
+  lines.push('Answer in the prompt, or focus the Planning workspace to choose/type an answer.');
   return lines.join('\n');
 }
 
 export function registerPlanningRuntimeCommands(registry: CommandRegistry): void {
   registry.register({
     name: 'plan',
-    description: 'Inspect or seed TUI-owned project planning state',
+    description: 'Inspect or seed Agent workspace planning state',
     usage: '[panel | approve | list | show <id> | mode | explain | override <strategy> | status | clear | <planning goal>]',
     argsHint: '[panel|approve|status|<goal>]',
     async handler(args, ctx) {
@@ -86,7 +86,7 @@ export function registerPlanningRuntimeCommands(registry: CommandRegistry): void
           ctx.print(
             `Project planning: ${evaluation.readiness}\n` +
             `Project: ${status.projectId}\n` +
-            `Knowledge space: ${status.knowledgeSpaceId}\n` +
+            `Planning namespace: ${status.knowledgeSpaceId}\n` +
             `Artifacts: ${status.counts.states} state, ${status.counts.decisions} decisions, ${status.counts.languageArtifacts} language\n` +
             formatNextQuestion(evaluation.nextQuestion),
           );
@@ -175,11 +175,11 @@ export function registerPlanningRuntimeCommands(registry: CommandRegistry): void
         state: {
           goal: taskDescription,
           knownContext: [
-            `Workspace planning was seeded from the TUI /plan command.`,
+            `Workspace planning was seeded from the Agent /plan command.`,
           ],
           metadata: {
             active: true,
-            owner: 'tui',
+            owner: 'agent',
             source: 'plan-command',
             lastPromptAt: Date.now(),
           },

package/src/panels/builtin/shared.ts

@@ -55,9 +55,9 @@ export interface BuiltinPanelDeps {
   resumeSession?: (sessionId: string) => void;
   /** Request a shell repaint directly rather than routing through a retired event path. */
   requestRender?: () => void;
-  /** Submit a Planning panel answer through the normal TUI chat/planning coordinator path. */
+  /** Submit a Planning panel answer through the normal Agent chat/planning coordinator path. */
   submitPlanningAnswer?: (answer: string) => void;
-  /** Pause the TUI-owned planning loop and return focus to normal prompt input. */
+  /** Pause the Agent-owned planning loop and return focus to normal prompt input. */
   dismissPlanning?: () => void;
   /** ForensicsRegistry for the Forensics panel. */
   forensicsRegistry?: import('@/runtime/index.ts').ForensicsRegistry;
@@ -96,9 +96,9 @@ export interface BuiltinPanelDeps {
   adaptivePlanner?: AdaptivePlanner;
   /** Passive SDK-backed project planning artifact service. */
   projectPlanningService?: ProjectPlanningService;
-  /** Stable workspace project id for project:<projectId> planning spaces. */
+  /** Stable workspace project id for project:<projectId> planning namespaces. */
   projectPlanningProjectId?: string;
-  /** TUI-owned persistent work plan store. */
+  /** Agent-owned persistent work plan store. */
   workPlanStore?: import('../../work-plans/work-plan-store.ts').WorkPlanStore;
   /** Shared system-messages panel instance attached from boot so low-priority chatter stays out of conversation. */
   systemMessagesPanel?: import('../system-messages-panel.ts').SystemMessagesPanel;

package/src/panels/project-planning-panel.ts

@@ -174,11 +174,11 @@ export class ProjectPlanningPanel extends BasePanel {
         lines: [
           buildKeyValueLine(width, [
             { label: 'project', value: this.projectId, valueColor: C.planning },
-            { label: 'space', value: status?.knowledgeSpaceId ?? `project:${this.projectId}`, valueColor: C.value },
-            { label: 'mode', value: 'TUI-owned passive backing store', valueColor: C.info },
+            { label: 'store', value: status?.knowledgeSpaceId ?? `project:${this.projectId}`, valueColor: C.value },
+            { label: 'mode', value: 'Agent-owned workspace planning state', valueColor: C.info },
           ], C),
           buildPanelLine(width, [
-            [' Planning never starts from daemon, webhooks, ntfy, Home Assistant, or companion surfaces.', C.dim],
+            [' Planning stays in the Agent main conversation; build/fix/review execution is delegated explicitly to GoodVibes TUI.', C.dim],
           ]),
         ],
       });
@@ -189,7 +189,7 @@ export class ProjectPlanningPanel extends BasePanel {
           lines: buildEmptyState(
             width,
             'No project planning state has been saved for this workspace.',
-            'Describe the intended change in normal chat to let the TUI start the planning interview. The SDK only stores and evaluates artifacts.',
+            'Describe the intended operator outcome in normal chat to let the Agent start the planning interview. The SDK stores and evaluates artifacts; it does not start execution.',
             [],
             C,
           ),
@@ -227,7 +227,7 @@ export class ProjectPlanningPanel extends BasePanel {
 
       return buildPanelWorkspace(width, height, {
         title: this.loading ? 'Project Planning - loading' : 'Project Planning',
-        intro: 'Passive SDK-backed planning artifacts for the current workspace. Conversation control stays inside this TUI.',
+        intro: 'SDK-backed planning artifacts for the current Agent workspace. Conversation control stays in the main Agent turn.',
         sections: [scroll.section],
         footerLines: this.footerLines(width),
         palette: C,

package/src/planning/project-planning-coordinator.ts

@@ -198,7 +198,7 @@ export class ProjectPlanningCoordinator {
       metadata: {
         ...(existing?.metadata ?? {}),
         active: true,
-        owner: 'tui',
+        owner: 'agent',
         source: 'conversation',
         lastPromptAt: now,
       },
@@ -471,13 +471,13 @@ export class ProjectPlanningCoordinator {
       .join('\n') || '- none recorded yet';
 
     return [
-      'TUI-owned project planning loop is active for this turn.',
+      'Agent-owned planning loop is active for this turn.',
       'Do not execute code changes, spawn agents, or claim implementation is complete unless the user explicitly approves execution after the plan is structurally ready.',
       'Be relentless and thorough: challenge vague wording, inspect relevant context before proposing execution, and ask exactly one focused question when information is missing.',
       'Do not ask broad questions like "what is in scope?" without examples. Break broad planning gaps into concrete choices, explain tradeoffs, and recommend a default the user can accept or correct.',
       '',
       `Project id: ${this.projectId}`,
-      `Knowledge space: ${state.knowledgeSpaceId}`,
+      `Planning namespace: ${state.knowledgeSpaceId}`,
       `Readiness: ${evaluation.readiness}`,
       `Execution approved: ${state.executionApproved ? 'yes' : 'no'}`,
       `Goal: ${state.goal || '(missing)'}`,

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.5';
+let _version = '0.1.7';
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', 'package.json'), 'utf-8'));
   _version = pkg.version ?? _version;