agent-conveyor 0.1.25 → 0.1.26

package/README.md

@@ -122,7 +122,10 @@ PATH="$tmp_prefix/bin:$PATH" conveyor --help
 PATH="$tmp_prefix/bin:$PATH" workerctl --help
 ```
 
-`conveyor doctor` reports local dependency health (tmux, codex, etc.).
+`conveyor doctor --json` reports local dependency health (tmux, codex, etc.),
+package/bin resolution, Codex home, installed operator plugin version, installed
+operator skills, and an `operator_ready` summary for Codex app manager/worker
+setup.
 `conveyor db-doctor` initializes and checks the SQLite control-plane
 database.
 On Node versions where `node:sqlite` is still marked experimental, SQLite
@@ -151,6 +154,13 @@ static landing page. From the repo, `npm run docs:landing` serves it at
 `http://127.0.0.1:8765/`.
 The GitHub Pages version lives at
 [`neonwatty.github.io/agent-conveyor`](https://neonwatty.github.io/agent-conveyor/).
+Pages deploys from the protected `landing-page` branch through the
+`Pages` GitHub Actions workflow; propose public landing-page edits against
+that branch rather than relying on ordinary `main` package PRs to publish the
+site.
+Pull requests into `landing-page` run the `Landing Page PR` workflow, which
+checks linting, unused exports/files, tests, build output, the landing-page
+screenshot gate, and a diff-scoped max-lines guard for changed text files.
 Use `node scripts/check-landing-page.mjs` for a docs-only desktop/mobile
 screenshot gate; this does not run the full package release smoke.
 
@@ -163,7 +173,7 @@ and inspect the plugin:
 ```bash
 npm install -g agent-conveyor
 conveyor install-plugin
-conveyor plugin-status
+conveyor doctor --json
 ```
 
 The per-project default ledger for operator sessions is

package/dist/cli/typescript-runtime.js

@@ -1130,7 +1130,7 @@ function parseRuntimeArgs(args, env) {
             index += 1;
         }
         else if (arg === "--codex-home") {
-            if (command !== "install-skills" && command !== "install-plugin" && command !== "plugin-status" && command !== "plugin-path") {
+            if (command !== "install-skills" && command !== "install-plugin" && command !== "plugin-status" && command !== "plugin-path" && command !== "doctor") {
                 return { command, enabled, error: "Unsupported TypeScript runtime option: --codex-home", explicit, flags, task };
             }
             const value = valueAfter(queue, index, arg);
@@ -11952,9 +11952,20 @@ function runDoctorCommand(parsed, options) {
     const root = stateRoot({ cwd: targetCwd, env: options.env });
     const tmuxPath = commandPath("tmux", options);
     const codexPath = options.codexCommandResolver?.("codex") ?? commandPath("codex", options);
+    const conveyorPath = commandPath("conveyor", options);
+    const workerctlPath = commandPath("workerctl", options);
+    const packageRoot = packageRootFromRuntimeModule();
+    const packageVersion = packageVersionFromRoot(packageRoot);
+    const plugin = agentConveyorPluginStatus(parsed, options);
+    const pluginSkillsInstalled = plugin.skills.every((skill) => skill.installed);
     const checks = [
         { name: "tmux", ok: Boolean(tmuxPath), path: tmuxPath },
         { name: "codex", ok: Boolean(codexPath), path: codexPath },
+        { name: "conveyor_on_path", ok: Boolean(conveyorPath), path: conveyorPath },
+        { name: "workerctl_on_path", ok: Boolean(workerctlPath), path: workerctlPath },
+        { name: "plugin_installed", ok: plugin.installed, installed_version: plugin.installed_version },
+        { name: "plugin_version_matches", ok: plugin.version_matches, package_version: packageVersion, plugin_version: plugin.plugin_version },
+        { name: "plugin_skills_installed", ok: pluginSkillsInstalled, missing: plugin.skills.filter((skill) => !skill.installed).map((skill) => skill.name) },
     ];
     if (tmuxPath) {
         const proc = runProcess(["tmux", "-V"], options);
@@ -11966,8 +11977,44 @@ function runDoctorCommand(parsed, options) {
     }
     checks.push({ name: "target_cwd_exists", ok: pathIsDirectory(targetCwd), path: targetCwd });
     checks.push({ name: "state_root_exists", ok: existsSync(root), path: root });
-    const ok = checks.every((check) => check.name === "state_root_exists" || check.ok === true);
-    return { ...jsonResult({ checks, ok, project_root: packageRootFromRuntimeModule(), workers: doctorWorkerSummaries(root) }), exitCode: ok ? 0 : 1 };
+    const commandReady = Boolean(conveyorPath) && Boolean(workerctlPath) && Boolean(codexPath) && Boolean(tmuxPath);
+    const operatorReady = commandReady && plugin.installed && plugin.version_matches && pluginSkillsInstalled;
+    const ok = checks.every((check) => check.name === "state_root_exists"
+        || check.name === "conveyor_on_path"
+        || check.name === "workerctl_on_path"
+        || check.name === "plugin_installed"
+        || check.name === "plugin_version_matches"
+        || check.name === "plugin_skills_installed"
+        || check.ok === true);
+    return {
+        ...jsonResult({
+            checks,
+            codex_home: plugin.paths.codex_home,
+            commands: {
+                codex: { ok: Boolean(codexPath), path: codexPath },
+                conveyor: { ok: Boolean(conveyorPath), path: conveyorPath },
+                tmux: { ok: Boolean(tmuxPath), path: tmuxPath },
+                workerctl: { ok: Boolean(workerctlPath), path: workerctlPath },
+            },
+            ok,
+            operator_ready: operatorReady,
+            package: {
+                name: "agent-conveyor",
+                root: packageRoot,
+                version: packageVersion,
+            },
+            platform: process.platform,
+            plugin,
+            project_root: packageRoot,
+            runtime: {
+                node: process.version,
+                state_root: root,
+                target_cwd: targetCwd,
+            },
+            workers: doctorWorkerSummaries(root),
+        }),
+        exitCode: ok ? 0 : 1,
+    };
 }
 function runDoctorSelfCommand(parsed, options) {
     if (parsed.task !== null) {