dispatch-check: add completeness guard + agentStop hook

- codifide dispatch-check subcommand: flags orphaned readouts
  (Quill .readout.md without paired Glyph .yaml) and missing
  session-close pairs for today's date
- agentStop hook: runs dispatch-check automatically when the
  agent stops; prompts to file missing artifacts if gaps found
- Prevents Quill and Glyph from silently leaving incomplete
  dispatch pairs at session end

Author: Douglas Jones

.kiro/hooks/dispatch-completeness-check.kiro.hook

@@ -0,0 +1,13 @@
+{
+  "enabled": true,
+  "name": "Dispatch Completeness Check",
+  "description": "When the agent stops, check that every Quill readout has a paired Glyph YAML and that today's session has a session-close pair. If gaps are found, prompt the agent to file the missing artifacts before the session ends.",
+  "version": "1",
+  "when": {
+    "type": "agentStop"
+  },
+  "then": {
+    "type": "askAgent",
+    "prompt": "Run `python3 -m codifide dispatch-check` and report the result. If it exits non-zero, file all missing dispatch artifacts before this session is considered complete. Every Quill readout (.readout.md) needs a paired Glyph YAML (.yaml). Every session that filed dispatches needs a session-close.readout.md and session-close.yaml pair. Do not end the session with gaps outstanding."
+  }
+}

codifide/__main__.py

@@ -562,6 +562,79 @@ def cmd_dispatch_index(args: argparse.Namespace) -> int:
     return 0
 
 
+def cmd_dispatch_check(args: argparse.Namespace) -> int:
+    """Check dispatch stream completeness — flag orphaned readouts and missing pairs.
+
+    Every Quill readout (.readout.md) should have a paired Glyph YAML (.yaml).
+    Every session date should have a session-close pair.
+    Proposals that have a readout but no YAML are flagged.
+
+    Exits 0 if complete, 1 if gaps found. Designed to run as an agentStop
+    hook so Quill and Glyph don't fall asleep on the job.
+    """
+    from pathlib import Path as _Path
+    from .dispatch_index import _collect_entries
+
+    repo_root = _Path(__file__).resolve().parent.parent
+    dispatch_dir = repo_root / "dispatches"
+    if not dispatch_dir.exists():
+        return 0
+
+    entries = _collect_entries(dispatch_dir)
+    gaps = []
+
+    for e in entries:
+        # A readout without a paired YAML is an orphan.
+        # Exception: standalone .md dispatches (audit notes, journals)
+        # that were never intended to have a YAML pair are fine — they
+        # show up with readout_path but no yaml_path AND their slug
+        # doesn't end in a pattern that implies a pair is expected.
+        # We flag it if the readout path ends in .readout.md (explicit
+        # Quill output) but no YAML exists.
+        if (
+            e.readout_path
+            and e.readout_path.endswith(".readout.md")
+            and not e.yaml_path
+        ):
+            gaps.append(
+                f"  ORPHAN  {e.date}-{e.slug}: "
+                f"readout exists but no paired Glyph YAML"
+            )
+
+        # A YAML without a readout is unusual but not always wrong
+        # (some Glyph dispatches are standalone). Don't flag these.
+
+    # Check for session-close pair on any date that has other dispatches.
+    dates_with_dispatches = {e.date for e in entries}
+    dates_with_close = {
+        e.date for e in entries
+        if e.slug == "session-close" and e.readout_path and e.yaml_path
+    }
+    # Only flag today's date if it has dispatches but no close pair —
+    # past sessions are already closed.
+    import datetime
+    today = datetime.date.today().isoformat()
+    if today in dates_with_dispatches and today not in dates_with_close:
+        gaps.append(
+            f"  MISSING {today}-session-close: "
+            f"dispatches filed today but no session-close pair"
+        )
+
+    if gaps:
+        print("codifide dispatch-check: gaps found:")
+        for g in gaps:
+            print(g)
+        print(
+            "\nFile the missing artifacts before ending the session. "
+            "Every Quill readout needs a paired Glyph YAML. "
+            "Every session needs a session-close pair."
+        )
+        return 1
+
+    print("codifide dispatch-check: all dispatch pairs complete.")
+    return 0
+
+
 def _default_entry(module) -> str:
     # If there's only one definition, use it; else prefer `main`.
     if len(module.symbols) == 1:
@@ -639,6 +712,12 @@ def main(argv=None) -> int:
     )
     p_dispatch_index.set_defaults(func=cmd_dispatch_index)
 
+    p_dispatch_check = sub.add_parser(
+        "dispatch-check",
+        help="check dispatch stream completeness — flag orphaned readouts and missing pairs",
+    )
+    p_dispatch_check.set_defaults(func=cmd_dispatch_check)
+
     # Symbol store. A store root can be passed via --store or the
     # CODIFIDE_STORE environment variable; defaults to ~/.codifide/store.
     p_store = sub.add_parser(