@r1z4x/tezgah 1.0.0 → 1.2.0

package/bin/tezgah-skill

@@ -0,0 +1,59 @@
+#!/usr/bin/env python3
+"""tezgah-skill [-k N] [--json] [--root DIR] QUERY... - find the skill section
+that answers a topic.
+
+The roster a session meets is hundreds of one-line names, so the skill that
+holds the answer is a guess unless something searches the bodies. This is that
+search: every installed skill root on the machine (the plugin's own, omp's user
+and custom-directories corpora, Claude/Codex/Agents/opencode), indexed by
+heading, ranked by the same BM25 the per-turn lessons block uses. Each hit is a
+section, not a file:
+
+  skill://attack-jwt:26-122  /abs/SKILL.md  JWT Token Attack
+
+The `skill://<name>:<start>-<end>` address is what omp's read tool resolves
+(line selectors included); the absolute path is for the hosts that have no
+skill:// transport, and is also the tiebreaker where two roots hold different
+skills under one name (the search reports the first root's copy, omp's own
+precedence order - it does not resolve the collision for you).
+
+--root DIR adds a directory to the discovered roots (a project's vendored
+skills); --json prints the machine shape. Exit 0 hits, 1 none, 2 usage.
+"""
+import argparse
+import json
+import os
+import sys
+
+HERE = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+sys.path.insert(0, os.path.join(HERE, "hooks"))
+import tezgah_skill_pick as sp  # noqa: E402
+
+
+def main(argv=None):
+    parser = argparse.ArgumentParser(
+        prog="tezgah-skill", description=__doc__.splitlines()[0])
+    parser.add_argument("query", nargs="+", help="the topic to search for")
+    parser.add_argument("-k", type=int, default=5, metavar="N",
+                        help="sections to print (default 5)")
+    parser.add_argument("--root", action="append", default=[], metavar="DIR",
+                        help="an extra skills directory to index (repeatable)")
+    parser.add_argument("--json", action="store_true",
+                        help="print [{skill, uri, path, title, start, end}]")
+    args = parser.parse_args(argv)
+    query = " ".join(args.query)
+    hits = sp.search(query, k=max(1, args.k),
+                     roots=(sp.skill_roots(args.root) if args.root else None))
+    if args.json:
+        print(json.dumps([{"skill": h[0],
+                           "uri": "skill://%s:%d-%d" % (h[0], h[3], h[4]),
+                           "path": h[1], "title": h[2],
+                           "start": h[3], "end": h[4]} for h in hits], indent=1))
+    else:
+        for skill, path, title, start, end in hits:
+            print("skill://%s:%d-%d\t%s\t%s" % (skill, start, end, path, title))
+    return 0 if hits else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/bin/tezgah-skill.py

@@ -0,0 +1,59 @@
+#!/usr/bin/env python3
+"""tezgah-skill [-k N] [--json] [--root DIR] QUERY... - find the skill section
+that answers a topic.
+
+The roster a session meets is hundreds of one-line names, so the skill that
+holds the answer is a guess unless something searches the bodies. This is that
+search: every installed skill root on the machine (the plugin's own, omp's user
+and custom-directories corpora, Claude/Codex/Agents/opencode), indexed by
+heading, ranked by the same BM25 the per-turn lessons block uses. Each hit is a
+section, not a file:
+
+  skill://attack-jwt:26-122  /abs/SKILL.md  JWT Token Attack
+
+The `skill://<name>:<start>-<end>` address is what omp's read tool resolves
+(line selectors included); the absolute path is for the hosts that have no
+skill:// transport, and is also the tiebreaker where two roots hold different
+skills under one name (the search reports the first root's copy, omp's own
+precedence order - it does not resolve the collision for you).
+
+--root DIR adds a directory to the discovered roots (a project's vendored
+skills); --json prints the machine shape. Exit 0 hits, 1 none, 2 usage.
+"""
+import argparse
+import json
+import os
+import sys
+
+HERE = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+sys.path.insert(0, os.path.join(HERE, "hooks"))
+import tezgah_skill_pick as sp  # noqa: E402
+
+
+def main(argv=None):
+    parser = argparse.ArgumentParser(
+        prog="tezgah-skill", description=__doc__.splitlines()[0])
+    parser.add_argument("query", nargs="+", help="the topic to search for")
+    parser.add_argument("-k", type=int, default=5, metavar="N",
+                        help="sections to print (default 5)")
+    parser.add_argument("--root", action="append", default=[], metavar="DIR",
+                        help="an extra skills directory to index (repeatable)")
+    parser.add_argument("--json", action="store_true",
+                        help="print [{skill, uri, path, title, start, end}]")
+    args = parser.parse_args(argv)
+    query = " ".join(args.query)
+    hits = sp.search(query, k=max(1, args.k),
+                     roots=(sp.skill_roots(args.root) if args.root else None))
+    if args.json:
+        print(json.dumps([{"skill": h[0],
+                           "uri": "skill://%s:%d-%d" % (h[0], h[3], h[4]),
+                           "path": h[1], "title": h[2],
+                           "start": h[3], "end": h[4]} for h in hits], indent=1))
+    else:
+        for skill, path, title, start, end in hits:
+            print("skill://%s:%d-%d\t%s\t%s" % (skill, start, end, path, title))
+    return 0 if hits else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/bin/tezgah-status

