@treeseed/cli 0.6.16 → 0.6.17

package/dist/cli/handlers/ci.d.ts

@@ -0,0 +1,2 @@
+import type { TreeseedCommandHandler } from '../types.js';
+export declare const handleCi: TreeseedCommandHandler;

package/dist/cli/handlers/ci.js

@@ -0,0 +1,96 @@
+import { guidedResult } from "./utils.js";
+import { createWorkflowSdk, workflowErrorResult } from "./workflow.js";
+function asStringArray(value) {
+  return Array.isArray(value) ? value.map(String) : typeof value === "string" ? [value] : [];
+}
+function workflowLabel(repo, workflow) {
+  const status = workflow.conclusion ?? workflow.state ?? "unknown";
+  return `- ${repo.name ?? repo.repository ?? "repo"} ${workflow.workflow ?? "workflow"}: ${status}${workflow.url ? ` (${workflow.url})` : ""}${workflow.inspectCommand ? `
+  Inspect: ${workflow.inspectCommand}` : ""}`;
+}
+function failureLines(payload) {
+  return payload.failures.flatMap((failure) => {
+    const target = failure.jobName ? `${failure.repoName} ${failure.workflow ?? "workflow"} job ${failure.jobName}` : failure.workflow ? `${failure.repoName} ${failure.workflow}` : failure.repoName;
+    const lines = [
+      `- ${target}: ${failure.message}`,
+      ...failure.url ? [`  URL: ${failure.url}`] : [],
+      ...failure.inspectCommand ? [`  Inspect: ${failure.inspectCommand}`] : [],
+      ...failure.failedSteps.length > 0 ? [`  Failed steps: ${failure.failedSteps.map((step) => step.name).join(", ")}`] : []
+    ];
+    if (failure.logExcerpt) {
+      lines.push("  Log excerpt:");
+      lines.push(...failure.logExcerpt.split(/\r?\n/u).map((line) => `    ${line}`));
+    }
+    return lines;
+  });
+}
+function pendingLines(payload) {
+  return payload.repositories.flatMap((repo) => repo.workflows.filter((workflow) => workflow.state === "pending").map((workflow) => workflowLabel(repo, workflow)));
+}
+function missingOrNotPushedLines(payload) {
+  const lines = [];
+  for (const repo of payload.repositories) {
+    if (repo.state === "not_pushed" || repo.state === "error") {
+      lines.push(`- ${repo.name}: ${repo.message ?? repo.state}`);
+      continue;
+    }
+    for (const workflow of repo.workflows.filter((entry) => entry.state === "missing" || entry.state === "error")) {
+      lines.push(workflowLabel(repo, workflow));
+    }
+  }
+  return lines;
+}
+function passingLines(payload) {
+  return payload.repositories.flatMap((repo) => repo.workflows.filter((workflow) => workflow.state === "success").map((workflow) => workflowLabel(repo, workflow)));
+}
+function ciSections(payload, failedOnly) {
+  const sections = [
+    { title: "Failures", lines: failureLines(payload) },
+    { title: "Pending", lines: pendingLines(payload) },
+    { title: "Missing / Not Pushed", lines: missingOrNotPushedLines(payload) }
+  ];
+  if (!failedOnly) {
+    sections.push({ title: "Passing", lines: passingLines(payload) });
+  }
+  return sections;
+}
+const handleCi = async (invocation, context) => {
+  try {
+    const result = await createWorkflowSdk(context).ci({
+      failed: invocation.args.failed === true,
+      logs: invocation.args.logs === true,
+      logLines: typeof invocation.args.logLines === "string" ? invocation.args.logLines : void 0,
+      scope: typeof invocation.args.scope === "string" ? invocation.args.scope : void 0,
+      workflows: asStringArray(invocation.args.workflow),
+      branch: typeof invocation.args.branch === "string" ? invocation.args.branch : void 0,
+      strict: invocation.args.strict === true
+    });
+    const payload = result.payload;
+    return guidedResult({
+      command: invocation.commandName || "ci",
+      summary: payload.hasFailures ? "Treeseed CI found remote GitHub Actions failures." : payload.strict && payload.hasPending ? "Treeseed CI found pending remote GitHub Actions runs." : "Treeseed CI status is clear.",
+      facts: [
+        { label: "Mode", value: payload.mode },
+        { label: "Scope", value: payload.scope },
+        { label: "Branch", value: payload.branch ?? "(mixed)" },
+        { label: "Repositories", value: payload.summary.repositories },
+        { label: "Workflows", value: payload.summary.workflows },
+        { label: "Passing", value: payload.summary.success },
+        { label: "Failing", value: payload.summary.failure },
+        { label: "Pending", value: payload.summary.pending },
+        { label: "Missing", value: payload.summary.missing },
+        { label: "Not pushed", value: payload.summary.notPushed },
+        { label: "Errors", value: payload.summary.error },
+        { label: "Checked at", value: payload.checkedAt }
+      ],
+      sections: ciSections(payload, invocation.args.failed === true),
+      report: result,
+      exitCode: payload.exitCode
+    });
+  } catch (error) {
+    return workflowErrorResult(error);
+  }
+};
+export {
+  handleCi
+};

