trigger-tree 1.14.0__tar.gz

trigger_tree-1.14.0/.github/scripts/plugin_install_smoke.py

@@ -0,0 +1,103 @@
+"""Prove the repository installs as a Claude Code marketplace plugin."""
+
+from __future__ import annotations
+
+import json
+import os
+import subprocess
+import tempfile
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[2]
+REQUIRED_FILES = (
+    ".claude-plugin/plugin.json",
+    "hooks/claude-hooks.json",
+    "hooks/hooks.json",
+    "codex-skills/trigger-tree/SKILL.md",
+    "skills/tt/SKILL.md",
+    "scripts/tt-log.py",
+    "scripts/tt-doctor.py",
+    "scripts/tt-uninstall.py",
+    "scripts/tt_scope.py",
+    "scripts/tt_runtime.py",
+)
+
+
+def run(*args: str, config_dir: Path) -> subprocess.CompletedProcess[str]:
+    env = os.environ.copy()
+    env["CLAUDE_CONFIG_DIR"] = str(config_dir)
+    return subprocess.run(
+        args,
+        cwd=ROOT,
+        env=env,
+        check=True,
+        text=True,
+        capture_output=True,
+    )
+
+
+def main() -> None:
+    with tempfile.TemporaryDirectory(prefix="trigger-tree-plugin-smoke-") as temp:
+        config_dir = Path(temp) / "claude"
+        config_dir.mkdir()
+
+        run(
+            "npx",
+            "claude",
+            "plugin",
+            "marketplace",
+            "add",
+            str(ROOT),
+            "--scope",
+            "user",
+            config_dir=config_dir,
+        )
+        run(
+            "npx",
+            "claude",
+            "plugin",
+            "install",
+            "trigger-tree@trigger-tree",
+            "--scope",
+            "user",
+            config_dir=config_dir,
+        )
+        result = run("npx", "claude", "plugin", "list", "--json", config_dir=config_dir)
+
+        installed = json.loads(result.stdout)
+        matches = [item for item in installed if item["id"] == "trigger-tree@trigger-tree"]
+        if len(matches) != 1 or not matches[0]["enabled"]:
+            raise SystemExit("trigger-tree was not installed and enabled exactly once")
+
+        install_path = Path(matches[0]["installPath"]).resolve()
+        if not install_path.is_relative_to(config_dir.resolve()):
+            raise SystemExit("plugin escaped the isolated Claude config directory")
+
+        missing = [name for name in REQUIRED_FILES if not (install_path / name).is_file()]
+        if missing:
+            raise SystemExit(f"installed plugin is incomplete: {', '.join(missing)}")
+        claude_skills = sorted(
+            path.parent.name for path in (install_path / "skills").glob("*/SKILL.md")
+        )
+        if claude_skills != ["tt"]:
+            raise SystemExit(f"Claude plugin exposes unexpected skills: {claude_skills}")
+
+        manifest = json.loads((install_path / ".claude-plugin/plugin.json").read_text())
+        if matches[0]["version"] != manifest["version"]:
+            raise SystemExit("installed version does not match plugin manifest")
+
+        hooks = (install_path / "hooks" / "hooks.json").read_text()
+        if "${CLAUDE_PLUGIN_ROOT}/scripts/tt-codex-hook.py" not in hooks:
+            raise SystemExit("shared hooks do not use the cross-client plugin root")
+
+        command_contract = (install_path / "skills" / "tt" / "SKILL.md").read_text()
+        if "CLAUDE_SKILL_DIR" in command_contract:
+            raise SystemExit("Claude command contract resolves scripts from the skill directory")
+        if "${CLAUDE_PLUGIN_ROOT}/scripts/tt-open.sh" not in command_contract:
+            raise SystemExit("Claude watch command does not resolve from the plugin root")
+
+        print(f"Installed trigger-tree v{manifest['version']} in an isolated Claude config")
+
+
+if __name__ == "__main__":
+    main()

trigger_tree-1.14.0/.github/scripts/release_integrity.py

