robot_lab-durable 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9bb9d48a0a10a6b049f34cb71625023be6373e403eae36b7964434443b9f74f2
+  data.tar.gz: b96330d170840c4e06b8ad349855e642bef12c4cb97b4a1b2d43fce0235df847
+SHA512:
+  metadata.gz: 36b8be5148c65454a058575065f92692466bf4a5a28f6fbc77e5fca39aa1ffce9dda7f368a15dc23a5a93e480b72ae40d9e5bf892419692c75bfee6dbb3a49fc
+  data.tar.gz: a162fdc17422a862537fb826ff0260fffb66de5143eb37da28362d06834bc4efa66b322a9b8984fe653690f87cd5c230806dc1441c67e3d5720f04a96d8eade2

data/.envrc

@@ -0,0 +1 @@
+export RR=`pwd`

data/.github/workflows/deploy-github-pages.yml

@@ -0,0 +1,52 @@
+name: Deploy Documentation to GitHub Pages
+on:
+  push:
+    branches:
+      - main
+      - develop
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - ".github/workflows/deploy-github-pages.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pages: write
+  id-token: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+
+      - name: Install dependencies
+        run: |
+          pip install mkdocs
+          pip install mkdocs-material
+          pip install mkdocs-macros-plugin
+          pip install mike
+
+      - name: Configure Git
+        run: |
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+
+      - name: Build MkDocs site
+        run: mkdocs build
+
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./site
+          keep_files: true

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2026-05-07
+
+- Initial release

data/LICENSE.txt

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

data/README.md

@@ -0,0 +1,83 @@
+# robot_lab-durable
+
+Cross-session durable learning for the [RobotLab](https://github.com/MadBomber/robot_lab) LLM agent framework.
+
+> [!CAUTION]
+> This gem is under active development. APIs may change without notice.
+
+## What it provides
+
+- **`Durable::Entry`** — immutable, confidence-tracked knowledge record
+- **`Durable::Store`** — YAML-backed, file-locked per-domain knowledge persistence in `~/.robot_lab/durable/`
+- **`Durable::Reflector`** — promotes session-level learnings into the durable store at end-of-run
+- **`Durable::Learning`** — mixin included into `RobotLab::Robot`; enabled via `learn: true, learn_domain:` constructor params
+- **`RecallKnowledge`** tool — lets robots query the durable store before making decisions
+- **`RecordKnowledge`** tool — lets robots write new knowledge during a session
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem "robot_lab"
+gem "robot_lab-durable"
+```
+
+## Quick Example
+
+```ruby
+require "robot_lab"
+require "robot_lab/durable"
+
+robot = RobotLab.build(
+  name: "advisor",
+  system_prompt: "You are a financial advisor that learns from each session.",
+  learn: true,
+  learn_domain: "finance"
+)
+
+# RecallKnowledge and RecordKnowledge tools are automatically available.
+# At the end of each run, the Reflector promotes learned facts to
+# ~/.robot_lab/durable/finance.yml for use in future sessions.
+result = robot.run("What do you know about my risk tolerance?")
+puts result.last_text_content
+```
+
+## How It Works
+
+When `learn: true` and `learn_domain:` are set, the robot gains two built-in tools:
+
+- **`RecallKnowledge`** — queries the domain's YAML store for relevant past knowledge before responding
+- **`RecordKnowledge`** — writes new knowledge entries during a session
+
+At the end of each run, `Durable::Reflector` promotes session-level learnings into the persistent store with confidence scoring and deduplication.
+
+## Knowledge Persistence
+
+```
+~/.robot_lab/durable/
+  finance.yml       # per-domain YAML store
+  support.yml
+  ...
+```
+
+Each entry records: `content`, `confidence`, `category`, `domain`, `use_count`, `created_at`, and `updated_at`.
+
+Knowledge confidence grows as the same fact is recalled and confirmed across sessions. Low-confidence entries are pruned automatically over time.
+
+## Relationship to `robot.learn()`
+
+`robot.learn()` is a core RobotLab method that accumulates observations within a single session in memory. `robot_lab-durable` extends this by persisting those observations to disk across sessions, making the robot's learning accumulate over its lifetime rather than resetting each run.
+
+## Links
+
+- [RobotLab Core](https://github.com/MadBomber/robot_lab)
+- [RubyGems](https://rubygems.org/gems/robot_lab-durable)
+
+## License
+
+MIT License - Copyright (c) 2025 Dewayne VanHoozer
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/MadBomber/robot_lab-durable.

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+task default: :test

data/docs/index.md

@@ -0,0 +1,62 @@
+# robot_lab-durable
+
+Cross-session durable learning for the [RobotLab](https://github.com/MadBomber/robot_lab) LLM agent framework.
+
+> [!CAUTION]
+> This gem is under active development. APIs may change without notice.
+
+## What it provides
+
+- **`Durable::Entry`** — immutable, confidence-tracked knowledge record
+- **`Durable::Store`** — YAML-backed, file-locked per-domain knowledge persistence in `~/.robot_lab/durable/`
+- **`Durable::Reflector`** — promotes session-level learnings into the durable store at end-of-run
+- **`Durable::Learning`** — mixin included into `RobotLab::Robot`; enabled via `learn: true, learn_domain:` constructor params
+- **`RecallKnowledge`** tool — lets robots query the durable store before making decisions
+- **`RecordKnowledge`** tool — lets robots write new knowledge during a session
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem "robot_lab"
+gem "robot_lab-durable"
+```
+
+## Quick Example
+
+```ruby
+require "robot_lab"
+require "robot_lab/durable"
+
+robot = RobotLab.build(
+  name: "advisor",
+  system_prompt: "You are a financial advisor that learns from each session.",
+  learn: true,
+  learn_domain: "finance"
+)
+
+# RecallKnowledge and RecordKnowledge tools are automatically available.
+# At the end of each run, the Reflector promotes learned facts to
+# ~/.robot_lab/durable/finance.yml for use in future sessions.
+result = robot.run("What do you know about my risk tolerance?")
+puts result.last_text_content
+```
+
+## Knowledge Persistence
+
+```
+~/.robot_lab/durable/
+  finance.yml       # per-domain YAML store
+  support.yml
+  ...
+```
+
+Each entry records `content`, `confidence`, `category`, `domain`, `use_count`, `created_at`, and `updated_at`.
+
+## Links
+
+- [Implementation Plan](superpowers/plans/2026-05-06-durable-learning.md)
+- [Design Spec](superpowers/specs/2026-05-06-durable-learning-design.md)
+- [RobotLab Core](https://github.com/MadBomber/robot_lab)
+- [RubyGems](https://rubygems.org/gems/robot_lab-durable)