package/dist/cli/handlers/config-ui.js

@@ -336,7 +336,9 @@ function buildStartupDetailLines(step, draftValue) {
     `Pending value: ${formatDisplayValue(step, draftValue, "(unset)")}`,
     "",
     step.entry.description || "Treeseed needs this value to complete setup.",
-    `How to get it: ${step.entry.howToGet || "Use the suggested/default value if it matches your setup."}`
+    "",
+    "How to get it:",
+    ...(step.entry.howToGet || "Use the suggested/default value if it matches your setup.").split("\n")
   ];
 }
 function buildFullDetailLines(page, draftValue) {
@@ -354,7 +356,9 @@ function buildFullDetailLines(page, draftValue) {
     `Pending: ${formatDisplayValue(page, draftValue, "(unset)")}`,
     "",
     page.entry.description || "(no description)",
-    `Get it: ${page.entry.howToGet || "(no extra setup guidance)"}`
+    "",
+    "How to get it:",
+    ...(page.entry.howToGet || "(no extra setup guidance)").split("\n")
   ];
 }
 function detailViewportLines(lines, width, height, offset) {

package/dist/cli/handlers/dev.js

@@ -65,6 +65,7 @@ const handleDev = async (invocation, context) => {
     forwardStringOption("feedback", "--feedback");
     forwardStringOption("open", "--open");
     forwardBooleanOption("plan", "--plan");
+    forwardBooleanOption("reset", "--reset");
     forwardBooleanOption("json", "--json");
     const workspaceRoot = findNearestTreeseedWorkspaceRoot(context.cwd);
     const workspaceLinksMode = typeof invocation.args.workspaceLinks === "string" ? invocation.args.workspaceLinks : void 0;

package/dist/cli/operations-registry.js

@@ -31,6 +31,7 @@ const DEV_RUNTIME_OPTIONS = [
   { name: "feedback", flags: "--feedback <mode>", description: "Control live feedback, service restarts, and browser reload stamps.", kind: "enum", values: ["live", "restart", "off"] },
   { name: "open", flags: "--open <mode>", description: "Control whether dev opens the browser after readiness.", kind: "enum", values: ["auto", "on", "off"] },
   { name: "plan", flags: "--plan", description: "Print the dev runtime plan and exit without starting services.", kind: "boolean" },
+  { name: "reset", flags: "--reset", description: "Clear local dev runtime state before setup, migrations, and service startup.", kind: "boolean" },
   { name: "json", flags: "--json", description: "Emit structured JSON or newline-delimited dev events.", kind: "boolean" },
   { name: "watch", flags: "--watch", description: "Enable live watch behavior. `dev` defaults to live feedback; this remains for compatibility.", kind: "boolean" },
   { name: "workspaceLinks", flags: "--workspace-links <mode>", description: "Control local workspace package links.", kind: "enum", values: ["auto", "off"] }
@@ -191,6 +192,56 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
     executionMode: "handler",
     handlerName: "status"
   })],
