@ankhorage/doctor 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.5.0
+
+### Minor Changes
+
+- 23a5302: Validate canonical `./cli` exports, reject `@ankh/*` workspace aliases and active `ankhorage4` source references, and enforce direct Studio ownership of runtime and drag-and-drop packages.
+
 ## 0.4.0
 
 ### Minor Changes

package/README.md

@@ -3,9 +3,9 @@
 
 # DOCTOR
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v0.3.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)
+![license: MIT](././paradox/badges/license.svg) ![npm: v0.4.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 repo and package compliance diagnostics.
+Executable doctor provider and standalone CLI for lightweight Ankhorage repo and package compliance diagnostics.
 
 ## Usage
 

package/dist/cliLayoutAnalysis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cliLayoutAnalysis.d.ts","sourceRoot":"","sources":["../src/cliLayoutAnalysis.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AAMvB,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAkB/B"}
+{"version":3,"file":"cliLayoutAnalysis.d.ts","sourceRoot":"","sources":["../src/cliLayoutAnalysis.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AAsDvB,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CA6B/B"}

package/dist/cliLayoutAnalysis.js

@@ -3,55 +3,319 @@ import path from 'node:path';
 import { analyzeDoctorTarget, } from './analysis.js';
 const LEGACY_ROOT_CLI_SOURCE = path.join('src', 'cli.ts');
 const CANONICAL_CLI_INDEX_SOURCE = path.join('src', 'cli', 'index.ts');
+const ACTIVE_SOURCE_ROOTS = ['src', 'app', 'apps', 'packages', 'scripts'];
+const ACTIVE_SOURCE_EXTENSIONS = new Set([
+    '.cjs',
+    '.cts',
+    '.js',
+    '.jsx',
+    '.mjs',
+    '.mts',
+    '.ts',
+    '.tsx',
+]);
+const IGNORED_SOURCE_DIRECTORIES = new Set([
+    '.expo',
+    '.git',
+    '.next',
+    '__fixtures__',
+    '__tests__',
+    'build',
+    'coverage',
+    'dist',
+    'docs',
+    'fixtures',
+    'node_modules',
+    'paradox',
+    'test',
+    'tests',
+]);
+const COMPATIBILITY_PACKAGE_PREFIX = '@ankh/';
+const STUDIO_PACKAGE_NAME = '@ankhorage/studio';
+const STUDIO_DND_PACKAGE_NAME = '@ankhorage/react-native-reanimated-dnd-web';
+const STUDIO_RUNTIME_PACKAGE_NAME = '@ankhorage/runtime';
+const DEPENDENCY_FIELD_NAMES = [
+    'dependencies',
+    'devDependencies',
+    'optionalDependencies',
+    'peerDependencies',
+];
 export async function analyzeDoctorTargetWithCliLayout(request) {
     const result = await analyzeDoctorTarget(request);
     if (!result.hasPackageJson) {
         return result;
     }
-    const cliDiagnostics = await analyzeCliLayout(result.targetPath, result.profile);
-    if (cliDiagnostics.length === 0) {
+    const packageJsonPath = path.join(result.targetPath, 'package.json');
+    const packageJson = await readPackageJson(packageJsonPath);
+    if (packageJson === null) {
         return result;
     }
-    const diagnostics = [...result.diagnostics, ...cliDiagnostics];
+    const architectureDiagnostics = await analyzeTargetArchitecture({
+        packageJson,
+        packageJsonPath,
+        profile: result.profile,
+        targetPath: result.targetPath,
+    });
+    if (architectureDiagnostics.length === 0) {
+        return result;
+    }
+    const diagnostics = [...result.diagnostics, ...architectureDiagnostics];
     return {
         ...result,
         diagnostics,
         fixPlan: result.fixPlan === null ? null : { ...result.fixPlan, diagnostics },
     };
 }
-async function analyzeCliLayout(targetPath, profile) {
+async function analyzeTargetArchitecture(request) {
     const diagnostics = [];
-    const legacyRootCliPath = path.join(targetPath, LEGACY_ROOT_CLI_SOURCE);
-    const canonicalCliIndexPath = path.join(targetPath, CANONICAL_CLI_INDEX_SOURCE);
+    const legacyRootCliPath = path.join(request.targetPath, LEGACY_ROOT_CLI_SOURCE);
+    const canonicalCliIndexPath = path.join(request.targetPath, CANONICAL_CLI_INDEX_SOURCE);
+    const exportsField = isRecord(request.packageJson.exports) ? request.packageJson.exports : null;
+    const cliCapable = hasAnkhProvider(request.packageJson) ||
+        exportsField?.['./cli'] !== undefined ||
+        (await pathExists(canonicalCliIndexPath));
     if (await pathExists(legacyRootCliPath)) {
         diagnostics.push({
             code: 'field-invalid',
             message: 'Package CLI code must live under src/cli/; root src/cli.ts is not allowed.',
             path: legacyRootCliPath,
-            profile,
+            profile: request.profile,
             ruleId: 'package.cli.root-file.disallowed',
             severity: 'error',
         });
     }
-    const packageJson = await readPackageJson(path.join(targetPath, 'package.json'));
-    if (packageJson !== null &&
-        exposesCliProvider(packageJson) &&
-        !(await pathExists(canonicalCliIndexPath))) {
+    if (cliCapable && !(await pathExists(canonicalCliIndexPath))) {
         diagnostics.push({
             code: 'missing-path',
             message: 'CLI-capable packages must expose their provider from src/cli/index.ts.',
             path: canonicalCliIndexPath,
-            profile,
+            profile: request.profile,
             ruleId: 'package.cli.index.required',
             severity: 'error',
         });
     }
+    if (cliCapable && exportsField?.['./cli'] === undefined) {
+        diagnostics.push({
+            code: 'field-missing',
+            message: 'CLI-capable packages must export "./cli" from package.json and point it at the owning src/cli/index.ts build output.',
+            path: request.packageJsonPath,
+            profile: request.profile,
+            ruleId: 'package.cli.export.required',
+            severity: 'error',
+        });
+    }
+    const dependencyEntries = collectDependencyEntries(request.packageJson);
+    diagnostics.push(...validateDependencyArchitecture({
+        dependencyEntries,
+        packageJsonPath: request.packageJsonPath,
+        profile: request.profile,
+    }));
+    const activeSourceImports = await collectActiveSourceImports(request.targetPath);
+    diagnostics.push(...validateActiveSourceImports({
+        activeSourceImports,
+        profile: request.profile,
+    }));
+    if (request.packageJson.name === STUDIO_PACKAGE_NAME) {
+        diagnostics.push(...validateStudioOwnership({
+            activeSourceImports,
+            dependencyEntries,
+            packageJsonPath: request.packageJsonPath,
+            profile: request.profile,
+        }));
+    }
+    return diagnostics;
+}
+function validateDependencyArchitecture(request) {
+    const diagnostics = [];
+    for (const dependency of request.dependencyEntries) {
+        if (dependency.packageName.startsWith(COMPATIBILITY_PACKAGE_PREFIX)) {
+            diagnostics.push({
+                code: 'field-invalid',
+                message: `Dependency "${dependency.packageName}" in package.json.${dependency.fieldName} is an old ankhorage4 workspace alias. Depend on "${toOwningPackageSpecifier(dependency.packageName)}" directly.`,
+                path: request.packageJsonPath,
+                profile: request.profile,
+                ruleId: 'package.dependencies.ankh-workspace-alias.disallowed',
+                severity: 'error',
+            });
+        }
+        if (dependency.packageName.includes('ankhorage4') ||
+            dependency.version.includes('ankhorage4')) {
+            diagnostics.push({
+                code: 'field-invalid',
+                message: `Dependency "${dependency.packageName}" references ankhorage4 as active source. Depend on the extracted owning @ankhorage/* package instead.`,
+                path: request.packageJsonPath,
+                profile: request.profile,
+                ruleId: 'package.dependencies.ankhorage4-source.disallowed',
+                severity: 'error',
+            });
+        }
+    }
+    return diagnostics;
+}
+function validateActiveSourceImports(request) {
+    const diagnostics = [];
+    for (const sourceImport of request.activeSourceImports) {
+        if (sourceImport.specifier.startsWith(COMPATIBILITY_PACKAGE_PREFIX)) {
+            diagnostics.push({
+                code: 'field-invalid',
+                message: `Import "${sourceImport.specifier}" is an old ankhorage4 compatibility boundary. Import "${toOwningPackageSpecifier(sourceImport.specifier)}" directly from the owning package.`,
+                path: sourceImport.filePath,
+                profile: request.profile,
+                ruleId: 'package.imports.ankh-workspace-alias.disallowed',
+                severity: 'error',
+            });
+        }
+        if (sourceImport.specifier.includes('ankhorage4')) {
+            diagnostics.push({
+                code: 'field-invalid',
+                message: `Import "${sourceImport.specifier}" references ankhorage4 as active source. Import the extracted owning @ankhorage/* package instead.`,
+                path: sourceImport.filePath,
+                profile: request.profile,
+                ruleId: 'package.imports.ankhorage4-source.disallowed',
+                severity: 'error',
+            });
+        }
+    }
     return diagnostics;
 }
-function exposesCliProvider(packageJson) {
+function validateStudioOwnership(request) {
+    const diagnostics = [];
+    const directDependencies = new Set(request.dependencyEntries
+        .filter((dependency) => dependency.fieldName === 'dependencies')
+        .map((dependency) => dependency.packageName));
+    const importedSpecifiers = request.activeSourceImports.map((sourceImport) => sourceImport.specifier);
+    if (!directDependencies.has(STUDIO_DND_PACKAGE_NAME)) {
+        diagnostics.push({
+            code: 'missing-dependency',
+            message: `@ankhorage/studio must depend directly on "${STUDIO_DND_PACKAGE_NAME}" for Studio drag-and-drop ownership.`,
+            path: request.packageJsonPath,
+            profile: request.profile,
+            ruleId: 'studio.dependencies.dnd.required',
+            severity: 'error',
+        });
+    }
+    if (!directDependencies.has(STUDIO_RUNTIME_PACKAGE_NAME)) {
+        diagnostics.push({
+            code: 'missing-dependency',
+            message: `@ankhorage/studio must depend directly on "${STUDIO_RUNTIME_PACKAGE_NAME}" for runtime ownership.`,
+            path: request.packageJsonPath,
+            profile: request.profile,
+            ruleId: 'studio.dependencies.runtime.required',
+            severity: 'error',
+        });
+    }
+    if (!importedSpecifiers.some((specifier) => isPackageImport(specifier, STUDIO_DND_PACKAGE_NAME))) {
+        diagnostics.push({
+            code: 'field-missing',
+            message: `@ankhorage/studio must import "${STUDIO_DND_PACKAGE_NAME}" directly from its Studio DnD boundary.`,
+            path: request.packageJsonPath,
+            profile: request.profile,
+            ruleId: 'studio.imports.dnd.required',
+            severity: 'error',
+        });
+    }
+    if (!importedSpecifiers.some((specifier) => isPackageImport(specifier, STUDIO_RUNTIME_PACKAGE_NAME))) {
+        diagnostics.push({
+            code: 'field-missing',
+            message: `@ankhorage/studio must import "${STUDIO_RUNTIME_PACKAGE_NAME}" directly from the owning runtime package.`,
+            path: request.packageJsonPath,
+            profile: request.profile,
+            ruleId: 'studio.imports.runtime.required',
+            severity: 'error',
+        });
+    }
+    return diagnostics;
+}
+async function collectActiveSourceImports(targetPath) {
+    const imports = [];
+    for (const sourceRoot of ACTIVE_SOURCE_ROOTS) {
+        const sourceRootPath = path.join(targetPath, sourceRoot);
+        if (!(await pathExists(sourceRootPath))) {
+            continue;
+        }
+        for (const filePath of await listActiveSourceFiles(sourceRootPath)) {
+            const source = await fs.readFile(filePath, 'utf8');
+            for (const specifier of extractImportSpecifiers(source)) {
+                imports.push({ filePath, specifier });
+            }
+        }
+    }
+    return imports;
+}
+async function listActiveSourceFiles(rootPath) {
+    const files = [];
+    await visit(rootPath);
+    return files.sort((left, right) => left.localeCompare(right));
+    async function visit(currentPath) {
+        const entries = await fs.readdir(currentPath, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                if (!IGNORED_SOURCE_DIRECTORIES.has(entry.name)) {
+                    await visit(path.join(currentPath, entry.name));
+                }
+                continue;
+            }
+            if (!entry.isFile()) {
+                continue;
+            }
+            const filePath = path.join(currentPath, entry.name);
+            if (isActiveSourceFile(filePath)) {
+                files.push(filePath);
+            }
+        }
+    }
+}
+function isActiveSourceFile(filePath) {
+    if (!ACTIVE_SOURCE_EXTENSIONS.has(path.extname(filePath))) {
+        return false;
+    }
+    return !/(?:^|\.)(?:spec|test)\.[cm]?[jt]sx?$/.test(path.basename(filePath));
+}
+function extractImportSpecifiers(source) {
+    const specifiers = new Set();
+    const patterns = [
+        /\b(?:import|export)\s+(?:type\s+)?(?:[^;]*?\sfrom\s*)?['"]([^'"]+)['"]/g,
+        /\b(?:import|require)\s*\(\s*['"]([^'"]+)['"]\s*\)/g,
+    ];
+    for (const pattern of patterns) {
+        for (const match of source.matchAll(pattern)) {
+            const [, specifier] = match;
+            if (specifier !== undefined) {
+                specifiers.add(specifier);
+            }
+        }
+    }
+    return [...specifiers].sort((left, right) => left.localeCompare(right));
+}
+function collectDependencyEntries(packageJson) {
+    const entries = [];
+    for (const fieldName of DEPENDENCY_FIELD_NAMES) {
+        const dependencies = isRecord(packageJson[fieldName]) ? packageJson[fieldName] : null;
+        if (dependencies === null) {
+            continue;
+        }
+        for (const [packageName, version] of Object.entries(dependencies)) {
+            if (isNonEmptyString(version)) {
+                entries.push({ fieldName, packageName, version });
+            }
+        }
+    }
+    return entries.sort((left, right) => {
+        const fieldComparison = left.fieldName.localeCompare(right.fieldName);
+        return fieldComparison !== 0
+            ? fieldComparison
+            : left.packageName.localeCompare(right.packageName);
+    });
+}
+function hasAnkhProvider(packageJson) {
     const ankh = isRecord(packageJson.ankh) ? packageJson.ankh : null;
-    const exportsField = isRecord(packageJson.exports) ? packageJson.exports : null;
-    return isNonEmptyString(ankh?.provider) || exportsField?.['./cli'] !== undefined;
+    return isNonEmptyString(ankh?.provider);
+}
+function isPackageImport(specifier, packageName) {
+    return specifier === packageName || specifier.startsWith(`${packageName}/`);
+}
+function toOwningPackageSpecifier(specifier) {
+    return `@ankhorage/${specifier.slice(COMPATIBILITY_PACKAGE_PREFIX.length)}`;
 }
 async function readPackageJson(packageJsonPath) {
     try {

package/dist/cliLayoutAnalysis.js.map

@@ -1 +1 @@
-{"version":3,"file":"cliLayoutAnalysis.js","sourceRoot":"","sources":["../src/cliLayoutAnalysis.ts"],"names":[],"mappings":"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","sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\n\nimport {\n  analyzeDoctorTarget,\n  type DoctorAnalysisRequest,\n  type DoctorAnalysisResult,\n} from './analysis.js';\nimport type { DoctorDiagnostic, DoctorPolicyProfile } from './diagnostics.js';\n\nconst LEGACY_ROOT_CLI_SOURCE = path.join('src', 'cli.ts');\nconst CANONICAL_CLI_INDEX_SOURCE = path.join('src', 'cli', 'index.ts');\n\nexport async function analyzeDoctorTargetWithCliLayout(\n  request: DoctorAnalysisRequest,\n): Promise<DoctorAnalysisResult> {\n  const result = await analyzeDoctorTarget(request);\n  if (!result.hasPackageJson) {\n    return result;\n  }\n\n  const cliDiagnostics = await analyzeCliLayout(result.targetPath, result.profile);\n  if (cliDiagnostics.length === 0) {\n    return result;\n  }\n\n  const diagnostics = [...result.diagnostics, ...cliDiagnostics];\n\n  return {\n    ...result,\n    diagnostics,\n    fixPlan: result.fixPlan === null ? null : { ...result.fixPlan, diagnostics },\n  };\n}\n\nasync function analyzeCliLayout(\n  targetPath: string,\n  profile: DoctorPolicyProfile,\n): Promise<DoctorDiagnostic[]> {\n  const diagnostics: DoctorDiagnostic[] = [];\n  const legacyRootCliPath = path.join(targetPath, LEGACY_ROOT_CLI_SOURCE);\n  const canonicalCliIndexPath = path.join(targetPath, CANONICAL_CLI_INDEX_SOURCE);\n\n  if (await pathExists(legacyRootCliPath)) {\n    diagnostics.push({\n      code: 'field-invalid',\n      message: 'Package CLI code must live under src/cli/; root src/cli.ts is not allowed.',\n      path: legacyRootCliPath,\n      profile,\n      ruleId: 'package.cli.root-file.disallowed',\n      severity: 'error',\n    });\n  }\n\n  const packageJson = await readPackageJson(path.join(targetPath, 'package.json'));\n  if (\n    packageJson !== null &&\n    exposesCliProvider(packageJson) &&\n    !(await pathExists(canonicalCliIndexPath))\n  ) {\n    diagnostics.push({\n      code: 'missing-path',\n      message: 'CLI-capable packages must expose their provider from src/cli/index.ts.',\n      path: canonicalCliIndexPath,\n      profile,\n      ruleId: 'package.cli.index.required',\n      severity: 'error',\n    });\n  }\n\n  return diagnostics;\n}\n\nfunction exposesCliProvider(packageJson: Record<string, unknown>): boolean {\n  const ankh = isRecord(packageJson.ankh) ? packageJson.ankh : null;\n  const exportsField = isRecord(packageJson.exports) ? packageJson.exports : null;\n\n  return isNonEmptyString(ankh?.provider) || exportsField?.['./cli'] !== undefined;\n}\n\nasync function readPackageJson(packageJsonPath: string): Promise<Record<string, unknown> | null> {\n  try {\n    const parsed: unknown = JSON.parse(await fs.readFile(packageJsonPath, 'utf8'));\n    return isRecord(parsed) ? parsed : null;\n  } catch {\n    return null;\n  }\n}\n\nasync function pathExists(targetPath: string): Promise<boolean> {\n  try {\n    await fs.access(targetPath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction isNonEmptyString(value: unknown): value is string {\n  return typeof value === 'string' && value.trim().length > 0;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n"]}
+{"version":3,"file":"cliLayoutAnalysis.js","sourceRoot":"","sources":["../src/cliLayoutAnalysis.ts"],"names":[],"mappings":"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","sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\n\nimport {\n  analyzeDoctorTarget,\n  type DoctorAnalysisRequest,\n  type DoctorAnalysisResult,\n} from './analysis.js';\nimport type { DoctorDiagnostic, DoctorPolicyProfile } from './diagnostics.js';\n\nconst LEGACY_ROOT_CLI_SOURCE = path.join('src', 'cli.ts');\nconst CANONICAL_CLI_INDEX_SOURCE = path.join('src', 'cli', 'index.ts');\nconst ACTIVE_SOURCE_ROOTS = ['src', 'app', 'apps', 'packages', 'scripts'] as const;\nconst ACTIVE_SOURCE_EXTENSIONS = new Set([\n  '.cjs',\n  '.cts',\n  '.js',\n  '.jsx',\n  '.mjs',\n  '.mts',\n  '.ts',\n  '.tsx',\n]);\nconst IGNORED_SOURCE_DIRECTORIES = new Set([\n  '.expo',\n  '.git',\n  '.next',\n  '__fixtures__',\n  '__tests__',\n  'build',\n  'coverage',\n  'dist',\n  'docs',\n  'fixtures',\n  'node_modules',\n  'paradox',\n  'test',\n  'tests',\n]);\nconst COMPATIBILITY_PACKAGE_PREFIX = '@ankh/';\nconst STUDIO_PACKAGE_NAME = '@ankhorage/studio';\nconst STUDIO_DND_PACKAGE_NAME = '@ankhorage/react-native-reanimated-dnd-web';\nconst STUDIO_RUNTIME_PACKAGE_NAME = '@ankhorage/runtime';\nconst DEPENDENCY_FIELD_NAMES = [\n  'dependencies',\n  'devDependencies',\n  'optionalDependencies',\n  'peerDependencies',\n] as const;\n\ninterface ActiveSourceImport {\n  readonly filePath: string;\n  readonly specifier: string;\n}\n\ninterface DependencyEntry {\n  readonly fieldName: (typeof DEPENDENCY_FIELD_NAMES)[number];\n  readonly packageName: string;\n  readonly version: string;\n}\n\nexport async function analyzeDoctorTargetWithCliLayout(\n  request: DoctorAnalysisRequest,\n): Promise<DoctorAnalysisResult> {\n  const result = await analyzeDoctorTarget(request);\n  if (!result.hasPackageJson) {\n    return result;\n  }\n\n  const packageJsonPath = path.join(result.targetPath, 'package.json');\n  const packageJson = await readPackageJson(packageJsonPath);\n  if (packageJson === null) {\n    return result;\n  }\n\n  const architectureDiagnostics = await analyzeTargetArchitecture({\n    packageJson,\n    packageJsonPath,\n    profile: result.profile,\n    targetPath: result.targetPath,\n  });\n  if (architectureDiagnostics.length === 0) {\n    return result;\n  }\n\n  const diagnostics = [...result.diagnostics, ...architectureDiagnostics];\n\n  return {\n    ...result,\n    diagnostics,\n    fixPlan: result.fixPlan === null ? null : { ...result.fixPlan, diagnostics },\n  };\n}\n\nasync function analyzeTargetArchitecture(request: {\n  readonly packageJson: Record<string, unknown>;\n  readonly packageJsonPath: string;\n  readonly profile: DoctorPolicyProfile;\n  readonly targetPath: string;\n}): Promise<DoctorDiagnostic[]> {\n  const diagnostics: DoctorDiagnostic[] = [];\n  const legacyRootCliPath = path.join(request.targetPath, LEGACY_ROOT_CLI_SOURCE);\n  const canonicalCliIndexPath = path.join(request.targetPath, CANONICAL_CLI_INDEX_SOURCE);\n  const exportsField = isRecord(request.packageJson.exports) ? request.packageJson.exports : null;\n  const cliCapable =\n    hasAnkhProvider(request.packageJson) ||\n    exportsField?.['./cli'] !== undefined ||\n    (await pathExists(canonicalCliIndexPath));\n\n  if (await pathExists(legacyRootCliPath)) {\n    diagnostics.push({\n      code: 'field-invalid',\n      message: 'Package CLI code must live under src/cli/; root src/cli.ts is not allowed.',\n      path: legacyRootCliPath,\n      profile: request.profile,\n      ruleId: 'package.cli.root-file.disallowed',\n      severity: 'error',\n    });\n  }\n\n  if (cliCapable && !(await pathExists(canonicalCliIndexPath))) {\n    diagnostics.push({\n      code: 'missing-path',\n      message: 'CLI-capable packages must expose their provider from src/cli/index.ts.',\n      path: canonicalCliIndexPath,\n      profile: request.profile,\n      ruleId: 'package.cli.index.required',\n      severity: 'error',\n    });\n  }\n\n  if (cliCapable && exportsField?.['./cli'] === undefined) {\n    diagnostics.push({\n      code: 'field-missing',\n      message:\n        'CLI-capable packages must export \"./cli\" from package.json and point it at the owning src/cli/index.ts build output.',\n      path: request.packageJsonPath,\n      profile: request.profile,\n      ruleId: 'package.cli.export.required',\n      severity: 'error',\n    });\n  }\n\n  const dependencyEntries = collectDependencyEntries(request.packageJson);\n  diagnostics.push(\n    ...validateDependencyArchitecture({\n      dependencyEntries,\n      packageJsonPath: request.packageJsonPath,\n      profile: request.profile,\n    }),\n  );\n\n  const activeSourceImports = await collectActiveSourceImports(request.targetPath);\n  diagnostics.push(\n    ...validateActiveSourceImports({\n      activeSourceImports,\n      profile: request.profile,\n    }),\n  );\n\n  if (request.packageJson.name === STUDIO_PACKAGE_NAME) {\n    diagnostics.push(\n      ...validateStudioOwnership({\n        activeSourceImports,\n        dependencyEntries,\n        packageJsonPath: request.packageJsonPath,\n        profile: request.profile,\n      }),\n    );\n  }\n\n  return diagnostics;\n}\n\nfunction validateDependencyArchitecture(request: {\n  readonly dependencyEntries: readonly DependencyEntry[];\n  readonly packageJsonPath: string;\n  readonly profile: DoctorPolicyProfile;\n}): DoctorDiagnostic[] {\n  const diagnostics: DoctorDiagnostic[] = [];\n\n  for (const dependency of request.dependencyEntries) {\n    if (dependency.packageName.startsWith(COMPATIBILITY_PACKAGE_PREFIX)) {\n      diagnostics.push({\n        code: 'field-invalid',\n        message: `Dependency \"${dependency.packageName}\" in package.json.${dependency.fieldName} is an old ankhorage4 workspace alias. Depend on \"${toOwningPackageSpecifier(dependency.packageName)}\" directly.`,\n        path: request.packageJsonPath,\n        profile: request.profile,\n        ruleId: 'package.dependencies.ankh-workspace-alias.disallowed',\n        severity: 'error',\n      });\n    }\n\n    if (\n      dependency.packageName.includes('ankhorage4') ||\n      dependency.version.includes('ankhorage4')\n    ) {\n      diagnostics.push({\n        code: 'field-invalid',\n        message: `Dependency \"${dependency.packageName}\" references ankhorage4 as active source. Depend on the extracted owning @ankhorage/* package instead.`,\n        path: request.packageJsonPath,\n        profile: request.profile,\n        ruleId: 'package.dependencies.ankhorage4-source.disallowed',\n        severity: 'error',\n      });\n    }\n  }\n\n  return diagnostics;\n}\n\nfunction validateActiveSourceImports(request: {\n  readonly activeSourceImports: readonly ActiveSourceImport[];\n  readonly profile: DoctorPolicyProfile;\n}): DoctorDiagnostic[] {\n  const diagnostics: DoctorDiagnostic[] = [];\n\n  for (const sourceImport of request.activeSourceImports) {\n    if (sourceImport.specifier.startsWith(COMPATIBILITY_PACKAGE_PREFIX)) {\n      diagnostics.push({\n        code: 'field-invalid',\n        message: `Import \"${sourceImport.specifier}\" is an old ankhorage4 compatibility boundary. Import \"${toOwningPackageSpecifier(sourceImport.specifier)}\" directly from the owning package.`,\n        path: sourceImport.filePath,\n        profile: request.profile,\n        ruleId: 'package.imports.ankh-workspace-alias.disallowed',\n        severity: 'error',\n      });\n    }\n\n    if (sourceImport.specifier.includes('ankhorage4')) {\n      diagnostics.push({\n        code: 'field-invalid',\n        message: `Import \"${sourceImport.specifier}\" references ankhorage4 as active source. Import the extracted owning @ankhorage/* package instead.`,\n        path: sourceImport.filePath,\n        profile: request.profile,\n        ruleId: 'package.imports.ankhorage4-source.disallowed',\n        severity: 'error',\n      });\n    }\n  }\n\n  return diagnostics;\n}\n\nfunction validateStudioOwnership(request: {\n  readonly activeSourceImports: readonly ActiveSourceImport[];\n  readonly dependencyEntries: readonly DependencyEntry[];\n  readonly packageJsonPath: string;\n  readonly profile: DoctorPolicyProfile;\n}): DoctorDiagnostic[] {\n  const diagnostics: DoctorDiagnostic[] = [];\n  const directDependencies = new Set(\n    request.dependencyEntries\n      .filter((dependency) => dependency.fieldName === 'dependencies')\n      .map((dependency) => dependency.packageName),\n  );\n  const importedSpecifiers = request.activeSourceImports.map(\n    (sourceImport) => sourceImport.specifier,\n  );\n\n  if (!directDependencies.has(STUDIO_DND_PACKAGE_NAME)) {\n    diagnostics.push({\n      code: 'missing-dependency',\n      message: `@ankhorage/studio must depend directly on \"${STUDIO_DND_PACKAGE_NAME}\" for Studio drag-and-drop ownership.`,\n      path: request.packageJsonPath,\n      profile: request.profile,\n      ruleId: 'studio.dependencies.dnd.required',\n      severity: 'error',\n    });\n  }\n\n  if (!directDependencies.has(STUDIO_RUNTIME_PACKAGE_NAME)) {\n    diagnostics.push({\n      code: 'missing-dependency',\n      message: `@ankhorage/studio must depend directly on \"${STUDIO_RUNTIME_PACKAGE_NAME}\" for runtime ownership.`,\n      path: request.packageJsonPath,\n      profile: request.profile,\n      ruleId: 'studio.dependencies.runtime.required',\n      severity: 'error',\n    });\n  }\n\n  if (\n    !importedSpecifiers.some((specifier) => isPackageImport(specifier, STUDIO_DND_PACKAGE_NAME))\n  ) {\n    diagnostics.push({\n      code: 'field-missing',\n      message: `@ankhorage/studio must import \"${STUDIO_DND_PACKAGE_NAME}\" directly from its Studio DnD boundary.`,\n      path: request.packageJsonPath,\n      profile: request.profile,\n      ruleId: 'studio.imports.dnd.required',\n      severity: 'error',\n    });\n  }\n\n  if (\n    !importedSpecifiers.some((specifier) => isPackageImport(specifier, STUDIO_RUNTIME_PACKAGE_NAME))\n  ) {\n    diagnostics.push({\n      code: 'field-missing',\n      message: `@ankhorage/studio must import \"${STUDIO_RUNTIME_PACKAGE_NAME}\" directly from the owning runtime package.`,\n      path: request.packageJsonPath,\n      profile: request.profile,\n      ruleId: 'studio.imports.runtime.required',\n      severity: 'error',\n    });\n  }\n\n  return diagnostics;\n}\n\nasync function collectActiveSourceImports(targetPath: string): Promise<ActiveSourceImport[]> {\n  const imports: ActiveSourceImport[] = [];\n\n  for (const sourceRoot of ACTIVE_SOURCE_ROOTS) {\n    const sourceRootPath = path.join(targetPath, sourceRoot);\n    if (!(await pathExists(sourceRootPath))) {\n      continue;\n    }\n\n    for (const filePath of await listActiveSourceFiles(sourceRootPath)) {\n      const source = await fs.readFile(filePath, 'utf8');\n      for (const specifier of extractImportSpecifiers(source)) {\n        imports.push({ filePath, specifier });\n      }\n    }\n  }\n\n  return imports;\n}\n\nasync function listActiveSourceFiles(rootPath: string): Promise<string[]> {\n  const files: string[] = [];\n  await visit(rootPath);\n  return files.sort((left, right) => left.localeCompare(right));\n\n  async function visit(currentPath: string): Promise<void> {\n    const entries = await fs.readdir(currentPath, { withFileTypes: true });\n\n    for (const entry of entries) {\n      if (entry.isDirectory()) {\n        if (!IGNORED_SOURCE_DIRECTORIES.has(entry.name)) {\n          await visit(path.join(currentPath, entry.name));\n        }\n        continue;\n      }\n\n      if (!entry.isFile()) {\n        continue;\n      }\n\n      const filePath = path.join(currentPath, entry.name);\n      if (isActiveSourceFile(filePath)) {\n        files.push(filePath);\n      }\n    }\n  }\n}\n\nfunction isActiveSourceFile(filePath: string): boolean {\n  if (!ACTIVE_SOURCE_EXTENSIONS.has(path.extname(filePath))) {\n    return false;\n  }\n\n  return !/(?:^|\\.)(?:spec|test)\\.[cm]?[jt]sx?$/.test(path.basename(filePath));\n}\n\nfunction extractImportSpecifiers(source: string): string[] {\n  const specifiers = new Set<string>();\n  const patterns = [\n    /\\b(?:import|export)\\s+(?:type\\s+)?(?:[^;]*?\\sfrom\\s*)?['\"]([^'\"]+)['\"]/g,\n    /\\b(?:import|require)\\s*\\(\\s*['\"]([^'\"]+)['\"]\\s*\\)/g,\n  ];\n\n  for (const pattern of patterns) {\n    for (const match of source.matchAll(pattern)) {\n      const [, specifier] = match;\n      if (specifier !== undefined) {\n        specifiers.add(specifier);\n      }\n    }\n  }\n\n  return [...specifiers].sort((left, right) => left.localeCompare(right));\n}\n\nfunction collectDependencyEntries(packageJson: Record<string, unknown>): DependencyEntry[] {\n  const entries: DependencyEntry[] = [];\n\n  for (const fieldName of DEPENDENCY_FIELD_NAMES) {\n    const dependencies = isRecord(packageJson[fieldName]) ? packageJson[fieldName] : null;\n    if (dependencies === null) {\n      continue;\n    }\n\n    for (const [packageName, version] of Object.entries(dependencies)) {\n      if (isNonEmptyString(version)) {\n        entries.push({ fieldName, packageName, version });\n      }\n    }\n  }\n\n  return entries.sort((left, right) => {\n    const fieldComparison = left.fieldName.localeCompare(right.fieldName);\n    return fieldComparison !== 0\n      ? fieldComparison\n      : left.packageName.localeCompare(right.packageName);\n  });\n}\n\nfunction hasAnkhProvider(packageJson: Record<string, unknown>): boolean {\n  const ankh = isRecord(packageJson.ankh) ? packageJson.ankh : null;\n  return isNonEmptyString(ankh?.provider);\n}\n\nfunction isPackageImport(specifier: string, packageName: string): boolean {\n  return specifier === packageName || specifier.startsWith(`${packageName}/`);\n}\n\nfunction toOwningPackageSpecifier(specifier: string): string {\n  return `@ankhorage/${specifier.slice(COMPATIBILITY_PACKAGE_PREFIX.length)}`;\n}\n\nasync function readPackageJson(packageJsonPath: string): Promise<Record<string, unknown> | null> {\n  try {\n    const parsed: unknown = JSON.parse(await fs.readFile(packageJsonPath, 'utf8'));\n    return isRecord(parsed) ? parsed : null;\n  } catch {\n    return null;\n  }\n}\n\nasync function pathExists(targetPath: string): Promise<boolean> {\n  try {\n    await fs.access(targetPath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction isNonEmptyString(value: unknown): value is string {\n  return typeof value === 'string' && value.trim().length > 0;\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/diagnostics.d.ts

@@ -1,7 +1,7 @@
 export type DoctorDiagnosticCode = 'field-invalid' | 'field-missing' | 'invalid-ankh-metadata' | 'invalid-package-json' | 'missing-dependency' | 'missing-path' | 'missing-script' | 'provider-source-import-failed' | 'provider-source-missing' | 'target-not-directory' | 'target-not-found' | 'unsupported-target';
 export type DoctorDiagnosticSeverity = 'error' | 'warning';
 export type DoctorPolicyProfile = 'integration-monorepo' | 'public-package' | 'unknown';
-export type DoctorRuleId = 'integration.package.ankh.disallowed' | 'integration.package.private.required' | 'integration.package.workspaces.required' | 'package.ankh.capabilities.match-provider' | 'package.ankh.present.valid-shape' | 'package.ankh.provider-path.required' | 'package.ankh.required-for-provider' | 'package.cli.index.required' | 'package.cli.root-file.disallowed' | 'package.dependencies.changesets.required' | 'package.dependencies.devtools.required' | 'package.dependencies.paradox.required' | 'package.dependencies.types-bun.required' | 'package.dependencies.types-node.required' | 'package.dependencies.typescript.required' | 'package.json.bugs.required' | 'package.json.description.required' | 'package.json.exports.required' | 'package.json.files.required' | 'package.json.homepage.required' | 'package.json.keywords.required' | 'package.json.license.required' | 'package.json.name.required' | 'package.json.package-manager.bun' | 'package.json.package-manager.required' | 'package.json.private.public-package-disallowed' | 'package.json.publish-config.public' | 'package.json.publish-config.required' | 'package.json.repository.required' | 'package.json.type.module' | 'package.json.type.required' | 'package.json.version.required' | 'package.scripts.build.required' | 'package.scripts.changeset-status.required' | 'package.scripts.changeset.required' | 'package.scripts.docs.required' | 'package.scripts.format-check.required' | 'package.scripts.format.required' | 'package.scripts.knip.required' | 'package.scripts.lint-fix.required' | 'package.scripts.lint.required' | 'package.scripts.test.required' | 'package.scripts.typecheck.required' | 'package.scripts.version-packages.required' | 'provider.commands.match-capabilities' | 'provider.commands.match-handlers' | 'provider.source.importable' | 'provider.source.required' | 'repo.changelog.required' | 'repo.changeset.required' | 'repo.license.required' | 'repo.readme.required' | 'repo.workflows.required' | 'target.package-json.required' | 'target.path.directory' | 'target.path.exists' | 'target.profile.supported' | 'target.repo-markers.required';
+export type DoctorRuleId = 'integration.package.ankh.disallowed' | 'integration.package.private.required' | 'integration.package.workspaces.required' | 'package.ankh.capabilities.match-provider' | 'package.ankh.present.valid-shape' | 'package.ankh.provider-path.required' | 'package.ankh.required-for-provider' | 'package.cli.export.required' | 'package.cli.index.required' | 'package.cli.root-file.disallowed' | 'package.dependencies.ankh-workspace-alias.disallowed' | 'package.dependencies.ankhorage4-source.disallowed' | 'package.dependencies.changesets.required' | 'package.dependencies.devtools.required' | 'package.dependencies.paradox.required' | 'package.dependencies.types-bun.required' | 'package.dependencies.types-node.required' | 'package.dependencies.typescript.required' | 'package.imports.ankh-workspace-alias.disallowed' | 'package.imports.ankhorage4-source.disallowed' | 'package.json.bugs.required' | 'package.json.description.required' | 'package.json.exports.required' | 'package.json.files.required' | 'package.json.homepage.required' | 'package.json.keywords.required' | 'package.json.license.required' | 'package.json.name.required' | 'package.json.package-manager.bun' | 'package.json.package-manager.required' | 'package.json.private.public-package-disallowed' | 'package.json.publish-config.public' | 'package.json.publish-config.required' | 'package.json.repository.required' | 'package.json.type.module' | 'package.json.type.required' | 'package.json.version.required' | 'package.scripts.build.required' | 'package.scripts.changeset-status.required' | 'package.scripts.changeset.required' | 'package.scripts.docs.required' | 'package.scripts.format-check.required' | 'package.scripts.format.required' | 'package.scripts.knip.required' | 'package.scripts.lint-fix.required' | 'package.scripts.lint.required' | 'package.scripts.test.required' | 'package.scripts.typecheck.required' | 'package.scripts.version-packages.required' | 'provider.commands.match-capabilities' | 'provider.commands.match-handlers' | 'provider.source.importable' | 'provider.source.required' | 'repo.changelog.required' | 'repo.changeset.required' | 'repo.license.required' | 'repo.readme.required' | 'repo.workflows.required' | 'studio.dependencies.dnd.required' | 'studio.dependencies.runtime.required' | 'studio.imports.dnd.required' | 'studio.imports.runtime.required' | 'target.package-json.required' | 'target.path.directory' | 'target.path.exists' | 'target.profile.supported' | 'target.repo-markers.required';
 export interface DoctorDiagnostic {
     readonly code: DoctorDiagnosticCode;
     readonly message: string;

package/dist/diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAC5B,eAAe,GACf,eAAe,GACf,uBAAuB,GACvB,sBAAsB,GACtB,oBAAoB,GACpB,cAAc,GACd,gBAAgB,GAChB,+BAA+B,GAC/B,yBAAyB,GACzB,sBAAsB,GACtB,kBAAkB,GAClB,oBAAoB,CAAC;AAEzB,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,SAAS,CAAC;AAC3D,MAAM,MAAM,mBAAmB,GAAG,sBAAsB,GAAG,gBAAgB,GAAG,SAAS,CAAC;AACxF,MAAM,MAAM,YAAY,GACpB,qCAAqC,GACrC,sCAAsC,GACtC,yCAAyC,GACzC,0CAA0C,GAC1C,kCAAkC,GAClC,qCAAqC,GACrC,oCAAoC,GACpC,4BAA4B,GAC5B,kCAAkC,GAClC,0CAA0C,GAC1C,wCAAwC,GACxC,uCAAuC,GACvC,yCAAyC,GACzC,0CAA0C,GAC1C,0CAA0C,GAC1C,4BAA4B,GAC5B,mCAAmC,GACnC,+BAA+B,GAC/B,6BAA6B,GAC7B,gCAAgC,GAChC,gCAAgC,GAChC,+BAA+B,GAC/B,4BAA4B,GAC5B,kCAAkC,GAClC,uCAAuC,GACvC,gDAAgD,GAChD,oCAAoC,GACpC,sCAAsC,GACtC,kCAAkC,GAClC,0BAA0B,GAC1B,4BAA4B,GAC5B,+BAA+B,GAC/B,gCAAgC,GAChC,2CAA2C,GAC3C,oCAAoC,GACpC,+BAA+B,GAC/B,uCAAuC,GACvC,iCAAiC,GACjC,+BAA+B,GAC/B,mCAAmC,GACnC,+BAA+B,GAC/B,+BAA+B,GAC/B,oCAAoC,GACpC,2CAA2C,GAC3C,sCAAsC,GACtC,kCAAkC,GAClC,4BAA4B,GAC5B,0BAA0B,GAC1B,yBAAyB,GACzB,yBAAyB,GACzB,uBAAuB,GACvB,sBAAsB,GACtB,yBAAyB,GACzB,8BAA8B,GAC9B,uBAAuB,GACvB,oBAAoB,GACpB,0BAA0B,GAC1B,8BAA8B,CAAC;AAEnC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;CAC7C;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,GAAG,MAAM,CAEtF;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,GAAG,MAAM,CAExF"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAC5B,eAAe,GACf,eAAe,GACf,uBAAuB,GACvB,sBAAsB,GACtB,oBAAoB,GACpB,cAAc,GACd,gBAAgB,GAChB,+BAA+B,GAC/B,yBAAyB,GACzB,sBAAsB,GACtB,kBAAkB,GAClB,oBAAoB,CAAC;AAEzB,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,SAAS,CAAC;AAC3D,MAAM,MAAM,mBAAmB,GAAG,sBAAsB,GAAG,gBAAgB,GAAG,SAAS,CAAC;AACxF,MAAM,MAAM,YAAY,GACpB,qCAAqC,GACrC,sCAAsC,GACtC,yCAAyC,GACzC,0CAA0C,GAC1C,kCAAkC,GAClC,qCAAqC,GACrC,oCAAoC,GACpC,6BAA6B,GAC7B,4BAA4B,GAC5B,kCAAkC,GAClC,sDAAsD,GACtD,mDAAmD,GACnD,0CAA0C,GAC1C,wCAAwC,GACxC,uCAAuC,GACvC,yCAAyC,GACzC,0CAA0C,GAC1C,0CAA0C,GAC1C,iDAAiD,GACjD,8CAA8C,GAC9C,4BAA4B,GAC5B,mCAAmC,GACnC,+BAA+B,GAC/B,6BAA6B,GAC7B,gCAAgC,GAChC,gCAAgC,GAChC,+BAA+B,GAC/B,4BAA4B,GAC5B,kCAAkC,GAClC,uCAAuC,GACvC,gDAAgD,GAChD,oCAAoC,GACpC,sCAAsC,GACtC,kCAAkC,GAClC,0BAA0B,GAC1B,4BAA4B,GAC5B,+BAA+B,GAC/B,gCAAgC,GAChC,2CAA2C,GAC3C,oCAAoC,GACpC,+BAA+B,GAC/B,uCAAuC,GACvC,iCAAiC,GACjC,+BAA+B,GAC/B,mCAAmC,GACnC,+BAA+B,GAC/B,+BAA+B,GAC/B,oCAAoC,GACpC,2CAA2C,GAC3C,sCAAsC,GACtC,kCAAkC,GAClC,4BAA4B,GAC5B,0BAA0B,GAC1B,yBAAyB,GACzB,yBAAyB,GACzB,uBAAuB,GACvB,sBAAsB,GACtB,yBAAyB,GACzB,kCAAkC,GAClC,sCAAsC,GACtC,6BAA6B,GAC7B,iCAAiC,GACjC,8BAA8B,GAC9B,uBAAuB,GACvB,oBAAoB,GACpB,0BAA0B,GAC1B,8BAA8B,CAAC;AAEnC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;CAC7C;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,GAAG,MAAM,CAEtF;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,GAAG,MAAM,CAExF"}

package/dist/diagnostics.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAqFA,MAAM,UAAU,qBAAqB,CAAC,WAAwC;IAC5E,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,WAAwC;IAC9E,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;AACtF,CAAC","sourcesContent":["export type DoctorDiagnosticCode =\n  | 'field-invalid'\n  | 'field-missing'\n  | 'invalid-ankh-metadata'\n  | 'invalid-package-json'\n  | 'missing-dependency'\n  | 'missing-path'\n  | 'missing-script'\n  | 'provider-source-import-failed'\n  | 'provider-source-missing'\n  | 'target-not-directory'\n  | 'target-not-found'\n  | 'unsupported-target';\n\nexport type DoctorDiagnosticSeverity = 'error' | 'warning';\nexport type DoctorPolicyProfile = 'integration-monorepo' | 'public-package' | 'unknown';\nexport type DoctorRuleId =\n  | 'integration.package.ankh.disallowed'\n  | 'integration.package.private.required'\n  | 'integration.package.workspaces.required'\n  | 'package.ankh.capabilities.match-provider'\n  | 'package.ankh.present.valid-shape'\n  | 'package.ankh.provider-path.required'\n  | 'package.ankh.required-for-provider'\n  | 'package.cli.index.required'\n  | 'package.cli.root-file.disallowed'\n  | 'package.dependencies.changesets.required'\n  | 'package.dependencies.devtools.required'\n  | 'package.dependencies.paradox.required'\n  | 'package.dependencies.types-bun.required'\n  | 'package.dependencies.types-node.required'\n  | 'package.dependencies.typescript.required'\n  | 'package.json.bugs.required'\n  | 'package.json.description.required'\n  | 'package.json.exports.required'\n  | 'package.json.files.required'\n  | 'package.json.homepage.required'\n  | 'package.json.keywords.required'\n  | 'package.json.license.required'\n  | 'package.json.name.required'\n  | 'package.json.package-manager.bun'\n  | 'package.json.package-manager.required'\n  | 'package.json.private.public-package-disallowed'\n  | 'package.json.publish-config.public'\n  | 'package.json.publish-config.required'\n  | 'package.json.repository.required'\n  | 'package.json.type.module'\n  | 'package.json.type.required'\n  | 'package.json.version.required'\n  | 'package.scripts.build.required'\n  | 'package.scripts.changeset-status.required'\n  | 'package.scripts.changeset.required'\n  | 'package.scripts.docs.required'\n  | 'package.scripts.format-check.required'\n  | 'package.scripts.format.required'\n  | 'package.scripts.knip.required'\n  | 'package.scripts.lint-fix.required'\n  | 'package.scripts.lint.required'\n  | 'package.scripts.test.required'\n  | 'package.scripts.typecheck.required'\n  | 'package.scripts.version-packages.required'\n  | 'provider.commands.match-capabilities'\n  | 'provider.commands.match-handlers'\n  | 'provider.source.importable'\n  | 'provider.source.required'\n  | 'repo.changelog.required'\n  | 'repo.changeset.required'\n  | 'repo.license.required'\n  | 'repo.readme.required'\n  | 'repo.workflows.required'\n  | 'target.package-json.required'\n  | 'target.path.directory'\n  | 'target.path.exists'\n  | 'target.profile.supported'\n  | 'target.repo-markers.required';\n\nexport interface DoctorDiagnostic {\n  readonly code: DoctorDiagnosticCode;\n  readonly message: string;\n  readonly path: string;\n  readonly profile: DoctorPolicyProfile;\n  readonly ruleId: DoctorRuleId;\n  readonly severity: DoctorDiagnosticSeverity;\n}\n\nexport function countErrorDiagnostics(diagnostics: readonly DoctorDiagnostic[]): number {\n  return diagnostics.filter((diagnostic) => diagnostic.severity === 'error').length;\n}\n\nexport function countWarningDiagnostics(diagnostics: readonly DoctorDiagnostic[]): number {\n  return diagnostics.filter((diagnostic) => diagnostic.severity === 'warning').length;\n}\n"]}
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AA8FA,MAAM,UAAU,qBAAqB,CAAC,WAAwC;IAC5E,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,WAAwC;IAC9E,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;AACtF,CAAC","sourcesContent":["export type DoctorDiagnosticCode =\n  | 'field-invalid'\n  | 'field-missing'\n  | 'invalid-ankh-metadata'\n  | 'invalid-package-json'\n  | 'missing-dependency'\n  | 'missing-path'\n  | 'missing-script'\n  | 'provider-source-import-failed'\n  | 'provider-source-missing'\n  | 'target-not-directory'\n  | 'target-not-found'\n  | 'unsupported-target';\n\nexport type DoctorDiagnosticSeverity = 'error' | 'warning';\nexport type DoctorPolicyProfile = 'integration-monorepo' | 'public-package' | 'unknown';\nexport type DoctorRuleId =\n  | 'integration.package.ankh.disallowed'\n  | 'integration.package.private.required'\n  | 'integration.package.workspaces.required'\n  | 'package.ankh.capabilities.match-provider'\n  | 'package.ankh.present.valid-shape'\n  | 'package.ankh.provider-path.required'\n  | 'package.ankh.required-for-provider'\n  | 'package.cli.export.required'\n  | 'package.cli.index.required'\n  | 'package.cli.root-file.disallowed'\n  | 'package.dependencies.ankh-workspace-alias.disallowed'\n  | 'package.dependencies.ankhorage4-source.disallowed'\n  | 'package.dependencies.changesets.required'\n  | 'package.dependencies.devtools.required'\n  | 'package.dependencies.paradox.required'\n  | 'package.dependencies.types-bun.required'\n  | 'package.dependencies.types-node.required'\n  | 'package.dependencies.typescript.required'\n  | 'package.imports.ankh-workspace-alias.disallowed'\n  | 'package.imports.ankhorage4-source.disallowed'\n  | 'package.json.bugs.required'\n  | 'package.json.description.required'\n  | 'package.json.exports.required'\n  | 'package.json.files.required'\n  | 'package.json.homepage.required'\n  | 'package.json.keywords.required'\n  | 'package.json.license.required'\n  | 'package.json.name.required'\n  | 'package.json.package-manager.bun'\n  | 'package.json.package-manager.required'\n  | 'package.json.private.public-package-disallowed'\n  | 'package.json.publish-config.public'\n  | 'package.json.publish-config.required'\n  | 'package.json.repository.required'\n  | 'package.json.type.module'\n  | 'package.json.type.required'\n  | 'package.json.version.required'\n  | 'package.scripts.build.required'\n  | 'package.scripts.changeset-status.required'\n  | 'package.scripts.changeset.required'\n  | 'package.scripts.docs.required'\n  | 'package.scripts.format-check.required'\n  | 'package.scripts.format.required'\n  | 'package.scripts.knip.required'\n  | 'package.scripts.lint-fix.required'\n  | 'package.scripts.lint.required'\n  | 'package.scripts.test.required'\n  | 'package.scripts.typecheck.required'\n  | 'package.scripts.version-packages.required'\n  | 'provider.commands.match-capabilities'\n  | 'provider.commands.match-handlers'\n  | 'provider.source.importable'\n  | 'provider.source.required'\n  | 'repo.changelog.required'\n  | 'repo.changeset.required'\n  | 'repo.license.required'\n  | 'repo.readme.required'\n  | 'repo.workflows.required'\n  | 'studio.dependencies.dnd.required'\n  | 'studio.dependencies.runtime.required'\n  | 'studio.imports.dnd.required'\n  | 'studio.imports.runtime.required'\n  | 'target.package-json.required'\n  | 'target.path.directory'\n  | 'target.path.exists'\n  | 'target.profile.supported'\n  | 'target.repo-markers.required';\n\nexport interface DoctorDiagnostic {\n  readonly code: DoctorDiagnosticCode;\n  readonly message: string;\n  readonly path: string;\n  readonly profile: DoctorPolicyProfile;\n  readonly ruleId: DoctorRuleId;\n  readonly severity: DoctorDiagnosticSeverity;\n}\n\nexport function countErrorDiagnostics(diagnostics: readonly DoctorDiagnostic[]): number {\n  return diagnostics.filter((diagnostic) => diagnostic.severity === 'error').length;\n}\n\nexport function countWarningDiagnostics(diagnostics: readonly DoctorDiagnostic[]): number {\n  return diagnostics.filter((diagnostic) => diagnostic.severity === 'warning').length;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/doctor",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Executable Ankh provider and standalone CLI for lightweight repo and package compliance diagnostics.",
   "license": "MIT",
   "publishConfig": {

package/src/cliLayoutAnalysis.ts

@@ -10,6 +10,54 @@ import type { DoctorDiagnostic, DoctorPolicyProfile } from './diagnostics.js';
 
 const LEGACY_ROOT_CLI_SOURCE = path.join('src', 'cli.ts');
 const CANONICAL_CLI_INDEX_SOURCE = path.join('src', 'cli', 'index.ts');
+const ACTIVE_SOURCE_ROOTS = ['src', 'app', 'apps', 'packages', 'scripts'] as const;
+const ACTIVE_SOURCE_EXTENSIONS = new Set([
+  '.cjs',
+  '.cts',
+  '.js',
+  '.jsx',
+  '.mjs',
+  '.mts',
+  '.ts',
+  '.tsx',
+]);
+const IGNORED_SOURCE_DIRECTORIES = new Set([
+  '.expo',
+  '.git',
+  '.next',
+  '__fixtures__',
+  '__tests__',
+  'build',
+  'coverage',
+  'dist',
+  'docs',
+  'fixtures',
+  'node_modules',
+  'paradox',
+  'test',
+  'tests',
+]);
+const COMPATIBILITY_PACKAGE_PREFIX = '@ankh/';
+const STUDIO_PACKAGE_NAME = '@ankhorage/studio';
+const STUDIO_DND_PACKAGE_NAME = '@ankhorage/react-native-reanimated-dnd-web';
+const STUDIO_RUNTIME_PACKAGE_NAME = '@ankhorage/runtime';
+const DEPENDENCY_FIELD_NAMES = [
+  'dependencies',
+  'devDependencies',
+  'optionalDependencies',
+  'peerDependencies',
+] as const;
+
+interface ActiveSourceImport {
+  readonly filePath: string;
+  readonly specifier: string;
+}
+
+interface DependencyEntry {
+  readonly fieldName: (typeof DEPENDENCY_FIELD_NAMES)[number];
+  readonly packageName: string;
+  readonly version: string;
+}
 
 export async function analyzeDoctorTargetWithCliLayout(
   request: DoctorAnalysisRequest,
@@ -19,12 +67,23 @@ export async function analyzeDoctorTargetWithCliLayout(
     return result;
   }
 
-  const cliDiagnostics = await analyzeCliLayout(result.targetPath, result.profile);
-  if (cliDiagnostics.length === 0) {
+  const packageJsonPath = path.join(result.targetPath, 'package.json');
+  const packageJson = await readPackageJson(packageJsonPath);
+  if (packageJson === null) {
+    return result;
+  }
+
+  const architectureDiagnostics = await analyzeTargetArchitecture({
+    packageJson,
+    packageJsonPath,
+    profile: result.profile,
+    targetPath: result.targetPath,
+  });
+  if (architectureDiagnostics.length === 0) {
     return result;
   }
 
-  const diagnostics = [...result.diagnostics, ...cliDiagnostics];
+  const diagnostics = [...result.diagnostics, ...architectureDiagnostics];
 
   return {
     ...result,
@@ -33,49 +92,333 @@ export async function analyzeDoctorTargetWithCliLayout(
   };
 }
 
-async function analyzeCliLayout(
-  targetPath: string,
-  profile: DoctorPolicyProfile,
-): Promise<DoctorDiagnostic[]> {
+async function analyzeTargetArchitecture(request: {
+  readonly packageJson: Record<string, unknown>;
+  readonly packageJsonPath: string;
+  readonly profile: DoctorPolicyProfile;
+  readonly targetPath: string;
+}): Promise<DoctorDiagnostic[]> {
   const diagnostics: DoctorDiagnostic[] = [];
-  const legacyRootCliPath = path.join(targetPath, LEGACY_ROOT_CLI_SOURCE);
-  const canonicalCliIndexPath = path.join(targetPath, CANONICAL_CLI_INDEX_SOURCE);
+  const legacyRootCliPath = path.join(request.targetPath, LEGACY_ROOT_CLI_SOURCE);
+  const canonicalCliIndexPath = path.join(request.targetPath, CANONICAL_CLI_INDEX_SOURCE);
+  const exportsField = isRecord(request.packageJson.exports) ? request.packageJson.exports : null;
+  const cliCapable =
+    hasAnkhProvider(request.packageJson) ||
+    exportsField?.['./cli'] !== undefined ||
+    (await pathExists(canonicalCliIndexPath));
 
   if (await pathExists(legacyRootCliPath)) {
     diagnostics.push({
       code: 'field-invalid',
       message: 'Package CLI code must live under src/cli/; root src/cli.ts is not allowed.',
       path: legacyRootCliPath,
-      profile,
+      profile: request.profile,
       ruleId: 'package.cli.root-file.disallowed',
       severity: 'error',
     });
   }
 
-  const packageJson = await readPackageJson(path.join(targetPath, 'package.json'));
-  if (
-    packageJson !== null &&
-    exposesCliProvider(packageJson) &&
-    !(await pathExists(canonicalCliIndexPath))
-  ) {
+  if (cliCapable && !(await pathExists(canonicalCliIndexPath))) {
     diagnostics.push({
       code: 'missing-path',
       message: 'CLI-capable packages must expose their provider from src/cli/index.ts.',
       path: canonicalCliIndexPath,
-      profile,
+      profile: request.profile,
       ruleId: 'package.cli.index.required',
       severity: 'error',
     });
   }
 
+  if (cliCapable && exportsField?.['./cli'] === undefined) {
+    diagnostics.push({
+      code: 'field-missing',
+      message:
+        'CLI-capable packages must export "./cli" from package.json and point it at the owning src/cli/index.ts build output.',
+      path: request.packageJsonPath,
+      profile: request.profile,
+      ruleId: 'package.cli.export.required',
+      severity: 'error',
+    });
+  }
+
+  const dependencyEntries = collectDependencyEntries(request.packageJson);
+  diagnostics.push(
+    ...validateDependencyArchitecture({
+      dependencyEntries,
+      packageJsonPath: request.packageJsonPath,
+      profile: request.profile,
+    }),
+  );
+
+  const activeSourceImports = await collectActiveSourceImports(request.targetPath);
+  diagnostics.push(
+    ...validateActiveSourceImports({
+      activeSourceImports,
+      profile: request.profile,
+    }),
+  );
+
+  if (request.packageJson.name === STUDIO_PACKAGE_NAME) {
+    diagnostics.push(
+      ...validateStudioOwnership({
+        activeSourceImports,
+        dependencyEntries,
+        packageJsonPath: request.packageJsonPath,
+        profile: request.profile,
+      }),
+    );
+  }
+
+  return diagnostics;
+}
+
+function validateDependencyArchitecture(request: {
+  readonly dependencyEntries: readonly DependencyEntry[];
+  readonly packageJsonPath: string;
+  readonly profile: DoctorPolicyProfile;
+}): DoctorDiagnostic[] {
+  const diagnostics: DoctorDiagnostic[] = [];
+
+  for (const dependency of request.dependencyEntries) {
+    if (dependency.packageName.startsWith(COMPATIBILITY_PACKAGE_PREFIX)) {
+      diagnostics.push({
+        code: 'field-invalid',
+        message: `Dependency "${dependency.packageName}" in package.json.${dependency.fieldName} is an old ankhorage4 workspace alias. Depend on "${toOwningPackageSpecifier(dependency.packageName)}" directly.`,
+        path: request.packageJsonPath,
+        profile: request.profile,
+        ruleId: 'package.dependencies.ankh-workspace-alias.disallowed',
+        severity: 'error',
+      });
+    }
+
+    if (
+      dependency.packageName.includes('ankhorage4') ||
+      dependency.version.includes('ankhorage4')
+    ) {
+      diagnostics.push({
+        code: 'field-invalid',
+        message: `Dependency "${dependency.packageName}" references ankhorage4 as active source. Depend on the extracted owning @ankhorage/* package instead.`,
+        path: request.packageJsonPath,
+        profile: request.profile,
+        ruleId: 'package.dependencies.ankhorage4-source.disallowed',
+        severity: 'error',
+      });
+    }
+  }
+
+  return diagnostics;
+}
+
+function validateActiveSourceImports(request: {
+  readonly activeSourceImports: readonly ActiveSourceImport[];
+  readonly profile: DoctorPolicyProfile;
+}): DoctorDiagnostic[] {
+  const diagnostics: DoctorDiagnostic[] = [];
+
+  for (const sourceImport of request.activeSourceImports) {
+    if (sourceImport.specifier.startsWith(COMPATIBILITY_PACKAGE_PREFIX)) {
+      diagnostics.push({
+        code: 'field-invalid',
+        message: `Import "${sourceImport.specifier}" is an old ankhorage4 compatibility boundary. Import "${toOwningPackageSpecifier(sourceImport.specifier)}" directly from the owning package.`,
+        path: sourceImport.filePath,
+        profile: request.profile,
+        ruleId: 'package.imports.ankh-workspace-alias.disallowed',
+        severity: 'error',
+      });
+    }
+
+    if (sourceImport.specifier.includes('ankhorage4')) {
+      diagnostics.push({
+        code: 'field-invalid',
+        message: `Import "${sourceImport.specifier}" references ankhorage4 as active source. Import the extracted owning @ankhorage/* package instead.`,
+        path: sourceImport.filePath,
+        profile: request.profile,
+        ruleId: 'package.imports.ankhorage4-source.disallowed',
+        severity: 'error',
+      });
+    }
+  }
+
   return diagnostics;
 }
 
-function exposesCliProvider(packageJson: Record<string, unknown>): boolean {
+function validateStudioOwnership(request: {
+  readonly activeSourceImports: readonly ActiveSourceImport[];
+  readonly dependencyEntries: readonly DependencyEntry[];
+  readonly packageJsonPath: string;
+  readonly profile: DoctorPolicyProfile;
+}): DoctorDiagnostic[] {
+  const diagnostics: DoctorDiagnostic[] = [];
+  const directDependencies = new Set(
+    request.dependencyEntries
+      .filter((dependency) => dependency.fieldName === 'dependencies')
+      .map((dependency) => dependency.packageName),
+  );
+  const importedSpecifiers = request.activeSourceImports.map(
+    (sourceImport) => sourceImport.specifier,
+  );
+
+  if (!directDependencies.has(STUDIO_DND_PACKAGE_NAME)) {
+    diagnostics.push({
+      code: 'missing-dependency',
+      message: `@ankhorage/studio must depend directly on "${STUDIO_DND_PACKAGE_NAME}" for Studio drag-and-drop ownership.`,
+      path: request.packageJsonPath,
+      profile: request.profile,
+      ruleId: 'studio.dependencies.dnd.required',
+      severity: 'error',
+    });
+  }
+
+  if (!directDependencies.has(STUDIO_RUNTIME_PACKAGE_NAME)) {
+    diagnostics.push({
+      code: 'missing-dependency',
+      message: `@ankhorage/studio must depend directly on "${STUDIO_RUNTIME_PACKAGE_NAME}" for runtime ownership.`,
+      path: request.packageJsonPath,
+      profile: request.profile,
+      ruleId: 'studio.dependencies.runtime.required',
+      severity: 'error',
+    });
+  }
+
+  if (
+    !importedSpecifiers.some((specifier) => isPackageImport(specifier, STUDIO_DND_PACKAGE_NAME))
+  ) {
+    diagnostics.push({
+      code: 'field-missing',
+      message: `@ankhorage/studio must import "${STUDIO_DND_PACKAGE_NAME}" directly from its Studio DnD boundary.`,
+      path: request.packageJsonPath,
+      profile: request.profile,
+      ruleId: 'studio.imports.dnd.required',
+      severity: 'error',
+    });
+  }
+
+  if (
+    !importedSpecifiers.some((specifier) => isPackageImport(specifier, STUDIO_RUNTIME_PACKAGE_NAME))
+  ) {
+    diagnostics.push({
+      code: 'field-missing',
+      message: `@ankhorage/studio must import "${STUDIO_RUNTIME_PACKAGE_NAME}" directly from the owning runtime package.`,
+      path: request.packageJsonPath,
+      profile: request.profile,
+      ruleId: 'studio.imports.runtime.required',
+      severity: 'error',
+    });
+  }
+
+  return diagnostics;
+}
+
+async function collectActiveSourceImports(targetPath: string): Promise<ActiveSourceImport[]> {
+  const imports: ActiveSourceImport[] = [];
+
+  for (const sourceRoot of ACTIVE_SOURCE_ROOTS) {
+    const sourceRootPath = path.join(targetPath, sourceRoot);
+    if (!(await pathExists(sourceRootPath))) {
+      continue;
+    }
+
+    for (const filePath of await listActiveSourceFiles(sourceRootPath)) {
+      const source = await fs.readFile(filePath, 'utf8');
+      for (const specifier of extractImportSpecifiers(source)) {
+        imports.push({ filePath, specifier });
+      }
+    }
+  }
+
+  return imports;
+}
+
+async function listActiveSourceFiles(rootPath: string): Promise<string[]> {
+  const files: string[] = [];
+  await visit(rootPath);
+  return files.sort((left, right) => left.localeCompare(right));
+
+  async function visit(currentPath: string): Promise<void> {
+    const entries = await fs.readdir(currentPath, { withFileTypes: true });
+
+    for (const entry of entries) {
+      if (entry.isDirectory()) {
+        if (!IGNORED_SOURCE_DIRECTORIES.has(entry.name)) {
+          await visit(path.join(currentPath, entry.name));
+        }
+        continue;
+      }
+
+      if (!entry.isFile()) {
+        continue;
+      }
+
+      const filePath = path.join(currentPath, entry.name);
+      if (isActiveSourceFile(filePath)) {
+        files.push(filePath);
+      }
+    }
+  }
+}
+
+function isActiveSourceFile(filePath: string): boolean {
+  if (!ACTIVE_SOURCE_EXTENSIONS.has(path.extname(filePath))) {
+    return false;
+  }
+
+  return !/(?:^|\.)(?:spec|test)\.[cm]?[jt]sx?$/.test(path.basename(filePath));
+}
+
+function extractImportSpecifiers(source: string): string[] {
+  const specifiers = new Set<string>();
+  const patterns = [
+    /\b(?:import|export)\s+(?:type\s+)?(?:[^;]*?\sfrom\s*)?['"]([^'"]+)['"]/g,
+    /\b(?:import|require)\s*\(\s*['"]([^'"]+)['"]\s*\)/g,
+  ];
+
+  for (const pattern of patterns) {
+    for (const match of source.matchAll(pattern)) {
+      const [, specifier] = match;
+      if (specifier !== undefined) {
+        specifiers.add(specifier);
+      }
+    }
+  }
+
+  return [...specifiers].sort((left, right) => left.localeCompare(right));
+}
+
+function collectDependencyEntries(packageJson: Record<string, unknown>): DependencyEntry[] {
+  const entries: DependencyEntry[] = [];
+
+  for (const fieldName of DEPENDENCY_FIELD_NAMES) {
+    const dependencies = isRecord(packageJson[fieldName]) ? packageJson[fieldName] : null;
+    if (dependencies === null) {
+      continue;
+    }
+
+    for (const [packageName, version] of Object.entries(dependencies)) {
+      if (isNonEmptyString(version)) {
+        entries.push({ fieldName, packageName, version });
+      }
+    }
+  }
+
+  return entries.sort((left, right) => {
+    const fieldComparison = left.fieldName.localeCompare(right.fieldName);
+    return fieldComparison !== 0
+      ? fieldComparison
+      : left.packageName.localeCompare(right.packageName);
+  });
+}
+
+function hasAnkhProvider(packageJson: Record<string, unknown>): boolean {
   const ankh = isRecord(packageJson.ankh) ? packageJson.ankh : null;
-  const exportsField = isRecord(packageJson.exports) ? packageJson.exports : null;
+  return isNonEmptyString(ankh?.provider);
+}
+
+function isPackageImport(specifier: string, packageName: string): boolean {
+  return specifier === packageName || specifier.startsWith(`${packageName}/`);
+}
 
-  return isNonEmptyString(ankh?.provider) || exportsField?.['./cli'] !== undefined;
+function toOwningPackageSpecifier(specifier: string): string {
+  return `@ankhorage/${specifier.slice(COMPATIBILITY_PACKAGE_PREFIX.length)}`;
 }
 
 async function readPackageJson(packageJsonPath: string): Promise<Record<string, unknown> | null> {

package/src/diagnostics.ts

@@ -22,14 +22,19 @@ export type DoctorRuleId =
   | 'package.ankh.present.valid-shape'
   | 'package.ankh.provider-path.required'
   | 'package.ankh.required-for-provider'
+  | 'package.cli.export.required'
   | 'package.cli.index.required'
   | 'package.cli.root-file.disallowed'
+  | 'package.dependencies.ankh-workspace-alias.disallowed'
+  | 'package.dependencies.ankhorage4-source.disallowed'
   | 'package.dependencies.changesets.required'
   | 'package.dependencies.devtools.required'
   | 'package.dependencies.paradox.required'
   | 'package.dependencies.types-bun.required'
   | 'package.dependencies.types-node.required'
   | 'package.dependencies.typescript.required'
+  | 'package.imports.ankh-workspace-alias.disallowed'
+  | 'package.imports.ankhorage4-source.disallowed'
   | 'package.json.bugs.required'
   | 'package.json.description.required'
   | 'package.json.exports.required'
@@ -68,6 +73,10 @@ export type DoctorRuleId =
   | 'repo.license.required'
   | 'repo.readme.required'
   | 'repo.workflows.required'
+  | 'studio.dependencies.dnd.required'
+  | 'studio.dependencies.runtime.required'
+  | 'studio.imports.dnd.required'
+  | 'studio.imports.runtime.required'
   | 'target.package-json.required'
   | 'target.path.directory'
   | 'target.path.exists'