gennady 0.7.0 → 0.8.0

package/dist/ai/skills/sdd-execute/scripts/verify.sh

@@ -0,0 +1,139 @@
+#!/usr/bin/env bash
+# @file: Smart verification gate — auto-discovers npm scripts via heuristic, runs them.
+# @consumers: phase agents (STEP_5_VERIFY); orchestrators; CI hooks
+# @contract: AX_BASH_NO_SILENT_EMPTY. All discovered gates MUST pass for exit 0.
+#            RUN-ALL: every gate executes regardless of previous failures.
+#            SUPPRESS-ON-SUCCESS: passing gates produce zero output; only failures are shown.
+#            On all-pass: single line "[verify] ALL_GATES_PASS (N/N)". Exit 0.
+#            On any-fail: each failed gate dumps its command + exit code + captured output. Exit 1.
+#
+# Usage:
+#   verify.sh <file1> [<file2> ...]
+#
+# Exit codes:
+#   0  — all gates PASS
+#   1  — one or more gates failed
+#   4  — bad invocation
+#   5  — environment failure
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROG="verify"
+
+# -----------------------------------------------------------
+# Preflight
+# -----------------------------------------------------------
+
+if [[ $# -lt 1 ]]; then
+  cat <<EOF
+[$PROG] BAD_INVOCATION
+  expected: $PROG <file1> [<file2> ...]
+  got:      $PROG (no args)
+EOF
+  exit 4
+fi
+
+if ! command -v npm &>/dev/null; then
+  echo "[$PROG] ENV_MISSING: npm not in PATH"
+  exit 5
+fi
+
+if ! command -v node &>/dev/null; then
+  echo "[$PROG] ENV_MISSING: node not in PATH"
+  exit 5
+fi
+
+for file in "$@"; do
+  if [[ ! -f "$file" ]]; then
+    echo "[$PROG] FILE_NOT_FOUND: $file"
+    exit 4
+  fi
+done
+
+# -----------------------------------------------------------
+# Step 1: Discover scripts via heuristic (silent)
+# -----------------------------------------------------------
+
+CLASSIFIER="$SCRIPT_DIR/classify-scripts.js"
+
+if [[ ! -f "$CLASSIFIER" ]]; then
+  echo "[$PROG] ENV_MISSING: classify-scripts.js not found at $CLASSIFIER"
+  exit 5
+fi
+
+classification=$(node "$CLASSIFIER" 2>/dev/null) || {
+  echo "[$PROG] ENV_FAIL: classify-scripts.js failed"
+  exit 5
+}
+
+# Extract selected scripts: "cls:name" lines
+discovered=$(echo "$classification" | python3 -c "
+import json,sys
+d=json.load(sys.stdin)
+sel=d.get('selected',{})
+for cls in ['typecheck','gennady','lint','test','format']:
+    v=sel.get(cls,'')
+    if v:
+        print(f'{cls}:{v}')
+" 2>/dev/null)
+
+if [[ -z "$discovered" ]]; then
+  echo "[$PROG] NO_SCRIPTS_DISCOVERED"
+  exit 0
+fi
+
+# -----------------------------------------------------------
+# Step 2: Run each gate — accumulate failures, suppress success
+# -----------------------------------------------------------
+
+total=0
+passed=0
+failures=""
+FILES=("$@")  # save original file args for file-specific commands
+
+run_cmd() {
+  local label="$1"
+  local display_name="$2"
+  shift 2
+  local cmd=("$@")
+
+  total=$((total + 1))
+
+  local output exit_code
+  set +e
+  output=$("${cmd[@]}" 2>&1)
+  exit_code=$?
+  set -e
+
+  if [[ $exit_code -eq 0 ]]; then
+    passed=$((passed + 1))
+    return 0
+  else
+    failures+=$(printf '\n[%s] ❌ FAIL gate: %s\n  command: %s\n  exit:    %s\n\n--- captured output ---\n%s\n--- end ---\n' "$PROG" "$label" "${cmd[*]}" "$exit_code" "$output")
+    return 1
+  fi
+}
+
+# Run ALL gates regardless of failures
+while IFS=: read cls name; do
+  case "$cls" in
+    typecheck) run_cmd "typecheck" "npm run $name" npm run "$name" || true ;;
+    gennady)   run_cmd "gennady DBC lint" "gennady lint ${#FILES[@]} files" npx tsx ~/Developer/gennady/cli/gennady.ts lint "${FILES[@]}" || true ;;
+    lint)      run_cmd "lint" "npm run $name" npm run "$name" || true ;;
+    test)      run_cmd "test" "npm run $name" npm run "$name" || true ;;
+    format)    run_cmd "format check" "npm run $name" npm run "$name" || true ;;
+  esac
+done <<< "$discovered"
+
+# -----------------------------------------------------------
+# Report: suppressed on success, full on failure
+# -----------------------------------------------------------
+
+if [[ -n "$failures" ]]; then
+  echo "$failures"
+  exit 1
+fi
+
+echo "[$PROG] ALL_GATES_PASS ($passed/$total)"
+exit 0

package/dist/ai/skills/sdd-execute-batch/SKILL.md

