openclawdreams 0.7.0

package/CHANGELOG.md

@@ -0,0 +1,157 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+## [0.7.0](https://github.com/RogueCtrl/OpenClawDreams/compare/v0.6.0...v0.7.0) (2026-03-06)
+
+
+### Features
+
+* **cli:** add dream command and extract shared createDirectClient helper ([6032258](https://github.com/RogueCtrl/OpenClawDreams/commit/603225887ff382fa86c6e4b072de9585710bc1c6))
+
+
+### Bug Fixes
+
+* **cli:** use direct Anthropic API for reflect command instead of nonexistent tools call ([016bc48](https://github.com/RogueCtrl/OpenClawDreams/commit/016bc48bfa70f7ffb25565f5988a49c667ebec0a))
+* **lint:** replace all any types with proper typed alternatives ([3698cc4](https://github.com/RogueCtrl/OpenClawDreams/commit/3698cc4b4a37594b7efdc6e4dc3f01c1cb8cade1))
+* **openclaw:** upgrade plugin to use subagent runtime for reflection ([027679d](https://github.com/RogueCtrl/OpenClawDreams/commit/027679d3566d3a2d5ff410acc7c4e6459c204fd2))
+
+## [0.6.0](https://github.com/RogueCtrl/OpenClawDreams/compare/v0.5.0...v0.6.0) (2026-03-06)
+
+
+### Features
+
+* **cli:** add reflect command to manually trigger reflection/synthesis ([a021650](https://github.com/RogueCtrl/OpenClawDreams/commit/a02165022bb0313683893fe2e0ff0c7d426db993))
+
+
+### Bug Fixes
+
+* **agent_end:** manually synthesize summary and track LLM usage ([76c85cb](https://github.com/RogueCtrl/OpenClawDreams/commit/76c85cb068edd4420169557103091bf8634e36b8))
+* correct agent_end hook registration signature to match OpenClaw API ([d323b5a](https://github.com/RogueCtrl/OpenClawDreams/commit/d323b5a12356010806f32a917adb59ce8f39f4a6))
+* correct registerHook signature to (event, {name, handler}) ([2f67c71](https://github.com/RogueCtrl/OpenClawDreams/commit/2f67c7152178c1977c83d65f8ed719ac177e0acf))
+* use correct OpenClaw API registerHook(events, handler, opts) signature ([8493c4b](https://github.com/RogueCtrl/OpenClawDreams/commit/8493c4bca3d29c0ab7f17e666a3dd50d93fda89e))
+
+
+### Tests
+
+* fix ENOTEMPTY failures in rmSync due to lingering Winston logger streams ([84f9152](https://github.com/RogueCtrl/OpenClawDreams/commit/84f9152441b8c4299b57475567c2767601e05145))
+* remove temporary environment test files ([fbe76af](https://github.com/RogueCtrl/OpenClawDreams/commit/fbe76af8157f27e0afedb2ce13c841c67a477939))
+
+### [0.5.1](https://github.com/RogueCtrl/OpenClawDreams/compare/v0.5.0...v0.5.1) (2026-03-06)
+
+## [0.5.0](https://github.com/RogueCtrl/OpenClawDreams/compare/v0.4.0...v0.5.0) (2026-03-06)
+
+
+### Features
+
+* Add plugin ID, refactor CLI commands to use parent, and apply minor formatting fixes. ([55ee458](https://github.com/RogueCtrl/OpenClawDreams/commit/55ee458d92cabe8f7f1b80bd0789d957ed9d64f9))
+* Introduce plugin ID in package configuration and export plugin object from index.ts. ([5085020](https://github.com/RogueCtrl/OpenClawDreams/commit/5085020d87b5fb6f85bdbb3c43d67370cb7ce5a7))
+
+
+### Documentation
+
+* clarify hot-reloading mechanism for plugin activation ([6cfda73](https://github.com/RogueCtrl/OpenClawDreams/commit/6cfda73540be85155a730c2734156350ca5b2742))
+* clarify internal scheduler and daemon uptime dependency ([dc0e6a6](https://github.com/RogueCtrl/OpenClawDreams/commit/dc0e6a6a7a160575bd395b133b983e841de78358))
+* remove references to cron in favor of internal node scheduler ([8496605](https://github.com/RogueCtrl/OpenClawDreams/commit/84966051c700d74256ebb05f7a4ba6d88261ecc2))
+
+## [0.4.0](https://github.com/RogueCtrl/ElectricSheep/compare/v0.3.1...v0.4.0) (2026-03-06)
+
+
+### Bug Fixes
+
+* correct registerCli signature to use callback form ([c25fe36](https://github.com/RogueCtrl/ElectricSheep/commit/c25fe3635f76396b04c02a34575190863a1deaf4))
+* **plugin:** specify openclaw.extensions exports ([6a3e545](https://github.com/RogueCtrl/ElectricSheep/commit/6a3e5454c4d102740dfaed38147a33229c3fd9b8))
+* replace registerCron with registerService for OpenClaw API compatibility ([f3b50c7](https://github.com/RogueCtrl/ElectricSheep/commit/f3b50c75763a3ba9d593e42c44434e2f96fa591b))
+* resolve @typescript-eslint/no-misused-promises in src/index.ts ([377a109](https://github.com/RogueCtrl/ElectricSheep/commit/377a109ec63266ea0a09562b7d00eaf3d9640858))
+
+
+### Documentation
+
+* add agent instructions for linting and formatting before commits ([f261654](https://github.com/RogueCtrl/ElectricSheep/commit/f26165409fed5cbd65a6faf870208a015b1b4e91))
+* rename project to OpenClawDreams in all documentation ([a260255](https://github.com/RogueCtrl/ElectricSheep/commit/a26025515fb22ef228e2c914175d75c6f149f7a8))
+
+### [0.3.1](https://github.com/RogueCtrl/ElectricSheep/compare/v0.3.0...v0.3.1) (2026-02-04)
+
+## 0.3.0 (2026-02-04)
+
+
+### Features
+
+* Add comprehensive test suite for core components and introduce API cost warnings to documentation. ([98d3130](https://github.com/RogueCtrl/ElectricSheep/commit/98d3130784e903f14f5016d5e1246f9697124015))
+* Add dream reflection pipeline, post filter, and documentation updates ([920d939](https://github.com/RogueCtrl/ElectricSheep/commit/920d9390314a56dd5e3ab3b908697096c36a3bc9))
+* Add new `setup-guide` skill and register it in `openclaw.plugin.json`. ([485670c](https://github.com/RogueCtrl/ElectricSheep/commit/485670c04745a69ddbcbf6e51714eee4a5b059f2))
+* add project governance, contribution guidelines, security policy, issue/PR templates, and CI build workflow. ([ddb3832](https://github.com/RogueCtrl/ElectricSheep/commit/ddb383238b9d29346c92b9f1e5316e9d222467f8))
+* Implement dynamic agent identity loading from workspace files and update memory system documentation. ([c5a2c2b](https://github.com/RogueCtrl/ElectricSheep/commit/c5a2c2bf77cecc49f037b16828d53adc8d370d3c))
+* Implement scheduled agent operations with `node-cron` and add retry logic to LLM API calls for increased robustness. ([12c6885](https://github.com/RogueCtrl/ElectricSheep/commit/12c6885b810ed6439faf6969d3f6cbcb2fca439f))
+* Introduce a daily token budget for LLM calls, update the LLM client interface to include token usage, and upgrade Node.js to v24 with updated dependencies. ([fcf4f2c](https://github.com/RogueCtrl/ElectricSheep/commit/fcf4f2c19dc7730c2c777d7b394083832f43a500))
+
+
+### Bug Fixes
+
+* Atomic state writes and SQLite connection singleton ([f5e1fe4](https://github.com/RogueCtrl/ElectricSheep/commit/f5e1fe439eda94e64f7707dcbf30a9cfcb36ea86))
+* clean up stale tags before running standard-version in release workflow ([fd87548](https://github.com/RogueCtrl/ElectricSheep/commit/fd8754897515bc5508f7fdae31ac714a3459a6f6))
+* Close logger before temp dir cleanup in state tests ([25478b3](https://github.com/RogueCtrl/ElectricSheep/commit/25478b3d2de4661ed4e7297fedcf45b0e400b169))
+* Fail-closed filter, title filtering, and robust LLM output parsing ([b5c0b10](https://github.com/RogueCtrl/ElectricSheep/commit/b5c0b10334b866eaa8ca4bcebaa58ea11ef4a664))
+* Mock file writes in state tests for CI reliability ([a6062ff](https://github.com/RogueCtrl/ElectricSheep/commit/a6062fffc335fcb1d078c135af61c4a8c9bb8585))
+* use release PR instead of direct push to protected main branch ([a7b3c5d](https://github.com/RogueCtrl/ElectricSheep/commit/a7b3c5d5acd77aac09a7c108406d2b6412d63443))
+
+
+### Documentation
+
+* Add uninstall section to setup guide skill ([e5b76d8](https://github.com/RogueCtrl/ElectricSheep/commit/e5b76d88ec9f15df1c7b1151d4c8a5cefa875c96))
+* Clarify that ElectricSheep does not modify OpenClaw's memory ([9a060e1](https://github.com/RogueCtrl/ElectricSheep/commit/9a060e1bd0655e825f6aea7572d1ac108170fce1))
+* clarify the daily token budget as best-effort and detail its limitations in both AGENTS.md and README.md. ([10eba97](https://github.com/RogueCtrl/ElectricSheep/commit/10eba97e87a334ca647b279d1fadc0b036a588b4))
+* reframe README intro as a reflection engine with optional Moltbook ([a2e8543](https://github.com/RogueCtrl/ElectricSheep/commit/a2e8543375d9555261c67087b7c1b519a3090af8))
+* Update CLAUDE.md for markdown blob pipeline and fail-closed filter ([c2f6865](https://github.com/RogueCtrl/ElectricSheep/commit/c2f68650e239fe205d14d59608bd286f8716f848))
+* Update documentation to prioritize OpenClaw extension installation and usage, and refine standalone CLI instructions. ([d26dbfc](https://github.com/RogueCtrl/ElectricSheep/commit/d26dbfc6e23e02d4e542f38e090d005ef83ee8e8))
+
+
+### Refactoring
+
+* Dream is a markdown blob, not a parsed structure ([52a86f0](https://github.com/RogueCtrl/ElectricSheep/commit/52a86f05054fc736d0be47fdbef9895f028fc15d))
+* Filter produces post-ready content with default rules ([5ff898f](https://github.com/RogueCtrl/ElectricSheep/commit/5ff898f8dc2329b1c0abe1860d797b867a005e2f))
+* Reimplement memory with encrypted SQLite, introduce LLM token budgeting, and update documentation and OpenClaw integration. ([b7887c3](https://github.com/RogueCtrl/ElectricSheep/commit/b7887c32ea6e80806bcd9a73031d8edfe137bbb5))
+* Remove standalone mode, improve security, add tests for waking/moltbook ([#6](https://github.com/RogueCtrl/ElectricSheep/issues/6)) ([d191dca](https://github.com/RogueCtrl/ElectricSheep/commit/d191dca8a29f55ee2c8c9ba00a58e461eaa4dbca))
+* rewrite ElectricSheep agent from Python to TypeScript and package as an OpenClaw plugin. ([c119a7a](https://github.com/RogueCtrl/ElectricSheep/commit/c119a7adfd995dcebb4c17a507e4b9e7da1c84e8))
+
+## 0.2.0 (2026-02-03)
+
+### Features
+
+* **reflection-engine**: Pivot from Moltbook-centric to operator-focused architecture
+* **synthesis**: New context synthesis combining operator conversations, web search, and optional Moltbook content
+* **notifications**: Operator notification system via configured channels (telegram, discord, slack, etc.)
+* **web-search**: Web search integration via OpenClaw API for broader context gathering
+* **openclaw-memory**: Store dreams and reflections in OpenClaw's persistent memory
+* **identity**: Dynamic agent identity loading from workspace SOUL.md/IDENTITY.md files
+* **dream-reflection**: Dream reflection pipeline for decomposing themes and synthesizing insights
+* **post-filter**: Content filter for outbound Moltbook posts (fail-closed design)
+* **setup-guide**: New skill for guided plugin configuration
+
+### Refactoring
+
+* **waking**: Reflection cycle now analyzes operator conversations instead of random Moltbook feed
+* **dreamer**: Dreams stored in OpenClaw memory, Moltbook posting now optional
+* **filter**: Filter produces post-ready content with configurable rules
+* **dream-format**: Dream is now a markdown blob, not a parsed structure
+
+### Bug Fixes
+
+* **filter**: Fail-closed filter behavior, title filtering, and robust LLM output parsing
+
+### Documentation
+
+* Updated README.md and CLAUDE.md for new operator-focused architecture
+* Added architecture diagrams showing daytime reflection and nighttime dream cycles
+* Documented all configuration options and their defaults
+
+## 0.1.0 (2026-01-15)
+
+Initial release with:
+
+* Dual memory system (working memory + encrypted deep memory)
+* Moltbook integration for community interaction
+* Dream cycle with AES-256-GCM encryption
+* OpenClaw plugin architecture (tools, hooks, cron jobs)
+* Daily token budget tracking
+* CLI utilities for status and memory inspection

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,41 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards other community members
+
+Examples of unacceptable behavior:
+
+- The use of sexualized language or imagery, and sexual attention or advances of any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information without explicit permission
+- Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the project maintainers via GitHub issues or by contacting the repository owner directly. All complaints will be reviewed and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/), version 2.1, available at https://www.contributor-covenant.org/version/2/1/code_of_conduct.html.

package/CONTRIBUTING.md

@@ -0,0 +1,95 @@
+# Contributing to ElectricSheep
+
+Thanks for your interest in contributing. This document covers the basics.
+
+## Getting Started
+
+```bash
+git clone https://github.com/RogueCtrl/ElectricSheep.git
+cd ElectricSheep
+npm install
+npm run build
+```
+
+You'll need Node.js >= 24.0.0 (Active LTS). To test the standalone CLI, install `@anthropic-ai/sdk` and create a `.env` from `.env.example`.
+
+## Development Workflow
+
+1. Fork the repo and create a branch from `main`.
+2. Make your changes in `src/`.
+3. Run `npm run build` to verify the project compiles cleanly.
+4. Run `npm test` to make sure all tests pass.
+5. Run `npm run lint` and `npm run format:check` to catch style issues.
+6. Open a pull request against `main`.
+
+CI will run build, lint, format check, and tests on your PR. All must pass before merging.
+
+## Testing
+
+Tests use Node's built-in test runner (`node:test`) with `tsx` for TypeScript:
+
+```bash
+npm test                                          # run all tests
+node --import tsx --test test/crypto.test.ts       # run a single file
+```
+
+Each test file creates an isolated temp directory via `ELECTRICSHEEP_DATA_DIR` so tests never touch real data. When adding new functionality, add tests in `test/` following the existing patterns.
+
+Good areas for more test coverage:
+- Moltbook client (mock HTTP responses)
+- Waking agent decision parsing
+- CLI command output
+
+## Code Style
+
+- **ESLint** and **Prettier** are configured. Run `npm run lint:fix` and `npm run format` to auto-fix.
+- TypeScript strict mode is enabled.
+- ESM modules (`import`/`export`, `.js` extensions in imports).
+- Unused variables are errors (prefix with `_` if intentionally unused).
+
+## Project Structure
+
+- `src/index.ts` — OpenClaw extension entry point
+- `src/cli.ts` — Standalone CLI
+- `src/scheduler.ts` — Long-lived process scheduler (node-cron)
+- `src/memory.ts`, `src/crypto.ts` — Dual memory system
+- `src/waking.ts`, `src/dreamer.ts` — Core agent logic
+- `src/moltbook.ts` — Moltbook API client
+- `src/persona.ts` — System prompts
+- `openclaw.plugin.json` — Plugin manifest
+- `test/` — Test suite
+
+See `CLAUDE.md` for a full architecture overview.
+
+## What to Work On
+
+Check the [issues](https://github.com/RogueCtrl/ElectricSheep/issues) for open tasks. Good first contributions:
+
+- Expanding test coverage (Moltbook client, CLI, waking logic)
+- Improving error handling in the Moltbook client
+- New memory categories or dream narrative styles
+- Documentation improvements
+
+## Commits
+
+- Write clear commit messages that describe *why*, not just *what*.
+- One logical change per commit.
+
+## Pull Requests
+
+- Keep PRs focused — one feature or fix per PR.
+- Include a description of what changed and why.
+- All CI checks (build, lint, format, tests) must pass before merging.
+- PRs require one approving review.
+
+## Reporting Bugs
+
+Open an issue with:
+- What you expected to happen
+- What actually happened
+- Steps to reproduce
+- Node.js version and OS
+
+## Questions
+
+Open a discussion or issue. There's no chat channel yet.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matt Cox
+
+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.