@@ -62,7 +62,17 @@ their status line; this CLI is how every host (and a human) gets it:
                            records, prose-only) and the record from
                            docs/contract.md. A report, not a gate: it always
                            exits 0. `--json` prints the rows.
+  tezgah-status --judge    what the judgement seam used last: the provider and
+                           model that answered, and why it was not the session's
+                           own CLI when it was not, or the refusal and the
+                           failures that left no judgement. `--json` prints it.
   tezgah-status --legend   explain the marks
+  tezgah-status --orca [PATH]
+                           this repository's checkouts as Orca sees them: each
+                           one Orca tracks with its card status, live terminal
+                           count and agent states (`orca worktree ps`), and each
+                           git worktree Orca does not list. Exits 0 when Orca is
+                           absent or down and says so. `--json` prints the fold.
   tezgah-status --observable=consult,research,graph,orch
                            the measures this surface can see; a measure outside
                            the set renders as dim "no state" instead of claiming
@@ -200,6 +210,37 @@ def print_enforcers(as_json):
         print("unrecorded: %s" % failure)
 
 
+def print_orca(cwd, as_json):
+    """`--orca`: this repository's git checkouts against Orca's listing. A
+    checkout Orca does not list has no card, terminal tracking or agent status
+    in Orca: create the next one with `orca worktree create`, or show the
+    existing ones with `orca repo set --external-worktree-visibility show`."""
+    import tezgah_orca
+    from tezgah_paths import worktrees
+    if not tezgah_orca.cli():
+        print("orca CLI not found: nothing to track")
+        return 0
+    found = tezgah_orca.checkouts(worktrees(cwd) or [cwd])
+    if found is None:
+        print("orca runtime did not answer `orca worktree ps --json` "
+              "(start it with `orca open`)")
+        return 0
+    if as_json:
+        print(json.dumps(found))
+        return 0
+    print("Orca tracks %d checkout(s) of this repository:" % len(found["tracked"]))
+    for w in found["tracked"]:
+        print("  %s  [%s/%s] %d terminal(s) agents: %s" % (
+            w["path"], w["card"] or "-", w["status"] or "-", w["terminals"],
+            ", ".join(w["agents"]) or "-"))
+    if found["untracked"]:
+        print("not listed by Orca (raw `git worktree`; no card, terminals or "
+              "agent status there): %d" % len(found["untracked"]))
+        for path in found["untracked"]:
+            print("  %s" % path)
+    return 0
+
+
 def main():
     # `--` ends the options: what follows is PATH and SESSION_ID even when it
     # starts with a dash. The dsh route and the MCP tool hand caller-chosen
@@ -219,7 +260,7 @@ def main():
     pos = [a for a in args if not a.startswith("--")] + rest
     known = {"--legend", "--json", "--color", "--no-color", "--counters",
              "--all", "--trend", "--skill-fitness", "--failure-shapes",
-             "--rule-yield", "--enforcers", "--help"}
+             "--rule-yield", "--enforcers", "--orca", "--judge", "--help"}
     unknown = sorted(f for f in flags
                      if f not in known and not f.startswith("--observable="))
     if unknown:
@@ -252,6 +293,23 @@ def main():
         sys.stderr.write("tezgah-status: %s only means something with "
                          "--counters\n" % modifier)
         return 2
+    if "--judge" in flags:
+        import tezgah_judge as tj
+        last = tj.last_use()
+        if "--json" in flags:
+            print(json.dumps(last, sort_keys=True))
+        elif not last:
+            print("judge: no judgement recorded")
+        elif last.get("provider"):
+            print("judge: %s answered with %s/%s (fallback=%s)%s" % (
+                last.get("at"), last["provider"], last.get("model"),
+                last.get("policy"), "; not the session: " + last["fallback"]
+                if last.get("fallback") else ""))
+        else:
+            print("judge: %s no judgement (fallback=%s): %s; failed: %s" % (
+                last.get("at"), last.get("policy"),
+                last.get("refused") or "every provider failed", last.get("failed")))
+        return 0
     if "--skill-fitness" in flags:
         fit = skill_fitness()
         if "--json" in flags:
@@ -362,6 +420,9 @@ def main():
     if "--enforcers" in flags:
         print_enforcers("--json" in flags)
         return 0
+    if "--orca" in flags:
+        return print_orca(os.path.realpath(pos[0] if pos else os.getcwd()),
+                          "--json" in flags)
     cwd = os.path.realpath(pos[0] if pos else os.getcwd())
     session = pos[1] if len(pos) > 1 else os.environ.get("TEZGAH_SESSION")
     spec = next((f.split("=", 1)[1] for f in flags