ly-workflow-codex 0.2.0 → 0.3.0

package/dist/cli.mjs

@@ -4,7 +4,7 @@ import { homedir } from 'node:os';
 import ansis from 'ansis';
 import inquirer from 'inquirer';
 import { join } from 'pathe';
-import { a as i18n, t as AGENTS_SKILLS_DIR, r as readLyConfig, L as LY_PROMPTS_DIR, v as version, P as PACKAGE_NAME, b as initI18n, s as showMainMenu, i as init, l as uninstallWorkflows, B as BIN_NAME } from './shared/ly-workflow-codex.K-E7PMp3.mjs';
+import { a as i18n, q as AGENTS_SKILLS_DIR, r as readLyConfig, L as LY_PROMPTS_DIR, t as readCodexCurrentModel, v as version, P as PACKAGE_NAME, x as sanitizeSpawnableModels, y as sanitizeReasoningEffort, z as sanitizeReviewModel, B as sanitizeModelField, C as sanitizeExecutor, b as initI18n, s as showMainMenu, i as init, l as uninstallWorkflows, D as BIN_NAME } from './shared/ly-workflow-codex.DZD52_5A.mjs';
 import { execFile, spawn, execSync } from 'node:child_process';
 import fs from 'fs-extra';
 import { existsSync } from 'node:fs';
@@ -17,20 +17,28 @@ import 'node:url';
 const DEPENDENT_COMMANDS = ["@lyx-init", "@lyx-explore", "@lyx-propose", "@lyx-review-plan", "@lyx-archive"];
 const INSTALL_CMD = ["npm", "install", "-g", "@fission-ai/openspec@latest"];
 const SHELL_OPT = process.platform === "win32" ? { shell: true } : {};
