@ankhorage/doctor 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## 0.2.0
+
+### Minor Changes
+
+- ab58890: Bootstrap `@ankhorage/doctor` as an executable Ankh provider and standalone CLI with lightweight repo/package diagnostics.
+
+All notable changes to this project will be documented in this file.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ankhorage
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,61 @@
+<!-- markdownlint-disable MD013 MD033 -->
+<!-- This file is generated by Paradox. Do not edit manually. -->
+
+# DOCTOR
+
+![license: MIT](././paradox/badges/license.svg) ![npm: v0.1.0](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
+
+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#1` intentionally stays lightweight:
+
+- path-aware local repo/package diagnostics are implemented now
+- GitHub checks, CI checks, full policy enforcement, and autofix rules are deferred
+
+Path handling:
+
+- pass `[path]`, or
+- omit it to inspect the current working directory
+
+Source: `src/readme-usage.ts`
+
+```ts
+import { runCli } from './cli.js';
+
+await runCli(['--help']);
+```
+
+## Installation
+
+```bash
+bunx @ankhorage/doctor
+```
+
+## Generated documentation
+
+- [Interactive documentation app](././paradox/index.html)
+- [Public API reference](././paradox/exports.md)
+- [Component registry](././paradox/components.md)
+- [Architecture overview](././paradox/diagrams/architecture-overview.mmd)
+- [Module relationships](././paradox/diagrams/module-relationships.mmd)
+- [Export graph](././paradox/diagrams/export-graph.mmd)
+- [ankhorage-doctor sequence](././paradox/diagrams/sequences/ankhorage-doctor.mmd)
+- [createDoctorRuntimeProvider sequence](././paradox/diagrams/sequences/create-doctor-runtime-provider.mmd)

package/dist/analysis.d.ts

@@ -0,0 +1,17 @@
+import type { DoctorDiagnostic } from "./diagnostics.js";
+export type DoctorTargetCheck = "package" | "repo";
+export type DoctorTargetMode = "fix" | "package" | "repo" | "validate";
+export interface DoctorAnalysisRequest {
+    readonly cwd: string;
+    readonly inputPath?: string;
+    readonly mode: DoctorTargetMode;
+}
+export interface DoctorAnalysisResult {
+    readonly appliedChecks: readonly DoctorTargetCheck[];
+    readonly diagnostics: readonly DoctorDiagnostic[];
+    readonly hasPackageJson: boolean;
+    readonly repoMarkers: readonly string[];
+    readonly targetPath: string;
+}
+export declare function analyzeDoctorTarget(request: DoctorAnalysisRequest): Promise<DoctorAnalysisResult>;
+//# sourceMappingURL=analysis.d.ts.map

package/dist/analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../src/analysis.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,MAAM,CAAC;AACnD,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAEvE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,aAAa,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACrD,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAClD,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAcD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CA6G/B"}

package/dist/analysis.js

@@ -0,0 +1,181 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+const REPO_MARKERS = [
+    { label: ".git", relativePath: ".git" },
+    { label: ".github/workflows", relativePath: path.join(".github", "workflows") },
+    { label: ".changeset", relativePath: ".changeset" },
+    { label: "package.json", relativePath: "package.json" },
+    { label: "pnpm-workspace.yaml", relativePath: "pnpm-workspace.yaml" },
+    { label: "bun.lock", relativePath: "bun.lock" },
+    { label: "bun.lockb", relativePath: "bun.lockb" },
+    { label: "package-lock.json", relativePath: "package-lock.json" },
+    { label: "yarn.lock", relativePath: "yarn.lock" },
+];
+export async function analyzeDoctorTarget(request) {
+    const targetPath = path.resolve(request.cwd, request.inputPath ?? ".");
+    const stats = await statOrNull(targetPath);
+    if (stats === null) {
+        return {
+            appliedChecks: [],
+            diagnostics: [
+                createDiagnostic("error", "target-not-found", targetPath, `Target path does not exist: ${targetPath}`),
+            ],
+            hasPackageJson: false,
+            repoMarkers: [],
+            targetPath,
+        };
+    }
+    if (!stats.isDirectory()) {
+        return {
+            appliedChecks: [],
+            diagnostics: [
+                createDiagnostic("error", "target-not-directory", targetPath, `Target path must be a directory: ${targetPath}`),
+            ],
+            hasPackageJson: false,
+            repoMarkers: [],
+            targetPath,
+        };
+    }
+    const repoMarkers = (await Promise.all(REPO_MARKERS.map(async (marker) => (await pathExists(path.join(targetPath, marker.relativePath)))
+        ? marker.label
+        : null))).filter((marker) => marker !== null);
+    const packageJsonPath = path.join(targetPath, "package.json");
+    const hasPackageJson = repoMarkers.includes("package.json");
+    const appliedChecks = [];
+    const diagnostics = [];
+    const shouldRunRepoChecks = request.mode === "repo" ||
+        ((request.mode === "validate" || request.mode === "fix") && repoMarkers.length > 0);
+    const shouldRunPackageChecks = request.mode === "package" ||
+        ((request.mode === "validate" || request.mode === "fix") && hasPackageJson);
+    if (request.mode === "repo" && repoMarkers.length === 0) {
+        diagnostics.push(createDiagnostic("error", "repo-markers-missing", targetPath, "Target is not a repo/workspace-root candidate because no repo markers were found."));
+    }
+    if (request.mode === "package" && !hasPackageJson) {
+        diagnostics.push(createDiagnostic("error", "package-json-missing", packageJsonPath, "Target does not contain a readable package.json file."));
+    }
+    if ((request.mode === "validate" || request.mode === "fix") &&
+        repoMarkers.length === 0 &&
+        !hasPackageJson) {
+        diagnostics.push(createDiagnostic("error", "unsupported-target", targetPath, "Target is neither a repo/workspace-root candidate nor a package root."));
+    }
+    if (shouldRunRepoChecks && repoMarkers.length > 0) {
+        appliedChecks.push("repo");
+        diagnostics.push(...(await analyzeRepoLight(targetPath)));
+    }
+    if (shouldRunPackageChecks && hasPackageJson) {
+        appliedChecks.push("package");
+        diagnostics.push(...(await analyzePackageLight(targetPath, packageJsonPath)));
+    }
+    return {
+        appliedChecks,
+        diagnostics,
+        hasPackageJson,
+        repoMarkers,
+        targetPath,
+    };
+}
+async function analyzeRepoLight(targetPath) {
+    const diagnostics = [];
+    await maybeWarnForMissingPath(diagnostics, targetPath, "README.md", "missing-readme");
+    await maybeWarnForMissingPath(diagnostics, targetPath, "CHANGELOG.md", "missing-changelog");
+    await maybeWarnForMissingPath(diagnostics, targetPath, "LICENSE", "missing-license");
+    await maybeWarnForMissingPath(diagnostics, targetPath, ".changeset", "missing-changeset-directory");
+    await maybeWarnForMissingPath(diagnostics, targetPath, path.join(".github", "workflows"), "missing-workflows-directory");
+    return diagnostics;
+}
+async function analyzePackageLight(targetPath, packageJsonPath) {
+    const diagnostics = [];
+    let parsed;
+    try {
+        parsed = JSON.parse(await fs.readFile(packageJsonPath, "utf8"));
+    }
+    catch (error) {
+        diagnostics.push(createDiagnostic("error", "invalid-package-json", packageJsonPath, createInvalidPackageJsonMessage(error)));
+        return diagnostics;
+    }
+    if (!isRecord(parsed)) {
+        diagnostics.push(createDiagnostic("error", "invalid-package-json", packageJsonPath, "package.json must contain a JSON object."));
+        return diagnostics;
+    }
+    if (!isNonEmptyString(parsed.name)) {
+        diagnostics.push(createDiagnostic("error", "package-name-missing", packageJsonPath, 'package.json must define a non-empty "name" field.'));
+    }
+    if (!isNonEmptyString(parsed.version)) {
+        diagnostics.push(createDiagnostic("error", "package-version-missing", packageJsonPath, 'package.json must define a non-empty "version" field.'));
+    }
+    if (!isNonEmptyString(parsed.type)) {
+        diagnostics.push(createDiagnostic("error", "package-type-missing", packageJsonPath, 'package.json must define a non-empty "type" field.'));
+    }
+    if ("ankh" in parsed) {
+        const validationError = validateAnkhMetadataShape(parsed.ankh);
+        if (validationError !== null) {
+            diagnostics.push(createDiagnostic("error", "invalid-ankh-metadata", targetPath, validationError));
+        }
+    }
+    return diagnostics;
+}
+async function maybeWarnForMissingPath(diagnostics, rootPath, relativePath, code) {
+    const absolutePath = path.join(rootPath, relativePath);
+    if (await pathExists(absolutePath)) {
+        return;
+    }
+    diagnostics.push(createDiagnostic("warning", code, absolutePath, `Missing expected repo artifact: ${relativePath}`));
+}
+function validateAnkhMetadataShape(value) {
+    if (!isRecord(value)) {
+        return 'package.json "ankh" metadata must be an object when present.';
+    }
+    if (!isNonEmptyString(value.category)) {
+        return 'package.json "ankh.category" must be a non-empty string.';
+    }
+    if (!(value.provider === null || isPackageRelativeProviderPath(value.provider))) {
+        return 'package.json "ankh.provider" must be null or a package-relative "./..." string.';
+    }
+    if (!Array.isArray(value.capabilities) ||
+        value.capabilities.some((capability) => !isNonEmptyString(capability))) {
+        return 'package.json "ankh.capabilities" must be an array of non-empty strings.';
+    }
+    return null;
+}
+function createDiagnostic(severity, code, diagnosticPath, message) {
+    return {
+        code,
+        message,
+        path: diagnosticPath,
+        severity,
+    };
+}
+function createInvalidPackageJsonMessage(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return `package.json contains invalid JSON: ${message}`;
+}
+async function pathExists(targetPath) {
+    return (await statOrNull(targetPath)) !== null;
+}
+async function statOrNull(targetPath) {
+    try {
+        return await fs.stat(targetPath);
+    }
+    catch (error) {
+        if (isMissingPathError(error)) {
+            return null;
+        }
+        throw error;
+    }
+}
+function isMissingPathError(error) {
+    return (error instanceof Error &&
+        "code" in error &&
+        typeof error.code === "string" &&
+        error.code === "ENOENT");
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim() !== "";
+}
+function isPackageRelativeProviderPath(value) {
+    return isNonEmptyString(value) && value.startsWith("./");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=analysis.js.map

package/dist/analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.js","sourceRoot":"","sources":["../src/analysis.ts"],"names":[],"mappings":"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","sourcesContent":["import { promises as fs } from \"node:fs\";\nimport path from \"node:path\";\n\nimport type { DoctorDiagnostic } from \"./diagnostics.js\";\n\nexport type DoctorTargetCheck = \"package\" | \"repo\";\nexport type DoctorTargetMode = \"fix\" | \"package\" | \"repo\" | \"validate\";\n\nexport interface DoctorAnalysisRequest {\n  readonly cwd: string;\n  readonly inputPath?: string;\n  readonly mode: DoctorTargetMode;\n}\n\nexport interface DoctorAnalysisResult {\n  readonly appliedChecks: readonly DoctorTargetCheck[];\n  readonly diagnostics: readonly DoctorDiagnostic[];\n  readonly hasPackageJson: boolean;\n  readonly repoMarkers: readonly string[];\n  readonly targetPath: string;\n}\n\nconst REPO_MARKERS = [\n  { label: \".git\", relativePath: \".git\" },\n  { label: \".github/workflows\", relativePath: path.join(\".github\", \"workflows\") },\n  { label: \".changeset\", relativePath: \".changeset\" },\n  { label: \"package.json\", relativePath: \"package.json\" },\n  { label: \"pnpm-workspace.yaml\", relativePath: \"pnpm-workspace.yaml\" },\n  { label: \"bun.lock\", relativePath: \"bun.lock\" },\n  { label: \"bun.lockb\", relativePath: \"bun.lockb\" },\n  { label: \"package-lock.json\", relativePath: \"package-lock.json\" },\n  { label: \"yarn.lock\", relativePath: \"yarn.lock\" },\n] as const;\n\nexport async function analyzeDoctorTarget(\n  request: DoctorAnalysisRequest,\n): Promise<DoctorAnalysisResult> {\n  const targetPath = path.resolve(request.cwd, request.inputPath ?? \".\");\n  const stats = await statOrNull(targetPath);\n\n  if (stats === null) {\n    return {\n      appliedChecks: [],\n      diagnostics: [\n        createDiagnostic(\"error\", \"target-not-found\", targetPath, `Target path does not exist: ${targetPath}`),\n      ],\n      hasPackageJson: false,\n      repoMarkers: [],\n      targetPath,\n    };\n  }\n\n  if (!stats.isDirectory()) {\n    return {\n      appliedChecks: [],\n      diagnostics: [\n        createDiagnostic(\n          \"error\",\n          \"target-not-directory\",\n          targetPath,\n          `Target path must be a directory: ${targetPath}`,\n        ),\n      ],\n      hasPackageJson: false,\n      repoMarkers: [],\n      targetPath,\n    };\n  }\n\n  const repoMarkers = (\n    await Promise.all(\n      REPO_MARKERS.map(async (marker) =>\n        (await pathExists(path.join(targetPath, marker.relativePath)))\n          ? marker.label\n          : null,\n      ),\n    )\n  ).filter((marker): marker is (typeof REPO_MARKERS)[number][\"label\"] => marker !== null);\n\n  const packageJsonPath = path.join(targetPath, \"package.json\");\n  const hasPackageJson = repoMarkers.includes(\"package.json\");\n  const appliedChecks: DoctorTargetCheck[] = [];\n  const diagnostics: DoctorDiagnostic[] = [];\n\n  const shouldRunRepoChecks =\n    request.mode === \"repo\" ||\n    ((request.mode === \"validate\" || request.mode === \"fix\") && repoMarkers.length > 0);\n  const shouldRunPackageChecks =\n    request.mode === \"package\" ||\n    ((request.mode === \"validate\" || request.mode === \"fix\") && hasPackageJson);\n\n  if (request.mode === \"repo\" && repoMarkers.length === 0) {\n    diagnostics.push(\n      createDiagnostic(\n        \"error\",\n        \"repo-markers-missing\",\n        targetPath,\n        \"Target is not a repo/workspace-root candidate because no repo markers were found.\",\n      ),\n    );\n  }\n\n  if (request.mode === \"package\" && !hasPackageJson) {\n    diagnostics.push(\n      createDiagnostic(\n        \"error\",\n        \"package-json-missing\",\n        packageJsonPath,\n        \"Target does not contain a readable package.json file.\",\n      ),\n    );\n  }\n\n  if (\n    (request.mode === \"validate\" || request.mode === \"fix\") &&\n    repoMarkers.length === 0 &&\n    !hasPackageJson\n  ) {\n    diagnostics.push(\n      createDiagnostic(\n        \"error\",\n        \"unsupported-target\",\n        targetPath,\n        \"Target is neither a repo/workspace-root candidate nor a package root.\",\n      ),\n    );\n  }\n\n  if (shouldRunRepoChecks && repoMarkers.length > 0) {\n    appliedChecks.push(\"repo\");\n    diagnostics.push(...(await analyzeRepoLight(targetPath)));\n  }\n\n  if (shouldRunPackageChecks && hasPackageJson) {\n    appliedChecks.push(\"package\");\n    diagnostics.push(...(await analyzePackageLight(targetPath, packageJsonPath)));\n  }\n\n  return {\n    appliedChecks,\n    diagnostics,\n    hasPackageJson,\n    repoMarkers,\n    targetPath,\n  };\n}\n\nasync function analyzeRepoLight(targetPath: string): Promise<DoctorDiagnostic[]> {\n  const diagnostics: DoctorDiagnostic[] = [];\n\n  await maybeWarnForMissingPath(diagnostics, targetPath, \"README.md\", \"missing-readme\");\n  await maybeWarnForMissingPath(\n    diagnostics,\n    targetPath,\n    \"CHANGELOG.md\",\n    \"missing-changelog\",\n  );\n  await maybeWarnForMissingPath(diagnostics, targetPath, \"LICENSE\", \"missing-license\");\n  await maybeWarnForMissingPath(\n    diagnostics,\n    targetPath,\n    \".changeset\",\n    \"missing-changeset-directory\",\n  );\n  await maybeWarnForMissingPath(\n    diagnostics,\n    targetPath,\n    path.join(\".github\", \"workflows\"),\n    \"missing-workflows-directory\",\n  );\n\n  return diagnostics;\n}\n\nasync function analyzePackageLight(\n  targetPath: string,\n  packageJsonPath: string,\n): Promise<DoctorDiagnostic[]> {\n  const diagnostics: DoctorDiagnostic[] = [];\n  let parsed: unknown;\n\n  try {\n    parsed = JSON.parse(await fs.readFile(packageJsonPath, \"utf8\")) as unknown;\n  } catch (error) {\n    diagnostics.push(\n      createDiagnostic(\n        \"error\",\n        \"invalid-package-json\",\n        packageJsonPath,\n        createInvalidPackageJsonMessage(error),\n      ),\n    );\n    return diagnostics;\n  }\n\n  if (!isRecord(parsed)) {\n    diagnostics.push(\n      createDiagnostic(\n        \"error\",\n        \"invalid-package-json\",\n        packageJsonPath,\n        \"package.json must contain a JSON object.\",\n      ),\n    );\n    return diagnostics;\n  }\n\n  if (!isNonEmptyString(parsed.name)) {\n    diagnostics.push(\n      createDiagnostic(\n        \"error\",\n        \"package-name-missing\",\n        packageJsonPath,\n        'package.json must define a non-empty \"name\" field.',\n      ),\n    );\n  }\n\n  if (!isNonEmptyString(parsed.version)) {\n    diagnostics.push(\n      createDiagnostic(\n        \"error\",\n        \"package-version-missing\",\n        packageJsonPath,\n        'package.json must define a non-empty \"version\" field.',\n      ),\n    );\n  }\n\n  if (!isNonEmptyString(parsed.type)) {\n    diagnostics.push(\n      createDiagnostic(\n        \"error\",\n        \"package-type-missing\",\n        packageJsonPath,\n        'package.json must define a non-empty \"type\" field.',\n      ),\n    );\n  }\n\n  if (\"ankh\" in parsed) {\n    const validationError = validateAnkhMetadataShape(parsed.ankh);\n    if (validationError !== null) {\n      diagnostics.push(\n        createDiagnostic(\"error\", \"invalid-ankh-metadata\", targetPath, validationError),\n      );\n    }\n  }\n\n  return diagnostics;\n}\n\nasync function maybeWarnForMissingPath(\n  diagnostics: DoctorDiagnostic[],\n  rootPath: string,\n  relativePath: string,\n  code:\n    | \"missing-changelog\"\n    | \"missing-changeset-directory\"\n    | \"missing-license\"\n    | \"missing-readme\"\n    | \"missing-workflows-directory\",\n): Promise<void> {\n  const absolutePath = path.join(rootPath, relativePath);\n  if (await pathExists(absolutePath)) {\n    return;\n  }\n\n  diagnostics.push(\n    createDiagnostic(\n      \"warning\",\n      code,\n      absolutePath,\n      `Missing expected repo artifact: ${relativePath}`,\n    ),\n  );\n}\n\nfunction validateAnkhMetadataShape(value: unknown): string | null {\n  if (!isRecord(value)) {\n    return 'package.json \"ankh\" metadata must be an object when present.';\n  }\n\n  if (!isNonEmptyString(value.category)) {\n    return 'package.json \"ankh.category\" must be a non-empty string.';\n  }\n\n  if (!(value.provider === null || isPackageRelativeProviderPath(value.provider))) {\n    return 'package.json \"ankh.provider\" must be null or a package-relative \"./...\" string.';\n  }\n\n  if (\n    !Array.isArray(value.capabilities) ||\n    value.capabilities.some((capability) => !isNonEmptyString(capability))\n  ) {\n    return 'package.json \"ankh.capabilities\" must be an array of non-empty strings.';\n  }\n\n  return null;\n}\n\nfunction createDiagnostic(\n  severity: DoctorDiagnostic[\"severity\"],\n  code: DoctorDiagnostic[\"code\"],\n  diagnosticPath: string,\n  message: string,\n): DoctorDiagnostic {\n  return {\n    code,\n    message,\n    path: diagnosticPath,\n    severity,\n  };\n}\n\nfunction createInvalidPackageJsonMessage(error: unknown): string {\n  const message = error instanceof Error ? error.message : String(error);\n  return `package.json contains invalid JSON: ${message}`;\n}\n\nasync function pathExists(targetPath: string): Promise<boolean> {\n  return (await statOrNull(targetPath)) !== null;\n}\n\nasync function statOrNull(targetPath: string) {\n  try {\n    return await fs.stat(targetPath);\n  } catch (error) {\n    if (isMissingPathError(error)) {\n      return null;\n    }\n\n    throw error;\n  }\n}\n\nfunction isMissingPathError(error: unknown): error is NodeJS.ErrnoException {\n  return (\n    error instanceof Error &&\n    \"code\" in error &&\n    typeof error.code === \"string\" &&\n    error.code === \"ENOENT\"\n  );\n}\n\nfunction isNonEmptyString(value: unknown): value is string {\n  return typeof value === \"string\" && value.trim() !== \"\";\n}\n\nfunction isPackageRelativeProviderPath(value: unknown): value is string {\n  return isNonEmptyString(value) && value.startsWith(\"./\");\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"]}

