pathly-adapters 2.0.3__tar.gz → 2.3.0__tar.gz

{pathly_adapters-2.0.3 → pathly_adapters-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pathly-adapters
-Version: 2.0.3
+Version: 2.3.0
 Summary: Pathly adapter installer — stitches and deploys agent files to AI host tools.
 Requires-Python: >=3.11
 Requires-Dist: pyyaml>=6.0
@@ -8,3 +8,4 @@ Provides-Extra: dev
 Requires-Dist: pytest>=8; extra == "dev"
 Requires-Dist: build; extra == "dev"
 Requires-Dist: twine; extra == "dev"
+Requires-Dist: jsonschema>=4; extra == "dev"

{pathly_adapters-2.0.3 → pathly_adapters-2.3.0}/README.md

@@ -37,7 +37,9 @@ Then open Claude Code in your project directory and start:
 /pathly end              ← retro + archive
 ```
 
-All commands go through `/pathly`. See `/pathly help` for the full command list.
+All commands go through `/pathly`. See [docs/FLOW_DIAGRAM.md](docs/FLOW_DIAGRAM.md) for the full command reference.
+
+> **Tip:** `/start` and `/pathly start` are equivalent. `/pathly` dispatches to the same skill; direct invocation skips the dispatcher.
 
 ## All commands
 
@@ -51,6 +53,8 @@ pathly-setup copilot --apply        # install for Copilot / VS Code only
 pathly-setup --repair               # overwrite Pathly-owned files
 pathly-setup --force                # overwrite all files, even non-Pathly-owned
 pathly-setup --uninstall            # remove all Pathly-owned files
+pathly-events summary <feature>     # print token/cost table for a pipeline run
+pathly-state <feature>              # print current FSM state for a feature
 ```
 
 `--dry-run` never writes. `--apply` is required for any writes.
@@ -59,15 +63,16 @@ pathly-setup --uninstall            # remove all Pathly-owned files
 
 | Host | Detected by | Installed locations |
 |------|-------------|---------------------|
-| `claude` | `~/.claude/` directory exists | `~/.claude/agents/` + `~/.claude/skills/` |
-| `codex` | Codex config directory exists | `~/.codex/agents/` + `~/.codex/skills/` |
-| `copilot` | VS Code + Copilot detected | VS Code agents folder |
+| `claude` | `~/.claude/` directory exists | `~/.claude/agents/` (behavioral contracts)<br>`~/.claude/skills/` (skill folders) |
+| `codex` | Codex config directory exists | `~/.codex/agents/` + `~/.codex/skills/` + local plugin marketplace |
+| `copilot` | VS Code + Copilot detected | `~/.vscode/extensions/pathly/agents/`<br>`~/.vscode/extensions/pathly/skills/` |
 
 ## How It Works
 
 1. **Detect** — scans for installed hosts on the current machine.
-2. **Stitch** — combines `core/agents/` and `core/skills/` content with adapter-specific `_meta/*.yaml` to produce deployable agent and skill files (frontmatter + body + spawn section).
+2. **Stitch** — combines `core/agents/` and `core/skills/` content with adapter-specific `_meta/<name>.yaml` to produce deployable agent and skill files (frontmatter + body + spawn section).
 3. **Materialize** — writes stitched files to the host config location. A manifest tracks Pathly-owned files; `--repair` overwrites owned files, `--force` overwrites everything. Install is atomic — if anything fails, already-written files are rolled back.
+4. **Register Codex plugin** - for Codex installs, writes `~/.codex/pathly-marketplace`, enables `pathly@pathly-local`, and refreshes the marketplace through the Codex CLI when available.
 
 ## Development setup
 
@@ -119,3 +124,5 @@ Stable (1.0.0). Core install path (`--dry-run`, `--apply`, `--uninstall`) is ver
 - **Hook path validation requires Python 3.9+** — hook scripts use `Path.is_relative_to()`, introduced in Python 3.9. The project already requires Python 3.11+, so this is always satisfied.
 
 - **Hooks require `PATHLY_PROJECT_ROOT`** — hook scripts (`classify_feedback.py`, `inject_feedback_ttl.py`) read the `PATHLY_PROJECT_ROOT` environment variable to locate the active project's `plans/` directory. If this variable is not set, hooks exit immediately without performing any action.
+
+- **Hook parity gap** — Pathly hooks run automatically only under Claude Code. Codex and Copilot VS Code require manual install; see [Hook surface coverage](docs/SECURITY.md#hook-surface-coverage).

{pathly_adapters-2.0.3 → pathly_adapters-2.3.0}/pyproject.toml

@@ -4,17 +4,19 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pathly-adapters"
-version = "2.0.3"
+version = "2.3.0"
 description = "Pathly adapter installer — stitches and deploys agent files to AI host tools."
 requires-python = ">=3.11"
 dependencies = ["pyyaml>=6.0"]
 
 [project.optional-dependencies]
-dev = ["pytest>=8", "build", "twine"]
+dev = ["pytest>=8", "build", "twine", "jsonschema>=4"]
 
 [project.scripts]
 pathly-setup = "install_cli.__main__:main"
 pathly-tokens = "pathly_telemetry.report:main"
+pathly-events = "pathly_orchestrator.eventlog:_cli"
+pathly-state = "pathly_orchestrator.eventlog:_state_cli"
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
@@ -23,7 +25,7 @@ addopts = ["-p", "no:cacheprovider"]
 
 [tool.setuptools.packages.find]
 where = ["src"]
-include = ["install_cli*", "pathly_telemetry*", "pathly_data*"]
+include = ["install_cli*", "pathly_telemetry*", "pathly_data*", "pathly_orchestrator*", "pathly_hooks*"]
 
 [tool.setuptools.package-data]
 "pathly_data" = [

{pathly_adapters-2.0.3 → pathly_adapters-2.3.0}/src/install_cli/codex_plugin_config.py

@@ -1,122 +1,170 @@
-"""Install/remove Pathly's Codex local marketplace registration."""
-from __future__ import annotations
-
-import json
-import re
-import shutil
-import sys
-from pathlib import Path
-
-MARKETPLACE_NAME = "pathly-local"
-PLUGIN_NAME = "pathly"
-
-_CODEX_CONFIG = Path.home() / ".codex" / "config.toml"
-_MARKETPLACE_ROOT = Path.home() / ".codex" / "pathly-marketplace"
-
-
-def install_codex_plugin(
-    plugin_files: dict[str, str],
-    *,
-    dry_run: bool = False,
-    config_path: Path | None = None,
-    marketplace_root: Path | None = None,
-) -> None:
-    """Create a real local marketplace and enable the Pathly plugin."""
-    config_path = config_path or _CODEX_CONFIG
-    marketplace_root = marketplace_root or _MARKETPLACE_ROOT
-
-    if dry_run:
-        print(f"  [dry-run] Would write Codex marketplace to {marketplace_root}")
-        print(f"  [dry-run] Would enable plugin '{PLUGIN_NAME}@{MARKETPLACE_NAME}' in {config_path}")
-        return
-
-    plugin_root = marketplace_root / "plugins" / PLUGIN_NAME
-    if plugin_root.exists():
-        shutil.rmtree(plugin_root)
-    plugin_root.mkdir(parents=True, exist_ok=True)
-
-    for name, content in sorted(plugin_files.items()):
-        target = plugin_root / name
-        if not target.resolve().is_relative_to(plugin_root.resolve()):
-            raise ValueError(f"Path traversal detected in plugin file: {name!r}")
-        target.parent.mkdir(parents=True, exist_ok=True)
-        target.write_text(content, encoding="utf-8")
-
-    _write_marketplace_json(marketplace_root)
-    _enable_in_codex_config(config_path, marketplace_root)
-    print(f"[codex] Registered local plugin marketplace at {marketplace_root}")
-
-
-def uninstall_codex_plugin(
-    *,
-    dry_run: bool = False,
-    config_path: Path | None = None,
-    marketplace_root: Path | None = None,
-) -> None:
-    config_path = config_path or _CODEX_CONFIG
-    marketplace_root = marketplace_root or _MARKETPLACE_ROOT
-
-    if dry_run:
-        print(f"  [dry-run] Would remove plugin '{PLUGIN_NAME}@{MARKETPLACE_NAME}' from {config_path}")
-        print(f"  [dry-run] Would remove Codex marketplace at {marketplace_root}")
-        return
-
-    _disable_in_codex_config(config_path)
-    if marketplace_root.exists():
-        shutil.rmtree(marketplace_root)
-    print(f"[codex] Removed local plugin marketplace at {marketplace_root}")
-
-
-def _write_marketplace_json(root: Path) -> None:
-    path = root / ".agents" / "plugins" / "marketplace.json"
-    path.parent.mkdir(parents=True, exist_ok=True)
-    data = {
-        "name": MARKETPLACE_NAME,
-        "interface": {"displayName": "Pathly Local"},
-        "plugins": [
-            {
-                "name": PLUGIN_NAME,
-                "source": {"source": "local", "path": f"./plugins/{PLUGIN_NAME}"},
-                "policy": {"installation": "AVAILABLE", "authentication": "ON_INSTALL"},
-                "category": "Developer Tools",
-            }
-        ],
-    }
-    path.write_text(json.dumps(data, indent=2), encoding="utf-8")
-
-
-def _enable_in_codex_config(path: Path, marketplace_root: Path) -> None:
-    content = _read_config(path)
-    content = _remove_pathly_blocks(content)
-    block = (
-        f"\n[marketplaces.{MARKETPLACE_NAME}]\n"
-        'last_updated = "1970-01-01T00:00:00Z"\n'
-        'source_type = "local"\n'
-        f"source = '{marketplace_root}'\n"
-        f'[plugins."{PLUGIN_NAME}@{MARKETPLACE_NAME}"]\n'
-        "enabled = true\n"
-    )
-    path.parent.mkdir(parents=True, exist_ok=True)
-    path.write_text(content.rstrip() + "\n" + block, encoding="utf-8")
-
-
-def _disable_in_codex_config(path: Path) -> None:
-    content = _read_config(path)
-    cleaned = _remove_pathly_blocks(content)
-    if cleaned != content:
-        path.write_text(cleaned.rstrip() + "\n", encoding="utf-8")
-
-
-def _read_config(path: Path) -> str:
-    if not path.exists():
-        print(f"  [warn] Codex config not found at {path}; creating it.", file=sys.stderr)
-        return ""
-    return path.read_text(encoding="utf-8")
-
-
-def _remove_pathly_blocks(content: str) -> str:
-    marketplace = rf"\n?\[marketplaces\.{re.escape(MARKETPLACE_NAME)}\].*?(?=\n\[|\Z)"
-    plugin = rf"\n?\[plugins\.\"{re.escape(PLUGIN_NAME)}@{re.escape(MARKETPLACE_NAME)}\"\].*?(?=\n\[|\Z)"
-    content = re.sub(marketplace, "", content, flags=re.DOTALL)
-    content = re.sub(plugin, "", content, flags=re.DOTALL)
-    return content
+"""Install/remove Pathly's Codex local marketplace registration."""
+from __future__ import annotations
+
+import json
+import re
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+MARKETPLACE_NAME = "pathly-local"
+PLUGIN_NAME = "pathly"
+
+_CODEX_CONFIG = Path.home() / ".codex" / "config.toml"
+_MARKETPLACE_ROOT = Path.home() / ".codex" / "pathly-marketplace"
+
+
+def install_codex_plugin(
+    plugin_files: dict[str, str],
+    *,
+    dry_run: bool = False,
+    config_path: Path | None = None,
+    marketplace_root: Path | None = None,
+    codex_command: str | None = None,
+) -> None:
+    """Create a real local marketplace and enable the Pathly plugin."""
+    config_path = config_path or _CODEX_CONFIG
+    marketplace_root = marketplace_root or _MARKETPLACE_ROOT
+
+    if dry_run:
+        print(f"  [dry-run] Would write Codex marketplace to {marketplace_root}")
+        print(f"  [dry-run] Would enable plugin '{PLUGIN_NAME}@{MARKETPLACE_NAME}' in {config_path}")
+        print("  [dry-run] Would refresh Codex local marketplace registration if the codex CLI is available")
+        return
+
+    using_default_paths = config_path == _CODEX_CONFIG and marketplace_root == _MARKETPLACE_ROOT
+    plugin_root = marketplace_root / "plugins" / PLUGIN_NAME
+    if plugin_root.exists():
+        shutil.rmtree(plugin_root)
+    plugin_root.mkdir(parents=True, exist_ok=True)
+
+    for name, content in sorted(plugin_files.items()):
+        target = plugin_root / name
+        if not target.resolve().is_relative_to(plugin_root.resolve()):
+            raise ValueError(f"Path traversal detected in plugin file: {name!r}")
+        target.parent.mkdir(parents=True, exist_ok=True)
+        target.write_text(content, encoding="utf-8")
+
+    _write_marketplace_json(marketplace_root)
+    refreshed = _refresh_codex_marketplace(
+        marketplace_root,
+        codex_command=codex_command,
+        discover_cli=using_default_paths,
+    )
+    if not refreshed:
+        _enable_in_codex_config(config_path, marketplace_root)
+    print(f"[codex] Registered local plugin marketplace at {marketplace_root}")
+    print('[codex] Restart Codex and start a new thread. Try: "Use Pathly help"')
+
+
+def uninstall_codex_plugin(
+    *,
+    dry_run: bool = False,
+    config_path: Path | None = None,
+    marketplace_root: Path | None = None,
+) -> None:
+    config_path = config_path or _CODEX_CONFIG
+    marketplace_root = marketplace_root or _MARKETPLACE_ROOT
+
+    if dry_run:
+        print(f"  [dry-run] Would remove plugin '{PLUGIN_NAME}@{MARKETPLACE_NAME}' from {config_path}")
+        print(f"  [dry-run] Would remove Codex marketplace at {marketplace_root}")
+        return
+
+    _disable_in_codex_config(config_path)
+    if marketplace_root.exists():
+        shutil.rmtree(marketplace_root)
+    print(f"[codex] Removed local plugin marketplace at {marketplace_root}")
+
+
+def _write_marketplace_json(root: Path) -> None:
+    path = root / ".agents" / "plugins" / "marketplace.json"
+    path.parent.mkdir(parents=True, exist_ok=True)
+    data = {
+        "name": MARKETPLACE_NAME,
+        "interface": {"displayName": "Pathly Local"},
+        "plugins": [
+            {
+                "name": PLUGIN_NAME,
+                "source": {"source": "local", "path": f"./plugins/{PLUGIN_NAME}"},
+                "policy": {"installation": "AVAILABLE", "authentication": "ON_INSTALL"},
+                "category": "Developer Tools",
+            }
+        ],
+    }
+    path.write_text(json.dumps(data, indent=2), encoding="utf-8")
+
+
+def _refresh_codex_marketplace(
+    marketplace_root: Path,
+    *,
+    codex_command: str | None = None,
+    discover_cli: bool = True,
+) -> bool:
+    command = codex_command
+    if command is None and discover_cli:
+        command = shutil.which("codex")
+    if command is None:
+        print("[codex] Codex CLI not found; config.toml was updated directly.")
+        return False
+
+    remove = subprocess.run(
+        [command, "plugin", "marketplace", "remove", MARKETPLACE_NAME],
+        capture_output=True,
+        text=True,
+        timeout=60,
+    )
+    if remove.returncode != 0:
+        print(f"[codex] Marketplace remove skipped: {remove.stderr.strip() or remove.stdout.strip()}")
+
+    add = subprocess.run(
+        [command, "plugin", "marketplace", "add", str(marketplace_root)],
+        capture_output=True,
+        text=True,
+        timeout=60,
+    )
+    if add.returncode != 0:
+        print(f"[codex] Codex CLI marketplace refresh failed: {add.stderr.strip() or add.stdout.strip()}", file=sys.stderr)
+        print("[codex] Falling back to direct config.toml registration.", file=sys.stderr)
+        return False
+
+    print("[codex] Refreshed Codex local marketplace registration via codex CLI.")
+    return True
+
+
+def _enable_in_codex_config(path: Path, marketplace_root: Path) -> None:
+    content = _read_config(path)
+    content = _remove_pathly_blocks(content)
+    block = (
+        f"\n[marketplaces.{MARKETPLACE_NAME}]\n"
+        'last_updated = "1970-01-01T00:00:00Z"\n'
+        'source_type = "local"\n'
+        f"source = '{marketplace_root}'\n"
+        f'[plugins."{PLUGIN_NAME}@{MARKETPLACE_NAME}"]\n'
+        "enabled = true\n"
+    )
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(content.rstrip() + "\n" + block, encoding="utf-8")
+
+
+def _disable_in_codex_config(path: Path) -> None:
+    content = _read_config(path)
+    cleaned = _remove_pathly_blocks(content)
+    if cleaned != content:
+        path.write_text(cleaned.rstrip() + "\n", encoding="utf-8")
+
+
+def _read_config(path: Path) -> str:
+    if not path.exists():
+        print(f"  [warn] Codex config not found at {path}; creating it.", file=sys.stderr)
+        return ""
+    return path.read_text(encoding="utf-8")
+
+
+def _remove_pathly_blocks(content: str) -> str:
+    marketplace = rf"\n?\[marketplaces\.{re.escape(MARKETPLACE_NAME)}\].*?(?=\n\[|\Z)"
+    plugin = rf"\n?\[plugins\.\"{re.escape(PLUGIN_NAME)}@{re.escape(MARKETPLACE_NAME)}\"\].*?(?=\n\[|\Z)"
+    content = re.sub(marketplace, "", content, flags=re.DOTALL)
+    content = re.sub(plugin, "", content, flags=re.DOTALL)
+    return content

{pathly_adapters-2.0.3 → pathly_adapters-2.3.0}/src/install_cli/detect.py

@@ -1,21 +1,21 @@
-from pathlib import Path
-
-_HOST_MARKERS: dict[str, list[Path]] = {
-    "claude": [
-        Path.home() / ".claude",
-    ],
-    "codex": [
-        Path.home() / ".codex",
-        Path.home() / ".openai-codex",
-    ],
-    "copilot": [
-        Path.home() / "AppData" / "Roaming" / "Code",          # Windows
-        Path.home() / ".config" / "Code",                       # Linux
-        Path.home() / "Library" / "Application Support" / "Code",  # macOS
-        Path.home() / ".vscode",
-    ],
-}
-
-
-def detect_hosts() -> list[str]:
-    return [host for host, paths in _HOST_MARKERS.items() if any(p.exists() for p in paths)]
+from pathlib import Path
+
+_HOST_MARKERS: dict[str, list[Path]] = {
+    "claude": [
+        Path.home() / ".claude",
+    ],
+    "codex": [
+        Path.home() / ".codex",
+        Path.home() / ".openai-codex",
+    ],
+    "copilot": [
+        Path.home() / "AppData" / "Roaming" / "Code",          # Windows
+        Path.home() / ".config" / "Code",                       # Linux
+        Path.home() / "Library" / "Application Support" / "Code",  # macOS
+        Path.home() / ".vscode",
+    ],
+}
+
+
+def detect_hosts() -> list[str]:
+    return [host for host, paths in _HOST_MARKERS.items() if any(p.exists() for p in paths)]