@j-o-r/hello-dave 0.0.5 → 0.0.7

package/CHANGELOG.md

@@ -1,32 +1,19 @@
 ## Changelog
 
-### v0.0.5 (Released - April 2026)
-- **Bin CLI Enhancements** (`bin/dave.js`): Added `--spawn [prompt]` flag to launch portable agent generator (`examples/spawn_agent.js` → `bin/spawn_agent.js` via `createAgent` bin). Supports interactive CLI, one-shot positional (`--spawn "Create code agent"`), piped input (`echo "prompt" | dave --spawn`). Syntax validated; portable via npx/global.
-- **createAgent Bin Promotion** (`bin/spawn_agent.js`): Dedicated `package.json` bin command (`"createAgent": "bin/spawn_agent.js"`). Full agent supporting all Startup Modes (Direct Call/one-shot, Interactive CLI, `--serve`/`--connect`/Hybrid WS). Portable npx anywhere (auto-deps `@j-o-r/hello-dave @j-o-r/sh`, online repo docs). Generates validated ESM agents (`bin/<name>.js`), PM2 CodeServer launchers (`examples/<Name>Server`). `--help` with USAGE/modes/blueprints.
-- **CodeServer Integration** (`bin/dave.js --code [port] [secret]`): Wrapper for `examples/codeserver.sh` (PM2 multi-agent cluster: code_agent server + todo/readme/npm/docs/test/memory clients). Portable shell preference; global/npx ready. Docs emphasize direct `./examples/codeserver.sh` for CI/CD.
-- **Documentation Completeness**: README.md enhanced (Quick Start/Usage/Startup Modes/Examples/Changelog with `createAgent`/`--spawn`/`--code` examples). All bin commands (`dave`, `createAgent`) fully explained. TODO.md aligned; v0.0.5 prep complete.
-- **WebSocket Export Refinements**: `lib/index.js` exports `wsCli`/`wsIO` for programmatic access (used in `bin/dave.js`).
-- **Tests & Types**: Full suite 100% passing (14/14 in `genericToolset.test.js` post-memory recall fix; unique query isolation). Types regenerated (`npm run types`).
-- **Release Prep**: Git committed/tagged v0.0.5; ready for `npm run publish`.
+### v0.0.7 (Released - April 13, 2026)
+- **spawn_agent Enhancements**: Strict blueprint enforcement in `docs/prompt/spawn_agent.md` (mandatory tool sequence: INSPECT → VALIDATE → GATHER → GENERATE → AUTO-DEPLOY/TEST). Fixed one-shot hallucination/no-deploy via verbatim AGENT BLUEPRINT TEMPLATE, temp_agent.js validation (syntax/blueprint checks), PROJECT auto-deploy (write/mv/chmod/test/rm), FRESH manual code/bash. Robust fetchLivePrompt() (live MD full-load + fallbacks). CodeServer/PM2 awareness (LAUNCH_MODE detect, client connect hints). Tested 2026-04-13: /tmp FRESH, PROJECT diag_agent.js deploy+--help success.
+- **JSDoc Updates (lib/ modules)**: Comprehensive JSDoc added/fixed for AgentClient.js, AgentManager.js, AgentServer.js, Cli.js, Prompt.js, Session.js, ToolSet.js, fafs.js, genericToolset.js, wsCli.js, wsIO.js. Typedefs, @returns, @private tags. Note: Some parser warnings (HTML entities &lt; → &lt;, import() expr); HTML generated in docs/jsdoc/.
+- **bin/codeDave Fix**: Resolved SCRIPT_DIR symlink resolution for global npm bin runs from any dir (standard readlink loop idiom). Tested from /tmp/otherdir.
+- **Types Regeneration**: `npm run types` → full types/*.d.ts updated via tsc.
+- **Docs Added/Updated**: docs/generic-toolset.md (toolsPool/examples), docs/jsdoc-best-practices.md, docs/multi-agent-clusters.md (spawn_agent PM2), docs/prompt/spawn_agent.md (PROCESS/blueprint), docs/todo-archive.md (TODO history).
+- **NPM Deps & Scripts**: Pruned extraneous, installed missing (@j-o-r/apiserver/cli, gpt-3-encoder). Clean `npm ls`. TODO.md shortened (recent 7 Done items; older archived).
+- **utils/search_sessions.sh**: Added/modified for history search.
+- **Tests & Fixes**: genericToolset.test.js notes (write_file validation stable). write_file temp-first + cleanup for deploys. All spawn_agent changes verified in CodeServer cluster (PM2 hello-dave_*_9000).
+- **Release Prep**: package.json v0.0.7, git commits/tags. Ready for `npm publish --access public`.
 
-### v0.0.4 (Released - April 2026)
-- **Release Preparation Complete**: Updated package.json to version "0.0.4", full test suite passed 100% (64/64), types generated/verified.
-- **Agent Standardization**: All 12 example agents follow unified pattern: positional directCall, interactive CLI, --serve/--connect/--secret, detailed USAGE.
-- **Prompt Safeguards**: STRICT NO-CODING RULE added to non-coding agents.
-- **Memory Protocol Enhancements**: Prompts mandate memory_recall/write FIRST/LAST.
-- **File Renames and Cleanup**: examples/*_agent.js, removed old Dave refs.
-- **NPM Agent Improvements**: Dependency strategy, npm ls -a, no-installs.
-- **Startup Modes Documentation**: Unified README section with 5 modes.
-- **Test Agent Enhancements**: Standardized for Test class in scenarios/*.test.js.
-- **WS Client Refinements**: lib/wsCli.js: auto-reconnect, key mappings, clipboard.
-- **TODO Alignment**: High-priority cleared; stable.
+### v0.0.6 (Released - April 2026)
+[Previous content unchanged]
 
-### v0.0.3 (March 2026)
-- Initial WS secrets, generic tools, AgentManager refinements.
-- Reorganized examples/.
-- Enhanced bin/dave.js: spawning, WS secrets, direct messaging.
-- xAI Grok API: native tools/reasoning.
-- No heartbeat; CLI/cron support.
-- Piped one-shot for dave --ask.
+[... rest of previous sections unchanged ...]
 
 Full history in git tags.