package/dist/ankh.provider.d.ts

@@ -0,0 +1,10 @@
+import type { AnkhRuntimeCommandProvider } from "@ankhorage/ankh";
+import { type DoctorCommandServices, type RunDoctorCommandImpl } from "./commands.js";
+export interface CreateDoctorRuntimeProviderOptions {
+    readonly runCommandImpl?: RunDoctorCommandImpl;
+    readonly services?: Partial<DoctorCommandServices>;
+}
+export declare function createDoctorRuntimeProvider(options?: CreateDoctorRuntimeProviderOptions): AnkhRuntimeCommandProvider;
+declare const provider: AnkhRuntimeCommandProvider;
+export default provider;
+//# sourceMappingURL=ankh.provider.d.ts.map

package/dist/ankh.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ankh.provider.d.ts","sourceRoot":"","sources":["../src/ankh.provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,EAIL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AAQvB,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,cAAc,CAAC,EAAE,oBAAoB,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACpD;AAED,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,kCAAuC,GAC/C,0BAA0B,CAyB5B;AAED,QAAA,MAAM,QAAQ,4BAAgC,CAAC;AAE/C,eAAe,QAAQ,CAAC"}

package/dist/ankh.provider.js

@@ -0,0 +1,27 @@
+import { createProviderCommandDescriptors, DOCTOR_COMMANDS, runDoctorCommand, } from "./commands.js";
+import { DOCTOR_CAPABILITIES, DOCTOR_COMMAND_CATEGORY, DOCTOR_PACKAGE_NAME, DOCTOR_PACKAGE_VERSION, } from "./packageMetadata.js";
+export function createDoctorRuntimeProvider(options = {}) {
+    const runCommandImpl = options.runCommandImpl ?? runDoctorCommand;
+    return {
+        id: DOCTOR_PACKAGE_NAME,
+        category: DOCTOR_COMMAND_CATEGORY,
+        version: DOCTOR_PACKAGE_VERSION,
+        capabilities: [...DOCTOR_CAPABILITIES],
+        commands: createProviderCommandDescriptors(),
+        handlers: DOCTOR_COMMANDS.map((command) => ({
+            path: command.path,
+            handler(request) {
+                return runCommandImpl({
+                    argv: request.argv,
+                    command,
+                    context: request.context,
+                }, {
+                    services: options.services,
+                });
+            },
+        })),
+    };
+}
+const provider = createDoctorRuntimeProvider();
+export default provider;
+//# sourceMappingURL=ankh.provider.js.map

