feat(profiler/behave_shell): emit cognitive.planning_depth

Distribution of inter-command IATs bucketed against IKI_THINK_MAX_S
(deep) and INTER_CMD_INSTANT_MAX (reactive); fall-through is shallow.
v0.1 thresholds; D.8 re-tunes.

decnet/profiler/behave_shell/_features/__init__.py

@@ -16,6 +16,7 @@ from decnet.profiler.behave_shell._features.cognitive import (
     command_branch_diversity,
     exploration_style,
     feedback_loop_engagement,
+    planning_depth,
     inter_command_consistency,
     inter_command_latency_class,
 )
@@ -49,4 +50,5 @@ FEATURES: tuple[FeatureFn, ...] = (
     inter_command_consistency,
     cognitive_load,
     exploration_style,
+    planning_depth,
 )

decnet/profiler/behave_shell/_features/cognitive.py

@@ -25,6 +25,7 @@ from decnet.profiler.behave_shell._thresholds import (
     EXPLORATION_TARGETED_REP_MIN,
     FEEDBACK_CORRELATION_MIN,
     FEEDBACK_MIN_PAIRS,
+    IKI_THINK_MAX_S,
     INTER_CMD_DELIBERATE_MAX,
     INTER_CMD_INSTANT_MAX,
     INTER_CMD_LLM_HEAVYWEIGHT_MAX,
@@ -33,6 +34,8 @@ from decnet.profiler.behave_shell._thresholds import (
     MIN_COMMANDS_FOR_FULL_CONFIDENCE,
     PAUSE_CV_BIMODAL_MIN,
     PAUSE_CV_METRONOMIC_MAX,
+    PLANNING_DEEP_MIN,
+    PLANNING_REACTIVE_MIN,
 )
 
 
@@ -181,6 +184,50 @@ def feedback_loop_engagement(ctx: SessionContext) -> Iterator[Observation]:
     )
 
 
+def planning_depth(ctx: SessionContext) -> Iterator[Observation]:
+    """Emit ``cognitive.planning_depth`` ∈ {deep, shallow, reactive}.
+
+    Read off the distribution of inter-command IATs:
+
+    * **deep** — many think-pauses (> ``IKI_THINK_MAX_S``). The
+      operator stops to think between commands.
+    * **reactive** — most pauses are sub-instant
+      (≤ ``INTER_CMD_INSTANT_MAX``). Knee-jerk pacing — automated
+      runner, prepared playbook, or an LLM with no internal latency.
+    * **shallow** — neither: mostly typing-speed pauses, no extended
+      contemplation.
+
+    Skip emission when no inter-command IATs exist (one or zero
+    commands); the registry has no ``unknown`` for this primitive.
+    """
+    iats = ctx.inter_cmd_iats
+    if not iats:
+        return
+    n = len(iats)
+    deep_count = sum(1 for x in iats if x > IKI_THINK_MAX_S)
+    reactive_count = sum(1 for x in iats if x <= INTER_CMD_INSTANT_MAX)
+    deep_frac = deep_count / n
+    reactive_frac = reactive_count / n
+
+    if deep_frac >= PLANNING_DEEP_MIN:
+        value = "deep"
+    elif reactive_frac >= PLANNING_REACTIVE_MIN:
+        value = "reactive"
+    else:
+        value = "shallow"
+
+    if len(ctx.commands) < MIN_COMMANDS_FOR_FULL_CONFIDENCE:
+        confidence = 0.40
+    else:
+        confidence = 0.65
+    yield make_observation(
+        ctx,
+        primitive="cognitive.planning_depth",
+        value=value,
+        confidence=confidence,
+    )
+
+
 def exploration_style(ctx: SessionContext) -> Iterator[Observation]:
     """Emit ``cognitive.exploration_style`` ∈ {methodical, chaotic, targeted}.
 

decnet/profiler/behave_shell/_thresholds.py

@@ -128,6 +128,19 @@ COGNITIVE_LOAD_MEDIUM_MAX: float = 0.67
 EXPLORATION_TARGETED_REP_MIN: float = 0.50
 EXPLORATION_CHAOTIC_BACKTRACK_MIN: float = 0.30
 
+# ── cognitive.planning_depth (Step D.3) ────────────────────────────────────
+# Distribution of inter-command IATs.
+#   deep_pause_fraction      = (count of inter_cmd_iats > IKI_THINK_MAX_S) / N
+#   reactive_pause_fraction  = (count of inter_cmd_iats <= INTER_CMD_INSTANT_MAX) / N
+#
+#   deep_pause_fraction      >= PLANNING_DEEP_MIN     → deep
+#   reactive_pause_fraction  >= PLANNING_REACTIVE_MIN → reactive
+#   otherwise                                         → shallow
+#
+# v0.1; D.8 re-tunes once D.1-D.7 are stable.
+PLANNING_DEEP_MIN: float = 0.40
+PLANNING_REACTIVE_MIN: float = 0.50
+
 # ── 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