@treeseed/cli 0.8.6 → 0.8.8

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

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

package/dist/cli/handlers/capacity.js

@@ -0,0 +1,145 @@
+import { guidedResult } from "./utils.js";
+import { createMarketClientForInvocation } from "./market-utils.js";
+function required(value, message) {
+  if (typeof value === "string" && value.trim()) return value.trim();
+  throw new Error(message);
+}
+const handleCapacity = async (invocation, context) => {
+  const action = invocation.positionals[0] ?? "status";
+  const { profile, client } = createMarketClientForInvocation(invocation, context, { requireAuth: true });
+  const teamId = typeof invocation.args.team === "string" ? invocation.args.team : typeof profile.teamId === "string" ? profile.teamId : null;
+  if (action === "status") {
+    const team = required(teamId, "Usage: treeseed capacity status --team <team-id>");
+    const response = await client.teamCapacity(team);
+    const summary = response.payload.summary;
+    return guidedResult({
+      command: "capacity",
+      summary: "Team helper capacity status",
+      facts: [
+        { label: "Market", value: profile.id },
+        { label: "Team", value: team },
+        { label: "Monthly remaining", value: summary?.monthlyRemainingCredits },
+        { label: "Daily remaining", value: summary?.dailyRemainingCredits },
+        { label: "Active providers", value: summary?.activeProviderCount }
+      ],
+      report: { marketId: profile.id, teamId: team, capacity: response.payload }
+    });
+  }
+  if (action === "providers") {
+    const subcommand = invocation.positionals[1] ?? "list";
+    const team = required(teamId, "Usage: treeseed capacity providers list --team <team-id>");
+    if (subcommand === "list") {
+      const response = await client.teamCapacity(team);
+      const providers = response.payload.providers ?? [];
+      return guidedResult({
+        command: "capacity",
+        summary: `Found ${providers.length} helper capacity provider${providers.length === 1 ? "" : "s"}.`,
+        sections: [{
+          title: "Providers",
+          lines: providers.map((provider) => `${provider.id}  ${provider.name}  ${provider.status}  workers=${provider.maxConcurrentWorkers ?? 0}`)
+        }],
+        report: { marketId: profile.id, teamId: team, providers }
+      });
+    }
+    if (subcommand === "connect") {
+      const response = await client.launchManagedCapacityProvider(team, { launchSource: "cli" });
+      return guidedResult({
+        command: "capacity",
+        summary: "TreeSeed-managed helper capacity is connected.",
+        facts: [
+          { label: "Provider", value: response.payload.provider?.id },
+          { label: "Security code prefix", value: response.payload.apiKey?.keyPrefix }
+        ],
+        report: { marketId: profile.id, teamId: team, result: response.payload }
+      });
+    }
+    if (subcommand === "keys") {
+      const keyAction = invocation.positionals[2] ?? "reset";
+      const providerId = required(invocation.args.provider, "Usage: treeseed capacity providers keys reset --provider <provider-id>");
+      if (keyAction === "reset") {
+        const response = await client.resetCapacityProviderApiKey(providerId, { name: "Provider security code" });
+        return guidedResult({
+          command: "capacity",
+          summary: "Provider security code was reset.",
+          facts: [
+            { label: "Provider", value: providerId },
+            { label: "Prefix", value: response.payload.key?.keyPrefix },
+            { label: "Security access code", value: response.payload.plaintextKey }
+          ],
+          report: { marketId: profile.id, providerId, result: response.payload }
+        });
+      }
+      if (keyAction === "revoke") {
+        const keyId = required(invocation.args.key, "Usage: treeseed capacity providers keys revoke --provider <provider-id> --key <key-id>");
+        const response = await client.revokeCapacityProviderApiKey(providerId, keyId);
+        return guidedResult({
+          command: "capacity",
+          summary: "Provider security code was revoked.",
+          facts: [
+            { label: "Provider", value: providerId },
+            { label: "Key", value: keyId }
+          ],
+          report: { marketId: profile.id, providerId, keyId, result: response.payload }
+        });
+      }
+    }
+    return { exitCode: 1, stderr: [`Unknown capacity providers action: ${subcommand}`] };
+  }
+  if (action === "grants") {
+    const subcommand = invocation.positionals[1] ?? "list";
+    const team = required(teamId, "Usage: treeseed capacity grants list --team <team-id>");
+    if (subcommand === "list") {
+      const response = await client.capacityGrants(team);
+      return guidedResult({
+        command: "capacity",
+        summary: `Found ${response.payload.length} capacity grant${response.payload.length === 1 ? "" : "s"}.`,
+        sections: [{
+          title: "Grants",
+          lines: response.payload.map((grant) => `${grant.id}  ${grant.grantScope}  daily=${grant.dailyCreditLimit ?? "policy"}  monthly=${grant.monthlyCreditLimit ?? "policy"}`)
+        }],
+        report: { marketId: profile.id, teamId: team, grants: response.payload }
+      });
+    }
+    if (subcommand === "create") {
+      const providerId = required(invocation.args.provider, "Usage: treeseed capacity grants create --team <team-id> --provider <provider-id>");
+      const response = await client.createCapacityGrant(team, {
+        capacityProviderId: providerId,
+        projectId: typeof invocation.args.project === "string" ? invocation.args.project : null,
+        environment: typeof invocation.args.environment === "string" ? invocation.args.environment : null,
+        dailyCreditLimit: Number(invocation.args.daily ?? 25),
+        monthlyCreditLimit: Number(invocation.args.monthly ?? 500),
+        overflowPolicy: typeof invocation.args.overflow === "string" ? invocation.args.overflow : "approval_required"
+      });
+      return guidedResult({
+        command: "capacity",
+        summary: "Capacity grant created.",
+        facts: [
+          { label: "Grant", value: response.payload.id },
+          { label: "Provider", value: providerId }
+        ],
+        report: { marketId: profile.id, teamId: team, grant: response.payload }
+      });
+    }
+    return { exitCode: 1, stderr: [`Unknown capacity grants action: ${subcommand}`] };
+  }
+  if (action === "enqueue") {
+    const projectId = required(invocation.args.project, "Usage: treeseed capacity enqueue --project <project-id> --task-kind <kind>");
+    const response = await client.enqueueAgentTask(projectId, {
+      taskKind: typeof invocation.args.taskKind === "string" ? invocation.args.taskKind : typeof invocation.args.task === "string" ? invocation.args.task : "proposal.draft",
+      environment: typeof invocation.args.environment === "string" ? invocation.args.environment : "staging"
+    });
+    return guidedResult({
+      command: "capacity",
+      summary: "Budgeted agent task enqueued.",
+      facts: [
+        { label: "Task", value: response.payload.task?.id },
+        { label: "Reserved credits", value: response.payload.reservation?.reservedCredits }
+      ],
+      report: { marketId: profile.id, projectId, result: response.payload }
+    });
+  }
+  return { exitCode: 1, stderr: [`Unknown capacity action: ${action}`] };
+};
+export {
+  handleCapacity
+};

