Clarify TQQQ present CLI and output root contract

Co-Authored-By: Codex <noreply@openai.com>

Author: Pigbibi

src/quant_strategy_plugins/tqqq_market_regime_control_present.py

@@ -1,3 +1,5 @@
+"""T2B2 PRESENT capture CLI is ``python -m quant_strategy_plugins.tqqq_market_regime_control_present``; direct src-file execution is outside the public contract."""
+
 from __future__ import annotations
 
 import base64
@@ -28,6 +30,7 @@
 STRATEGY = "tqqq_growth_income"
 PLUGIN = "market_regime_control"
 MODE = "shadow"
+PUBLIC_CLI_INVOCATION = "python -m quant_strategy_plugins.tqqq_market_regime_control_present"
 
 REQUIRED_INPUTS = frozenset(
     {
@@ -263,7 +266,7 @@ def _csv_path(value: object) -> str:
 def _admit_output_root(value: str, root: Path) -> Path:
     lexical = Path(value)
     if not lexical.is_absolute():
-        lexical = Path.cwd() / lexical
+        lexical = root / lexical
     try:
         if lexical.is_symlink():
             _fail(IDENTITY_INVALID, 2)

tests/test_tqqq_market_regime_control_present.py

@@ -302,3 +302,29 @@ def test_ignored_in_checkout_output_root_is_admitted(tmp_path: Path, monkeypatch
 
     assert error.value.code == "T2B2_PRODUCER_ARTIFACT_INVALID"
     assert (tmp_path / "output").is_dir()
+
+
+def _checkout_root(tmp_path: Path) -> Path:
+    subprocess.run(("git", "init", "-q", str(tmp_path)), check=True)
+    (tmp_path / ".gitignore").write_text("output/\n", encoding="utf-8")
+    return tmp_path
+
+
+def test_public_cli_contract_uses_package_module_not_direct_source_file() -> None:
+    assert present.PUBLIC_CLI_INVOCATION == "python -m quant_strategy_plugins.tqqq_market_regime_control_present"
+
+
+def test_relative_output_dir_is_resolved_from_verified_checkout_root(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
+    root = _checkout_root(tmp_path)
+    invocation_dir = tmp_path / "other-working-directory"
+    invocation_dir.mkdir()
+    monkeypatch.chdir(invocation_dir)
+
+    assert present._admit_output_root("output/present", root) == root / "output" / "present"
+
+
+def test_trusted_local_output_outside_checkout_remains_admitted(tmp_path: Path) -> None:
+    root = _checkout_root(tmp_path)
+    outside = tmp_path.parent / f"{tmp_path.name}-outside-output"
+
+    assert present._admit_output_root(str(outside), root) == outside.resolve(strict=False)