package/dist/ankh.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ankh.provider.js","sourceRoot":"","sources":["../src/ankh.provider.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gCAAgC,EAChC,eAAe,EACf,gBAAgB,GAGjB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAO9B,MAAM,UAAU,2BAA2B,CACzC,UAA8C,EAAE;IAEhD,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,gBAAgB,CAAC;IAElE,OAAO;QACL,EAAE,EAAE,mBAAmB;QACvB,QAAQ,EAAE,uBAAuB;QACjC,OAAO,EAAE,sBAAsB;QAC/B,YAAY,EAAE,CAAC,GAAG,mBAAmB,CAAC;QACtC,QAAQ,EAAE,gCAAgC,EAAE;QAC5C,QAAQ,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC1C,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,CAAC,OAAO;gBACb,OAAO,cAAc,CACnB;oBACE,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,OAAO;oBACP,OAAO,EAAE,OAAO,CAAC,OAAO;iBACzB,EACD;oBACE,QAAQ,EAAE,OAAO,CAAC,QAAQ;iBAC3B,CACF,CAAC;YACJ,CAAC;SACF,CAAC,CAAC;KACiC,CAAC;AACzC,CAAC;AAED,MAAM,QAAQ,GAAG,2BAA2B,EAAE,CAAC;AAE/C,eAAe,QAAQ,CAAC","sourcesContent":["import type { AnkhRuntimeCommandProvider } from \"@ankhorage/ankh\";\n\nimport {\n  createProviderCommandDescriptors,\n  DOCTOR_COMMANDS,\n  runDoctorCommand,\n  type DoctorCommandServices,\n  type RunDoctorCommandImpl,\n} from \"./commands.js\";\nimport {\n  DOCTOR_CAPABILITIES,\n  DOCTOR_COMMAND_CATEGORY,\n  DOCTOR_PACKAGE_NAME,\n  DOCTOR_PACKAGE_VERSION,\n} from \"./packageMetadata.js\";\n\nexport interface CreateDoctorRuntimeProviderOptions {\n  readonly runCommandImpl?: RunDoctorCommandImpl;\n  readonly services?: Partial<DoctorCommandServices>;\n}\n\nexport function createDoctorRuntimeProvider(\n  options: CreateDoctorRuntimeProviderOptions = {},\n): AnkhRuntimeCommandProvider {\n  const runCommandImpl = options.runCommandImpl ?? runDoctorCommand;\n\n  return {\n    id: DOCTOR_PACKAGE_NAME,\n    category: DOCTOR_COMMAND_CATEGORY,\n    version: DOCTOR_PACKAGE_VERSION,\n    capabilities: [...DOCTOR_CAPABILITIES],\n    commands: createProviderCommandDescriptors(),\n    handlers: DOCTOR_COMMANDS.map((command) => ({\n      path: command.path,\n      handler(request) {\n        return runCommandImpl(\n          {\n            argv: request.argv,\n            command,\n            context: request.context,\n          },\n          {\n            services: options.services,\n          },\n        );\n      },\n    })),\n  } satisfies AnkhRuntimeCommandProvider;\n}\n\nconst provider = createDoctorRuntimeProvider();\n\nexport default provider;\n"]}

