claw-ctx v6.8.0

Release Highlights

• Role-Aware Injection (ADR: role-aware-injection): five-role context package semantics (Authority > Exemplar > Constraint > Rubric > Metadata) from arXiv 2604.04258v1 applied to the injection pipeline.
• Priority-based assembly: injection segments now carry role + priority; assembly orders by priority (Authority first) and records same-topic conflicts instead of joining by injection order - low-priority signals (RL experience, CI signals) can no longer override high-priority governance constraints.
• Conservative conflict handling: both segments retained, conflict logged; nothing dropped.
• Backward compatible: roleAwareInjection: false restores the v6.7.3 join order; ContextQualityEvaluator.evaluate gains an optional rubricBlocks? (behavior unchanged when omitted).

What's Changed

Added

• src/context-role.ts: RoleHint, source-to-role classification, sortRoleHints, detectRoleConflicts, roleBreakdown, resolveRoleAssembly.
• Engine injectors emit RoleHint[]; _assembleRoleAware at the assembly layer (after cache lookups); ctx_build returns roleConflicts / roleBreakdown (observational, non-breaking). _rlGovernanceCache / _crossDomainCache keys untouched; hot-cache string entries wrapped as metadata (content never dropped).
• Config: roleAwareInjection (default true) and roleOverrides.

Tests

• 1168 -> 1195 (+23): context-role.test.ts (17) + role-aware-injection.test.ts (6); benchmarks 22/22 PASS; dependency audit 0 vulnerabilities (openclaw 2026.8.1, CI matrix Node 22/24).

Reference

• Paper review: docs/research/papers/2026-08-31-Context-Engineering.md (arXiv 2604.04258v1).

Full Changelog: v6.7.3...v6.8.0

claw-ctx v6.7.3

claw-ctx v6.7.3 — P3 registry tarball fix (root plugin manifest)

Release Highlights:

• Fixes the npm tarball missing the root openclaw.plugin.json (P3 GA gate): files whitelist now includes the root manifest.
• No functional or tool-surface changes.

Tools (3): ctx_compact, ctx_build, ctx_inject (unchanged).

Quality: npm run build clean (dist fresh); tarball audit confirms root openclaw.plugin.json + dist/index.js shipped; OpenClaw loads plugin as loaded v6.7.3.

claw-ctx v6.7.2

claw-ctx v6.7.2 — corrective release (version fact source sync)

Release Highlights:

• Corrective patch that aligns the runtime version fact source (src/version.ts) with package.json / plugin manifest (6.7.1 → 6.7.2).
• Fixes the drift where the published 6.7.1 artifact self-reported v6.7.0 at plugin registration time.
• No functional or tool-surface changes; plugin registration now reports the shipped version.

Changes:

• Sync src/version.ts (via scripts/gen-version.mjs), openclaw.plugin.json, package.json, and package-lock.json to 6.7.2.
• Update version assertions in tests/unit/tools/version-bump.test.ts and tests/unit/tools/plugin-contract.test.ts.

Tools (3): ctx_compact, ctx_build, ctx_inject (unchanged).

Quality: npm run build clean; full test suite 1172 passed / 5 skipped; OpenClaw loads plugin as loaded v6.7.2.

claw-ctx v6.7.1

claw-ctx v6.7.1 — definePluginEntry migration release

Ship the context-engine plugin on the unified definePluginEntry + shared plugin-entry SDK.

Changes:

• Migrate claw-ctx plugin registration to the modern definePluginEntry interface (shared plugin-entry SDK).
• Sync plugin manifest / package.json / package-lock version alignment to 6.7.1.

Tools (3): ctx_compact, ctx_build, ctx_inject (unchanged).

Quality: npm run build clean; full test suite 1172 passed / 5 skipped; OpenClaw loads plugin as loaded v6.7.1.

claw-ctx v6.7.0

Release Highlights

• pi agent adapter (pi_plugin/): tools wrapped as pi AgentTool definitions (TypeBox schema), with package.json exports ./pi and tsconfig.pi.json isolating pi type checking.
• Peer dependency @earendil-works/pi-agent-core >= 0.84.2; dev dependency @sinclair/typebox.

