@treeseed/cli 0.6.25 → 0.6.26

package/dist/cli/handlers/auth-login.js

@@ -1,25 +1,19 @@
-import { RemoteTreeseedAuthClient, RemoteTreeseedClient } from "@treeseed/sdk/remote";
 import {
-  resolveTreeseedRemoteConfig,
-  setTreeseedRemoteSession,
-  TreeseedKeyAgentError
-} from "@treeseed/sdk/workflow-support";
+  setMarketSession
+} from "@treeseed/sdk/market-client";
+import { TreeseedKeyAgentError } from "@treeseed/sdk/workflow-support";
 import { guidedResult } from "./utils.js";
+import { createMarketClientForInvocation, marketAuthRoot } from "./market-utils.js";
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 const handleAuthLogin = async (invocation, context) => {
   try {
-    const tenantRoot = context.cwd;
-    const remoteConfig = resolveTreeseedRemoteConfig(tenantRoot, context.env);
-    const hostId = typeof invocation.args.host === "string" ? invocation.args.host : remoteConfig.activeHostId;
-    const client = new RemoteTreeseedAuthClient(new RemoteTreeseedClient({
-      ...remoteConfig,
-      activeHostId: hostId
-    }));
-    const started = await client.startDeviceFlow({
+    const tenantRoot = marketAuthRoot(context);
+    const { profile, client } = createMarketClientForInvocation(invocation, context);
+    const started = await client.startDeviceLogin({
       clientName: "treeseed-cli",
-      scopes: ["auth:me", "sdk", "operations"]
+      scopes: ["auth:me", "market"]
     });
     if (context.outputFormat !== "json") {
       context.write(`Open ${started.verificationUriComplete}`, "stdout");
@@ -28,10 +22,10 @@ const handleAuthLogin = async (invocation, context) => {
     }
     const deadline = Date.parse(started.expiresAt);
     while (Date.now() < deadline) {
-      const response = await client.pollDeviceFlow({ deviceCode: started.deviceCode });
+      const response = await client.pollDeviceLogin({ deviceCode: started.deviceCode });
       if (response.ok && response.status === "approved") {
-        setTreeseedRemoteSession(tenantRoot, {
-          hostId,
+        setMarketSession(tenantRoot, {
+          marketId: profile.id,
           accessToken: response.accessToken,
           refreshToken: response.refreshToken,
           expiresAt: response.expiresAt,
@@ -41,12 +35,14 @@ const handleAuthLogin = async (invocation, context) => {
           command: "auth:login",
           summary: "Treeseed API login completed successfully.",
           facts: [
-            { label: "Host", value: hostId },
+            { label: "Market", value: profile.id },
+            { label: "URL", value: profile.baseUrl },
             { label: "Principal", value: response.principal.displayName ?? response.principal.id },
             { label: "Scopes", value: response.principal.scopes.join(", ") }
           ],
           report: {
-            hostId,
+            marketId: profile.id,
+            baseUrl: profile.baseUrl,
             principal: response.principal
           }
         });

package/dist/cli/handlers/auth-logout.js

@@ -1,20 +1,25 @@
 import {
-  clearTreeseedRemoteSession,
-  resolveTreeseedRemoteConfig,
   TreeseedKeyAgentError
 } from "@treeseed/sdk/workflow-support";
+import { clearMarketSession } from "@treeseed/sdk/market-client";
 import { guidedResult } from "./utils.js";
+import { createMarketClientForInvocation, marketAuthRoot } from "./market-utils.js";
 const handleAuthLogout = async (invocation, context) => {
   try {
-    const tenantRoot = context.cwd;
-    const remoteConfig = resolveTreeseedRemoteConfig(tenantRoot, context.env);
-    const hostId = typeof invocation.args.host === "string" ? invocation.args.host : remoteConfig.activeHostId;
-    clearTreeseedRemoteSession(tenantRoot, hostId);
+    const tenantRoot = marketAuthRoot(context);
+    const { profile, client, session } = createMarketClientForInvocation(invocation, context);
+    if (session?.accessToken) {
+      await client.logout().catch(() => null);
+    }
+    clearMarketSession(tenantRoot, profile.id);
     return guidedResult({
       command: "auth:logout",
       summary: "Cleared the local Treeseed API session.",
-      facts: [{ label: "Host", value: hostId }],
-      report: { hostId }
+      facts: [
+        { label: "Market", value: profile.id },
+        { label: "URL", value: profile.baseUrl }
+      ],
+      report: { marketId: profile.id, baseUrl: profile.baseUrl }
     });
   } catch (error) {
     if (error instanceof TreeseedKeyAgentError) {

package/dist/cli/handlers/auth-whoami.js

@@ -1,22 +1,48 @@
-import { RemoteTreeseedAuthClient, RemoteTreeseedClient } from "@treeseed/sdk/remote";
-import { resolveTreeseedRemoteConfig, TreeseedKeyAgentError } from "@treeseed/sdk/workflow-support";
+import { loadMarketRegistryState, resolveMarketSession } from "@treeseed/sdk/market-client";
+import { TreeseedKeyAgentError } from "@treeseed/sdk/workflow-support";
 import { guidedResult } from "./utils.js";
-const handleAuthWhoAmI = async (_invocation, context) => {
+import { createMarketClientForInvocation, marketAuthRoot } from "./market-utils.js";
+const handleAuthWhoAmI = async (invocation, context) => {
   try {
-    const remoteConfig = resolveTreeseedRemoteConfig(context.cwd, context.env);
-    const client = new RemoteTreeseedAuthClient(new RemoteTreeseedClient(remoteConfig));
-    const response = await client.whoAmI();
+    if (invocation.args.allMarkets === true) {
+      const tenantRoot = marketAuthRoot(context);
+      const state = loadMarketRegistryState();
+      const sessions = state.profiles.map((profile2) => ({
+        profile: profile2,
+        session: resolveMarketSession(tenantRoot, profile2.id)
+      }));
+      return guidedResult({
+        command: "auth:whoami",
+        summary: "Treeseed market identities",
+        sections: [{
+          title: "Markets",
+          lines: sessions.map(({ profile: profile2, session }) => `${profile2.id}: ${session?.principal?.displayName ?? session?.principal?.id ?? "(not logged in)"}`)
+        }],
+        report: {
+          markets: sessions.map(({ profile: profile2, session }) => ({
+            marketId: profile2.id,
+            baseUrl: profile2.baseUrl,
+            principal: session?.principal ?? null
+          }))
+        }
+      });
+    }
+    const { profile, client } = createMarketClientForInvocation(invocation, context, { requireAuth: true });
+    const response = await client.me();
     return guidedResult({
       command: "auth:whoami",
       summary: "Treeseed API identity",
       facts: [
-        { label: "Host", value: remoteConfig.activeHostId },
-        { label: "Principal", value: response.payload.displayName ?? response.payload.id },
-        { label: "Scopes", value: response.payload.scopes.join(", ") }
+        { label: "Market", value: profile.id },
+        { label: "URL", value: profile.baseUrl },
+        { label: "Principal", value: response.payload.principal.displayName ?? response.payload.principal.id },
+        { label: "Scopes", value: response.payload.principal.scopes.join(", ") }
       ],
       report: {
-        hostId: remoteConfig.activeHostId,
-        principal: response.payload
+        marketId: profile.id,
+        baseUrl: profile.baseUrl,
+        principal: response.payload.principal,
+        teams: response.payload.teams
       }
     });
   } catch (error) {

package/dist/cli/handlers/market-utils.d.ts

@@ -0,0 +1,12 @@
+import { MarketClient, type MarketProfile } from '@treeseed/sdk/market-client';
+import type { TreeseedCommandContext, TreeseedParsedInvocation } from '../types.js';
+export declare function marketAuthRoot(context: TreeseedCommandContext): string;
+export declare function marketSelector(invocation: TreeseedParsedInvocation): string | null;
+export declare function createMarketClientForInvocation(invocation: TreeseedParsedInvocation, context: TreeseedCommandContext, options?: {
+    requireAuth?: boolean;
+}): {
+    profile: MarketProfile;
+    session: import("@treeseed/sdk/market-client").MarketSession | null;
+    client: MarketClient;
+};
+export declare function formatMarketProfile(profile: MarketProfile): string;

package/dist/cli/handlers/market-utils.js

@@ -0,0 +1,39 @@
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+import {
+  MarketClient,
+  resolveMarketProfile,
+  resolveMarketSession
+} from "@treeseed/sdk/market-client";
+import { findNearestTreeseedRoot } from "@treeseed/sdk/workflow-support";
+function marketAuthRoot(context) {
+  return findNearestTreeseedRoot(context.cwd) ?? resolve(context.env.HOME || homedir());
+}
+function marketSelector(invocation) {
+  return typeof invocation.args.market === "string" ? invocation.args.market : typeof invocation.args.host === "string" ? invocation.args.host : null;
+}
+function createMarketClientForInvocation(invocation, context, options = {}) {
+  const profile = resolveMarketProfile(marketSelector(invocation));
+  const session = resolveMarketSession(marketAuthRoot(context), profile.id);
+  if (options.requireAuth && !session?.accessToken) {
+    throw new Error(`Not logged in to market "${profile.id}". Run treeseed auth:login --market ${profile.id}.`);
+  }
+  return {
+    profile,
+    session,
+    client: new MarketClient({
+      profile,
+      accessToken: session?.accessToken ?? null,
+      userAgent: "treeseed-cli"
+    })
+  };
+}
+function formatMarketProfile(profile) {
+  return `${profile.id}  ${profile.baseUrl}  ${profile.kind}${profile.teamId ? `  team=${profile.teamId}` : ""}`;
+}
+export {
+  createMarketClientForInvocation,
+  formatMarketProfile,
+  marketAuthRoot,
+  marketSelector
+};

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

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

package/dist/cli/handlers/market.js

@@ -0,0 +1,88 @@
+import {
+  addMarketProfile,
+  loadMarketRegistryState,
+  removeMarketProfile,
+  setActiveMarketProfile
+} from "@treeseed/sdk/market-client";
+import { guidedResult } from "./utils.js";
+import { createMarketClientForInvocation, formatMarketProfile } from "./market-utils.js";
+const handleMarket = async (invocation, context) => {
+  const action = invocation.positionals[0] ?? "list";
+  if (action === "list") {
+    const state = loadMarketRegistryState();
+    return guidedResult({
+      command: "market",
+      summary: "Configured Treeseed markets",
+      sections: [{
+        title: "Markets",
+        lines: state.profiles.map((profile) => `${profile.id === state.activeMarketId ? "*" : " "} ${formatMarketProfile(profile)}`)
+      }],
+      report: state
+    });
+  }
+  if (action === "add") {
+    const id = invocation.positionals[1];
+    const baseUrl = invocation.positionals[2];
+    if (!id || !baseUrl) {
+      return { exitCode: 1, stderr: ["Usage: treeseed market add <id> <url>"] };
+    }
+    const state = addMarketProfile({
+      id,
+      label: typeof invocation.args.label === "string" ? invocation.args.label : id,
+      baseUrl,
+      kind: invocation.args.kind === "central" ? "central" : "specialized",
+      teamId: typeof invocation.args.team === "string" ? invocation.args.team : null,
+      alwaysAvailable: invocation.args.kind === "central"
+    });
+    return guidedResult({
+      command: "market",
+      summary: `Added market "${id}".`,
+      report: state
+    });
+  }
+  if (action === "remove") {
+    const id = invocation.positionals[1];
+    if (!id) return { exitCode: 1, stderr: ["Usage: treeseed market remove <id>"] };
+    const state = removeMarketProfile(id);
+    return guidedResult({
+      command: "market",
+      summary: `Removed market "${id}".`,
+      report: state
+    });
+  }
+  if (action === "use") {
+    const id = invocation.positionals[1];
+    if (!id) return { exitCode: 1, stderr: ["Usage: treeseed market use <id>"] };
+    const state = setActiveMarketProfile(id);
+    return guidedResult({
+      command: "market",
+      summary: `Active market is now "${id}".`,
+      report: state
+    });
+  }
+  if (action === "status") {
+    const { profile, client, session } = createMarketClientForInvocation(invocation, context);
+    const current = await client.currentMarket().catch(() => null);
+    return guidedResult({
+      command: "market",
+      summary: "Treeseed market status",
+      facts: [
+        { label: "Market", value: profile.id },
+        { label: "URL", value: profile.baseUrl },
+        { label: "Kind", value: current?.payload.kind ?? profile.kind },
+        { label: "Authenticated", value: Boolean(session?.accessToken) }
+      ],
+      report: {
+        market: current?.payload ?? profile,
+        authenticated: Boolean(session?.accessToken)
+      }
+    });
+  }
+  return {
+    exitCode: 1,
+    stderr: [`Unknown market action: ${action}`]
+  };
+};
+export {
+  handleMarket
+};

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

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

package/dist/cli/handlers/packs.js

@@ -0,0 +1,70 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import {
+  listIntegratedMarketCatalog,
+  resolveIntegratedCatalogArtifactDownload,
+  verifyArtifactBytes
+} from "@treeseed/sdk/market-client";
+import { guidedResult } from "./utils.js";
+import { marketAuthRoot, marketSelector } from "./market-utils.js";
+function artifactFileName(kind, slug, version) {
+  return `${kind}-${slug}-${version}.tar`.replace(/[^A-Za-z0-9._-]+/g, "-");
+}
+const handlePacks = async (invocation, context) => {
+  const action = invocation.positionals[0] ?? "search";
+  const selector = marketSelector(invocation);
+  const authRoot = marketAuthRoot(context);
+  if (action === "search" || action === "list") {
+    const response = await listIntegratedMarketCatalog({
+      kind: "knowledge_pack",
+      selector,
+      authRoot,
+      userAgent: "treeseed-cli"
+    });
+    return guidedResult({
+      command: "packs",
+      summary: selector ? "Treeseed knowledge packs" : "Treeseed integrated knowledge packs",
+      sections: [{
+        title: "Packs",
+        lines: response.payload.map((pack) => `${pack.id}  ${pack.title ?? pack.name ?? pack.slug}  market=${pack.sourceMarket.label ?? pack.sourceMarket.id}`)
+      }],
+      report: { selector, packs: response.payload, errors: response.errors }
+    });
+  }
+  if (action === "install") {
+    const itemId = invocation.positionals[1];
+    const version = typeof invocation.args.version === "string" ? invocation.args.version : "1.0.0";
+    if (!itemId) return { exitCode: 1, stderr: ["Usage: treeseed packs install <item-id> [--version <version>]"] };
+    const response = await resolveIntegratedCatalogArtifactDownload({
+      itemId,
+      version,
+      selector,
+      authRoot,
+      userAgent: "treeseed-cli"
+    });
+    const download = await fetch(response.payload.downloadUrl);
+    if (!download.ok) {
+      return { exitCode: 1, stderr: [`Artifact download failed with ${download.status}.`] };
+    }
+    const bytes = await verifyArtifactBytes(download, response.payload.sha256);
+    const outputDir = resolve(context.cwd, ".treeseed", "downloads");
+    mkdirSync(outputDir, { recursive: true });
+    const outputPath = resolve(outputDir, artifactFileName(response.payload.kind, response.payload.slug ?? itemId, response.payload.version));
+    writeFileSync(outputPath, bytes);
+    return guidedResult({
+      command: "packs",
+      summary: "Downloaded knowledge pack artifact.",
+      facts: [
+        { label: "Market", value: response.payload.sourceMarket.label ?? response.payload.sourceMarket.id },
+        { label: "Pack", value: response.payload.slug ?? itemId },
+        { label: "Version", value: response.payload.version },
+        { label: "Path", value: outputPath }
+      ],
+      report: { marketId: response.payload.sourceMarket.id, artifact: response.payload, outputPath }
+    });
+  }
+  return { exitCode: 1, stderr: [`Unknown packs action: ${action}`] };
+};
+export {
+  handlePacks
+};

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

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

package/dist/cli/handlers/projects.js

@@ -0,0 +1,48 @@
+import { guidedResult } from "./utils.js";
+import { createMarketClientForInvocation } from "./market-utils.js";
+const handleProjects = async (invocation, context) => {
+  const action = invocation.positionals[0] ?? "list";
+  const { profile, client } = createMarketClientForInvocation(invocation, context, { requireAuth: true });
+  if (action === "list") {
+    const teamId = typeof invocation.args.team === "string" ? invocation.args.team : null;
+    const response = await client.projects(teamId);
+    return guidedResult({
+      command: "projects",
+      summary: "Treeseed market projects",
+      sections: [{
+        title: "Projects",
+        lines: response.payload.map((project) => `${project.id}  ${project.name ?? project.slug}  team=${project.teamId}`)
+      }],
+      report: { marketId: profile.id, teamId, projects: response.payload }
+    });
+  }
+  if (action === "access") {
+    const projectId = invocation.positionals[1];
+    if (!projectId) return { exitCode: 1, stderr: ["Usage: treeseed projects access <project-id>"] };
+    const response = await client.projectAccess(projectId);
+    return guidedResult({
+      command: "projects",
+      summary: "Treeseed market project access",
+      facts: [
+        { label: "Project", value: response.payload.projectId },
+        { label: "Staging admin", value: response.payload.team.summary.canAdminStaging },
+        { label: "Production admin", value: response.payload.team.summary.canAdminProduction }
+      ],
+      sections: [{
+        title: "Environments",
+        lines: response.payload.environments.map((entry) => `${entry.environment}: ${entry.role}`)
+      }],
+      report: { marketId: profile.id, access: response.payload }
+    });
+  }
+  if (action === "connect") {
+    return {
+      exitCode: 1,
+      stderr: ["Use treeseed config --connect-market --market-project-id <project-id> for project pairing."]
+    };
+  }
+  return { exitCode: 1, stderr: [`Unknown projects action: ${action}`] };
+};
+export {
+  handleProjects
+};

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

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

package/dist/cli/handlers/teams.js

@@ -0,0 +1,47 @@
+import { setActiveMarketProfile } from "@treeseed/sdk/market-client";
+import { guidedResult } from "./utils.js";
+import { createMarketClientForInvocation } from "./market-utils.js";
+const handleTeams = async (invocation, context) => {
+  const action = invocation.positionals[0] ?? "list";
+  const { profile, client } = createMarketClientForInvocation(invocation, context, { requireAuth: true });
+  if (action === "list") {
+    const response = await client.teams();
+    return guidedResult({
+      command: "teams",
+      summary: "Treeseed market teams",
+      sections: [{
+        title: "Teams",
+        lines: response.payload.map((team) => `${team.id}  ${team.displayName ?? team.name ?? team.slug}`)
+      }],
+      report: { marketId: profile.id, teams: response.payload }
+    });
+  }
+  if (action === "use") {
+    const teamId = invocation.positionals[1];
+    if (!teamId) return { exitCode: 1, stderr: ["Usage: treeseed teams use <team-id>"] };
+    const state = setActiveMarketProfile(profile.id);
+    return guidedResult({
+      command: "teams",
+      summary: `Selected team "${teamId}" for market "${profile.id}".`,
+      report: { marketId: profile.id, teamId, registry: state }
+    });
+  }
+  if (action === "members") {
+    const teamId = typeof invocation.args.team === "string" ? invocation.args.team : invocation.positionals[1];
+    if (!teamId) return { exitCode: 1, stderr: ["Usage: treeseed teams members <team-id>"] };
+    const response = await client.teamMembers(teamId);
+    return guidedResult({
+      command: "teams",
+      summary: "Treeseed market team members",
+      sections: [{
+        title: "Members",
+        lines: response.payload.map((member) => `${member.userId}  ${member.displayName ?? member.email ?? member.id}  ${(member.roles ?? []).join(", ")}`)
+      }],
+      report: { marketId: profile.id, teamId, members: response.payload }
+    });
+  }
+  return { exitCode: 1, stderr: [`Unknown teams action: ${action}`] };
+};
+export {
+  handleTeams
+};

package/dist/cli/handlers/template.js

@@ -1,6 +1,69 @@
 import { TreeseedOperationsSdk } from "@treeseed/sdk/operations";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import {
+  listIntegratedMarketCatalog,
+  resolveIntegratedCatalogArtifactDownload,
+  verifyArtifactBytes
+} from "@treeseed/sdk/market-client";
+import { guidedResult } from "./utils.js";
+import { marketAuthRoot, marketSelector } from "./market-utils.js";
 const operations = new TreeseedOperationsSdk();
 const handleTemplate = async (invocation, context) => {
+  if (invocation.positionals[0] === "search" || invocation.positionals[0] === "install" || typeof invocation.args.market === "string") {
+    const action = invocation.positionals[0] ?? "search";
+    const selector = marketSelector(invocation);
+    const authRoot = marketAuthRoot(context);
+    if (action === "search" || action === "list") {
+      const response = await listIntegratedMarketCatalog({
+        kind: "template",
+        selector,
+        authRoot,
+        userAgent: "treeseed-cli"
+      });
+      return guidedResult({
+        command: "template",
+        summary: selector ? "Treeseed market templates" : "Treeseed integrated market templates",
+        sections: [{
+          title: "Templates",
+          lines: response.payload.map((template) => `${template.id}  ${template.title ?? template.displayName ?? template.slug}  market=${template.sourceMarket.label ?? template.sourceMarket.id}`)
+        }],
+        report: { selector, templates: response.payload, errors: response.errors }
+      });
+    }
+    if (action === "install") {
+      const itemId = invocation.positionals[1];
+      const version = typeof invocation.args.version === "string" ? invocation.args.version : "1.0.0";
+      if (!itemId) return { exitCode: 1, stderr: ["Usage: treeseed template install <item-id> [--version <version>]"] };
+      const response = await resolveIntegratedCatalogArtifactDownload({
+        itemId,
+        version,
+        selector,
+        authRoot,
+        userAgent: "treeseed-cli"
+      });
+      const download = await fetch(response.payload.downloadUrl);
+      if (!download.ok) {
+        return { exitCode: 1, stderr: [`Artifact download failed with ${download.status}.`] };
+      }
+      const bytes = await verifyArtifactBytes(download, response.payload.sha256);
+      const outputDir = resolve(context.cwd, ".treeseed", "downloads");
+      mkdirSync(outputDir, { recursive: true });
+      const outputPath = resolve(outputDir, `template-${response.payload.slug ?? itemId}-${response.payload.version}.tar`.replace(/[^A-Za-z0-9._-]+/g, "-"));
+      writeFileSync(outputPath, bytes);
+      return guidedResult({
+        command: "template",
+        summary: "Downloaded template artifact.",
+        facts: [
+          { label: "Market", value: response.payload.sourceMarket.label ?? response.payload.sourceMarket.id },
+          { label: "Template", value: response.payload.slug ?? itemId },
+          { label: "Version", value: response.payload.version },
+          { label: "Path", value: outputPath }
+        ],
+        report: { marketId: response.payload.sourceMarket.id, artifact: response.payload, outputPath }
+      });
+    }
+  }
   const result = await operations.execute({
     operationName: "template",
     input: {

package/dist/cli/operations-registry.js

@@ -662,6 +662,7 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
   ["auth:login", command({
     options: [
       { name: "host", flags: "--host <id>", description: "Override the configured remote host id for this login.", kind: "string" },
+      { name: "market", flags: "--market <id-or-url>", description: "Limit catalog lookup to one configured market id or direct market API URL. Without this, search/install uses the integrated catalog from all configured catalog markets.", kind: "string" },
       { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
     ],
     examples: ["treeseed auth:login"],
@@ -679,6 +680,7 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
   ["auth:logout", command({
     options: [
       { name: "host", flags: "--host <id>", description: "Override the configured remote host id to clear.", kind: "string" },
+      { name: "market", flags: "--market <id-or-url>", description: "Select a configured market id or direct market API URL.", kind: "string" },
       { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
     ],
     examples: ["treeseed auth:logout"],
@@ -694,7 +696,11 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
     handlerName: "auth:logout"
   })],
   ["auth:whoami", command({
-    options: [{ name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }],
+    options: [
+      { name: "market", flags: "--market <id-or-url>", description: "Select a configured market id or direct market API URL.", kind: "string" },
+      { name: "allMarkets", flags: "--all-markets", description: "Show locally stored identities for all configured markets.", kind: "boolean" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
     examples: ["treeseed auth:whoami"],
     help: {
       longSummary: ["Auth:whoami shows the currently active Treeseed API identity so you can verify which account and host context the CLI is using."],
@@ -790,10 +796,15 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
       { name: "action", description: "Template action: list, show, or validate.", required: false },
       { name: "id", description: "Template id for show or validate.", required: false }
     ],
+    options: [
+      { name: "market", flags: "--market <id-or-url>", description: "Select a configured market id or direct market API URL.", kind: "string" },
+      { name: "version", flags: "--version <version>", description: "Artifact version for market template install.", kind: "string" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
     examples: ["treeseed template", "treeseed template list", "treeseed template show starter-basic", "treeseed template validate"],
     help: {
       longSummary: [
-        "Template exposes the Treeseed starter catalog so you can list, inspect, and validate starter definitions before using them for initialization or distribution work."
+        "Template exposes local starter catalog actions and market-backed search/install actions. Market search/install uses an integrated catalog from central and configured specialized markets, with every result labeled by source market."
       ],
       examples: [
         example("treeseed template", "Default to the catalog list", "Show the available starters without specifying an action."),
@@ -1201,6 +1212,120 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
   ["starlight:patch", command({ examples: ["treeseed starlight:patch"], executionMode: "adapter" })]
 ]);
 const CLI_ONLY_OPERATION_SPECS = [
+  {
+    id: "market.registry",
+    name: "market",
+    aliases: [],
+    group: "Utilities",
+    summary: "Manage configured Treeseed market API endpoints.",
+    description: "List, add, select, remove, and inspect market API profiles stored in local machine configuration.",
+    provider: "default",
+    related: ["auth:login", "teams", "projects"],
+    usage: "treeseed market [list|add|use|remove|status]",
+    arguments: [{ name: "action", description: "Market 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: "label", flags: "--label <label>", description: "Display label for market add.", kind: "string" },
+      { name: "kind", flags: "--kind <kind>", description: "Market kind for market add.", kind: "enum", values: ["central", "specialized"] },
+      { name: "team", flags: "--team <team-id>", description: "Team id for a specialized market profile.", kind: "string" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ["treeseed market list", "treeseed market add enterprise https://market.example.com", "treeseed market use central"],
+    help: {
+      longSummary: ["Market manages local Treeseed market API profiles. It never serves market behavior itself; it only selects endpoints the SDK market client should call."],
+      whenToUse: ["Use this when you need to add an enterprise market, switch back to central, or inspect which market endpoint CLI commands will target."],
+      beforeYouRun: ["Decide whether you are managing the always-available central profile or a team-specific specialized market profile."],
+      automationNotes: ["Use `--json` when scripts need the active market id, URL, and configured profiles."]
+    },
+    helpVisible: true,
+    helpFeatured: false,
+    executionMode: "handler",
+    handlerName: "market"
+  },
+  {
+    id: "market.teams",
+    name: "teams",
+    aliases: [],
+    group: "Utilities",
+    summary: "Inspect teams from the selected market.",
+    description: "List teams, select a team context, and inspect team membership through the market API client.",
+    provider: "default",
+    related: ["market", "auth:login", "projects"],
+    usage: "treeseed teams [list|use|members]",
+    arguments: [{ name: "action", description: "Teams 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 member lookup.", kind: "string" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ["treeseed teams list", "treeseed teams members team_123"],
+    help: {
+      longSummary: ["Teams reads team membership data from the selected market API using the SDK market client."],
+      whenToUse: ["Use this after login to confirm team membership or inspect who belongs to a market-owned team."],
+      beforeYouRun: ["Authenticate to the selected market with `treeseed auth:login --market <id>` before reading private team data."],
+      automationNotes: ["Use `--json` for scripts that need stable team or member arrays."]
+    },
+    helpVisible: true,
+    helpFeatured: false,
+    executionMode: "handler",
+    handlerName: "teams"
+  },
+  {
+    id: "market.projects",
+    name: "projects",
+    aliases: [],
+    group: "Utilities",
+    summary: "Inspect projects and access controls from the selected market.",
+    description: "List market projects and inspect staging/production access through the market API client.",
+    provider: "default",
+    related: ["market", "teams", "config"],
+    usage: "treeseed projects [list|access|connect]",
+    arguments: [{ name: "action", description: "Projects 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: "Limit project list to a team.", kind: "string" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ["treeseed projects list", "treeseed projects access project_123"],
+    help: {
+      longSummary: ["Projects reads project and environment access data from the selected market API using the SDK market client."],
+      whenToUse: ["Use this to confirm which market projects you can see and whether your account has staging or production admin access."],
+      beforeYouRun: ["Authenticate to the market and know the project id when inspecting a single project access summary."],
+      automationNotes: ["Use `--json` to capture project lists and access summaries for automation."]
+    },
+    helpVisible: true,
+    helpFeatured: false,
+    executionMode: "handler",
+    handlerName: "projects"
+  },
+  {
+    id: "market.packs",
+    name: "packs",
+    aliases: [],
+    group: "Utilities",
+    summary: "Search and download market knowledge packs.",
+    description: "Search knowledge packs and download artifact versions through the integrated market catalog or a selected market API.",
+    provider: "default",
+    related: ["market", "template"],
+    usage: "treeseed packs [search|install] [id]",
+    arguments: [{ name: "action", description: "Packs action.", required: false }],
+    options: [
+      { name: "market", flags: "--market <id-or-url>", description: "Limit catalog lookup to one configured market id or direct market API URL. Without this, search/install uses the integrated catalog from all configured catalog markets.", kind: "string" },
+      { name: "version", flags: "--version <version>", description: "Artifact version for install.", kind: "string" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ["treeseed packs search", "treeseed packs install pack_123 --version 1.0.0"],
+    help: {
+      longSummary: ["Packs searches and downloads knowledge pack artifacts from the integrated catalog formed by central and configured specialized markets."],
+      whenToUse: ["Use this when a project should install a market-published knowledge bundle rather than a local fixture."],
+      beforeYouRun: ["Choose the market and artifact version; private packs require an authenticated market session."],
+      automationNotes: ["Use `--json` to capture artifact metadata and the downloaded file path."]
+    },
+    helpVisible: true,
+    helpFeatured: false,
+    executionMode: "handler",
+    handlerName: "packs"
+  },
   {
     id: "agents.run",
     name: "agents",

package/dist/cli/registry.d.ts

@@ -24,6 +24,10 @@ export declare const COMMAND_HANDLERS: {
     readonly 'auth:login': import("./operations-types.js").TreeseedCommandHandler;
     readonly 'auth:logout': import("./operations-types.js").TreeseedCommandHandler;
     readonly 'auth:whoami': import("./operations-types.js").TreeseedCommandHandler;
+    readonly market: import("./operations-types.js").TreeseedCommandHandler;
+    readonly teams: import("./operations-types.js").TreeseedCommandHandler;
+    readonly projects: import("./operations-types.js").TreeseedCommandHandler;
+    readonly packs: import("./operations-types.js").TreeseedCommandHandler;
     readonly 'secrets:status': import("./operations-types.js").TreeseedCommandHandler;
     readonly 'secrets:unlock': import("./operations-types.js").TreeseedCommandHandler;
     readonly 'secrets:lock': import("./operations-types.js").TreeseedCommandHandler;

package/dist/cli/registry.js

@@ -19,6 +19,10 @@ import { handleSync } from "./handlers/sync.js";
 import { handleAuthLogin } from "./handlers/auth-login.js";
 import { handleAuthLogout } from "./handlers/auth-logout.js";
 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 { handlePacks } from "./handlers/packs.js";
 import {
   handleSecretsLock,
   handleSecretsMigrateKey,
@@ -62,6 +66,10 @@ const COMMAND_HANDLERS = {
   "auth:login": handleAuthLogin,
   "auth:logout": handleAuthLogout,
   "auth:whoami": handleAuthWhoAmI,
+  market: handleMarket,
+  teams: handleTeams,
+  projects: handleProjects,
+  packs: handlePacks,
   "secrets:status": handleSecretsStatus,
   "secrets:unlock": handleSecretsUnlock,
   "secrets:lock": handleSecretsLock,

package/dist/cli/runtime.js

@@ -333,7 +333,19 @@ function formatProjectError(spec) {
   ].join("\n");
 }
 function commandNeedsProjectRoot(spec) {
-  return spec.name !== "init" && spec.name !== "export" && spec.name !== "install";
+  return !(/* @__PURE__ */ new Set([
+    "init",
+    "export",
+    "install",
+    "auth:login",
+    "auth:logout",
+    "auth:whoami",
+    "market",
+    "teams",
+    "projects",
+    "packs",
+    "template"
+  ])).has(spec.name);
 }
 function resolveTreeseedCommandCwd(spec, cwd) {
   if (!commandNeedsProjectRoot(spec)) {

package/package.json

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