package/dist/cli.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env bun
+import type { DoctorCommandContext, DoctorCommandRunResult } from "./commandContext.js";
+import { type DoctorCommandServices, type RunDoctorCommandImpl } from "./commands.js";
+export interface DoctorCliOptions {
+    readonly context?: DoctorCommandContext;
+    readonly runCommandImpl?: RunDoctorCommandImpl;
+    readonly services?: Partial<DoctorCommandServices>;
+}
+export declare function runCli(argv: readonly string[], options?: DoctorCliOptions): Promise<DoctorCommandRunResult>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAExF,OAAO,EAKL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,oBAAoB,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACpD;AAED,wBAAsB,MAAM,CAC1B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,sBAAsB,CAAC,CA+BjC"}

package/dist/cli.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env bun
+import { createDefaultCommandContext } from "./commandContext.js";
+import { findDoctorCommandByStandaloneName, renderRootHelp, renderUnknownCommand, runDoctorCommand, } from "./commands.js";
+export async function runCli(argv, options = {}) {
+    const context = options.context ?? createDefaultCommandContext();
+    const runCommand = options.runCommandImpl ?? runDoctorCommand;
+    const [firstToken, ...restTokens] = argv;
+    if (firstToken === undefined || isHelpToken(firstToken)) {
+        context.writeStdout(renderRootHelp(context.version));
+        return { exitCode: 0 };
+    }
+    if (isVersionToken(firstToken)) {
+        context.writeStdout(`${context.version}\n`);
+        return { exitCode: 0 };
+    }
+    const command = findDoctorCommandByStandaloneName(firstToken);
+    if (command === null) {
+        context.writeStderr(renderUnknownCommand(firstToken));
+        return { exitCode: 1 };
+    }
+    return runCommand({
+        argv: restTokens,
+        command,
+        context,
+    }, {
+        services: options.services,
+    });
+}
+function isHelpToken(value) {
+    return value === "--help" || value === "-h" || value === "help";
+}
+function isVersionToken(value) {
+    return value === "--version" || value === "-v" || value === "version";
+}
+if (import.meta.main) {
+    const result = await runCli(process.argv.slice(2));
+    process.exit(result.exitCode);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EACL,iCAAiC,EACjC,cAAc,EACd,oBAAoB,EACpB,gBAAgB,GAGjB,MAAM,eAAe,CAAC;AAQvB,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,IAAuB,EACvB,UAA4B,EAAE;IAE9B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,2BAA2B,EAAE,CAAC;IACjE,MAAM,UAAU,GAAG,OAAO,CAAC,cAAc,IAAI,gBAAgB,CAAC;IAC9D,MAAM,CAAC,UAAU,EAAE,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC;IAEzC,IAAI,UAAU,KAAK,SAAS,IAAI,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;QACxD,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACrD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACzB,CAAC;IAED,IAAI,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;QAC5C,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACzB,CAAC;IAED,MAAM,OAAO,GAAG,iCAAiC,CAAC,UAAU,CAAC,CAAC;IAC9D,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC;QACtD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACzB,CAAC;IAED,OAAO,UAAU,CACf;QACE,IAAI,EAAE,UAAU;QAChB,OAAO;QACP,OAAO;KACR,EACD;QACE,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CACF,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC;AAClE,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AACxE,CAAC;AAED,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC","sourcesContent":["#!/usr/bin/env bun\n\nimport type { DoctorCommandContext, DoctorCommandRunResult } from \"./commandContext.js\";\nimport { createDefaultCommandContext } from \"./commandContext.js\";\nimport {\n  findDoctorCommandByStandaloneName,\n  renderRootHelp,\n  renderUnknownCommand,\n  runDoctorCommand,\n  type DoctorCommandServices,\n  type RunDoctorCommandImpl,\n} from \"./commands.js\";\n\nexport interface DoctorCliOptions {\n  readonly context?: DoctorCommandContext;\n  readonly runCommandImpl?: RunDoctorCommandImpl;\n  readonly services?: Partial<DoctorCommandServices>;\n}\n\nexport async function runCli(\n  argv: readonly string[],\n  options: DoctorCliOptions = {},\n): Promise<DoctorCommandRunResult> {\n  const context = options.context ?? createDefaultCommandContext();\n  const runCommand = options.runCommandImpl ?? runDoctorCommand;\n  const [firstToken, ...restTokens] = argv;\n\n  if (firstToken === undefined || isHelpToken(firstToken)) {\n    context.writeStdout(renderRootHelp(context.version));\n    return { exitCode: 0 };\n  }\n\n  if (isVersionToken(firstToken)) {\n    context.writeStdout(`${context.version}\\n`);\n    return { exitCode: 0 };\n  }\n\n  const command = findDoctorCommandByStandaloneName(firstToken);\n  if (command === null) {\n    context.writeStderr(renderUnknownCommand(firstToken));\n    return { exitCode: 1 };\n  }\n\n  return runCommand(\n    {\n      argv: restTokens,\n      command,\n      context,\n    },\n    {\n      services: options.services,\n    },\n  );\n}\n\nfunction isHelpToken(value: string): boolean {\n  return value === \"--help\" || value === \"-h\" || value === \"help\";\n}\n\nfunction isVersionToken(value: string): boolean {\n  return value === \"--version\" || value === \"-v\" || value === \"version\";\n}\n\nif (import.meta.main) {\n  const result = await runCli(process.argv.slice(2));\n  process.exit(result.exitCode);\n}\n"]}

package/dist/commandContext.d.ts

@@ -0,0 +1,12 @@
+export interface DoctorCommandContext {
+    readonly cwd: string;
+    readonly env: NodeJS.ProcessEnv;
+    readonly version: string;
+    writeStdout(text: string): void;
+    writeStderr(text: string): void;
+}
+export interface DoctorCommandRunResult {
+    readonly exitCode: number;
+}
+export declare function createDefaultCommandContext(): DoctorCommandContext;
+//# sourceMappingURL=commandContext.d.ts.map

package/dist/commandContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandContext.d.ts","sourceRoot":"","sources":["../src/commandContext.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,2BAA2B,IAAI,oBAAoB,CAYlE"}

package/dist/commandContext.js

@@ -0,0 +1,15 @@
+import packageJson from "../package.json";
+export function createDefaultCommandContext() {
+    return {
+        cwd: process.cwd(),
+        env: process.env,
+        version: packageJson.version,
+        writeStdout(text) {
+            process.stdout.write(text);
+        },
+        writeStderr(text) {
+            process.stderr.write(text);
+        },
+    };
+}
+//# sourceMappingURL=commandContext.js.map

package/dist/commandContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandContext.js","sourceRoot":"","sources":["../src/commandContext.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,iBAAiB,CAAC;AAc1C,MAAM,UAAU,2BAA2B;IACzC,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,WAAW,CAAC,IAAY;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,WAAW,CAAC,IAAY;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import packageJson from \"../package.json\";\n\nexport interface DoctorCommandContext {\n  readonly cwd: string;\n  readonly env: NodeJS.ProcessEnv;\n  readonly version: string;\n  writeStdout(text: string): void;\n  writeStderr(text: string): void;\n}\n\nexport interface DoctorCommandRunResult {\n  readonly exitCode: number;\n}\n\nexport function createDefaultCommandContext(): DoctorCommandContext {\n  return {\n    cwd: process.cwd(),\n    env: process.env,\n    version: packageJson.version,\n    writeStdout(text: string) {\n      process.stdout.write(text);\n    },\n    writeStderr(text: string) {\n      process.stderr.write(text);\n    },\n  };\n}\n"]}

