tickmarkr 1.33.4 → 1.34.0

package/dist/adapters/codex.js

@@ -129,11 +129,14 @@ export const codex = {
     probe: async () => probeVersion("codex"),
     channels: (cfg) => channelsFromConfig("codex", cfg),
     // --sandbox workspace-write is the autonomous sandbox mode (codex v0.144.1+)
-    headlessCommand: (promptFile, model) => `codex exec --sandbox workspace-write ${GITDIR_WRITABLE} --model ${shq(model)} "$(cat ${shq(promptFile)})"`,
+    // OBS-24: -c 'mcp_servers={}' is codex's analog of claude's --strict-mcp-config — operator-global
+    // MCP servers in ~/.codex/config.toml block startup indefinitely when one is down (live-measured
+    // 2026-07-15: probe wedged >120s with MCP, 30s clean), wedging probes and worktree workers alike.
+    headlessCommand: (promptFile, model) => `codex exec --sandbox workspace-write -c 'mcp_servers={}' ${GITDIR_WRITABLE} --model ${shq(model)} "$(cat ${shq(promptFile)})"`,
     // TUI uses expanded -a never -s workspace-write (exec-only flags do not apply)
     // (--help 2026-07-09: valid approval policies are untrusted|on-request|never; the previously
     // used `on-failure` is invalid and made codex exit 2 pre-inference)
-    interactiveCommand: (promptFile, model) => `codex -a never -s workspace-write ${GITDIR_WRITABLE} --model ${shq(model)} "$(cat ${shq(promptFile)})"`,
+    interactiveCommand: (promptFile, model) => `codex -a never -s workspace-write -c 'mcp_servers={}' ${GITDIR_WRITABLE} --model ${shq(model)} "$(cat ${shq(promptFile)})"`,
     invoke(task, _cwd, a, ctx) {
         return { command: this.headlessCommand(ctx.promptFile, a.model) };
     },

package/dist/adapters/model-lints.d.ts

@@ -2,5 +2,13 @@ import type { DrovrConfig } from "../config/config.js";
 import { type AuthHealth, type WorkerAdapter } from "./types.js";
 export declare const SEED_STAMPED = "2026-07-09";
 export declare const MODEL_STALE_DAYS = 30;
-export declare function modelLints(cfg: DrovrConfig, health: Record<string, AuthHealth>, adapters: WorkerAdapter[]): string[];
+export declare const ttyVisual: () => boolean;
+export declare function modelLints(cfg: DrovrConfig, health: Record<string, AuthHealth>, adapters: WorkerAdapter[], opts?: {
+    tty?: boolean;
+}): string[];
+export declare function formatModelAuthLine(excluded: {
+    key: string;
+    reason: string;
+    probedAt: string;
+}[], tty?: boolean): string;
 export declare function suggestOverlay(cfg: DrovrConfig, health: Record<string, AuthHealth>, adapters: WorkerAdapter[]): string;

package/dist/adapters/model-lints.js

@@ -9,10 +9,15 @@ const DAY_MS = 86400000;
 // raw list (verified 2026-07-10). Data stays raw; lints stay signal.
 const LINT_VARIANT_RE = /^auto$|-(fast|minimal|low|medium|high|xhigh)$/;
 const LINT_CAP = 5;
+const TTY_LINT_CAP = 3;
+const DOCTOR_JSON_REF = " — see .drovr/doctor.json";
+export const ttyVisual = () => process.stdout.isTTY === true && process.env.NO_COLOR === undefined;
 // Diffs detected models (doctor.json) against configured tiers, both directions, per adapter id in cfg.tiers.
 // No `  ! ` prefix here — the consumer (doctor rows / plan lints) owns that. Pre-v1.5 doctor.json (models:[], no
 // modelsDetectedAt) is the compat baseline: `?.`/`?? []` everywhere, no zod (would reject old files).
-export function modelLints(cfg, health, adapters) {
+export function modelLints(cfg, health, adapters, opts) {
+    const cap = opts?.tty ? TTY_LINT_CAP : LINT_CAP;
+    const doctorRef = opts?.tty ? DOCTOR_JSON_REF : "";
     const lints = [];
     for (const id of Object.keys(cfg.tiers)) {
         const adapter = adapters.find((a) => a.id === id);
@@ -37,8 +42,8 @@ export function modelLints(cfg, health, adapters) {
         }
         const extra = detected.filter((m) => !configured.includes(m) && !LINT_VARIANT_RE.test(m));
         if (extra.length) {
-            const shown = extra.slice(0, LINT_CAP).join(", ");
-            const tail = extra.length > LINT_CAP ? `, +${extra.length - LINT_CAP} more` : "";
+            const shown = extra.slice(0, cap).join(", ");
+            const tail = extra.length > cap ? `, +${extra.length - cap} more${doctorRef}` : "";
             lints.push(`${id}: reports ${extra.length} model(s) not in tiers (${shown}${tail}) — classify before routing (benchmark policy)`);
         }
         const at = h?.modelsDetectedAt;
@@ -50,6 +55,17 @@ export function modelLints(cfg, health, adapters) {
     }
     return lints;
 }
+// T2/T6: one lint per exclusion, naming the probe reason and date. TTY truncates reasons to 60 chars and
+// points at doctor.json for the full text; non-TTY is byte-identical to the pre-T6 registry helper.
+export function formatModelAuthLine(excluded, tty) {
+    const trunc = (s, n) => (s.length <= n ? s : `${s.slice(0, n - 1)}…`);
+    const parts = excluded.map(({ key, reason, probedAt }) => {
+        const r = tty ? trunc(reason, 60) : reason;
+        return `${key} (${r} — probed ${probedAt.split("T")[0]})`;
+    });
+    const base = `model auth: ${excluded.length} channel(s) unauthed — ${parts.join(", ")}`;
+    return tty ? `${base}${DOCTOR_JSON_REF}` : base;
+}
 // MODEL-05/06: render detected-vs-configured drift as a paste-ready config.yaml fragment. Locked v1.5
 // decision: detection is strictly advisory — doctor prints, a human pastes; NO --write/--apply exists.
 // Additions render WHOLE-LINE-COMMENTED with a `???` tier placeholder (a tier is a benchmark claim; the

package/dist/adapters/registry.d.ts

@@ -5,7 +5,9 @@ export declare function allAdapters(opts?: {
 }): WorkerAdapter[];
 export declare function getAdapter(id: string, adapters: WorkerAdapter[]): WorkerAdapter;
 export declare function probeAll(adapters: WorkerAdapter[]): Promise<Record<string, AuthHealth>>;
-export declare function probeModels(cfg: DrovrConfig, repoRoot: string, adapters: WorkerAdapter[], health: Record<string, AuthHealth>): Promise<void>;
+export type ProbeModelStatus = "ok" | "timeout" | "failed";
+export type ProbeModelProgress = (adapter: string, model: string, status: ProbeModelStatus, durationMs: number) => void;
+export declare function probeModels(cfg: DrovrConfig, repoRoot: string, adapters: WorkerAdapter[], health: Record<string, AuthHealth>, onProgress?: ProbeModelProgress): Promise<void>;
 export declare function writeDoctor(repoRoot: string, health: Record<string, AuthHealth>): void;
 export declare function readDoctor(repoRoot: string): Record<string, AuthHealth> | null;
 export declare function discoverChannels(cfg: DrovrConfig, adapters: WorkerAdapter[], health: Record<string, AuthHealth>): BillingChannel[];
@@ -29,3 +31,13 @@ export declare function modelAuthLine(excluded: {
     probedAt: string;
 }[]): string;
 export declare function doctorAgeMs(repoRoot: string): number | null;
+export declare const INIT_DOCTOR_REUSE_MS: number;
+export declare function formatDoctorAgeForInit(ageMs: number): string;
+export declare function initDoctorReuse(repoRoot: string, fresh: boolean): {
+    reuse: boolean;
+    ageMs: number | null;
+    health: Record<string, AuthHealth> | null;
+};
+export declare function formatDoctorReport(cwd: string, cfg: DrovrConfig, health: Record<string, AuthHealth>, adapters: WorkerAdapter[], opts?: {
+    wrote?: boolean;
+}): string;

package/dist/adapters/registry.js

@@ -1,8 +1,10 @@
 import { existsSync, mkdtempSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { modelLints, suggestOverlay } from "./model-lints.js";
+import { HerdrDriver } from "../drivers/herdr.js";
 import { drovrDir, stateDirName } from "../graph/graph.js";
-import { disallowedBy } from "../route/preference.js";
+import { disallowedBy, excludedChannels, exclusionLine, preferRanks } from "../route/preference.js";
 import { sh } from "../run/git.js";
 import { claudeCode } from "./claude-code.js";
 import { codex } from "./codex.js";
@@ -32,7 +34,8 @@ export async function probeAll(adapters) {
     return out;
 }
 const MODEL_PROBE_PROMPT = "Reply with exactly OK and nothing else.";
-const MODEL_PROBE_TIMEOUT_MS = 30000;
+// 60s: a healthy MCP-free codex probe measured 29.9s round-trip (2026-07-15) — 30s had zero headroom.
+const MODEL_PROBE_TIMEOUT_MS = 60000;
 // Auth-words only match when tied to a failure word; bare "auth"/"OAuth"/"authored" never fail (v1.27 T2).
 const AUTH_FAILURE_RE = /\b4\d\d\b|\bauth(?:entication|orization)?\s+(?:error|failed|failure|denied)|unauthori[sz]ed|forbidden|access denied|credit(?:s)?\s+(?:exhausted|error|denied)/i;
 function probeFailure(code, stdout, stderr, timedOut, timeoutMs = MODEL_PROBE_TIMEOUT_MS) {
@@ -44,8 +47,12 @@ function probeFailure(code, stdout, stderr, timedOut, timeoutMs = MODEL_PROBE_TI
         ? output.slice(0, 240) || `probe exited ${code}`
         : undefined;
 }
+const probeModelStatus = (v) => v.authed ? "ok" : v.reason?.includes("timed out") ? "timeout" : "failed";
 // v1.21: one bounded, headless call per configured model; detected-but-unclassified models never enter this loop.
-export async function probeModels(cfg, repoRoot, adapters, health) {
+export async function probeModels(cfg, repoRoot, adapters, health, onProgress) {
+    // T2: a prior doctor.json timeout verdict for this model skips the retry — a persistently dead
+    // model (e.g. opencode glm-5.2) costs one 30s attempt instead of two every run.
+    const priorHealth = readDoctor(repoRoot);
     await Promise.all(adapters.map(async (a) => {
         const h = health[a.id];
         if (!h?.installed)
@@ -54,33 +61,65 @@ export async function probeModels(cfg, repoRoot, adapters, health) {
         if (process.env.VITEST && [claudeCode, codex, cursorAgent, opencode, pi, grok].includes(a))
             return;
         const verdicts = {};
-        for (const model of Object.keys(cfg.tiers[a.id]?.models ?? {})) {
+        const priorModelAuth = priorHealth?.[a.id]?.modelAuth;
+        // models probe concurrently too (v1.33.5) — sequential chains made init wall time Σ(models×60s)
+        // on the slowest adapter (measured 96s); each probe is one tiny prompt, safe to overlap.
+        // Capped at MODEL_PROBE_CONCURRENCY per adapter (v1.33.5 regression: 4 concurrent codex exec
+        // in one repo made ALL 4 codex probes time out where sequential passed 2/4).
+        await mapLimit(Object.keys(cfg.tiers[a.id]?.models ?? {}), MODEL_PROBE_CONCURRENCY, async (model) => {
+            const t0 = Date.now();
             const probedAt = new Date().toISOString();
+            const priorTimedOut = priorModelAuth?.[model]?.reason?.includes("timed out") === true;
+            let verdict;
             try {
                 if (typeof a.headlessCommand !== "function") {
-                    verdicts[model] = { authed: false, reason: "headless probe unavailable", probedAt };
-                    continue;
+                    verdict = { authed: false, reason: "headless probe unavailable", probedAt, durationMs: Date.now() - t0 };
                 }
-                const promptFile = join(mkdtempSync(join(tmpdir(), "drovr-auth-")), "probe.md");
-                writeFileSync(promptFile, MODEL_PROBE_PROMPT);
-                let r = await sh(a.headlessCommand(promptFile, model), repoRoot, MODEL_PROBE_TIMEOUT_MS);
-                if (r.timedOut) {
-                    r = await sh(a.headlessCommand(promptFile, model), repoRoot, MODEL_PROBE_TIMEOUT_MS);
-                    if (r.timedOut) {
-                        verdicts[model] = { authed: false, reason: `probe timed out twice (${MODEL_PROBE_TIMEOUT_MS}ms)`, probedAt };
-                        continue;
+                else {
+                    const promptFile = join(mkdtempSync(join(tmpdir(), "drovr-auth-")), "probe.md");
+                    writeFileSync(promptFile, MODEL_PROBE_PROMPT);
+                    const r = await sh(a.headlessCommand(promptFile, model), repoRoot, MODEL_PROBE_TIMEOUT_MS);
+                    if (r.timedOut && priorTimedOut) {
+                        verdict = { authed: false, reason: `probe timed out (repeat — retry skipped) (${MODEL_PROBE_TIMEOUT_MS}ms)`, probedAt, durationMs: Date.now() - t0 };
+                    }
+                    else if (r.timedOut) {
+                        const r2 = await sh(a.headlessCommand(promptFile, model), repoRoot, MODEL_PROBE_TIMEOUT_MS);
+                        if (r2.timedOut) {
+                            verdict = { authed: false, reason: `probe timed out twice (${MODEL_PROBE_TIMEOUT_MS}ms)`, probedAt, durationMs: Date.now() - t0 };
+                        }
+                        else {
+                            const reason = probeFailure(r2.code, r2.stdout, r2.stderr, r2.timedOut, MODEL_PROBE_TIMEOUT_MS);
+                            verdict = reason ? { authed: false, reason, probedAt, durationMs: Date.now() - t0 } : { authed: true, probedAt, durationMs: Date.now() - t0 };
+                        }
+                    }
+                    else {
+                        const reason = probeFailure(r.code, r.stdout, r.stderr, r.timedOut, MODEL_PROBE_TIMEOUT_MS);
+                        verdict = reason ? { authed: false, reason, probedAt, durationMs: Date.now() - t0 } : { authed: true, probedAt, durationMs: Date.now() - t0 };
                     }
                 }
-                const reason = probeFailure(r.code, r.stdout, r.stderr, r.timedOut, MODEL_PROBE_TIMEOUT_MS);
-                verdicts[model] = reason ? { authed: false, reason, probedAt } : { authed: true, probedAt };
             }
             catch (e) {
-                verdicts[model] = { authed: false, reason: String(e), probedAt };
+                verdict = { authed: false, reason: String(e), probedAt, durationMs: Date.now() - t0 };
             }
-        }
+            verdicts[model] = verdict;
+            onProgress?.(a.id, model, probeModelStatus(verdict), verdict.durationMs);
+        });
         h.modelAuth = verdicts;
     }));
 }
+// T2: caps concurrent probes per adapter at 2 — v1.33.5 regression, 4 concurrent codex exec in one
+// repo made ALL 4 time out where sequential passed 2/4 (suspected CLI self-contention).
+const MODEL_PROBE_CONCURRENCY = 2;
+async function mapLimit(items, limit, fn) {
+    let i = 0;
+    const workers = Array.from({ length: Math.min(limit, items.length) }, async () => {
+        while (i < items.length) {
+            const item = items[i++];
+            await fn(item);
+        }
+    });
+    await Promise.all(workers);
+}
 const doctorPath = (repoRoot) => join(repoRoot, stateDirName(repoRoot), "doctor.json");
 export function writeDoctor(repoRoot, health) {
     drovrDir(repoRoot);
@@ -163,3 +202,97 @@ export function doctorAgeMs(repoRoot) {
     // renders a nonsensical negative age ("doctor.json is -0h old").
     return Math.max(0, Date.now() - statSync(p).mtimeMs);
 }
+// ponytail: hardcoded 60m TTL for init reuse only — promote to config when an operator asks.
+export const INIT_DOCTOR_REUSE_MS = 60 * 60 * 1000;
+export function formatDoctorAgeForInit(ageMs) {
+    return `${Math.floor(ageMs / 60_000)}m`;
+}
+export function initDoctorReuse(repoRoot, fresh) {
+    const health = readDoctor(repoRoot);
+    const ageMs = doctorAgeMs(repoRoot);
+    const reuse = !fresh && health !== null && ageMs !== null && ageMs < INIT_DOCTOR_REUSE_MS;
+    return { reuse, ageMs, health: reuse ? health : null };
+}
+// Report body shared by init's cached-doctor path — mirrors doctor.ts formatting without probing.
+export function formatDoctorReport(cwd, cfg, health, adapters, opts = {}) {
+    const rows = adapters.map((a) => {
+        const h = health[a.id];
+        const state = !h?.installed ? "not installed" : `${h.version ?? "installed"}${h.note ? ` (${h.note})` : ""}`;
+        return `  ${h?.installed ? "✓" : "✗"} ${a.id.padEnd(14)} ${state}`;
+    });
+    rows.push(`  ${HerdrDriver.available() ? "✓" : "✗"} herdr          ${HerdrDriver.available() ? "driver available (HERDR_ENV=1)" : "not detected — subprocess driver will be used"}`);
+    rows.push("workspace trust:");
+    for (const a of adapters) {
+        if (!health[a.id]?.installed)
+            continue;
+        if (!a.trust) {
+            rows.push(`  = ${a.id.padEnd(14)} trust: n/a`);
+            continue;
+        }
+        try {
+            const v = a.trust(cwd);
+            if (v.status === "trusted")
+                rows.push(`  ✓ ${a.id.padEnd(14)} trust: trusted`);
+            else if (v.status === "seeded")
+                rows.push(`  ✓ ${a.id.padEnd(14)} trust: seeded`);
+            else
+                rows.push(`  ! ${a.id.padEnd(14)} trust: action-required — run ONCE: ${v.command}`);
+        }
+        catch (e) {
+            rows.push(`  ! ${a.id.padEnd(14)} trust: action-required — run ONCE: (trust check failed: ${e instanceof Error ? e.message : String(e)})`);
+        }
+    }
+    for (const [role, sel] of [["judge", cfg.judge], ["consult", cfg.consult]]) {
+        if (!health[sel.adapter]?.installed) {
+            rows.push(`  ! ${role} runs on ${sel.adapter}:${sel.model} — NOT installed; that gate will fail closed until you install it or remap cfg.${role}`);
+        }
+    }
+    rows.push(...modelLints(cfg, health, adapters).map((l) => `  ! ${l}`));
+    const excluded = excludedChannels(cfg, adapters, health);
+    if (excluded.length)
+        rows.push(`  ! ${exclusionLine(excluded)}`);
+    const servable = servableExclusions(cfg, adapters, health);
+    if (servable.length)
+        rows.push(`  ! ${servabilityLine(servable)}`);
+    const visual = process.stdout.isTTY === true && process.env.NO_COLOR === undefined;
+    const frag = suggestOverlay(cfg, health, adapters);
+    let drift = "";
+    if (frag) {
+        if (visual) {
+            const overlayPath = join(drovrDir(cwd), "doctor-overlay.yaml");
+            writeFileSync(overlayPath, frag);
+            drift = `\nmodel drift: unclassified models detected — paste-ready overlay written to ${overlayPath} (advisory; tickmarkr never applies it)`;
+        }
+        else {
+            drift = `\nmodel drift — paste-ready overlay (advisory; tickmarkr never applies):\n${frag}`;
+        }
+    }
+    const trunc = (s, n) => (s.length <= n ? s : `${s.slice(0, n - 1)}…`);
+    const dateOf = (iso) => iso.slice(0, 10);
+    const modelStatus = adapters.flatMap((a) => {
+        const h = health[a.id];
+        if (!h?.installed)
+            return [];
+        const classified = cfg.tiers[a.id]?.models ?? {};
+        const models = Object.keys(classified);
+        const unclassified = (h.models ?? []).filter((m) => !(m in classified));
+        if (!models.length && !unclassified.length)
+            return [];
+        const w = Math.max(8, ...models.map((m) => m.length));
+        const statusRows = [`  ${a.id}`];
+        for (const m of models) {
+            const v = h.modelAuth?.[m];
+            const auth = !v ? "unknown" : v.authed ? "authed" : `unauthed: ${trunc(v.reason ?? "probe failed", 40)} (${dateOf(v.probedAt)})`;
+            const d = disallowedBy({ adapter: a.id, model: m }, cfg.routing);
+            const denied = d?.by === "deny" ? d.entry : "—";
+            const pref = preferRanks({ adapter: a.id, model: m }, cfg).map((p) => `${p.shape}#${p.rank}`).join(",") || "—";
+            statusRows.push(`    ${m.padEnd(w)} ${classified[m].padEnd(8)} ${auth}  denied=${denied}  prefer=${pref}`);
+        }
+        if (unclassified.length)
+            statusRows.push(`    (${unclassified.length} more listed, unclassified)`);
+        return statusRows;
+    });
+    const modelSummary = modelStatus.length ? `\nmodel status:\n${modelStatus.join("\n")}` : "";
+    const wrote = opts.wrote === false ? "" : `\nwrote .drovr/doctor.json`;
+    return `tickmarkr doctor — capability matrix:\n${rows.join("\n")}${modelSummary}${drift}${wrote}`;
+}

package/dist/cli/commands/doctor.js

@@ -2,7 +2,7 @@ import { writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { allAdapters, probeAll, probeModels, servableExclusions, servabilityLine, writeDoctor } from "../../adapters/registry.js";
 import { drovrDir } from "../../graph/graph.js";
-import { modelLints, suggestOverlay } from "../../adapters/model-lints.js";
+import { modelLints, suggestOverlay, ttyVisual } from "../../adapters/model-lints.js";
 import { loadConfig } from "../../config/config.js";
 import { HerdrDriver } from "../../drivers/herdr.js";
 import { disallowedBy, excludedChannels, exclusionLine, preferRanks } from "../../route/preference.js";
@@ -35,6 +35,7 @@ export async function doctor(_argv, cwd = process.cwd(), adapters = allAdapters(
     // stderr, live: auth probes are real LLM calls (up to 30s per configured model) and the CLI
     // otherwise prints nothing until the end — silence here reads as a hang (v1.33.1)
     console.error("probing installed agent CLIs — one short LLM call per configured model, may take a minute...");
+    const probeProgressTTY = process.stderr.isTTY === true;
     const health = await probeAll(adapters);
     // MODEL-02: detect models where the adapter exposes a list surface, BEFORE writing doctor.json (write once, below).
     // Fail OPEN — the inverse of gates' fail-closed: detection is advisory, so a broken list surface NEVER fails doctor.
@@ -51,7 +52,9 @@ export async function doctor(_argv, cwd = process.cwd(), adapters = allAdapters(
         }
         catch { /* fail open: leave models as-is, doctor stays healthy */ }
     }
-    await probeModels(cfg, cwd, adapters, health);
+    await probeModels(cfg, cwd, adapters, health, probeProgressTTY
+        ? (adapter, model, status, durationMs) => console.error(`  ${adapter}:${model} ${status} (${(durationMs / 1000).toFixed(1)}s)`)
+        : undefined);
     writeDoctor(cwd, health);
     const rows = adapters.map((a) => {
         const h = health[a.id];
@@ -88,7 +91,7 @@ export async function doctor(_argv, cwd = process.cwd(), adapters = allAdapters(
             rows.push(`  ! ${role} runs on ${sel.adapter}:${sel.model} — NOT installed; that gate will fail closed until you install it or remap cfg.${role}`);
         }
     }
-    rows.push(...modelLints(cfg, health, adapters).map((l) => `  ! ${l}`));
+    rows.push(...modelLints(cfg, health, adapters, { tty: ttyVisual() }).map((l) => `  ! ${l}`));
     const excluded = excludedChannels(cfg, adapters, health);
     if (excluded.length)
         rows.push(`  ! ${exclusionLine(excluded)}`);

package/dist/cli/commands/init.js

@@ -2,7 +2,8 @@ import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } fr
 import { join } from "node:path";
 import { createInterface } from "node:readline/promises";
 import { parseArgs } from "node:util";
-import { configTemplate, globalConfigDir } from "../../config/config.js";
+import { allAdapters, formatDoctorAgeForInit, formatDoctorReport, initDoctorReuse } from "../../adapters/registry.js";
+import { configTemplate, DEFAULT_CONFIG, globalConfigDir, loadConfig } from "../../config/config.js";
 import { specTemplate } from "../../compile/native.js";
 import { drovrDir } from "../../graph/graph.js";
 import { doctor } from "./doctor.js";
@@ -23,6 +24,9 @@ Loop: \`tickmarkr compile <spec>\` → \`tickmarkr plan\` → \`tickmarkr run\`
 - Treat missing or unparseable results as failures.
 ${DOCS_END}
 `;
+const skillPath = (cwd, skill) => join(cwd, ".claude", "skills", skill, "SKILL.md");
+const skillsInstalled = (cwd) => AGENT_SKILLS.every((s) => existsSync(skillPath(cwd, s)));
+const wizardDriverDefault = () => process.env.HERDR_ENV === "1" ? "herdr" : "auto";
 async function installAgentFiles(cwd, force, docs, notes) {
     const interactive = process.stdin.isTTY === true && process.stdout.isTTY === true;
     let prompt;
@@ -34,7 +38,7 @@ async function installAgentFiles(cwd, force, docs, notes) {
     };
     try {
         for (const skill of AGENT_SKILLS) {
-            const dest = join(cwd, ".claude", "skills", skill, "SKILL.md");
+            const dest = skillPath(cwd, skill);
             const exists = existsSync(dest);
             if (exists && !force && !(await confirm(`Overwrite ${dest}?`))) {
                 notes.push(`skipped existing ${dest}; pass --force to overwrite it`);
@@ -63,6 +67,42 @@ async function installAgentFiles(cwd, force, docs, notes) {
         prompt?.close();
     }
 }
+const askDefault = async (rl, label, def) => {
+    const answer = (await rl.question(`${label} [${def}] `)).trim();
+    return answer || def;
+};
+const askYesNo = async (rl, label, def) => {
+    const hint = def ? "Y/n" : "y/N";
+    const answer = (await rl.question(`${label} [${hint}] `)).trim();
+    if (!answer)
+        return def;
+    return /^(?:y|yes)$/i.test(answer);
+};
+async function runInitWizard(cwd) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const driverDef = wizardDriverDefault();
+        const driverRaw = await askDefault(rl, "Driver (auto|herdr|subprocess)", driverDef);
+        const driver = ["auto", "herdr", "subprocess"].includes(driverRaw)
+            ? driverRaw
+            : driverDef;
+        const concRaw = await askDefault(rl, "Concurrency", String(DEFAULT_CONFIG.concurrency));
+        const parsed = Number.parseInt(concRaw, 10);
+        const concurrency = Number.isInteger(parsed) && parsed > 0 ? parsed : DEFAULT_CONFIG.concurrency;
+        const llmDef = DEFAULT_CONFIG.visibility.llm;
+        const llmRaw = await askDefault(rl, "visibility.llm (pane|headless)", llmDef);
+        const llm = llmRaw === "pane" || llmRaw === "headless" ? llmRaw : llmDef;
+        let installSkills = false;
+        if (!skillsInstalled(cwd)) {
+            const skillsDef = existsSync(join(cwd, ".claude")) && !skillsInstalled(cwd);
+            installSkills = await askYesNo(rl, "Install agent skills (tickmarkr-loop/tickmarkr-auto) into .claude/skills?", skillsDef);
+        }
+        return { overlay: { driver, concurrency, visibility: { llm } }, installSkills };
+    }
+    finally {
+        rl.close();
+    }
+}
 export async function init(argv, cwd = process.cwd()) {
     const { values } = parseArgs({
         args: argv,
@@ -71,20 +111,25 @@ export async function init(argv, cwd = process.cwd()) {
             agent: { type: "boolean" },
             force: { type: "boolean" },
             docs: { type: "boolean" },
+            fresh: { type: "boolean" },
+            yes: { type: "boolean" },
         },
     });
     const gdir = values["global-dir"] ?? globalConfigDir();
     mkdirSync(gdir, { recursive: true });
     const notes = [];
-    for (const p of [join(gdir, "config.yaml"), join(drovrDir(cwd), "config.yaml")]) {
-        if (!existsSync(p)) {
-            writeFileSync(p, configTemplate());
-            notes.push(`wrote ${p}`);
-        }
-        else {
-            notes.push(`kept existing ${p}`);
-        }
+    const globalPath = join(gdir, "config.yaml");
+    if (!existsSync(globalPath)) {
+        writeFileSync(globalPath, configTemplate());
+        notes.push(`wrote ${globalPath}`);
+    }
+    else {
+        notes.push(`kept existing ${globalPath}`);
     }
+    const repoConfigPath = join(drovrDir(cwd), "config.yaml");
+    const repoConfigExists = existsSync(repoConfigPath);
+    if (repoConfigExists)
+        notes.push(`kept existing ${repoConfigPath}`);
     const specPath = join(cwd, "tickmarkr.spec.md");
     if (existsSync(specPath)) {
         notes.push(`kept existing ${specPath}`);
@@ -96,8 +141,26 @@ export async function init(argv, cwd = process.cwd()) {
         writeFileSync(specPath, specTemplate());
         notes.push(`wrote ${specPath}`);
     }
+    const fresh = values.fresh ?? false;
+    const { reuse, ageMs, health } = initDoctorReuse(cwd, fresh);
+    const doc = reuse && health && ageMs !== null
+        ? `using probe results from ${formatDoctorAgeForInit(ageMs)} ago — run tickmarkr doctor to refresh (or init --fresh)\n${formatDoctorReport(cwd, loadConfig(cwd), health, allAdapters(), { wrote: false })}`
+        : await doctor([], cwd);
+    const interactive = process.stdin.isTTY === true && process.stdout.isTTY === true && !(values.yes ?? false);
+    if (!repoConfigExists) {
+        if (interactive) {
+            const wizard = await runInitWizard(cwd);
+            writeFileSync(repoConfigPath, configTemplate(wizard.overlay));
+            notes.push(`wrote ${repoConfigPath}`);
+            if (wizard.installSkills)
+                await installAgentFiles(cwd, values.force ?? false, values.docs ?? false, notes);
+        }
+        else {
+            writeFileSync(repoConfigPath, configTemplate());
+            notes.push(`wrote ${repoConfigPath}`);
+        }
+    }
     if (values.agent)
         await installAgentFiles(cwd, values.force ?? false, values.docs ?? false, notes);
-    const doc = await doctor([], cwd);
     return `${notes.join("\n")}\n${doc}\nnext: edit tickmarkr.spec.md, then tickmarkr compile tickmarkr.spec.md && tickmarkr plan && tickmarkr run`;
 }

package/dist/cli/commands/plan.js

@@ -1,5 +1,5 @@
-import { allAdapters, discoverChannels, doctorAgeMs, modelAuthExclusions, modelAuthLine, probeAll, readDoctor, servableExclusions, servabilityLine } from "../../adapters/registry.js";
-import { modelLints } from "../../adapters/model-lints.js";
+import { allAdapters, discoverChannels, doctorAgeMs, modelAuthExclusions, probeAll, readDoctor, servableExclusions, servabilityLine } from "../../adapters/registry.js";
+import { formatModelAuthLine, modelLints, ttyVisual } from "../../adapters/model-lints.js";
 import { collateralLints } from "../../compile/collateral.js";
 import { loadConfig } from "../../config/config.js";
 import { loadGraph } from "../../graph/graph.js";
@@ -31,7 +31,7 @@ export async function plan(_argv, cwd = process.cwd(), adapters = allAdapters())
     // T2 (2026-07-13): per-model unauthed verdicts from doctor — one lint per exclusion (reason + date).
     const modelUnauthed = modelAuthExclusions(cfg, adapters, health);
     if (modelUnauthed.length)
-        lines.push(modelAuthLine(modelUnauthed), "");
+        lines.push(formatModelAuthLine(modelUnauthed, ttyVisual()), "");
     const unauthed = adapters.filter((a) => health[a.id]?.installed && !health[a.id]?.authed).map((a) => a.id);
     if (unauthed.length)
         lines.push(`installed but unauthed: ${unauthed.join(", ")} — channels excluded from routing`, "");
@@ -58,7 +58,7 @@ export async function plan(_argv, cwd = process.cwd(), adapters = allAdapters())
         if (!health[sel.adapter]?.installed)
             lints.push(`${role}: ${sel.adapter}:${sel.model} not installed — that gate/consult will fail closed`);
     }
-    lints.push(...modelLints(cfg, health, adapters)); // health may be pre-v1.5/probeAll-fallback — no-detection branch covers both
+    lints.push(...modelLints(cfg, health, adapters, { tty: ttyVisual() })); // health may be pre-v1.5/probeAll-fallback — no-detection branch covers both
     let cost = 0;
     for (const t of g.tasks) {
         try {

package/dist/cli/index.js

@@ -16,6 +16,7 @@ import { unlock } from "./commands/unlock.js";
 export const COMMANDS = {
     init, doctor, compile, scope, plan, run, status, resume, report, profile, unlock, approve,
 };
+const HELP_CMDS = new Set(["help", "-h", "--help"]);
 export const USAGE = `tickmarkr — spec-driven orchestration harness for AI coding agents
 usage: tickmarkr <command>
   init          guided setup + doctor; init --agent [--force] [--docs] adds agent skills/docs
@@ -34,9 +35,11 @@ usage: tickmarkr <command>
 // unknown/missing cmd → USAGE (exit 1 if a cmd was typed, 0 for bare `drovr`); a handler throw becomes
 // a one-line `drovr <cmd>: <message>` (never a raw stack) at exit 1.
 export async function dispatch(cmd, argv, commands = COMMANDS) {
-    const fn = cmd ? commands[cmd] : undefined;
+    if (!cmd || HELP_CMDS.has(cmd))
+        return { out: USAGE, code: 0 };
+    const fn = commands[cmd];
     if (!fn)
-        return { out: USAGE, code: cmd ? 1 : 0 };
+        return { out: USAGE, code: 1 };
     try {
         return { out: await fn(argv), code: 0 };
     }

package/dist/config/config.d.ts

@@ -180,5 +180,12 @@ export declare function globalConfigDir(): string;
 export declare function loadConfig(repoRoot: string, opts?: {
     globalDir?: string;
 }): DrovrConfig;
-export declare function configTemplate(): string;
+export type InitConfigOverlay = {
+    concurrency?: number;
+    driver?: DrovrConfig["driver"];
+    visibility?: {
+        llm?: DrovrConfig["visibility"]["llm"];
+    };
+};
+export declare function configTemplate(overlay?: InitConfigOverlay): string;
 export {};

package/dist/config/config.js

@@ -271,8 +271,8 @@ export function loadConfig(repoRoot, opts = {}) {
         throw new ConfigError(z.prettifyError(r.error));
     return r.data;
 }
-export function configTemplate() {
-    return `# tickmarkr config overlay — merges over built-in defaults (repo beats global beats defaults)
+export function configTemplate(overlay) {
+    const base = `# tickmarkr config overlay — merges over built-in defaults (repo beats global beats defaults)
 # concurrency: 3
 # driver: auto            # auto | herdr | subprocess
 # taskTimeoutMinutes: 30
@@ -329,4 +329,19 @@ export function configTemplate() {
 # ever — tickmarkr reuses stable worktree paths so the accept persists across runs; blocked-pane paging
 # surfaces each first-time dialog.
 `;
+    if (!overlay)
+        return base;
+    const lines = [];
+    if (overlay.concurrency !== undefined)
+        lines.push(`concurrency: ${overlay.concurrency}`);
+    if (overlay.driver !== undefined)
+        lines.push(`driver: ${overlay.driver}`);
+    if (overlay.visibility?.llm !== undefined) {
+        lines.push("visibility:");
+        lines.push(`  llm: ${overlay.visibility.llm}`);
+    }
+    if (!lines.length)
+        return base;
+    const nl = base.indexOf("\n");
+    return `${base.slice(0, nl + 1)}${lines.join("\n")}\n${base.slice(nl + 1)}`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tickmarkr",
-  "version": "1.33.4",
+  "version": "1.34.0",
   "description": "Spec in, verified work out.",
   "type": "module",
   "license": "MIT",