cc-transcript 9.1.0__tar.gz → 10.1.0__tar.gz

{cc_transcript-9.1.0 → cc_transcript-10.1.0}/Cargo.lock

@@ -42,6 +42,12 @@ version = "0.22.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "72b3254f16251a8381aa12e40e3c4d2f0199f8c6508fbecb9d91f575e0fbb8c6"
 
+[[package]]
+name = "bitflags"
+version = "2.13.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b4388bee8683e3d04af747c73422af53102d2bd24d9eadb6cbc100baef4b43f8"
+
 [[package]]
 name = "bumpalo"
 version = "3.20.3"
@@ -66,7 +72,7 @@ dependencies = [
 
 [[package]]
 name = "cc_transcript_parser"
-version = "0.8.0"
+version = "0.9.0"
 dependencies = [
  "chrono",
  "crossbeam-channel",
@@ -75,15 +81,24 @@ dependencies = [
  "num_cpus",
  "once_cell",
  "pyo3",
+ "pyo3-build-config",
  "rayon",
  "regex",
- "serde",
  "sonic-rs",
  "tree-sitter",
  "tree-sitter-bash",
  "udpipe-rs",
 ]
 
+[[package]]
+name = "cc_transcript_swift"
+version = "0.9.0"
+dependencies = [
+ "cc_transcript_parser",
+ "swift-bridge",
+ "swift-bridge-build",
+]
+
 [[package]]
 name = "cfg-if"
 version = "1.0.4"
@@ -175,6 +190,22 @@ version = "1.0.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "877a4ace8713b0bcf2a4e7eec82529c029f1d0619886d18145fea96c3ffe5c0f"
 
+[[package]]
+name = "errno"
+version = "0.3.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "39cab71617ae0d63f51a36d69f866391735b51691dbda63cf6f96d042b63efeb"
+dependencies = [
+ "libc",
+ "windows-sys 0.52.0",
+]
+
+[[package]]
+name = "fastrand"
+version = "2.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f1f227452a390804cdb637b74a86990f2a7d7ba4b7d5693aac9b4dd6defd8d6"
+
 [[package]]
 name = "faststr"
 version = "0.2.34"
@@ -327,6 +358,12 @@ dependencies = [
  "libc",
 ]
 
+[[package]]
+name = "linux-raw-sys"
+version = "0.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "32a66949e030da00e8c7d4434b251670a91556f4144941d37452769c25d58a53"
+
 [[package]]
 name = "log"
 version = "0.4.32"
@@ -366,7 +403,7 @@ checksum = "4568f25ccbd45ab5d5603dc34318c1ec56b117531781260002151b8530a9f931"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn",
+ "syn 2.0.117",
 ]
 
 [[package]]
@@ -444,7 +481,7 @@ checksum = "7347867d0a7e1208d93b46767be83e2b8f978c3dad35f775ac8d8847551d6fe1"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn",
+ "syn 2.0.117",
 ]
 
 [[package]]
@@ -490,7 +527,7 @@ dependencies = [
  "proc-macro2",
  "pyo3-macros-backend",
  "quote",
- "syn",
+ "syn 2.0.117",
 ]
 
 [[package]]
@@ -503,7 +540,7 @@ dependencies = [
  "proc-macro2",
  "pyo3-build-config",
  "quote",
- "syn",
+ "syn 2.0.117",
 ]
 
 [[package]]
@@ -578,7 +615,7 @@ checksum = "b7186006dcb21920990093f30e3dea63b7d6e977bf1256be20c3563a5db070da"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn",
+ "syn 2.0.117",
 ]
 
 [[package]]
@@ -656,7 +693,20 @@ checksum = "5d2ed0b54125315fb36bd021e82d314d1c126548f871634b483f46b31d13cac6"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn",
+ "syn 2.0.117",
+]
+
+[[package]]
+name = "rustix"
+version = "1.1.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b6fe4565b9518b83ef4f91bb47ce29620ca828bd32cb7e408f0062e9930ba190"
+dependencies = [
+ "bitflags",
+ "errno",
+ "libc",
+ "linux-raw-sys",
+ "windows-sys 0.52.0",
 ]
 
 [[package]]