+  ["ci", command({
+    options: [
+      { name: "failed", flags: "--failed", description: "Focus human output on failures and attention-needed workflows.", kind: "boolean" },
+      { name: "logs", flags: "--logs", description: "Fetch capped log excerpts for failed jobs.", kind: "boolean" },
+      { name: "logLines", flags: "--log-lines <n>", description: "Maximum failed-job log lines to include with --logs.", kind: "string" },
+      { name: "scope", flags: "--scope <scope>", description: "Select workspace, root, or package repositories.", kind: "enum", values: ["workspace", "root", "packages"] },
+      { name: "workflow", flags: "--workflow <file>", description: "Inspect a specific workflow file. May be repeated.", kind: "string", repeatable: true },
+      { name: "branch", flags: "--branch <name>", description: "Inspect this branch name in all selected repositories.", kind: "string" },
+      { name: "strict", flags: "--strict", description: "Return nonzero for pending workflows as well as failures.", kind: "boolean" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ["treeseed ci", "treeseed ci --failed", "treeseed ci --logs --log-lines 50", "treeseed ci --scope packages --workflow verify.yml --json"],
+    help: {
+      workflowPosition: "inspect",
+      longSummary: [
+        "CI inspects the remote GitHub Actions runs for the current branch heads in market and checked-out package repositories.",
+        "It is read-only and is designed for quickly finding failed hosted verification without digging through GitHub UI pages."
+      ],
+      whenToUse: [
+        "Use this after `save`, `stage`, or a pushed package change when you need the latest remote verification state.",
+        "Use `--failed` when you only want attention items, or `--logs` when you want failed-job excerpts inline."
+      ],
+      beforeYouRun: [
+        "Run from the Treeseed workspace you want to inspect.",
+        "Make sure the branch heads you care about have been pushed; unpushed heads are reported as not pushed.",
+        "Use `--json` for agent or script consumption."
+      ],
+      outcomes: [
+        "Lists passing, pending, missing, not-pushed, and failing GitHub Actions workflows.",
+        "Shows failed jobs, failed steps when GitHub provides them, workflow URLs, and inspect commands."
+      ],
+      examples: [
+        example("treeseed ci", "Inspect workspace CI", "Check market and checked-out package workflows for the active branch heads."),
+        example("treeseed ci --failed", "Focus on failures", "Show only failed and attention-needed workflows in human output."),
+        example("treeseed ci --logs --log-lines 50", "Include failed logs", "Fetch compact failed-job log excerpts while keeping output bounded."),
+        example("treeseed ci --scope packages --json", "Automate package CI checks", "Emit structured package workflow status for agents and scripts.")
+      ],
+      automationNotes: [
+        "`--json` includes the full repository list plus a flattened `failures` array.",
+        "The command is read-only; it does not wait, rerun, or mutate GitHub Actions runs."
+      ],
+      relatedDetails: [
+        related("status", "Use `status` for local workspace health before inspecting hosted CI."),
+        related("save", "Use `save` before CI inspection when local changes need to be pushed."),
+        related("stage", "Use `stage` after hosted CI is healthy and the task is ready for staging.")
+      ]
+    },
+    executionMode: "handler",
+    handlerName: "ci"
+  })],
   ["tasks", command({
     options: [{ name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }],
     examples: ["treeseed tasks", "treeseed tasks --json"],
@@ -1052,7 +1103,7 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
   })],
   ["dev", command({
     options: DEV_RUNTIME_OPTIONS,
-    examples: ["treeseed dev", "treeseed dev --plan --json", "treeseed dev --surface web --port 4322 --open off"],
+    examples: ["treeseed dev", "treeseed dev --reset", "treeseed dev --reset --plan --json", "treeseed dev --surface web --port 4322 --open off"],
     help: {
       longSummary: [
         "Dev starts the unified local Treeseed runtime as a foreground supervisor so you can work against the integrated web, API, and supporting local surfaces.",
@@ -1061,10 +1112,13 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
       beforeYouRun: [
         "Run from the tenant or workspace root you want to develop.",
         "Use `--plan --json` when you want to inspect commands, setup steps, readiness checks, and watched paths without starting services.",
+        "Use `--reset` when you want a fresh local D1 database, Mailpit inbox, generated worker bundle, and Wrangler temp output without deleting configuration.",
         "Keep the foreground process running while you test. Press Ctrl+C to stop the supervised stack and free the local ports."
       ],
       examples: [
         example("treeseed dev", "Start integrated local development", "Run the default integrated local runtime and keep supervising it in the foreground."),
+        example("treeseed dev --reset", "Start from a fresh local runtime", "Clear disposable local dev state, rerun setup and D1 migrations, then start the dev supervisor."),
+        example("treeseed dev --reset --plan --json", "Inspect reset actions", "Emit the reset, setup, readiness, command, and watch plan without deleting local state or starting services."),
         example("treeseed dev --plan --json", "Inspect the runtime plan", "Emit a structured plan with setup steps, commands, ports, URLs, readiness checks, and watch entries."),
         example("treeseed dev --surface web --port 4322 --open off", "Run only the web surface", "Start the Astro UI on a specific port without opening a browser."),
         example("trsd dev", "Use the short alias", "Start the same local runtime through the shorter entrypoint."),

package/dist/cli/registry.d.ts

@@ -8,6 +8,7 @@ export declare const COMMAND_HANDLERS: {
     readonly release: import("./operations-types.js").TreeseedCommandHandler;
     readonly destroy: import("./operations-types.js").TreeseedCommandHandler;
     readonly status: import("./operations-types.js").TreeseedCommandHandler;
+    readonly ci: import("./operations-types.js").TreeseedCommandHandler;
     readonly dev: import("./operations-types.js").TreeseedCommandHandler;
     readonly 'dev:watch': import("./operations-types.js").TreeseedCommandHandler;
     readonly doctor: import("./operations-types.js").TreeseedCommandHandler;

package/dist/cli/registry.js

@@ -10,6 +10,7 @@ import { handleSave } from "./handlers/save.js";
 import { handleRelease } from "./handlers/release.js";
 import { handleDestroy } from "./handlers/destroy.js";
 import { handleStatus } from "./handlers/status.js";
+import { handleCi } from "./handlers/ci.js";
 import { handleDev } from "./handlers/dev.js";
 import { handleDoctor } from "./handlers/doctor.js";
 import { handleRollback } from "./handlers/rollback.js";
@@ -42,6 +43,7 @@ const COMMAND_HANDLERS = {
   release: handleRelease,
   destroy: handleDestroy,
   status: handleStatus,
+  ci: handleCi,
   dev: handleDev,
   "dev:watch": handleDev,
   doctor: handleDoctor,

package/dist/cli/ui/framework.d.ts

@@ -70,7 +70,7 @@ type AppFrameProps = {
     body: React.ReactNode;
     footer: React.ReactNode;
 };
-export declare function AppFrame(props: AppFrameProps): any;
+export declare function AppFrame(props: AppFrameProps): React.ReactElement;
 type TopTabsProps = {
     title?: string;
     items: TabItem[];
@@ -79,7 +79,7 @@ type TopTabsProps = {
     width: number;
     prefix?: string;
 };
-export declare function TopTabs(props: TopTabsProps): any;
+export declare function TopTabs(props: TopTabsProps): React.ReactElement;
 type SidebarListProps = {
     width: number;
     height: number;
@@ -93,7 +93,7 @@ type SidebarListProps = {
     scrollState?: ScrollRegionState;
     title?: string;
 };
-export declare function SidebarList(props: SidebarListProps): any;
+export declare function SidebarList(props: SidebarListProps): React.ReactElement;
 type ScrollPanelProps = {
     width: number;
     height: number;
@@ -103,7 +103,7 @@ type ScrollPanelProps = {
     tone?: 'normal' | 'accent';
     scrollState?: ScrollRegionState;
 };
-export declare function ScrollPanel(props: ScrollPanelProps): any;
+export declare function ScrollPanel(props: ScrollPanelProps): React.ReactElement;
 type FieldCardProps = {
     width: number;
     height: number;
@@ -111,7 +111,7 @@ type FieldCardProps = {
     lines: string[];
     focused?: boolean;
 };
-export declare function FieldCard(props: FieldCardProps): any;
+export declare function FieldCard(props: FieldCardProps): React.ReactElement;
 type TextInputFieldProps = {
     label: string;
     value: string;
@@ -123,7 +123,7 @@ type TextInputFieldProps = {
     cursorPosition?: number;
     helperText?: string;
 };
-export declare function TextInputField(props: TextInputFieldProps): any;
+export declare function TextInputField(props: TextInputFieldProps): React.ReactElement;
 type TextAreaFieldProps = {
     label: string;
     value: string;
@@ -131,28 +131,28 @@ type TextAreaFieldProps = {
     height: number;
     focused?: boolean;
 };
-export declare function TextAreaField(props: TextAreaFieldProps): any;
+export declare function TextAreaField(props: TextAreaFieldProps): React.ReactElement;
 type ButtonProps = {
     label: string;
     focused?: boolean;
     active?: boolean;
     width?: number;
 };
-export declare function PrimaryButton(props: ButtonProps): any;
-export declare function SecondaryButton(props: ButtonProps): any;
+export declare function PrimaryButton(props: ButtonProps): React.ReactElement;
+export declare function SecondaryButton(props: ButtonProps): React.ReactElement;
 type StatusBarProps = {
     width: number;
     primary: string;
     secondary?: string;
     accent?: boolean;
 };
-export declare function StatusBar(props: StatusBarProps): any;
+export declare function StatusBar(props: StatusBarProps): React.ReactElement;
 export declare function EmptyState(props: {
     width: number;
     height: number;
     title: string;
     message: string;
-}): any;
+}): React.ReactElement;
 export declare function ConfirmDialog(props: {
     width: number;
     title: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/cli",
-  "version": "0.6.16",
+  "version": "0.6.17",
   "description": "Operator-facing Treeseed CLI package.",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -45,7 +45,7 @@
     "release:publish": "node ./scripts/run-ts.mjs ./scripts/publish-package.ts"
   },
   "dependencies": {
-    "@treeseed/sdk": "0.6.16",
+    "@treeseed/sdk": "0.6.17",
     "ink": "^7.0.0",
     "react": "^19.2.5"
   },