pactkit-codex 4.0.0__tar.gz → 4.1.1__tar.gz

{pactkit_codex-4.0.0/src/pactkit_codex.egg-info → pactkit_codex-4.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pactkit-codex
-Version: 4.0.0
+Version: 4.1.1
 Summary: PactKit adapter for OpenAI Codex CLI
 Author: Slim
 License: MIT
@@ -21,7 +21,7 @@ Classifier: Topic :: Software Development :: Quality Assurance
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: pactkit<4.1.0,>=4.0.0
+Requires-Dist: pactkit<4.2.0,>=4.1.3
 Requires-Dist: tomli>=1.1.0; python_version < "3.11"
 Dynamic: license-file
 

{pactkit_codex-4.0.0 → pactkit_codex-4.1.1}/pyproject.toml

@@ -4,13 +4,17 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pactkit-codex"
-version = "4.0.0"
+version = "4.1.1"
 description = "PactKit adapter for OpenAI Codex CLI"
 readme = "README.md"
 license = {text = "MIT"}
 requires-python = ">=3.10"
 dependencies = [
-    "pactkit>=4.0.0,<4.1.0",
+    # 2026-10-14: the project-level AGENTS.md write goes through
+    # `pactkit.managed_docs.upsert_managed_block`, which first ships in
+    # core 4.1.3.  The previous floor (>=4.1.0) allowed a released-core
+    # combination whose deploy raises ImportError.
+    "pactkit>=4.1.3,<4.2.0",
     "tomli>=1.1.0; python_version < '3.11'",
 ]
 

{pactkit_codex-4.0.0 → pactkit_codex-4.1.1}/src/pactkit_codex/deployer.py

@@ -85,6 +85,8 @@ _CODEX_PROJECT_AGENTS_MD = """\
 
 ## Dev Commands
 
+During development, run changed and mapped tests first (`pactkit regression --json <changed-files>`; a non-empty `not_run` means the result is partial). Run the full suite once at an explicit acceptance or release boundary.
+
 ```bash
 {dev_commands}
 ```
@@ -97,7 +99,7 @@ _CODEX_LOCAL_AGENTS_MD = """\
 """
 
 _STACK_DEV_COMMANDS = {
-    "python": "# Run tests\npython3 -m pytest tests/ -v\n\n# Lint\nruff check src/ tests/",
+    "python": "# Full acceptance suite\npython3 -m pytest tests/ -v\n\n# Lint\nruff check src/ tests/",
     "node": "# Run tests\nnpm test\n\n# Lint\nnpm run lint",
     "go": "# Run tests\ngo test ./...\n\n# Lint\ngolangci-lint run",
     "java": "# Run tests\nmvn test\n\n# Lint\nmvn checkstyle:check",
@@ -156,15 +158,22 @@ class CodexDeployer(DeployerBase):
             "trust_review_command": None,
         }
 
-    def deploy(self, config=None, target=None):
-        """Deploy PactKit configuration for Codex CLI."""
+    def deploy(self, config=None, target=None, project_root=None, no_redetect=False):
+        """Deploy PactKit configuration for Codex CLI.
+
+        ``project_root`` is **not** the deploy root (``~/.codex`` is): it names
+        the project whose config and overlay are read, which used to resolve
+        from the caller's cwd.  ``no_redetect`` is accepted because Core passes
+        it alongside; it is a no-op here — the stack probe only reads.
+        """
         codex_root = Path(target) if target else Path.home() / ".codex"
+        project_root = Path(project_root) if project_root is not None else Path.cwd()
 
         print("🚀 PactKit Codex CLI Deployment")
 
         from pactkit.config import find_pactkit_yaml
 
-        project_yaml = find_pactkit_yaml()
+        project_yaml = find_pactkit_yaml(project_root)
         if config is not None:
             cfg = config
         elif project_yaml is not None:
@@ -174,7 +183,7 @@ class CodexDeployer(DeployerBase):
             cfg = load_config(project_yaml)
         else:
             cfg = {}
-        cfg = activate_pactkit_maintainer_overlay(cfg, Path.cwd())
+        cfg = activate_pactkit_maintainer_overlay(cfg, project_root)
 
         enabled_skills = cfg.get("skills", sorted(VALID_SKILLS))
         enabled_commands = cfg.get("commands")
@@ -186,8 +195,8 @@ class CodexDeployer(DeployerBase):
             codex_root, enabled_skills, enabled_commands, cfg.get("rules", sorted(DEFAULT_RULE_IDS)),
         )
 
-        project_root = Path.cwd() if target is None else None
-        with rollback_paths(self._transaction_paths(codex_root, project_root)):
+        transaction_root = project_root if target is None else None  # rollback scope
+        with rollback_paths(self._transaction_paths(codex_root, transaction_root)):
             self._cleanup_stale_command_references(
                 codex_root, enabled_commands,
                 cfg.get("rules", sorted(DEFAULT_RULE_IDS)),
@@ -219,7 +228,12 @@ class CodexDeployer(DeployerBase):
             self.generate_codex_config_toml(codex_root)
             self.remove_legacy_stop_hook(codex_root)
 
-            if project_root is not None:
+            # Gate on `target is None`, not on `project_root is not None`: the
+            # two coincided only while `project_root` was *derived* from this
+            # condition, making it a flag as much as an identity.  Separate them
+            # and `-C` reaches the identity while an explicit `-t` install still
+            # touches nothing outside its target (measured 2026-10-02).
+            if target is None:
                 self.generate_codex_project_files(project_root)
 
             self.write_version_marker(codex_root)
@@ -1002,7 +1016,14 @@ class CodexDeployer(DeployerBase):
 
     @staticmethod
     def generate_codex_project_files(project_root):
-        """Generate project-level AGENTS.md, .codex/AGENTS.local.md, and .codex/pactkit.yaml."""
+        """Generate project-level AGENTS.md, .codex/AGENTS.local.md, and .codex/pactkit.yaml.
+
+        ``AGENTS.md`` is merge-semantics (2026-10-14, STORY-010 AC1/AC4
+        re-adjudicated): it carries the project's own rules, so only PactKit's
+        marked region is ours.  The whole-file rewrite and the title-based
+        "migration" into ``AGENTS.local.md`` are gone — a matching title was
+        never ownership proof, and both destroyed project rules.
+        """
         if project_root.resolve() == Path.home().resolve():
             return
 
@@ -1014,19 +1035,18 @@ class CodexDeployer(DeployerBase):
         agents_md_path = project_root / "AGENTS.md"
         local_md_path = codex_dir / "AGENTS.local.md"
 
-        if agents_md_path.exists() and not local_md_path.exists():
-            existing = agents_md_path.read_text()
-            expected_first_line = f"# {project_name}"
-            first_line = existing.split("\n", 1)[0].strip()
-            if first_line != expected_first_line:
-                atomic_write(local_md_path, existing)
-
         dev_commands = _STACK_DEV_COMMANDS.get(stack, _STACK_DEV_COMMANDS["unknown"])
         content = _CODEX_PROJECT_AGENTS_MD.format(
             project_name=project_name,
             dev_commands=dev_commands,
+        ).rstrip("\n")
+
+        from pactkit.managed_docs import upsert_managed_block
+
+        upsert_managed_block(
+            agents_md_path, content,
+            ownership=(project_root, "AGENTS.md"), backup_root=codex_dir,
         )
-        atomic_write(agents_md_path, content)
 
         if not local_md_path.exists():
             atomic_write(local_md_path, _CODEX_LOCAL_AGENTS_MD)
@@ -1229,6 +1249,13 @@ Stop at the failing stage and report the evidence needed to resume in this
 same session. Checkpoints are optional handover context; they never block a
 later command or require a run ID.
 
+Handover notes are optional. When they help, retain the current objective and
+confirmed corrections, target worktree/branch/revision, completed work with
+evidence references, remaining gaps, and the next useful action. Omit unknowns,
+credentials, and chat transcripts. Authorization does not carry forward;
+re-check the current user's instruction. A missing handover never blocks work
+in this session.
+
 ## Backlog mode
 
 With empty `$ARGUMENTS`, inspect the board and run eligible Stories one at a

{pactkit_codex-4.0.0 → pactkit_codex-4.1.1/src/pactkit_codex.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pactkit-codex
-Version: 4.0.0
+Version: 4.1.1
 Summary: PactKit adapter for OpenAI Codex CLI
 Author: Slim
 License: MIT
@@ -21,7 +21,7 @@ Classifier: Topic :: Software Development :: Quality Assurance
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: pactkit<4.1.0,>=4.0.0
+Requires-Dist: pactkit<4.2.0,>=4.1.3
 Requires-Dist: tomli>=1.1.0; python_version < "3.11"
 Dynamic: license-file
 

{pactkit_codex-4.0.0 → pactkit_codex-4.1.1}/src/pactkit_codex.egg-info/requires.txt

@@ -1,4 +1,4 @@
-pactkit<4.1.0,>=4.0.0
+pactkit<4.2.0,>=4.1.3
 
 [:python_version < "3.11"]
 tomli>=1.1.0