rubik 0.4.2 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8907beb9d8441f6f497af9bd1b65a998c5dfa1d2857552943809ace7270e3759
-  data.tar.gz: a4b938aa55ff08037d63fc00d545a5039c06319c2ecee309e85d369d5d752621
+  metadata.gz: cd6a93a2277eebd80ce20dbf33ceba1ba7354d6540a6906740b4d58274736847
+  data.tar.gz: 2f46b92bbf23cbcea71767c433ffd45dd55b821e6bb8f1b18cb8c2e7310c5be0
 SHA512:
-  metadata.gz: a034a02d012190d0f6fe02c1b7977628d60617fb0bca562c3b4799dd6512e5cb77809540d57ebe4eede099a0c8e724a679579cc75f4db85f9a8e59bd535d59ea
-  data.tar.gz: bc8162afcace2ab99fca16b749a5291abeac662e2255f5d798277931a7295a447bdc981bb5d9bc897afa80a15db8fe836771536c3441c110208546442b280622
+  metadata.gz: 258d3631c684bfdd719a3b341197dd02da8fc64789c30645b8df0cd4814fc7546392c371737582adab36ff4d46052828fe8d0fed536a1efb592b2c5dcca34571
+  data.tar.gz: d9a517f0f4b7026d666d3ac0e2f880805ce40d2341613e5cc75ed72b5b37df3eabf60f07cee9cdf2d8a491b3758b0871edc43b62e501b423bde817b814b1edaf

data/ATTRIBUTION.md

@@ -121,7 +121,7 @@ SOFTWARE.
 | **`strings-ansi`** | Piotr Murach | MIT | ANSI-aware string truncation and alignment for REPL formatters. |
 | **`reline`** | Hiroshi SHIBATA & Ruby Team | Ruby License / BSD-2-Clause | Line-editing, history navigation, autocompletion hooks, and headless terminal adaptation. |
 | **`prism`** | Kevin Newton & Ruby Core Team | MIT | High-performance Ruby parsing and AST extraction ([`Rubik::AST::RubyExtractor`](lib/rubik/ast/ruby_extractor.rb)). |
-| **`minitest`** | Ryan Davis & seattlerb | MIT | Fast, modular test suite powering Rubik's 3,900+ unit, integration, and contract tests. |
+| **`minitest`** | Ryan Davis & seattlerb | MIT | Fast, modular test suite powering Rubik's 4,000+ unit, integration, and contract tests. |
 | **`rubocop`** | Bozhidar Batsov & contributors | MIT | Static code analysis, style enforcement, and architectural hygiene gates. |
 | **`benchmark`, `logger`, `pstore`, `reline`, `fiddle`** | Ruby core / rubygems teams | Ruby License / BSD-2-Clause | Ruby stdlib gems pinned explicitly in `rubik.gemspec` as they are unbundled from the default set in Ruby 3.4/3.5. |
 

data/CHANGELOG.md