What's Changed

Added

• pi agent adapter (pi_plugin/): tools wrapped as pi AgentTool definitions (TypeBox schema), package.json exports ./pi, tsconfig.pi.json isolates type checking.
• Dependencies: peer @earendil-works/pi-agent-core >= 0.84.2, dev @sinclair/typebox.

Full Changelog: v6.6.0...v6.7.0

claw-ctx v6.6.1: fix release-lag assertions + js-yaml security

v6.6.1 (2026-08-15)

Fixed

• Version assertion drift: 2 tests (version-bump / plugin-contract) expected 6.5.1 but actual was 6.6.0 — v6.6.0 released with these failing; assertions synced to 6.6.0 in 0673ea2
• js-yaml security upgrade: devDependency bumped 4.3.0 → 4.3.1 (PR #7, dependabot npm_and_yarn group)

Changed

• Version: 6.6.0 → 6.6.1

Tests

• 92 files / 1172 tests / 5 skipped / 0 failed (assertion-sync verification)

claw-ctx v6.6.0: Context Efficiency Metrics

v6.6.0 (2026-08-14)

Added

• Context Efficiency Metrics (src/efficiency/): measure compaction effectiveness and context budget utilization, the observational foundation for future adaptive thresholds
  • ContextEfficiencyMetrics — records utilization (currentTokens / effectiveBudget), waste (compactionDeltaRate + triggerGap), and cache-hit-rate correlation
  • EfficiencyReport — per-session (getSessionReport) and cross-session (getAggregateReport) aggregation
  • Integrated into ProactiveCompactionController via injectable metrics (pure observation, zero decision impact)

Changed

• Version: 6.5.1 → 6.6.0

Tests

• 92 files / 1172 tests / 5 skipped / 0 failed (Edith independent QC APPROVED; integration semantics zero-change 10/10)

claw-ctx v6.5.1: Fix tool registration (ctx_compact/ctx_build/ctx_inject)

v6.5.1 (2026-08-14)

Fixed

• Tool registration missing: ctx_compact / ctx_build / ctx_inject were declared in contracts.tools but never registered at runtime (the registration code lived only in an unreferenced orphan file openclaw_plugin/index.ts). Registered the three tools in src/index.ts's plugin.register(api) via api.registerTool, aligned with the real ContextCapability API.
• Update 2 version assertions (6.4.0 → 6.5.0) that were not synced at v6.5.0 release.

Changed

• Version: 6.5.0 → 6.5.1
• openclaw_plugin/index.ts marked @deprecated (kept as audit trail; not build output, incorrect registration pattern).

claw-ctx v6.5.0: MECW-Aware Compaction

v6.5.0 — 2026-08-14

Added

• MECW-Aware Compaction: compression threshold from static ratio → dynamic computation based on Maximum Effective Context Window (MECW)
• New MecwEstimator (src/mecw/) + configurable complexityFactor table (SIMPLE 1.0 / MULTI 0.8 / SUMMARIZATION 0.7 / COMPLEX_REASONING 0.6)
• ProactiveCompactionController.shouldCompact optional taskType param (backward compatible fallback to static compressionThreshold)
• detectTaskType wired into full pipeline
• Complex tasks MECW < simple tasks (core dynamic threshold semantics)

Tests

• 85 files / 1143 tests / 5 skipped / 0 failed (independent QC APPROVED)

claw-ctx v6.4.0: Tool Registration

Release Highlights

• Tool registration: ctx_compact, ctx_build, ctx_inject registered as OpenClaw tools with contracts.tools declared in openclaw.plugin.json.
• ContextCapability.inject: directed context injection added (replace degrades to append).

What's Changed

Added

• Tool registration: ctx_compact / ctx_build / ctx_inject OpenClaw tools.
• ContextCapability.inject: directed context injection (replace degrades to append).
• contracts.tools in openclaw.plugin.json.

Changed

• Version: 6.3.0 -> 6.4.0.

Full Changelog: v6.0.0...v6.4.0