@deploid/plugin-doctor 2.0.0

package/dist/index.d.ts

@@ -0,0 +1,57 @@
+type CheckStatus = 'pass' | 'warn' | 'fail';
+interface CheckResult {
+    id: string;
+    title: string;
+    status: CheckStatus;
+    message: string;
+    details?: string;
+}
+interface DoctorSummary {
+    ok: boolean;
+    cwd: string;
+    checks: CheckResult[];
+    totals: Record<CheckStatus, number>;
+}
+interface DoctorOptions {
+    json?: boolean;
+    projectOnly?: boolean;
+}
+interface PipelineContext {
+    logger: {
+        info: (message: string) => void;
+        warn: (message: string) => void;
+        error: (message: string) => void;
+    };
+    config: {
+        appName: string;
+        appId: string;
+        web: {
+            framework: string;
+            buildCommand: string;
+            webDir: string;
+        };
+        android: {
+            packaging: string;
+            signing?: {
+                keystorePath?: string;
+                storePasswordEnv?: string;
+                keyPasswordEnv?: string;
+            };
+        };
+        assets?: {
+            source: string;
+        };
+    };
+    cwd: string;
+    doctorOptions?: DoctorOptions;
+}
+declare const plugin: {
+    name: string;
+    plan: () => string[];
+    run: typeof runDoctor;
+};
+declare function runDoctor(ctx: PipelineContext): Promise<void>;
+declare function inspectProject(cwd: string, options?: DoctorOptions): Promise<DoctorSummary>;
+export default plugin;
+export { inspectProject, plugin };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5C,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,aAAa;IACrB,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,UAAU,eAAe;IACvB,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;KAClC,CAAC;IACF,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QACjE,OAAO,EAAE;YACP,SAAS,EAAE,MAAM,CAAC;YAClB,OAAO,CAAC,EAAE;gBACR,YAAY,CAAC,EAAE,MAAM,CAAC;gBACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;gBAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;aACzB,CAAC;SACH,CAAC;QACF,MAAM,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KAC7B,CAAC;IACF,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AASD,QAAA,MAAM,MAAM;;;;CAQX,CAAC;AAEF,iBAAe,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAY5D;AAED,iBAAe,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAuD1F;AAmOD,eAAe,MAAM,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,225 @@
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+const CONFIG_CANDIDATES = [
+    'deploid.config.ts',
+    'deploid.config.js',
+    'deploid.config.mjs',
+    'deploid.config.cjs'
+];
+const plugin = {
+    name: 'doctor',
+    plan: () => [
+        'Inspect project files and Deploid config',
+        'Check required command availability',
+        'Report Android setup and release readiness gaps'
+    ],
+    run: runDoctor
+};
+async function runDoctor(ctx) {
+    const summary = await inspectProject(ctx.cwd, ctx.doctorOptions);
+    if (ctx.doctorOptions?.json) {
+        console.log(JSON.stringify(summary, null, 2));
+    }
+    else {
+        printSummary(ctx, summary);
+    }
+    if (!summary.ok) {
+        process.exitCode = 1;
+    }
+}
+async function inspectProject(cwd, options) {
+    const checks = [];
+    const packageJsonPath = path.join(cwd, 'package.json');
+    const configPath = findExistingPath(cwd, CONFIG_CANDIDATES);
+    const packageJson = readJson(packageJsonPath);
+    const config = configPath ? await loadProjectConfig(configPath) : null;
+    checks.push(fs.existsSync(packageJsonPath)
+        ? pass('package-json', 'package.json', 'Found package.json in project root.')
+        : fail('package-json', 'package.json', 'package.json is missing from the project root.'));
+    checks.push(configPath
+        ? pass('deploid-config', 'Deploid config', `Found ${path.basename(configPath)}.`)
+        : fail('deploid-config', 'Deploid config', 'No Deploid config file was found.'));
+    if (config) {
+        checks.push(checkWebDir(cwd, config.web?.webDir));
+        checks.push(checkAssetsSource(cwd, config.assets?.source));
+        checks.push(checkSigning(cwd, config.android?.signing));
+        checks.push(checkCapacitorConfig(cwd, config.android?.packaging));
+        checks.push(checkAndroidProject(cwd));
+    }
+    else {
+        checks.push(warn('web-output', 'Web output directory', 'Skipped because no Deploid config was loaded.'));
+        checks.push(warn('assets-source', 'Asset source', 'Skipped because no Deploid config was loaded.'));
+        checks.push(warn('android-signing', 'Android signing', 'Skipped because no Deploid config was loaded.'));
+        checks.push(warn('capacitor-config', 'Capacitor config', 'Skipped because no Deploid config was loaded.'));
+        checks.push(warn('android-project', 'Android project', 'Skipped because no Deploid config was loaded.'));
+    }
+    if (!options?.projectOnly) {
+        checks.push(await checkCommand('node', ['--version'], 'Node.js', 'Required to run Deploid.'));
+        checks.push(await checkCommand('npm', ['--version'], 'npm', 'Used by init, plugin setup, and Capacitor workflows.'));
+        checks.push(await checkCommand('npx', ['--version'], 'npx', 'Used to invoke Capacitor CLI commands.'));
+        checks.push(await checkCommand('java', ['-version'], 'Java', 'Required for Android builds.'));
+        checks.push(await checkCommand('adb', ['version'], 'ADB', 'Required for device listing, deploy, and logs.'));
+        checks.push(await checkAndroidSdk());
+        checks.push(checkCapacitorDependency(packageJson));
+    }
+    const totals = {
+        pass: checks.filter((check) => check.status === 'pass').length,
+        warn: checks.filter((check) => check.status === 'warn').length,
+        fail: checks.filter((check) => check.status === 'fail').length
+    };
+    return {
+        ok: totals.fail === 0,
+        cwd,
+        checks,
+        totals
+    };
+}
+function printSummary(ctx, summary) {
+    ctx.logger.info(`doctor: inspecting ${summary.cwd}`);
+    for (const check of summary.checks) {
+        const prefix = check.status === 'pass' ? 'PASS' : check.status === 'warn' ? 'WARN' : 'FAIL';
+        const line = `${prefix} ${check.title}: ${check.message}`;
+        if (check.status === 'pass')
+            ctx.logger.info(line);
+        if (check.status === 'warn')
+            ctx.logger.warn(line);
+        if (check.status === 'fail')
+            ctx.logger.error(line);
+        if (check.details)
+            ctx.logger.info(`      ${check.details}`);
+    }
+    ctx.logger.info(`doctor summary: ${summary.totals.pass} passed, ${summary.totals.warn} warnings, ${summary.totals.fail} failures`);
+}
+async function checkCommand(command, args, title, details) {
+    const result = spawnSync(command, args, { encoding: 'utf8' });
+    if (result.status === 0) {
+        const output = `${result.stdout || ''} ${result.stderr || ''}`.trim().split('\n')[0]?.trim();
+        return pass(command, title, `${command} is available.`, output || details);
+    }
+    return fail(command, title, `${command} is not available.`, result.error?.message || result.stderr?.trim() || details);
+}
+async function checkAndroidSdk() {
+    const envHome = process.env.ANDROID_HOME || process.env.ANDROID_SDK_ROOT;
+    const sdkPath = envHome || path.join(process.env.HOME || '', 'Android', 'Sdk');
+    if (!sdkPath || !fs.existsSync(sdkPath)) {
+        return fail('android-sdk', 'Android SDK', 'Android SDK directory was not found.', 'Set ANDROID_HOME or ANDROID_SDK_ROOT, or install the SDK in ~/Android/Sdk.');
+    }
+    const platformToolsPath = path.join(sdkPath, 'platform-tools');
+    if (!fs.existsSync(platformToolsPath)) {
+        return warn('android-sdk', 'Android SDK', `SDK found at ${sdkPath}, but platform-tools is missing.`, 'Install Android SDK Platform Tools to enable adb-based workflows.');
+    }
+    return pass('android-sdk', 'Android SDK', `SDK found at ${sdkPath}.`);
+}
+function checkCapacitorDependency(packageJson) {
+    if (!packageJson) {
+        return warn('capacitor-dependency', 'Capacitor dependency', 'Skipped because package.json could not be read.');
+    }
+    const deps = {
+        ...(asRecord(packageJson.dependencies)),
+        ...(asRecord(packageJson.devDependencies))
+    };
+    if (typeof deps['@capacitor/core'] === 'string' || typeof deps['@capacitor/cli'] === 'string') {
+        return pass('capacitor-dependency', 'Capacitor dependency', 'Capacitor dependencies are present.');
+    }
+    return warn('capacitor-dependency', 'Capacitor dependency', 'No Capacitor dependency found in package.json.', 'Run `deploid init` or install @capacitor/core and @capacitor/cli if this project targets Android.');
+}
+function checkWebDir(cwd, webDir) {
+    if (!webDir) {
+        return warn('web-output', 'Web output directory', 'No `web.webDir` configured.');
+    }
+    const fullPath = path.join(cwd, webDir);
+    if (fs.existsSync(fullPath)) {
+        return pass('web-output', 'Web output directory', `Found ${webDir}.`);
+    }
+    return warn('web-output', 'Web output directory', `${webDir} does not exist yet.`, 'Run your web build before packaging if you expect a ready-to-sync output directory.');
+}
+function checkAssetsSource(cwd, source) {
+    if (!source) {
+        return warn('assets-source', 'Asset source', 'No `assets.source` configured.');
+    }
+    const sourcePath = path.join(cwd, source);
+    if (fs.existsSync(sourcePath)) {
+        return pass('assets-source', 'Asset source', `Found ${source}.`);
+    }
+    return fail('assets-source', 'Asset source', `${source} does not exist.`, 'Add the source asset or update `assets.source` before running `deploid assets`.');
+}
+function checkSigning(cwd, signing) {
+    if (!signing?.keystorePath) {
+        return warn('android-signing', 'Android signing', 'No Android signing config found.');
+    }
+    const keystorePath = path.join(cwd, signing.keystorePath);
+    const missingEnvVars = [signing.storePasswordEnv, signing.keyPasswordEnv]
+        .filter((name) => Boolean(name))
+        .filter((name) => !process.env[name]);
+    if (!fs.existsSync(keystorePath)) {
+        return fail('android-signing', 'Android signing', `Keystore file is missing: ${signing.keystorePath}.`, 'Create the keystore or fix `android.signing.keystorePath`.');
+    }
+    if (missingEnvVars.length > 0) {
+        return warn('android-signing', 'Android signing', `Keystore found, but env vars are missing: ${missingEnvVars.join(', ')}.`, 'Release builds will fail until those password env vars are exported.');
+    }
+    return pass('android-signing', 'Android signing', 'Signing keystore and env vars look ready.');
+}
+function checkCapacitorConfig(cwd, packaging) {
+    if (packaging !== 'capacitor') {
+        return warn('capacitor-config', 'Capacitor config', `Packaging engine is ${packaging || 'unknown'}.`);
+    }
+    const capacitorConfigPath = path.join(cwd, 'capacitor.config.json');
+    if (fs.existsSync(capacitorConfigPath)) {
+        return pass('capacitor-config', 'Capacitor config', 'Found capacitor.config.json.');
+    }
+    return warn('capacitor-config', 'Capacitor config', 'capacitor.config.json is missing.', 'Run `deploid init` or `deploid package` to scaffold Capacitor configuration.');
+}
+function checkAndroidProject(cwd) {
+    const androidPath = path.join(cwd, 'android');
+    if (fs.existsSync(androidPath)) {
+        return pass('android-project', 'Android project', 'Found android/ project.');
+    }
+    return warn('android-project', 'Android project', 'android/ project has not been generated yet.', 'Run `deploid package` before building or deploying Android artifacts.');
+}
+function pass(id, title, message, details) {
+    return { id, title, status: 'pass', message, details };
+}
+function warn(id, title, message, details) {
+    return { id, title, status: 'warn', message, details };
+}
+function fail(id, title, message, details) {
+    return { id, title, status: 'fail', message, details };
+}
+function findExistingPath(cwd, candidates) {
+    for (const candidate of candidates) {
+        const fullPath = path.join(cwd, candidate);
+        if (fs.existsSync(fullPath))
+            return fullPath;
+    }
+    return null;
+}
+async function loadProjectConfig(configPath) {
+    try {
+        const mod = await import(pathToFileUrl(configPath).href);
+        return (mod.default || mod);
+    }
+    catch {
+        return null;
+    }
+}
+function pathToFileUrl(filePath) {
+    const resolved = path.resolve(filePath);
+    const url = new URL('file://');
+    url.pathname = resolved;
+    return url;
+}
+function readJson(filePath) {
+    try {
+        return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : {};
+}
+export default plugin;
+export { inspectProject, plugin };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@deploid/plugin-doctor",
+  "version": "2.0.0",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -b"
+  }
+}

