Latest fab-kit version

Author: sahil87

fab/.kit-migration-version

@@ -1 +1 @@
-2.6.0
+2.13.2

fab/project/config.yaml

@@ -1,36 +1,71 @@
+# Full reference of all available options: fab config reference
 agent:
-  spawn_command: claude --dangerously-skip-permissions --effort xhigh -n "$(basename "$(pwd)")"
-  # agent.tiers — per-stage model override (optional). A "tier" is a named
-  # {model, effort} profile. fab-kit owns the FIXED, non-overridable stage→tier
-  # mapping below; you override only WHAT EACH TIER MEANS (model + effort).
-  # Omit any tier (or the whole tiers: block) to use fab-kit's built-in default.
-  # Resolved per stage by `fab resolve-agent <stage>` at sub-agent dispatch time.
-  # See docs/specs/stage-models.md.
-  #
-  # FIXED stage→tier mapping (fab-owned, NOT overridable — shown for reference):
-  #   thinking: intake, review            (generative judgment)
-  #   doing:    apply, review-pr, hydrate  (execution that must not err)
-  #   fast:     ship                       (speed on near-mechanical work)
-  #
-  # fab-kit's built-in default profiles (today):
-  #   thinking: { model: claude-opus-4-8,   effort: xhigh }
-  #   doing:    { model: claude-opus-4-8,   effort: high  }
-  #   fast:     { model: claude-sonnet-4-6, effort: low   }
-  #
-  # Override shape (uncomment + edit any tier; an omitted field inherits the
-  # default for that tier; an empty model means "inherit the session model";
-  # values are passed through verbatim — fab does no provider validation):
-  # tiers:
-  #   doing: { model: claude-sonnet-4-6, effort: medium }   # example: run doing cheaper
+    # agent.tiers.<tier>.spawn_command — per-stage CLI dispatch (optional, opt-in).
+    # PRESENT on a tier → that tier's stages are dispatched by RUNNING this command
+    # (cross-harness, e.g. codex); ABSENT → native Agent-tool dispatch (default).
+    # INDEPENDENT of agent.spawn_command above (which opens whole agent SESSIONS):
+    # there is NO fallback from a tier to agent.spawn_command. {model}/{effort}
+    # placeholders are substituted at resolve time (the {model} always the FULL
+    # model ID, never an alias). See: fab config reference.
 checklist:
-  extra_categories: []
-fab_version: 2.6.6
+    extra_categories: []
+# providers — named agent invocation grammars. Each provider MAY carry a
+# session_command (opens an interactive session: fab operator / fab batch /
+# fab agent) and/or a dispatch_command (runs one headless stage task via fab
+# dispatch, which pipes the stage prompt to the command's STDIN; ABSENT →
+# native Agent-tool dispatch). The two are NOT merged. {model}/{effort}
+# placeholders are substituted from the resolved tier profile; a plain Claude
+# command has --model/--effort appended instead. Provider names are opaque,
+# user-chosen strings. See: fab config reference.
+#
+# claude is the built-in default (session_command shown live). codex and gemini
+# are a commented starter TEMPLATE — uncomment and adapt to add that provider.
+# Anything whose uncommenting changes default behavior ships commented: claude's
+# dispatch_command (flips claude native→headless CLI dispatch) and the opt-in
+# codex/gemini blocks.
+#
+# Per-provider notes (kept out of the blocks below so uncommenting a whole block
+# yields valid YAML — strip the leading '# ' from every line of a block):
+#   claude.dispatch_command — claude -p reads the prompt from stdin; uncommenting
+#     runs claude's stages as headless CLI processes instead of native sub-agents.
+#   codex — codex exec reads the prompt from stdin. Substitute a current model ID
+#     for {model} (e.g. gpt-5.3-codex); {model}/{effort} come from the tier.
+#   gemini — no {effort} (the gemini CLI has no reasoning-effort flag) and no -p:
+#     gemini's -p takes prompt TEXT (appended after stdin), whereas fab dispatch
+#     pipes the prompt to stdin, which gemini reads as the prompt in non-TTY mode.
+providers:
+    claude:
+        session_command: claude --dangerously-skip-permissions --effort xhigh -n "$(basename "$(pwd)")"
+        # dispatch_command: 'claude -p --dangerously-skip-permissions --model {model} --effort {effort}'
+    # codex:
+    #     session_command: 'codex -m {model} -c model_reasoning_effort={effort}'
+    #     dispatch_command: 'codex exec -m {model} -c model_reasoning_effort={effort}'
+    # gemini:
+    #     session_command: 'gemini -m {model}'
+    #     dispatch_command: 'gemini -m {model}'   # no {effort} flag; no -p (fab dispatch pipes the prompt to stdin)
+fab_version: 2.13.4
 project:
-  description: Go CLI for quick repo operations — locate, open, list, and clone repos from hop.yaml.
-  name: hop
+    description: Go CLI for quick repo operations — locate, open, list, and clone repos from hop.yaml.
+    name: hop
 source_paths:
-  - cmd
-  - internal
+    - cmd
+    - internal
+# Glob/pathspec patterns identifying test files. Used by the true-impact
+# breakdown to attribute lines to tests vs. implementation (impl = total − tests).
+# Language-specific — no kit default. Patterns are :(glob) magic pathspecs, so
+# `**` matches across directories and `*` does NOT match `/`. Anchor to your
+# language's test convention rather than a bare substring (a substring like
+# `*test*` miscounts production code such as `attestation.go` or `latest.go`).
+# When absent/empty, the breakdown collapses to a single total line.
+#
+# Examples (uncomment/adapt the line for your stack):
+#   - "**/*_test.go"                  # Go   — `_test.go` suffix
+#   - "**/test_*.py"                  # Python (pytest) — `test_` prefix
+#   - "**/*.spec.ts"                  # JS/TS (Jest/Vitest) — `.spec` infix
+#   - "**/*.test.ts"                  # JS/TS — `.test` infix
+#   - "**/src/test/**"                # Java/Kotlin (Maven/Gradle) — test source root
+test_paths:
+    - "**/*_test.go"
 true_impact_exclude:
-  - fab/
-  - docs/
+    - fab/
+    - docs/