@kody/doctor

@kody/doctor — agent notes

Human overview: README.md. Read-only only — never call runUpdate, jobUpdate, secretSet/secretDelete, or package mutators from this package's guidance.

Auth

None. Uses the caller's signed-in Kody session builtins.

Import paths

Prefer static kody:@kody/doctor/... imports from execute. Do not lead with packages.invoke.

Smoke test (read-only)

import check from 'kody:@kody/doctor/check'

export default async function main() {
	return await check()
	// => { ok, generatedAt, summary, findings, markdown }
}

Bound the run window:

import check from 'kody:@kody/doctor/check'

export default async function main() {
	return await check({ since: '2026-09-01T00:00:00Z' })
}

Root import is the same function:

import doctor from 'kody:@kody/doctor'

export default async function main() {
	return await doctor()
}

Edge cases

• Capability failures (missing permission / transient error) become findings, not thrown crashes — report still returns.
• Open-error sample is capped (small); use since to bound runSummary / open-error listing.
• Never treat findings as authorization to mutate; ask the user before fixing jobs, secrets, or packages.