package/dist/commands.d.ts

@@ -0,0 +1,71 @@
+import type { AnkhCapabilityId, AnkhCommandDescriptor } from "@ankhorage/contracts/cli";
+import type { DoctorTargetMode } from "./analysis.js";
+import { analyzeDoctorTarget } from "./analysis.js";
+import type { DoctorCommandContext, DoctorCommandRunResult } from "./commandContext.js";
+type DoctorCommandName = "fix" | "package" | "repo" | "validate";
+interface DoctorCommandRunRequest {
+    readonly context: DoctorCommandContext;
+    readonly inputPath?: string;
+}
+type DoctorCommandImplementation = (request: DoctorCommandRunRequest, services: DoctorCommandServices) => Promise<DoctorCommandRunResult>;
+export interface DoctorCommandDefinition {
+    readonly capability: AnkhCapabilityId;
+    readonly mode: DoctorTargetMode;
+    readonly path: readonly [DoctorCommandName];
+    readonly standaloneName: DoctorCommandName;
+    readonly summary: string;
+    readonly run: DoctorCommandImplementation;
+}
+export interface DoctorCommandInvocation {
+    readonly argv: readonly string[];
+    readonly command: DoctorCommandDefinition;
+    readonly context: DoctorCommandContext;
+}
+export interface DoctorCommandServices {
+    readonly analyzeTarget: typeof analyzeDoctorTarget;
+}
+export interface RunDoctorCommandOptions {
+    readonly runCommandImpl?: RunDoctorCommandImpl;
+    readonly services?: Partial<DoctorCommandServices>;
+}
+export type RunDoctorCommandImpl = (request: DoctorCommandInvocation, options?: RunDoctorCommandOptions) => Promise<DoctorCommandRunResult>;
+export declare const DOCTOR_COMMANDS: readonly [{
+    readonly standaloneName: "validate";
+    readonly path: readonly ["validate"];
+    readonly capability: "doctor.validate";
+    readonly mode: "validate";
+    readonly summary: "Auto-detect lightweight repo and package diagnostics for a local path.";
+    readonly run: typeof runValidateCommand;
+}, {
+    readonly standaloneName: "fix";
+    readonly path: readonly ["fix"];
+    readonly capability: "doctor.fix";
+    readonly mode: "fix";
+    readonly summary: "Run the same lightweight checks and report that no automatic fixes exist yet.";
+    readonly run: typeof runFixCommand;
+}, {
+    readonly standaloneName: "repo";
+    readonly path: readonly ["repo"];
+    readonly capability: "doctor.repo";
+    readonly mode: "repo";
+    readonly summary: "Force repo-light diagnostics for a repo/workspace-root candidate path.";
+    readonly run: typeof runRepoCommand;
+}, {
+    readonly standaloneName: "package";
+    readonly path: readonly ["package"];
+    readonly capability: "doctor.package";
+    readonly mode: "package";
+    readonly summary: "Force package-light diagnostics for a directory containing package.json.";
+    readonly run: typeof runPackageCommand;
+}];
+export declare function runDoctorCommand(request: DoctorCommandInvocation, options?: RunDoctorCommandOptions): Promise<DoctorCommandRunResult>;
+export declare function createProviderCommandDescriptors(): readonly AnkhCommandDescriptor[];
+export declare function findDoctorCommandByStandaloneName(value: string): DoctorCommandDefinition | null;
+export declare function renderRootHelp(version: string): string;
+export declare function renderUnknownCommand(value: string): string;
+declare function runValidateCommand(request: DoctorCommandRunRequest, services: DoctorCommandServices): Promise<DoctorCommandRunResult>;
+declare function runFixCommand(request: DoctorCommandRunRequest, services: DoctorCommandServices): Promise<DoctorCommandRunResult>;
+declare function runRepoCommand(request: DoctorCommandRunRequest, services: DoctorCommandServices): Promise<DoctorCommandRunResult>;
+declare function runPackageCommand(request: DoctorCommandRunRequest, services: DoctorCommandServices): Promise<DoctorCommandRunResult>;
+export {};
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAwB,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAOpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAExF,KAAK,iBAAiB,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAEjE,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,KAAK,2BAA2B,GAAG,CACjC,OAAO,EAAE,uBAAuB,EAChC,QAAQ,EAAE,qBAAqB,KAC5B,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAErC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAC5C,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,2BAA2B,CAAC;CAC3C;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;CACxC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,aAAa,EAAE,OAAO,mBAAmB,CAAC;CACpD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,oBAAoB,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACpD;AAED,MAAM,MAAM,oBAAoB,GAAG,CACjC,OAAO,EAAE,uBAAuB,EAChC,OAAO,CAAC,EAAE,uBAAuB,KAC9B,OAAO,CAAC,sBAAsB,CAAC,CAAC;AASrC,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiC2B,CAAC;AAExD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,uBAAuB,EAChC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAuBjC;AAED,wBAAgB,gCAAgC,IAAI,SAAS,qBAAqB,EAAE,CAMnF;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,MAAM,GACZ,uBAAuB,GAAG,IAAI,CAEhC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAmBtD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO1D;AA4CD,iBAAe,kBAAkB,CAC/B,OAAO,EAAE,uBAAuB,EAChC,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAYjC;AAED,iBAAe,aAAa,CAC1B,OAAO,EAAE,uBAAuB,EAChC,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAajC;AAED,iBAAe,cAAc,CAC3B,OAAO,EAAE,uBAAuB,EAChC,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAYjC;AAED,iBAAe,iBAAiB,CAC9B,OAAO,EAAE,uBAAuB,EAChC,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAYjC"}