@ankhorage/doctor 0.3.1 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # 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
+
+- 1d1a8fd: Enforce the canonical `src/cli/index.ts` provider layout, reject root `src/cli.ts` files, and move the Doctor standalone executable under `src/cli/`.
+
 ## 0.3.1
 
 ### Patch Changes

package/README.md

@@ -3,7 +3,7 @@
 
 # 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 Ankhorage repo and package compliance diagnostics.
 
@@ -46,7 +46,7 @@ Path handling:
 Source: `src/readme-usage.ts`
 
 ```ts
-import { runCli } from './cli.js';
+import { runCli } from './cli/standalone.js';
 
 await runCli(['--help']);
 ```

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAsB,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAEtF,OAAO,EAGL,KAAK,qBAAqB,EAE1B,KAAK,oBAAoB,EAC1B,MAAM,gBAAgB,CAAC;AAQxB,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,CA4B5B;AAED,QAAA,MAAM,QAAQ,4BAAgC,CAAC;AAE/C,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAsB,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAGtF,OAAO,EAGL,KAAK,qBAAqB,EAE1B,KAAK,oBAAoB,EAC1B,MAAM,gBAAgB,CAAC;AAQxB,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,CAgC5B;AAED,QAAA,MAAM,QAAQ,4BAAgC,CAAC;AAE/C,eAAe,QAAQ,CAAC"}

package/dist/cli/index.js

@@ -1,7 +1,12 @@
+import { analyzeDoctorTargetWithCliLayout } from '../cliLayoutAnalysis.js';
 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;
+    const services = {
+        analyzeTarget: analyzeDoctorTargetWithCliLayout,
+        ...options.services,
+    };
     return {
         id: DOCTOR_PACKAGE_NAME,
         category: DOCTOR_COMMAND_CATEGORY,
@@ -14,7 +19,7 @@ export function createDoctorRuntimeProvider(options = {}) {
                 command,
                 context: request.context,
             }, {
-                services: options.services,
+                services,
             });
             return {
                 path: command.path,

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gCAAgC,EAChC,eAAe,EAEf,gBAAgB,GAEjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAO/B,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;YACxC,MAAM,OAAO,GAAuB,CAAC,OAAO,EAAE,EAAE,CAC9C,cAAc,CACZ;gBACE,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,OAAO;gBACP,OAAO,EAAE,OAAO,CAAC,OAAO;aACzB,EACD;gBACE,QAAQ,EAAE,OAAO,CAAC,QAAQ;aAC3B,CACF,CAAC;YAEJ,OAAO;gBACL,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,OAAO;aACR,CAAC;QACJ,CAAC,CAAC;KACkC,CAAC;AACzC,CAAC;AAED,MAAM,QAAQ,GAAG,2BAA2B,EAAE,CAAC;AAE/C,eAAe,QAAQ,CAAC","sourcesContent":["import type { AnkhCommandHandler, AnkhRuntimeCommandProvider } from '@ankhorage/ankh';\n\nimport {\n  createProviderCommandDescriptors,\n  DOCTOR_COMMANDS,\n  type DoctorCommandServices,\n  runDoctorCommand,\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      const handler: AnkhCommandHandler = (request) =>\n        runCommandImpl(\n          {\n            argv: request.argv,\n            command,\n            context: request.context,\n          },\n          {\n            services: options.services,\n          },\n        );\n\n      return {\n        path: command.path,\n        handler,\n      };\n    }),\n  } satisfies AnkhRuntimeCommandProvider;\n}\n\nconst provider = createDoctorRuntimeProvider();\n\nexport default provider;\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gCAAgC,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EACL,gCAAgC,EAChC,eAAe,EAEf,gBAAgB,GAEjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAO/B,MAAM,UAAU,2BAA2B,CACzC,UAA8C,EAAE;IAEhD,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,gBAAgB,CAAC;IAClE,MAAM,QAAQ,GAAG;QACf,aAAa,EAAE,gCAAgC;QAC/C,GAAG,OAAO,CAAC,QAAQ;KACY,CAAC;IAElC,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;YACxC,MAAM,OAAO,GAAuB,CAAC,OAAO,EAAE,EAAE,CAC9C,cAAc,CACZ;gBACE,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,OAAO;gBACP,OAAO,EAAE,OAAO,CAAC,OAAO;aACzB,EACD;gBACE,QAAQ;aACT,CACF,CAAC;YAEJ,OAAO;gBACL,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,OAAO;aACR,CAAC;QACJ,CAAC,CAAC;KACkC,CAAC;AACzC,CAAC;AAED,MAAM,QAAQ,GAAG,2BAA2B,EAAE,CAAC;AAE/C,eAAe,QAAQ,CAAC","sourcesContent":["import type { AnkhCommandHandler, AnkhRuntimeCommandProvider } from '@ankhorage/ankh';\n\nimport { analyzeDoctorTargetWithCliLayout } from '../cliLayoutAnalysis.js';\nimport {\n  createProviderCommandDescriptors,\n  DOCTOR_COMMANDS,\n  type DoctorCommandServices,\n  runDoctorCommand,\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  const services = {\n    analyzeTarget: analyzeDoctorTargetWithCliLayout,\n    ...options.services,\n  } satisfies DoctorCommandServices;\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      const handler: AnkhCommandHandler = (request) =>\n        runCommandImpl(\n          {\n            argv: request.argv,\n            command,\n            context: request.context,\n          },\n          {\n            services,\n          },\n        );\n\n      return {\n        path: command.path,\n        handler,\n      };\n    }),\n  } satisfies AnkhRuntimeCommandProvider;\n}\n\nconst provider = createDoctorRuntimeProvider();\n\nexport default provider;\n"]}

