@treeseed/cli 0.10.5 → 0.10.6

package/dist/cli/handlers/capacity.js

@@ -4,6 +4,7 @@ import { resolve } from "node:path";
 import { resolveCapacityProviderLaunchEnvironment } from "@treeseed/sdk/capacity-provider";
 import { resolveMarketProfile } from "@treeseed/sdk/market-client";
 import { findNearestTreeseedRoot, findNearestTreeseedWorkspaceRoot } from "@treeseed/sdk/workflow-support";
+import { createMarketClientForInvocation } from "./market-utils.js";
 import { fail, guidedResult } from "./utils.js";
 const ENTRYPOINT_RELATIVE_PATH = ["dist", "provider", "entrypoint.js"];
 const COMPOSE_FILE_NAME = "compose.capacity-provider.yml";
@@ -11,6 +12,7 @@ const DEFAULT_PROJECT_NAME = "treeseed-capacity-provider";
 const DEFAULT_HOST_DATA_DIR = ".treeseed/local-capacity-provider/data";
 const PROVIDER_LIFECYCLE_ACTIONS = /* @__PURE__ */ new Set(["build", "up", "down", "restart", "logs", "status", "test-local"]);
 const PROVIDER_ENTRYPOINT_ACTIONS = /* @__PURE__ */ new Set(["doctor", "register", "plan"]);
