@r1z4x/tezgah 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -6,6 +6,16 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [1.3.0] - 2026-10-07
+
+### Added
+
+- **Armed taste learns by itself.** Session start runs `tezgah-taste learn` in
+  the background when the repository's signals grew, at most once an hour. It
+  runs only when a TypeSafe key resolves, with the new `--no-fallback`, so it
+  asks no other provider. It does not run on Windows yet. Its log goes under
+  the cache dir, in `taste-learn/`.
+
 ## [1.2.0] - 2026-10-07
 
 ### Added
@@ -823,7 +833,8 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
   the copy could not find `hooks/` and died on import. It now links into the
   installed tree, and also installs the command as `tezgah`.
 
-[Unreleased]: https://github.com/r1z4x/tezgah/compare/v1.2.0...HEAD
+[Unreleased]: https://github.com/r1z4x/tezgah/compare/v1.3.0...HEAD
+[1.3.0]: https://github.com/r1z4x/tezgah/releases/tag/v1.3.0
 [1.2.0]: https://github.com/r1z4x/tezgah/releases/tag/v1.2.0
 [1.1.0]: https://github.com/r1z4x/tezgah/releases/tag/v1.1.0
 [1.0.0]: https://github.com/r1z4x/tezgah/releases/tag/v1.0.0

package/bin/tezgah-taste

@@ -5,7 +5,7 @@
   tezgah-taste measure --samples FILE --labels FILE [--model M] [--json]
   tezgah-taste rate --in MINED [--limit N] [--json]
   tezgah-taste learn [--repo DIR] [--from-transcripts] [--host omp|claude|all]
-                     [--limit N] [--json]
+                     [--limit N] [--no-fallback] [--json]
   tezgah-taste list [--repo DIR] [--all] [--json]
   tezgah-taste show|accept|reject ID [--repo DIR]
   tezgah-taste edit ID --text TEXT [--repo DIR]
@@ -701,7 +701,8 @@ def cmd_learn(args):
               "preference": 0, "defect": 0, "none": 0}
     tokens = [0, 0]
     for sig in todo:
-        dec, result = decide(sig, held(ledgers), fallback=sig["id"] not in decided)
+        dec, result = decide(sig, held(ledgers),
+                             fallback=not args.no_fallback and sig["id"] not in decided)
         if dec is None:
             counts["unanswered"] += 1
             continue
@@ -729,7 +730,9 @@ def cmd_learn(args):
     for lid, learning in tl.every(ledgers).items():
         if learning["state"] == "active" and lid not in before \
                 and not learning.get("written") and not learning.get("edited"):
-            line = write_line(learning)
+            # --no-fallback asks nothing of a generative provider: the user's
+            # own words stay the learning's line
+            line = None if args.no_fallback else write_line(learning)
             if line:
                 learning.update(text=" ".join(line.split())[:400], written=True)
     tl.save(repo, ledgers)
@@ -878,6 +881,8 @@ def main(argv):
     learn.add_argument("--from-transcripts", action="store_true")
     learn.add_argument("--host", choices=("omp", "claude", "all"), default="all")
     learn.add_argument("--limit", type=int)
+    learn.add_argument("--no-fallback", action="store_true",
+                       help="TypeSafe only: never pay another provider for a decision")
     listing = sub.add_parser("list")
     listing.add_argument("--all", action="store_true")
     for name in ("show", "accept", "reject", "edit"):

package/docs/clarity-baseline.json

