feat(profiler/behave_shell): emit cognitive.exploration_style

Two-axis classification over the first_token_hash sequence:
repetition_rate (drilling) vs backtrack_rate (jumping among prior
tools). chaotic/targeted/methodical buckets. v0.1 thresholds; D.8
re-tunes.
This commit is contained in:
2026-05-03 23:54:03 -04:00
parent f948e10830
commit 2254651270
4 changed files with 157 additions and 0 deletions

View File

@@ -14,6 +14,7 @@ from decnet.profiler.behave_shell._ctx import SessionContext
from decnet.profiler.behave_shell._features.cognitive import (
cognitive_load,
command_branch_diversity,
exploration_style,
feedback_loop_engagement,
inter_command_consistency,
inter_command_latency_class,
@@ -47,4 +48,5 @@ FEATURES: tuple[FeatureFn, ...] = (
feedback_loop_engagement,
inter_command_consistency,
cognitive_load,
exploration_style,
)

View File

@@ -21,6 +21,8 @@ from decnet.profiler.behave_shell._thresholds import (
COGNITIVE_LOAD_LOW_MAX,
COGNITIVE_LOAD_MEDIUM_MAX,
COGNITIVE_LOAD_PACE_REF_CV,
EXPLORATION_CHAOTIC_BACKTRACK_MIN,
EXPLORATION_TARGETED_REP_MIN,
FEEDBACK_CORRELATION_MIN,
FEEDBACK_MIN_PAIRS,
INTER_CMD_DELIBERATE_MAX,
@@ -179,6 +181,65 @@ def feedback_loop_engagement(ctx: SessionContext) -> Iterator[Observation]:
)
def exploration_style(ctx: SessionContext) -> Iterator[Observation]:
"""Emit ``cognitive.exploration_style`` ∈ {methodical, chaotic, targeted}.
Two-axis classification over the first_token_hash sequence:
* **methodical** — low repetition, low backtracks. Operator marches
forward through new tools.
* **targeted** — high repetition (R ≥ EXPLORATION_TARGETED_REP_MIN).
Same tool re-invoked repeatedly; the operator is drilling.
* **chaotic** — high backtrack rate (J ≥ EXPLORATION_CHAOTIC_BACKTRACK_MIN).
Jumps among previously-used tools without a clear thread.
The registry doesn't permit ``unknown``; below the
MIN_COMMANDS_FOR_FULL_CONFIDENCE floor we emit at confidence 0.40
rather than skip — the engine has *some* signal, just less of it.
Skip emission only when there are no commands at all.
"""
n = len(ctx.commands)
if n == 0:
return
hashes = [c.first_token_hash for c in ctx.commands]
unique = len(set(hashes))
repetition_rate = 0.0 if n == 0 else 1.0 - (unique / n)
# Backtrack: at position i, hashes[i] previously seen at index < i-1
# and not equal to hashes[i-1]. (Repeating the immediate predecessor
# is "drilling", picked up by repetition_rate; backtrack is the
# non-local jump signal.)
seen_before: set[str] = set()
backtracks = 0
transitions = 0
if hashes:
seen_before.add(hashes[0])
for i in range(1, n):
transitions += 1
if hashes[i] != hashes[i - 1] and hashes[i] in seen_before:
backtracks += 1
seen_before.add(hashes[i])
backtrack_rate = (backtracks / transitions) if transitions else 0.0
if backtrack_rate >= EXPLORATION_CHAOTIC_BACKTRACK_MIN:
value = "chaotic"
elif repetition_rate >= EXPLORATION_TARGETED_REP_MIN:
value = "targeted"
else:
value = "methodical"
if n < MIN_COMMANDS_FOR_FULL_CONFIDENCE:
confidence = 0.40
else:
confidence = 0.60
yield make_observation(
ctx,
primitive="cognitive.exploration_style",
value=value,
confidence=confidence,
)
def cognitive_load(ctx: SessionContext) -> Iterator[Observation]:
"""Emit ``cognitive.cognitive_load`` ∈ {low, medium, high}.

View File

@@ -108,6 +108,26 @@ COGNITIVE_LOAD_PACE_REF_CV: float = 1.50
COGNITIVE_LOAD_LOW_MAX: float = 0.33
COGNITIVE_LOAD_MEDIUM_MAX: float = 0.67
# ── cognitive.exploration_style (Step D.2) ─────────────────────────────────
# Two-axis classification over the first_token_hash sequence:
#
# repetition_rate (R) = 1 - (unique_first_tokens / total_commands)
# backtrack_rate (J) = transitions where commands[i+1].first_token_hash
# appeared anywhere in commands[0..i-1] but is NOT
# equal to commands[i].first_token_hash (jumping
# back to an older tool, not just repeating).
#
# J >= EXPLORATION_CHAOTIC_BACKTRACK_MIN → chaotic
# else if R >= EXPLORATION_TARGETED_REP_MIN → targeted
# else → methodical
#
# Methodical = low repetition, low backtracks (linear progression through
# novel tools). Targeted = high repetition (drilling the same tool).
# Chaotic = jumping between prior tools without a clear thread.
# v0.1; D.8 re-tunes.
EXPLORATION_TARGETED_REP_MIN: float = 0.50
EXPLORATION_CHAOTIC_BACKTRACK_MIN: float = 0.30
# ── motor.keystroke_cadence (Step B.1) ──────────────────────────────────────
# Typing bursts split at gaps > IKI_THINK_MAX_S so think-pauses between
# commands don't inflate the within-burst CV. Mirrors the prototype's

View File

@@ -0,0 +1,74 @@
"""Step D.2: ``cognitive.exploration_style``."""
from __future__ import annotations
from decnet.profiler.behave_shell import extract_session
from decnet.profiler.behave_shell._parse import AsciinemaEvent
def _of(observations: list, primitive: str):
obs = [o for o in observations if o.primitive == primitive]
assert len(obs) == 1, f"expected exactly one {primitive}, got {len(obs)}"
return obs[0]
def _cmds(tokens: list[str]) -> list[AsciinemaEvent]:
"""One command per token, evenly spaced one second apart."""
events: list[AsciinemaEvent] = []
for i, tok in enumerate(tokens):
t0 = i * 1.0
for j, c in enumerate(tok):
events.append((t0 + j * 0.05, "i", c))
events.append((t0 + len(tok) * 0.05, "i", "\r"))
return events
def test_no_commands_no_emission() -> None:
out = list(extract_session([(0.0, "i", "x")], sid="es-empty"))
assert [o for o in out if o.primitive == "cognitive.exploration_style"] == []
def test_all_unique_tools_emits_methodical() -> None:
"""Linear progression through new tools: low R, low J → methodical."""
out = list(extract_session(
_cmds(["ls", "ps", "id", "uname", "whoami", "pwd", "env", "date"]),
sid="es-meth",
))
obs = _of(out, "cognitive.exploration_style")
assert obs.value == "methodical"
def test_drilling_one_tool_emits_targeted() -> None:
"""Same tool repeated → high R, low J → targeted."""
out = list(extract_session(
_cmds(["curl", "curl", "curl", "curl", "curl", "curl", "curl", "curl"]),
sid="es-tgt",
))
obs = _of(out, "cognitive.exploration_style")
assert obs.value == "targeted"
def test_jumping_among_old_tools_emits_chaotic() -> None:
"""Backtracking among prior tools → high J → chaotic."""
out = list(extract_session(
_cmds(["a", "b", "c", "a", "c", "b", "a", "b"]),
sid="es-chaos",
))
obs = _of(out, "cognitive.exploration_style")
assert obs.value == "chaotic"
def test_low_sample_count_reduces_confidence() -> None:
short = list(extract_session(_cmds(["a", "b", "c"]), sid="es-short"))
full = list(extract_session(_cmds(["a", "b", "c", "d", "e", "f"]), sid="es-full"))
s = _of(short, "cognitive.exploration_style")
f = _of(full, "cognitive.exploration_style")
assert s.confidence < f.confidence
def test_pii_no_command_bodies_in_observation() -> None:
out = list(extract_session(
_cmds(["secret_payload"] * 6),
sid="es-pii",
))
obs = _of(out, "cognitive.exploration_style")
assert "secret_payload" not in obs.model_dump_json()