package/dist/cli/handlers/config-ui.d.ts

@@ -88,6 +88,7 @@ export type ConfigViewportLayout = UiViewportLayout & {
     inputHeight: number;
     actionRowHeight: number;
 };
+export declare function resolveCurrentConfigValue(context: ConfigContextSnapshot, overrides: Record<string, string>, entryId: string, scope?: ConfigScope): string;
 export declare function filterCliConfigPages(pages: ConfigPage[], query: string): ConfigPage[];
 export declare function computeConfigViewportLayout(rows: number, columns: number): ConfigViewportLayout;
 export declare function buildCliConfigPages(context: ConfigContextSnapshot, selectedFilter: ConfigScope, overrides?: Record<string, string>, viewMode?: ConfigViewMode): ConfigPage[];

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

@@ -21,6 +21,12 @@ import {
 } from "../ui/framework.js";
 import { useTerminalMouse } from "../ui/mouse.js";
 const FULL_CONFIG_FILTERS = ["local", "staging", "prod"];
+function firstAvailableScope(context, preferred = "local") {
+  if (context.scopes.includes(preferred)) {
+    return preferred;
+  }
+  return context.scopes[0] ?? preferred;
+}
 function maskValue(value) {
   if (!value) {
     return "(unset)";
@@ -111,7 +117,7 @@ function resolveCurrentConfigValue(context, overrides, entryId, scope = "local")
     return overrides[scopedOverrideKey] ?? "";
   }
   for (const candidateScope of [scope, ...context.scopes.filter((candidate) => candidate !== scope)]) {
-    const entry = context.entriesByScope[candidateScope].find((candidate) => candidate.id === entryId);
+    const entry = context.entriesByScope[candidateScope]?.find((candidate) => candidate.id === entryId);
     if (entry?.storage === "shared") {
       const overrideKey = `shared:${entryId}`;
       if (overrideKey in overrides) {
@@ -236,15 +242,15 @@ function buildCliConfigPages(context, selectedFilter, overrides = {}, viewMode =
   const sharedEntries = /* @__PURE__ */ new Set();
   const pages = [];
   for (const scope of selectedScopes) {
-    for (const entry of context.entriesByScope[scope]) {
+    for (const entry of context.entriesByScope[scope] ?? []) {
       if (entry.storage === "shared") {
         if (sharedEntries.has(entry.id)) {
           continue;
         }
-        const relevantScopes = selectedScopes.filter((candidateScope) => context.entriesByScope[candidateScope].some((candidate) => candidate.id === entry.id));
+        const relevantScopes = selectedScopes.filter((candidateScope) => context.entriesByScope[candidateScope]?.some((candidate) => candidate.id === entry.id));
         const key2 = `shared:${entry.id}`;
         sharedEntries.add(entry.id);
-        const requiredScopes = relevantScopes.filter((candidateScope) => context.entriesByScope[candidateScope].some((candidate) => candidate.id === entry.id && candidate.required));
+        const requiredScopes = relevantScopes.filter((candidateScope) => context.entriesByScope[candidateScope]?.some((candidate) => candidate.id === entry.id && candidate.required));
         const currentValue = resolveSharedEntryValue(relevantScopes, requiredScopes, context.entriesByScope, entry.id, "currentValue");
         const suggestedValue = resolveSharedEntryValue(relevantScopes, requiredScopes, context.entriesByScope, entry.id, "suggestedValue", {
           fallbackToRelevant: requiredScopes.length === 0
@@ -465,7 +471,10 @@ async function runCliConfigEditor(context, options = {}) {
     function App() {
       const sidebarFilterHeight = 4;
       const [currentContext, setCurrentContext] = React.useState(context);
-      const [filterIndex, setFilterIndex] = React.useState(0);
+      const [filterIndex, setFilterIndex] = React.useState(() => {
+        const initialScope = firstAvailableScope(context);
+        return Math.max(0, FULL_CONFIG_FILTERS.indexOf(initialScope));
+      });
       const [viewMode, setViewMode] = React.useState(options.initialViewMode ?? "startup");
       const [pageIndex, setPageIndex] = React.useState(0);
       const [sidebarOffset, setSidebarOffset] = React.useState(0);
@@ -484,7 +493,8 @@ async function runCliConfigEditor(context, options = {}) {
       const { exit } = useApp();
       const windowSize = useWindowSize();
       const layout = computeConfigViewportLayout(windowSize?.rows ?? 24, windowSize?.columns ?? 100);
-      const selectedFilter = FULL_CONFIG_FILTERS[filterIndex] ?? "local";
+      const selectedFilter = FULL_CONFIG_FILTERS[filterIndex] ?? firstAvailableScope(currentContext);
+      const readinessScope = firstAvailableScope(currentContext, selectedFilter);
       const allPages = buildCliConfigPages(currentContext, selectedFilter, overrides, viewMode);
       const pages = viewMode === "full" ? filterCliConfigPages(allPages, filterQuery) : allPages;
       const safePageIndex = pages.length === 0 ? 0 : Math.min(pageIndex, pages.length - 1);
@@ -510,10 +520,10 @@ async function runCliConfigEditor(context, options = {}) {
       const detailWidth = viewMode === "full" ? layout.contentWidth : layout.columns;
       const detailPanel = detailViewportLines(detailSourceLines, detailWidth, layout.detailHeight, detailOffset);
       const configReadiness = {
-        github: { configured: hasUsableValue(resolveCurrentConfigValue(currentContext, overrides, "GH_TOKEN", "local")) },
-        cloudflare: { configured: hasUsableValue(resolveCurrentConfigValue(currentContext, overrides, "CLOUDFLARE_API_TOKEN", "local")) },
-        railway: { configured: hasUsableValue(resolveCurrentConfigValue(currentContext, overrides, "RAILWAY_API_TOKEN", "local")) },
-        localDevelopment: currentContext.configReadinessByScope.local?.localDevelopment ?? { configured: true }
+        github: { configured: hasUsableValue(resolveCurrentConfigValue(currentContext, overrides, "GH_TOKEN", readinessScope)) },
+        cloudflare: { configured: hasUsableValue(resolveCurrentConfigValue(currentContext, overrides, "CLOUDFLARE_API_TOKEN", readinessScope)) },
+        railway: { configured: hasUsableValue(resolveCurrentConfigValue(currentContext, overrides, "RAILWAY_API_TOKEN", readinessScope)) },
+        localDevelopment: currentContext.configReadinessByScope[readinessScope]?.localDevelopment ?? { configured: true }
       };
       const sidebarHeight = Math.max(4, layout.bodyHeight - sidebarFilterHeight);
       const sidebarViewportSize = Math.max(1, sidebarHeight - 4);
@@ -1171,5 +1181,6 @@ export {
   filterCliConfigPages,
   normalizeConfigInputChunk,
   readLinuxClipboardText,
+  resolveCurrentConfigValue,
   runCliConfigEditor
 };

package/dist/cli/handlers/config.js

@@ -117,8 +117,12 @@ function renderConfigResult(commandName, result) {
   const payload = result.payload;
   const toolHealth = payload.toolHealth;
   const configContext = payload.context;
-  const configReadiness = configContext?.configReadinessByScope?.local ?? {};
   const readinessByScope = payload.result?.readinessByScope ?? {};
+  const configReadinessByScope = configContext?.configReadinessByScope ?? {};
+  const providerConfigStatus = (provider) => {
+    const selectedScopes = Array.isArray(payload.scopes) && payload.scopes.length > 0 ? payload.scopes : Object.keys(configReadinessByScope);
+    return selectedScopes.some((scope) => configReadinessByScope?.[scope]?.[provider]?.configured) ? "configured" : "missing";
+  };
   const bootstrapSystemsByScope = payload.result?.bootstrapSystemsByScope ?? payload.bootstrapSystemsByScope ?? {};
   const skippedSystems = Object.values(bootstrapSystemsByScope).flatMap((entry) => Array.isArray(entry?.skipped) ? entry.skipped : []);
   const resourceInventoryByScope = payload.result?.resourceInventoryByScope ?? payload.resourceInventoryByScope ?? {};
@@ -149,9 +153,9 @@ function renderConfigResult(commandName, result) {
       { label: "Prod readiness", value: configReadinessLabel(readinessByScope.prod) },
       { label: "Pages project", value: resourceInventoryByScope.staging?.resources?.pagesProject ?? resourceInventoryByScope.prod?.resources?.pagesProject ?? "(unset)" },
       { label: "R2 bucket", value: resourceInventoryByScope.staging?.resources?.contentBucket ?? resourceInventoryByScope.prod?.resources?.contentBucket ?? "(unset)" },
-      { label: "GitHub token/config", value: configReadiness.github?.configured ? "configured" : "missing" },
-      { label: "Cloudflare token/config", value: configReadiness.cloudflare?.configured ? "configured" : "missing" },
-      { label: "Railway token/config", value: configReadiness.railway?.configured ? "configured" : "missing" },
+      { label: "GitHub token/config", value: providerConfigStatus("github") },
+      { label: "Cloudflare token/config", value: providerConfigStatus("cloudflare") },
+      { label: "Railway token/config", value: providerConfigStatus("railway") },
       { label: "GitHub CLI", value: toolHealth?.githubCli?.available ? "ready" : "missing" },
       { label: "Wrangler CLI", value: toolHealth?.wranglerCli?.available ? "ready" : "missing" },
       { label: "Railway CLI", value: toolHealth?.railwayCli?.available ? "ready" : "missing" },

package/dist/cli/operations-registry.js

@@ -1460,6 +1460,47 @@ const CLI_ONLY_OPERATION_SPECS = [
     executionMode: "handler",
     handlerName: "projects"
   },
+  {
+    id: "market.capacity",
+    name: "capacity",
+    aliases: [],
+    group: "Utilities",
+    summary: "Manage team helper capacity from the selected market.",
+    description: "Inspect team helper credits, connect managed providers, rotate provider security codes, manage grants, and enqueue budgeted agent tasks.",
+    provider: "default",
+    related: ["teams", "projects", "agents"],
+    usage: "treeseed capacity [status|providers|grants|enqueue]",
+    arguments: [{ name: "action", description: "Capacity action.", required: false }],
+    options: [
+      { name: "market", flags: "--market <id-or-url>", description: "Select a configured market id or direct market API URL.", kind: "string" },
+      { name: "team", flags: "--team <team-id>", description: "Team id for capacity status and grants.", kind: "string" },
+      { name: "provider", flags: "--provider <provider-id>", description: "Capacity provider id for grant or key actions.", kind: "string" },
+      { name: "project", flags: "--project <project-id>", description: "Project id for grant allocation or agent enqueue.", kind: "string" },
+      { name: "key", flags: "--key <key-id>", description: "Provider security code id to revoke.", kind: "string" },
+      { name: "taskKind", flags: "--task-kind <kind>", description: "Agent task signature for budgeted enqueue.", kind: "string" },
+      { name: "environment", flags: "--environment <environment>", description: "Project environment for grants or enqueue.", kind: "enum", values: ["local", "staging", "prod"] },
+      { name: "daily", flags: "--daily <credits>", description: "Daily credit limit for a created grant.", kind: "string" },
+      { name: "monthly", flags: "--monthly <credits>", description: "Monthly credit limit for a created grant.", kind: "string" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: [
+      "treeseed capacity status --team team_123",
+      "treeseed capacity providers connect --team team_123",
+      "treeseed capacity providers keys reset --provider provider_123",
+      "treeseed capacity grants create --team team_123 --provider provider_123 --daily 25",
+      "treeseed capacity enqueue --project project_123 --task-kind proposal.draft"
+    ],
+    help: {
+      longSummary: ["Capacity talks to the market control plane so technical stewards can inspect helper credits, provider security codes, and budgeted agent task routing without opening the browser."],
+      whenToUse: ["Use this after connecting to a market when provider health, budget allocation, or budgeted agent enqueue needs to be checked from a terminal."],
+      beforeYouRun: ["Authenticate to the selected market and know the team, project, or provider id for the action you are taking."],
+      automationNotes: ["Use `--json` when capturing provider keys, grant ids, task ids, or dashboard summaries in automation."]
+    },
+    helpVisible: true,
+    helpFeatured: false,
+    executionMode: "handler",
+    handlerName: "capacity"
+  },
   {
     id: "market.packs",
     name: "packs",

package/dist/cli/registry.d.ts

@@ -28,6 +28,7 @@ export declare const COMMAND_HANDLERS: {
     readonly market: import("./operations-types.js").TreeseedCommandHandler;
     readonly teams: import("./operations-types.js").TreeseedCommandHandler;
     readonly projects: import("./operations-types.js").TreeseedCommandHandler;
+    readonly capacity: import("./operations-types.js").TreeseedCommandHandler;
     readonly packs: import("./operations-types.js").TreeseedCommandHandler;
     readonly gh: import("./operations-types.js").TreeseedCommandHandler;
     readonly railway: import("./operations-types.js").TreeseedCommandHandler;

package/dist/cli/registry.js

@@ -22,6 +22,7 @@ import { handleAuthWhoAmI } from "./handlers/auth-whoami.js";
 import { handleMarket } from "./handlers/market.js";
 import { handleTeams } from "./handlers/teams.js";
 import { handleProjects } from "./handlers/projects.js";
+import { handleCapacity } from "./handlers/capacity.js";
 import { handlePacks } from "./handlers/packs.js";
 import { handleToolWrapper } from "./handlers/tool-wrapper.js";
 import {
@@ -73,6 +74,7 @@ const COMMAND_HANDLERS = {
   market: handleMarket,
   teams: handleTeams,
   projects: handleProjects,
+  capacity: handleCapacity,
   packs: handlePacks,
   gh: handleToolWrapper,
   railway: handleToolWrapper,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/cli",
-  "version": "0.8.6",
+  "version": "0.8.8",
   "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.8.6",
+    "@treeseed/sdk": "0.8.8",
     "ink": "^7.0.0",
     "react": "^19.2.5"
   },