@@ -727,7 +777,7 @@ checksum = "d540f220d3187173da220f885ab66608367b6574e925011a9353e4badda91d79"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn",
+ "syn 2.0.117",
 ]
 
 [[package]]
@@ -819,6 +869,62 @@ version = "2.6.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "13c2bddecc57b384dee18652358fb23172facb8a2c51ccc10d74c157bdea3292"
 
+[[package]]
+name = "swift-bridge"
+version = "0.1.59"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "384ed39ea10f1cefabb197b7d8e67f0034b15a94ccbb1038b8e020da59bfb0be"
+dependencies = [
+ "swift-bridge-build",
+ "swift-bridge-macro",
+]
+
+[[package]]
+name = "swift-bridge-build"
+version = "0.1.59"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "71b36df21e7f8a8b5eeb718d2e71f9cfc308477bfb705981cca705de9767dcb7"
+dependencies = [
+ "proc-macro2",
+ "swift-bridge-ir",
+ "syn 1.0.109",
+ "tempfile",
+]
+
+[[package]]
+name = "swift-bridge-ir"
+version = "0.1.59"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c73bd16155df50708b92306945656e57d62d321290a7db490f299f709fb31c83"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 1.0.109",
+]
+
+[[package]]
+name = "swift-bridge-macro"
+version = "0.1.59"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a1a13dc0dc875d85341dec5b5344a7d713f20eb5650b71086b27d09a6ece272f"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "swift-bridge-ir",
+ "syn 1.0.109",
+]
+
+[[package]]
+name = "syn"
+version = "1.0.109"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "72b64191b275b66ffe2469e8af2c1cfe3bafa67b529ead792a6d0160888b4237"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
 [[package]]
 name = "syn"
 version = "2.0.117"
@@ -836,6 +942,19 @@ version = "0.13.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "adb6935a6f5c20170eeceb1a3835a49e12e19d792f6dd344ccc76a985ca5a6ca"
 
+[[package]]
+name = "tempfile"
+version = "3.27.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "32497e9a4c7b38532efcdebeef879707aa9f794296a4f0244f6f69e9bc8574bd"
+dependencies = [
+ "fastrand",
+ "getrandom 0.3.4",
+ "once_cell",
+ "rustix",
+ "windows-sys 0.52.0",
+]
+
 [[package]]
 name = "thiserror"
 version = "1.0.69"
@@ -862,7 +981,7 @@ checksum = "4fee6c4efc90059e10f81e6d42c60a18f76588c3d74cb83a0b242a2b6c7504c1"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn",
+ "syn 2.0.117",
 ]
 
 [[package]]
@@ -873,7 +992,7 @@ checksum = "ebc4ee7f67670e9b64d05fa4253e753e016c6c95ff35b89b7941d6b856dec1d5"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn",
+ "syn 2.0.117",
 ]
 
 [[package]]
@@ -1041,7 +1160,7 @@ dependencies = [
  "bumpalo",
  "proc-macro2",
  "quote",
- "syn",
+ "syn 2.0.117",
  "wasm-bindgen-shared",
 ]
 
@@ -1225,7 +1344,7 @@ checksum = "0b631b19d36a892ab55420c92dbc83ccd79274f25be714855d3074aa71cab639"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn",
+ "syn 2.0.117",
 ]
 
 [[package]]

{cc_transcript-9.1.0 → cc_transcript-10.1.0}/PKG-INFO

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

{cc_transcript-9.1.0 → cc_transcript-10.1.0}/cc_transcript/_parser_rs.pyi

@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from typing import Any
+
 from cc_transcript.models import PrintResult, TranscriptEvent
 
 class ParseStream:
@@ -41,3 +43,15 @@ def score_post_process(spec_json: str, buckets: list[list[str]], raw: list[int],
 
 def command_prefixes(commands: list[str], /) -> list[list[str]]:
     """Permission-style prefixes per command line, parsed in parallel off the GIL."""
+
+def mine_signals(raw: bytes, spec_json: str, /) -> list[dict[str, Any]]:
+    """Parses raw transcript bytes and mines signal dicts per the portable mining spec."""
+
+def session_activity_probe(
+    path: str, waiting_tools: list[str] | None = ..., human_facing_tools: list[str] | None = ..., /
+) -> dict[str, Any]:
+    """Parses the transcript at ``path`` and returns the session-activity verdict dict.
+
+    The dict carries ``is_waiting: bool``, ``mid_tool: bool``, ``last_event_epoch: int | None``,
+    and ``pending: list[dict]`` with ``tool_use_id``/``name``/``kind`` per contributing call.
+    """

cc_transcript-10.1.0/cc_transcript/activity_probe.py

@@ -0,0 +1,223 @@
+"""Dual-backend session-activity probe — captain-hook's ``is_waiting`` oracle over one transcript.
+
+:func:`rust_probe_backend` resolves the Rust extension when built, else None to fall back
+to the Python reference. :func:`session_activity_probe` is the public dual-backend entry:
+it reads a ``.jsonl`` transcript, runs the oracle over its parsed events, and returns a
+:class:`SessionActivityProbe`; :func:`probe_events` is the Python reference the Rust probe
+stays identical to. The verdict spans undelivered task notifications (the
+:class:`~cc_transcript.notifications.Notifications` queue replay), ephemeral waits
+(waiting tools, backgrounded Agent/Task/Bash, subagentless Agent/Task) over the current
+turn, and pending async launches (async Agent/Task, live Workflow) session-wide — a
+launch counts as completed only once its notification was delivered or drained, never
+when merely enqueued — and flags unanswered non-human-facing tool calls in the current
+turn as mid-tool. Compact-summary user lines do not open turns, deliberately leading
+captain-hook, which still lets compaction close the turn.
+"""
+
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+from typing import TYPE_CHECKING, Literal
+
+from cc_transcript.activity import native_user_classifier
+from cc_transcript.models import (
+    AssistantEvent,
+    SystemEvent,
+    ToolResultBlock,
+    ToolUseBlock,
+    UserEvent,
+)
+from cc_transcript.notifications import Notifications
+from cc_transcript.parser import parse_events_from_bytes
+
+if TYPE_CHECKING:
+    from collections.abc import Sequence
+    from pathlib import Path
+    from types import ModuleType
+
+    from cc_transcript.models import TranscriptEvent
+
+DEFAULT_WAITING_TOOLS = frozenset({"Monitor", "ScheduleWakeup", "SendMessage", "TeamCreate"})
+DEFAULT_HUMAN_FACING_TOOLS = frozenset({"AskUserQuestion", "ExitPlanMode"})
+
+PendingKind = Literal[
+    "waiting_tool",
+    "background",
+    "subagentless_task",
+    "pending_async_task",
+    "pending_async_workflow",
+    "mid_tool",
+]
+"""How a tool call contributes to the session-activity verdict."""
+
+
+@dataclass(frozen=True, slots=True)
+class PendingItem:
+    """One tool call contributing to the session-activity verdict.
+
+    Attributes:
+        tool_use_id: The contributing call's tool-use id.
+        name: The tool's name exactly as invoked.
+        kind: How the call contributes to the verdict.
+    """
+
+    tool_use_id: str | None
+    name: str
+    kind: PendingKind
+
+
+@dataclass(frozen=True, slots=True)
+class SessionActivityProbe:
+    """The session-activity verdict over one transcript.
+
+    Attributes:
+        is_waiting: Whether the session waits on ephemeral or pending async work.
+        mid_tool: Whether the current turn has an unanswered non-human-facing call.
+        pending: The contributing calls, in document order, deduped by tool-use id.
+        last_event_epoch: The latest envelope timestamp as epoch seconds, or None.
+    """
+
+    is_waiting: bool
+    mid_tool: bool
+    pending: tuple[PendingItem, ...]
+    last_event_epoch: int | None
+
+
+def ephemeral_wait(block: ToolUseBlock, waiting_tools: frozenset[str]) -> PendingKind | None:
+    if block.name in waiting_tools:
+        return "waiting_tool"
+    match block.name:
+        case "Agent" | "Task" | "Bash" if block.input.get("run_in_background") is True:
+            return "background"
+        case "Agent" | "Task" if not isinstance(block.input.get("subagent_type"), str):
+            return "subagentless_task"
+    return None
+
+
+def pending_async(
+    block: ToolUseBlock, result: ToolResultBlock | None, notifications: Notifications
+) -> PendingKind | None:
+    match block.name:
+        case "Agent" | "Task" if result is not None and result.is_async and not notifications.completed(block.id):
+            return "pending_async_task"
+        case "Workflow" if not notifications.completed(block.id):
+            return "pending_async_workflow"
+    return None
+
+
+def probe_events(
+    events: Sequence[TranscriptEvent],
+    *,
+    waiting_tools: frozenset[str] = DEFAULT_WAITING_TOOLS,
+    human_facing_tools: frozenset[str] = DEFAULT_HUMAN_FACING_TOOLS,
+) -> SessionActivityProbe:
+    """The Python reference oracle over parsed events, twin of the Rust probe.
+
+    An undelivered task notification alone sets ``is_waiting`` with no pending
+    item — a resumed session's orphan has no launch to point at.
+    """
+    results = {
+        block.tool_use_id: block
+        for event in events
+        if isinstance(event, UserEvent | AssistantEvent)
+        for block in event.blocks
+        if isinstance(block, ToolResultBlock)
+    }
+    notifications = Notifications.from_events(events)
+    turn_start = next(
+        (
+            index
+            for index in reversed(range(len(events)))
+            if isinstance(event := events[index], UserEvent)
+            and native_user_classifier(event)
+            and not event.meta.is_compact_summary
+        ),
+        0,
+    )
+
+    is_waiting = notifications.has_pending
+    mid_tool = False
+    pending: list[PendingItem] = []
+    seen: set[str] = set()
+    for index, event in enumerate(events):
+        if not isinstance(event, UserEvent | AssistantEvent):
+            continue
+        for block in event.blocks:
+            if not isinstance(block, ToolUseBlock):
+                continue
+            result = results.get(block.id)
+            if result is not None and result.is_error:
+                continue
+            in_current_turn = index >= turn_start
+            waiting_kind = (ephemeral_wait(block, waiting_tools) if in_current_turn else None) or pending_async(
+                block, result, notifications
+            )
+            unmatched = in_current_turn and result is None and block.name not in human_facing_tools
+            is_waiting = is_waiting or waiting_kind is not None
+            mid_tool = mid_tool or unmatched
+            kind = waiting_kind or ("mid_tool" if unmatched else None)
+            if kind is None or block.id in seen:
+                continue
+            seen.add(block.id)
+            pending.append(PendingItem(tool_use_id=block.id, name=block.name, kind=kind))
+    return SessionActivityProbe(
+        is_waiting=is_waiting,
+        mid_tool=mid_tool,
+        pending=tuple(pending),
+        last_event_epoch=max(
+            (
+                int(event.meta.timestamp.timestamp())
+                for event in events
+                if isinstance(event, UserEvent | AssistantEvent | SystemEvent)
+            ),
+            default=None,
+        ),
+    )
+
+
+def rust_probe_backend() -> ModuleType | None:
+    """The Rust probe when the extension is built with it; else None → the Python reference."""
+    if os.environ.get("CC_TRANSCRIPT_DISABLE_RUST"):
+        return None
+    try:
+        from cc_transcript import _parser_rs
+    except ImportError:
+        return None
+    return _parser_rs if hasattr(_parser_rs, "session_activity_probe") else None
+
+
+def session_activity_probe(
+    path: Path,
+    *,
+    waiting_tools: frozenset[str] = DEFAULT_WAITING_TOOLS,
+    human_facing_tools: frozenset[str] = DEFAULT_HUMAN_FACING_TOOLS,
+) -> SessionActivityProbe:
+    """Probes the transcript at ``path`` for session activity via the active backend.
+
+    The Rust backend reads and parses the file inside the extension in one pass; the
+    Python reference parses via :func:`~cc_transcript.parser.parse_events_from_bytes`
+    and runs :func:`probe_events`. Both yield identical verdicts.
+
+    Args:
+        path: The ``.jsonl`` transcript to probe.
+        waiting_tools: Tool names whose calls in the current turn mark the session waiting.
+        human_facing_tools: Tool names whose unanswered calls are the user's move, never mid-tool.
+
+    Returns:
+        The session-activity verdict.
+    """
+    rust = rust_probe_backend()
+    if rust is None:
+        return probe_events(
+            parse_events_from_bytes(path.read_bytes()),
+            waiting_tools=waiting_tools,
+            human_facing_tools=human_facing_tools,
+        )
+    payload = rust.session_activity_probe(str(path), sorted(waiting_tools), sorted(human_facing_tools))
+    return SessionActivityProbe(
+        is_waiting=payload["is_waiting"],
+        mid_tool=payload["mid_tool"],
+        pending=tuple(PendingItem(**item) for item in payload["pending"]),
+        last_event_epoch=payload["last_event_epoch"],
+    )

{cc_transcript-9.1.0 → cc_transcript-10.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cc-transcript"
-version = "9.1.0"
+version = "10.1.0"
 description = "Grep every Claude Code session you've ever run."
 readme = "README.md"
 license = "PolyForm-Noncommercial-1.0.0"

cc_transcript-10.1.0/rust/Cargo.toml

@@ -0,0 +1,42 @@
+[package]
+name = "cc_transcript_parser"
+version = "0.9.0"
+edition = "2021"
+
+[lib]
+name = "_parser_rs"
+crate-type = ["cdylib", "rlib"]
+
+[features]
+default = ["python"]
+python = [
+    "dep:pyo3",
+    "dep:rayon",
+    "dep:crossbeam-channel",
+    "dep:num_cpus",
+    "dep:udpipe-rs",
+    "dep:dirs",
+    "dep:tree-sitter",
+    "dep:tree-sitter-bash",
+]
+extension-module = ["python", "pyo3/extension-module"]
+
+[dependencies]
+pyo3 = { version = "0.28", features = ["abi3-py313", "chrono"], optional = true }
+sonic-rs = "0.5"
+chrono = { version = "0.4", default-features = false, features = ["std"] }
+rayon = { version = "1.10", optional = true }
+crossbeam-channel = { version = "0.5", optional = true }
+num_cpus = { version = "1", optional = true }
+memchr = "2.7"
+once_cell = "1"
+regex = "1"
+udpipe-rs = { version = "0.2", optional = true }
+dirs = { version = "5", optional = true }
+# Grammar-pinned to the Python wheel: tree_sitter_bash 0.25.1 both sides (same
+# bash grammar), tree-sitter core 0.26 matches the wheel's tree-sitter 0.26.0.
+tree-sitter = { version = "0.26", optional = true }
+tree-sitter-bash = { version = "0.25", optional = true }
+
+[build-dependencies]
+pyo3-build-config = { version = "0.28", features = ["resolve-config"] }

cc_transcript-10.1.0/rust/build.rs

@@ -0,0 +1,20 @@
+// Local `cargo test` on the default (python) feature links a shared libpython
+// whose install name is `@rpath/libpython3.X.dylib`. The cargo test harness
+// carries no rpath to the interpreter's lib dir, so the binary aborts at load.
+// Emit that rpath, derived from the same interpreter pyo3 linked. Gated off when
+// `extension-module` is active, so the shipped wheel (which links no libpython
+// and resolves symbols from the host interpreter) keeps its exact build flags.
+fn main() {
+    let python = std::env::var_os("CARGO_FEATURE_PYTHON").is_some();
+    let extension_module = std::env::var_os("CARGO_FEATURE_EXTENSION_MODULE").is_some();
+    if !python || extension_module {
+        return;
+    }
+    println!("cargo:rerun-if-env-changed=PYO3_PYTHON");
+    println!("cargo:rerun-if-env-changed=PYO3_CONFIG_FILE");
+    let lib_dir = pyo3_build_config::get()
+        .lib_dir
+        .as_ref()
+        .expect("pyo3 linked a shared libpython but reported no lib_dir for the test rpath");
+    println!("cargo:rustc-link-arg=-Wl,-rpath,{lib_dir}");
+}