@repo-os/repoos 0.5.47 → 0.5.49

package/README.md

@@ -88,9 +88,10 @@ is enabled so its `repoos` shim is on your PATH.
 
 Use the same tool to update a package-manager install: `npm update -g
 @repo-os/repoos`, `bun update -g @repo-os/repoos`, `pnpm update -g
-@repo-os/repoos`, `mise upgrade npm:@repo-os/repoos`, or `brew upgrade
-repo-os/tap/repoos`. A standalone install updates with `repoos upgrade` and
-removes with `repoos uninstall`.
+@repo-os/repoos`, `mise upgrade npm:@repo-os/repoos`, or `brew update && brew
+upgrade repo-os/tap/repoos`. A standalone install updates with `repoos upgrade`
+and removes with `repoos uninstall`. When run from a recognised package-manager
+install, `repoos upgrade` prints the matching package-manager command instead.
 
 Then in any repo:
 

package/dist/.build-info.json

@@ -1,4 +1,4 @@
 {
-  "hash": "9b6f7f703e729021650ce8768748ad02cc51078cfee42e1c4cc328f5ea177dad",
-  "version": "0.5.47"
+  "hash": "f5bc7080896e6462e45fb88aeecb10c9c2f675395207b58c11bc29b2b5524aa7",
+  "version": "0.5.49"
 }

package/dist/.build-stamp.json

@@ -1,3 +1,3 @@
 {
-  "generatedAt": "2026-09-19T09:11:14.500Z"
+  "generatedAt": "2026-09-20T04:12:23.987Z"
 }

package/dist/cli/index.js

@@ -14,6 +14,8 @@ import { cmdTunnel } from "../commands/tunnel.js";
 import { cmdUpgrade } from "../commands/upgrade.js";
 import { cmdUninstall } from "../commands/uninstall.js";
 import { cmdStatus } from "../commands/status.js";
+import { cmdDoctor } from "../commands/doctor.js";
+import { cmdSupport } from "../commands/support.js";
 import { cmdService } from "../commands/service.js";
 import { checkBuild } from "../core/build.js";
 import { loadConfig } from "../core/config.js";
@@ -82,10 +84,15 @@ function exRow(cmd, comment) {
 }
 function help() {
     const commandLines = [
-        cmdRow("check", "Full definition-of-done: build, typecheck, tests, UI smoke check"),
+        cmdRow("check", "Definition-of-done gate: runs the check plan declared in repoos.toml"),
+        cmdRow("check --profile full", "Run every declared step, including ones held back from a routine run"),
+        cmdRow("check --changed main", "Fast pre-review pass over steps affected by changed paths"),
+        cmdRow("check --print-plan", "Print the resolved plan as [[check.steps]] TOML to commit"),
         cmdRow("init [name]", "Scaffold work/, repoos.toml, AGENTS.md; outside a git repo runs a guided flow that can launch the web console"),
         cmdRow("list [status]", `Show the board (or one column: ${c.dim("inbox|ready|active|review|done")})`),
         cmdRow("status [--json]", "One-screen health snapshot: server, build freshness, board, worktrees, tunnel, git"),
+        cmdRow("doctor [--json]", "Read-only readiness preflight: identity, config, layout, tools, check plan, server, secrets"),
+        cmdRow("support bundle", "Write a redacted, inspectable diagnostic bundle for failed setups"),
         cmdRow("show <id>", "Show a task's full spec"),
         cmdRow("mv <id> <status>", `Move a task to a new status — never merges code   ${c.dim('flags: --note "...", --force-not-merged')}`),
         cmdRow('note <id> "<text>"', "Append a free-form note to a task's activity log"),
@@ -155,6 +162,8 @@ function main() {
         undefined,
         "check",
         "status",
+        "doctor",
+        "support",
         "help",
         "--help",
         "-h",
@@ -189,6 +198,12 @@ function main() {
         case "status":
             void cmdStatus(rest);
             break;
+        case "doctor":
+            void cmdDoctor(rest);
+            break;
+        case "support":
+            void cmdSupport(rest);
+            break;
         case "show":
         case "cat":
             cmdShow(rest[0]);
@@ -238,7 +253,7 @@ function main() {
             void cmdService(rest);
             break;
         case "check":
-            void cmdCheck();
+            void cmdCheck(rest);
             break;
         case "tunnel":
             void cmdTunnel(rest);

package/dist/commands/check.d.ts

@@ -1,4 +1,6 @@
-import type { CheckContrastPair, CheckThemeScope } from "../core/types.js";
+import type { CheckContrastPair, CheckThemeScope, RepoOSConfig } from "../core/types.js";
+import { type CheckPlan, type CheckStep } from "../core/check-plan.js";
+import { type StepRunResult } from "../core/check-runner.js";
 /**
  * Bare `require(...)` calls guard (#0271 follow-up): this package is
  * `"type": "module"` (ESM) — a bare, un-shadowed `require` is undefined at
@@ -167,4 +169,49 @@ export declare function resolveSmokeCommand(configured: string | undefined, pkgS
  * floor via `undefined`.
  */
 export declare function testPoolSize(env: NodeJS.ProcessEnv): number | undefined;
-export declare function cmdCheck(): Promise<void>;
+/** `repoos check` CLI flags (#0446). */
+export interface CheckOptions {
+    /** Profile to select. Defaults to `[check] defaultProfile`, else `default`. */
+    profile?: string;
+    /** Git ref for changed-path mode. Also read from `REPOOS_CHECK_CHANGED`. */
+    changed?: string;
+    /** Print the resolved plan as `[[check.steps]]` TOML and exit 0. */
+    printPlan?: boolean;
+}
+/** Parse `repoos check` flags. Unknown flags are ignored, never fatal. */
+export declare function parseCheckArgs(argv?: string[]): CheckOptions;
+/**
+ * Repo-relative paths that differ from `ref`, plus anything uncommitted or
+ * untracked — the working tree an agent actually hands over, not just what is
+ * committed on the branch.
+ *
+ * Returns `null` when `ref` itself can't be resolved. That has to be
+ * distinguishable from "nothing changed": a typo'd ref with an empty result
+ * would silently scope every `whenChanged` step away and let the gate go green
+ * having verified nothing at all.
+ */
+export declare function changedPathsSince(repoRoot: string, ref: string): string[] | null;
+export interface RunPlanOptions {
+    repoRoot: string;
+    /** Config for the repo; loaded here when not supplied. */
+    cfg?: RepoOSConfig;
+    profile?: string;
+    /** Changed paths for changed-path mode; absent means a full run. */
+    changedPaths?: string[];
+    /** Git ref the changed paths came from — the Tests step scopes itself to it. */
+    changedRef?: string;
+    onStart?: (step: CheckStep) => void;
+    onResult?: (result: StepRunResult) => void;
+}
+/**
+ * Run a resolved plan, in declaration order, and return one structured result
+ * per step. Pure with respect to the caller's output: printing happens through
+ * the callbacks, so this is unit-testable end to end (see
+ * ui-app/tests/check-plan.test.ts).
+ *
+ * Every step ends in exactly one of: passed, failed, timeout, missing
+ * prerequisite, or an explicit skip that says why. Nothing here can "pass" by
+ * not running.
+ */
+export declare function runCheckPlan(plan: CheckPlan, opts: RunPlanOptions): Promise<StepRunResult[]>;
+export declare function cmdCheck(argv?: string[]): Promise<void>;