syncorejs 0.2.1 → 0.2.2

package/dist/_vendor/cli/context.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"context.mjs","names":[],"sources":["../src/context.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport path from \"node:path\";\nimport process from \"node:process\";\nimport readline from \"node:readline/promises\";\nimport { CliError, type CliErrorCategory, normalizeCliError } from \"./errors.js\";\n\nexport interface GlobalCliOptions {\n  cwd?: string;\n  json?: boolean;\n  verbose?: boolean;\n  interactive?: boolean;\n  yes?: boolean;\n}\n\nexport interface CliChoice<TValue> {\n  label: string;\n  value: TValue;\n  description?: string;\n}\n\nexport interface CliResult<TValue = unknown> {\n  command?: string;\n  summary?: string;\n  target?: string;\n  data?: TValue;\n  nextSteps?: string[];\n}\n\nexport class CliContext {\n  readonly cwd: string;\n  readonly json: boolean;\n  readonly verbose: boolean;\n  readonly interactive: boolean;\n  readonly yes: boolean;\n\n  constructor(options: GlobalCliOptions = {}) {\n    this.cwd = path.resolve(options.cwd ?? process.cwd());\n    this.json = options.json ?? false;\n    this.verbose = options.verbose ?? false;\n    this.yes = options.yes ?? false;\n    this.interactive =\n      options.interactive === false\n        ? false\n        : process.env.SYNCORE_FORCE_INTERACTIVE === \"1\"\n          ? true\n          : Boolean(process.stdin.isTTY && process.stdout.isTTY && !this.json);\n  }\n\n  info(message: string): void {\n    if (!this.json) {\n      process.stdout.write(`[info] ${message}\\n`);\n    }\n  }\n\n  success(message: string): void {\n    if (!this.json) {\n      process.stdout.write(`[done] ${message}\\n`);\n    }\n  }\n\n  warn(message: string): void {\n    if (!this.json) {\n      process.stderr.write(`[warn] ${message}\\n`);\n    }\n  }\n\n  error(message: string): void {\n    if (!this.json) {\n      process.stderr.write(`[error] ${message}\\n`);\n    }\n  }\n\n  nextStep(message: string): void {\n    if (!this.json) {\n      process.stdout.write(`[next] ${message}\\n`);\n    }\n  }\n\n  printJson(payload: unknown): void {\n    process.stdout.write(`${JSON.stringify(payload, null, 2)}\\n`);\n  }\n\n  printResult<TValue>(result: CliResult<TValue>): void {\n    if (this.json) {\n      this.printJson({\n        ok: true,\n        cwd: this.cwd,\n        ...(result.command ? { command: result.command } : {}),\n        ...(result.target ? { target: result.target } : {}),\n        ...(result.summary ? { summary: result.summary } : {}),\n        ...(result.data !== undefined ? { data: result.data } : {}),\n        ...(result.nextSteps ? { nextSteps: result.nextSteps } : {})\n      });\n      return;\n    }\n\n    if (result.summary) {\n      this.success(result.summary);\n    }\n    if (result.nextSteps) {\n      for (const step of result.nextSteps) {\n        this.nextStep(step);\n      }\n    }\n  }\n\n  fail(\n    message: string,\n    exitCode = 1,\n    details?: unknown,\n    options: {\n      category?: CliErrorCategory;\n      nextSteps?: string[];\n    } = {}\n  ): never {\n    const errorOptions = {\n      exitCode,\n      details,\n      ...(options.category ? { category: options.category } : {}),\n      ...(options.nextSteps ? { nextSteps: options.nextSteps } : {})\n    };\n    throw new CliError(message, errorOptions);\n  }\n\n  handleError(error: unknown): void {\n    const cliError = normalizeCliError(error);\n\n    if (this.json) {\n      this.printJson({\n        ok: false,\n        cwd: this.cwd,\n        error: {\n          category: cliError.category,\n          message: cliError.message,\n          exitCode: cliError.exitCode,\n          ...(cliError.details !== undefined ? { details: cliError.details } : {}),\n          ...(cliError.nextSteps ? { nextSteps: cliError.nextSteps } : {})\n        }\n      });\n    } else {\n      this.error(cliError.message);\n      if (cliError.nextSteps) {\n        for (const step of cliError.nextSteps) {\n          this.nextStep(step);\n        }\n      }\n      if (this.verbose && cliError.details !== undefined) {\n        this.error(JSON.stringify(cliError.details, null, 2));\n      }\n    }\n\n    process.exitCode = cliError.exitCode;\n  }\n\n  async confirm(message: string, defaultValue = true): Promise<boolean> {\n    if (this.yes) {\n      return true;\n    }\n    if (!this.interactive) {\n      return false;\n    }\n\n    const suffix = defaultValue ? \"Y/n\" : \"y/N\";\n    const answer = await this.input(`${message} [${suffix}]`, {\n      defaultValue: defaultValue ? \"y\" : \"n\"\n    });\n    const normalized = answer.trim().toLowerCase();\n    if (normalized.length === 0) {\n      return defaultValue;\n    }\n    return normalized === \"y\" || normalized === \"yes\";\n  }\n\n  async input(\n    message: string,\n    options: {\n      defaultValue?: string;\n      allowEmpty?: boolean;\n    } = {}\n  ): Promise<string> {\n    if (!this.interactive) {\n      this.fail(`Cannot prompt in non-interactive mode: ${message}`);\n    }\n\n    const rl = readline.createInterface({\n      input: process.stdin,\n      output: process.stdout\n    });\n\n    try {\n      const prompt =\n        options.defaultValue !== undefined\n          ? `${message} (${options.defaultValue}): `\n          : `${message}: `;\n      const answer = await rl.question(prompt);\n      if (answer.length === 0 && options.defaultValue !== undefined) {\n        return options.defaultValue;\n      }\n      if (answer.length === 0 && !options.allowEmpty) {\n        this.fail(`A value is required for: ${message}`);\n      }\n      return answer;\n    } finally {\n      rl.close();\n    }\n  }\n\n  async select<TValue>(\n    message: string,\n    choices: CliChoice<TValue>[],\n    defaultValue?: TValue\n  ): Promise<TValue> {\n    if (!this.interactive) {\n      this.fail(`Cannot prompt in non-interactive mode: ${message}`);\n    }\n    if (choices.length === 0) {\n      this.fail(`No choices are available for: ${message}`);\n    }\n\n    this.info(message);\n    choices.forEach((choice, index) => {\n      const suffix = choice.description ? ` - ${choice.description}` : \"\";\n      process.stdout.write(`  ${index + 1}. ${choice.label}${suffix}\\n`);\n    });\n\n    const defaultIndex = defaultValue\n      ? Math.max(\n          choices.findIndex((choice) => choice.value === defaultValue),\n          0\n        )\n      : 0;\n    const rawValue = await this.input(`Choose 1-${choices.length}`, {\n      defaultValue: String(defaultIndex + 1)\n    });\n    const index = Number.parseInt(rawValue, 10);\n    if (Number.isNaN(index) || index < 1 || index > choices.length) {\n      this.fail(`Expected a value between 1 and ${choices.length}.`);\n    }\n    return choices[index - 1]!.value;\n  }\n\n  async withSpinner<TValue>(\n    label: string,\n    action: () => Promise<TValue>\n  ): Promise<TValue> {\n    if (!this.interactive) {\n      this.info(label);\n      return await action();\n    }\n\n    const frames = [\"-\", \"\\\\\", \"|\", \"/\"];\n    let index = 0;\n    process.stderr.write(`[work] ${label}`);\n    const timer = setInterval(() => {\n      process.stderr.write(`\\r[${frames[index % frames.length]}] ${label}`);\n      index += 1;\n    }, 80);\n\n    try {\n      const result = await action();\n      clearInterval(timer);\n      process.stderr.write(`\\r[done] ${label}\\n`);\n      return result;\n    } catch (error) {\n      clearInterval(timer);\n      process.stderr.write(`\\r[fail] ${label}\\n`);\n      throw error;\n    }\n  }\n}\n\nexport async function openTarget(target: string): Promise<boolean> {\n  const command =\n    process.platform === \"win32\"\n      ? {\n          file: \"cmd\",\n          args: [\"/c\", \"start\", \"\", target]\n        }\n      : process.platform === \"darwin\"\n        ? {\n            file: \"open\",\n            args: [target]\n          }\n        : {\n            file: \"xdg-open\",\n            args: [target]\n          };\n\n  return await new Promise((resolve) => {\n    const child = spawn(command.file, command.args, {\n      detached: true,\n      stdio: \"ignore\"\n    });\n    child.once(\"error\", () => resolve(false));\n    child.once(\"spawn\", () => {\n      child.unref();\n      resolve(true);\n    });\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"context.mjs","names":[],"sources":["../src/context.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport path from \"node:path\";\nimport process from \"node:process\";\nimport readline from \"node:readline/promises\";\nimport { CliError, type CliErrorCategory, normalizeCliError } from \"./errors.js\";\n\nconst ANSI = {\n  reset: \"\\u001b[0m\",\n  bold: \"\\u001b[1m\",\n  yellow: \"\\u001b[33m\",\n  cyan: \"\\u001b[36m\",\n  green: \"\\u001b[32m\",\n  red: \"\\u001b[31m\",\n  magenta: \"\\u001b[35m\",\n  dim: \"\\u001b[2m\"\n} as const;\n\nfunction supportsColor(stream: NodeJS.WriteStream): boolean {\n  return Boolean(stream.isTTY) && process.env.NO_COLOR !== \"1\" && process.env.TERM !== \"dumb\";\n}\n\nfunction formatPrefix(\n  stream: NodeJS.WriteStream,\n  level: \"info\" | \"done\" | \"warn\" | \"error\" | \"next\" | \"work\" | \"fail\"\n): string {\n  const plain = `[${level}]`;\n  if (!supportsColor(stream)) {\n    return plain;\n  }\n  const levelColor =\n    level === \"info\"\n      ? ANSI.cyan\n      : level === \"done\"\n        ? ANSI.green\n        : level === \"warn\"\n          ? ANSI.yellow\n          : level === \"error\" || level === \"fail\"\n            ? ANSI.red\n            : level === \"next\"\n              ? ANSI.magenta\n              : ANSI.dim;\n  return `${levelColor}[${level}]${ANSI.reset}`;\n}\n\nexport interface GlobalCliOptions {\n  cwd?: string;\n  json?: boolean;\n  verbose?: boolean;\n  interactive?: boolean;\n  yes?: boolean;\n}\n\nexport interface CliChoice<TValue> {\n  label: string;\n  value: TValue;\n  description?: string;\n}\n\nexport interface CliResult<TValue = unknown> {\n  command?: string;\n  summary?: string;\n  target?: string;\n  data?: TValue;\n  nextSteps?: string[];\n}\n\nexport class CliContext {\n  readonly cwd: string;\n  readonly json: boolean;\n  readonly verbose: boolean;\n  readonly interactive: boolean;\n  readonly yes: boolean;\n\n  constructor(options: GlobalCliOptions = {}) {\n    this.cwd = path.resolve(options.cwd ?? process.cwd());\n    this.json = options.json ?? false;\n    this.verbose = options.verbose ?? false;\n    this.yes = options.yes ?? false;\n    this.interactive =\n      options.interactive === false\n        ? false\n        : process.env.SYNCORE_FORCE_INTERACTIVE === \"1\"\n          ? true\n          : Boolean(process.stdin.isTTY && process.stdout.isTTY && !this.json);\n  }\n\n  info(message: string): void {\n    if (!this.json) {\n      process.stdout.write(`${formatPrefix(process.stdout, \"info\")} ${message}\\n`);\n    }\n  }\n\n  success(message: string): void {\n    if (!this.json) {\n      process.stdout.write(`${formatPrefix(process.stdout, \"done\")} ${message}\\n`);\n    }\n  }\n\n  warn(message: string): void {\n    if (!this.json) {\n      process.stderr.write(`${formatPrefix(process.stderr, \"warn\")} ${message}\\n`);\n    }\n  }\n\n  error(message: string): void {\n    if (!this.json) {\n      process.stderr.write(`${formatPrefix(process.stderr, \"error\")} ${message}\\n`);\n    }\n  }\n\n  nextStep(message: string): void {\n    if (!this.json) {\n      process.stdout.write(`${formatPrefix(process.stdout, \"next\")} ${message}\\n`);\n    }\n  }\n\n  printJson(payload: unknown): void {\n    process.stdout.write(`${JSON.stringify(payload, null, 2)}\\n`);\n  }\n\n  printResult<TValue>(result: CliResult<TValue>): void {\n    if (this.json) {\n      this.printJson({\n        ok: true,\n        cwd: this.cwd,\n        ...(result.command ? { command: result.command } : {}),\n        ...(result.target ? { target: result.target } : {}),\n        ...(result.summary ? { summary: result.summary } : {}),\n        ...(result.data !== undefined ? { data: result.data } : {}),\n        ...(result.nextSteps ? { nextSteps: result.nextSteps } : {})\n      });\n      return;\n    }\n\n    if (result.summary) {\n      this.success(result.summary);\n    }\n    if (result.nextSteps) {\n      for (const step of result.nextSteps) {\n        this.nextStep(step);\n      }\n    }\n  }\n\n  fail(\n    message: string,\n    exitCode = 1,\n    details?: unknown,\n    options: {\n      category?: CliErrorCategory;\n      nextSteps?: string[];\n    } = {}\n  ): never {\n    const errorOptions = {\n      exitCode,\n      details,\n      ...(options.category ? { category: options.category } : {}),\n      ...(options.nextSteps ? { nextSteps: options.nextSteps } : {})\n    };\n    throw new CliError(message, errorOptions);\n  }\n\n  handleError(error: unknown): void {\n    const cliError = normalizeCliError(error);\n\n    if (this.json) {\n      this.printJson({\n        ok: false,\n        cwd: this.cwd,\n        error: {\n          category: cliError.category,\n          message: cliError.message,\n          exitCode: cliError.exitCode,\n          ...(cliError.details !== undefined ? { details: cliError.details } : {}),\n          ...(cliError.nextSteps ? { nextSteps: cliError.nextSteps } : {})\n        }\n      });\n    } else {\n      this.error(cliError.message);\n      if (cliError.nextSteps) {\n        for (const step of cliError.nextSteps) {\n          this.nextStep(step);\n        }\n      }\n      if (this.verbose && cliError.details !== undefined) {\n        this.error(JSON.stringify(cliError.details, null, 2));\n      }\n    }\n\n    process.exitCode = cliError.exitCode;\n  }\n\n  async confirm(message: string, defaultValue = true): Promise<boolean> {\n    if (this.yes) {\n      return true;\n    }\n    if (!this.interactive) {\n      return false;\n    }\n\n    const suffix = defaultValue ? \"Y/n\" : \"y/N\";\n    const answer = await this.input(`${message} [${suffix}]`, {\n      defaultValue: defaultValue ? \"y\" : \"n\"\n    });\n    const normalized = answer.trim().toLowerCase();\n    if (normalized.length === 0) {\n      return defaultValue;\n    }\n    return normalized === \"y\" || normalized === \"yes\";\n  }\n\n  async input(\n    message: string,\n    options: {\n      defaultValue?: string;\n      allowEmpty?: boolean;\n    } = {}\n  ): Promise<string> {\n    if (!this.interactive) {\n      this.fail(`Cannot prompt in non-interactive mode: ${message}`);\n    }\n\n    const rl = readline.createInterface({\n      input: process.stdin,\n      output: process.stdout\n    });\n\n    try {\n      const prompt =\n        options.defaultValue !== undefined\n          ? `${message} (${options.defaultValue}): `\n          : `${message}: `;\n      const answer = await rl.question(prompt);\n      if (answer.length === 0 && options.defaultValue !== undefined) {\n        return options.defaultValue;\n      }\n      if (answer.length === 0 && !options.allowEmpty) {\n        this.fail(`A value is required for: ${message}`);\n      }\n      return answer;\n    } finally {\n      rl.close();\n    }\n  }\n\n  async select<TValue>(\n    message: string,\n    choices: CliChoice<TValue>[],\n    defaultValue?: TValue\n  ): Promise<TValue> {\n    if (!this.interactive) {\n      this.fail(`Cannot prompt in non-interactive mode: ${message}`);\n    }\n    if (choices.length === 0) {\n      this.fail(`No choices are available for: ${message}`);\n    }\n\n    this.info(message);\n    choices.forEach((choice, index) => {\n      const suffix = choice.description ? ` - ${choice.description}` : \"\";\n      process.stdout.write(`  ${index + 1}. ${choice.label}${suffix}\\n`);\n    });\n\n    const defaultIndex = defaultValue\n      ? Math.max(\n          choices.findIndex((choice) => choice.value === defaultValue),\n          0\n        )\n      : 0;\n    const rawValue = await this.input(`Choose 1-${choices.length}`, {\n      defaultValue: String(defaultIndex + 1)\n    });\n    const index = Number.parseInt(rawValue, 10);\n    if (Number.isNaN(index) || index < 1 || index > choices.length) {\n      this.fail(`Expected a value between 1 and ${choices.length}.`);\n    }\n    return choices[index - 1]!.value;\n  }\n\n  async withSpinner<TValue>(\n    label: string,\n    action: () => Promise<TValue>\n  ): Promise<TValue> {\n    if (!this.interactive) {\n      this.info(label);\n      return await action();\n    }\n\n    const frames = [\"-\", \"\\\\\", \"|\", \"/\"];\n    let index = 0;\n    process.stderr.write(`${formatPrefix(process.stderr, \"work\")} ${label}`);\n    const timer = setInterval(() => {\n      process.stderr.write(\n        `\\r${formatPrefix(process.stderr, \"work\")} ${frames[index % frames.length]} ${label}`\n      );\n      index += 1;\n    }, 80);\n\n    try {\n      const result = await action();\n      clearInterval(timer);\n      process.stderr.write(`\\r${formatPrefix(process.stderr, \"done\")} ${label}\\n`);\n      return result;\n    } catch (error) {\n      clearInterval(timer);\n      process.stderr.write(`\\r${formatPrefix(process.stderr, \"fail\")} ${label}\\n`);\n      throw error;\n    }\n  }\n}\n\nexport async function openTarget(target: string): Promise<boolean> {\n  const command =\n    process.platform === \"win32\"\n      ? {\n          file: \"cmd\",\n          args: [\"/c\", \"start\", \"\", target]\n        }\n      : process.platform === \"darwin\"\n        ? {\n            file: \"open\",\n            args: [target]\n          }\n        : {\n            file: \"xdg-open\",\n            args: [target]\n          };\n\n  return await new Promise((resolve) => {\n    const child = spawn(command.file, command.args, {\n      detached: true,\n      stdio: \"ignore\"\n    });\n    child.once(\"error\", () => resolve(false));\n    child.once(\"spawn\", () => {\n      child.unref();\n      resolve(true);\n    });\n  });\n}\n"],"mappings":";;;;;;AAMA,MAAM,OAAO;CACX,OAAO;CACP,MAAM;CACN,QAAQ;CACR,MAAM;CACN,OAAO;CACP,KAAK;CACL,SAAS;CACT,KAAK;CACN;AAED,SAAS,cAAc,QAAqC;AAC1D,QAAO,QAAQ,OAAO,MAAM,IAAI,QAAQ,IAAI,aAAa,OAAO,QAAQ,IAAI,SAAS;;AAGvF,SAAS,aACP,QACA,OACQ;CACR,MAAM,QAAQ,IAAI,MAAM;AACxB,KAAI,CAAC,cAAc,OAAO,CACxB,QAAO;AAcT,QAAO,GAXL,UAAU,SACN,KAAK,OACL,UAAU,SACR,KAAK,QACL,UAAU,SACR,KAAK,SACL,UAAU,WAAW,UAAU,SAC7B,KAAK,MACL,UAAU,SACR,KAAK,UACL,KAAK,IACE,GAAG,MAAM,GAAG,KAAK;;AAyBxC,IAAa,aAAb,MAAwB;CACtB;CACA;CACA;CACA;CACA;CAEA,YAAY,UAA4B,EAAE,EAAE;AAC1C,OAAK,MAAM,KAAK,QAAQ,QAAQ,OAAO,QAAQ,KAAK,CAAC;AACrD,OAAK,OAAO,QAAQ,QAAQ;AAC5B,OAAK,UAAU,QAAQ,WAAW;AAClC,OAAK,MAAM,QAAQ,OAAO;AAC1B,OAAK,cACH,QAAQ,gBAAgB,QACpB,QACA,QAAQ,IAAI,8BAA8B,MACxC,OACA,QAAQ,QAAQ,MAAM,SAAS,QAAQ,OAAO,SAAS,CAAC,KAAK,KAAK;;CAG5E,KAAK,SAAuB;AAC1B,MAAI,CAAC,KAAK,KACR,SAAQ,OAAO,MAAM,GAAG,aAAa,QAAQ,QAAQ,OAAO,CAAC,GAAG,QAAQ,IAAI;;CAIhF,QAAQ,SAAuB;AAC7B,MAAI,CAAC,KAAK,KACR,SAAQ,OAAO,MAAM,GAAG,aAAa,QAAQ,QAAQ,OAAO,CAAC,GAAG,QAAQ,IAAI;;CAIhF,KAAK,SAAuB;AAC1B,MAAI,CAAC,KAAK,KACR,SAAQ,OAAO,MAAM,GAAG,aAAa,QAAQ,QAAQ,OAAO,CAAC,GAAG,QAAQ,IAAI;;CAIhF,MAAM,SAAuB;AAC3B,MAAI,CAAC,KAAK,KACR,SAAQ,OAAO,MAAM,GAAG,aAAa,QAAQ,QAAQ,QAAQ,CAAC,GAAG,QAAQ,IAAI;;CAIjF,SAAS,SAAuB;AAC9B,MAAI,CAAC,KAAK,KACR,SAAQ,OAAO,MAAM,GAAG,aAAa,QAAQ,QAAQ,OAAO,CAAC,GAAG,QAAQ,IAAI;;CAIhF,UAAU,SAAwB;AAChC,UAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,SAAS,MAAM,EAAE,CAAC,IAAI;;CAG/D,YAAoB,QAAiC;AACnD,MAAI,KAAK,MAAM;AACb,QAAK,UAAU;IACb,IAAI;IACJ,KAAK,KAAK;IACV,GAAI,OAAO,UAAU,EAAE,SAAS,OAAO,SAAS,GAAG,EAAE;IACrD,GAAI,OAAO,SAAS,EAAE,QAAQ,OAAO,QAAQ,GAAG,EAAE;IAClD,GAAI,OAAO,UAAU,EAAE,SAAS,OAAO,SAAS,GAAG,EAAE;IACrD,GAAI,OAAO,SAAS,KAAA,IAAY,EAAE,MAAM,OAAO,MAAM,GAAG,EAAE;IAC1D,GAAI,OAAO,YAAY,EAAE,WAAW,OAAO,WAAW,GAAG,EAAE;IAC5D,CAAC;AACF;;AAGF,MAAI,OAAO,QACT,MAAK,QAAQ,OAAO,QAAQ;AAE9B,MAAI,OAAO,UACT,MAAK,MAAM,QAAQ,OAAO,UACxB,MAAK,SAAS,KAAK;;CAKzB,KACE,SACA,WAAW,GACX,SACA,UAGI,EAAE,EACC;AAOP,QAAM,IAAI,SAAS,SANE;GACnB;GACA;GACA,GAAI,QAAQ,WAAW,EAAE,UAAU,QAAQ,UAAU,GAAG,EAAE;GAC1D,GAAI,QAAQ,YAAY,EAAE,WAAW,QAAQ,WAAW,GAAG,EAAE;GAC9D,CACwC;;CAG3C,YAAY,OAAsB;EAChC,MAAM,WAAW,kBAAkB,MAAM;AAEzC,MAAI,KAAK,KACP,MAAK,UAAU;GACb,IAAI;GACJ,KAAK,KAAK;GACV,OAAO;IACL,UAAU,SAAS;IACnB,SAAS,SAAS;IAClB,UAAU,SAAS;IACnB,GAAI,SAAS,YAAY,KAAA,IAAY,EAAE,SAAS,SAAS,SAAS,GAAG,EAAE;IACvE,GAAI,SAAS,YAAY,EAAE,WAAW,SAAS,WAAW,GAAG,EAAE;IAChE;GACF,CAAC;OACG;AACL,QAAK,MAAM,SAAS,QAAQ;AAC5B,OAAI,SAAS,UACX,MAAK,MAAM,QAAQ,SAAS,UAC1B,MAAK,SAAS,KAAK;AAGvB,OAAI,KAAK,WAAW,SAAS,YAAY,KAAA,EACvC,MAAK,MAAM,KAAK,UAAU,SAAS,SAAS,MAAM,EAAE,CAAC;;AAIzD,UAAQ,WAAW,SAAS;;CAG9B,MAAM,QAAQ,SAAiB,eAAe,MAAwB;AACpE,MAAI,KAAK,IACP,QAAO;AAET,MAAI,CAAC,KAAK,YACR,QAAO;EAGT,MAAM,SAAS,eAAe,QAAQ;EAItC,MAAM,cAHS,MAAM,KAAK,MAAM,GAAG,QAAQ,IAAI,OAAO,IAAI,EACxD,cAAc,eAAe,MAAM,KACpC,CAAC,EACwB,MAAM,CAAC,aAAa;AAC9C,MAAI,WAAW,WAAW,EACxB,QAAO;AAET,SAAO,eAAe,OAAO,eAAe;;CAG9C,MAAM,MACJ,SACA,UAGI,EAAE,EACW;AACjB,MAAI,CAAC,KAAK,YACR,MAAK,KAAK,0CAA0C,UAAU;EAGhE,MAAM,KAAK,SAAS,gBAAgB;GAClC,OAAO,QAAQ;GACf,QAAQ,QAAQ;GACjB,CAAC;AAEF,MAAI;GACF,MAAM,SACJ,QAAQ,iBAAiB,KAAA,IACrB,GAAG,QAAQ,IAAI,QAAQ,aAAa,OACpC,GAAG,QAAQ;GACjB,MAAM,SAAS,MAAM,GAAG,SAAS,OAAO;AACxC,OAAI,OAAO,WAAW,KAAK,QAAQ,iBAAiB,KAAA,EAClD,QAAO,QAAQ;AAEjB,OAAI,OAAO,WAAW,KAAK,CAAC,QAAQ,WAClC,MAAK,KAAK,4BAA4B,UAAU;AAElD,UAAO;YACC;AACR,MAAG,OAAO;;;CAId,MAAM,OACJ,SACA,SACA,cACiB;AACjB,MAAI,CAAC,KAAK,YACR,MAAK,KAAK,0CAA0C,UAAU;AAEhE,MAAI,QAAQ,WAAW,EACrB,MAAK,KAAK,iCAAiC,UAAU;AAGvD,OAAK,KAAK,QAAQ;AAClB,UAAQ,SAAS,QAAQ,UAAU;GACjC,MAAM,SAAS,OAAO,cAAc,MAAM,OAAO,gBAAgB;AACjE,WAAQ,OAAO,MAAM,KAAK,QAAQ,EAAE,IAAI,OAAO,QAAQ,OAAO,IAAI;IAClE;EAEF,MAAM,eAAe,eACjB,KAAK,IACH,QAAQ,WAAW,WAAW,OAAO,UAAU,aAAa,EAC5D,EACD,GACD;EACJ,MAAM,WAAW,MAAM,KAAK,MAAM,YAAY,QAAQ,UAAU,EAC9D,cAAc,OAAO,eAAe,EAAE,EACvC,CAAC;EACF,MAAM,QAAQ,OAAO,SAAS,UAAU,GAAG;AAC3C,MAAI,OAAO,MAAM,MAAM,IAAI,QAAQ,KAAK,QAAQ,QAAQ,OACtD,MAAK,KAAK,kCAAkC,QAAQ,OAAO,GAAG;AAEhE,SAAO,QAAQ,QAAQ,GAAI;;CAG7B,MAAM,YACJ,OACA,QACiB;AACjB,MAAI,CAAC,KAAK,aAAa;AACrB,QAAK,KAAK,MAAM;AAChB,UAAO,MAAM,QAAQ;;EAGvB,MAAM,SAAS;GAAC;GAAK;GAAM;GAAK;GAAI;EACpC,IAAI,QAAQ;AACZ,UAAQ,OAAO,MAAM,GAAG,aAAa,QAAQ,QAAQ,OAAO,CAAC,GAAG,QAAQ;EACxE,MAAM,QAAQ,kBAAkB;AAC9B,WAAQ,OAAO,MACb,KAAK,aAAa,QAAQ,QAAQ,OAAO,CAAC,GAAG,OAAO,QAAQ,OAAO,QAAQ,GAAG,QAC/E;AACD,YAAS;KACR,GAAG;AAEN,MAAI;GACF,MAAM,SAAS,MAAM,QAAQ;AAC7B,iBAAc,MAAM;AACpB,WAAQ,OAAO,MAAM,KAAK,aAAa,QAAQ,QAAQ,OAAO,CAAC,GAAG,MAAM,IAAI;AAC5E,UAAO;WACA,OAAO;AACd,iBAAc,MAAM;AACpB,WAAQ,OAAO,MAAM,KAAK,aAAa,QAAQ,QAAQ,OAAO,CAAC,GAAG,MAAM,IAAI;AAC5E,SAAM;;;;AAKZ,eAAsB,WAAW,QAAkC;CACjE,MAAM,UACJ,QAAQ,aAAa,UACjB;EACE,MAAM;EACN,MAAM;GAAC;GAAM;GAAS;GAAI;GAAO;EAClC,GACD,QAAQ,aAAa,WACnB;EACE,MAAM;EACN,MAAM,CAAC,OAAO;EACf,GACD;EACE,MAAM;EACN,MAAM,CAAC,OAAO;EACf;AAET,QAAO,MAAM,IAAI,SAAS,YAAY;EACpC,MAAM,QAAQ,MAAM,QAAQ,MAAM,QAAQ,MAAM;GAC9C,UAAU;GACV,OAAO;GACR,CAAC;AACF,QAAM,KAAK,eAAe,QAAQ,MAAM,CAAC;AACzC,QAAM,KAAK,eAAe;AACxB,SAAM,OAAO;AACb,WAAQ,KAAK;IACb;GACF"}