package/dist/{cli.d.ts → cli/standalone.d.ts}

@@ -1,10 +1,10 @@
 #!/usr/bin/env bun
-import type { DoctorCommandContext, DoctorCommandRunResult } from './commandContext.js';
-import { type DoctorCommandServices, type RunDoctorCommandImpl } from './commands.js';
+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
+//# sourceMappingURL=standalone.d.ts.map

package/dist/cli/standalone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone.d.ts","sourceRoot":"","sources":["../../src/cli/standalone.ts"],"names":[],"mappings":";AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEzF,OAAO,EACL,KAAK,qBAAqB,EAK1B,KAAK,oBAAoB,EAC1B,MAAM,gBAAgB,CAAC;AAExB,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,CAkCjC"}

package/dist/{cli.js → cli/standalone.js}

@@ -1,6 +1,7 @@
 #!/usr/bin/env bun
-import { createDefaultCommandContext } from './commandContext.js';
-import { findDoctorCommandByStandaloneName, renderRootHelp, renderUnknownCommand, runDoctorCommand, } from './commands.js';
+import { analyzeDoctorTargetWithCliLayout } from '../cliLayoutAnalysis.js';
+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;
@@ -23,7 +24,10 @@ export async function runCli(argv, options = {}) {
         command,
         context,
     }, {
-        services: options.services,
+        services: {
+            analyzeTarget: analyzeDoctorTargetWithCliLayout,
+            ...options.services,
+        },
     });
 }
 function isHelpToken(value) {
@@ -36,4 +40,4 @@ if (import.meta.main) {
     const result = await runCli(process.argv.slice(2));
     process.exit(result.exitCode);
 }
-//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=standalone.js.map

package/dist/cli/standalone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone.js","sourceRoot":"","sources":["../../src/cli/standalone.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,gCAAgC,EAAE,MAAM,yBAAyB,CAAC;AAE3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAEL,iCAAiC,EACjC,cAAc,EACd,oBAAoB,EACpB,gBAAgB,GAEjB,MAAM,gBAAgB,CAAC;AAQxB,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;YACR,aAAa,EAAE,gCAAgC;YAC/C,GAAG,OAAO,CAAC,QAAQ;SACpB;KACF,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 { analyzeDoctorTargetWithCliLayout } from '../cliLayoutAnalysis.js';\nimport type { DoctorCommandContext, DoctorCommandRunResult } from '../commandContext.js';\nimport { createDefaultCommandContext } from '../commandContext.js';\nimport {\n  type DoctorCommandServices,\n  findDoctorCommandByStandaloneName,\n  renderRootHelp,\n  renderUnknownCommand,\n  runDoctorCommand,\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: {\n        analyzeTarget: analyzeDoctorTargetWithCliLayout,\n        ...options.services,\n      },\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/cliLayoutAnalysis.d.ts

@@ -0,0 +1,3 @@
+import { type DoctorAnalysisRequest, type DoctorAnalysisResult } from './analysis.js';
+export declare function analyzeDoctorTargetWithCliLayout(request: DoctorAnalysisRequest): Promise<DoctorAnalysisResult>;
+//# sourceMappingURL=cliLayoutAnalysis.d.ts.map

package/dist/cliLayoutAnalysis.d.ts.map

@@ -0,0 +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;AAsDvB,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CA6B/B"}

package/dist/cliLayoutAnalysis.js

@@ -0,0 +1,344 @@
+import { promises as fs } from 'node:fs';
+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 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, ...architectureDiagnostics];
+    return {
+        ...result,
+        diagnostics,
+        fixPlan: result.fixPlan === null ? null : { ...result.fixPlan, diagnostics },
+    };
+}
+async function analyzeTargetArchitecture(request) {
+    const diagnostics = [];
+    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: request.profile,
+            ruleId: 'package.cli.root-file.disallowed',
+            severity: 'error',
+        });
+    }
+    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: 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 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;
+    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 {
+        const parsed = JSON.parse(await fs.readFile(packageJsonPath, 'utf8'));
+        return isRecord(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function pathExists(targetPath) {
+    try {
+        await fs.access(targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=cliLayoutAnalysis.js.map

package/dist/cliLayoutAnalysis.js.map

@@ -0,0 +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');\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.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,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":"AAmFA,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.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/dist/index.d.ts

@@ -1,7 +1,8 @@
 export type { DoctorAnalysisRequest, DoctorAnalysisResult, DoctorFixPlan, DoctorPlannedChange, DoctorPlannedChangeKind, DoctorTargetCheck, DoctorTargetMode, } from './analysis.js';
 export { analyzeDoctorTarget } from './analysis.js';
-export { runCli } from './cli.js';
 export { createDoctorRuntimeProvider, type CreateDoctorRuntimeProviderOptions, } from './cli/index.js';
+export { runCli } from './cli/standalone.js';
+export { analyzeDoctorTargetWithCliLayout } from './cliLayoutAnalysis.js';
 export type { DoctorCommandContext, DoctorCommandRunResult } from './commandContext.js';
 export { createDefaultCommandContext } from './commandContext.js';
 export type { DoctorDiagnostic, DoctorDiagnosticCode, DoctorDiagnosticSeverity, DoctorPolicyProfile, DoctorRuleId, } from './diagnostics.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EACL,2BAA2B,EAC3B,KAAK,kCAAkC,GACxC,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACL,2BAA2B,EAC3B,KAAK,kCAAkC,GACxC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,gCAAgC,EAAE,MAAM,wBAAwB,CAAC;AAC1E,YAAY,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,6 +1,7 @@
 export { analyzeDoctorTarget } from './analysis.js';
-export { runCli } from './cli.js';
 export { createDoctorRuntimeProvider, } from './cli/index.js';
+export { runCli } from './cli/standalone.js';
+export { analyzeDoctorTargetWithCliLayout } from './cliLayoutAnalysis.js';
 export { createDefaultCommandContext } from './commandContext.js';
 export { DOCTOR_CAPABILITIES, DOCTOR_COMMAND_CATEGORY, DOCTOR_PACKAGE_METADATA, DOCTOR_PACKAGE_NAME, DOCTOR_PACKAGE_VERSION, } from './packageMetadata.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EACL,2BAA2B,GAE5B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAQlE,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC","sourcesContent":["export type {\n  DoctorAnalysisRequest,\n  DoctorAnalysisResult,\n  DoctorFixPlan,\n  DoctorPlannedChange,\n  DoctorPlannedChangeKind,\n  DoctorTargetCheck,\n  DoctorTargetMode,\n} from './analysis.js';\nexport { analyzeDoctorTarget } from './analysis.js';\nexport { runCli } from './cli.js';\nexport {\n  createDoctorRuntimeProvider,\n  type CreateDoctorRuntimeProviderOptions,\n} from './cli/index.js';\nexport type { DoctorCommandContext, DoctorCommandRunResult } from './commandContext.js';\nexport { createDefaultCommandContext } from './commandContext.js';\nexport type {\n  DoctorDiagnostic,\n  DoctorDiagnosticCode,\n  DoctorDiagnosticSeverity,\n  DoctorPolicyProfile,\n  DoctorRuleId,\n} from './diagnostics.js';\nexport {\n  DOCTOR_CAPABILITIES,\n  DOCTOR_COMMAND_CATEGORY,\n  DOCTOR_PACKAGE_METADATA,\n  DOCTOR_PACKAGE_NAME,\n  DOCTOR_PACKAGE_VERSION,\n} from './packageMetadata.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACL,2BAA2B,GAE5B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,gCAAgC,EAAE,MAAM,wBAAwB,CAAC;AAE1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAQlE,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC","sourcesContent":["export type {\n  DoctorAnalysisRequest,\n  DoctorAnalysisResult,\n  DoctorFixPlan,\n  DoctorPlannedChange,\n  DoctorPlannedChangeKind,\n  DoctorTargetCheck,\n  DoctorTargetMode,\n} from './analysis.js';\nexport { analyzeDoctorTarget } from './analysis.js';\nexport {\n  createDoctorRuntimeProvider,\n  type CreateDoctorRuntimeProviderOptions,\n} from './cli/index.js';\nexport { runCli } from './cli/standalone.js';\nexport { analyzeDoctorTargetWithCliLayout } from './cliLayoutAnalysis.js';\nexport type { DoctorCommandContext, DoctorCommandRunResult } from './commandContext.js';\nexport { createDefaultCommandContext } from './commandContext.js';\nexport type {\n  DoctorDiagnostic,\n  DoctorDiagnosticCode,\n  DoctorDiagnosticSeverity,\n  DoctorPolicyProfile,\n  DoctorRuleId,\n} from './diagnostics.js';\nexport {\n  DOCTOR_CAPABILITIES,\n  DOCTOR_COMMAND_CATEGORY,\n  DOCTOR_PACKAGE_METADATA,\n  DOCTOR_PACKAGE_NAME,\n  DOCTOR_PACKAGE_VERSION,\n} from './packageMetadata.js';\n"]}

package/dist/readme-usage.js

@@ -1,4 +1,4 @@
-import { runCli } from './cli.js';
+import { runCli } from './cli/standalone.js';
 /***
  * Provider and CLI surface
  *

package/dist/readme-usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"readme-usage.js","sourceRoot":"","sources":["../src/readme-usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC","sourcesContent":["import { runCli } from './cli.js';\n\n/***\n * Provider and CLI surface\n *\n * `@ankhorage/doctor` is the repo/package compliance provider for Ankhorage.\n *\n * The same shared command implementation backs both:\n *\n * - `ankh doctor ...`\n * - `bunx @ankhorage/doctor ...`\n *\n * Current command surface:\n *\n * - `validate`\n * - `fix`\n * - `repo`\n * - `package`\n *\n * `doctor#2` adds a profile-based policy engine:\n *\n * - strict `public-package` validation for extracted public package repos\n * - light recognized `integration-monorepo` validation for `ankhorage4`\n * - non-mutating `fix` plans for deterministic mechanical changes only\n *\n * Still deferred:\n *\n * - GitHub checks\n * - CI checks\n * - on-disk `fix --apply`\n * - deeper cross-repo policy enforcement\n *\n * Path handling:\n *\n * - pass `[path]`, or\n * - omit it to inspect the current working directory\n *\n * @usage\n */\nawait runCli(['--help']);\n"]}
+{"version":3,"file":"readme-usage.js","sourceRoot":"","sources":["../src/readme-usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC","sourcesContent":["import { runCli } from './cli/standalone.js';\n\n/***\n * Provider and CLI surface\n *\n * `@ankhorage/doctor` is the repo/package compliance provider for Ankhorage.\n *\n * The same shared command implementation backs both:\n *\n * - `ankh doctor ...`\n * - `bunx @ankhorage/doctor ...`\n *\n * Current command surface:\n *\n * - `validate`\n * - `fix`\n * - `repo`\n * - `package`\n *\n * `doctor#2` adds a profile-based policy engine:\n *\n * - strict `public-package` validation for extracted public package repos\n * - light recognized `integration-monorepo` validation for `ankhorage4`\n * - non-mutating `fix` plans for deterministic mechanical changes only\n *\n * Still deferred:\n *\n * - GitHub checks\n * - CI checks\n * - on-disk `fix --apply`\n * - deeper cross-repo policy enforcement\n *\n * Path handling:\n *\n * - pass `[path]`, or\n * - omit it to inspect the current working directory\n *\n * @usage\n */\nawait runCli(['--help']);\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/doctor",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "description": "Executable Ankh provider and standalone CLI for lightweight repo and package compliance diagnostics.",
   "license": "MIT",
   "publishConfig": {
@@ -47,7 +47,7 @@
     "LICENSE"
   ],
   "bin": {
-    "ankhorage-doctor": "./dist/cli.js"
+    "ankhorage-doctor": "./dist/cli/standalone.js"
   },
   "ankh": {
     "category": "doctor",

package/src/cli/index.ts

@@ -1,5 +1,6 @@
 import type { AnkhCommandHandler, AnkhRuntimeCommandProvider } from '@ankhorage/ankh';
 
+import { analyzeDoctorTargetWithCliLayout } from '../cliLayoutAnalysis.js';
 import {
   createProviderCommandDescriptors,
   DOCTOR_COMMANDS,
@@ -23,6 +24,10 @@ export function createDoctorRuntimeProvider(
   options: CreateDoctorRuntimeProviderOptions = {},
 ): AnkhRuntimeCommandProvider {
   const runCommandImpl = options.runCommandImpl ?? runDoctorCommand;
+  const services = {
+    analyzeTarget: analyzeDoctorTargetWithCliLayout,
+    ...options.services,
+  } satisfies DoctorCommandServices;
 
   return {
     id: DOCTOR_PACKAGE_NAME,
@@ -39,7 +44,7 @@ export function createDoctorRuntimeProvider(
             context: request.context,
           },
           {
-            services: options.services,
+            services,
           },
         );
 

package/src/{cli.ts → cli/standalone.ts}

@@ -1,7 +1,8 @@
 #!/usr/bin/env bun
 
-import type { DoctorCommandContext, DoctorCommandRunResult } from './commandContext.js';
-import { createDefaultCommandContext } from './commandContext.js';
+import { analyzeDoctorTargetWithCliLayout } from '../cliLayoutAnalysis.js';
+import type { DoctorCommandContext, DoctorCommandRunResult } from '../commandContext.js';
+import { createDefaultCommandContext } from '../commandContext.js';
 import {
   type DoctorCommandServices,
   findDoctorCommandByStandaloneName,
@@ -9,7 +10,7 @@ import {
   renderUnknownCommand,
   runDoctorCommand,
   type RunDoctorCommandImpl,
-} from './commands.js';
+} from '../commands.js';
 
 export interface DoctorCliOptions {
   readonly context?: DoctorCommandContext;
@@ -48,7 +49,10 @@ export async function runCli(
       context,
     },
     {
-      services: options.services,
+      services: {
+        analyzeTarget: analyzeDoctorTargetWithCliLayout,
+        ...options.services,
+      },
     },
   );
 }

package/src/cliLayoutAnalysis.ts

@@ -0,0 +1,448 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+
+import {
+  analyzeDoctorTarget,
+  type DoctorAnalysisRequest,
+  type DoctorAnalysisResult,
+} from './analysis.js';
+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,
+): Promise<DoctorAnalysisResult> {
+  const result = await analyzeDoctorTarget(request);
+  if (!result.hasPackageJson) {
+    return result;
+  }
+
+  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, ...architectureDiagnostics];
+
+  return {
+    ...result,
+    diagnostics,
+    fixPlan: result.fixPlan === null ? null : { ...result.fixPlan, diagnostics },
+  };
+}
+
+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(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: request.profile,
+      ruleId: 'package.cli.root-file.disallowed',
+      severity: 'error',
+    });
+  }
+
+  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: 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 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;
+  return isNonEmptyString(ankh?.provider);
+}
+
+function isPackageImport(specifier: string, packageName: string): boolean {
+  return specifier === packageName || specifier.startsWith(`${packageName}/`);
+}
+
+function toOwningPackageSpecifier(specifier: string): string {
+  return `@ankhorage/${specifier.slice(COMPATIBILITY_PACKAGE_PREFIX.length)}`;
+}
+
+async function readPackageJson(packageJsonPath: string): Promise<Record<string, unknown> | null> {
+  try {
+    const parsed: unknown = JSON.parse(await fs.readFile(packageJsonPath, 'utf8'));
+    return isRecord(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+
+async function pathExists(targetPath: string): Promise<boolean> {
+  try {
+    await fs.access(targetPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function isNonEmptyString(value: unknown): value is string {
+  return typeof value === 'string' && value.trim().length > 0;
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}

package/src/diagnostics.ts

@@ -22,12 +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'
@@ -66,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'

package/src/index.ts

@@ -8,11 +8,12 @@ export type {
   DoctorTargetMode,
 } from './analysis.js';
 export { analyzeDoctorTarget } from './analysis.js';
-export { runCli } from './cli.js';
 export {
   createDoctorRuntimeProvider,
   type CreateDoctorRuntimeProviderOptions,
 } from './cli/index.js';
+export { runCli } from './cli/standalone.js';
+export { analyzeDoctorTargetWithCliLayout } from './cliLayoutAnalysis.js';
 export type { DoctorCommandContext, DoctorCommandRunResult } from './commandContext.js';
 export { createDefaultCommandContext } from './commandContext.js';
 export type {

package/src/readme-usage.ts

@@ -1,4 +1,4 @@
-import { runCli } from './cli.js';
+import { runCli } from './cli/standalone.js';
 
 /***
  * Provider and CLI surface

package/dist/cli.d.ts.map

@@ -1 +0,0 @@
-{"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,EACL,KAAK,qBAAqB,EAK1B,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.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAEL,iCAAiC,EACjC,cAAc,EACd,oBAAoB,EACpB,gBAAgB,GAEjB,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  type DoctorCommandServices,\n  findDoctorCommandByStandaloneName,\n  renderRootHelp,\n  renderUnknownCommand,\n  runDoctorCommand,\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"]}