- Introduces BudgetEnforcer, a dedicated component that enforces per-file (max_file_size) and aggregated context (max_total_size) budgets, ensuring assembled contexts stay within configured limits.

- Adds BudgetViolation, a structured report that indicates which constraint was violated, the current usage, the limit, and a suggested remediation.

- Introduces ContextFile, a representation for files included in the assembled context, encapsulating path, size, and optional metadata required by the enforcer.

- Adds comprehensive Behave BDD tests (11 scenarios) to verify enforcement across all constraint types, including boundary conditions, violation paths, and warning vs. error semantics.

- Provides clear error and warning messages for budget violations to help users understand which constraint failed and by how much.

- Ensures full type annotations and linting compliance, aligning with the repository's strict type and style guidelines.

- Integrates budget enforcement into the acms context assembly workflow with minimal intrusion to existing code paths.

- Documents budgets, configuration, and usage; tests establish expected outcomes and maintain broad coverage.

- Optimizes for performance and maintainability with early-exit checks on violation detection and well-scoped abstractions.

- Prepares the feature for CI readiness with deterministic test coverage and well-defined behavior.

ISSUES CLOSED: #9583

After committing, push to remote with -u flag.

@@ -0,0 +1,73 @@
+Feature: ACMS Budget Enforcement for max_file_size and max_total_size constraints

@@ -0,0 +1,243 @@
+"""Step implementations for ACMS budget enforcement feature tests."""

@@ -0,0 +156,4 @@
+
+
+def _test_multibyte_utf8() -> None:
+    """BudgetEnforcer measures file size in bytes not characters."""

@@ -0,0 +147,4 @@
+
+    # Non-string content
+    try:
+        enforcer.add_file("file.txt", None)  # type: ignore[arg-type]

@@ -0,0 +11,4 @@
+def step_create_budget_enforcer_with_max_file_size(context, size: int) -> None:
+    """Create a budget enforcer with specified max_file_size."""
+    if not hasattr(context, "budget_enforcer"):
+        context.budget_enforcer = BudgetEnforcer(

@@ -0,0 +11,4 @@
+def step_create_budget_enforcer_with_max_file_size(context, size: int) -> None:
+    """Create a fresh budget enforcer with specified max_file_size.
+
+    Always creates a fresh instance — the Background runs before each scenario

@@ -9,2 +8,3 @@
-indexing large projects.
+Also provides budget enforcement mechanisms for max_file_size and
+max_total_size constraints on assembled context.
 

@@ -0,0 +241,4 @@
+    print("assembled-context-ok")
+
+
+_TESTS: dict[str, callable] = {

@@ -76,2 +23,2 @@
-_uko_exports = list(_uko.__all__)
-_index_exports = [
+# Re-export UKO vocabulary symbols for convenience
+_uko_exports: list[str] = list(_uko.__all__)

@@ -0,0 +1 @@
+test write verification

@@ -86,0 +87,4 @@
+]
+
+# Full __all__ includes uko symbols (already bound as explicit imports) + index + budget
+__all__: list[str] = list(_uko.__all__) + _index_exports + _budget_exports

@@ -86,0 +87,4 @@
+]
+
+# Full __all__ includes uko symbols (already bound as explicit imports) + index + budget
+__all__: list[str] = list(_uko.__all__) + _index_exports + _budget_exports