package/dist/_vendor/cli/doctor.mjs

@@ -1,39 +1,72 @@
-import { findWorkspaceSyncoreProjects, listAvailableTargets, resolveDashboardUrl, resolveDevtoolsUrl, resolveProjectTargetDescriptor } from "./project.mjs";
-import { templateUsesConnectedClients } from "./messages.mjs";
+import { findWorkspaceSyncoreProjects, listConnectedClientTargets, resolveDashboardUrl, resolveDevtoolsUrl, resolveProjectTargetDescriptor } from "./project.mjs";
+import { templateUsesConnectedClients as templateUsesConnectedClients$1 } from "./messages.mjs";
+import { readFile } from "node:fs/promises";
 import path from "node:path";
-import { detectProjectTemplate, fileExists, isLocalPortInUse } from "../core/cli.mjs";
+import { createSchemaSnapshot, diffSchemaSnapshots } from "../core/index.mjs";
+import { detectProjectTemplate, fileExists, formatError, hasSyncoreProject, isLocalPortInUse, loadProjectSchema, readStoredSnapshot, runCodegen, writeStoredSnapshot } from "../core/cli.mjs";
 //#region src/doctor.ts
+const STRUCTURE_CHECKS = [
+	{
+		category: "project",
+		path: "syncore.config.ts"
+	},
+	{
+		category: "schema",
+		path: path.join("syncore", "schema.ts")
+	},
+	{
+		category: "project",
+		path: path.join("syncore", "components.ts"),
+		optional: true
+	},
+	{
+		category: "project",
+		path: path.join("syncore", "functions")
+	},
+	{
+		category: "generated",
+		path: path.join("syncore", "_generated", "api.ts")
+	},
+	{
+		category: "generated",
+		path: path.join("syncore", "_generated", "components.ts")
+	},
+	{
+		category: "generated",
+		path: path.join("syncore", "_generated", "schema.ts")
+	},
+	{
+		category: "generated",
+		path: path.join("syncore", "_generated", "functions.ts")
+	},
+	{
+		category: "generated",
+		path: path.join("syncore", "_generated", "server.ts")
+	},
+	{
+		category: "schema",
+		path: path.join("syncore", "migrations")
+	}
+];
 async function buildDoctorReport(cwd) {
 	const template = await detectProjectTemplate(cwd);
-	const checks = [
-		{
-			category: "project",
-			path: "syncore.config.ts"
-		},
-		{
-			category: "schema",
-			path: path.join("syncore", "schema.ts")
-		},
-		{
-			category: "project",
-			path: path.join("syncore", "functions")
-		},
-		{
-			category: "generated",
-			path: path.join("syncore", "_generated", "functions.ts")
-		},
-		{
-			category: "schema",
-			path: path.join("syncore", "migrations")
-		}
-	];
-	const checkResults = await Promise.all(checks.map(async (entry) => ({
+	const checks = await Promise.all(STRUCTURE_CHECKS.map(async (entry) => ({
 		category: entry.category,
 		path: entry.path.replaceAll("\\", "/"),
-		ok: await fileExists(path.join(cwd, entry.path))
+		ok: await fileExists(path.join(cwd, entry.path)) || "optional" in entry && entry.optional === true
 	})));
-	const projectTarget = await resolveProjectTargetDescriptor(cwd);
-	const targets = await listAvailableTargets(cwd);
+	const hasProject = await hasSyncoreProject(cwd);
+	let projectTarget = null;
+	let persistenceDetails;
+	try {
+		projectTarget = await resolveProjectTargetDescriptor(cwd);
+		if (projectTarget) persistenceDetails = `Database path: ${projectTarget.databasePath}. Storage directory: ${projectTarget.storageDirectory}.`;
+	} catch (error) {
+		persistenceDetails = formatError(error);
+	}
+	const usesConnectedClients = templateUsesConnectedClients$1(template) || !projectTarget && template !== "node";
+	const clientTargets = await listConnectedClientTargets();
+	const targets = [...projectTarget ? [projectTarget] : [], ...clientTargets];
 	const devtoolsUrl = resolveDevtoolsUrl();
 	const dashboardUrl = resolveDashboardUrl();
 	const hubPort = Number.parseInt(new URL(devtoolsUrl).port, 10);
@@ -48,25 +81,50 @@ async function buildDoctorReport(cwd) {
 			dashboard: dashboardPort
 		}
 	};
-	const ready = checkResults.every((entry) => entry.ok);
-	const workspaceMatches = ready ? [] : await findWorkspaceSyncoreProjects(cwd);
-	const clientTargets = targets.filter((target) => target.kind === "client");
-	const status = ready ? !projectTarget && clientTargets.length === 0 ? "waiting-for-client" : "ready" : workspaceMatches.length > 0 ? "workspace-root" : checkResults.some((entry) => entry.ok) ? "incomplete" : "missing";
-	const suggestions = [];
-	if (status === "workspace-root") suggestions.push(`Run the command with --cwd ${workspaceMatches[0].relativePath} or change into a package directory.`);
-	if (status === "missing") suggestions.push("Run `npx syncorejs init` to scaffold a new Syncore project.");
-	if (status === "incomplete") {
-		suggestions.push("Run `npx syncorejs codegen` after restoring missing files.");
-		suggestions.push("Run `npx syncorejs migrate status` to inspect schema state.");
-	}
-	if (!projectTarget && templateUsesConnectedClients(template)) suggestions.push("Use `npx syncorejs dev` and a connected client target for run/data/import/export in this template.");
-	if (status === "waiting-for-client") suggestions.push("Start your app host, then run `npx syncorejs targets` to inspect connected client targets.");
-	if (!hub.running) suggestions.push("Run `npx syncorejs dev` to start the local devtools hub.");
+	const workspaceMatches = hasProject ? [] : await findWorkspaceSyncoreProjects(cwd);
+	const runtimeSignals = await inspectRuntimeSignals(cwd);
+	const drift = (await loadSchemaDrift(cwd, checks))?.drift ?? {
+		state: "unavailable",
+		currentSchemaHash: null,
+		storedSchemaHash: null,
+		statements: [],
+		warnings: [],
+		destructiveChanges: [],
+		details: "Syncore could not inspect schema drift yet."
+	};
+	const diagnostics = buildDiagnostics({
+		checks,
+		drift,
+		hasProject,
+		hub,
+		projectTarget,
+		runtimeSignals,
+		template,
+		usesConnectedClients,
+		clientTargets,
+		...persistenceDetails ? { persistenceDetails } : {}
+	});
+	const primaryIssue = resolvePrimaryIssue({
+		checks,
+		diagnostics,
+		drift,
+		hasProject,
+		hubRunning: hub.running,
+		usesConnectedClients,
+		clientTargets,
+		workspaceMatches
+	});
+	const suggestions = collectSuggestions(primaryIssue, diagnostics, workspaceMatches);
 	return {
 		cwd,
 		template,
-		status,
-		checks: checkResults,
+		status: primaryIssue.code,
+		primaryIssue,
+		diagnostics,
+		autoFixesAvailable: diagnostics.some((diagnostic) => diagnostic.canAutoFix && diagnostic.status !== "pass"),
+		drift,
+		runtimeSignals,
+		checks,
 		workspaceMatches,
 		suggestions,
 		projectTarget,
@@ -74,7 +132,416 @@ async function buildDoctorReport(cwd) {
 		hub
 	};
 }
+async function applyDoctorFixes(cwd, report) {
+	const appliedFixes = [];
+	const currentReport = report ?? await buildDoctorReport(cwd);
+	const missingGenerated = currentReport.checks.some((check) => check.category === "generated" && !check.ok);
+	if (missingGenerated) {
+		await runCodegen(cwd);
+		appliedFixes.push("Regenerated syncore/_generated/*.");
+	}
+	const refreshedReport = missingGenerated || !report ? await buildDoctorReport(cwd) : currentReport;
+	if (refreshedReport.drift.state === "missing-snapshot" || refreshedReport.drift.state === "snapshot-outdated" || refreshedReport.drift.state === "migration-pending") {
+		if (await fileExists(path.join(cwd, "syncore", "_generated", "schema.ts"))) {
+			await writeStoredSnapshot(cwd, createSchemaSnapshot(await loadProjectSchema(cwd)));
+			appliedFixes.push("Refreshed the stored schema snapshot.");
+		}
+	}
+	return appliedFixes;
+}
+async function inspectRuntimeSignals(cwd) {
+	const session = await inspectDevtoolsSession(cwd);
+	const logFilePath = path.join(cwd, ".syncore", "logs", "runtime.jsonl");
+	if (!await fileExists(logFilePath)) return {
+		logFilePath,
+		logFilePresent: false,
+		logEntryCount: 0,
+		recent: [],
+		sessionState: session.state,
+		sessionPath: session.path
+	};
+	try {
+		const entries = (await readFile(logFilePath, "utf8")).split(/\r?\n/).map((line) => line.trim()).filter(Boolean).map((line) => JSON.parse(line)).filter((entry) => entry.version === 2);
+		return {
+			logFilePath,
+			logFilePresent: true,
+			logEntryCount: entries.length,
+			recent: entries.slice(-5).map((entry) => ({
+				timestamp: entry.timestamp,
+				category: entry.category,
+				message: entry.message,
+				targetId: entry.targetId ?? "unknown",
+				...entry.runtimeLabel ? { runtimeLabel: entry.runtimeLabel } : {}
+			})),
+			sessionState: session.state,
+			sessionPath: session.path
+		};
+	} catch (error) {
+		return {
+			logFilePath,
+			logFilePresent: true,
+			logEntryCount: 0,
+			recent: [{
+				timestamp: Date.now(),
+				category: "system",
+				message: `Unable to read runtime log history: ${formatError(error)}`,
+				targetId: "system"
+			}],
+			sessionState: session.state,
+			sessionPath: session.path
+		};
+	}
+}
+async function inspectDevtoolsSession(cwd) {
+	const sessionPath = path.join(cwd, ".syncore", "devtools-session.json");
+	if (!await fileExists(sessionPath)) return {
+		state: "missing",
+		path: sessionPath
+	};
+	try {
+		const source = await readFile(sessionPath, "utf8");
+		const parsed = JSON.parse(source);
+		return {
+			state: typeof parsed.dashboardUrl === "string" && typeof parsed.authenticatedDashboardUrl === "string" && typeof parsed.devtoolsUrl === "string" && typeof parsed.token === "string" ? "present" : "invalid",
+			path: sessionPath
+		};
+	} catch {
+		return {
+			state: "invalid",
+			path: sessionPath
+		};
+	}
+}
+async function loadSchemaDrift(cwd, checks) {
+	if (!checks.some((check) => check.path === "syncore/_generated/schema.ts" && check.ok)) return null;
+	try {
+		const currentSnapshot = createSchemaSnapshot(await loadProjectSchema(cwd));
+		const storedSnapshot = await readStoredSnapshot(cwd);
+		const plan = diffSchemaSnapshots(storedSnapshot, currentSnapshot);
+		const state = plan.destructiveChanges.length > 0 ? "destructive" : !storedSnapshot ? "missing-snapshot" : storedSnapshot.hash !== currentSnapshot.hash && plan.statements.length > 0 ? "migration-pending" : storedSnapshot.hash !== currentSnapshot.hash ? "snapshot-outdated" : "clean";
+		return {
+			currentSnapshot,
+			storedSnapshot,
+			drift: {
+				state,
+				currentSchemaHash: currentSnapshot.hash,
+				storedSchemaHash: storedSnapshot?.hash ?? null,
+				statements: plan.statements,
+				warnings: plan.warnings,
+				destructiveChanges: plan.destructiveChanges,
+				details: state === "clean" ? "Local schema snapshot matches the generated Syncore schema." : describeDriftState(state, plan.statements.length, plan.warnings.length)
+			}
+		};
+	} catch (error) {
+		return {
+			currentSnapshot: null,
+			storedSnapshot: null,
+			drift: {
+				state: "unavailable",
+				currentSchemaHash: null,
+				storedSchemaHash: null,
+				statements: [],
+				warnings: [],
+				destructiveChanges: [],
+				details: `Syncore could not load the generated schema: ${formatError(error)}`
+			}
+		};
+	}
+}
+function describeDriftState(state, statementCount, warningCount) {
+	if (state === "missing-snapshot") return "No stored schema snapshot was found yet.";
+	if (state === "migration-pending") return `Schema drift detected with ${statementCount} SQL statement(s) pending and ${warningCount} warning(s).`;
+	if (state === "snapshot-outdated") return "The stored schema snapshot differs from the generated schema, but no SQL statements are pending.";
+	if (state === "destructive") return "The current schema diff includes destructive changes that require manual review.";
+	return "Syncore could not inspect schema drift.";
+}
+function buildDiagnostics(input) {
+	const diagnostics = [];
+	const missingProjectPaths = input.checks.filter((check) => (check.category === "project" || check.category === "schema") && !check.ok);
+	diagnostics.push(missingProjectPaths.length === 0 && input.hasProject ? {
+		id: "project.structure",
+		category: "project",
+		severity: "info",
+		status: "pass",
+		summary: "Syncore project structure is present.",
+		details: "Core project files are available in this directory.",
+		canAutoFix: false
+	} : {
+		id: "project.structure",
+		category: "project",
+		severity: "error",
+		status: "fail",
+		summary: "Syncore project structure is incomplete or missing.",
+		details: missingProjectPaths.length > 0 ? `Missing: ${missingProjectPaths.map((check) => check.path).join(", ")}.` : "This directory does not contain a full Syncore project yet.",
+		suggestedAction: "Run `npx syncorejs init` or restore the missing project files.",
+		canAutoFix: false
+	});
+	const missingGenerated = input.checks.filter((check) => check.category === "generated" && !check.ok);
+	diagnostics.push(missingGenerated.length === 0 ? {
+		id: "generated.files",
+		category: "generated",
+		severity: "info",
+		status: "pass",
+		summary: "Generated Syncore files are present.",
+		details: "syncore/_generated looks available for runtime and type-driven tooling.",
+		canAutoFix: false
+	} : {
+		id: "generated.files",
+		category: "generated",
+		severity: "error",
+		status: "fail",
+		summary: "Generated Syncore files are missing.",
+		details: `Missing: ${missingGenerated.map((check) => check.path).join(", ")}.`,
+		suggestedAction: "Run `npx syncorejs codegen` or `npx syncorejs doctor --fix`.",
+		canAutoFix: true,
+		fixCommand: "npx syncorejs doctor --fix"
+	});
+	diagnostics.push(buildSchemaDiagnostic(input.drift));
+	diagnostics.push(input.projectTarget ? {
+		id: "persistence.project-target",
+		category: "persistence",
+		severity: "info",
+		status: "pass",
+		summary: "Project target persistence is configured.",
+		...input.persistenceDetails ? { details: input.persistenceDetails } : {},
+		canAutoFix: false
+	} : input.usesConnectedClients ? {
+		id: "persistence.project-target",
+		category: "persistence",
+		severity: "info",
+		status: "pass",
+		summary: "Persistence is client-managed for this template.",
+		details: "This app template expects a connected client runtime to provide local storage and runtime state.",
+		canAutoFix: false
+	} : {
+		id: "persistence.project-target",
+		category: "persistence",
+		severity: "error",
+		status: "fail",
+		summary: "No local project target is configured.",
+		details: input.persistenceDetails ?? "Syncore could not resolve a project target database and storage directory.",
+		suggestedAction: "Check syncore.config.ts and make sure projectTarget.databasePath and projectTarget.storageDirectory are valid.",
+		canAutoFix: false
+	});
+	diagnostics.push(input.hub.running ? {
+		id: "hub.devtools",
+		category: "hub",
+		severity: "info",
+		status: "pass",
+		summary: "Local devtools hub is running.",
+		details: `Devtools: ${input.hub.url}. Dashboard: ${input.hub.dashboardUrl}.`,
+		canAutoFix: false
+	} : {
+		id: "hub.devtools",
+		category: "hub",
+		severity: "warning",
+		status: "warn",
+		summary: "Local devtools hub is not running.",
+		details: `Expected devtools endpoint: ${input.hub.url}.`,
+		suggestedAction: "Run `npx syncorejs dev` to start the local hub and dashboard.",
+		canAutoFix: false
+	});
+	diagnostics.push(input.hub.dashboardRunning ? {
+		id: "hub.dashboard",
+		category: "hub",
+		severity: "info",
+		status: "pass",
+		summary: "Dashboard shell is responding.",
+		details: input.hub.dashboardUrl,
+		canAutoFix: false
+	} : {
+		id: "hub.dashboard",
+		category: "hub",
+		severity: "warning",
+		status: "warn",
+		summary: "Dashboard shell is not responding yet.",
+		details: `Expected dashboard URL: ${input.hub.dashboardUrl}.`,
+		suggestedAction: "Run `npx syncorejs dev` or inspect whether the dashboard port is already taken.",
+		canAutoFix: false
+	});
+	diagnostics.push(input.usesConnectedClients ? input.clientTargets.length > 0 ? {
+		id: "client.runtime",
+		category: "client",
+		severity: "info",
+		status: "pass",
+		summary: "At least one client runtime is connected.",
+		details: `Connected targets: ${input.clientTargets.map((target) => target.id).join(", ")}.`,
+		canAutoFix: false
+	} : {
+		id: "client.runtime",
+		category: "client",
+		severity: "warning",
+		status: "warn",
+		summary: "This template is waiting for a connected client runtime.",
+		details: "Syncore is ready to inspect or operate on your app once a browser tab, worker, Electron shell, or Expo runtime connects.",
+		suggestedAction: "Start your app host, then run `npx syncorejs targets` to inspect connected client targets.",
+		canAutoFix: false
+	} : {
+		id: "client.runtime",
+		category: "client",
+		severity: "info",
+		status: "pass",
+		summary: "This template does not require a connected client runtime.",
+		canAutoFix: false
+	});
+	diagnostics.push(buildRuntimeDiagnostic(input.runtimeSignals));
+	return diagnostics;
+}
+function buildSchemaDiagnostic(drift) {
+	if (drift.state === "clean") return {
+		id: "schema.drift",
+		category: "schema",
+		severity: "info",
+		status: "pass",
+		summary: "Schema snapshot is in sync.",
+		...drift.details ? { details: drift.details } : {},
+		canAutoFix: false
+	};
+	if (drift.state === "destructive") return {
+		id: "schema.drift",
+		category: "schema",
+		severity: "error",
+		status: "fail",
+		summary: "Schema drift includes destructive changes.",
+		details: drift.destructiveChanges.join("; "),
+		suggestedAction: "Review the schema change manually and create or edit a migration before continuing.",
+		canAutoFix: false
+	};
+	if (drift.state === "missing-snapshot") return {
+		id: "schema.drift",
+		category: "schema",
+		severity: "warning",
+		status: "warn",
+		summary: "No stored schema snapshot was found.",
+		...drift.details ? { details: drift.details } : {},
+		suggestedAction: "Run `npx syncorejs doctor --fix` to refresh the snapshot, or generate a migration if you intend to persist the change.",
+		canAutoFix: true,
+		fixCommand: "npx syncorejs doctor --fix"
+	};
+	if (drift.state === "snapshot-outdated" || drift.state === "migration-pending") return {
+		id: "schema.drift",
+		category: "schema",
+		severity: "warning",
+		status: "warn",
+		summary: drift.state === "migration-pending" ? "Schema drift has pending migration statements." : "Stored schema snapshot differs from the generated schema.",
+		...drift.details ? { details: drift.details } : {},
+		suggestedAction: drift.state === "migration-pending" ? "Run `npx syncorejs migrate status` to inspect the diff, then `npx syncorejs doctor --fix` only if you just want to refresh the stored snapshot." : "Run `npx syncorejs doctor --fix` to refresh the stored snapshot safely.",
+		canAutoFix: true,
+		fixCommand: "npx syncorejs doctor --fix"
+	};
+	return {
+		id: "schema.drift",
+		category: "schema",
+		severity: "warning",
+		status: "warn",
+		summary: "Schema drift could not be inspected yet.",
+		...drift.details ? { details: drift.details } : {},
+		suggestedAction: "Restore generated files or rerun `npx syncorejs codegen`, then run `npx syncorejs doctor` again.",
+		canAutoFix: false
+	};
+}
+function buildRuntimeDiagnostic(runtimeSignals) {
+	if (runtimeSignals.sessionState === "invalid") return {
+		id: "runtime.session",
+		category: "runtime",
+		severity: "warning",
+		status: "warn",
+		summary: "The saved devtools session file is invalid.",
+		details: runtimeSignals.sessionPath,
+		suggestedAction: "Restart `npx syncorejs dev` to regenerate the session state for the local hub.",
+		canAutoFix: false
+	};
+	if (runtimeSignals.logEntryCount === 0) return {
+		id: "runtime.signals",
+		category: "runtime",
+		severity: "info",
+		status: "pass",
+		summary: "No recent runtime signals were recorded yet.",
+		details: runtimeSignals.logFilePresent ? "The runtime log file exists but has no recorded entries yet." : "No runtime log file has been created yet.",
+		canAutoFix: false
+	};
+	const latest = runtimeSignals.recent[runtimeSignals.recent.length - 1];
+	return {
+		id: "runtime.signals",
+		category: "runtime",
+		severity: "info",
+		status: "pass",
+		summary: "Recent runtime signals are available.",
+		...latest ? { details: `Latest: ${latest.category} on ${latest.targetId} at ${new Date(latest.timestamp).toISOString()}: ${latest.message}` } : {},
+		canAutoFix: false
+	};
+}
+function resolvePrimaryIssue(input) {
+	if (!input.hasProject && input.workspaceMatches.length > 0) return {
+		code: "workspace-root",
+		summary: "You are at a workspace root, not inside a Syncore app package.",
+		details: `Found ${input.workspaceMatches.length} Syncore package(s) under this workspace.`,
+		impact: "Project-specific diagnostics and runtime operations are ambiguous from the workspace root.",
+		suggestedAction: `Run the command with --cwd ${input.workspaceMatches[0].relativePath} or change into that package directory.`
+	};
+	const missingProjectPaths = input.checks.filter((check) => (check.category === "project" || check.category === "schema") && !check.ok);
+	if (!input.hasProject || missingProjectPaths.length > 0) return {
+		code: "missing-project",
+		summary: "Syncore project files are missing or incomplete.",
+		details: missingProjectPaths.length > 0 ? `Missing: ${missingProjectPaths.map((check) => check.path).join(", ")}.` : "This directory does not contain a complete Syncore project yet.",
+		impact: "The CLI cannot bootstrap the local runtime or inspect schema and persistence reliably.",
+		suggestedAction: "Run `npx syncorejs init` or restore the missing project files."
+	};
+	const missingGenerated = input.checks.filter((check) => check.category === "generated" && !check.ok);
+	if (missingGenerated.length > 0) return {
+		code: "missing-generated",
+		summary: "Generated Syncore files are missing.",
+		details: `Missing: ${missingGenerated.map((check) => check.path).join(", ")}.`,
+		impact: "Type-driven runtime loading and schema inspection may be stale or unavailable.",
+		suggestedAction: "Run `npx syncorejs doctor --fix` or `npx syncorejs codegen`."
+	};
+	if (input.drift.state === "destructive") return {
+		code: "schema-destructive-drift",
+		summary: "Schema drift is blocked by destructive changes.",
+		details: input.drift.destructiveChanges.join("; "),
+		impact: "Syncore cannot safely advance the local schema automatically.",
+		suggestedAction: "Review the schema change manually and generate a migration before continuing."
+	};
+	if (input.usesConnectedClients && input.clientTargets.length === 0) return {
+		code: "waiting-for-client",
+		summary: "This app is waiting for a connected local runtime.",
+		details: input.hubRunning ? "Client-managed templates only become fully operational after the app host connects to the local Syncore hub." : "This template depends on a client-managed runtime, and no app runtime is connected yet.",
+		impact: "Worker, bridge IPC, storage, and client-side data inspection stay unavailable until a runtime connects.",
+		suggestedAction: input.hubRunning ? "Start your app host, then run `npx syncorejs targets` to inspect connected runtimes." : "Run `npx syncorejs dev`, start your app host, then run `npx syncorejs targets` to inspect connected runtimes."
+	};
+	if (input.drift.state === "missing-snapshot" || input.drift.state === "snapshot-outdated" || input.drift.state === "migration-pending") return {
+		code: "schema-drift",
+		summary: "The local schema snapshot is out of sync.",
+		details: input.drift.details ?? "Schema drift was detected.",
+		impact: "The local dev loop can become confusing because the stored snapshot no longer matches the generated schema.",
+		suggestedAction: input.drift.state === "migration-pending" ? "Run `npx syncorejs migrate status` to inspect the diff, then use `npx syncorejs doctor --fix` if you only need to refresh the stored snapshot." : "Run `npx syncorejs doctor --fix` to refresh the stored snapshot safely."
+	};
+	if (!input.hubRunning) return {
+		code: "hub-down",
+		summary: "The local devtools hub is not running.",
+		details: "Syncore can inspect project state, but runtime and client diagnostics are limited until the hub starts.",
+		impact: "Commands that depend on live targets, logs, or IPC visibility will have reduced signal.",
+		suggestedAction: "Run `npx syncorejs dev` to start the local hub."
+	};
+	return {
+		code: "ready",
+		summary: "Syncore is ready for the local development loop.",
+		details: "Project structure, generated files, schema state, and runtime prerequisites look healthy.",
+		impact: "You can use `syncorejs dev`, inspect targets, and operate on the local runtime.",
+		suggestedAction: "Run `npx syncorejs dev` to keep codegen, schema, and the local hub in sync."
+	};
+}
+function collectSuggestions(primaryIssue, diagnostics, workspaceMatches) {
+	const suggestions = /* @__PURE__ */ new Set();
+	if (primaryIssue.suggestedAction) suggestions.add(primaryIssue.suggestedAction);
+	if (primaryIssue.code === "workspace-root" && workspaceMatches.length > 0) suggestions.add(`Run the command with --cwd ${workspaceMatches[0].relativePath} or change into a package directory.`);
+	for (const diagnostic of diagnostics) {
+		if (diagnostic.status === "pass") continue;
+		if (diagnostic.suggestedAction) suggestions.add(diagnostic.suggestedAction);
+	}
+	return [...suggestions];
+}
 //#endregion
-export { buildDoctorReport };
+export { applyDoctorFixes, buildDoctorReport };
 
 //# sourceMappingURL=doctor.mjs.map