hstack 0.16.0 → 0.17.0

package/template/scripts/telemetry/run_kernel_fit.py

@@ -1,95 +0,0 @@
-#!/usr/bin/env python3
-"""Run the kernel-fit detection layer in isolation and dump JSON to stdout.
-
-Thin wrapper around `telemetry.insights.kernel_fit.compute()`. Used by
-`/hstack:kernel-fit-scan` to obtain the structured evidence blob the
-`kernel-fit-analyst` subagent consumes, without producing the full
-telemetry report.
-
-Usage:
-    python scripts/telemetry/run_kernel_fit.py [--repo <path>] [--window <days>]
-
-Defaults match `report.py`: `--repo` is cwd; `--window` is 30 days.
-
-The output is a single JSON object whose top-level keys mirror the
-`compute()` return value (`existing_open_findings_by_pattern`, and one
-key per pattern). The scan Skill reads stdout, parses, and passes the
-blob to the subagent.
-
-Read-only. No writes, no git side-effects.
-"""
-
-from __future__ import annotations
-
-import argparse
-import json
-import sys
-from datetime import datetime, timedelta, timezone
-from pathlib import Path
-
-# Match report.py's import-path bootstrap so this script can be invoked
-# from any directory.
-_THIS = Path(__file__).resolve()
-_SCRIPTS = _THIS.parent.parent
-if str(_SCRIPTS) not in sys.path:
-    sys.path.insert(0, str(_SCRIPTS))
-
-from telemetry.parsers import frontmatter, commits, transcripts  # noqa: E402
-from telemetry.insights import kernel_fit  # noqa: E402
-
-
-def main(argv: list[str] | None = None) -> int:
-    parser = argparse.ArgumentParser(description="Run kernel-fit detection and dump JSON.")
-    parser.add_argument("--repo", type=Path, default=Path.cwd(),
-                        help="Consuming-repo root (default: cwd).")
-    parser.add_argument("--window", type=int, default=30,
-                        help="Limit git/transcript history to last N days (default: 30; 0 = all).")
-    args = parser.parse_args(argv)
-
-    repo = args.repo.resolve()
-    hstack_root = repo / "hstack"
-    if not hstack_root.is_dir():
-        # Permit running against the template repo itself. CLAUDE.md is the
-        # pre-ADR-0010 kernel name — still accepted so an un-migrated tree
-        # keeps scanning.
-        if (repo / "specs").is_dir() and (
-            (repo / "KERNEL.md").is_file() or (repo / "CLAUDE.md").is_file()
-        ):
-            hstack_root = repo
-        else:
-            print(f"error: no hstack/ directory at {repo}", file=sys.stderr)
-            return 1
-
-    window_days: int | None = args.window if args.window > 0 else None
-    since_dt: datetime | None = (
-        datetime.now(timezone.utc) - timedelta(days=window_days)
-    ) if window_days else None
-
-    changes = frontmatter.load_change_artifacts(hstack_root)
-    tech_debt = frontmatter.load_tech_debt(hstack_root)
-    adrs = frontmatter.load_adrs(hstack_root)
-    module_specs = frontmatter.load_module_specs(hstack_root)
-    git_commits = commits.parse_commits(repo, since_days=window_days)
-    session_rows = transcripts.collect_session_rows([repo], since=since_dt)
-
-    findings_dir = hstack_root / "kernel-fit" / "findings"
-
-    result = kernel_fit.compute(
-        commits=git_commits,
-        changes=changes,
-        tech_debt=tech_debt,
-        adrs=adrs,
-        module_specs=module_specs,
-        session_rows=session_rows,
-        findings_dir=findings_dir,
-    )
-
-    # Path objects are not JSON-serializable; strip them where they appear
-    # (existing-findings paths get re-derived by the analyst from the id).
-    json.dump(result, sys.stdout, default=str, indent=2)
-    sys.stdout.write("\n")
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())

package/template/scripts/telemetry/session_id.py

