@kody/doctor

@kody/doctor

Intent

Give any signed-in account a read-only hygiene report: open run errors, jobs that last failed or lost their alarm, user secrets with no allowed hosts, forks whose source listing is gone, and plan-limit pressure. Success is a structured report plus a short next-ask list so the agent knows what to inspect next.

This package only reads existing builtins. It never updates runs, jobs, secrets, or packages.

What it does

• Summarize open run errors (bounded sample) and recent run pressure
• Flag enabled jobs with last-error, kill-switch, expiry, or alarm drift
• List user secrets missing allowedHosts
• Detect stale community forks (source listing gone)
• Surface plan / usage warnings
• Return structured findings plus a markdown summary

Prerequisites / setup

No secrets or OAuth. Runs against the signed-in Kody account using builtins (runSummary, runList, jobList, secretList, packageList, usageGet).

Agents: import paths and smoke checks live in AGENTS.md.

Done when

• check() (or the default export) returns { ok, summary, findings, markdown }
• Findings include actionable nextAsk strings without mutating anything

Branding

community-icon.svg is a simple medical-cross mark for the doctor metaphor. Keep MIT license and this Intent section when forking.