@@ -60,7 +60,7 @@
     "semicolons": 18
   },
   "docs/judge.md": {
-    "long_sentences": 23,
+    "long_sentences": 22,
     "passive": 15,
     "replace_words": 0,
     "semicolons": 14

package/docs/judge.md

@@ -59,10 +59,13 @@ certificates, destructive data or history operations, privilege and security.
 The prompt-path skill hint sends the user's prompt through the same redactor. It
 also cuts the prompt at 2,000 characters (`PROMPT_MAX`,
 `hooks/tezgah_skill_pick.py::PROMPT_MAX`), because a prompt can quote a token and
-nobody chose to send it. Four of the callers are explicit -
-a person runs the tool - and the fifth, `bin/tezgah-route`, is what the
-ORCHESTRATE paragraph tells the router to run before every delegation, which is
-why its redaction is not optional. The switches below are the off buttons.
+nobody chose to send it. Three of the callers are explicit - a person runs
+the tool. `bin/tezgah-route` is what the ORCHESTRATE paragraph tells the router
+to run before every delegation, which is why its redaction is not optional.
+`bin/tezgah-taste learn` also starts by itself at session start once the user
+armed `taste-on`. It then sends redacted signal text to TypeSafe only, and only
+when a TypeSafe key resolves (`learn_later`, `hooks/tezgah_taste.py::learn_later`).
+The switches below are the off buttons.
 
 ## The five callers
 
@@ -78,7 +81,9 @@ The third caller is the one no shell row can see: it runs on the prompt path,
 caches one answer per `(session, prompt)` (`_remember`,
 `hooks/tezgah_skill_pick.py::_remember`; `suggest`,
 `hooks/tezgah_skill_pick.py::suggest`), and asks at all only when its own marker is
-armed. The other four are bin tools a session runs by name.
+armed. `bin/tezgah-triage`, `bin/tezgah-docs` and `bin/tezgah-route` are bin
+tools a session runs by name, and so is `bin/tezgah-taste`, except for the
+background `learn` that armed taste starts.
 
 ## The providers and their order
 

package/docs/operations.md

@@ -442,6 +442,14 @@ contradicts, narrows or unrelated. When another provider answers, `learn` writes
 the decision to `decisions.jsonl` as `unverified` and never applies it. A defect
 goes to `defects.jsonl` and never into the ledger.
 
+Armed taste also learns by itself. At session start, `learn` starts in the
+background when `signals.jsonl` grew since the last start, at most once an hour
+per repository (`learn_later`, `hooks/tezgah_taste.py::learn_later`). It runs
+with `--no-fallback` and only when a TypeSafe key resolves, so it never pays a
+generative provider for a decision it could not apply. It does not run on
+Windows, which has no ledger lock yet. The stamp and the log live under the
+cache dir, in `taste-learn/`.
+
 The ledger is `<repo>/.tezgah/taste/ledger.json`, plus
 `~/.config/tezgah/taste/ledger.json` for user-scope learnings
 (`hooks/tezgah_taste_ledger.py`). Confidence is (r+1)/(r+s+2) over supporting

package/hooks/tezgah_context.py

@@ -2202,6 +2202,14 @@ def context_for(event, cwd, payload=None, with_core=True):
                 taste = ""
             if taste:
                 parts.append(("taste", taste))
+        # Armed taste learns by itself: a detached `learn` when the signals grew,
+        # at most hourly (tezgah_taste.learn_later); session start only, with the
+        # root `enabled` already resolved above.
+        if taste_root and event == "session_start":
+            try:
+                tezgah_taste.learn_later(taste_root)
+            except Exception:
+                pass
         broken = tezgah_research.failing(root) if not off("research-off") else []
         if broken:
             line_slug, err = broken[0]

package/hooks/tezgah_taste.py

@@ -15,15 +15,24 @@ PostToolUse hot paths, so the switch is read before anything else is.
 
 Learning lives in `bin/tezgah-taste learn` and `tezgah_taste_ledger`; the one
 thing fed back from here is `write_note`, the learnings in scope for a write.
+`learn_later` starts that `learn` in the background at session start.
 """
 import datetime
 import json
 import os
+import re
+import subprocess
+import sys
+import time
 
 import tezgah_integrity as ti
+import tezgah_paths
 from tezgah_paths import _toplevel, armed, root_for, workspace_from_repo
 
 ARM = "taste-on"
+LEARN_EVERY = 3600  # seconds between two background `learn` starts per repo
+BIN = os.path.join(os.path.dirname(os.path.dirname(os.path.realpath(__file__))),
+                   "bin", "tezgah-taste")
 MARK = ".no-taste"
 VERSION = 1
 PROMPT_MAX = 2000
@@ -203,6 +212,48 @@ def write_note(session_id, inp, cwd, tool=None):
         return ""
 
 
+def learn_later(root):
+    """Start `tezgah-taste learn --repo <root> --no-fallback` detached when the
+    signals of `root` (the git root `enabled` returned) grew since the last
+    start and an hour has passed. Only when TypeSafe resolves: the automatic run
+    never pays a generative provider for a decision it may not apply. Not on a
+    machine without flock (Windows), where two background runs in two
+    repositories would race on the user ledger. ponytail: no Windows lock; add
+    one (msvcrt.locking) before enabling it there. Total; the stamp is written
+    before the spawn, so a failed start waits an hour."""
+    try:
+        if not root:
+            return
+        size = os.path.getsize(os.path.join(root, ".tezgah", "taste", "signals.jsonl"))
+        base = os.path.join(tezgah_paths.cache_dir(), "taste-learn")
+        name = re.sub(r"[^A-Za-z0-9]+", "-", root).strip("-")
+        stamp = os.path.join(base, name + ".json")
+        try:
+            with open(stamp, encoding="utf-8") as fh:
+                last = json.load(fh)
+        except (OSError, ValueError):
+            last = {}
+        now = time.time()
+        if size <= last.get("size", -1) or now - last.get("at", 0) < LEARN_EVERY:
+            return
+        # the costlier checks run only once a start is due: at most hourly
+        import tezgah_judge
+        import tezgah_taste_ledger
+        if tezgah_taste_ledger.fcntl is None or tezgah_paths.off("judge-off") \
+                or not tezgah_judge.named(("typesafe",)):
+            return
+        os.makedirs(base, exist_ok=True)
+        with open(stamp, "w", encoding="utf-8") as fh:
+            json.dump({"size": size, "at": now}, fh)
+        with open(os.path.join(base, name + ".log"), "ab") as log:
+            subprocess.Popen([sys.executable, BIN, "learn", "--repo", root,
+                              "--no-fallback"],
+                             cwd=root, stdin=subprocess.DEVNULL, stdout=log,
+                             stderr=log, start_new_session=True)
+    except Exception:
+        pass
+
+
 def main(argv):
     """`tezgah_taste.py '<json>'`: `note_write`, then `write_note`, for a host
     that cannot call them in process (opencode's plugin is JavaScript). The one
@@ -223,5 +274,4 @@ def main(argv):
 
 
 if __name__ == "__main__":
-    import sys
     sys.exit(main(sys.argv[1:]))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@r1z4x/tezgah",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "One shared working contract for every AI coding assistant you run: Claude Code, Codex, Cursor, opencode, dsh and oh-my-pi (omp).",
   "license": "MIT",
   "repository": {