cc-transcript 14.40.1__tar.gz → 14.42.0__tar.gz

{cc_transcript-14.40.1 → cc_transcript-14.42.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cc-transcript
-Version: 14.40.1
+Version: 14.42.0
 Classifier: Development Status :: 3 - Alpha
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers

{cc_transcript-14.40.1 → cc_transcript-14.42.0}/cc_transcript/snapshot_schema/config.schema.json

@@ -129,6 +129,21 @@
       "title": "Max Source Bytes",
       "type": "integer"
     },
+    "prepared_fact_producer": {
+      "anyOf": [
+        {
+          "maxLength": 256,
+          "minLength": 1,
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "Exact identity of the build that produces prepared facts. Null keeps prepared facts private to this store and deletes them when it closes. A string lets this store adopt validated prepared facts left by earlier stores that named the same producer with the same max_source_bytes and max_entry_bytes, and leaves its own facts in place for the next one. Change it with every build whose fact extraction or in-memory fact layout could differ.",
+      "title": "Prepared Fact Producer"
+    },
     "reserved_hook_accounted_bytes": {
       "default": 536870912,
       "exclusiveMinimum": 0,

{cc_transcript-14.40.1 → cc_transcript-14.42.0}/cc_transcript/snapshot_schema/request.schema.json

@@ -1143,6 +1143,40 @@
       "title": "PreparedErrorPredicate",
       "type": "object"
     },
+    "PreparedGlobPredicate": {
+      "additionalProperties": false,
+      "properties": {
+        "kind": {
+          "enum": [
+            "has_edit_to",
+            "has_read_glob"
+          ],
+          "title": "Kind",
+          "type": "string"
+        },
+        "subagents": {
+          "const": true,
+          "title": "Subagents",
+          "type": "boolean"
+        },
+        "values": {
+          "items": {
+            "maxLength": 1048576,
+            "type": "string"
+          },
+          "maxItems": 256,
+          "title": "Values",
+          "type": "array"
+        }
+      },
+      "required": [
+        "kind",
+        "values",
+        "subagents"
+      ],
+      "title": "PreparedGlobPredicate",
+      "type": "object"
+    },
     "PreparedInputs": {
       "additionalProperties": false,
       "properties": {
@@ -1170,10 +1204,8 @@
         "kind": {
           "enum": [
             "has_command",
-            "has_edit_to",
             "has_skill",
-            "has_skill_suffix",
-            "has_read_glob"
+            "has_skill_suffix"
           ],
           "title": "Kind",
           "type": "string"
@@ -1239,14 +1271,40 @@
       "title": "PreparedOverridePredicate",
       "type": "object"
     },
+    "PreparedRegexPredicate": {
+      "additionalProperties": false,
+      "properties": {
+        "kind": {
+          "const": "has_command_regex",
+          "title": "Kind",
+          "type": "string"
+        },
+        "pattern": {
+          "maxLength": 1048576,
+          "title": "Pattern",
+          "type": "string"
+        },
+        "subagents": {
+          "const": true,
+          "title": "Subagents",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "kind",
+        "pattern",
+        "subagents"
+      ],
+      "title": "PreparedRegexPredicate",
+      "type": "object"
+    },
     "PreparedToolPredicate": {
       "additionalProperties": false,
       "properties": {
         "kind": {
           "enum": [
             "has_tool",
-            "has_read",
-            "has_command_regex"
+            "has_read"
           ],
           "title": "Kind",
           "type": "string"
@@ -1404,6 +1462,49 @@
         "limits": {
           "$ref": "#/$defs/Limits"
         },
+        "observers": {
+          "anyOf": [
+            {
+              "items": {
+                "discriminator": {
+                  "mapping": {
+                    "has_command": "#/$defs/PreparedListPredicate",
+                    "has_edit": "#/$defs/PreparedErrorPredicate",
+                    "has_error": "#/$defs/PreparedErrorPredicate",
+                    "has_override": "#/$defs/PreparedOverridePredicate",
+                    "has_read": "#/$defs/PreparedToolPredicate",
+                    "has_skill": "#/$defs/PreparedListPredicate",
+                    "has_skill_suffix": "#/$defs/PreparedListPredicate",
+                    "has_tool": "#/$defs/PreparedToolPredicate"
+                  },
+                  "propertyName": "kind"
+                },
+                "oneOf": [
+                  {
+                    "$ref": "#/$defs/PreparedToolPredicate"
+                  },
+                  {
+                    "$ref": "#/$defs/PreparedListPredicate"
+                  },
+                  {
+                    "$ref": "#/$defs/PreparedOverridePredicate"
+                  },
+                  {
+                    "$ref": "#/$defs/PreparedErrorPredicate"
+                  }
+                ]
+              },
+              "maxItems": 32,
+              "minItems": 1,
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Observers"
+        },
         "operation": {
           "const": "query_graph",
           "title": "Operation",
@@ -1414,13 +1515,13 @@
             "mapping": {
               "deep_predicate_inputs": "#/$defs/PreparedInputs",
               "has_command": "#/$defs/PreparedListPredicate",
-              "has_command_regex": "#/$defs/PreparedToolPredicate",
+              "has_command_regex": "#/$defs/PreparedRegexPredicate",
               "has_edit": "#/$defs/PreparedErrorPredicate",
-              "has_edit_to": "#/$defs/PreparedListPredicate",
+              "has_edit_to": "#/$defs/PreparedGlobPredicate",
               "has_error": "#/$defs/PreparedErrorPredicate",
               "has_override": "#/$defs/PreparedOverridePredicate",
               "has_read": "#/$defs/PreparedToolPredicate",
-              "has_read_glob": "#/$defs/PreparedListPredicate",
+              "has_read_glob": "#/$defs/PreparedGlobPredicate",
               "has_skill": "#/$defs/PreparedListPredicate",
               "has_skill_suffix": "#/$defs/PreparedListPredicate",
               "has_tool": "#/$defs/PreparedToolPredicate"
@@ -1434,9 +1535,15 @@
             {
               "$ref": "#/$defs/PreparedToolPredicate"
             },
+            {
+              "$ref": "#/$defs/PreparedRegexPredicate"
+            },
             {
               "$ref": "#/$defs/PreparedListPredicate"
             },
+            {
+              "$ref": "#/$defs/PreparedGlobPredicate"
+            },
             {
               "$ref": "#/$defs/PreparedOverridePredicate"
             },

{cc_transcript-14.40.1 → cc_transcript-14.42.0}/cc_transcript/snapshot_schema/response.schema.json

@@ -89,6 +89,7 @@
               "hydrated": "#/$defs/Hydrated",
               "loading": "#/$defs/Loading",
               "located": "#/$defs/Located",
+              "observed_scalar": "#/$defs/ObservedScalarResult",
               "prepared_graph": "#/$defs/PreparedGraphResult",
               "records": "#/$defs/RecordsResult",
               "released": "#/$defs/Released",
@@ -143,6 +144,9 @@
             {
               "$ref": "#/$defs/ScalarResult"
             },
+            {
+              "$ref": "#/$defs/ObservedScalarResult"
+            },
             {
               "$ref": "#/$defs/StringsResult"
             },
@@ -732,6 +736,7 @@
                   "hydrated": "#/$defs/Hydrated",
                   "loading": "#/$defs/Loading",
                   "located": "#/$defs/Located",
+                  "observed_scalar": "#/$defs/ObservedScalarResult",
                   "prepared_graph": "#/$defs/PreparedGraphResult",
                   "records": "#/$defs/RecordsResult",
                   "released": "#/$defs/Released",
@@ -786,6 +791,9 @@
                 {
                   "$ref": "#/$defs/ScalarResult"
                 },
+                {
+                  "$ref": "#/$defs/ObservedScalarResult"
+                },
                 {
                   "$ref": "#/$defs/StringsResult"
                 },
@@ -945,6 +953,43 @@
       "title": "Location",
       "type": "object"
     },
+    "ObservedScalarResult": {
+      "additionalProperties": false,
+      "properties": {
+        "kind": {
+          "const": "observed_scalar",
+          "title": "Kind",
+          "type": "string"
+        },
+        "observers": {
+          "items": {
+            "anyOf": [
+              {
+                "type": "boolean"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "maxItems": 32,
+          "minItems": 1,
+          "title": "Observers",
+          "type": "array"
+        },
+        "value": {
+          "title": "Value",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "kind",
+        "value",
+        "observers"
+      ],
+      "title": "ObservedScalarResult",
+      "type": "object"
+    },
     "PreparedGraphResult": {
       "additionalProperties": false,
       "properties": {

{cc_transcript-14.40.1 → cc_transcript-14.42.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cc-transcript"
-version = "14.40.1" # informational — releases stamp the version from the git tag
+version = "14.42.0" # informational — releases stamp the version from the git tag
 description = "Grep every Claude Code session you've ever run."
 readme = "README.md"
 license = "PolyForm-Noncommercial-1.0.0"

{cc_transcript-14.40.1 → cc_transcript-14.42.0}/rust/crates/core/src/snapshot.rs

@@ -1018,6 +1018,7 @@ struct PreparedQueryCursor {
     query: Value,
     pending: Option<PendingPreparedSource>,
     input_records: Option<VecDeque<String>>,
+    observers: Observers,
     next: usize,
     page_output_bytes: usize,
     remaining: WorkLimits,
@@ -1684,6 +1685,7 @@ impl Charge<String> for PreparedQueryCursor {
                 records.capacity() * size_of::<String>()
                     + records.iter().map(String::capacity).sum::<usize>()
             })
+            + self.observers.charge()
     }
 }
 
@@ -3127,18 +3129,30 @@ impl NativeStore {
                 );
             }
         }
-        if number(&Self::gauges(&mut state), "retained_total_accounted_bytes")? > config.retained {
+        let footprint = number(&Self::gauges(&mut state), "retained_total_accounted_bytes")?;
+        if footprint > config.retained {
             return Err(invalid("retained cap below startup footprint"));
         }
         #[cfg(test)]
         let audits = Arc::clone(&state.audits);
+        let prepared_disk = crate::snapshot_prepared_disk::PreparedDiskCache::new(
+            &owner_epoch,
+            get("max_prepared_disk_bytes", 2 * 1024 * 1024 * 1024),
+            &crate::snapshot_prepared_disk::FactOrigin {
+                producer: value.get("prepared_fact_producer").and_then(Value::as_str),
+                max_source_bytes: config.source,
+                max_entry_bytes: config.entry,
+            },
+            config
+                .retained
+                .saturating_sub(config.hook_bytes)
+                .saturating_sub(footprint),
+            work.clone(),
+        )?;
+        state.prepared_disk_index_bytes = prepared_disk.index_bytes();
         Ok(Self {
             config,
-            prepared_disk: crate::snapshot_prepared_disk::PreparedDiskCache::new(
-                &owner_epoch,
-                get("max_prepared_disk_bytes", 2 * 1024 * 1024 * 1024),
-                work.clone(),
-            )?,
+            prepared_disk,
             owner_epoch,
             default_registry,
             seed,
@@ -5062,6 +5076,13 @@ impl NativeStore {
             query,
             pending,
             input_records,
+            observers:
+                Observers {
+                    declared: _,
+                    allowance: _,
+                    witnessed: _,
+                    pending: observing,
+                },
             next: _,
             page_output_bytes: _,
             remaining: _,
@@ -5084,6 +5105,11 @@ impl NativeStore {
                 records.capacity() * size_of::<String>()
                     + records.iter().map(String::capacity).sum::<usize>()
             })
+            + observing.capacity() * size_of::<(usize, Value)>()
+            + observing
+                .iter()
+                .map(|(_, query)| value_bytes(query))
+                .sum::<usize>()
     }
 
     #[cfg(test)]
@@ -13157,6 +13183,66 @@ mod tests {
         assert!(after[1] > before[1]);
     }
 
+    #[test]
+    fn restarted_owner_reuses_prepared_facts_for_unchanged_sources() {
+        let namespace = std::fs::canonicalize(std::env::temp_dir())
+            .unwrap()
+            .join(format!(
+                "cc-transcript-prepared-reuse-{}-{}",
+                std::process::id(),
+                now_ms()
+            ));
+        crate::snapshot_prepared_disk::REUSE_NAMESPACE_OVERRIDE
+            .with(|path| *path.borrow_mut() = Some(namespace.clone()));
+        let tool = r#"{"type":"assistant","uuid":"tool","sessionId":"s","timestamp":"2026-01-02T03:04:06Z","message":{"model":"test","content":[{"type":"tool_use","id":"read","name":"Read","input":{"file_path":"/tmp/changed"}}]}}"#;
+        let source = Source::new(&format!("{}\n", user("root")));
+        let changed = source.directory.join("changed.jsonl");
+        let stable = source.directory.join("stable.jsonl");
+        std::fs::write(&changed, format!("{}\n", user("before"))).unwrap();
+        std::fs::write(&stable, format!("{}\n", user("stable"))).unwrap();
+        let config = json!({"prepared_fact_producer":"restart-test"});
+        let owner = context("a");
+        let serve = |store: &NativeStore| {
+            let root = finish(
+                store,
+                store.request(&acquire(&source.path), &owner, &Cancellation::default()),
+                &owner,
+            );
+            let template = acquire(&source.path);
+            let prepare = json!({"schema":SCHEMA,"id":"prepare","operation":"prepare_graph","view":{"handle":handle(&root),"classifier":{"id":"native","version":"1"},"selectors":[],"attachments":[]},"thread_ids":[],"roots":[],"direct_paths":[stable.to_string_lossy().as_ref(),changed.to_string_lossy().as_ref()],"deadline_unix_ms":template["deadline_unix_ms"],"limits":template["limits"]});
+            let graph = finish(
+                store,
+                store.request(&prepare, &owner, &Cancellation::default()),
+                &owner,
+            );
+            assert_eq!(graph["status"].as_str(), Some("ok"), "{graph:?}");
+            let answer = finish_prepared(
+                store,
+                store.request(&json!({"schema":SCHEMA,"id":"query","operation":"query_graph","handle":graph["data"]["handle"],"selectors":[],"query":{"kind":"has_tool","pattern":"Read","subagents":true},"deadline_unix_ms":template["deadline_unix_ms"],"limits":template["limits"]}), &owner, &Cancellation::default()),
+                &owner,
+            );
+            assert_eq!(answer["status"].as_str(), Some("ok"), "{answer:?}");
+            answer["data"]["value"].as_bool()
+        };
+        let first = NativeStore::new(&config).unwrap();
+        assert_eq!(serve(&first), Some(false));
+        let built = first.prepared_disk.stats().writes;
+        drop(first);
+        std::fs::write(&changed, format!("{}\n{tool}\n", user("after"))).unwrap();
+        let restarted = NativeStore::new(&config).unwrap();
+        assert_eq!(serve(&restarted), Some(true));
+        let rebuilt = restarted.prepared_disk.stats().writes;
+        assert!(
+            rebuilt >= 1 && rebuilt < built,
+            "the restarted owner wrote {rebuilt} facts where the first wrote {built}"
+        );
+        restarted.assert_conserved();
+        drop(restarted);
+        crate::snapshot_prepared_disk::REUSE_NAMESPACE_OVERRIDE
+            .with(|path| *path.borrow_mut() = None);
+        std::fs::remove_dir_all(namespace).unwrap();
+    }
+
     #[test]
     fn prepared_negative_rechecks_sidechain_membership() {
         let source = Source::new(&format!("{}\n", user("root")));