@ankhorage/doctor

Executable Ankh provider and standalone CLI for lightweight repo and package compliance diagnostics.

Usage

Provider and CLI surface

@ankhorage/doctor is the repo/package compliance provider for Ankhorage.

The same shared command implementation backs both:

• ankh doctor ...
• bunx @ankhorage/doctor ...

Current command surface:

• validate
• fix
• repo
• package

doctor#2 adds a profile-based policy engine:

• strict public-package validation for extracted public package repos
• light recognized integration-monorepo validation for ankhorage4
• canonical app-manifest authentication validation for JSON file targets
• non-mutating fix plans for deterministic mechanical changes only

Public-package script validation follows the canonical Devtools contract. In particular, packages must expose knip:check; the obsolete knip script does not satisfy that policy. Changesets dependency placement follows the same ownership boundary: @ankhorage/devtools publishes @changesets/cli from dependencies, while consumers use the Devtools-owned command without declaring the CLI directly.

Manifest validation accepts infra.auth.flow as the only auth-flow location, rejects settings.authFlow with a manual-migration diagnostic, and permits authentication without an authorization block.

Still deferred:

• GitHub checks
• CI checks
• on-disk fix --apply
• deeper cross-repo policy enforcement

Path handling:

• pass a repo/package directory or app-manifest JSON file as [path], or
• omit it to inspect the current working directory

Source: src/readme-usage.ts

import { runCli } from './cli/standalone.js';

await runCli(['--help']);

Generated documentation

• Interactive documentation app
• Public API reference
• Component registry
• Architecture overview
• Module relationships
• Export graph
• ankhorage-doctor sequence
• createDoctorRuntimeProvider sequence