-const OPENSPEC_SKILL_NAMES = [
-  "openspec-explore",
-  "openspec-propose",
-  "openspec-apply-change",
-  "openspec-archive-change"
-];
-function detectOpenspecSkills() {
-  const roots = [
-    AGENTS_SKILLS_DIR,
-    join(process.cwd(), ".agents", "skills")
+const DEFAULT_WORKFLOWS = ["propose", "explore", "apply", "update", "sync", "archive"];
+const WORKFLOW_TO_SKILL = {
+  explore: "openspec-explore",
+  new: "openspec-new-change",
+  continue: "openspec-continue-change",
+  apply: "openspec-apply-change",
+  update: "openspec-update-change",
+  ff: "openspec-ff-change",
+  sync: "openspec-sync-specs",
+  archive: "openspec-archive-change",
+  "bulk-archive": "openspec-bulk-archive-change",
+  verify: "openspec-verify-change",
+  onboard: "openspec-onboard",
+  propose: "openspec-propose"
+};
+function getOpenspecSkillRoots(cwd = process.cwd()) {
+  return [
+    { scope: "project", path: join(cwd, ".agents", "skills") },
+    { scope: "project", path: join(cwd, ".codex", "skills") },
+    { scope: "global", path: AGENTS_SKILLS_DIR },
+    { scope: "global", path: join(homedir(), ".codex", "skills") }
   ];
-  return OPENSPEC_SKILL_NAMES.some(
-    (name) => roots.some((root) => existsSync(join(root, name, "SKILL.md")))
-  );
 }
 function detectOpenspecCli() {
   return new Promise((resolve) => {
@@ -47,6 +55,126 @@ function detectOpenspecCli() {
     });
   });
 }
+function execFileText(cmd, args, options = {}) {
+  return new Promise((resolve) => {
+    execFile(cmd, args, { timeout: 5e3, ...SHELL_OPT, ...options }, (err, stdout, stderr) => {
+      resolve({
+        ok: !err,
+        stdout: stdout?.toString() ?? "",
+        stderr: stderr?.toString() ?? "",
+        error: err
+      });
+    });
+  });
+}
+function resolveWorkflowDependencies(workflows) {
+  const resolved = [...workflows];
+  if ((resolved.includes("archive") || resolved.includes("bulk-archive")) && !resolved.includes("sync"))
+    resolved.splice(Math.max(resolved.findIndex((w) => w === "archive" || w === "bulk-archive"), 0), 0, "sync");
+  return resolved;
+}
+async function readOpenspecProfile(cwd) {
+  const result = await execFileText("openspec", ["config", "list", "--json"], { cwd });
+  if (!result.ok)
+    return { workflows: DEFAULT_WORKFLOWS, source: "fallback" };
+  try {
+    const parsed = JSON.parse(result.stdout);
+    if (!Array.isArray(parsed.workflows) || parsed.workflows.length === 0)
+      return { workflows: DEFAULT_WORKFLOWS, source: "fallback" };
+    const workflows = parsed.workflows.filter((w) => typeof w === "string" && w.length > 0);
+    return { workflows: resolveWorkflowDependencies(workflows), source: "openspec-config" };
+  } catch {
+    return { workflows: DEFAULT_WORKFLOWS, source: "fallback" };
+  }
+}
+function mapWorkflowsToSkills(workflows) {
+  return [...new Set(workflows.map((w) => WORKFLOW_TO_SKILL[w]).filter((s) => Boolean(s)))];
+}
+function inspectOpenspecSkills(required, cwd, profileSource) {
+  const roots = getOpenspecSkillRoots(cwd);
+  const resolved = {};
+  const projectHits = /* @__PURE__ */ new Set();
+  const missing = [];
+  for (const skill of required) {
+    for (const root of roots) {
+      const skillFile = join(root.path, skill, "SKILL.md");
+      if (existsSync(skillFile)) {
+        resolved[skill] = skillFile;
+        if (root.scope === "project")
+          projectHits.add(skill);
+        break;
+      }
+    }
+    if (!resolved[skill])
+      missing.push(skill);
+  }
+  let status;
+  if (missing.length > 0)
+    status = "missing";
+  else if (profileSource === "fallback")
+    status = "unknown";
+  else if (projectHits.size !== required.length)
+    status = "global-only";
+  else
+    status = "project-ready";
+  return { status, required, resolved, missing, roots, profileSource };
+}
+async function inspectOpenspecRoot(cwd, cli) {
+  if (!cli.installed)
+    return { status: "not-checked" };
+  const result = await execFileText("openspec", ["doctor", "--json"], { cwd });
+  let doctor;
+  try {
+    doctor = result.stdout ? JSON.parse(result.stdout) : void 0;
+  } catch (error) {
+    return { status: "unhealthy", error: error instanceof Error ? error.message : String(error) };
+  }
+  const statuses = doctor?.status ?? [];
+  if (!result.ok) {
+    if (statuses.some((s) => s.code === "no_openspec_root"))
+      return { status: "missing", doctor };
+    return {
+      status: "unhealthy",
+      doctor,
+      error: result.stderr || "openspec doctor --json failed"
+    };
+  }
+  const rootHealthy = doctor?.root?.healthy;
+  return rootHealthy === true ? { status: "healthy", doctor } : { status: "unhealthy", doctor };
+}
+async function inspectOpenspec(options) {
+  const cwd = options?.cwd ?? process.cwd();
+  const cli = await detectOpenspecCli();
+  const cliStatus = !cli.installed ? "missing" : cli.version === "unknown" ? "unhealthy" : "ok";
+  const profile = cli.installed && cliStatus !== "unhealthy" ? await readOpenspecProfile(cwd) : { workflows: DEFAULT_WORKFLOWS, source: "fallback" };
+  const required = mapWorkflowsToSkills(profile.workflows);
+  const skills = inspectOpenspecSkills(required, cwd, profile.source);
+  const root = await inspectOpenspecRoot(cwd, cli);
+  const actions = [];
+  if (cliStatus === "missing")
+    actions.push({ kind: "install-cli" });
+  if (skills.status === "global-only")
+    actions.push({ kind: "warn-global-only" });
+  if (skills.status === "missing") {
+    if (root.status === "missing")
+      actions.push({ kind: "init-root" });
+    else
+      actions.push({ kind: "repair-skills", strategy: "update" });
+  }
+  if (root.status === "missing" && !actions.some((a) => a.kind === "init-root"))
+    actions.push({ kind: "init-root" });
+  if (root.status === "unhealthy")
+    actions.push({ kind: "report-root", doctor: root.doctor });
+  return {
+    cli: { status: cliStatus, version: cli.version },
+    skills,
+    root,
+    actions
+  };
+}
+function isNonInteractive(skipPrompt) {
+  return Boolean(skipPrompt || process.env.CI || !process.stdin.isTTY || !process.stdout.isTTY);
+}
 function printUnavailable() {
   console.log(ansis.yellow(`  ${i18n.t("common:preflight.unavailableList", { list: DEPENDENT_COMMANDS.join(" ") })}`));
   console.log(ansis.gray(`  ${i18n.t("common:preflight.unaffectedNote")}`));
@@ -59,49 +187,118 @@ async function runNpmInstall() {
     child.on("close", (code) => resolve(code === 0));
   });
 }