package/src/index.ts

@@ -0,0 +1,365 @@
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+
+type CheckStatus = 'pass' | 'warn' | 'fail';
+
+interface CheckResult {
+  id: string;
+  title: string;
+  status: CheckStatus;
+  message: string;
+  details?: string;
+}
+
+interface DoctorSummary {
+  ok: boolean;
+  cwd: string;
+  checks: CheckResult[];
+  totals: Record<CheckStatus, number>;
+}
+
+interface DoctorOptions {
+  json?: boolean;
+  projectOnly?: boolean;
+}
+
+interface PipelineContext {
+  logger: {
+    info: (message: string) => void;
+    warn: (message: string) => void;
+    error: (message: string) => void;
+  };
+  config: {
+    appName: string;
+    appId: string;
+    web: { framework: string; buildCommand: string; webDir: string };
+    android: {
+      packaging: string;
+      signing?: {
+        keystorePath?: string;
+        storePasswordEnv?: string;
+        keyPasswordEnv?: string;
+      };
+    };
+    assets?: { source: string };
+  };
+  cwd: string;
+  doctorOptions?: DoctorOptions;
+}
+
+const CONFIG_CANDIDATES = [
+  'deploid.config.ts',
+  'deploid.config.js',
+  'deploid.config.mjs',
+  'deploid.config.cjs'
+];
+
+const plugin = {
+  name: 'doctor',
+  plan: () => [
+    'Inspect project files and Deploid config',
+    'Check required command availability',
+    'Report Android setup and release readiness gaps'
+  ],
+  run: runDoctor
+};
+
+async function runDoctor(ctx: PipelineContext): Promise<void> {
+  const summary = await inspectProject(ctx.cwd, ctx.doctorOptions);
+
+  if (ctx.doctorOptions?.json) {
+    console.log(JSON.stringify(summary, null, 2));
+  } else {
+    printSummary(ctx, summary);
+  }
+
+  if (!summary.ok) {
+    process.exitCode = 1;
+  }
+}
+
+async function inspectProject(cwd: string, options?: DoctorOptions): Promise<DoctorSummary> {
+  const checks: CheckResult[] = [];
+  const packageJsonPath = path.join(cwd, 'package.json');
+  const configPath = findExistingPath(cwd, CONFIG_CANDIDATES);
+  const packageJson = readJson<Record<string, unknown>>(packageJsonPath);
+  const config = configPath ? await loadProjectConfig(configPath) : null;
+
+  checks.push(
+    fs.existsSync(packageJsonPath)
+      ? pass('package-json', 'package.json', 'Found package.json in project root.')
+      : fail('package-json', 'package.json', 'package.json is missing from the project root.')
+  );
+
+  checks.push(
+    configPath
+      ? pass('deploid-config', 'Deploid config', `Found ${path.basename(configPath)}.`)
+      : fail('deploid-config', 'Deploid config', 'No Deploid config file was found.')
+  );
+
+  if (config) {
+    checks.push(checkWebDir(cwd, config.web?.webDir));
+    checks.push(checkAssetsSource(cwd, config.assets?.source));
+    checks.push(checkSigning(cwd, config.android?.signing));
+    checks.push(checkCapacitorConfig(cwd, config.android?.packaging));
+    checks.push(checkAndroidProject(cwd));
+  } else {
+    checks.push(warn('web-output', 'Web output directory', 'Skipped because no Deploid config was loaded.'));
+    checks.push(warn('assets-source', 'Asset source', 'Skipped because no Deploid config was loaded.'));
+    checks.push(warn('android-signing', 'Android signing', 'Skipped because no Deploid config was loaded.'));
+    checks.push(warn('capacitor-config', 'Capacitor config', 'Skipped because no Deploid config was loaded.'));
+    checks.push(warn('android-project', 'Android project', 'Skipped because no Deploid config was loaded.'));
+  }
+
+  if (!options?.projectOnly) {
+    checks.push(await checkCommand('node', ['--version'], 'Node.js', 'Required to run Deploid.'));
+    checks.push(await checkCommand('npm', ['--version'], 'npm', 'Used by init, plugin setup, and Capacitor workflows.'));
+    checks.push(await checkCommand('npx', ['--version'], 'npx', 'Used to invoke Capacitor CLI commands.'));
+    checks.push(await checkCommand('java', ['-version'], 'Java', 'Required for Android builds.'));
+    checks.push(await checkCommand('adb', ['version'], 'ADB', 'Required for device listing, deploy, and logs.'));
+    checks.push(await checkAndroidSdk());
+    checks.push(checkCapacitorDependency(packageJson));
+  }
+
+  const totals = {
+    pass: checks.filter((check) => check.status === 'pass').length,
+    warn: checks.filter((check) => check.status === 'warn').length,
+    fail: checks.filter((check) => check.status === 'fail').length
+  };
+
+  return {
+    ok: totals.fail === 0,
+    cwd,
+    checks,
+    totals
+  };
+}
+
+function printSummary(ctx: PipelineContext, summary: DoctorSummary): void {
+  ctx.logger.info(`doctor: inspecting ${summary.cwd}`);
+
+  for (const check of summary.checks) {
+    const prefix = check.status === 'pass' ? 'PASS' : check.status === 'warn' ? 'WARN' : 'FAIL';
+    const line = `${prefix} ${check.title}: ${check.message}`;
+    if (check.status === 'pass') ctx.logger.info(line);
+    if (check.status === 'warn') ctx.logger.warn(line);
+    if (check.status === 'fail') ctx.logger.error(line);
+    if (check.details) ctx.logger.info(`      ${check.details}`);
+  }
+
+  ctx.logger.info(
+    `doctor summary: ${summary.totals.pass} passed, ${summary.totals.warn} warnings, ${summary.totals.fail} failures`
+  );
+}
+
+async function checkCommand(command: string, args: string[], title: string, details: string): Promise<CheckResult> {
+  const result = spawnSync(command, args, { encoding: 'utf8' });
+  if (result.status === 0) {
+    const output = `${result.stdout || ''} ${result.stderr || ''}`.trim().split('\n')[0]?.trim();
+    return pass(command, title, `${command} is available.`, output || details);
+  }
+
+  return fail(command, title, `${command} is not available.`, result.error?.message || result.stderr?.trim() || details);
+}
+
+async function checkAndroidSdk(): Promise<CheckResult> {
+  const envHome = process.env.ANDROID_HOME || process.env.ANDROID_SDK_ROOT;
+  const sdkPath = envHome || path.join(process.env.HOME || '', 'Android', 'Sdk');
+
+  if (!sdkPath || !fs.existsSync(sdkPath)) {
+    return fail(
+      'android-sdk',
+      'Android SDK',
+      'Android SDK directory was not found.',
+      'Set ANDROID_HOME or ANDROID_SDK_ROOT, or install the SDK in ~/Android/Sdk.'
+    );
+  }
+
+  const platformToolsPath = path.join(sdkPath, 'platform-tools');
+  if (!fs.existsSync(platformToolsPath)) {
+    return warn(
+      'android-sdk',
+      'Android SDK',
+      `SDK found at ${sdkPath}, but platform-tools is missing.`,
+      'Install Android SDK Platform Tools to enable adb-based workflows.'
+    );
+  }
+
+  return pass('android-sdk', 'Android SDK', `SDK found at ${sdkPath}.`);
+}
+
+function checkCapacitorDependency(packageJson: Record<string, unknown> | null): CheckResult {
+  if (!packageJson) {
+    return warn('capacitor-dependency', 'Capacitor dependency', 'Skipped because package.json could not be read.');
+  }
+
+  const deps = {
+    ...(asRecord(packageJson.dependencies)),
+    ...(asRecord(packageJson.devDependencies))
+  };
+
+  if (typeof deps['@capacitor/core'] === 'string' || typeof deps['@capacitor/cli'] === 'string') {
+    return pass('capacitor-dependency', 'Capacitor dependency', 'Capacitor dependencies are present.');
+  }
+
+  return warn(
+    'capacitor-dependency',
+    'Capacitor dependency',
+    'No Capacitor dependency found in package.json.',
+    'Run `deploid init` or install @capacitor/core and @capacitor/cli if this project targets Android.'
+  );
+}
+
+function checkWebDir(cwd: string, webDir: string | undefined): CheckResult {
+  if (!webDir) {
+    return warn('web-output', 'Web output directory', 'No `web.webDir` configured.');
+  }
+
+  const fullPath = path.join(cwd, webDir);
+  if (fs.existsSync(fullPath)) {
+    return pass('web-output', 'Web output directory', `Found ${webDir}.`);
+  }
+
+  return warn(
+    'web-output',
+    'Web output directory',
+    `${webDir} does not exist yet.`,
+    'Run your web build before packaging if you expect a ready-to-sync output directory.'
+  );
+}
+
+function checkAssetsSource(cwd: string, source: string | undefined): CheckResult {
+  if (!source) {
+    return warn('assets-source', 'Asset source', 'No `assets.source` configured.');
+  }
+
+  const sourcePath = path.join(cwd, source);
+  if (fs.existsSync(sourcePath)) {
+    return pass('assets-source', 'Asset source', `Found ${source}.`);
+  }
+
+  return fail(
+    'assets-source',
+    'Asset source',
+    `${source} does not exist.`,
+    'Add the source asset or update `assets.source` before running `deploid assets`.'
+  );
+}
+
+function checkSigning(
+  cwd: string,
+  signing: { keystorePath?: string; storePasswordEnv?: string; keyPasswordEnv?: string } | undefined
+): CheckResult {
+  if (!signing?.keystorePath) {
+    return warn('android-signing', 'Android signing', 'No Android signing config found.');
+  }
+
+  const keystorePath = path.join(cwd, signing.keystorePath);
+  const missingEnvVars = [signing.storePasswordEnv, signing.keyPasswordEnv]
+    .filter((name): name is string => Boolean(name))
+    .filter((name) => !process.env[name]);
+
+  if (!fs.existsSync(keystorePath)) {
+    return fail(
+      'android-signing',
+      'Android signing',
+      `Keystore file is missing: ${signing.keystorePath}.`,
+      'Create the keystore or fix `android.signing.keystorePath`.'
+    );
+  }
+
+  if (missingEnvVars.length > 0) {
+    return warn(
+      'android-signing',
+      'Android signing',
+      `Keystore found, but env vars are missing: ${missingEnvVars.join(', ')}.`,
+      'Release builds will fail until those password env vars are exported.'
+    );
+  }
+
+  return pass('android-signing', 'Android signing', 'Signing keystore and env vars look ready.');
+}
+
+function checkCapacitorConfig(cwd: string, packaging: string | undefined): CheckResult {
+  if (packaging !== 'capacitor') {
+    return warn('capacitor-config', 'Capacitor config', `Packaging engine is ${packaging || 'unknown'}.`);
+  }
+
+  const capacitorConfigPath = path.join(cwd, 'capacitor.config.json');
+  if (fs.existsSync(capacitorConfigPath)) {
+    return pass('capacitor-config', 'Capacitor config', 'Found capacitor.config.json.');
+  }
+
+  return warn(
+    'capacitor-config',
+    'Capacitor config',
+    'capacitor.config.json is missing.',
+    'Run `deploid init` or `deploid package` to scaffold Capacitor configuration.'
+  );
+}
+
+function checkAndroidProject(cwd: string): CheckResult {
+  const androidPath = path.join(cwd, 'android');
+  if (fs.existsSync(androidPath)) {
+    return pass('android-project', 'Android project', 'Found android/ project.');
+  }
+
+  return warn(
+    'android-project',
+    'Android project',
+    'android/ project has not been generated yet.',
+    'Run `deploid package` before building or deploying Android artifacts.'
+  );
+}
+
+function pass(id: string, title: string, message: string, details?: string): CheckResult {
+  return { id, title, status: 'pass', message, details };
+}
+
+function warn(id: string, title: string, message: string, details?: string): CheckResult {
+  return { id, title, status: 'warn', message, details };
+}
+
+function fail(id: string, title: string, message: string, details?: string): CheckResult {
+  return { id, title, status: 'fail', message, details };
+}
+
+function findExistingPath(cwd: string, candidates: string[]): string | null {
+  for (const candidate of candidates) {
+    const fullPath = path.join(cwd, candidate);
+    if (fs.existsSync(fullPath)) return fullPath;
+  }
+  return null;
+}
+
+async function loadProjectConfig(configPath: string): Promise<Record<string, any> | null> {
+  try {
+    const mod = await import(pathToFileUrl(configPath).href);
+    return (mod.default || mod) as Record<string, any>;
+  } catch {
+    return null;
+  }
+}
+
+function pathToFileUrl(filePath: string): URL {
+  const resolved = path.resolve(filePath);
+  const url = new URL('file://');
+  url.pathname = resolved;
+  return url;
+}
+
+function readJson<T>(filePath: string): T | null {
+  try {
+    return JSON.parse(fs.readFileSync(filePath, 'utf8')) as T;
+  } catch {
+    return null;
+  }
+}
+
+function asRecord(value: unknown): Record<string, unknown> {
+  return typeof value === 'object' && value !== null ? (value as Record<string, unknown>) : {};
+}
+
+export default plugin;
+export { inspectProject, plugin };

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src"]
+}

package/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/index.ts"],"version":"5.9.3"}