@alan512/experienceengine 0.1.2 → 0.2.0

package/docs/releases/v0.1.3.md

@@ -0,0 +1,95 @@
+# ExperienceEngine v0.1.3
+
+Release date: 2026-03-29
+
+## Summary
+
+`v0.1.3` tightens the product surface around three things:
+
+- a more complete host-native daily workflow for `OpenClaw`
+- a cleaner onboarding and inspection experience across hosts
+- a smaller Codex MCP schema surface with less duplicated public schema
+
+This release is mainly about productization and day-to-day usability, not a new learning core.
+
+## Included In This Release
+
+### OpenClaw Daily Interaction Loop
+
+`OpenClaw` now has a complete daily host-native routine interaction track for common ExperienceEngine questions.
+
+Users can now ask in-session about:
+
+- what ExperienceEngine just injected
+- why a hint matched
+- whether the last intervention helped or harmed
+- whether ExperienceEngine is ready in the current repo
+- whether the repo is still warming up
+- why ExperienceEngine stayed quiet on the latest turn
+- a compact repo-level ExperienceEngine summary
+
+This completes the intended daily host-native interaction loop for `OpenClaw`, while keeping deeper diagnostics and operator workflows in CLI.
+
+### Onboarding And First-Value Guidance
+
+The onboarding model is now clearer and more product-facing:
+
+- `Setup state`
+  - `Installed`
+  - `Initialized`
+  - `Ready`
+- `Value state`
+  - `Warming up`
+  - `First value reached`
+
+This release aligns those states across:
+
+- `ee install`
+- `ee init`
+- `ee status`
+- `ee doctor`
+- `README`
+- `User Guide`
+
+It also makes first value stricter: generic warm-up text does not count as value unless a real task produced visible ExperienceEngine output.
+
+### Better Explanation Surfaces
+
+ExperienceEngine now explains its behavior more clearly in the places users actually look:
+
+- `inspect --last`
+- node and repo inspection summaries
+- `status`
+- `doctor`
+- Codex MCP summary payloads
+
+The default path now favors short product-facing explanations, while deeper inspection still retains the more exact system details where needed.
+
+### Codex MCP Schema Slimming
+
+This release trims duplicated public MCP schema in the Codex adapter without changing the current agent-first workflow:
+
+- merged duplicate feedback, scope-state, and node-lifecycle tools
+- removed public MCP prompts after brokering the remaining high-impact workflows
+- kept repo summary as a resource-only read surface
+- kept routine read surfaces public while shifting long-tail admin, maintenance, and advanced inspect paths behind broker tools
+
+The result is a smaller public schema footprint with no change to the routine host-first review flow.
+
+### Marketplace-Facing Metadata
+
+This release also improves public discovery packaging:
+
+- npm package description is now product-facing instead of internal MVP wording
+- README now explicitly calls out:
+  - OpenClaw compatibility expectations
+  - Node.js `>=20`
+  - a minimal shared `ee init` example
+
+These changes are aimed at making the GitHub + npm landing page easier to understand before official directory approval lands.
+
+## Notes
+
+- The OpenClaw community-plugin PR can still be merged independently of this release.
+- `OpenClaw` daily host-native interaction is now considered complete for the current product boundary.
+- CLI remains the explicit operator path for deep inspection, repair, lifecycle control, backup, rollback, and other advanced workflows.

package/docs/releases/v0.2.0.md

@@ -0,0 +1,85 @@
+# ExperienceEngine v0.2.0
+
+Release date: 2026-04-13
+
+## Summary
+
+`v0.2.0` is the first release that makes ExperienceEngine explicitly production-first.
+
+This release changes the product center of gravity in three ways:
+
+- live hint delivery is now governed more conservatively, with delivery-state gating and stronger harmful-hint containment
+- posttask feedback is no longer biased toward `success => helped`, and the system now supports structured per-node postmortem writeback
+- Codex lifecycle ownership is now deterministic through a wrapper and validation harness, instead of depending on nested host behavior alone
+
+This is a product-behavior release, not just a packaging or UX pass. That is why it moves to `v0.2.0`.
+
+## Included In This Release
+
+### Production-First Hint Governance
+
+ExperienceEngine now separates lifecycle maturity from live delivery safety more clearly.
+
+Key changes:
+
+- delivery-state governance now controls whether a node is:
+  - shadow-only
+  - conservative-only
+  - eligible
+  - quarantined
+- harmful nodes are removed from normal live delivery earlier
+- `priority_candidate` remains available for cautious first exposure, while ordinary `candidate` paths stay more conservative
+
+The result is that bad guidance is withdrawn faster, instead of being allowed to keep competing in the normal live path.
+
+### Posttask Per-Node Governance Writeback
+
+This release also upgrades the posttask review loop:
+
+- automatic feedback no longer treats successful completion as enough evidence to mark a hint as helped
+- posttask review now supports per-node `helped / harmed / uncertain` adjudication
+- runtime writeback is policy-gated, so model output does not directly mutate lifecycle without bounded checks
+
+This makes the experience library more trustworthy over time, especially for tasks where a hint may have been present but not actually helpful.
+
+### Selective Sync Second Opinion
+
+ExperienceEngine now supports a bounded synchronous LLM second-opinion layer for high-risk live hint decisions.
+
+It is intentionally selective, not always-on.
+
+This release includes:
+
+- the second-opinion gate itself
+- CLI observability for second-opinion activity in:
+  - `ee status`
+  - `ee doctor`
+  - `ee inspect --last --verbose`
+- a tighter trigger policy so second-opinion calls happen less often on low-value edge cases
+- explicit OpenAI-style token budgeting to reduce avoidable provider-side failures
+
+### Deterministic Codex Lifecycle Ownership
+
+Codex now has a deterministic wrapper path instead of relying only on nested model behavior to complete the ExperienceEngine lifecycle.
+
+Included:
+
+- `ee codex exec` wrapper for external lifecycle ownership
+- support for stdin prompt input and explicit EE session ids
+- a deterministic `codex-lifecycle` validation harness
+
+This makes Codex validation and operator workflows much less dependent on host randomness, quota windows, or nested tool-calling behavior.
+
+### OpenClaw Packaging And Runtime Reliability
+
+This release also folds in the OpenClaw stability fixes completed after `v0.1.3`:
+
+- safer packaged install behavior
+- cleaner runtime payload boundaries
+- more explicit learning-loop defaults and diagnostics
+
+## Notes
+
+- `v0.2.0` is still a local-first, single-machine product. It does not yet change the underlying SQLite architecture into a multi-session distributed design.
+- real-host second-opinion acceptance with free-provider routing still depends on third-party provider availability and quota conditions
+- the Codex wrapper path is now the recommended deterministic operator path for real release validation