-function isNonInteractive(skipPrompt) {
-  return Boolean(skipPrompt || process.env.CI || !process.stdin.isTTY || !process.stdout.isTTY);
+async function confirmOpenspecCliInstall(skipPrompt) {
+  if (isNonInteractive(skipPrompt)) {
+    printUnavailable();
+    return false;
+  }
+  const { confirmed } = await inquirer.prompt([{
+    type: "confirm",
+    name: "confirmed",
+    message: i18n.t("common:preflight.installAsk"),
+    default: true
+  }]);
+  if (!confirmed) {
+    printUnavailable();
+    return false;
+  }
+  return true;
 }
-async function checkExternalDeps(options) {
-  try {
-    const cli = await detectOpenspecCli();
-    if (cli.installed) {
-      if (!detectOpenspecSkills()) {
-        console.log(ansis.yellow(`\u26A0 ${i18n.t("common:preflight.skillsMissingCodex")}`));
-      }
-      return;
-    }
+async function installCli() {
+  const ok = await runNpmInstall();
+  if (!ok) {
+    console.error(ansis.red(`\u2717 ${i18n.t("common:preflight.installFailed")}`));
+    printUnavailable();
+    return false;
+  }
+  const recheck = await detectOpenspecCli();
+  if (!recheck.installed) {
+    console.log(ansis.yellow(`\u26A0 ${i18n.t("common:preflight.installNotInPath")}`));
+    return false;
+  }
+  return true;
+}
+function printOpenspecInspection(inspection) {
+  if (inspection.cli.status === "missing") {
     console.log(ansis.yellow(`\u26A0 ${i18n.t("common:preflight.cliMissing")}`));
-    if (isNonInteractive(options?.skipPrompt)) {
-      printUnavailable();
-      return;
-    }
-    const { confirmed } = await inquirer.prompt([{
-      type: "confirm",
-      name: "confirmed",
-      message: i18n.t("common:preflight.installAsk"),
-      default: true
-    }]);
-    if (!confirmed) {
-      printUnavailable();
-      return;
+    printUnavailable();
+    return;
+  }
+  if (inspection.cli.status === "unhealthy") {
+    console.log(ansis.yellow(`\u26A0 ${i18n.t("common:preflight.cliUnhealthy")}`));
+  }
+  if (inspection.skills.status === "global-only") {
+    console.log(ansis.yellow(`\u26A0 ${i18n.t("common:preflight.skillsGlobalOnly")}`));
+  } else if (inspection.skills.status === "missing") {
+    console.log(ansis.yellow(`\u26A0 ${i18n.t("common:preflight.skillsMissing", { list: inspection.skills.missing.join(", ") })}`));
+  } else if (inspection.skills.status === "unknown") {
+    console.log(ansis.yellow(`\u26A0 ${i18n.t("common:preflight.skillsUnknown")}`));
+  }
+  if (inspection.root.status === "missing") {
+    console.log(ansis.yellow(`\u26A0 ${i18n.t("common:preflight.rootMissing")}`));
+  } else if (inspection.root.status === "unhealthy") {
+    console.error(ansis.red(`\u2717 ${i18n.t("common:preflight.rootUnhealthy")}`));
+  }
+}
+async function ensureOpenspec(options) {
+  const cwd = options?.cwd ?? process.cwd();
+  const executed = [];
+  let inspection = await inspectOpenspec({ cwd });
+  if (inspection.cli.status === "missing") {
+    const confirmed = options?.yes || (options?.confirmInstall ? await options.confirmInstall() : false);
+    if (!confirmed)
+      return { inspection, executed };
+    if (await installCli()) {
+      executed.push("install-cli");
+      inspection = await inspectOpenspec({ cwd });
+    } else {
+      return { inspection, executed };
     }
-    const ok = await runNpmInstall();
-    if (!ok) {
-      console.error(ansis.red(`\u2717 ${i18n.t("common:preflight.installFailed")}`));
-      printUnavailable();
-      return;
+  }
+  if (inspection.cli.status !== "ok")
+    return { inspection, executed };
+  if (inspection.root.status === "unhealthy")
+    return { inspection, executed };
+  if (inspection.root.status === "missing") {
+    const initResult = await execFileText("openspec", ["init", "--tools", "codex", "--no-animation"], { cwd });
+    executed.push("init-root");
+    inspection = await inspectOpenspec({ cwd });
+    if (!initResult.ok && inspection.root.status === "missing")
+      return { inspection, executed };
+  }
+  if (inspection.skills.status === "missing") {
+    const updateResult = await execFileText("openspec", ["update", "--force"], { cwd });
+    executed.push("repair-skills:update");
+    inspection = await inspectOpenspec({ cwd });
+    if (inspection.skills.status === "missing") {
+      const initResult = await execFileText("openspec", ["init", "--tools", "codex", "--no-animation"], { cwd });
+      executed.push("repair-skills:init");
+      inspection = await inspectOpenspec({ cwd });
+      if (!updateResult.ok && !initResult.ok && inspection.skills.status === "missing")
+        return { inspection, executed };
     }
-    const recheck = await detectOpenspecCli();
-    if (!recheck.installed) {
-      console.log(ansis.yellow(`\u26A0 ${i18n.t("common:preflight.installNotInPath")}`));
+  }
+  return { inspection, executed };
+}
+async function checkExternalDeps(options) {
+  try {
+    if (options?.initOpenspec) {
+      const result = await ensureOpenspec({
+        yes: options.skipPrompt,
+        confirmInstall: () => confirmOpenspecCliInstall(options.skipPrompt)
+      });
+      printOpenspecInspection(result.inspection);
       return;
     }
-    if (detectOpenspecSkills()) {
-      console.log(ansis.green(`\u2713 ${i18n.t("common:preflight.installSuccessWithSkills")}`));
-    } else {
-      console.log(ansis.green(`\u2713 ${i18n.t("common:preflight.installSuccessNeedInit")}`));
+    let inspection = await inspectOpenspec();
+    if (inspection.cli.status === "missing") {
+      if (!await confirmOpenspecCliInstall(options?.skipPrompt))
+        return;
+      if (!await installCli())
+        return;
+      inspection = await inspectOpenspec();
     }
+    printOpenspecInspection(inspection);
   } catch {
   }
 }
@@ -124,6 +321,113 @@ function execSafe(cmd) {
     return null;
   }
 }
+function buildOpenspecSkillsDetail(status2, missing) {
+  if (status2 === "project-ready")
+    return i18n.t("common:doctor.skillsInitialized");
+  if (status2 === "global-only")
+    return i18n.t("common:doctor.skillsGlobalOnly");
+  if (status2 === "unknown")
+    return i18n.t("common:doctor.skillsUnknown");
+  return i18n.t("common:doctor.skillsMissing", { list: missing.join(", ") || "unknown" });
+}
+function buildOpenspecRootDetail(status2) {
+  if (status2 === "healthy")
+    return i18n.t("common:doctor.rootHealthy");
+  if (status2 === "missing")
+    return i18n.t("common:doctor.rootMissing");
+  if (status2 === "unhealthy")
+    return i18n.t("common:doctor.rootUnhealthy");
+  return i18n.t("common:doctor.rootNotChecked");
+}
+function resolveExecutor(value) {
+  const cleaned = sanitizeExecutor(value);
+  if (cleaned)
+    return { kind: cleaned, invalid: false };
+  const invalid = typeof value === "string" && value.trim() !== "";
+  return { kind: "main", invalid };
+}
+function assessSubagentModelConfig(codexHost) {
+  const spawn = sanitizeSpawnableModels(codexHost?.spawnableModels);
+  const reviewExecutor = resolveExecutor(codexHost?.reviewExecutor);
+  const codingExecutor = resolveExecutor(codexHost?.codingExecutor);
+  const buildField = (input) => {
+    const ineffective = input.executorKind === "main";
+    const hasValue = Boolean(input.value || input.reasoningEffort);
+    return {
+      key: input.key,
+      value: input.value,
+      status: ineffective && hasValue ? "warn" : "ok",
+      okKind: hasValue ? ineffective ? "ineffective" : "configured" : "unset",
+      reasoningEffortKey: input.reasoningEffortKey,
+      reasoningEffort: input.reasoningEffort
+    };
+  };
+  const fields = [
+    buildField({
+      key: "reviewModel",
+      value: sanitizeReviewModel(codexHost?.reviewModel),
+      reasoningEffortKey: "reviewReasoningEffort",
+      reasoningEffort: sanitizeReasoningEffort(codexHost?.reviewReasoningEffort),
+      executorKind: reviewExecutor.kind
+    }),
+    buildField({
+      key: "codingModel",
+      value: sanitizeModelField(codexHost?.codingModel),
+      reasoningEffortKey: "codingReasoningEffort",
+      reasoningEffort: sanitizeReasoningEffort(codexHost?.codingReasoningEffort),
+      executorKind: codingExecutor.kind
+    })
+  ];
+  const executors = [
+    {
+      key: "reviewExecutor",
+      kind: reviewExecutor.kind,
+      invalid: reviewExecutor.invalid,
+      rawValue: typeof codexHost?.reviewExecutor === "string" ? codexHost.reviewExecutor : void 0
+    },
+    {
+      key: "codingExecutor",
+      kind: codingExecutor.kind,
+      invalid: codingExecutor.invalid,
+      rawValue: typeof codexHost?.codingExecutor === "string" ? codexHost.codingExecutor : void 0
+    }
+  ];
+  const raw = codexHost;
+  const removedFields = ["reviewModelB", "reviewReasoningEffortB"].filter((key) => raw?.[key] !== void 0);
+  const spawnWarn = spawn.state === "empty" || spawn.state === "invalid";
+  const fieldWarn = fields.some((f) => f.status === "warn");
+  const executorWarn = executors.some((e) => e.invalid);
+  return {
+    status: spawnWarn || fieldWarn || executorWarn ? "warn" : "ok",
+    executors,
+    fields,
+    spawnState: spawn.state,
+    removedFields
+  };
+}
+function buildSubagentModelCheckDetail(result) {
+  const parts = [];
+  for (const e of result.executors) {
+    parts.push(e.invalid ? i18n.t("doctor:modelConfig.warnInvalidExecutor", { key: e.key, value: e.rawValue ?? "" }) : i18n.t(e.kind === "main" ? "doctor:modelConfig.executorMain" : "doctor:modelConfig.executorSubagent", { key: e.key }));
+  }
+  for (const f of result.fields) {
+    const modelPart = f.value ? f.okKind === "ineffective" ? i18n.t("doctor:modelConfig.warnIneffective", { key: f.key, model: f.value }) : i18n.t("doctor:modelConfig.okConfigured", { key: f.key, model: f.value }) : i18n.t("doctor:modelConfig.okUnset", { key: f.key });
+    const reasoningPart = f.reasoningEffort ? i18n.t("doctor:modelConfig.okReasoningConfigured", { key: f.reasoningEffortKey, effort: f.reasoningEffort }) : i18n.t("doctor:modelConfig.okReasoningUnset", { key: f.reasoningEffortKey });
+    parts.push(modelPart, reasoningPart);
+  }
+  for (const key of result.removedFields)
+    parts.push(i18n.t("doctor:modelConfig.removedNote", { key }));
+  if (result.spawnState === "empty" || result.spawnState === "invalid")
+    parts.push(i18n.t("doctor:modelConfig.warnInvalid"));
+  return parts.join("; ");
+}
+function buildSubagentModelHintLines(currentModel) {
+  const lines = [i18n.t("doctor:modelConfig.agentNeedConfig")];
+  if (currentModel)
+    lines.push(i18n.t("doctor:modelConfig.inheritNote", { model: currentModel }));
+  lines.push(i18n.t("doctor:modelConfig.verifyHint"));
+  return lines;
+}
 async function doctor() {
   const checks = [];
   const nodeVer = process.version;
@@ -137,7 +441,7 @@ async function doctor() {
   checks.push({
     label: "config",
     status: config ? OK : WARN,
-    detail: config ? `v${config.general?.version || "?"}, lang=${config.general?.language || "?"}` : "Not found (~/.ly/config.toml)"
+    detail: config ? `v${config.general?.version || "?"}, lang=${config.general?.language || "?"}` : "Not found (~/.codex/lyx/config.toml)"
   });
   const skillsEntries = await dirFiles(AGENTS_SKILLS_DIR);
   const cmdCount = skillsEntries.filter((f) => f.startsWith("lyx-")).length;
@@ -151,19 +455,30 @@ async function doctor() {
   checks.push({
     label: "Roles",
     status: roleFiles.length >= 2 ? OK : roleFiles.length > 0 ? WARN : FAIL,
-    detail: roleFiles.length > 0 ? roleFiles.join(", ") : "None (~/.ly/prompts/codex/)"
+    detail: roleFiles.length > 0 ? roleFiles.join(", ") : "None (~/.codex/lyx/prompts/codex/)"
   });
-  const openspecCli = await detectOpenspecCli();
+  const openspec = await inspectOpenspec();
   checks.push({
     label: "OpenSpec CLI",
-    status: openspecCli.installed ? OK : WARN,
-    detail: openspecCli.installed ? `v${openspecCli.version}` : i18n.t("common:doctor.openspecCliMissing")
+    status: openspec.cli.status === "ok" ? OK : WARN,
+    detail: openspec.cli.status === "ok" ? `v${openspec.cli.version}` : openspec.cli.status === "unhealthy" ? i18n.t("common:doctor.openspecCliUnhealthy") : i18n.t("common:doctor.openspecCliMissing")
   });
-  const hasOpenspecSkills = detectOpenspecSkills();
   checks.push({
     label: "OpenSpec skills",
-    status: hasOpenspecSkills ? OK : WARN,
-    detail: hasOpenspecSkills ? i18n.t("common:doctor.skillsInitialized") : i18n.t("common:doctor.skillsMissing")
+    status: openspec.skills.status === "project-ready" ? OK : WARN,
+    detail: buildOpenspecSkillsDetail(openspec.skills.status, openspec.skills.missing)
+  });
+  checks.push({
+    label: "OpenSpec root",
+    status: openspec.root.status === "healthy" ? OK : WARN,
+    detail: buildOpenspecRootDetail(openspec.root.status)
+  });
+  const currentModel = await readCodexCurrentModel();
+  const modelCheck = assessSubagentModelConfig(config?.codexHost);
+  checks.push({
+    label: i18n.t("doctor:modelConfig.label"),
+    status: modelCheck.status === "warn" ? WARN : OK,
+    detail: buildSubagentModelCheckDetail(modelCheck)
   });
   console.log();
   console.log(ansis.cyan.bold(`  ly-workflow-codex Doctor v${version}`));
@@ -171,6 +486,8 @@ async function doctor() {
   for (const { label, status: status2, detail } of checks) {
     console.log(`  ${status2} ${ansis.bold(label.padEnd(20))} ${ansis.gray(detail)}`);
   }
+  for (const line of buildSubagentModelHintLines(currentModel))
+    console.log(ansis.gray(`     ${line}`));
   const failures = checks.filter((c) => c.status === FAIL);
   console.log();
   if (failures.length === 0) {
@@ -205,16 +522,16 @@ async function status() {
       }
     }
   }
-  const openspecCli = await detectOpenspecCli();
-  const hasOpenspecSkills = detectOpenspecSkills();
+  const openspec = await inspectOpenspec();
   console.log();
   console.log(ansis.cyan.bold("  ly-workflow-codex Status"));
   console.log();
   console.log(`  ${ansis.bold("Version")}        ${installedVer}${installedVer !== latestVer ? ansis.yellow(` (latest: ${latestVer})`) : ansis.green(" (up to date)")}`);
   console.log(`  ${ansis.bold("Commands")}       ${cmds.length}`);
   console.log(`  ${ansis.bold("Review model")}   ${reviewModel}`);
-  console.log(`  ${ansis.bold("OpenSpec CLI")}   ${openspecCli.installed ? `v${openspecCli.version}` : ansis.yellow(i18n.t("common:doctor.openspecCliMissing"))}`);
-  console.log(`  ${ansis.bold("OpenSpec skills")}${hasOpenspecSkills ? ` ${i18n.t("common:doctor.skillsInitialized")}` : ansis.yellow(` ${i18n.t("common:doctor.skillsMissing")}`)}`);
+  console.log(`  ${ansis.bold("OpenSpec CLI")}   ${openspec.cli.status === "ok" ? `v${openspec.cli.version}` : ansis.yellow(i18n.t(openspec.cli.status === "unhealthy" ? "common:doctor.openspecCliUnhealthy" : "common:doctor.openspecCliMissing"))}`);
+  console.log(`  ${ansis.bold("OpenSpec skills")} ${openspec.skills.status === "project-ready" ? i18n.t("common:doctor.skillsInitialized") : ansis.yellow(buildOpenspecSkillsDetail(openspec.skills.status, openspec.skills.missing))}`);
+  console.log(`  ${ansis.bold("OpenSpec root")}   ${openspec.root.status === "healthy" ? i18n.t("common:doctor.rootHealthy") : ansis.yellow(buildOpenspecRootDetail(openspec.root.status))}`);
   console.log(`  ${ansis.bold("Active tasks")}   ${activeTasks > 0 ? ansis.yellow(String(activeTasks)) : "0"}`);
   console.log();
 }
@@ -231,6 +548,8 @@ function customizeHelp(sections) {
       `  ${ansis.cyan(`${BIN_NAME} init`)} | ${ansis.cyan("i")}     ${i18n.t("cli:help.commandDescriptions.initConfig")}`,
       `  ${ansis.cyan(`${BIN_NAME} doctor`)}       Check installation health`,
       `  ${ansis.cyan(`${BIN_NAME} status`)}       Show installation overview`,
+      `  ${ansis.cyan(`${BIN_NAME} openspec inspect`)}  Inspect OpenSpec dependency state`,
+      `  ${ansis.cyan(`${BIN_NAME} openspec ensure`)}   Ensure OpenSpec CLI/skills/root`,
       `  ${ansis.cyan(`${BIN_NAME} uninstall`)}    Uninstall ${PACKAGE_NAME} (non-interactive)`,
       "",
       ansis.gray(`  ${i18n.t("cli:help.shortcuts")}`),
@@ -284,26 +603,49 @@ async function setupCommands(cli) {
     await checkExternalDeps();
     await showMainMenu();
   });
-  cli.command("init", i18n.t("cli:help.commandDescriptions.initConfig")).alias("i").option("--lang, -l <lang>", `${i18n.t("cli:help.optionDescriptions.displayLanguage")} (zh-CN, en)`).option("--force, -f", i18n.t("cli:help.optionDescriptions.forceOverwrite")).option("--skip-prompt, -s", i18n.t("cli:help.optionDescriptions.skipAllPrompts")).option("--workflows, -w <workflows>", i18n.t("cli:help.optionDescriptions.workflows")).option("--install-dir, -d <path>", i18n.t("cli:help.optionDescriptions.installDir")).action(async (options) => {
+  cli.command("init", i18n.t("cli:help.commandDescriptions.initConfig")).alias("i").option("--lang, -l <lang>", `${i18n.t("cli:help.optionDescriptions.displayLanguage")} (zh-CN, en)`).option("--force, -f", i18n.t("cli:help.optionDescriptions.forceOverwrite")).option("--skip-prompt, -s", i18n.t("cli:help.optionDescriptions.skipAllPrompts")).option("--workflows, -w <workflows>", i18n.t("cli:help.optionDescriptions.workflows")).option("--install-dir, -d <path>", i18n.t("cli:help.optionDescriptions.installDir")).option("--init-openspec", i18n.t("cli:help.optionDescriptions.initOpenspec")).action(async (options) => {
     if (options.lang) {
       await initI18n(options.lang);
     }
-    await checkExternalDeps({ skipPrompt: options.skipPrompt });
+    await checkExternalDeps({ skipPrompt: options.skipPrompt, initOpenspec: options.initOpenspec });
     await init(options);
   });
+  cli.command("openspec <action>", "Inspect or ensure OpenSpec dependencies").option("--json", "Output JSON").option("--yes, -y", "Skip confirmation").action(async (action, options) => {
+    if (action === "inspect") {
+      const result = await inspectOpenspec();
+      if (options.json)
+        console.log(JSON.stringify(result, null, 2));
+      else
+        printOpenspecInspection(result);
+      return;
+    }
+    if (action === "ensure") {
+      const result = await ensureOpenspec({
+        yes: options.yes,
+        confirmInstall: () => confirmOpenspecCliInstall()
+      });
+      if (options.json)
+        console.log(JSON.stringify(result, null, 2));
+      else
+        printOpenspecInspection(result.inspection);
+      return;
+    }
+    console.error(ansis.red(`\u672A\u77E5 openspec \u5B50\u547D\u4EE4: ${action}`));
+    process.exitCode = 1;
+  });
   cli.command("doctor", "Check ly-workflow-codex installation health").action(async () => {
     await doctor();
   });
   cli.command("status", "Show ly-workflow-codex installation status").action(async () => {
     await status();
   });
-  cli.command("uninstall", "Uninstall ly-workflow-codex workflows (~/.agents/skills/lyx-*, ~/.ly/prompts/codex/)").option("--yes, -y", "Skip confirmation").action(async (options) => {
+  cli.command("uninstall", "Uninstall ly-workflow-codex workflows (~/.agents/skills/lyx-*, ~/.codex/lyx/)").option("--yes, -y", "Skip confirmation").action(async (options) => {
     const installDir = join(homedir(), ".codex");
     if (!options.yes) {
       const { confirm } = await inquirer.prompt([{
         type: "confirm",
         name: "confirm",
-        message: `\u786E\u5B9A\u8981\u5378\u8F7D ${PACKAGE_NAME} \u5417\uFF1F\u5C06\u79FB\u9664 ~/.agents/skills/lyx-*\uFF08\u542B\u65E7 ~/.agents/skills/ly-* \u4E0E ~/.codex/prompts/ly-*.md \u6B8B\u7559\uFF09\u4E0E ~/.ly/prompts/codex/\uFF1B\u5171\u4EAB\u914D\u7F6E ~/.ly/config.toml \u4E0E ~/.ly/ \u5176\u4F59\u5185\u5BB9\uFF08\u542B worktrees\uFF09\u4FDD\u7559\u3002`,
+        message: `\u786E\u5B9A\u8981\u5378\u8F7D ${PACKAGE_NAME} \u5417\uFF1F\u5C06\u79FB\u9664 ~/.agents/skills/lyx-*\uFF08\u542B\u65E7 ~/.agents/skills/ly-* \u4E0E ~/.codex/prompts/ly-*.md \u6B8B\u7559\uFF09\u4E0E ~/.codex/lyx/\uFF08\u914D\u7F6E config.toml\u3001\u89D2\u8272\u8BCD prompts/\u3001worktrees\uFF09\uFF1B\u82E5 ~/.codex/lyx/worktrees/ \u4E0B\u5B58\u5728\u672A\u6E05\u7406\u7684\u5B9E\u9645 git worktree\uFF0C\u8BE5\u5B50\u76EE\u5F55\u4F1A\u88AB\u4FDD\u7559\u5E76\u63D0\u793A\u9700\u5148\u624B\u52A8\u6E05\u7406\u3002`,
         default: false
       }]);
       if (!confirm) {
@@ -318,10 +660,8 @@ async function setupCommands(cli) {
         console.log(ansis.gray(`  lyx-* skills: ${result.removedSkills.length} removed`));
       if (result.removedLegacyPrompts.length > 0)
         console.log(ansis.gray(`  Legacy ~/.codex/prompts residue: ${result.removedLegacyPrompts.length} removed`));
-      if (result.removedSharedPrompts)
-        console.log(ansis.gray("  Shared prompts (~/.ly/prompts/codex/): removed"));
-      if (result.configTomlKept)
-        console.log(ansis.gray("  Shared config (~/.ly/config.toml): kept (~/.ly is the ly-workflow shared namespace)"));
+      if (result.removedPrompts)
+        console.log(ansis.gray("  Prompts (~/.codex/lyx/prompts/codex/): removed"));
     } else {
       console.error(ansis.red("\u2717 Uninstall failed"));
       for (const err of result.errors) console.error(ansis.gray(`  ${err}`));