context-compiler 0.9.0.dev0__tar.gz → 0.9.0.dev2__tar.gz

{context_compiler-0.9.0.dev0 → context_compiler-0.9.0.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: context-compiler
-Version: 0.9.0.dev0
+Version: 0.9.0.dev2
 Summary: Deterministic conversational state engine for LLM applications.
 Project-URL: Homepage, https://github.com/rlippmann/context-compiler
 Project-URL: Repository, https://github.com/rlippmann/context-compiler
@@ -306,14 +306,15 @@ Common API entry points:
 - decision helpers: `is_clarify(...)`, `is_update(...)`, `is_passthrough(...)`,
   `get_clarify_prompt(...)`, `get_decision_state(...)`
 - state transport: `engine.export_json(...)`, `engine.import_json(...)`
-- controller APIs: `preview(...)`, `step(...)`, `state_diff(...)`
+- controller API: `step(...)`
+- audit APIs: `preview(...)`, `state_diff(...)`
 
-### Controller API (Reusable Outside REPL)
+### Controller And Audit APIs (Reusable Outside REPL)
 
-- `preview(engine, user_input)` performs a deterministic dry run and restores
-  live engine state afterward
 - `step(engine, user_input)` returns a reusable result envelope around one
   engine turn
+- `preview(engine, user_input)` performs a deterministic dry run and restores
+  live engine state afterward
 - `state_diff(state_before, state_after)` summarizes structural state changes
 
 For examples and helper accessors such as `get_step_decision(...)`,

{context_compiler-0.9.0.dev0 → context_compiler-0.9.0.dev2}/README.md

@@ -276,14 +276,15 @@ Common API entry points:
 - decision helpers: `is_clarify(...)`, `is_update(...)`, `is_passthrough(...)`,
   `get_clarify_prompt(...)`, `get_decision_state(...)`
 - state transport: `engine.export_json(...)`, `engine.import_json(...)`
-- controller APIs: `preview(...)`, `step(...)`, `state_diff(...)`
+- controller API: `step(...)`
+- audit APIs: `preview(...)`, `state_diff(...)`
 
-### Controller API (Reusable Outside REPL)
+### Controller And Audit APIs (Reusable Outside REPL)
 
-- `preview(engine, user_input)` performs a deterministic dry run and restores
-  live engine state afterward
 - `step(engine, user_input)` returns a reusable result envelope around one
   engine turn
+- `preview(engine, user_input)` performs a deterministic dry run and restores
+  live engine state afterward
 - `state_diff(state_before, state_after)` summarizes structural state changes
 
 For examples and helper accessors such as `get_step_decision(...)`,

{context_compiler-0.9.0.dev0 → context_compiler-0.9.0.dev2}/examples/08_controller_preview_diff.py

@@ -4,14 +4,16 @@ from _util import print_decision_summary, print_state_summary
 
 from context_compiler import (
     create_engine,
-    diff_has_changes,
-    get_preview_decision,
     get_step_decision,
     get_step_state,
+    step,
+)
+from context_compiler.audit import (
+    diff_has_changes,
+    get_preview_decision,
     preview,
     preview_would_mutate,
     state_diff,
-    step,
 )
 
 

{context_compiler-0.9.0.dev0 → context_compiler-0.9.0.dev2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "context-compiler"
-version = "0.9.0dev"
+version = "0.9.0dev2"
 description = "Deterministic conversational state engine for LLM applications."
 readme = "README.md"
 requires-python = ">=3.11"

{context_compiler-0.9.0.dev0 → context_compiler-0.9.0.dev2}/src/context_compiler/__init__.py

@@ -8,17 +8,9 @@ from .const import (
     POLICY_USE,
 )
 from .controller import (
-    PreviewResult,
     StepResult,
-    StructuralDiff,
-    diff_has_changes,
-    get_preview_decision,
-    get_preview_state_after,
     get_step_decision,
     get_step_state,
-    preview,
-    preview_would_mutate,
-    state_diff,
     step,
 )
 from .decision_helpers import (
@@ -30,43 +22,34 @@ from .decision_helpers import (
 )
 from .engine import (
     Decision,
+    DecisionKind,
     Engine,
+    PolicyValue,
     State,
     create_engine,
 )
-from .grammar import DirectiveKind, is_canonical_directive, render_directive, validate_directive
 
 __version__ = version("context-compiler")
 
 __all__ = [
     "Decision",
+    "DecisionKind",
     "DECISION_CLARIFY",
     "DECISION_PASSTHROUGH",
     "DECISION_UPDATE",
-    "DirectiveKind",
     "Engine",
     "POLICY_PROHIBIT",
     "POLICY_USE",
-    "PreviewResult",
+    "PolicyValue",
     "State",
     "StepResult",
-    "StructuralDiff",
-    "diff_has_changes",
     "create_engine",
     "get_clarify_prompt",
     "get_decision_state",
-    "get_preview_decision",
-    "get_preview_state_after",
     "get_step_decision",
     "get_step_state",
-    "is_canonical_directive",
     "is_clarify",
     "is_passthrough",
     "is_update",
-    "preview",
-    "preview_would_mutate",
-    "render_directive",
-    "state_diff",
     "step",
-    "validate_directive",
 ]

context_compiler-0.9.0.dev2/src/context_compiler/audit.py

@@ -0,0 +1,23 @@
+"""Public auditability helpers layered above the authoritative engine."""
+
+from .controller import (
+    PreviewResult,
+    StructuralDiff,
+    diff_has_changes,
+    get_preview_decision,
+    get_preview_state_after,
+    preview,
+    preview_would_mutate,
+    state_diff,
+)
+
+__all__ = [
+    "PreviewResult",
+    "StructuralDiff",
+    "diff_has_changes",
+    "get_preview_decision",
+    "get_preview_state_after",
+    "preview",
+    "preview_would_mutate",
+    "state_diff",
+]