@@ -0,0 +1,117 @@
+"""Reject release tags that disagree with the plugin's release metadata."""
+
+from __future__ import annotations
+
+import json
+import re
+import sys
+from pathlib import Path
+from urllib.parse import unquote
+
+ROOT = Path(__file__).resolve().parents[2]
+PUBLIC_OMISSIONS = {"help"}
+CLAUDE_SECTION_ONLY = {"tips"}
+CODEX_LABELS = {"live dashboard": "watch"}
+
+
+def fail(message: str) -> None:
+    raise SystemExit(f"release integrity failed: {message}")
+
+
+def tt_commands(text: str) -> set[str]:
+    return set(re.findall(r"/tt\s+([a-z]+)", text))
+
+
+def require_commands(label: str, actual: set[str], expected: set[str]) -> None:
+    if actual != expected:
+        fail(
+            f"{label} command drift: missing {sorted(expected - actual)}, "
+            f"extra {sorted(actual - expected)}"
+        )
+
+
+def check_relative_links(root: Path) -> None:
+    documents = [root / "README.md", *(root / "docs").glob("*.md")]
+    for document in documents:
+        text = document.read_text(encoding="utf-8")
+        for raw_target in re.findall(r"!?\[[^]]*\]\(([^)]+)\)", text):
+            target = raw_target.strip().strip("<>").split("#", 1)[0]
+            if not target or re.match(r"^[a-z][a-z0-9+.-]*:", target, re.I):
+                continue
+            resolved = (document.parent / unquote(target)).resolve()
+            if not resolved.exists():
+                fail(f"broken relative link in {document.relative_to(root)}: {raw_target}")
+
+
+def check_docs_currency(root: Path = ROOT) -> None:
+    claude = (root / "skills/tt/SKILL.md").read_text(encoding="utf-8")
+    frontmatter = claude.split("---", 2)[1]
+    help_block = claude.split('## `$1` = "help" or empty', 1)[1].split("\n## ", 1)[0]
+    canonical = tt_commands(frontmatter)
+    require_commands("Claude help table", tt_commands(help_block), canonical)
+
+    sections = set(re.findall(r'^## `\$1` = "([a-z]+)', claude, re.M))
+    require_commands("Claude handler sections", sections - CLAUDE_SECTION_ONLY, canonical)
+
+    public = canonical - PUBLIC_OMISSIONS
+    require_commands(
+        "README.md", tt_commands((root / "README.md").read_text(encoding="utf-8")), public
+    )
+    require_commands(
+        "index.html", tt_commands((root / "index.html").read_text(encoding="utf-8")), public
+    )
+
+    codex = (root / "codex-skills/trigger-tree/SKILL.md").read_text(encoding="utf-8")
+    labels = set(re.findall(r"^- ([A-Za-z ]+):", codex, re.M))
+    codex_commands = {CODEX_LABELS.get(label.lower(), label.lower()) for label in labels}
+    require_commands("Codex workflows", codex_commands, public | CLAUDE_SECTION_ONLY)
+    check_relative_links(root)
+
+
+def main(tag: str) -> None:
+    if not re.fullmatch(r"v\d+\.\d+\.\d+(?:-rc\.\d+)?", tag):
+        fail(f"tag {tag!r} is not vMAJOR.MINOR.PATCH or vMAJOR.MINOR.PATCH-rc.N")
+
+    manifest = json.loads((ROOT / ".claude-plugin/plugin.json").read_text(encoding="utf-8"))
+    codex_manifest = json.loads((ROOT / ".codex-plugin/plugin.json").read_text(encoding="utf-8"))
+    marketplace = json.loads((ROOT / ".claude-plugin/marketplace.json").read_text(encoding="utf-8"))
+    version = tag.removeprefix("v")
+
+    if manifest["version"] != version:
+        fail(f"tag {tag} does not match plugin version {manifest['version']}")
+    if codex_manifest["name"] != manifest["name"]:
+        fail("Codex and Claude plugin names disagree")
+    if codex_manifest["version"] != version:
+        fail(f"Codex plugin version {codex_manifest['version']} does not match {version}")
+    if marketplace["name"] != manifest["name"]:
+        fail("marketplace and plugin names disagree")
+    if not any(plugin["name"] == manifest["name"] for plugin in marketplace["plugins"]):
+        fail("marketplace does not expose the plugin manifest name")
+    entry = next(plugin for plugin in marketplace["plugins"] if plugin["name"] == manifest["name"])
+    if entry.get("version") != version:
+        fail(f"marketplace plugin version {entry.get('version')} does not match {version}")
+
+    pyproject = (ROOT / "pyproject.toml").read_text(encoding="utf-8")
+    packaged = re.search(r'(?m)^version = "([^"]+)"$', pyproject)
+    if not packaged or packaged.group(1) != version:
+        found = packaged.group(1) if packaged else "missing"
+        fail(f"pyproject packaged version {found} does not match {version}")
+
+    changelog = (ROOT / "CHANGELOG.md").read_text(encoding="utf-8")
+    heading = re.search(r"^## (?:\[)?([^]\s]+)", changelog, re.M)
+    if not heading or heading.group(1) != version:
+        fail(f"top CHANGELOG.md release is not {version}")
+
+    check_docs_currency(ROOT)
+
+    print(f"Release metadata consistently describes {tag}")
+
+
+if __name__ == "__main__":
+    if len(sys.argv) != 2:
+        fail("expected exactly one tag argument")
+    if sys.argv[1] == "--docs":
+        check_docs_currency(ROOT)
+        print("User-facing command surfaces and relative links are current")
+    else:
+        main(sys.argv[1])

