@treeseed/cli 0.8.7 → 0.8.9

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.js

@@ -128,7 +128,7 @@ function renderConfigResult(commandName, result) {
   const resourceInventoryByScope = payload.result?.resourceInventoryByScope ?? payload.resourceInventoryByScope ?? {};
   const secretSession = payload.secretSession;
   const sharedStorageMigrations = payload.result?.sharedStorageMigrations;
-  const summary = payload.mode === "print-env-only" ? "Treeseed config environment report completed." : payload.mode === "rotate-machine-key" ? "Treeseed machine key rotated successfully." : payload.mode === "connect-market" ? "Knowledge Coop pairing completed successfully." : payload.mode === "bootstrap-preflight" ? "Treeseed bootstrap verification preflight completed." : payload.mode === "bootstrap" ? "Treeseed platform bootstrap completed successfully." : "Treeseed config completed successfully.";
+  const summary = payload.mode === "print-env-only" ? "Treeseed config environment report completed." : payload.mode === "rotate-machine-key" ? "Treeseed machine key rotated successfully." : payload.mode === "connect-market" ? "TreeSeed pairing completed successfully." : payload.mode === "bootstrap-preflight" ? "Treeseed bootstrap verification preflight completed." : payload.mode === "bootstrap" ? "Treeseed platform bootstrap completed successfully." : "Treeseed config completed successfully.";
   const market = payload.market;
   return guidedResult({
     command: commandName,

package/dist/cli/operations-registry.js

@@ -939,14 +939,14 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
       { name: "printEnvOnly", flags: "--print-env-only", description: "Print resolved environment values, check provider connections, and exit without prompting or initializing remote resources.", kind: "boolean" },
       { name: "showSecrets", flags: "--show-secrets", description: "Print full secret values in environment reports instead of masking them.", kind: "boolean" },
       { name: "rotateMachineKey", flags: "--rotate-machine-key", description: "Regenerate the local home machine key and re-encrypt stored Treeseed secrets and remote auth sessions.", kind: "boolean" },
-      { name: "connectMarket", flags: "--connect-market", description: "Pair the current local repo to a Knowledge Coop project and register the hybrid runner connection.", kind: "boolean" },
-      { name: "marketBaseUrl", flags: "--market-base-url <url>", description: "Knowledge Coop control-plane base URL for --connect-market. Defaults to the active remote host.", kind: "string" },
-      { name: "marketTeamId", flags: "--market-team-id <id>", description: "Team ID to record in the local Knowledge Coop pairing metadata.", kind: "string" },
-      { name: "marketTeamSlug", flags: "--market-team-slug <slug>", description: "Team slug to record in the local Knowledge Coop pairing metadata.", kind: "string" },
+      { name: "connectMarket", flags: "--connect-market", description: "Pair the current local repo to a TreeSeed project and register the hybrid runner connection.", kind: "boolean" },
+      { name: "marketBaseUrl", flags: "--market-base-url <url>", description: "TreeSeed control-plane base URL for --connect-market. Defaults to the active remote host.", kind: "string" },
+      { name: "marketTeamId", flags: "--market-team-id <id>", description: "Team ID to record in the local TreeSeed pairing metadata.", kind: "string" },
+      { name: "marketTeamSlug", flags: "--market-team-slug <slug>", description: "Team slug to record in the local TreeSeed pairing metadata.", kind: "string" },
       { name: "marketProjectId", flags: "--market-project-id <id>", description: "Project ID to pair with when using --connect-market.", kind: "string" },
-      { name: "marketProjectSlug", flags: "--market-project-slug <slug>", description: "Project slug to record in the local Knowledge Coop pairing metadata.", kind: "string" },
-      { name: "marketProjectApiBaseUrl", flags: "--market-project-api-base-url <url>", description: "Override the project API base URL recorded on the Knowledge Coop project connection.", kind: "string" },
-      { name: "marketAccessToken", flags: "--market-access-token <token>", description: "Explicit Knowledge Coop access token to use for pairing. Prefer an existing remote session when possible.", kind: "string" },
+      { name: "marketProjectSlug", flags: "--market-project-slug <slug>", description: "Project slug to record in the local TreeSeed pairing metadata.", kind: "string" },
+      { name: "marketProjectApiBaseUrl", flags: "--market-project-api-base-url <url>", description: "Override the project API base URL recorded on the TreeSeed project connection.", kind: "string" },
+      { name: "marketAccessToken", flags: "--market-access-token <token>", description: "Explicit TreeSeed access token to use for pairing. Prefer an existing remote session when possible.", kind: "string" },
       { name: "rotateRunnerToken", flags: "--rotate-runner-token", description: "Rotate the project runner credential while pairing the local hybrid repo.", kind: "boolean" },
       { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
     ],
@@ -983,7 +983,7 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
         example("treeseed config --environment local --sync none --non-interactive", "Apply deterministic local config in automation", "Use the resolved current and suggested values without opening the interactive UI."),
         example("treeseed config --environment staging --print-env-only --show-secrets", "Inspect a resolved environment report", "Print the resolved staging environment with full secret visibility and exit."),
         example("treeseed config --rotate-machine-key", "Rotate the local secret encryption key", "Regenerate the machine key and re-encrypt locally stored Treeseed secrets."),
-        example("treeseed config --connect-market --market-project-id kc_proj_123", "Pair a hybrid repo to Knowledge Coop", "Register the current local repo as the hybrid runner connection for an existing Knowledge Coop project.")
+        example("treeseed config --connect-market --market-project-id kc_proj_123", "Pair a hybrid repo to TreeSeed", "Register the current local repo as the hybrid runner connection for an existing TreeSeed project.")
       ],
       optionDetails: [
         detail("--full", "Enter the advanced editor directly instead of the startup wizard."),
@@ -1001,7 +1001,7 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
         detail("--print-env", "Print the resolved environment values before remote initialization continues."),
         detail("--print-env-only", "Print the environment report and exit without interactive editing or remote initialization."),
         detail("--rotate-machine-key", "Rotate the local machine key used for encrypted Treeseed secret storage."),
-        detail("--connect-market", "Pair the current repo to a Knowledge Coop project and store the resulting market connection metadata locally.")
+        detail("--connect-market", "Pair the current repo to a TreeSeed project and store the resulting market connection metadata locally.")
       ],
       automationNotes: [
         "Use `--json` for machine-readable automation, or `--non-interactive` when you want deterministic application without interactive UI.",
@@ -1217,14 +1217,14 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
   ["test:unit", command({ examples: ["treeseed test:unit"], help: { longSummary: ["Test:unit runs workspace unit tests in dependency order."], examples: [example("treeseed test:unit", "Run unit tests", "Execute the package unit test flow."), example("trsd test:unit", "Use the short alias", "Run the same unit tests via the short entrypoint."), example("treeseed test:unit && treeseed check", "Unit tests then validation", "Combine focused tests with broader tenant validation.")] }, executionMode: "adapter" })],
   ["preflight", command({
     options: [
-      { name: "launch", flags: "--launch", description: "Validate managed Knowledge Coop launch prerequisites, provider auth, and required live configuration.", kind: "boolean" }
+      { name: "launch", flags: "--launch", description: "Validate managed TreeSeed launch prerequisites, provider auth, and required live configuration.", kind: "boolean" }
     ],
     examples: ["treeseed preflight", "treeseed preflight --launch"],
     help: {
       longSummary: ["Preflight checks local prerequisites and authentication state before heavier workflows run."],
       examples: [
         example("treeseed preflight", "Run the preflight checklist", "Inspect local prerequisites and auth readiness."),
-        example("treeseed preflight --launch", "Validate live launch readiness", "Check managed Knowledge Coop launch prerequisites before creating live GitHub, Cloudflare, and Railway resources."),
+        example("treeseed preflight --launch", "Validate live launch readiness", "Check managed TreeSeed launch prerequisites before creating live GitHub, Cloudflare, and Railway resources."),
         example("trsd preflight", "Use the short alias", "Run the same readiness check via the short entrypoint."),
         example("treeseed preflight && treeseed dev", "Validate before starting local runtime", "Confirm readiness before launching the integrated dev surface.")
       ]
@@ -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.7",
+  "version": "0.8.9",
   "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.7",
+    "@treeseed/sdk": "0.8.9",
     "ink": "^7.0.0",
     "react": "^19.2.5"
   },