@@ -1,139 +0,0 @@
-#!/usr/bin/env python3
-"""Resolve the active Claude Code session id — the one heuristic, in one place.
-
-Per ADR-0009 § Neutral: `/hstack:flag` resolved the session id inline in its own
-prose; the five sidecar-emitting Skills would have duplicated that prose a sixth
-time. They call this module instead.
-
-The heuristic (unchanged from ADR-0005): Claude Code writes one `*.jsonl`
-transcript per session under `~/.claude/projects/<encoded-cwd>/`, where
-`<encoded-cwd>` is the absolute working directory with `/` replaced by `-`. The
-most recently modified file in that directory is the active session; the session
-id is its basename.
-
-Both the heuristic and the transcript layout are harness implementation details,
-not a contract (ADR-0009 § Negative). Every failure mode resolves to
-`session_id: null` — never a guess, never a halt. A null session id means the
-phase reports as *unmeasured*, which is the whole point of the null-not-zero
-rule.
-
-CLI:
-    python3 scripts/telemetry/session_id.py            # JSON on stdout, always exit 0
-    python3 scripts/telemetry/session_id.py --cwd DIR  # resolve for another dir
-
-Output:
-    {"session_id": "062b8fe8-…" | null,
-     "transcript_path": "/Users/…/062b8fe8-….jsonl" | null,
-     "message_count": 1423,
-     "source": "transcript" | "unresolved",
-     "fallback_id": "a3f9c1d2",
-     "now": "2026-08-15T09:12:44Z"}
-
-`now` is the UTC stamp at resolution time, so a Skill opening a phase gets its
-`session_id` and its `phase_opened_at` from one call. `fallback_id` is short
-random hex for callers that need a non-null id anyway (`/hstack:flag` writes
-`fallback-<id>`); sidecar emitters ignore it and write `null`.
-"""
-
-from __future__ import annotations
-
-import argparse
-import json
-import os
-import sys
-from datetime import datetime, timezone
-from pathlib import Path
-
-
-PROJECTS_ROOT = Path.home() / ".claude" / "projects"
-
-
-def encoded_cwd(cwd: Path | str | None = None) -> str:
-    """`/Users/jane/code/moso` → `-Users-jane-code-moso`."""
-    p = Path(cwd) if cwd is not None else Path.cwd()
-    return str(p.resolve()).replace("/", "-")
-
-
-def project_dir(cwd: Path | str | None = None, projects_root: Path | None = None) -> Path:
-    root = projects_root or PROJECTS_ROOT
-    return root / encoded_cwd(cwd)
-
-
-def utc_now_iso() -> str:
-    """ISO-8601 UTC, second precision, `Z` suffix — the sidecar timestamp format."""
-    return datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
-
-
-def resolve_session(cwd: Path | str | None = None,
-                    projects_root: Path | None = None) -> dict:
-    """Resolve the active session for `cwd`. Never raises; never halts."""
-    out = {
-        "session_id": None,
-        "transcript_path": None,
-        "message_count": 0,
-        "source": "unresolved",
-        "fallback_id": os.urandom(4).hex(),
-        "now": utc_now_iso(),
-    }
-    d = project_dir(cwd, projects_root)
-    try:
-        candidates = [f for f in d.glob("*.jsonl") if f.is_file()]
-    except OSError:
-        return out
-    if not candidates:
-        return out
-    try:
-        newest = max(candidates, key=lambda f: f.stat().st_mtime)
-    except OSError:
-        return out
-    out["session_id"] = newest.stem
-    out["transcript_path"] = str(newest)
-    out["source"] = "transcript"
-    out["message_count"] = _count_lines(newest)
-    return out
-
-
-def _count_lines(path: Path) -> int:
-    try:
-        with open(path, "rb") as fh:
-            return sum(1 for _ in fh)
-    except OSError:
-        return 0
-
-
-def transcript_for_session(session_id: str | None,
-                           projects_root: Path | None = None) -> Path | None:
-    """Locate a transcript by session id, across every project directory.
-
-    The sidecar carries the session id, not the path: a Conductor worktree can be
-    renamed or removed between the write and the read, and the encoded-cwd
-    directory with it. Returns None when no transcript is found — retention
-    sweep, another machine, or a harness layout change. None means *unmeasured*.
-    """
-    if not session_id or not isinstance(session_id, str):
-        return None
-    if session_id.startswith("fallback-"):
-        return None
-    root = projects_root or PROJECTS_ROOT
-    if not root.is_dir():
-        return None
-    for d in sorted(root.iterdir()):
-        if not d.is_dir():
-            continue
-        candidate = d / f"{session_id}.jsonl"
-        if candidate.is_file():
-            return candidate
-    return None
-
-
-def main(argv: list[str] | None = None) -> int:
-    parser = argparse.ArgumentParser(description="Resolve the active Claude Code session id.")
-    parser.add_argument("--cwd", type=Path, default=None,
-                        help="Directory to resolve for (default: current working directory).")
-    args = parser.parse_args(argv)
-    print(json.dumps(resolve_session(args.cwd), indent=1))
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())