@@ -0,0 +1,213 @@
+---
+name: sdd-execute-batch
+description: Orchestrate batch task execution. For each task: plan phases from its Phases Overview → dispatch one phase-subagent per phase (sequential within task; parallel across tasks in same sub-batch when file sets disjoint) → close Round → dispatch audit-subagent (fresh-eyes) → optional selective phase re-run on audit FAIL. Use for "выполни всю очередь" / "execute pickable tasks". Optional epic-level audit across batch.
+license: MIT
+compatibility: opencode
+---
+
+<SddExecuteBatchOrchestrator role="orchestrator-only">
+You are the BATCH ORCHESTRATOR. You PLAN the queue, manage layered parallelism, dispatch phase-subagents and audit-subagents in fresh contexts, thread typed Handoff payloads within each task. You do NOT operate under any execution directive yourself.
+
+**Environment: macOS.** All bash commands dispatched to subagents must be macOS-compatible. No `grep -P` → use `rg`. No GNU-only flags.
+
+You DO read each ticket's PLANNING SURFACE: section 1 Meta, section 2 Phases Overview, current Round of section 7 Execution Log. You do NOT read section 3 Phases bodies, section 4 BDD, section 5 Verification, section 6 Coverage — those are read by phase-subagents.
+
+Each subagent runs in a FRESH ISOLATED CONTEXT.
+
+<Inputs>
+Args from operator may be:
+- empty / "next" / "все" / "all pickable" → full pickable queue from tasks/README.md.
+- explicit list "TSK-04 TSK-05 TSK-06" → use that exact list (verify each exists).
+- "domain:<name>" → all tickets in tasks/<name>/.
+- "tasks/<scope>/<scope>.task-NN.md" → single task path resolved to ID.
+
+Optional flag: `epic-only` → skip per-task audits, run ONE epic-level audit at end. Default = per-task audit + optional epic at end.
+</Inputs>
+
+<ProgressReporting>
+Black-box: subagents are opaque. Emit progress at state transitions the orchestrator owns (queue confirmation, layer/sub-batch boundaries, phase dispatch, phase return, audit, retry, batch end).
+
+Format: `[<bar>] <pct>% | <done>/<total> | Layer L/Ltotal | <event>`
+
+Per-task phase tokens:
+
+- `TSK-NN: P<N> (<kind>) 🏃‍♂️‍➡️` — phase actively executing
+- `TSK-NN: P<N> ✅` — phase done; orchestrator threads Handoff to next phase
+- `TSK-NN: ✅ all phases → 🔍 audit`
+- `TSK-NN: ✅ audit PASS`
+- `TSK-NN: ❌ audit FAIL → 🔄 fix phases <list>`
+- `TSK-NN: ❌ FAIL after 2 attempts`
+  </ProgressReporting>
+
+<Protocol>
+1. **Collect working set:**
+   - Read tasks/README.md Tracker Index.
+   - Scan tasks/**/*.task-*.md **planning surface only** — section 1 Meta (up to `## 2.`) + section 2 Phases Overview (up to `## 3.`). Typically first 40-60 lines per ticket. Do NOT read full files.
+   - Working set = ALL `[ ] TODO` tickets (regardless of whether deps are DONE yet — future layers must be planned too).
+   - Also collect: `[x] DONE` set (for dep-resolution context) and `[~] IN_PROGRESS` / `[!] BLOCKED` set (excluded from batch but reported in summary).
+   - Filter by operator args (explicit list / domain scope / etc.).
+   - Empty working set → halt: "No TODO tasks in scope. State: <N DONE, M IN_PROGRESS, K BLOCKED>".
+
+2.  **Plan execution layers (full forward DAG, not just Layer 0):**
+    Build a layered DAG over the WHOLE working set. The orchestrator does this analysis itself reading **planning surface ONLY** (Dependencies + Phases Overview to compute aggregate Target Files for conflict analysis). No subagent for planning.
+
+    Algorithm:
+    a. **Topological layers by explicit Task Dependencies** (entire working set):
+    - Layer 0 = tasks where every Dependency is in `[x] DONE` set.
+    - Layer L+1 = tasks where every Dependency is either DONE OR placed in layers ≤ L.
+    - Tasks with deps on IN_PROGRESS / BLOCKED tickets → marked `⏸️ waiting` and excluded from the layer plan.
+      b. **File-conflict split within each layer:**
+    - For each task in layer, aggregate file set = union of ALL its phases' `Target Files` (read from each phase block — minimal extra read).
+    - Two tasks in same layer with overlapping aggregate file sets → cannot run in parallel.
+    - Greedy split: assign tasks to parallel sub-batches such that no two tasks in a sub-batch share files. Conflict → push to next sub-batch within same layer.
+    - Result: each layer = list of sub-batches; sub-batches within a layer run sequentially; tasks within a sub-batch run in parallel.
+
+    Cycle detection: working set with unresolved deps after all layering → cycle. Halt with explicit cycle path.
+
+    **Preflight: blocker scan** (per `AX_BLOCKER_RESOLUTION_TRAIL`). For each ticket in working set, run `~/Developer/gennady/ai/skills/sdd-execute/scripts/sdd check-blockers <ticket>` (skill helper scripts ship with the sibling `sdd-execute` skill). Any ticket with unresolved blockers → mark `✋ AWAITING UNBLOCK` (NOT failed); exclude from batch dispatch with explicit list of pending decisions. Distinguish in summary from `❌ FAILED` tasks.
+
+3.  **Show full plan to operator:**
+
+    ```
+    📋 Execution Plan
+
+    Already ✅ DONE: <N> tasks (<list of TSK-NN, max 8 shown then "…">)
+
+    Layer 0 [parallel, 3 tasks]:
+      TSK-01 — Implement port A  | deps: none          | phases: P1 impl, P2 test
+      TSK-02 — Implement port B  | deps: none          | phases: P1 impl, P2 test
+      TSK-03 — Implement port C  | deps: none          | phases: P1 impl, P2 test
+
+    Layer 1 [parallel, 2 tasks]:
+      TSK-04 — Compose AB        | deps: TSK-01,TSK-02 | phases: P1 impl, P2 test
+      TSK-05 — Compose AC        | deps: TSK-01,TSK-03 | phases: P1 impl, P2 test
+
+    Layer 2 [serial, 2 tasks — file conflict on src/shared.ts]:
+      sub-batch a: TSK-07        | deps: TSK-04        | phases: P1 refactor
+      sub-batch b: TSK-06        | deps: TSK-04,TSK-05 | phases: P1 refactor
+
+    ⏸️ Waiting (excluded):
+      TSK-08 — ...               | waiting on TSK-99 (IN_PROGRESS elsewhere)
+
+    📊 Total: 7 TODO tasks across 3 layers. Max parallelism: 3. Audit mode: per-task.
+    ```
+
+    Ask: "Start batch? [yes / re-plan / cancel / set audit mode / restrict to Layer N]". Wait for confirmation.
+
+4.  **Dispatch loop** (Layer → sub-batch → parallel tasks; within each task — sequential phase loop):
+
+    For each Layer L (sequential between layers):
+    For each sub-batch S in Layer L (sequential between sub-batches):
+    For each task in sub-batch S — START PER-TASK ORCHESTRATION IN PARALLEL:
+
+        Per-task orchestration (run as a single inline loop the batch orchestrator manages; one "virtual lane" per task):
+
+          For each phase in task's Phases Overview (sequential within task):
+             a. Dispatch PHASE subagent (`subagent_type: general-purpose`, **`model: "sonnet"`** — phase work requires capable code-generation model), fresh context, with prompt:
+                ```
+                Step 1 — Read the directive. Use Read tool directly on:
+                  ai/directives/sdd/phase-execution-protocol.xml
+                  On failure → halt, report exact path.
+
+                Step 2 — Activate. Announce: "🔒 DIRECTIVE ACTIVATED: SddPhaseExecution"
+                  You ARE this directive.
+
+                Step 3 — Apply to intent.
+                  Ticket: <absolute ticket path>
+                  Phase: <P<N>>, kind: <kind>
+                  Reason: <"initial" | "fix: address audit findings F-NNN" | "resume after blocker">
+                  Inputs: <verbatim prior Handoff lines OR "none — first phase">
+                  SDD tooling available at: ~/Developer/gennady/ai/skills/sdd-execute/scripts/sdd
+                    (run "~/Developer/gennady/ai/skills/sdd-execute/scripts/sdd help" for surface;
+                     use for any extraction/lint/verify operations the directive references).
+
+                  Follow the directive. This ONE phase only. Do not invoke audit.
+                ```
+
+            b. Branch on phase status:
+               - `BLOCKED` or `FAIL` → STOP this task's lane; mark task FAILED for the batch. Other parallel tasks in same sub-batch continue.
+               - `DONE` → record Handoff (artifacts, decisions, open). Continue to next phase.
+
+            c. Thread next phase's Inputs from this phase's Handoff (verbatim).
+
+          After all phases DONE: close Round (append `#### Round close` block: sync + DONE). Sync trackers. Ticket Status → `[x] DONE`.
+
+           d. Dispatch AUDIT subagent (`subagent_type: general-purpose`, **`model: "haiku"`** — audit is mechanical verification + fact-checking, haiku sufficient and cheaper). MANDATORY, always runs. Include in prompt the SDD tooling location: `~/Developer/gennady/ai/skills/sdd-execute/scripts/sdd` (audit may use `lint`, `verify`, `check-blockers` subcommands):
+              ```
+              Step 1 — Read the directive. Use Read tool directly on:
+                ai/directives/sdd/audit.directive.xml
+                On failure → halt, report exact path.
+
+              Step 2 — Activate. Announce: "🔒 DIRECTIVE ACTIVATED: SddAudit"
+                You ARE this directive. Operate under its Mission, Belief_State, Halt_Conditions, Execution_Plan, Output_Contracts.
+
+              Step 3 — Apply to intent.
+                Task: <TSK-NN>
+                Ticket: <absolute ticket path>
+                Round: <N>
+                Artifacts: <union of all phase Handoff artifacts>
+                Mode: per-task
+
+                Follow the directive's Execution_Plan. Report findings per AUDIT_SESSION_SUMMARY_FORMAT.
+              ```
+              Wait for return. If dispatch fails → retry once. If fails again → mark task FAILED.
+
+          e. Branch on audit status:
+             - `PASS` / `PASS_WITH_ACKNOWLEDGED_RISKS` → task complete; continue lane (next task in batch).
+             - `FAIL` AND `audit_attempt = 1` → trigger selective phase re-run.
+               Open new Round with reason `audit-driven fix: F-NNN, F-MMM`.
+               For each phase in `phases_to_fix` (sequential, declared order subset):
+                 Dispatch PHASE subagent with `Reason: fix: address audit findings F-NNN, F-MMM` and audit findings list in Inputs. Wait.
+                 On BLOCKED/FAIL → STOP this task's lane; mark task FAILED.
+               After all fix phases DONE → close Round → dispatch AUDIT (round 2, fresh context). Branch again:
+                 PASS → task complete.
+                 FAIL (audit_attempt = 2) → STOP lane; mark task FAILED.
+
+         — Wait for all parallel task lanes in sub-batch to finish.
+         — Any task FAILED → continue batch (other layers may not depend on it; if they do they'll be marked `⏸️ waiting`). Operator gets failure list in final summary.
+
+5.  **End of batch:**
+
+    Dispatch ONE verification check across all completed tasks:
+
+    ```
+    Verify for scope <scope>:
+    1. Read tasks/<scope>/README.md — confirm all task statuses match their tickets' Meta Status.
+    2. Read tasks/README.md Tracker Index — confirm aggregate counts match.
+    3. If mismatches found → fix sync directly.
+    ```
+
+6.  **Final summary table:**
+
+    ```
+    📊 Batch Summary
+
+    | Task-ID | Phases | Audit (round) | 🔄 phases_fixed | Final | Files |
+    |---|---|---|---|---|---|
+    | TSK-04 | P1✅ P2✅ | ✅ R1 | — | ✅ PASS | 2 |
+    | TSK-05 | P1✅ P2✅ | ❌→✅ R2 | P2 | ✅ PASS | 1 |
+    | TSK-06 | P1✅ P2❌ | — | — | ❌ phase-FAIL | 0 |
+
+    📊 ✅ <N> · 🔄 <R> · ❌ <F> · 🛑 <B> · ⏸️ waiting <S>
+
+    🔍 Epic audit (if run): <✅ PASS | ❌ FAIL — 🔴 N cross-task findings>
+    ```
+
+    Any audit = FAIL → recommend `/sdd-execute <TSK-NN>` for targeted re-run.
+    </Protocol>
+
+<HardForbidden>
+- Reading phase-execution-protocol.xml or audit.directive.xml yourself. (Subagents do.)
+- Reading full ticket files (sections 3 bodies, 4 BDD, 5 Verification, 6 Coverage). During planning, read ONLY sections 1 + 2 + 7-current-Round.
+- Writing code or phase blocks in Execution Log. (Phase subagents do.)
+- Sharing context between phase subagents of different tasks. Each lane is isolated; orchestrator threads only typed Handoffs within ONE task's lane.
+- Skipping audit after Round close in default (per-task) mode. Audit dispatch is mandatory.
+- Audit retry beyond 2 total attempts per task. Hard cap.
+- Re-running phases not flagged in `phases_to_fix`. The map finding-location → phase is the contract.
+- Parallel dispatch ACROSS layers. Layers run sequentially.
+- Parallel dispatch ACROSS sub-batches in same layer. Sub-batches exist exactly because of file conflicts.
+- Parallel dispatch ACROSS phases of the SAME task. Phases are sequential by declared Deps within a task. Cross-task parallelism is the legitimate use of parallel sub-batches.
+- Auto-reopening on phase BLOCKED/FAIL within a task. Only on audit FAIL after Round close the selective phase retry kicks in (max once per task).
+- Skipping the planning step. Even for 2-task batches the orchestrator MUST emit the layer plan and ask for confirmation.
+</HardForbidden>
+</SddExecuteBatchOrchestrator>

package/dist/ai/skills/sdd-fix/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: sdd-fix
+description: Take findings (code review, sdd-check, audit output, bug report), classify, plan, agree with operator, execute fixes, reopen tasks, dispatch execution, verify. Use for "исправь", "почини", "fix", "sdd-fix", after code review or sdd-check.
+compatibility: opencode
+---
+
+1. **Extract intent.** Parse findings from operator's context — code review, sdd-check output, audit summary, bug report. If no findings → HALT with explicit ask.
+
+2. **Load & activate directive.** Read in full: `~/Developer/gennady/ai/directives/sdd/fix.directive.xml`
+   Announce: `🔒 DIRECTIVE ACTIVATED: SddFix`
+   You ARE this directive now.
+
+3. **Apply directive to intent.** Pass parsed findings. Follow Execution_Plan: classify → plan → agree → execute → dispatch → verify.

package/dist/ai/skills/sdd-infra/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: sdd-infra
+description: Design or evolve an infrastructure scope — package manager, type-checker, linter, formatter, test runner, git hooks, CI. Scope-type=infrastructure discovery session. Use for bootstrapping tooling for a new infra scope (infra-base, infra-golang, infra-frontend) or pivoting/extending an existing one.
+compatibility: opencode
+---
+
+1. **Extract intent.** Operator wants to bootstrap or evolve infrastructure scope. Scope-type is fixed: `infrastructure`. Resolve scope name from intake.
+
+2. **Load & activate directive.** Read in full: `~/Developer/gennady/ai/directives/sdd/discovery.directive.xml`
+   Announce: `🔒 DIRECTIVE ACTIVATED: SddDiscovery | infrastructure`
+   You ARE this directive now.
+
+3. **Apply directive to intent.** Force scope-type=`infrastructure`. Mode auto-detected per `AX_MODE_AUTO_DETECT_OR_HALT`. Follow Execution_Plan end-to-end.

package/dist/ai/skills/sdd-module-decomposition/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: sdd-module-decomposition
+description: Decompose a product or library scope into module specs with closed-world entity inventory, public surfaces, DbC contracts (Ports / Adapters / Services). Only applicable to scope-type=product and scope-type=library. Modes auto-detected: initial, add-module, refine-module.
+compatibility: opencode
+---
+
+1. **Extract intent.** Operator wants to decompose scope `<name>` into modules. Verify scope-type ∈ {product, library} — infrastructure / contracts forbidden.
+
+2. **Load & activate directive.** Read in full: `~/Developer/gennady/ai/directives/sdd/module-decomposition.directive.xml`
+   Announce: `🔒 DIRECTIVE ACTIVATED: SddModuleDecomposition`
+   You ARE this directive now.
+
+3. **Apply directive to intent.** Mode auto-detected per `AX_MODE_AUTO_DETECT_OR_HALT`. Follow Execution_Plan end-to-end. Do not deviate.

package/dist/ai/skills/sdd-scaffold/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: sdd-scaffold
+description: Decompose specs (root + domain + infra) into a DAG of compact task tickets ready for autonomous execution by sdd-execute orchestrator. Materializes Cascade Table, Tracker Index, BDD scenarios, Phases Overview + per-phase Rules. Use for first task generation from spec tree, or scaffolding tasks for a new/refined domain. Modes auto-detected: initial, extend-dag.
+compatibility: opencode
+---
+
+1. **Extract intent.** Operator wants to scaffold tasks for {scope | all scopes}. Mode: `initial` (no `tasks/` yet) or `extend-dag` (`tasks/` exists, adding to it).
+
+2. **Load & activate directive.** Read in full: `~/Developer/gennady/ai/directives/sdd/scaffold.directive.xml`
+   Announce: `🔒 DIRECTIVE ACTIVATED: SddScaffold`
+   You ARE this directive now.
+
+3. **Apply directive to intent.** Mode auto-detected per `AX_MODE_AUTO_DETECT_OR_HALT`. Follow Execution_Plan end-to-end. Do not deviate.

package/dist/ai/skills/sdd-setup/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: sdd-setup
+description: Initialize or update the project portal (specs/README.md) — Vision, Scope Graph, and Scopes table. This is the sole owner of the project portal. Idempotent: run any number of times to add scopes, update vision, or bootstrap infra-base. Always run this first for a brand new project.
+compatibility: opencode
+---
+
+1. **Extract intent.** Operator wants to initialize or update the project portal. Operation may be: bootstrap new project, add a scope to Scope Graph, update Vision, sync after discovery.
+
+2. **Load & activate directive.** Read in full: `~/Developer/gennady/ai/directives/sdd/setup.directive.xml`
+   Announce: `🔒 DIRECTIVE ACTIVATED: SddSetup`
+   You ARE this directive now.
+
+3. **Apply directive to intent.** Mode auto-detected per `AX_IDEMPOTENT_MODES`. Follow Execution_Plan end-to-end. Do not deviate.

package/dist/chunks/_commonjsHelpers-DaMA6jEr.js

@@ -0,0 +1,8 @@
+var o = typeof globalThis < "u" ? globalThis : typeof window < "u" ? window : typeof global < "u" ? global : typeof self < "u" ? self : {};
+function l(e) {
+  return e && e.__esModule && Object.prototype.hasOwnProperty.call(e, "default") ? e.default : e;
+}
+export {
+  o as c,
+  l as g
+};

package/dist/chunks/{devtools-B-7ugZhF.js → devtools-CPZ0IUNM.js}

@@ -1,4 +1,4 @@
-import { g as l } from "./services-CaLOhuLV.js";
+import { g as l } from "./_commonjsHelpers-DaMA6jEr.js";
 var n, s;
 function u() {
   return s || (s = 1, n = function() {

package/dist/chunks/help-5qCaicff.js

@@ -0,0 +1,6 @@
+function o() {
+  console.info("gennady commit — Generate commit message from staged changes"), console.info(""), console.info("Usage:"), console.info("  npx gennady commit [options]"), console.info(""), console.info("Options:"), console.info("  --apply             Apply generated commit message via git commit -am"), console.info("  --mode, -m <mode>   Commit style: auto, oneline, detailed (default: auto)"), console.info("  --oneline, -o       Shorthand for --mode=oneline"), console.info("  --model <model>     AI model to use (reads from rc config by default)"), console.info("  --branch, -b <ref>  Git diff target branch (default: origin/main)"), console.info("  --api, --apiUrl <u> Override AI API endpoint URL"), console.info("  --task, -t <desc>   Task description for commit context"), console.info(""), console.info("Examples:"), console.info("  npx gennady commit"), console.info("  npx gennady commit --mode=oneline"), console.info("  npx gennady commit --apply --mode=detailed");
+}
+export {
+  o as printHelp
+};

package/dist/chunks/help-B2ETH0j6.js

@@ -0,0 +1,6 @@
+function n() {
+  console.info("gennady review — Review staged changes using AI models"), console.info(""), console.info("Usage:"), console.info("  npx gennady review [options]"), console.info(""), console.info("Options:"), console.info("  --branch, -b <ref>  Git diff target branch (default: origin/main)"), console.info(""), console.info("Examples:"), console.info("  npx gennady review"), console.info("  npx gennady review --branch=develop");
+}
+export {
+  n as printHelp
+};

package/dist/chunks/help-BCDURaCQ.js

@@ -0,0 +1,6 @@
+function o() {
+  console.info("gennady remote-console — Mirror browser console output into local stdout"), console.info(""), console.info("Usage:"), console.info("  npx gennady remote-console [options]"), console.info(""), console.info("Options:"), console.info("  --port, -p <port>   Server port (default: 43001)"), console.info("  --host <host>       Server bind host (default: localhost)"), console.info("  --url <URL>         Page URL to open with remote-console activation"), console.info(""), console.info("Examples:"), console.info("  npx gennady remote-console"), console.info("  npx gennady remote-console --port=8080"), console.info('  npx gennady remote-console --url="https://example.com"');
+}
+export {
+  o as printHelp
+};

package/dist/chunks/help-BvgYOSyQ.js

@@ -0,0 +1,6 @@
+function o() {
+  console.info("gennady review-verify — Build verification prompt from MR/PR"), console.info(""), console.info("Usage:"), console.info("  npx gennady review-verify [URL | !ref] [options]"), console.info(""), console.info("Options:"), console.info("  --branch, -b <ref>  Git diff target branch"), console.info("  --url <URL>         GitLab MR or GitHub PR URL"), console.info("  --ref <ref>         MR/PR reference (supports ! prefix)"), console.info('  --project <name>    VCS project path (e.g. "group/repo")'), console.info("  --iid <id>          MR internal ID"), console.info("  --all               Include all discussions, not only unresolved"), console.info(""), console.info("Examples:"), console.info('  npx gennady review-verify --url="https://gitlab.com/g/name/-/merge_requests/42"'), console.info("  npx gennady review-verify https://github.com/owner/repo/pull/10"), console.info('  npx gennady review-verify --branch=develop "https://..."');
+}
+export {
+  o as printHelp
+};

package/dist/chunks/help-CSPhOoI9.js

@@ -0,0 +1,8 @@
+function o() {
+  console.info("gennady vcs-reply — Post replies to GitLab MR discussions"), console.info(""), console.info("Usage:"), console.info("  npx gennady vcs-reply --project=<name> --iid=<id> [options]"), console.info(""), console.info("  Reads a JSON array of discussion replies from stdin."), console.info(""), console.info("Options:"), console.info('  --project <name>    GitLab project path (e.g. "group/repo")'), console.info("  --iid <id>          Merge request internal ID"), console.info("  --dry-run, --dry    Print what would be sent without posting"), console.info(""), console.info("Environment:"), console.info("  GITLAB_PERSONAL_TOKEN   GitLab access token (required)"), console.info("  GITLAB_API_PATH         API path override (default: /api/v4)"), console.info(""), console.info("Examples:"), console.info(
+    `  echo '[{"discussionId":"abc","body":"reviewed"}]' | npx gennady vcs-reply --project=my/repo --iid=42`
+  ), console.info("  npx gennady vcs-reply --project=my/repo --iid=42 --dry-run < replies.json");
+}
+export {
+  o as printHelp
+};

package/dist/chunks/help-CV1vpwrh.js

@@ -0,0 +1,6 @@
+function n() {
+  console.info("gennady sync — Synchronize ai/directives/ from npm package into current project"), console.info(""), console.info("Usage:"), console.info("  npx gennady sync [subdirs...] [options]"), console.info(""), console.info("Options:"), console.info("  --dry-run           Preview changes without writing files"), console.info(""), console.info("  Specify subdirectories to sync only those parts of ai/directives/."), console.info("  Requires gennady as a local dev dependency (npm i -D gennady)."), console.info(""), console.info("Examples:"), console.info("  npx gennady sync"), console.info("  npx gennady sync --dry-run"), console.info("  npx gennady sync ts-patterns typescript --dry-run");
+}
+export {
+  n as printHelp
+};

package/dist/chunks/help-CaBNA6Qr.js

@@ -0,0 +1,12 @@
+function o() {
+  console.info(
+    "gennady alt-opinion — Get alternative opinions from AI models with optional synthesis"
+  ), console.info(""), console.info("Usage:"), console.info('  npx gennady alt-opinion --model="provider/model" [options] < artifact.txt'), console.info('  npx gennady alt-opinion --model="provider/model" --file=<path> [options]'), console.info(""), console.info("Options:"), console.info("  --model=<spec>      Model descriptor: provider/model[::prompt.md] (repeatable)"), console.info("  --synthModel=<spec> Synthesizer model (same format as --model)"), console.info("  --file=<path>       Input file (mutually exclusive with stdin)"), console.info("  --modelPrompt=<p>   Prompt file for all opinion models"), console.info("  --synthPrompt=<p>   Prompt file for the synthesizer model"), console.info("  --strict            Exit with code 1 if any model errors"), console.info(""), console.info("  Supported providers: llmproxy, openrouter."), console.info("  The ::prompt.md suffix loads a per-model custom prompt."), console.info(""), console.info("Environment:"), console.info("  LLM_PROXY_API_KEY     Required for llmproxy provider"), console.info("  LLM_PROXY_BASE_URL    Override default base URL"), console.info("  OPENROUTER_API_KEY    Required for openrouter provider"), console.info(""), console.info("Examples:"), console.info('  npx gennady alt-opinion --model="llmproxy/gpt-4o" < spec.md'), console.info(
+    '  npx gennady alt-opinion --model="openrouter/gemini-pro" --synthModel="llmproxy/claude-sonnet" < spec.md'
+  ), console.info(
+    '  npx gennady alt-opinion --model="llmproxy/gpt-4o::./custom.md" --file=./spec.md --strict'
+  );
+}
+export {
+  o as printHelp
+};

package/dist/chunks/help-CjkR6SB9.js

@@ -0,0 +1,6 @@
+function o() {
+  console.info("gennady cat — Display file contents as XML or Markdown"), console.info(""), console.info("Usage:"), console.info("  npx gennady cat <path/glob>... [options]"), console.info("  npx gennady cat --url=<MR/PR URL> [options]"), console.info(""), console.info("Options:"), console.info("  --plain             Suppress hint footer and color output"), console.info("  --exclude, -e <g>   Glob pattern to exclude files"), console.info("  --ext <exts>        Comma-separated file extensions to include"), console.info("  --output, -o <fmt>  Output format: xml (default) or md"), console.info("  --url <URL>         Fetch files from MR/PR URL instead of local paths"), console.info(""), console.info("  Note: --url and positional paths are mutually exclusive."), console.info(""), console.info("Examples:"), console.info('  npx gennady cat "./src/**/*.ts"'), console.info('  npx gennady cat "./src/**/*.ts" --output=md --plain | pbcopy'), console.info('  npx gennady cat --url="https://gitlab.com/.../-/merge_requests/123"');
+}
+export {
+  o as printHelp
+};

package/dist/chunks/help-Coi1l5u9.js

@@ -0,0 +1,8 @@
+function n() {
+  console.info(
+    "gennady agent-mon — Interactive terminal dashboard for monitoring AI agent sessions"
+  ), console.info(""), console.info("Usage:"), console.info("  npx gennady agent-mon [options]"), console.info(""), console.info("Options:"), console.info("  --once             Snapshot mode — print dashboard and exit"), console.info("  --interval <ms>    Polling interval in ms (default: 5000)"), console.info("  --provider <name>  Filter by provider: claude, opencode, all (default: all)"), console.info("  --view <name>      Dashboard layout: column (default), compact"), console.info("  --limit <N>        Max sessions per provider (default: 10)"), console.info(""), console.info("Examples:"), console.info("  npx gennady agent-mon"), console.info("  npx gennady agent-mon --once"), console.info("  npx gennady agent-mon --provider=claude --limit=5");
+}
+export {
+  n as printHelp
+};

package/dist/chunks/help-CsuLpZn-.js

@@ -0,0 +1,8 @@
+function n() {
+  console.info(
+    "gennady resolve-conflicts — Build confidence-aware merge-conflict resolution prompt"
+  ), console.info(""), console.info("Usage:"), console.info("  npx gennady resolve-conflicts [options]"), console.info(""), console.info("Options:"), console.info("  --branch, -b <ref>  Target branch for merge (default: origin/main)"), console.info("  --incoming <ref>    Incoming branch being merged"), console.info(""), console.info("  Requires an active git merge with conflicts present."), console.info(""), console.info("Examples:"), console.info("  npx gennady resolve-conflicts"), console.info("  npx gennady resolve-conflicts --branch=main --incoming=feature/x");
+}
+export {
+  n as printHelp
+};

package/dist/chunks/help-DL_QBMwy.js

@@ -0,0 +1,8 @@
+function o() {
+  console.info("gennady lint — Validate TypeScript files for codebase conventions"), console.info(""), console.info("Usage:"), console.info("  npx gennady lint [paths...] [options]"), console.info(""), console.info("Options:"), console.info("  --autofix           Auto-fix DbC contract issues where possible"), console.info(
+    "  --staged            Lint only staged and untracked .ts files (mutually exclusive with paths)"
+  ), console.info("  --verbose, -v       Enable debug logging output"), console.info("  --max-invariants <n>  Max invariants per exported entity (default: 3)"), console.info("  --exclude <glob>      Exclude files matching glob pattern (repeatable)"), console.info(""), console.info("  Default exclude patterns (always active):"), console.info("    **/node_modules/**  **/__tests__/**  **/fixtures/**"), console.info("    **/dist/**          **/coverage/**   **/build/**  **/out/**"), console.info(""), console.info("  When no paths or --staged are provided, lints nothing."), console.info(""), console.info("Examples:"), console.info("  npx gennady lint ./src"), console.info("  npx gennady lint --staged"), console.info("  npx gennady lint ./src --autofix --verbose");
+}
+export {
+  o as printHelp
+};

package/dist/chunks/help-DqBZ2xcp.js

@@ -0,0 +1,6 @@
+function e() {
+  console.info("gennady orient — Navigate project structure via file headers and DBC contracts"), console.info(""), console.info("Usage:"), console.info("  npx gennady orient [options] [keyword]"), console.info(""), console.info("Options:"), console.info("  --file=<path>       Show detailed view of a specific file (repeatable)"), console.info("  --dir=<path>        Limit scanning to a directory"), console.info("  --task=<TSK-NN>     Find files by task ID (repeatable)"), console.info("  --consumer=<name>   Find files by consumer name (repeatable)"), console.info("  --entity=<name>     Search for an exported entity (repeatable)"), console.info("  --graph             Show consumer dependency graph"), console.info("  --recursive         Expand graph recursively"), console.info("  --specs             List all specs and their tasks"), console.info("  --spec=<name>       Show tasks for a specific spec"), console.info("  --detail            Include DBC contract details in output"), console.info("  --fuzzy             Enable fuzzy matching for --entity and --consumer"), console.info("  --depth=<N>         Limit tree or graph depth"), console.info("  --max-results=<N>   Limit number of files shown"), console.info(""), console.info("Examples:"), console.info("  npx gennady orient                        Project map (S1)"), console.info("  npx gennady orient --file=index.ts        Detailed file view (S5)"), console.info("  npx gennady orient --task=TSK-55          Files by task (S2)"), console.info("  npx gennady orient --graph                Dependency graph (S7)"), console.info("  npx gennady orient contract               Keyword search (S4)"), console.info("  npx gennady orient --specs                Specs overview (S8)");
+}
+export {
+  e as printHelp
+};

package/dist/chunks/help-_Y_TN4DZ.js

@@ -0,0 +1,6 @@
+function o() {
+  console.info("gennady review-issues — Build XML issues artifact from MR/PR discussions"), console.info(""), console.info("Usage:"), console.info("  npx gennady review-issues [URL | !ref] [options]"), console.info(""), console.info("Options:"), console.info("  --branch, -b <ref>  Git diff target branch"), console.info("  --url <URL>         GitLab MR or GitHub PR URL"), console.info("  --ref <ref>         MR/PR reference (supports ! prefix)"), console.info('  --project <name>    VCS project path (e.g. "group/repo")'), console.info("  --iid <id>          MR internal ID"), console.info("  --all               Include all discussions, not only unresolved"), console.info(""), console.info("Examples:"), console.info('  npx gennady review-issues --url="https://gitlab.com/g/name/-/merge_requests/42"'), console.info("  npx gennady review-issues https://github.com/owner/repo/pull/10");
+}
+export {
+  o as printHelp
+};

package/dist/chunks/{help.cmd-B_G7EWzF.js → help.cmd-BseRtoBF.js}

@@ -6,7 +6,7 @@ console.info("");
 console.info("Commands:");
 console.info("  commit            Generate commit message from staged changes");
 console.info("  cat               Display file contents as XML or Markdown");
-console.info("  agent             Run AI agent request");
+console.info("  review            Review staged changes using AI models");
 console.info("  vcs-reply         Post replies to GitLab MR discussions from stdin");
 console.info("  review-verify     Build verification prompt from open GitLab MR or GitHub PR");
 console.info(
@@ -16,16 +16,24 @@ console.info(
   "  resolve-conflicts Build confidence-aware merge-conflict resolution prompt from active git merge"
 );
 console.info("  remote-console    Mirror browser console output into local stdout");
-console.info("  lint              Validate TypeScript files: file header, DBC contracts, anchors");
+console.info(
+  "  lint              Validate .ts files: headers, anchors, DBC contracts, invariants, disables"
+);
 console.info("  alt-opinion       Get alternative opinions from AI models with optional synthesis");
 console.info(
   "  sync              Synchronize ai/directives/ from npm package into current project"
 );
+console.info("  sync-skills       Synchronize SDD skills from ai/skills/ to .claude/skills/");
 console.info(
   "  agent-mon         Interactive terminal dashboard for monitoring active AI agent sessions"
 );
+console.info(
+  "  orient            Navigate file headers and DBC contracts — project map, search, dependency graph"
+);
+console.info("  agents-rules      Print orient usage instructions for AI agents");
 console.info("");
 console.info("Examples:");
 console.info("  npx gennady");
 console.info("  npx gennady commit");
 console.info('  npx gennady cat "./src/**/*.js" --output=md');
+console.info("  npx gennady <command> --help  (per-command help)");