@ankhorage/doctor 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.10.0
+
+### Minor Changes
+
+- c2e3845: Surface exact native OAuth callback schemes and native app-build requirements in Doctor readiness without duplicating runtime host detection.
+
 ## 0.9.0
 
 ### Minor Changes

package/dist/authReadinessEnvironment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authReadinessEnvironment.d.ts","sourceRoot":"","sources":["../src/authReadinessEnvironment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EACV,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,wBAAgB,+BAA+B,CAAC,KAAK,EAAE;IACrD,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;IAC7C,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;CACpC,GAAG;IACF,QAAQ,CAAC,oBAAoB,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC5D,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;CAChD,CA6BA"}
+{"version":3,"file":"authReadinessEnvironment.d.ts","sourceRoot":"","sources":["../src/authReadinessEnvironment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EACV,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AAOrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,wBAAgB,+BAA+B,CAAC,KAAK,EAAE;IACrD,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;IAC7C,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;CACpC,GAAG;IACF,QAAQ,CAAC,oBAAoB,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC5D,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;CAChD,CAgCA"}

package/dist/authReadinessEnvironment.js

@@ -1,3 +1,4 @@
+import { createAuthReadinessMessage, resolveNativeAuthReadinessContext, } from './authReadinessNativeContext.js';
 import { collectMissingAuthReadinessRequirements } from './authReadinessRequirements.js';
 export function analyzeAuthReadinessEnvironment(input) {
     const missingNativeTargets = new Set();
@@ -12,12 +13,16 @@ export function analyzeAuthReadinessEnvironment(input) {
         if (target !== 'web' && missing.includes(`${target} deep-link scheme`)) {
             missingNativeTargets.add(target);
         }
+        const nativeContext = resolveNativeAuthReadinessContext({ target, targets: input.targets });
         return {
+            ...nativeContext,
             category: 'auth-oauth',
             environment: input.environment,
-            message: missing.length === 0
-                ? 'Manifest and adapter setup requirements are satisfiable; concrete callback URLs remain Infra/runtime-owned.'
-                : `Missing ${missing.join(' and ')}.`,
+            message: createAuthReadinessMessage({
+                ...nativeContext,
+                missing,
+                target,
+            }),
             provider: input.provider,
             status: missing.length === 0 ? 'ready' : 'missing',
             target,

package/dist/authReadinessEnvironment.js.map

@@ -1 +1 @@
-{"version":3,"file":"authReadinessEnvironment.js","sourceRoot":"","sources":["../src/authReadinessEnvironment.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,uCAAuC,EAAE,MAAM,gCAAgC,CAAC;AAGzF,MAAM,UAAU,+BAA+B,CAAC,KAQ/C;IAIC,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC1D,MAAM,SAAS,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,MAAM,EAAmB,EAAE;QACrE,MAAM,OAAO,GAAG,uCAAuC,CAAC;YACtD,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM;YACN,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;QACH,IAAI,MAAM,KAAK,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,MAAM,mBAAmB,CAAC,EAAE,CAAC;YACvE,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,YAAY;YACtB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,OAAO,EACL,OAAO,CAAC,MAAM,KAAK,CAAC;gBAClB,CAAC,CAAC,6GAA6G;gBAC/G,CAAC,CAAC,WAAW,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG;YACzC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;YAClD,MAAM;YACN,SAAS,EAAE,kBAAkB;SAC9B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,oBAAoB,EAAE,CAAC,GAAG,oBAAoB,CAAC,EAAE,SAAS,EAAE,CAAC;AACxE,CAAC","sourcesContent":["import type { AuthOAuthSetupPlan } from '@ankhorage/contracts/auth';\nimport type {\n  AppDeployEnvironmentId,\n  AppDeployTargetId,\n  AppDeployTargets,\n} from '@ankhorage/contracts/deploy';\n\nimport { collectMissingAuthReadinessRequirements } from './authReadinessRequirements.js';\nimport type { DoctorReadiness } from './readiness.js';\n\nexport function analyzeAuthReadinessEnvironment(input: {\n  readonly callbackRoute: unknown;\n  readonly credentialsRef: unknown;\n  readonly enabledTargets: readonly AppDeployTargetId[];\n  readonly environment: AppDeployEnvironmentId;\n  readonly plan: AuthOAuthSetupPlan;\n  readonly provider: string;\n  readonly targets: AppDeployTargets;\n}): {\n  readonly missingNativeTargets: readonly AppDeployTargetId[];\n  readonly readiness: readonly DoctorReadiness[];\n} {\n  const missingNativeTargets = new Set<AppDeployTargetId>();\n  const readiness = input.enabledTargets.map((target): DoctorReadiness => {\n    const missing = collectMissingAuthReadinessRequirements({\n      callbackRoute: input.callbackRoute,\n      credentialsRef: input.credentialsRef,\n      plan: input.plan,\n      target,\n      targets: input.targets,\n    });\n    if (target !== 'web' && missing.includes(`${target} deep-link scheme`)) {\n      missingNativeTargets.add(target);\n    }\n\n    return {\n      category: 'auth-oauth',\n      environment: input.environment,\n      message:\n        missing.length === 0\n          ? 'Manifest and adapter setup requirements are satisfiable; concrete callback URLs remain Infra/runtime-owned.'\n          : `Missing ${missing.join(' and ')}.`,\n      provider: input.provider,\n      status: missing.length === 0 ? 'ready' : 'missing',\n      target,\n      transport: 'brokeredRedirect',\n    };\n  });\n\n  return { missingNativeTargets: [...missingNativeTargets], readiness };\n}\n"]}
+{"version":3,"file":"authReadinessEnvironment.js","sourceRoot":"","sources":["../src/authReadinessEnvironment.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,0BAA0B,EAC1B,iCAAiC,GAClC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,uCAAuC,EAAE,MAAM,gCAAgC,CAAC;AAGzF,MAAM,UAAU,+BAA+B,CAAC,KAQ/C;IAIC,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC1D,MAAM,SAAS,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,MAAM,EAAmB,EAAE;QACrE,MAAM,OAAO,GAAG,uCAAuC,CAAC;YACtD,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM;YACN,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;QACH,IAAI,MAAM,KAAK,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,MAAM,mBAAmB,CAAC,EAAE,CAAC;YACvE,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,aAAa,GAAG,iCAAiC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5F,OAAO;YACL,GAAG,aAAa;YAChB,QAAQ,EAAE,YAAY;YACtB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,OAAO,EAAE,0BAA0B,CAAC;gBAClC,GAAG,aAAa;gBAChB,OAAO;gBACP,MAAM;aACP,CAAC;YACF,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;YAClD,MAAM;YACN,SAAS,EAAE,kBAAkB;SAC9B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,oBAAoB,EAAE,CAAC,GAAG,oBAAoB,CAAC,EAAE,SAAS,EAAE,CAAC;AACxE,CAAC","sourcesContent":["import type { AuthOAuthSetupPlan } from '@ankhorage/contracts/auth';\nimport type {\n  AppDeployEnvironmentId,\n  AppDeployTargetId,\n  AppDeployTargets,\n} from '@ankhorage/contracts/deploy';\n\nimport {\n  createAuthReadinessMessage,\n  resolveNativeAuthReadinessContext,\n} from './authReadinessNativeContext.js';\nimport { collectMissingAuthReadinessRequirements } from './authReadinessRequirements.js';\nimport type { DoctorReadiness } from './readiness.js';\n\nexport function analyzeAuthReadinessEnvironment(input: {\n  readonly callbackRoute: unknown;\n  readonly credentialsRef: unknown;\n  readonly enabledTargets: readonly AppDeployTargetId[];\n  readonly environment: AppDeployEnvironmentId;\n  readonly plan: AuthOAuthSetupPlan;\n  readonly provider: string;\n  readonly targets: AppDeployTargets;\n}): {\n  readonly missingNativeTargets: readonly AppDeployTargetId[];\n  readonly readiness: readonly DoctorReadiness[];\n} {\n  const missingNativeTargets = new Set<AppDeployTargetId>();\n  const readiness = input.enabledTargets.map((target): DoctorReadiness => {\n    const missing = collectMissingAuthReadinessRequirements({\n      callbackRoute: input.callbackRoute,\n      credentialsRef: input.credentialsRef,\n      plan: input.plan,\n      target,\n      targets: input.targets,\n    });\n    if (target !== 'web' && missing.includes(`${target} deep-link scheme`)) {\n      missingNativeTargets.add(target);\n    }\n\n    const nativeContext = resolveNativeAuthReadinessContext({ target, targets: input.targets });\n    return {\n      ...nativeContext,\n      category: 'auth-oauth',\n      environment: input.environment,\n      message: createAuthReadinessMessage({\n        ...nativeContext,\n        missing,\n        target,\n      }),\n      provider: input.provider,\n      status: missing.length === 0 ? 'ready' : 'missing',\n      target,\n      transport: 'brokeredRedirect',\n    };\n  });\n\n  return { missingNativeTargets: [...missingNativeTargets], readiness };\n}\n"]}

package/dist/authReadinessNativeContext.d.ts

@@ -0,0 +1,13 @@
+import type { AppDeployTargetId, AppDeployTargets } from '@ankhorage/contracts/deploy';
+import type { DoctorReadiness } from './readiness.js';
+export type NativeAuthReadinessContext = Pick<DoctorReadiness, 'callbackScheme' | 'hostRequirement'>;
+export declare function resolveNativeAuthReadinessContext(input: {
+    readonly target: AppDeployTargetId;
+    readonly targets: AppDeployTargets;
+}): NativeAuthReadinessContext;
+export declare function createAuthReadinessMessage(input: {
+    readonly callbackScheme?: string;
+    readonly missing: readonly string[];
+    readonly target: AppDeployTargetId;
+}): string;
+//# sourceMappingURL=authReadinessNativeContext.d.ts.map

package/dist/authReadinessNativeContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authReadinessNativeContext.d.ts","sourceRoot":"","sources":["../src/authReadinessNativeContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAC3C,eAAe,EACf,gBAAgB,GAAG,iBAAiB,CACrC,CAAC;AAEF,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IACvD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;CACpC,GAAG,0BAA0B,CAQ7B;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC,GAAG,MAAM,CAUT"}

package/dist/authReadinessNativeContext.js

@@ -0,0 +1,19 @@
+export function resolveNativeAuthReadinessContext(input) {
+    if (input.target === 'web')
+        return {};
+    const callbackScheme = input.targets[input.target]?.scheme;
+    return {
+        ...(callbackScheme === undefined ? {} : { callbackScheme }),
+        hostRequirement: 'development-or-standalone-build',
+    };
+}
+export function createAuthReadinessMessage(input) {
+    const base = input.missing.length === 0
+        ? 'Manifest and adapter setup requirements are satisfiable; concrete callback URLs remain Infra/runtime-owned.'
+        : `Missing ${input.missing.join(' and ')}.`;
+    if (input.target === 'web')
+        return base;
+    const scheme = input.callbackScheme === undefined ? '' : ` Callback scheme: ${input.callbackScheme}.`;
+    return `${base}${scheme} Native OAuth requires a development or standalone app build; runtime host compatibility remains runtime-owned.`;
+}
+//# sourceMappingURL=authReadinessNativeContext.js.map

package/dist/authReadinessNativeContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authReadinessNativeContext.js","sourceRoot":"","sources":["../src/authReadinessNativeContext.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,iCAAiC,CAAC,KAGjD;IACC,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK;QAAE,OAAO,EAAE,CAAC;IAEtC,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAC3D,OAAO;QACL,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC;QAC3D,eAAe,EAAE,iCAAiC;KACnD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAI1C;IACC,MAAM,IAAI,GACR,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QACxB,CAAC,CAAC,6GAA6G;QAC/G,CAAC,CAAC,WAAW,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;IAChD,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAExC,MAAM,MAAM,GACV,KAAK,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,qBAAqB,KAAK,CAAC,cAAc,GAAG,CAAC;IACzF,OAAO,GAAG,IAAI,GAAG,MAAM,iHAAiH,CAAC;AAC3I,CAAC","sourcesContent":["import type { AppDeployTargetId, AppDeployTargets } from '@ankhorage/contracts/deploy';\n\nimport type { DoctorReadiness } from './readiness.js';\n\nexport type NativeAuthReadinessContext = Pick<\n  DoctorReadiness,\n  'callbackScheme' | 'hostRequirement'\n>;\n\nexport function resolveNativeAuthReadinessContext(input: {\n  readonly target: AppDeployTargetId;\n  readonly targets: AppDeployTargets;\n}): NativeAuthReadinessContext {\n  if (input.target === 'web') return {};\n\n  const callbackScheme = input.targets[input.target]?.scheme;\n  return {\n    ...(callbackScheme === undefined ? {} : { callbackScheme }),\n    hostRequirement: 'development-or-standalone-build',\n  };\n}\n\nexport function createAuthReadinessMessage(input: {\n  readonly callbackScheme?: string;\n  readonly missing: readonly string[];\n  readonly target: AppDeployTargetId;\n}): string {\n  const base =\n    input.missing.length === 0\n      ? 'Manifest and adapter setup requirements are satisfiable; concrete callback URLs remain Infra/runtime-owned.'\n      : `Missing ${input.missing.join(' and ')}.`;\n  if (input.target === 'web') return base;\n\n  const scheme =\n    input.callbackScheme === undefined ? '' : ` Callback scheme: ${input.callbackScheme}.`;\n  return `${base}${scheme} Native OAuth requires a development or standalone app build; runtime host compatibility remains runtime-owned.`;\n}\n"]}

package/dist/readiness.d.ts

@@ -2,8 +2,10 @@ import type { AuthOAuthProviderId, AuthOAuthTransportId } from '@ankhorage/contr
 import type { AppDeployEnvironmentId, AppDeployTargetId } from '@ankhorage/contracts/deploy';
 export type DoctorReadinessStatus = 'missing' | 'ready' | 'unsupported';
 export interface DoctorReadiness {
+    readonly callbackScheme?: string;
     readonly category: 'auth-oauth';
     readonly environment: AppDeployEnvironmentId;
+    readonly hostRequirement?: 'development-or-standalone-build';
     readonly message: string;
     readonly provider: AuthOAuthProviderId;
     readonly status: DoctorReadinessStatus;

package/dist/readiness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readiness.d.ts","sourceRoot":"","sources":["../src/readiness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAC3F,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAE7F,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC;AAExE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;CAC1C"}
+{"version":3,"file":"readiness.d.ts","sourceRoot":"","sources":["../src/readiness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAC3F,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAE7F,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC;AAExE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;IAC7C,QAAQ,CAAC,eAAe,CAAC,EAAE,iCAAiC,CAAC;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;CAC1C"}

package/dist/readiness.js.map

@@ -1 +1 @@
-{"version":3,"file":"readiness.js","sourceRoot":"","sources":["../src/readiness.ts"],"names":[],"mappings":"","sourcesContent":["import type { AuthOAuthProviderId, AuthOAuthTransportId } from '@ankhorage/contracts/auth';\nimport type { AppDeployEnvironmentId, AppDeployTargetId } from '@ankhorage/contracts/deploy';\n\nexport type DoctorReadinessStatus = 'missing' | 'ready' | 'unsupported';\n\nexport interface DoctorReadiness {\n  readonly category: 'auth-oauth';\n  readonly environment: AppDeployEnvironmentId;\n  readonly message: string;\n  readonly provider: AuthOAuthProviderId;\n  readonly status: DoctorReadinessStatus;\n  readonly target: AppDeployTargetId;\n  readonly transport: AuthOAuthTransportId;\n}\n"]}
+{"version":3,"file":"readiness.js","sourceRoot":"","sources":["../src/readiness.ts"],"names":[],"mappings":"","sourcesContent":["import type { AuthOAuthProviderId, AuthOAuthTransportId } from '@ankhorage/contracts/auth';\nimport type { AppDeployEnvironmentId, AppDeployTargetId } from '@ankhorage/contracts/deploy';\n\nexport type DoctorReadinessStatus = 'missing' | 'ready' | 'unsupported';\n\nexport interface DoctorReadiness {\n  readonly callbackScheme?: string;\n  readonly category: 'auth-oauth';\n  readonly environment: AppDeployEnvironmentId;\n  readonly hostRequirement?: 'development-or-standalone-build';\n  readonly message: string;\n  readonly provider: AuthOAuthProviderId;\n  readonly status: DoctorReadinessStatus;\n  readonly target: AppDeployTargetId;\n  readonly transport: AuthOAuthTransportId;\n}\n"]}

package/package.json

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

package/src/authReadinessEnvironment.ts

@@ -5,6 +5,10 @@ import type {
   AppDeployTargets,
 } from '@ankhorage/contracts/deploy';
 
+import {
+  createAuthReadinessMessage,
+  resolveNativeAuthReadinessContext,
+} from './authReadinessNativeContext.js';
 import { collectMissingAuthReadinessRequirements } from './authReadinessRequirements.js';
 import type { DoctorReadiness } from './readiness.js';
 
@@ -33,13 +37,16 @@ export function analyzeAuthReadinessEnvironment(input: {
       missingNativeTargets.add(target);
     }
 
+    const nativeContext = resolveNativeAuthReadinessContext({ target, targets: input.targets });
     return {
+      ...nativeContext,
       category: 'auth-oauth',
       environment: input.environment,
-      message:
-        missing.length === 0
-          ? 'Manifest and adapter setup requirements are satisfiable; concrete callback URLs remain Infra/runtime-owned.'
-          : `Missing ${missing.join(' and ')}.`,
+      message: createAuthReadinessMessage({
+        ...nativeContext,
+        missing,
+        target,
+      }),
       provider: input.provider,
       status: missing.length === 0 ? 'ready' : 'missing',
       target,

package/src/authReadinessNativeContext.ts

@@ -0,0 +1,37 @@
+import type { AppDeployTargetId, AppDeployTargets } from '@ankhorage/contracts/deploy';
+
+import type { DoctorReadiness } from './readiness.js';
+
+export type NativeAuthReadinessContext = Pick<
+  DoctorReadiness,
+  'callbackScheme' | 'hostRequirement'
+>;
+
+export function resolveNativeAuthReadinessContext(input: {
+  readonly target: AppDeployTargetId;
+  readonly targets: AppDeployTargets;
+}): NativeAuthReadinessContext {
+  if (input.target === 'web') return {};
+
+  const callbackScheme = input.targets[input.target]?.scheme;
+  return {
+    ...(callbackScheme === undefined ? {} : { callbackScheme }),
+    hostRequirement: 'development-or-standalone-build',
+  };
+}
+
+export function createAuthReadinessMessage(input: {
+  readonly callbackScheme?: string;
+  readonly missing: readonly string[];
+  readonly target: AppDeployTargetId;
+}): string {
+  const base =
+    input.missing.length === 0
+      ? 'Manifest and adapter setup requirements are satisfiable; concrete callback URLs remain Infra/runtime-owned.'
+      : `Missing ${input.missing.join(' and ')}.`;
+  if (input.target === 'web') return base;
+
+  const scheme =
+    input.callbackScheme === undefined ? '' : ` Callback scheme: ${input.callbackScheme}.`;
+  return `${base}${scheme} Native OAuth requires a development or standalone app build; runtime host compatibility remains runtime-owned.`;
+}

package/src/readiness.ts

@@ -4,8 +4,10 @@ import type { AppDeployEnvironmentId, AppDeployTargetId } from '@ankhorage/contr
 export type DoctorReadinessStatus = 'missing' | 'ready' | 'unsupported';
 
 export interface DoctorReadiness {
+  readonly callbackScheme?: string;
   readonly category: 'auth-oauth';
   readonly environment: AppDeployEnvironmentId;
+  readonly hostRequirement?: 'development-or-standalone-build';
   readonly message: string;
   readonly provider: AuthOAuthProviderId;
   readonly status: DoctorReadinessStatus;