+const MARKET_CAPACITY_ACTIONS = /* @__PURE__ */ new Set(["migrate"]);
 function stringArg(invocation, name) {
   const value = invocation.args[name];
   return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
@@ -18,6 +20,24 @@ function stringArg(invocation, name) {
 function boolArg(invocation, name) {
   return invocation.args[name] === true;
 }
+function numberArg(invocation, name) {
+  const value = invocation.args[name];
+  if (typeof value === "number" && Number.isFinite(value)) return value;
+  if (typeof value === "string" && value.trim().length > 0 && Number.isFinite(Number(value))) return Number(value);
+  return null;
+}
+function formatNumber(value, digits = 2) {
+  if (value === null || value === void 0 || value === "") return "n/a";
+  const numeric = Number(value);
+  if (!Number.isFinite(numeric)) return String(value);
+  return numeric.toLocaleString("en-US", { maximumFractionDigits: digits });
+}
+function recordValue(record, key) {
+  return record && typeof record === "object" && key in record ? record[key] : void 0;
+}
+function marketRequest(client, path, options = {}) {
+  return client.request(path, options);
+}
 function readPackageName(packageRoot) {
   const packageJsonPath = resolve(packageRoot, "package.json");
   if (!existsSync(packageJsonPath)) return null;
@@ -108,6 +128,212 @@ function composeCommandArgs(composeFilePath, projectName, action) {
       return base;
   }
 }
+function nativeBudgetSummaryLines(report) {
+  const budgets = recordValue(report, "budgets");
+  const nativeCapacity = recordValue(budgets, "nativeCapacity") ?? recordValue(budgets, "native_capacity");
+  const executionProviders = recordValue(nativeCapacity, "executionProviders") ?? recordValue(nativeCapacity, "execution_providers");
+  if (!Array.isArray(executionProviders)) return [];
+  return executionProviders.flatMap((provider) => {
+    const name = recordValue(provider, "name") ?? recordValue(provider, "id") ?? "execution provider";
+    const kind = recordValue(provider, "kind") ?? "custom";
+    const nativeUnit = recordValue(provider, "nativeUnit") ?? recordValue(provider, "native_unit") ?? "native unit";
+    const workers = recordValue(provider, "maxConcurrentWorkers") ?? recordValue(provider, "max_concurrent_workers");
+    const limits = recordValue(provider, "nativeLimits") ?? recordValue(provider, "native_limits");
+    const lines = [`${name}: ${kind}, ${nativeUnit}${workers ? `, workers ${workers}` : ""}`];
+    if (Array.isArray(limits)) {
+      for (const limit of limits) {
+        lines.push(`  ${recordValue(limit, "scope") ?? recordValue(limit, "limitScope") ?? "limit"}: ${formatNumber(recordValue(limit, "limitAmount") ?? recordValue(limit, "limit_amount"))} ${recordValue(limit, "nativeUnit") ?? nativeUnit}, reserve ${formatNumber(recordValue(limit, "reserveBufferPercent") ?? recordValue(limit, "reserve_buffer_percent"))}%`);
+      }
+    }
+    return lines;
+  });
+}
+function derivedCapacityLines(plan) {
+  const derivedCapacity = recordValue(plan, "derivedCapacity");
+  const entries = recordValue(derivedCapacity, "entries");
+  if (!Array.isArray(entries) || entries.length === 0) {
+    return ["No derived native capacity entries are available yet."];
+  }
+  return entries.map((entry) => [
+    `${recordValue(entry, "executionProviderKind") ?? "provider"}:${recordValue(entry, "nativeUnit") ?? "native"}`,
+    `limit ${formatNumber(recordValue(entry, "configuredNativeLimit"))}`,
+    `observed ${formatNumber(recordValue(entry, "observedNativeRemaining"))}`,
+    `reserved ${formatNumber(recordValue(entry, "activeReservedNativeAmount"))}`,
+    `reserve ${formatNumber(recordValue(entry, "reserveBufferPercent"))}%`,
+    `conversion ${formatNumber(recordValue(entry, "nativeUnitsPerCredit"))} native/credit`,
+    `derived ${formatNumber(recordValue(entry, "derivedAvailableCredits"))} credits`,
+    `confidence ${recordValue(entry, "confidence") ?? "unknown"}`
+  ].join(" | "));
+}
+function grantAllocationLines(plan) {
+  const grants = recordValue(plan, "grants");
+  if (!Array.isArray(grants) || grants.length === 0) return [];
+  return grants.map((grant) => [
+    `${recordValue(grant, "grantScope") ?? "grant"} ${recordValue(grant, "environment") ?? "all"}`,
+    `allocation ${formatNumber(recordValue(grant, "portfolioAllocationPercent"))}%`,
+    `reserve pool ${formatNumber(recordValue(grant, "reservePoolPercent"))}%`,
+    `max daily project credits ${formatNumber(recordValue(grant, "maxDailyProjectCredits"))}`,
+    `overflow ${recordValue(grant, "overflowPolicy") ?? "soft_grant"}`,
+    `emergency ${recordValue(grant, "emergencyOverride") === true ? "on" : "off"}`
+  ].join(" | "));
+}
+async function runProjectCapacityPlan(invocation, context) {
+  const projectId = stringArg(invocation, "project");
+  if (!projectId) return fail("Missing --project. Use `trsd capacity plan --project <project-id> --environment local`.");
+  const { profile, client } = createMarketClientForInvocation(invocation, context, { requireAuth: true });
+  const environment = environmentSelector(invocation);
+  const response = await marketRequest(
+    client,
+    `/v1/projects/${encodeURIComponent(projectId)}/capacity-plan?environment=${encodeURIComponent(environment)}`,
+    { requireAuth: true }
+  );
+  const plan = response.payload;
+  return guidedResult({
+    command: "capacity plan",
+    summary: `Capacity plan for project ${projectId} in ${environment}.`,
+    facts: [
+      { label: "Market", value: `${profile.id} (${profile.baseUrl})` },
+      { label: "Project", value: projectId },
+      { label: "Environment", value: environment },
+      { label: "Derived credits", value: formatNumber(recordValue(recordValue(plan, "derivedCapacity"), "totalDerivedAvailableCredits")) }
+    ],
+    sections: [
+      { title: "Native projection", lines: derivedCapacityLines(plan) },
+      { title: "Allocation grants", lines: grantAllocationLines(plan) }
+    ],
+    report: { action: "plan", projectId, environment, market: { id: profile.id, baseUrl: profile.baseUrl }, plan }
+  });
+}
+function providerMatcher(selector) {
+  return (provider) => {
+    const id = String(recordValue(provider, "id") ?? "");
+    const name = String(recordValue(provider, "name") ?? "");
+    return id === selector || name === selector;
+  };
+}
+function migrationMissingFields(invocation) {
+  const missing = [];
+  if (!stringArg(invocation, "team")) missing.push("--team");
+  if (!stringArg(invocation, "provider")) missing.push("--provider");
+  if (!stringArg(invocation, "kind")) missing.push("--kind");
+  if (!stringArg(invocation, "nativeUnit")) missing.push("--native-unit");
+  if (numberArg(invocation, "limit") === null) missing.push("--limit");
+  return missing;
+}
+async function runMigrateToDerived(invocation, context) {
+  if (!boolArg(invocation, "toDerived")) {
+    return fail("Missing --to-derived. Phase 8 supports `trsd capacity migrate --to-derived`.");
+  }
+  const missing = migrationMissingFields(invocation);
+  const example = "trsd capacity migrate --to-derived --team team_123 --provider provider_123 --kind codex_subscription --native-unit wall_minute --limit 480 --scope daily --reset-cadence daily --quota-visibility opaque --reserve-buffer-percent 20 --max-concurrent-workers 4 --project project_123 --portfolio-allocation-percent 100 --dry-run";
+  if (missing.length > 0) {
+    return fail(`Missing native capacity facts: ${missing.join(", ")}.
+Example: ${example}`);
+  }
+  const teamId = stringArg(invocation, "team");
+  const providerSelectorValue = stringArg(invocation, "provider");
+  const kind = stringArg(invocation, "kind");
+  const nativeUnit = stringArg(invocation, "nativeUnit");
+  const limitAmount = numberArg(invocation, "limit");
+  const scope = stringArg(invocation, "scope") ?? "daily";
+  const resetCadence = stringArg(invocation, "resetCadence") ?? "daily";
+  const quotaVisibility = stringArg(invocation, "quotaVisibility") ?? "opaque";
+  const reserveBufferPercent = numberArg(invocation, "reserveBufferPercent") ?? 20;
+  const maxConcurrentWorkers = Math.max(1, Math.floor(numberArg(invocation, "maxConcurrentWorkers") ?? 1));
+  const environment = environmentSelector(invocation);
+  const projectId = stringArg(invocation, "project");
+  const allocationPercent = numberArg(invocation, "portfolioAllocationPercent");
+  const dryRun = boolArg(invocation, "dryRun");
+  const { profile, client } = createMarketClientForInvocation(invocation, context, { requireAuth: !dryRun });
+  const providerList = dryRun ? { payload: [{ id: providerSelectorValue, name: providerSelectorValue }] } : await marketRequest(
+    client,
+    `/v1/teams/${encodeURIComponent(teamId)}/capacity-providers`,
+    { requireAuth: true }
+  );
+  const provider = providerList.payload.find(providerMatcher(providerSelectorValue));
+  if (!provider) return fail(`Capacity provider "${providerSelectorValue}" was not found in team ${teamId}.`);
+  const providerId = String(recordValue(provider, "id"));
+  const executionProvider = {
+    name: `${kind.replace(/_/gu, " ")} ${nativeUnit}`,
+    kind,
+    nativeUnit,
+    quotaVisibility,
+    maxConcurrentWorkers,
+    resetCadence,
+    nativeLimits: [{
+      scope,
+      nativeUnit,
+      limitAmount,
+      reserveBufferPercent,
+      resetCadence,
+      confidence: "estimated",
+      source: "operator_migration"
+    }],
+    metadata: {
+      source: "trsd capacity migrate --to-derived",
+      staticCreditBudgetsPreservedAs: "hybrid_fallback_cap"
+    }
+  };
+  const grant = allocationPercent === null ? null : {
+    capacityProviderId: providerId,
+    teamId,
+    projectId,
+    environment,
+    grantScope: projectId ? "project" : "team",
+    portfolioAllocationPercent: allocationPercent,
+    overflowPolicy: "soft_grant",
+    metadata: {
+      source: "trsd capacity migrate --to-derived"
+    }
+  };
+  if (!dryRun) {
+    await marketRequest(client, `/v1/teams/${encodeURIComponent(teamId)}/capacity-providers/${encodeURIComponent(providerId)}`, {
+      method: "PATCH",
+      body: {
+        name: String(recordValue(provider, "name") ?? providerId),
+        creditBudgetMode: "hybrid"
+      },
+      requireAuth: true
+    });
+    await marketRequest(client, `/v1/teams/${encodeURIComponent(teamId)}/capacity-providers/${encodeURIComponent(providerId)}/execution-providers`, {
+      method: "POST",
+      body: executionProvider,
+      requireAuth: true
+    });
+    if (grant) {
+      await marketRequest(client, `/v1/teams/${encodeURIComponent(teamId)}/capacity-grants`, {
+        method: "POST",
+        body: grant,
+        requireAuth: true
+      });
+    }
+  }
+  return guidedResult({
+    command: "capacity migrate",
+    summary: dryRun ? "Dry run: derived native capacity migration plan." : "Derived native capacity migration applied.",
+    facts: [
+      { label: "Market", value: `${profile.id} (${profile.baseUrl})` },
+      { label: "Team", value: teamId },
+      { label: "Provider", value: providerId },
+      { label: "Native limit", value: `${formatNumber(limitAmount)} ${nativeUnit} / ${scope}` },
+      { label: "Reserve buffer", value: `${formatNumber(reserveBufferPercent)}%` },
+      { label: "Allocation percent", value: allocationPercent === null ? null : `${formatNumber(allocationPercent)}%` },
+      { label: "Dry run", value: dryRun }
+    ],
+    sections: [
+      { title: "Execution provider", lines: [`${executionProvider.name}: ${kind}, ${nativeUnit}, ${maxConcurrentWorkers} workers, ${quotaVisibility} quota visibility`] },
+      ...grant ? [{ title: "Allocation grant", lines: [`${grant.grantScope} ${projectId ?? teamId} in ${environment}: ${formatNumber(allocationPercent)}%`] }] : []
+    ],
+    report: {
+      action: "migrate",
+      dryRun,
+      teamId,
+      providerId,
+      executionProvider,
+      grant
+    }
+  });
+}
 function lifecycleActionRequiresConnection(action) {
   return action === "up" || action === "restart";
 }
@@ -256,6 +482,7 @@ function invokeProviderEntrypoint(action, invocation, context) {
     ],
     sections: [
       { title: "Output", lines: stdout ? stdout.split(/\r?\n/u) : [] },
+      { title: "Native budget file", lines: nativeBudgetSummaryLines(report) },
       { title: "Errors", lines: stderr ? stderr.split(/\r?\n/u) : [] }
     ],
     exitCode: result.status ?? 1,
@@ -268,6 +495,21 @@ function invokeProviderEntrypoint(action, invocation, context) {
 }
 const handleCapacity = (invocation, context) => {
   const action = invocation.positionals[0] ?? "doctor";
+  if (action === "plan" && stringArg(invocation, "project")) {
+    try {
+      return runProjectCapacityPlan(invocation, context);
+    } catch (error) {
+      return fail(error instanceof Error ? error.message : String(error));
+    }
+  }
+  if (MARKET_CAPACITY_ACTIONS.has(action)) {
+    try {
+      if (action === "migrate") return runMigrateToDerived(invocation, context);
+      return fail(`Unknown capacity action "${action}".`);
+    } catch (error) {
+      return fail(error instanceof Error ? error.message : String(error));
+    }
+  }
   if (PROVIDER_LIFECYCLE_ACTIONS.has(action)) {
     try {
       return runLifecycleAction(action, invocation, context);
@@ -282,7 +524,7 @@ const handleCapacity = (invocation, context) => {
       return fail(error instanceof Error ? error.message : String(error));
     }
   }
-  return fail(`Unknown capacity action "${action}". Use doctor, register, plan, build, up, down, restart, logs, status, or test-local.`);
+  return fail(`Unknown capacity action "${action}". Use doctor, register, plan, migrate, build, up, down, restart, logs, status, or test-local.`);
 };
 export {
   handleCapacity

package/dist/cli/operations-registry.js

@@ -1523,16 +1523,28 @@ const CLI_ONLY_OPERATION_SPECS = [
     name: "capacity",
     aliases: [],
     group: "Utilities",
-    summary: "Operate the package-owned capacity provider runtime.",
-    description: "Run provider diagnostics, registration, and planning through the built @treeseed/agent capacity provider entrypoint.",
+    summary: "Inspect capacity plans and operate the package-owned capacity provider runtime.",
+    description: "Read Market capacity plans, migrate static providers to derived native capacity, and run provider diagnostics through the built @treeseed/agent entrypoint.",
     provider: "default",
     related: ["teams", "projects", "agents"],
-    usage: "treeseed capacity [doctor|register|plan|up|down|restart|logs|status|build|test-local]",
+    usage: "treeseed capacity [doctor|register|plan|migrate|up|down|restart|logs|status|build|test-local]",
     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: "provider", flags: "--provider <provider-id>", description: "Provider id or local provider selector for diagnostics.", kind: "string" },
+      { name: "team", flags: "--team <team-id>", description: "Team id for Market capacity migration.", kind: "string" },
+      { name: "project", flags: "--project <project-id>", description: "Project id for Market capacity plan or allocation migration.", kind: "string" },
       { name: "environment", flags: "--environment <scope>", description: "Treeseed config scope used when resolving encrypted provider launch values.", kind: "enum", values: ["local", "staging", "prod"] },
+      { name: "toDerived", flags: "--to-derived", description: "Migrate a static provider to derived native capacity facts.", kind: "boolean" },
+      { name: "kind", flags: "--kind <provider-kind>", description: "Execution provider kind such as codex_subscription or openrouter.", kind: "string" },
+      { name: "nativeUnit", flags: "--native-unit <unit>", description: "Native unit humans can forecast, such as wall_minute, usd, or billable_token.", kind: "string" },
+      { name: "limit", flags: "--limit <amount>", description: "Native limit amount for the selected scope.", kind: "string" },
+      { name: "scope", flags: "--scope <scope>", description: "Native limit scope, usually daily or monthly.", kind: "string" },
+      { name: "resetCadence", flags: "--reset-cadence <cadence>", description: "Native limit reset cadence.", kind: "string" },
+      { name: "quotaVisibility", flags: "--quota-visibility <mode>", description: "Whether quota remaining is visible, sampled, or opaque.", kind: "string" },
+      { name: "reserveBufferPercent", flags: "--reserve-buffer-percent <percent>", description: "Native reserve buffer percentage.", kind: "string" },
+      { name: "maxConcurrentWorkers", flags: "--max-concurrent-workers <count>", description: "Maximum workers this execution provider can run concurrently.", kind: "string" },
+      { name: "portfolioAllocationPercent", flags: "--portfolio-allocation-percent <percent>", description: "Optional project/team allocation percent to create during migration.", kind: "string" },
       { name: "dataDir", flags: "--data-dir <path>", description: "Host data directory mounted into the provider container at /data.", kind: "string" },
       { name: "agentPackageRoot", flags: "--agent-package-root <path>", description: "Path to a built @treeseed/agent package root.", kind: "string" },
       { name: "diagnostic", flags: "--diagnostic", description: "Start lifecycle commands without live Market registration or provider credentials.", kind: "boolean" },
@@ -1541,8 +1553,10 @@ const CLI_ONLY_OPERATION_SPECS = [
     ],
     examples: [
       "treeseed capacity doctor --market local --provider local",
+      "treeseed capacity plan --market local --project project_123 --environment local",
       "treeseed capacity register --market local --provider local --dry-run --json",
       "treeseed capacity plan --market local --provider local --dry-run --json",
+      "treeseed capacity migrate --to-derived --market local --team team_123 --provider provider_123 --kind codex_subscription --native-unit wall_minute --limit 480 --scope daily --dry-run",
       "treeseed capacity build",
       "treeseed capacity up --market local --provider local",
       "treeseed capacity up --market local --provider local --diagnostic",
@@ -1552,8 +1566,8 @@ const CLI_ONLY_OPERATION_SPECS = [
       "treeseed capacity test-local"
     ],
     help: {
-      longSummary: ["Capacity invokes the package-owned @treeseed/agent provider runtime for local diagnostics, registration previews, portfolio planning, and Docker/Compose lifecycle commands."],
-      whenToUse: ["Use this when validating a self-hosted capacity provider install, checking provider runtime output, or running the local provider stack."],
+      longSummary: ["Capacity reads Market project capacity plans, migrates provider setup toward derived native facts, and invokes the package-owned @treeseed/agent provider runtime for local diagnostics and Docker/Compose lifecycle commands."],
+      whenToUse: ["Use this when inspecting native-to-credit projection, validating a self-hosted capacity provider install, checking provider runtime output, or running the local provider stack."],
       beforeYouRun: ["Build @treeseed/agent first, or pass --agent-package-root to a built package. Use `trsd config` for encrypted provider values; capacity commands do not write plaintext env files."],
       automationNotes: ["Use `--json` for stable provider runtime output. `up` runs live local provider mode by default; pass `--diagnostic` or use `test-local` for diagnostics without provider secrets."]
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/cli",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "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": "github:treeseed-ai/sdk#0.10.11",
+    "@treeseed/sdk": "github:treeseed-ai/sdk#0.10.12",
     "ink": "^7.0.0",
     "react": "^19.2.5"
   },