[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-80794":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":16,"stars30d":17,"stars90d":15,"forks30d":15,"starsTrendScore":14,"compositeScore":18,"rankGlobal":9,"rankLanguage":9,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":20,"hasPages":20,"topics":22,"createdAt":9,"pushedAt":9,"updatedAt":30,"readmeContent":31,"aiSummary":32,"trendingCount":15,"starSnapshotCount":15,"syncStatus":33,"lastSyncTime":34,"discoverSource":35},80794,"hermes-dreaming","asimons81\u002Fhermes-dreaming","asimons81","Staged self-improvement engine for Hermes-style memory, skill, and fact updates with explicit review and apply\u002Fdiscard gates.",null,"Python",64,5,38,1,0,24,26,2.33,"MIT License",false,"main",[23,24,25,26,27,28,29],"ai-agents","cli","mcp","memory","open-source","python","self-improvement","2026-06-12 02:04:06","# hermes-dreaming\n\n[![CI](https:\u002F\u002Fgithub.com\u002Fasimons81\u002Fhermes-dreaming\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fasimons81\u002Fhermes-dreaming\u002Factions\u002Fworkflows\u002Fci.yml)\n\n![Hermes Dreaming hero banner](assets\u002Freadme\u002Fhermes-dreaming-hero.png)\n\nA standalone, open-source staged self-improvement engine for Hermes-style memory, user, skill, and fact updates.\nIt scans explicit source inputs, stages proposed changes in a reviewable artifact directory, and only writes to live state after an explicit apply step.\n\n## Hermes plugin\n\nThis repo now ships as a proper Hermes plugin too.\n\nInstall from GitHub with:\n\n```bash\nhermes plugins install asimons81\u002Fhermes-dreaming --enable\n```\n\nFor a local checkout during development:\n\n```bash\nhermes plugins install file:\u002F\u002F\u002Fpath\u002Fto\u002Fhermes-dreaming --enable\n```\n\nOnce installed, use:\n\n```bash\nhermes dreaming review --help\n```\n\nUpdate the installed checkout with:\n\n```bash\nhermes dreaming update\n```\n\nUse `hermes dreaming update --check` if you only want the status check.\n\nThe plugin also bundles a Hermes skill named `dreaming`. Load that bare name inside Hermes if you want the guided staged workflow.\n\n## Onboarding docs\n\n- `docs\u002Fonboarding.md` is the shortest path from \"what is this\" to the full loop.\n- `docs\u002Finstall-update.md` covers plugin install and safe fast-forward updates.\n- `docs\u002Fquickstart.md` is the copy\u002Fpaste offline demo.\n- `docs\u002Fpersonas.md` shows how different operators use the same loop.\n- `docs\u002Fsafety.md` spells out what Dreaming can and cannot mutate.\n\n## Current status\n\n- **Full feature set:** create, review\u002Fopen, summarize, approve, reject, diff, validate, apply, discard, compact, report-card, install-cron, status, update, all implemented\n- **Live memory mutation** with score gating, idempotence, backups, and capacity enforcement\n- **Run ledger + DREAMS.md diary** for auditability\n- **Hermes-native plugin:** install once, use everywhere\n- **Recent-session reader** with fallback chain (SessionDB → SQLite → pointer-log)\n- **Cron installer** for nightly dry-run review\n- **Test suite passes locally**\n\n## Install\n\nFor end-user installs, use the plugin path in `docs\u002Finstall-update.md`. For local development:\n\n```bash\npython -m pip install -e .[dev]\n```\n\nIf you want the optional OpenAI-compatible provider:\n\n```bash\npython -m pip install -e .[llm]\n```\n\n## CLI\n\n```bash\n# Create an artifact from sources\n\ndreaming create --live-root .\u002Flive --artifact-root .\u002Fartifacts --source .\u002Fsources\n\n# Review: create and validate without applying\n\ndreaming review --live-root .\u002Flive --artifact-root .\u002Fartifacts --source .\u002Fsources\n\n# Open an existing artifact and print next steps\n\ndreaming review --open .\u002Fartifacts\u002F\u003Cartifact-id>\n\ndreaming summarize .\u002Fartifacts\u002F\u003Cartifact-id>\ndreaming approve .\u002Fartifacts\u002F\u003Cartifact-id> all\ndreaming reject .\u002Fartifacts\u002F\u003Cartifact-id> \u003Cproposal-id> --reason \"too broad\"\n\n# Inspect an artifact\n\ndreaming diff .\u002Fartifacts\u002F\u003Cartifact-id> --live-root .\u002Flive\n\n# Validate a staged artifact\n\ndreaming validate .\u002Fartifacts\u002F\u003Cartifact-id> --live-root .\u002Flive\n\n# Apply approved changes\n\ndreaming apply .\u002Fartifacts\u002F\u003Cartifact-id> --live-root .\u002Flive --backup-root .\u002Fbackups\n\n# Discard a staged artifact\n\ndreaming discard .\u002Fartifacts\u002F\u003Cartifact-id> --archive-root .\u002Farchive\n\n# Compact terminal (applied\u002Fdiscarded) artifacts to an archive\n\ndreaming compact --artifact-root .\u002Fartifacts --archive-root .\u002Farchive\n\n# Install a nightly review-only cron job\n\ndreaming install-cron --schedule \"0 3 * * *\"\n\n# Render a local operator digest\n\ndreaming digest .\u002Fartifacts\u002F\u003Cartifact-id> --weekly\n\n# Show artifact status\n\ndreaming status --artifact-root .\u002Fartifacts\n\n# Safely update the installed checkout\n\ndreaming update\ndreaming update --check\n```\n\n## Quickstart demo fixture\n\nIf you want the shortest path to \"oh, I get it,\" use `examples\u002Fquickstart\u002F`. It is an offline fixture, so no API key or external model access is required.\nIf the `dreaming` entrypoint is not installed yet, swap in `python -m hermes_dreaming` for the same commands.\n\n- Fixture notes: `examples\u002Fquickstart\u002FREADME.md`\n- Onboarding path: `docs\u002Fonboarding.md`\n- Install and update: `docs\u002Finstall-update.md`\n- Runnable walkthrough: `docs\u002Fquickstart.md`\n- Persona examples: `docs\u002Fpersonas.md`\n- Safety boundaries: `docs\u002Fsafety.md`\n\n### Command notes\n\n- `report-card` renders a redacted shareable summary from an existing artifact and can write a JSON companion with `--json`.\n- `digest` renders a local operator brief to stdout only. It can include `--weekly` rollups, but it does not send anything to Telegram. If you want delivery later, wrap the command in a separate transport layer that consumes stdout.\n- `create` and `review` accept repeatable `--source` plus optional `--provider`, `--model`, `--api-key`, and `--base-url`. `review --open` prints the artifact path and the next commands.\n- OpenAI-compatible and Ollama providers fail closed on malformed output, and each proposal must carry confidence, snippet, provenance, and approved fields before it can be written.\n- `summarize` prints a concise decision brief for an existing artifact.\n- `approve` and `reject` update artifact metadata only, they do not touch live roots.\n- `diff` accepts optional `--live-root` and renders unified diffs when the live target root is available.\n- `apply` applies already approved proposals. `--approve` still works as a compatibility shortcut for recording approvals before apply.\n- `update` supports `--remote`, `--branch`, `--check`, and `--no-verify`.\n\n## Dream markers\n\nThe offline provider looks for explicit `DREAM:` lines in the source bundle.\n\n```text\nDREAM: memory: Keep updates short and concrete.\nDREAM: user: Prefer concise status updates.\nDREAM: fact: {\"type\": \"preference\", \"key\": \"tone\", \"value\": \"casual\"}\nDREAM: skill: path=skills\u002Freview.md | Preserve review gates and backups.\n```\n\n## Artifact layout\n\nEach run writes a staged artifact directory containing:\n\n- `manifest.json`\n- `REPORT.md`\n- `sources.jsonl`\n- `proposals.jsonl`\n- `audit.jsonl`\n\nThe artifact is intentionally simple, deterministic, and easy to review on disk or in git.\n\n## Repo docs\n\n- `CONTRIBUTING.md` is the contributor guide and local workflow contract\n- `SECURITY.md` covers private vulnerability reporting\n- `CODE_OF_CONDUCT.md` sets the collaboration rules\n- `brief.md` has the project brief and non-goals\n- `specs\u002Fmvp-implementation-plan.md` describes the current implementation contract and package layout\n- `docs\u002Frelease-checklist.md` is the pre-release checklist\n- `reviews\u002Ffinal-sanity.md` records the most recent QA pass\n- `research\u002Fupstream-overlap.md` captures the upstream overlap notes and references\n\n## Contributing\n\nIf you want to contribute, start with `CONTRIBUTING.md`.\n\n- Use the issue templates so the scope and intent are clear.\n- Run `pytest -q`, `python -m build --wheel`, and `git diff --check` before requesting review.\n- If your change touches live roots, artifact roots, or writeback behavior, state that explicitly.\n- If you change release-facing text or safety rules, make sure the docs still match shipped behavior.\n\n## Development\n\n```bash\npytest -q\npython -m pip install build\npython -m build --wheel\n```\n\nThe repo is intentionally self-contained and safe for public release review.\n","hermes-dreaming 是一个用于Hermes风格记忆、技能和事实更新的阶段性自我改进引擎。它使用Python编写，支持从明确的源输入扫描、在可审查目录中分阶段提出更改，并仅在显式应用步骤后写入实时状态。项目具备完整的功能集，包括创建、审查、总结、批准、拒绝等操作，并具有实时内存突变控制、运行日志记录以及夜间自动审核安装等功能。适用于需要对AI代理的记忆和知识进行安全可控更新的场景，特别适合开发人员和研究人员在维护复杂系统时使用。",2,"2026-06-11 04:02:20","CREATED_QUERY"]