trigger_tree-1.14.0/.github/scripts/release_notes.py

@@ -0,0 +1,57 @@
+"""Print the GitHub Release body for one tag from the changelog. Idempotent input."""
+
+from __future__ import annotations
+
+import re
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[2]
+
+FOOTER = """
+---
+
+**Install (Claude Code)**
+
+```
+/plugin marketplace add Hedde/trigger_tree
+/plugin install trigger-tree@trigger-tree
+```
+
+**Install (Codex)**
+
+```
+codex plugin marketplace add Hedde/trigger_tree
+codex plugin install trigger-tree
+```
+
+[Website](https://hedde.github.io/trigger_tree/) · [Documentation](https://github.com/Hedde/trigger_tree/tree/main/docs) · [Changelog](https://github.com/Hedde/trigger_tree/blob/main/CHANGELOG.md) · [Privacy](https://github.com/Hedde/trigger_tree/blob/main/PRIVACY.md)
+"""
+
+
+def changelog_section(text: str, version: str) -> str:
+    """Return the changelog body for exactly this version, without its heading."""
+    pattern = rf"(?ms)^## {re.escape(version)} — [0-9-]+\n(.*?)(?=^## |\Z)"
+    match = re.search(pattern, text)
+    if not match:
+        raise SystemExit(f"CHANGELOG.md has no section for version {version}")
+    body = match.group(1).strip()
+    if not body:
+        raise SystemExit(f"CHANGELOG.md section for {version} is empty")
+    return body
+
+
+def release_body(tag: str, changelog_text: str) -> str:
+    version = tag.removeprefix("v")
+    return changelog_section(changelog_text, version) + "\n" + FOOTER
+
+
+def main(tag: str) -> None:
+    changelog = (ROOT / "CHANGELOG.md").read_text(encoding="utf-8")
+    sys.stdout.write(release_body(tag, changelog))
+
+
+if __name__ == "__main__":
+    if len(sys.argv) != 2:
+        raise SystemExit("usage: release_notes.py <tag>")
+    main(sys.argv[1])

trigger_tree-1.14.0/.gitignore

@@ -0,0 +1,16 @@
+.trigger-tree/
+!tests/fixture-project/.trigger-tree/
+!tests/fixture-project/.trigger-tree/**
+tests/fixture-project/.trigger-tree/report.html
+__pycache__/
+.DS_Store
+.venv/
+.venv-*/
+node_modules/
+.coverage
+htmlcov/
+.pytest_cache/
+.claude/worktrees/
+dist-submissions/
+dist/
+*.egg-info/