DOCTOR

Executable doctor provider and standalone CLI for lightweight Ankhorage 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

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']);

Installation

bunx @ankhorage/doctor

Generated documentation

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