2026-05-12 09:02:42 +00:00 · 2026-05-12 09:02:42 +00:00
3 changed files with 38 additions and 4 deletions
@@ -1,9 +1,19 @@
 # Changelog

-# Changelog
-
 ## Unreleased

+- **Invariant Management CLI Commands** (#8161): Implemented `agents invariant add`,
+  `agents invariant list`, and `agents invariant remove` CLI commands for managing
+  invariant constraints in plan execution. The add command supports scope flags
+  (`--global`, `--project`, `--plan`, `--action`), validates constraint syntax via
+  Pydantic validators and prompt sanitization, and returns ULID-identified invariants
+  with structured output. The list command supports filtering by scope (global, project,
+  plan, action), effective-set merging with precedence (plan > project > global), regex
+  text filtering, and machine-readable output formats (json, yaml, plain). The remove
+  command soft-deletes invariants via active flag toggle with `--yes` confirmation
+  bypass. Full BDD test coverage (Behave) and Robot Framework integration tests included
+  with >= 97% line coverage for the invariant CLI commands module and service layer.
+
 - Hardened the TDD bug-fix quality gate for issue #629: PR parsing now
  requires whole-word closing keywords (avoids false positives like
  "prefixes #12"), TDD bug tag discovery now uses exact token matching
@@ -40,3 +40,4 @@ Below are some of the specific details of various contributions.
 * HAL 9000 has contributed database resource types (PostgreSQL, SQLite) with transaction-based sandbox strategy: implemented ``DatabaseResourceHandler`` providing full CRUD operations (`read`, `write`, `delete`, `list_children`) and connection validation with automatic credential masking for PostgreSQL and SQLite backends. Includes ``TransactionSandbox`` infrastructure wired into ``SandboxFactory``, BDD test coverage in ``features/database_resources.feature``, and Robot Framework integration tests in ``robot/database_resources.robot`` (PR #10591 / issue #8608, Epic #8568).
 * HAL 9000 has contributed the agents plan rollback command (PR #8674 / issue #8557): implemented checkpoint-based plan state restoration with the `agents plan rollback <plan-id> [<checkpoint-id>]` CLI command as part of Epic #8493, enabling plans to be restored to previous checkpoints, discarding post-checkpoint decisions, and resuming execution from the rolled-back state. Supported by `--yes/-y`, `--to-checkpoint`, and `--format/-f` flags. Includes comprehensive BDD test coverage (>= 97%) for rollback, decision discarding, and plan resume functionality.
 * HAL 9000 has contributed the PyYAML security upgrade (PR #11012 / issue #9055): added `pyyaml>=6.0.3` dependency constraint to address known YAML parsing vulnerabilities.
+* Jeffrey Phillips Freeman has contributed the invariant management CLI commands (PR #8161): implemented `agents invariant add`, `agents invariant list`, and `agents invariant remove` for managing plan execution constraints across global, project, plan, and action scopes, with scope flag validation, regex filtering, multiple output formats, and comprehensive BDD/Robot Framework test coverage.
@@ -487,6 +487,7 @@ docs = [
 tests = [
    { name = "asv" },
    { name = "behave" },
+    { name = "faker" },
    { name = "robotframework" },
    { name = "robotframework-pabot" },
    { name = "slipcover" },
@@ -497,7 +498,7 @@ tui = [

 [package.metadata]
 requires-dist = [
-    { name = "a2a-sdk", specifier = ">=0.3.0" },
+    { name = "a2a-sdk", specifier = ">=0.3.0,<1.0.0" },
    { name = "aiohttp", specifier = ">=3.13.4" },
    { name = "alembic", specifier = ">=1.13.1" },
    { name = "asv", marker = "extra == 'tests'", specifier = ">=0.6.5" },
@@ -506,6 +507,7 @@ requires-dist = [
    { name = "behave", marker = "extra == 'tests'", specifier = "==1.3.3" },
    { name = "dependency-injector", specifier = ">=4.41.0" },
    { name = "faiss-cpu", specifier = ">=1.7.4" },
+    { name = "faker", marker = "extra == 'tests'", specifier = ">=20.0.0" },
    { name = "griffe-pydantic", marker = "extra == 'docs'", specifier = ">=1.0.0" },
    { name = "jinja2", specifier = ">=3.1.0" },
    { name = "jsonschema", specifier = ">=4.20.0" },
@@ -529,8 +531,8 @@ requires-dist = [
    { name = "pytest", marker = "extra == 'dev'", specifier = ">=8.0.0" },
    { name = "pytest-asyncio", marker = "extra == 'dev'", specifier = ">=0.23.0" },
    { name = "pytest-cov", marker = "extra == 'dev'", specifier = ">=4.1.0" },
-    { name = "pyyaml", specifier = ">=6.0.3" },
    { name = "python-ulid", specifier = ">=2.7.0" },
+    { name = "pyyaml", specifier = ">=6.0.3" },
    { name = "radon", marker = "extra == 'dev'", specifier = ">=6.0.1" },
    { name = "restrictedpython", specifier = ">=7.0" },
    { name = "robotframework", marker = "extra == 'tests'", specifier = ">=7.3.2" },
@@ -832,6 +834,18 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/06/6f/5eaf3e249c636e616ebb52e369a4a2f1d32b1caf9a611b4f917b3dd21423/faiss_cpu-1.13.2-cp314-cp314-win_arm64.whl", hash = "sha256:8113a2a80b59fe5653cf66f5c0f18be0a691825601a52a614c30beb1fca9bc7c", size = 8556374, upload-time = "2025-12-24T10:27:36.653Z" },
 ]

+[[package]]
+name = "faker"
+version = "40.15.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "tzdata", marker = "sys_platform == 'win32'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/7f/13/6741787bd91c4109c7bed047d68273965cd52ce8a5f773c471b949334b6d/faker-40.15.0.tar.gz", hash = "sha256:20f3a6ec8c266b74d4c554e34118b21c3c2056c0b4a519d15c8decb3a4e6e795", size = 1967447, upload-time = "2026-04-17T20:05:27.555Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a7/a7/a600f8f30d4505e89166de51dd121bd540ab8e560e8cf0901de00a81de8c/faker-40.15.0-py3-none-any.whl", hash = "sha256:71ab3c3370da9d2205ab74ffb0fd51273063ad562b3a3bb69d0026a20923e318", size = 2004447, upload-time = "2026-04-17T20:05:25.437Z" },
+]
+
 [[package]]
 name = "filelock"
 version = "3.25.2"
@@ -3412,6 +3426,15 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/dc/9b/47798a6c91d8bdb567fe2698fe81e0c6b7cb7ef4d13da4114b41d239f65d/typing_inspection-0.4.2-py3-none-any.whl", hash = "sha256:4ed1cacbdc298c220f1bd249ed5287caa16f34d44ef4e9c3d0cbad5b521545e7", size = 14611, upload-time = "2025-10-01T02:14:40.154Z" },
 ]

+[[package]]
+name = "tzdata"
+version = "2026.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/ba/19/1b9b0e29f30c6d35cb345486df41110984ea67ae69dddbc0e8a100999493/tzdata-2026.2.tar.gz", hash = "sha256:9173fde7d80d9018e02a662e168e5a2d04f87c41ea174b139fbef642eda62d10", size = 198254, upload-time = "2026-04-24T15:22:08.651Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ce/e4/dccd7f47c4b64213ac01ef921a1337ee6e30e8c6466046018326977efd95/tzdata-2026.2-py2.py3-none-any.whl", hash = "sha256:bbe9af844f658da81a5f95019480da3a89415801f6cc966806612cc7169bffe7", size = 349321, upload-time = "2026-04-24T15:22:05.876Z" },
+]
+
 [[package]]
 name = "uc-micro-py"
 version = "2.0.0"