@@ -6,6 +6,128 @@ commits, 2026-08-23 → 2026-10-09, see `git log`).
 
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.6.0] - 2026-11-02
+
+A measurement-and-honesty minor: the planned vakanüvis fixes gain their
+baseline with a tool-adoption bench scenario, goal suspensions finally
+reach the chronicle through a typed digest contract, interleaved-goal
+suspend rows stop mispairing their records, the annal dedupe can no
+longer be poisoned by free-text `event=` markers, and a typo'd
+truncation strategy warns instead of silently no-oping.
+
+### Added
+
+- **Goal suspension chronicling:** the chronicler now subscribes to
+  `:goal_suspended` (previously posted by `GoalState` but bus-orphaned —
+  the producer comment promised a consumption that never existed) and
+  appends a `goal.<n>.suspended` row to the session annal; the ordinal is
+  peeked rather than minted, so the eventual finish shares the same
+  `goal.<n>` record and no duplicate goal note is born from a suspension.
+- **vakanüvis tool-adoption bench scenario (#338, #354):** a two-plane
+  measurement of whether models actually adopt recall/record — a
+  deterministic replay (default, runs in `rake bench` and CI) driving the
+  real tool plane through adopter/wrong-path/struggler profiles, and an
+  opt-in live plane (`rake bench:vakanuvis_adoption MODELS=...`) looping
+  real provider completions with both tools available; per-model metrics
+  cover recall adoption, Keywords usage, record-via-vakanüvis vs direct
+  storage put, answer grounding and turn-cap hits, with honest Skip
+  (quota) vs Error rows and a fresh seeded store per driver.
+  `:goal_suspended` (previously posted by `GoalState` but bus-orphaned —
+  the producer comment promised a consumption that never existed) and
+  appends a `goal.<n>.suspended` row to the session annal; the ordinal is
+  peeked rather than minted, so the eventual finish shares the same
+  `goal.<n>` record and no duplicate goal note is born from a suspension.
+
+### Changed
+
+- **Digest contract typed:** the digest job is one `DistillGate::Job`
+  Struct (the queue's two Hash literals collapse into a keyword-minted
+  shape), the orphaned `:goal_id` read that no site ever set becomes a
+  live `goal_ordinal` carried from goal-end auto-digest — the distiller
+  brief now cites the goal record for goal-tied digests — and the digest
+  receipt text is single-homed in the DistillGate rules module
+  (`receipt` / `duplicate_receipt` / `full_receipt`) instead of three
+  templates across two files.
+- **Truncation strategy parity:** `tools.truncation_strategy` was honored
+  by exactly one of the Truncator call sites while the subagent tool
+  dispatch hard-coded `head_tail` under a comment claiming the two planes
+  cannot drift; both orchestrator planes now fetch the knob (fallback
+  `Truncator::DEFAULT_STRATEGY`), the restated 12_000/300 literals resolve
+  from `Truncator::DEFAULT_MAX_CHARS/LINES`, and a parity pin test turns
+  the prose invariant into a test invariant (classification, truncation
+  and the strategy knob are asserted equal across the two planes, oracle-
+  anchored against Truncator directly). The configuration docs now name
+  the honoring consumers.
+
+### Fixed
+
+- **Goal-identity suspend keys and honest logs (#350, #351):** suspend
+  rows key on goal identity (ledger id, else slug) plus steps and an
+  error digest instead of a peeked ordinal — interleaved goals no longer
+  mispair A's suspend row to B's finish and two suspensions sharing a
+  peek no longer dedupe into one row; `AnnalWriter.event_context` adds
+  status + goal so a dropped suspension and a dropped finish are
+  distinguishable in the logs; a `:duplicate` auto-digest admission warns
+  with the topic and unattached ordinal instead of silently succeeding;
+  the append dedupe anchors on line ends so free-text fields carrying
+  `(event=...)` cannot plant phantom keys that suppress genuine rows; the
+  chronicler worker gains a per-iteration last-ditch rescue with a
+  backtrace frame, the ledger id is stamped before `suspend!`, and a
+  spawn-disabled flush warns honestly instead of queueing in silence.
+- **Unrecognized truncation strategy values warn once (#349):** a typo'd
+  `tools.truncation_strategy` (or `context.emergency_truncate_strategy`)
+  previously fell into the `head_tail` else branch with no signal in
+  either plane; `Truncator::STRATEGIES` is now the honest frontier, all
+  three config-fetch sites resolve through it, and each distinct unknown
+  value warns exactly once per knob+value pair with a UTF-8-scrubbed
+  message that can never turn tool results into errors.
+
+## [0.5.0] - 2026-10-31
+
+A vakanüvis minor: the memory system gains a harness-owned auto-digest
+loop and a deterministic topics orientation injected at session start
+and after compaction, the prompt doctrine's recall/record contradiction
+is closed with a single storage write path, duck-typed AST cache stores
+stop breaking `save_to_cache`, and the security redactor's clean-text
+path skips its intermediate allocations.
+
+### Added
+
+- **Harness-owned auto-digest of touched topics (#346, #348):** topics
+  recorded or updated since the last digest are tracked in the Harness
+  and auto-digested at goal completion and queued (spawn-free) at
+  shutdown, gated by the `subagents.vakanuvis.auto_digest` knob
+  (default on); per-topic error isolation re-arms failed or refused
+  topics for the next flush instead of losing them, the drain window
+  between store write and touched-topic tracking is closed with one
+  monitor section, and shutdown always joins/kills the digest worker
+  with an honest dmesg listing parked topics.
+- **Deterministic topics orientation (#343):** session start and budget
+  compaction inject a compact, deterministic overview of the memory
+  topics so the model is oriented without a recall round-trip.
+
+### Fixed
+
+- **Keywords-in-query contradiction closed (#342):** the vakanüvis
+  teaching now separates the recall and record directions, stops
+  telling the model to add Keywords to recall queries, renders a single
+  write-path storage variant when vakanüvis is active, and folds the
+  doctrine down to two core duties with the duplicated
+  `goal_storage_rule` wording removed (SSOT).
+- **Duck-typed AST cache stores (#347):** `save_to_cache` probes
+  `store.method(:save).parameters` once and dispatches deterministically
+  instead of rescuing `ArgumentError` (which swallowed genuine errors
+  and double-fired side-effecting stores); 1-arity stores get the
+  snapshot without statuses plus a warn naming the store class, while
+  stores declaring the canonical kwarg signature keep the full-map
+  delivery — including in the clean-graph case.
+
+### Performance
+
+- **Redactor clean-text fast path (#337):** `Redactor.redact` no longer
+  allocates an intermediate scrub/dup string before testing
+  `QUICK_CHECK_REGEX` on valid-encoding clean input.
+
 ## [0.4.2] - 2026-10-29
 
 A reliability patch: plugin file loads become transactional with
@@ -961,7 +1083,9 @@ installation section.
 - Context: serialized index mutations, snapshot-outside-lock reconcile,
   streaming-first truncation.
 
-[Unreleased]: https://github.com/ozgurulukir/rubik/compare/v0.4.2...HEAD
+[Unreleased]: https://github.com/ozgurulukir/rubik/compare/v0.6.0...HEAD
+[0.6.0]: https://github.com/ozgurulukir/rubik/compare/v0.5.0...v0.6.0
+[0.5.0]: https://github.com/ozgurulukir/rubik/compare/v0.4.2...v0.5.0
 [0.4.2]: https://github.com/ozgurulukir/rubik/compare/v0.4.1...v0.4.2
 [0.4.1]: https://github.com/ozgurulukir/rubik/compare/v0.4.0...v0.4.1
 [0.1.0]: https://github.com/ozgurulukir/rubik/releases/tag/v0.1.0

data/lib/rubik/ast/cache_store.rb

@@ -110,6 +110,39 @@ module Rubik
         false
       end
 
+      # Dispatch a cache save across duck-typed stores. The canonical #save
+      # contract is (hash, statuses: {}) with a FULL statuses map (every
+      # snapshot file present, :ok or not), but gem consumers may hand the
+      # graph a narrower store. The signature is probed instead of rescuing
+      # ArgumentError around the call — a genuine ArgumentError raised inside
+      # a store's save must surface, and a failing save must never be
+      # silently retried single-arg (double side effects).
+      #
+      # Classification: a `statuses:` keyword (or **kwargs) means the kwarg
+      # call; otherwise the store is treated as 1-arity and non-ok statuses
+      # are dropped with a warn (such entries reload as :ok). When the
+      # signature cannot be read at all — save resolves through
+      # method_missing, or the object has no save — the canonical kwarg call
+      # is kept: the call itself surfaces any problem, exactly as the
+      # pre-probe code did. respond_to_missing?-backed proxies report
+      # [[:rest]] and are therefore treated as 1-arity: behavioral probing
+      # would risk double invocation.
+      def self.save_via(store, snapshot, statuses)
+        accepts_statuses = begin
+          store.method(:save).parameters.any? do |param|
+            kind, name = param
+            kind == :keyrest || ([:key, :keyreq].include?(kind) && name == :statuses)
+          end
+        rescue NameError
+          nil
+        end
+        return store.save(snapshot, statuses: statuses) if accepts_statuses != false
+
+        non_ok = statuses.count { |_, status| status != :ok }
+        Rubik::Log.warn(:ast, "#{store.class}#save cannot carry extraction statuses; #{non_ok} file(s) will reload as :ok") if non_ok.positive?
+        store.save(snapshot)
+      end
+
       def load
         load_with_statuses[0]
       end

data/lib/rubik/ast/graph.rb

@@ -139,7 +139,8 @@ module Rubik
         end
         skipped = "cache snapshot excluded #{skipped_failed} file(s) with failed extractions; they re-extract on next boot"
         Rubik::Log.warn(:ast, skipped) if skipped_failed.positive?
-        cache_store.save(snapshot, statuses: statuses)
+
+        CacheStore.save_via(cache_store, snapshot, statuses)
       end
 
       def smart_context_for(symbol_name)

data/lib/rubik/benchmark/runner.rb

@@ -3,6 +3,8 @@
 require "benchmark"
 require "tmpdir"
 
+require_relative "vakanuvis_adoption"
+
 module Rubik
   module Benchmark
     class MetricResult
@@ -38,9 +40,21 @@ module Rubik
         results << bench_grep_tool
         results << bench_cold_scan
         results << bench_search_ranking
+        results.concat(bench_vakanuvis_adoption)
         results
       end
 
+      # issue #338: araç-benimseme taban çizgisi. Ana süit YALNIZ deterministik
+      # replay düzlemini koşar (canlı model çağrısı asla default olamaz);
+      # canlı ölçüm rake bench:vakanuvis_adoption MODELS=... ile açık istektir.
+      def bench_vakanuvis_adoption
+        rows = Rubik::Benchmark::VakanuvisAdoption.run(
+          Rubik::Benchmark::VakanuvisAdoption::REPLAY_PROFILES.map { |p| Rubik::Benchmark::VakanuvisAdoption::ReplayDriver.new(p) },
+          io: nil
+        )
+        Rubik::Benchmark::VakanuvisAdoption.metric_results(rows, io: nil)
+      end
+
       def generate_markdown_report(results)
         lines = []
         lines << "| Metric | Target | Measured | Status |"