@01.software/cli 0.10.0 → 0.10.3

package/dist/mcp/vercel.js

@@ -1,7 +1,7 @@
 // src/handler.ts
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 
-// ../../packages/auth-contracts/dist/index.js
+// ../../packages/auth-contracts/src/index.ts
 var MCP_RESOURCE_AUDIENCE = "https://mcp.01.software/mcp";
 var MCP_OAUTH_ISSUER = "https://01.software";
 var MCP_PROTECTED_RESOURCE_METADATA_PATH = "/.well-known/oauth-protected-resource/mcp";
@@ -125,6 +125,77 @@ var tenantContextResponseSchema = z.object({
     webhookConfigured: z.boolean()
   }).strict().optional()
 }).strict();
+var tenantFeatureProgressFeatureSchema = z.enum(["ecommerce"]);
+var tenantFeatureProgressInputSchema = z.object({
+  feature: tenantFeatureProgressFeatureSchema.describe(
+    "Feature to inspect for tenant implementation readiness"
+  ),
+  includeEvidence: z.boolean().optional().default(false).describe("Include sanitized counts and static surface evidence")
+}).strict();
+var tenantFeatureProgressStatusSchema = z.enum([
+  "ready",
+  "attention",
+  "blocked"
+]);
+var tenantFeatureProgressItemStateSchema = z.enum([
+  "complete",
+  "incomplete",
+  "blocked",
+  "attention",
+  "optional",
+  "unknown",
+  "manual",
+  "not-applicable"
+]);
+var tenantFeatureProgressSeveritySchema = z.enum([
+  "required",
+  "recommended",
+  "optional"
+]);
+var tenantFeatureProgressEvidenceValueSchema = z.union([
+  z.string(),
+  z.number(),
+  z.boolean(),
+  z.null()
+]);
+var tenantFeatureProgressItemSchema = z.object({
+  id: z.string(),
+  title: z.string(),
+  state: tenantFeatureProgressItemStateSchema,
+  severity: tenantFeatureProgressSeveritySchema,
+  summary: z.string(),
+  evidence: z.record(z.string(), tenantFeatureProgressEvidenceValueSchema).optional()
+}).strict();
+var tenantFeatureProgressGroupSchema = z.object({
+  id: z.string(),
+  title: z.string(),
+  summary: z.string().optional(),
+  items: z.array(tenantFeatureProgressItemSchema)
+}).strict();
+var tenantFeatureProgressResponseSchema = z.object({
+  schemaVersion: z.literal(1),
+  feature: tenantFeatureProgressFeatureSchema,
+  status: tenantFeatureProgressStatusSchema,
+  generatedAt: z.string(),
+  tenant: z.object({
+    id: z.string(),
+    name: z.string(),
+    plan: z.string()
+  }).strict(),
+  capability: z.object({
+    effectiveFeatures: z.array(z.string()),
+    planBlocked: z.array(z.string()),
+    closureAdded: z.array(z.string())
+  }).strict(),
+  summary: z.object({
+    complete: z.number().int().nonnegative(),
+    total: z.number().int().nonnegative(),
+    blocking: z.number().int().nonnegative(),
+    manual: z.number().int().nonnegative(),
+    unknown: z.number().int().nonnegative()
+  }).strict(),
+  groups: z.array(tenantFeatureProgressGroupSchema)
+}).strict();
 var COLLECTION_SCHEMA_CONTRACT_VERSION = 1;
 var collectionSchemaEndpointParamsSchema = z.object({
   collectionSlug: z.string().min(1, "collectionSlug is required")
@@ -190,6 +261,29 @@ var updateTransactionSchema = z2.object({
   amount: z2.number().int().positive().optional().describe("Provider-confirmed amount for verified paid confirmation")
 }).strict();
 var UpdateTransactionSchema = updateTransactionSchema;
+var providerSlugSchema = z2.string().trim().regex(/^[a-z0-9][a-z0-9_-]{0,63}$/, "pgProvider must be lowercase slug");
+var confirmPaymentSchema = z2.object({
+  orderNumber: z2.string().min(1).optional(),
+  pgPaymentId: z2.string().min(1, "pgPaymentId is required").describe("Provider payment identifier stored on the transaction"),
+  pgProvider: providerSlugSchema.describe(
+    "Payment provider slug, e.g. toss, portone, stripe"
+  ),
+  pgOrderId: z2.string().min(1).optional(),
+  amount: z2.number().int().nonnegative("amount must be non-negative").describe("Provider-confirmed amount in minor units"),
+  currency: z2.string().min(1).optional(),
+  paymentMethod: z2.string().optional(),
+  receiptUrl: z2.string().url().optional(),
+  approvedAt: z2.string().optional(),
+  providerStatus: z2.string().optional(),
+  providerEventId: z2.string().min(1).optional(),
+  confirmationSource: z2.enum([
+    "provider_webhook",
+    "provider_lookup",
+    "provider_api_confirm",
+    "manual_server"
+  ]).optional(),
+  metadata: z2.record(z2.string(), z2.unknown()).optional()
+}).strict();
 var returnReasonSchema = z2.enum([
   "change_of_mind",
   "defective",
@@ -201,7 +295,8 @@ var restockActionSchema = z2.enum(["return_to_stock", "discard"]);
 var returnWithRefundItemSchema = z2.object({
   orderItem: z2.union([z2.string(), z2.number()]).transform(String),
   quantity: z2.number().int().positive("quantity must be a positive integer"),
-  restockAction: restockActionSchema.default("return_to_stock")
+  restockAction: restockActionSchema.default("return_to_stock"),
+  restockingFee: z2.number().min(0, "restockingFee must be non-negative").optional().describe("Restocking fee charged for this line (ADR 0005 \xA7Gap 1)")
 }).strict();
 var returnWithRefundSchema = z2.object({
   orderNumber: z2.string().min(1, "orderNumber is required").describe("Order number (required)"),
@@ -209,6 +304,7 @@ var returnWithRefundSchema = z2.object({
   reasonDetail: z2.string().optional().describe("Detailed reason text (optional)"),
   returnItems: z2.array(returnWithRefundItemSchema).min(1, "At least one return item is required").max(100, "Too many return items").describe("Array of products to return (required)"),
   refundAmount: z2.number().min(0, "refundAmount must be non-negative").describe("Refund amount (required, min 0)"),
+  returnShippingFee: z2.number().min(0, "returnShippingFee must be non-negative").optional().describe("Return shipping fee charged to the customer (ADR 0005 \xA7Gap 1)"),
   pgPaymentId: z2.string().min(1, "pgPaymentId is required").describe("PG payment ID for refund (required)"),
   paymentKey: z2.string().min(1).optional().describe("Provider payment key for verified refund"),
   refundReceiptUrl: z2.string().optional().describe("Refund receipt URL (optional)")
@@ -237,6 +333,16 @@ var MCP_TOOL_CONTRACT = {
     oauthScope: "mcp:read",
     readOnly: true
   },
+  "product-detail": {
+    consoleRole: "tenant-viewer",
+    oauthScope: "mcp:read",
+    readOnly: true
+  },
+  "product-upsert": {
+    consoleRole: "tenant-admin",
+    oauthScope: "mcp:write",
+    readOnly: false
+  },
   "validate-discount": {
     consoleRole: "tenant-viewer",
     oauthScope: "mcp:read",
@@ -262,6 +368,11 @@ var MCP_TOOL_CONTRACT = {
     oauthScope: "mcp:read",
     readOnly: true
   },
+  "check-feature-progress": {
+    consoleRole: "tenant-viewer",
+    oauthScope: "mcp:read",
+    readOnly: true
+  },
   "add-cart-item": {
     consoleRole: "tenant-editor",
     oauthScope: "mcp:write",
@@ -363,9 +474,7 @@ var MCP_TOOL_CONTRACT = {
     readOnly: true
   }
 };
-var MCP_TOOL_NAMES = Object.keys(
-  MCP_TOOL_CONTRACT
-);
+var MCP_TOOL_NAMES = Object.keys(MCP_TOOL_CONTRACT);
 function isMcpToolName(toolName) {
   return Object.prototype.hasOwnProperty.call(MCP_TOOL_CONTRACT, toolName);
 }
@@ -433,6 +542,21 @@ var TOOL_POLICY_MANIFEST = {
     consoleSurface: "GET /api/products/{id}/stock",
     annotationPolicy: READ_ONLY_ANNOTATION
   },
+  "product-detail": {
+    category: "read-only-collection",
+    oauthScope: MCP_SCOPES.read,
+    consoleRole: "tenant-viewer",
+    consoleSurface: "GET /api/products/detail",
+    annotationPolicy: READ_ONLY_ANNOTATION
+  },
+  "product-upsert": {
+    category: "mutation-product",
+    oauthScope: MCP_SCOPES.write,
+    consoleRole: "tenant-admin",
+    consoleSurface: "POST /api/products/upsert",
+    annotationPolicy: DESTRUCTIVE_IDEMPOTENT_MUTATION_ANNOTATION,
+    exemptionReason: REASON_IDEMPOTENT_DESTRUCTIVE_UPDATE
+  },
   "validate-discount": {
     category: "read-only-collection",
     oauthScope: MCP_SCOPES.read,
@@ -469,6 +593,13 @@ var TOOL_POLICY_MANIFEST = {
     consoleSurface: "GET /api/tenants/context",
     annotationPolicy: READ_ONLY_ANNOTATION
   },
+  "check-feature-progress": {
+    category: "read-only-tenant",
+    oauthScope: MCP_SCOPES.read,
+    consoleRole: "tenant-viewer",
+    consoleSurface: "GET /api/tenants/feature-progress",
+    annotationPolicy: READ_ONLY_ANNOTATION
+  },
   // ── Cart mutations (mcp:write, tenant-editor) ──
   "add-cart-item": {
     category: "mutation-cart",
@@ -518,7 +649,7 @@ var TOOL_POLICY_MANIFEST = {
     exemptionReason: REASON_CART_EPHEMERAL
   },
   // ── Order mutations (mcp:write, tenant-admin) ──
-  "checkout": {
+  checkout: {
     category: "mutation-order",
     oauthScope: MCP_SCOPES.write,
     consoleRole: "tenant-admin",
@@ -779,9 +910,12 @@ function signMcpServiceToken(context) {
 }
 
 // src/lib/console-api.ts
-var BASE_URL = process.env.SOFTWARE_API_URL || "http://localhost:3000";
+var DEFAULT_API_URL = "https://api.01.software";
 var TIMEOUT_MS = 5e3;
 var MISSING_HTTP_AUTH_CONTEXT_ERROR = "MCP HTTP requests require a validated OAuth tenant context before tool execution.";
+function resolveConsoleApiUrl() {
+  return (process.env.SOFTWARE_API_URL || process.env.NEXT_PUBLIC_SOFTWARE_API_URL || DEFAULT_API_URL).replace(/\/$/, "");
+}
 function resolveAuthHeaderContext() {
   const oauthContext = tenantAuthContext();
   if (oauthContext) {
@@ -831,7 +965,7 @@ async function consoleGet(path, apiKey) {
   const controller = new AbortController();
   const timeoutId = setTimeout(() => controller.abort(), TIMEOUT_MS);
   try {
-    const res = await fetch(`${BASE_URL}${path}`, {
+    const res = await fetch(`${resolveConsoleApiUrl()}${path}`, {
       headers: authHeaders,
       signal: controller.signal
     });
@@ -850,7 +984,7 @@ async function consolePost(path, body, apiKey) {
   const controller = new AbortController();
   const timeoutId = setTimeout(() => controller.abort(), TIMEOUT_MS);
   try {
-    const res = await fetch(`${BASE_URL}${path}`, {
+    const res = await fetch(`${resolveConsoleApiUrl()}${path}`, {
       method: "POST",
       headers: { ...authHeaders, "Content-Type": "application/json" },
       body: JSON.stringify(body),
@@ -871,7 +1005,7 @@ async function consolePostTelemetry(path, body, apiKey) {
   const controller = new AbortController();
   const timeoutId = setTimeout(() => controller.abort(), TIMEOUT_MS);
   try {
-    const res = await fetch(`${BASE_URL}${path}`, {
+    const res = await fetch(`${resolveConsoleApiUrl()}${path}`, {
       method: "POST",
       headers: { ...authHeaders, "Content-Type": "application/json" },
       body: JSON.stringify(body),
@@ -1769,6 +1903,118 @@ async function stockCheck({
   }
 }
 
+// src/tools/product-detail.ts
+import { z as z22 } from "zod";
+var schema22 = {
+  slug: z22.string().optional().describe("Product slug (one of slug or id required)"),
+  id: z22.string().optional().describe("Product id (one of slug or id required)")
+};
+var metadata22 = {
+  name: "product-detail",
+  description: "Fetch full product detail by slug or id. Returns one resolver-ready product with variants, option slugs, option value slugs/media, brand, categories, tags, images, videos, and listing rollup, or null if missing/unpublished/wrong tenant/feature disabled.",
+  annotations: {
+    title: "Get product detail",
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true
+  }
+};
+async function productDetail({
+  slug,
+  id
+}) {
+  try {
+    if (Boolean(slug) === Boolean(id)) {
+      return toolError(new Error("Provide exactly one of slug or id"));
+    }
+    const client = getClient();
+    const params = slug ? { slug } : { id };
+    const result = await client.commerce.product.detail(params);
+    return toolSuccess({ data: result });
+  } catch (error) {
+    return toolError(error);
+  }
+}
+
+// src/tools/product-upsert.ts
+import { z as z23 } from "zod";
+var optionValueSchema = z23.object({
+  id: z23.string().optional().describe("Existing option-value ID for updates"),
+  value: z23.string().describe("Display label (e.g. Black, S)"),
+  slug: z23.string().optional().describe("Canonical value token used in variant maps and URLs"),
+  swatchColor: z23.string().nullable().optional(),
+  thumbnail: z23.string().nullable().optional(),
+  images: z23.array(z23.string()).optional(),
+  metadata: z23.unknown().optional()
+});
+var optionSchema = z23.object({
+  id: z23.string().optional().describe("Existing option ID for updates"),
+  title: z23.string().describe("Option name (e.g. Color, Size)"),
+  slug: z23.string().optional().describe("Canonical option token used in variant maps and URLs"),
+  values: z23.array(optionValueSchema).describe("Allowed option values")
+});
+var variantOptionValueSchema = z23.object({
+  valueSlug: z23.string().optional(),
+  valueId: z23.string().optional(),
+  value: z23.string().optional()
+});
+var variantSchema = z23.object({
+  id: z23.string().optional().describe("Existing variant ID for updates"),
+  optionValues: z23.union([
+    z23.record(z23.string(), z23.union([z23.string(), variantOptionValueSchema])),
+    z23.array(z23.string())
+  ]).optional().describe(
+    "Option-value selection. Prefer canonical { optionSlug: valueSlug } maps. Object values may use { valueSlug, valueId, value }. Exact { OptionTitle: ValueLabel } maps remain compatibility-only and fail when labels are ambiguous. Arrays of option-value IDs are also accepted."
+  ),
+  sku: z23.string().nullable().optional(),
+  title: z23.string().nullable().optional(),
+  price: z23.number().nonnegative().describe("Selling price (KRW, min 0)"),
+  compareAtPrice: z23.number().nonnegative().nullable().optional(),
+  stock: z23.number().int().nonnegative().optional(),
+  isUnlimited: z23.boolean().optional(),
+  weight: z23.number().nonnegative().nullable().optional(),
+  requiresShipping: z23.boolean().optional(),
+  barcode: z23.string().nullable().optional(),
+  externalId: z23.string().nullable().optional(),
+  isActive: z23.boolean().optional(),
+  thumbnail: z23.string().nullable().optional(),
+  images: z23.array(z23.string()).optional(),
+  metadata: z23.unknown().optional()
+});
+var schema23 = {
+  product: z23.record(z23.string(), z23.unknown()).describe(
+    "Product fields. Include `id` to update an existing product; omit for create (then `title` is required)."
+  ),
+  options: z23.array(optionSchema).optional().describe(
+    "Option definitions. Prefer explicit option slug and value slugs. Omitted options on an existing product are deleted (with their values)."
+  ),
+  variants: z23.array(variantSchema).optional().describe(
+    "Variant rows. Prefer canonical { optionSlug: valueSlug } optionValues maps. Omitted variants on an existing product are deleted, unless referenced by an active cart or non-terminal order \u2014 those are soft-deactivated (isActive: false)."
+  )
+};
+var metadata23 = {
+  name: "product-upsert",
+  description: "Atomically create or update a product together with its options, option-values, and variants in a single transaction. Mirrors Shopify productSet semantics. Any failure rolls back the entire write.",
+  annotations: {
+    title: "Upsert product (atomic)",
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: true,
+    openWorldHint: false
+  }
+};
+async function productUpsert(params) {
+  try {
+    const client = getClient();
+    const result = await client.commerce.product.upsert(
+      params
+    );
+    return toolSuccess({ data: result });
+  } catch (error) {
+    return toolError(error);
+  }
+}
+
 // src/tools/get-collection-schema.ts
 import { SERVER_COLLECTIONS as SERVER_COLLECTIONS3 } from "@01.software/sdk";
 
@@ -1783,8 +2029,8 @@ async function getCollectionSchema(collection) {
 }
 
 // src/tools/get-collection-schema.ts
-var schema22 = createCollectionSchemaToolInputSchema(SERVER_COLLECTIONS3).shape;
-var metadata22 = {
+var schema24 = createCollectionSchemaToolInputSchema(SERVER_COLLECTIONS3).shape;
+var metadata24 = {
   name: "get-collection-schema",
   description: "Get the authoritative tenant-aware collection schema from console. Use this before create/update to understand writable fields, hidden fields, required metadata, and collection-level visibility.",
   annotations: {
@@ -1812,6 +2058,11 @@ async function getCollectionSchemaTool({
 function getTenantContextPath(includeCounts) {
   return includeCounts ? "/api/tenants/context?counts=true" : "/api/tenants/context";
 }
+function getTenantFeatureProgressPath(feature, includeEvidence) {
+  const search = new URLSearchParams({ feature });
+  if (includeEvidence) search.set("includeEvidence", "true");
+  return `/api/tenants/feature-progress?${search.toString()}`;
+}
 async function getTenantContext(includeCounts = false) {
   const apiKey = resolveApiKey();
   const data = await consoleGet(
@@ -1820,10 +2071,18 @@ async function getTenantContext(includeCounts = false) {
   );
   return tenantContextResponseSchema.parse(data);
 }
+async function getTenantFeatureProgress(feature, includeEvidence = false) {
+  const apiKey = resolveApiKey();
+  const data = await consoleGet(
+    getTenantFeatureProgressPath(feature, includeEvidence),
+    apiKey
+  );
+  return tenantFeatureProgressResponseSchema.parse(data);
+}
 
 // src/tools/get-tenant-context.ts
-var schema23 = tenantContextToolInputSchema.shape;
-var metadata23 = {
+var schema25 = tenantContextToolInputSchema.shape;
+var metadata25 = {
   name: "get-tenant-context",
   description: "Get current tenant features, active collections, and field visibility. Call this at the start of every session. Use includeCounts=true to also get per-collection document counts for setup diagnostics.",
   annotations: {
@@ -1899,8 +2158,32 @@ async function handler({
   }
 }
 
+// src/tools/check-feature-progress.ts
+var schema26 = tenantFeatureProgressInputSchema.shape;
+var metadata26 = {
+  name: "check-feature-progress",
+  description: "Check tenant implementation progress for a supported feature. Start with feature=ecommerce to inspect catalog, cart, checkout, payment result, webhook, and operations readiness without mutating tenant data.",
+  annotations: {
+    title: "Check Feature Progress",
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true
+  }
+};
+async function handler2({
+  feature,
+  includeEvidence
+}) {
+  try {
+    const progress = await getTenantFeatureProgress(feature, includeEvidence);
+    return toolSuccess({ progress });
+  } catch (error) {
+    return toolError(error);
+  }
+}
+
 // src/tools/list-configurable-fields.ts
-import { z as z22 } from "zod";
+import { z as z24 } from "zod";
 
 // src/lib/field-config.ts
 async function fetchFieldConfigs() {
@@ -1923,12 +2206,12 @@ function invalidateFieldConfigCache() {
 }
 
 // src/tools/list-configurable-fields.ts
-var schema24 = {
-  collection: z22.string().optional().describe(
+var schema27 = {
+  collection: z24.string().optional().describe(
     "Filter by collection slug (optional \u2014 returns all if omitted). Use this filter to reduce response size when you know which collection to check."
   )
 };
-var metadata24 = {
+var metadata27 = {
   name: "list-configurable-fields",
   description: "List all configurable fields for tenant collections with current visibility state. Shows which fields can be shown/hidden and their current status. Returns all collections including inactive features \u2014 cross-reference with get-tenant-context for active features. Response includes ~300 fields across 47 collections \u2014 use collection filter when possible.",
   annotations: {
@@ -1959,17 +2242,17 @@ async function listConfigurableFields(params) {
 }
 
 // src/tools/update-field-config.ts
-import { z as z23 } from "zod";
-var schema25 = {
-  collection: z23.string().min(1).describe("Collection slug (required)"),
-  hiddenFields: z23.array(z23.string().min(1).max(200)).max(300).describe(
+import { z as z25 } from "zod";
+var schema28 = {
+  collection: z25.string().min(1).describe("Collection slug (required)"),
+  hiddenFields: z25.array(z25.string().min(1).max(200)).max(300).describe(
     "Fields to hide (required). This is a FULL REPLACE \u2014 fields NOT in this list will be shown. Pass [] to show all fields. Use list-configurable-fields first to see available field paths."
   ),
-  isHidden: z23.boolean().optional().describe(
+  isHidden: z25.boolean().optional().describe(
     "Hide the entire collection from Admin Panel (optional). When true, individual hiddenFields are irrelevant."
   )
 };
-var metadata25 = {
+var metadata28 = {
   name: "update-field-config",
   description: "Update field visibility configuration for a tenant collection. Hidden fields are removed from the Admin Panel UI. IMPORTANT: hiddenFields is a full replace, not a merge. Always call list-configurable-fields first to see current state.",
   annotations: {
@@ -1997,7 +2280,7 @@ async function updateFieldConfig(params) {
 }
 
 // src/tools/sdk-get-recipe.ts
-import { z as z24 } from "zod";
+import { z as z26 } from "zod";
 
 // src/lib/sdk-recipes.ts
 var recipes = {
@@ -2429,8 +2712,8 @@ function getRecipe(goal, runtime = "both") {
 }
 
 // src/tools/sdk-get-recipe.ts
-var schema26 = {
-  goal: z24.enum([
+var schema29 = {
+  goal: z26.enum([
     "fetch-list",
     "fetch-by-id",
     "create-item",
@@ -2442,11 +2725,11 @@ var schema26 = {
     "file-upload",
     "bulk-operations"
   ]).describe("What the user wants to accomplish"),
-  runtime: z24.enum(["browser", "server", "both"]).default("both").describe("Target runtime environment"),
-  collection: z24.string().optional().describe("Specific collection name if applicable"),
-  includeExample: z24.boolean().default(true).describe("Whether to include a full code example")
+  runtime: z26.enum(["browser", "server", "both"]).default("both").describe("Target runtime environment"),
+  collection: z26.string().optional().describe("Specific collection name if applicable"),
+  includeExample: z26.boolean().default(true).describe("Whether to include a full code example")
 };
-var metadata26 = {
+var metadata29 = {
   name: "sdk-get-recipe",
   description: "Get a complete SDK code recipe for a specific task. Returns recommended approach, code example, and related documentation links. Use this FIRST when the user asks how to do something with the SDK.",
   annotations: {
@@ -2456,7 +2739,7 @@ var metadata26 = {
     idempotentHint: true
   }
 };
-function handler2({
+function handler3({
   goal,
   runtime,
   collection,
@@ -2489,7 +2772,7 @@ function handler2({
 }
 
 // src/tools/sdk-search-docs.ts
-import { z as z25 } from "zod";
+import { z as z27 } from "zod";
 
 // src/lib/sdk-doc-index.ts
 var docIndex = [
@@ -2664,11 +2947,11 @@ function searchDocs(query, limit = 5) {
 }
 
 // src/tools/sdk-search-docs.ts
-var schema27 = {
-  query: z25.string().min(2).describe('Search keyword or phrase (e.g. "infinite scroll", "webhook", "customer login")'),
-  limit: z25.number().min(1).max(10).default(5).describe("Maximum results to return (1-10, default: 5)")
+var schema30 = {
+  query: z27.string().min(2).describe('Search keyword or phrase (e.g. "infinite scroll", "webhook", "customer login")'),
+  limit: z27.number().min(1).max(10).default(5).describe("Maximum results to return (1-10, default: 5)")
 };
-var metadata27 = {
+var metadata30 = {
   name: "sdk-search-docs",
   description: "Search SDK documentation by keyword. Returns matching topics with summaries and resource links. Use when looking for specific SDK features or patterns.",
   annotations: {
@@ -2678,7 +2961,7 @@ var metadata27 = {
     idempotentHint: true
   }
 };
-function handler3({
+function handler4({
   query,
   limit
 }) {
@@ -2703,9 +2986,9 @@ function handler3({
 }
 
 // src/tools/sdk-get-auth-setup.ts
-import { z as z26 } from "zod";
-var schema28 = {
-  scenario: z26.enum([
+import { z as z28 } from "zod";
+var schema31 = {
+  scenario: z28.enum([
     "browser-client",
     "server-client",
     "customer-auth",
@@ -2714,7 +2997,7 @@ var schema28 = {
     "webhook-verification"
   ]).describe("Authentication scenario")
 };
-var metadata28 = {
+var metadata31 = {
   name: "sdk-get-auth-setup",
   description: "Get the current authentication setup for a specific scenario. Returns env var names, code snippets, and security notes.",
   annotations: {
@@ -2853,7 +3136,7 @@ export async function POST(request: Request) {
     ]
   }
 };
-function handler4({
+function handler5({
   scenario
 }) {
   try {
@@ -2868,14 +3151,14 @@ function handler4({
 }
 
 // src/tools/sdk-get-collection-pattern.ts
-import { z as z27 } from "zod";
+import { z as z29 } from "zod";
 import { COLLECTIONS, SERVER_COLLECTIONS as SERVER_COLLECTIONS4 } from "@01.software/sdk";
-var schema29 = {
-  collection: z27.enum(SERVER_COLLECTIONS4).describe("Collection name"),
-  operation: z27.enum(["read", "write", "full-crud"]).default("read").describe("What operations are needed"),
-  surface: z27.enum(["query-builder", "react-query", "server-api"]).default("query-builder").describe("Preferred API surface")
+var schema32 = {
+  collection: z29.enum(SERVER_COLLECTIONS4).describe("Collection name"),
+  operation: z29.enum(["read", "write", "full-crud"]).default("read").describe("What operations are needed"),
+  surface: z29.enum(["query-builder", "react-query", "server-api"]).default("query-builder").describe("Preferred API surface")
 };
-var metadata29 = {
+var metadata32 = {
   name: "sdk-get-collection-pattern",
   description: "Get the recommended CRUD pattern for a specific collection. Returns code examples for the chosen API surface and operation type.",
   annotations: {
@@ -3048,7 +3331,7 @@ function generatePattern(collection, operation, surface) {
     ].filter(Boolean)
   };
 }
-function handler5({
+function handler6({
   collection,
   operation,
   surface
@@ -3076,14 +3359,14 @@ function handler5({
 }
 
 // src/prompts/sdk-usage-guide.ts
-import { z as z28 } from "zod";
-var schema30 = {
-  goal: z28.string().describe('What the user wants to accomplish (e.g., "query product list", "create order")'),
-  runtime: z28.enum(["browser", "server"]).optional().describe("Target runtime: browser (React/Next.js client) or server (Node.js)"),
-  surface: z28.enum(["query-builder", "react-query", "customer-api", "server-api"]).optional().describe("Preferred API surface"),
-  collection: z28.string().optional().describe("Specific collection if relevant")
+import { z as z30 } from "zod";
+var schema33 = {
+  goal: z30.string().describe('What the user wants to accomplish (e.g., "query product list", "create order")'),
+  runtime: z30.enum(["browser", "server"]).optional().describe("Target runtime: browser (React/Next.js client) or server (Node.js)"),
+  surface: z30.enum(["query-builder", "react-query", "customer-api", "server-api"]).optional().describe("Preferred API surface"),
+  collection: z30.string().optional().describe("Specific collection if relevant")
 };
-var metadata30 = {
+var metadata33 = {
   name: "sdk-usage-guide",
   title: "SDK Usage Guide",
   description: "Provides guidance on how to perform a specific task using the 01.software SDK",
@@ -3216,18 +3499,44 @@ const client = createServerClient({
 })
 \`\`\`
 
-You can perform the "${goal}" task by following the patterns above.`;
+You can perform the "${goal}" task by following the patterns above.
+
+## Common recipes
+
+### Product detail page (slug-based)
+
+\`\`\`typescript
+const product = await client.commerce.product.detail({ slug })
+if (!product) return notFound()
+// product: { product, variants, options, brand, categories, tags, images, videos, listing }
+\`\`\`
+
+For React: \`const { data } = client.query.useProductDetailBySlug(slug)\`.
+
+### Product listing (grouped)
+
+\`\`\`typescript
+const { docs } = await client.commerce.product.listingGroups({ productIds })
+\`\`\`
+
+### Stock check before adding to cart
+
+\`\`\`typescript
+const { allAvailable } = await client.commerce.product.stockCheck({
+  items: [{ variantId, quantity }],
+})
+\`\`\``;
 }
 
 // src/prompts/collection-query-help.ts
-import { z as z29 } from "zod";
+import { z as z31 } from "zod";
 import { COLLECTIONS as COLLECTIONS2, SERVER_COLLECTIONS as SERVER_COLLECTIONS5 } from "@01.software/sdk";
-var schema31 = {
-  collection: z29.enum(SERVER_COLLECTIONS5).describe("Collection name"),
-  operation: z29.enum(["find", "create", "update", "delete"]).describe("Operation to perform (find, create, update, delete)"),
-  filters: z29.string().optional().describe("Filter conditions (JSON string, optional)")
+var schema34 = {
+  collection: z31.enum(SERVER_COLLECTIONS5).describe("Collection name"),
+  operation: z31.enum(["find", "create", "update", "delete"]).describe("Operation to perform (find, create, update, delete)"),
+  filters: z31.string().optional().describe("Filter conditions (JSON string, optional)")
 };
-var metadata31 = {
+var metadata34 = {
   name: "collection-query-help",
   title: "Collection Query Help",
   description: "Provides guidance on how to write queries for a specific collection",
@@ -3319,16 +3628,16 @@ ${operation === "find" ? `- Use \`where\` option for filtering (Payload query sy
 }
 
 // src/prompts/order-flow-guide.ts
-import { z as z30 } from "zod";
-var schema32 = {
-  scenario: z30.enum([
+import { z as z32 } from "zod";
+var schema35 = {
+  scenario: z32.enum([
     "simple-order",
     "cart-checkout",
     "return-refund",
     "fulfillment-tracking"
   ]).describe("Order flow scenario")
 };
-var metadata32 = {
+var metadata35 = {
   name: "order-flow-guide",
   title: "Order Flow Guide",
   description: "Provides step-by-step guidance for ecommerce order flows including creation, checkout, returns, and fulfillment.",
@@ -3513,9 +3822,9 @@ ${SCENARIOS[scenario] || "Unknown scenario."}
 }
 
 // src/prompts/feature-setup-guide.ts
-import { z as z31 } from "zod";
-var schema33 = {
-  feature: z31.enum([
+import { z as z33 } from "zod";
+var schema36 = {
+  feature: z33.enum([
     "ecommerce",
     "customers",
     "articles",
@@ -3530,10 +3839,10 @@ var schema33 = {
     "community"
   ]).describe("Feature to get setup guide for")
 };
-var metadata33 = {
+var metadata36 = {
   name: "feature-setup-guide",
   title: "Feature Setup Guide",
-  description: "Setup checklist and remediation guide for a tenant feature. Load before using get-tenant-context to diagnose setup gaps.",
+  description: "Setup checklist and remediation guide for a tenant feature. Load with check-feature-progress and get-tenant-context to diagnose setup gaps.",
   role: "assistant"
 };
 var FEATURES = {
@@ -3563,6 +3872,7 @@ product-options, product-option-values, product-categories, product-tags, produc
 ### Config
 
 - **Webhook URL** must be configured in tenant settings for payment gateway callbacks
+- Use \`check-feature-progress\` for the tenant-aware ecommerce progress check
 - Use \`get-tenant-context\` to check current webhook configuration`,
   customers: `## Customers Setup Guide
 
@@ -3729,18 +4039,19 @@ function featureSetupGuide({
 ${FEATURES[feature] || "Unknown feature."}
 
 ## Related MCP Tools
+- \`check-feature-progress\` \u2014 run the tenant-aware ecommerce implementation progress check
 - \`get-tenant-context\` \u2014 check current collection counts and feature status
 - \`query-collection\` \u2014 verify existing documents in a collection
 - \`get-collection-schema\` \u2014 inspect tenant-aware fields before creating data via SDK or Console UI`;
 }
 
 // src/resources/(config)/app.ts
-var metadata34 = {
+var metadata37 = {
   name: "app-config",
   title: "Application Config",
   description: "01.software SDK and MCP server configuration information"
 };
-function handler6() {
+function handler7() {
   return `# 01.software MCP Server Configuration
 
 ## Server Info
@@ -3758,15 +4069,16 @@ HTTP MCP uses OAuth discovery and Authorization Code + PKCE.
 url = "https://mcp.01.software/mcp"
 \`\`\`
 
-## Hosted HTTP OAuth Tools (8)
+## Hosted HTTP OAuth Tools (9)
 
 The hosted HTTP MCP endpoint at https://mcp.01.software/mcp exposes only these OAuth-safe tools:
 
 ### Schema (1)
 - \`get-collection-schema\` - Get authoritative tenant-aware collection schema
 
-### Tenant Context (1)
+### Tenant Context (2)
 - \`get-tenant-context\` - Get tenant features, active collections, and field config
+- \`check-feature-progress\` - Check ecommerce implementation progress without mutating tenant data
 
 ### Field Config (2)
 - \`list-configurable-fields\` - List configurable fields and current hidden state
@@ -3778,7 +4090,7 @@ The hosted HTTP MCP endpoint at https://mcp.01.software/mcp exposes only these O
 - \`sdk-get-auth-setup\` - Get framework-specific auth setup guidance
 - \`sdk-get-collection-pattern\` - Get collection-specific usage patterns
 
-## Local CLI Stdio Surface (29)
+## Local CLI Stdio Surface (30)
 
 For trusted local server-key workflows, start the stdio server:
 
@@ -3786,7 +4098,7 @@ For trusted local server-key workflows, start the stdio server:
 npx @01.software/cli mcp
 \`\`\`
 
-Local stdio can expose generic read, order, return, cart, validation, stock, schema, tenant context, field config, and guidance tools. Generic collection write tools (create/update/delete/update-many/delete-many) are intentionally absent on every transport; use the SDK server client for generic writes.
+Local stdio can expose generic read, order, return, cart, validation, stock, schema, tenant context, feature progress, field config, and guidance tools. Generic collection write tools (create/update/delete/update-many/delete-many) are intentionally absent on every transport; use the SDK server client for generic writes.
 
 ## Rate Limits
 
@@ -3800,7 +4112,7 @@ Rate limits depend on your tenant plan:
 
 // src/resources/(collections)/schema.ts
 import { COLLECTIONS as COLLECTIONS3 } from "@01.software/sdk";
-var metadata35 = {
+var metadata38 = {
   name: "collections-schema",
   title: "Collection Schema Info",
   description: "Available collections and their schema information"
@@ -3824,7 +4136,12 @@ var COLLECTIONS_BY_CATEGORY = {
     "fulfillments",
     "fulfillment-items"
   ],
-  "Shipping & Returns": ["returns", "return-items", "shipping-policies"],
+  "Shipping & Returns": [
+    "returns",
+    "return-items",
+    "shipping-policies",
+    "shipping-zones"
+  ],
   Customers: [
     "customers",
     "customer-profiles",
@@ -3832,7 +4149,7 @@ var COLLECTIONS_BY_CATEGORY = {
     "customer-addresses"
   ],
   Carts: ["carts", "cart-items"],
-  "Discounts & Promotions": ["discounts", "promotions"],
+  Discounts: ["discounts"],
   Documents: ["documents", "document-categories", "document-types"],
   Articles: [
     "articles",
@@ -3846,9 +4163,7 @@ var COLLECTIONS_BY_CATEGORY = {
     "reactions",
     "reaction-types",
     "bookmarks",
-    "post-categories",
-    "reports",
-    "community-bans"
+    "post-categories"
   ],
   Playlists: [
     "playlists",
@@ -3886,7 +4201,7 @@ var COLLECTIONS_BY_CATEGORY = {
     "event-tags"
   ]
 };
-function handler7() {
+function handler8() {
   const categoryDocs = Object.entries(COLLECTIONS_BY_CATEGORY).map(([category, collections]) => {
     const collectionList = collections.filter((c) => COLLECTIONS3.includes(c)).map((c) => `- **${c}**`).join("\n");
     return `## ${category}
@@ -3938,12 +4253,12 @@ Total available collections: ${COLLECTIONS3.length}`;
 }
 
 // src/resources/(docs)/getting-started.ts
-var metadata36 = {
+var metadata39 = {
   name: "docs-getting-started",
   title: "Getting Started",
   description: "01.software SDK getting started guide"
 };
-function handler8() {
+function handler9() {
   return `# Getting Started
 
 A guide to getting started with the 01.software SDK.
@@ -3977,18 +4292,18 @@ const result = await client.collections.from('products').find({
 
 ## Next Steps
 
-- [Quick Start](/docs/getting-started/quick-start) - Get started in 5 minutes
-- [Configuration](/docs/getting-started/configuration) - Detailed configuration options
-- [API Reference](/docs/api) - Full API documentation`;
+- [SDK Guide](/developers/sdk) - Install and query workspace content
+- [Authentication & Keys](/developers/authentication) - Choose the right key for each surface
+- [API](/developers/api) - Use the HTTP API when SDKs are not a fit`;
 }
 
 // src/resources/(docs)/guides.ts
-var metadata37 = {
+var metadata40 = {
   name: "docs-guides",
   title: "Guides",
   description: "01.software SDK usage guides"
 };
-function handler9() {
+function handler10() {
   return `# Guides
 
 Comprehensive guides to master the 01.software SDK.
@@ -4190,16 +4505,16 @@ Payload query syntax operators:
 
 For ecommerce collections, \`products.listing.*\` is the browse/search projection. Authoritative sellable price and stock remain on \`product-variants\`.
 
-For more detailed guides, see the [Guides page](/docs/guides).`;
+For more implementation guidance, see the [SDK Guide](/developers/sdk).`;
 }
 
 // src/resources/(docs)/api.ts
-var metadata38 = {
+var metadata41 = {
   name: "docs-api",
   title: "API Reference",
   description: "01.software SDK API reference documentation"
 };
-function handler10() {
+function handler11() {
   return `# API Reference
 
 Comprehensive documentation for all methods and types in the 01.software SDK.
@@ -4476,16 +4791,16 @@ client.customer.isAuthenticated()  // Check auth status
 client.customer.logout()           // Clear token
 \`\`\`
 
-For more details, see the [full API documentation](/docs/api).`;
+For more details, see the [API documentation](/developers/api).`;
 }
 
 // src/resources/(docs)/query-builder.ts
-var metadata39 = {
+var metadata42 = {
   name: "docs-query-builder",
   title: "Query Builder",
   description: "01.software SDK Query Builder API reference (client.collections.from)"
 };
-function handler11() {
+function handler12() {
   return `# Query Builder API
 
 The Query Builder provides a fluent interface for querying collections via \`client.collections.from(collection)\`.
@@ -4674,12 +4989,12 @@ console.log(result.hasNextPage) // true
 }
 
 // src/resources/(docs)/react-query.ts
-var metadata40 = {
+var metadata43 = {
   name: "docs-react-query",
   title: "React Query Hooks",
   description: "01.software SDK React Query hooks reference (client.query)"
 };
-function handler12() {
+function handler13() {
   return `# React Query Hooks
 
 React Query hooks are available on the browser-side \`Client\` via \`client.query\`. They provide automatic caching, background refetching, and cache invalidation.
@@ -4922,12 +5237,12 @@ export function ProductList() {
 }
 
 // src/resources/(docs)/server-api.ts
-var metadata41 = {
+var metadata44 = {
   name: "docs-server-api",
   title: "Server-side API",
   description: "01.software SDK server-side API reference (client.commerce) for orders, fulfillments, returns, carts, and validation"
 };
-function handler13() {
+function handler14() {
   return `# Server-side API
 
 Server-side operations are available via \`client.commerce\` on \`ServerClient\`. Use \`createServerClient\` with both \`publishableKey\` and \`secretKey\`.
@@ -5184,12 +5499,12 @@ const result = await client.commerce.shipping.calculate({
 }
 
 // src/resources/(docs)/customer-auth.ts
-var metadata42 = {
+var metadata45 = {
   name: "docs-customer-auth",
   title: "Customer Auth API",
   description: "01.software SDK Customer Auth API reference (client.customer)"
 };
-function handler14() {
+function handler15() {
   return `# Customer Auth API
 
 Customer authentication and profile management is available via \`client.customer\` on the browser-side \`Client\`.
@@ -5362,12 +5677,12 @@ async function loadProfile() {
 }
 
 // src/resources/(docs)/browser-vs-server.ts
-var metadata43 = {
+var metadata46 = {
   name: "docs-browser-vs-server",
   title: "Client vs ServerClient",
   description: "When to use Client (createClient) vs ServerClient (createServerClient) in the 01.software SDK"
 };
-function handler15() {
+function handler16() {
   return `# Client vs ServerClient
 
 The SDK provides two client types for different execution environments.
@@ -5521,12 +5836,12 @@ export function ProductList() {
 }
 
 // src/resources/(docs)/file-upload.ts
-var metadata44 = {
+var metadata47 = {
   name: "docs-file-upload",
   title: "File Upload",
   description: "01.software SDK file upload patterns using the images collection"
 };
-function handler16() {
+function handler17() {
   return `# File Upload
 
 Upload files using the \`images\` collection (tenant-scoped, unified image store) or \`system-media\` (global, non-tenant).
@@ -5672,12 +5987,12 @@ The platform stores files in Cloudflare R2 and serves via CDN (\`cdn.01.software
 }
 
 // src/resources/(docs)/webhook.ts
-var metadata45 = {
+var metadata48 = {
   name: "docs-webhook",
   title: "Webhooks",
   description: "01.software SDK webhook verification and event handling"
 };
-function handler17() {
+function handler18() {
   return `# Webhooks
 
 The platform dispatches HMAC-SHA256 signed webhook events to your registered URLs. Tenant developers own routing inside their webhook handler.
@@ -5785,9 +6100,91 @@ Failed webhook deliveries are queued with automatic retries. Ensure your handler
 Configure webhook URLs in the 01.software console under Tenant Settings > Webhooks. Multiple URLs can be registered; all receive every event.`;
 }
 
+// src/resources/(docs)/product-detail.ts
+var metadata49 = {
+  name: "docs-product-detail",
+  title: "Product Detail Helper",
+  description: "01.software SDK commerce.product.detail helper guide"
+};
+function handler19() {
+  return `# Product Detail Helper
+
+## When to use the helper vs the raw query builder
+
+Use \`client.commerce.product.detail({ slug | id })\` when you need a full product detail page payload in one call. The helper folds the Payload query, access policy, and response shaping (variants, options, option value slugs/media, brand, categories, tags, images, videos, listing rollup) into a single call.
+
+Use \`client.collections.from('products').find(...)\` (escape hatch) when you need bulk reads, custom filter combinations, or fields outside the helper response shape.
+
+## Single-call example
+
+\`\`\`typescript
+import { createClient, resolveProductSelection } from '@01.software/sdk'
+
+const client = createClient({
+  publishableKey: process.env.NEXT_PUBLIC_SOFTWARE_PUBLISHABLE_KEY!,
+})
+
+const detail = await client.commerce.product.detail({ slug: 'my-product' })
+if (!detail) return notFound()
+const selection = resolveProductSelection(detail, {
+  search: '?opt.color=black&opt.size=large',
+})
+// selection.selectedVariant, selection.price, selection.stock, selection.media
+\`\`\`
+
+## URL round-trip
+
+Use the SDK codec for one canonical selection URL format: \`opt.<optionSlug>=<valueSlug>\`. Option and value slugs are the stable public tokens exposed by product detail.
+
+\`\`\`typescript
+import { createProductSelectionCodec } from '@01.software/sdk'
+
+const codec = createProductSelectionCodec(detail)
+const selection = codec.parse('?opt.color=black')
+const href = codec.stringify(selection)
+\`\`\`
+
+Value-slug-only URLs such as \`?black\` or \`?color=black\` are rejected because option titles are not stable identifiers.
+
+## React Query hook variant
+
+\`\`\`typescript
+const { data: detail, isLoading } = client.query.useProductDetailBySlug(slug)
+\`\`\`
+
+Cache invalidates automatically when any of 10 detail-relevant collections is mutated through SDK mutation hooks.
+
+## SSG / Server Component snippet
+
+\`\`\`tsx
+// app/products/[slug]/page.tsx
+import { createClient } from '@01.software/sdk'
+import { notFound } from 'next/navigation'
+
+export const revalidate = 60
+
+export default async function ProductPage({ params }: { params: { slug: string } }) {
+  const client = createClient({
+    publishableKey: process.env.NEXT_PUBLIC_SOFTWARE_PUBLISHABLE_KEY!,
+  })
+  const detail = await client.commerce.product.detail({ slug: params.slug })
+  if (!detail) return notFound()
+  return <ProductView detail={detail} />
+}
+\`\`\`
+
+## The \`null\` return contract
+
+The endpoint returns 404 for \`not_found\`, \`not_published\`, \`tenant_mismatch\`, or \`feature_disabled\`. The SDK collapses all 404s to \`null\` so consumer UIs render one "not available" path.
+
+## Backend correlation
+
+Log \`client.lastRequestId\` against backend logs \u2014 the endpoint records the exact 404 code alongside the request ID.`;
+}
+
 // src/server.ts
 var REGISTERED_TOOLS_BY_SERVER = /* @__PURE__ */ new WeakMap();
-function registerTool(server, schema34, meta, handler19) {
+function registerTool(server, schema37, meta, handler21) {
   let registered = REGISTERED_TOOLS_BY_SERVER.get(server);
   if (!registered) {
     registered = /* @__PURE__ */ new Set();
@@ -5798,7 +6195,7 @@ function registerTool(server, schema34, meta, handler19) {
     meta.name,
     {
       description: meta.description,
-      inputSchema: schema34,
+      inputSchema: schema37,
       annotations: meta.annotations
     },
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -5827,7 +6224,7 @@ function registerTool(server, schema34, meta, handler19) {
       const summary = activeSummary ?? ownSummary;
       let result = null;
       try {
-        result = await handler19(params);
+        result = await handler21(params);
         return { content: [{ type: "text", text: result }] };
       } finally {
         if (summary) {
@@ -5844,26 +6241,26 @@ function registerTool(server, schema34, meta, handler19) {
     }
   );
 }
-function registerPrompt(server, schema34, meta, handler19) {
+function registerPrompt(server, schema37, meta, handler21) {
   server.registerPrompt(
     meta.name,
     {
       title: meta.title,
       description: meta.description,
-      argsSchema: schema34
+      argsSchema: schema37
     },
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     (params) => ({
       messages: [
         {
           role: meta.role ?? "assistant",
-          content: { type: "text", text: handler19(params) }
+          content: { type: "text", text: handler21(params) }
         }
       ]
     })
   );
 }
-function registerStaticResource(server, uri, meta, handler19) {
+function registerStaticResource(server, uri, meta, handler21) {
   server.registerResource(
     meta.name,
     uri,
@@ -5873,7 +6270,7 @@ function registerStaticResource(server, uri, meta, handler19) {
       mimeType: meta.mimeType ?? "text/plain"
     },
     async (url) => ({
-      contents: [{ uri: url.href, text: handler19() }]
+      contents: [{ uri: url.href, text: handler21() }]
     })
   );
 }
@@ -5884,52 +6281,251 @@ function createServer(options = {}) {
     version: "0.1.0"
   });
   if (toolSurface === "full") {
-    registerTool(server, schema, metadata, queryCollection);
-    registerTool(server, schema2, metadata2, getCollectionById);
+    registerTool(
+      server,
+      schema,
+      metadata,
+      queryCollection
+    );
+    registerTool(
+      server,
+      schema2,
+      metadata2,
+      getCollectionById
+    );
     registerTool(server, schema3, metadata3, getOrder);
     registerTool(server, schema4, metadata4, createOrder);
     registerTool(server, schema5, metadata5, updateOrder);
     registerTool(server, schema6, metadata6, checkout);
-    registerTool(server, schema7, metadata7, createFulfillment);
-    registerTool(server, schema8, metadata8, updateFulfillment);
-    registerTool(server, schema9, metadata9, updateTransaction);
-    registerTool(server, schema10, metadata10, createReturn);
-    registerTool(server, schema11, metadata11, updateReturn);
-    registerTool(server, schema12, metadata12, returnWithRefund);
+    registerTool(
+      server,
+      schema7,
+      metadata7,
+      createFulfillment
+    );
+    registerTool(
+      server,
+      schema8,
+      metadata8,
+      updateFulfillment
+    );
+    registerTool(
+      server,
+      schema9,
+      metadata9,
+      updateTransaction
+    );
+    registerTool(
+      server,
+      schema10,
+      metadata10,
+      createReturn
+    );
+    registerTool(
+      server,
+      schema11,
+      metadata11,
+      updateReturn
+    );
+    registerTool(
+      server,
+      schema12,
+      metadata12,
+      returnWithRefund
+    );
     registerTool(server, schema13, metadata13, addCartItem);
-    registerTool(server, schema14, metadata14, updateCartItem);
-    registerTool(server, schema15, metadata15, removeCartItem);
-    registerTool(server, schema16, metadata16, applyDiscount);
-    registerTool(server, schema17, metadata17, removeDiscount);
+    registerTool(
+      server,
+      schema14,
+      metadata14,
+      updateCartItem
+    );
+    registerTool(
+      server,
+      schema15,
+      metadata15,
+      removeCartItem
+    );
+    registerTool(
+      server,
+      schema16,
+      metadata16,
+      applyDiscount
+    );
+    registerTool(
+      server,
+      schema17,
+      metadata17,
+      removeDiscount
+    );
     registerTool(server, schema18, metadata18, clearCart);
-    registerTool(server, schema19, metadata19, validateDiscount);
-    registerTool(server, schema20, metadata20, calculateShipping);
+    registerTool(
+      server,
+      schema19,
+      metadata19,
+      validateDiscount
+    );
+    registerTool(
+      server,
+      schema20,
+      metadata20,
+      calculateShipping
+    );
     registerTool(server, schema21, metadata21, stockCheck);
+    registerTool(server, schema22, metadata22, productDetail);
+    registerTool(
+      server,
+      schema23,
+      metadata23,
+      productUpsert
+    );
   }
-  registerTool(server, schema22, metadata22, getCollectionSchemaTool);
-  registerTool(server, schema23, metadata23, handler);
-  registerTool(server, schema24, metadata24, listConfigurableFields);
-  registerTool(server, schema25, metadata25, updateFieldConfig);
-  registerTool(server, schema26, metadata26, handler2);
-  registerTool(server, schema27, metadata27, handler3);
-  registerTool(server, schema28, metadata28, handler4);
-  registerTool(server, schema29, metadata29, handler5);
-  registerPrompt(server, schema30, metadata30, sdkUsageGuide);
-  registerPrompt(server, schema31, metadata31, collectionQueryHelp);
-  registerPrompt(server, schema32, metadata32, orderFlowGuide);
-  registerPrompt(server, schema33, metadata33, featureSetupGuide);
-  registerStaticResource(server, "config://app", metadata34, handler6);
-  registerStaticResource(server, "collections://schema", metadata35, handler7);
-  registerStaticResource(server, "docs://sdk/getting-started", metadata36, handler8);
-  registerStaticResource(server, "docs://sdk/guides", metadata37, handler9);
-  registerStaticResource(server, "docs://sdk/api", metadata38, handler10);
-  registerStaticResource(server, "docs://sdk/query-builder", metadata39, handler11);
-  registerStaticResource(server, "docs://sdk/react-query", metadata40, handler12);
-  registerStaticResource(server, "docs://sdk/server-api", metadata41, handler13);
-  registerStaticResource(server, "docs://sdk/customer-auth", metadata42, handler14);
-  registerStaticResource(server, "docs://sdk/browser-vs-server", metadata43, handler15);
-  registerStaticResource(server, "docs://sdk/file-upload", metadata44, handler16);
-  registerStaticResource(server, "docs://sdk/webhook", metadata45, handler17);
+  registerTool(
+    server,
+    schema24,
+    metadata24,
+    getCollectionSchemaTool
+  );
+  registerTool(
+    server,
+    schema25,
+    metadata25,
+    handler
+  );
+  registerTool(
+    server,
+    schema26,
+    metadata26,
+    handler2
+  );
+  registerTool(
+    server,
+    schema27,
+    metadata27,
+    listConfigurableFields
+  );
+  registerTool(
+    server,
+    schema28,
+    metadata28,
+    updateFieldConfig
+  );
+  registerTool(
+    server,
+    schema29,
+    metadata29,
+    handler3
+  );
+  registerTool(
+    server,
+    schema30,
+    metadata30,
+    handler4
+  );
+  registerTool(
+    server,
+    schema31,
+    metadata31,
+    handler5
+  );
+  registerTool(
+    server,
+    schema32,
+    metadata32,
+    handler6
+  );
+  registerPrompt(
+    server,
+    schema33,
+    metadata33,
+    sdkUsageGuide
+  );
+  registerPrompt(
+    server,
+    schema34,
+    metadata34,
+    collectionQueryHelp
+  );
+  registerPrompt(
+    server,
+    schema35,
+    metadata35,
+    orderFlowGuide
+  );
+  registerPrompt(
+    server,
+    schema36,
+    metadata36,
+    featureSetupGuide
+  );
+  registerStaticResource(
+    server,
+    "config://app",
+    metadata37,
+    handler7
+  );
+  registerStaticResource(
+    server,
+    "collections://schema",
+    metadata38,
+    handler8
+  );
+  registerStaticResource(
+    server,
+    "docs://sdk/getting-started",
+    metadata39,
+    handler9
+  );
+  registerStaticResource(server, "docs://sdk/guides", metadata40, handler10);
+  registerStaticResource(server, "docs://sdk/api", metadata41, handler11);
+  registerStaticResource(
+    server,
+    "docs://sdk/query-builder",
+    metadata42,
+    handler12
+  );
+  registerStaticResource(
+    server,
+    "docs://sdk/react-query",
+    metadata43,
+    handler13
+  );
+  registerStaticResource(
+    server,
+    "docs://sdk/server-api",
+    metadata44,
+    handler14
+  );
+  registerStaticResource(
+    server,
+    "docs://sdk/customer-auth",
+    metadata45,
+    handler15
+  );
+  registerStaticResource(
+    server,
+    "docs://sdk/browser-vs-server",
+    metadata46,
+    handler16
+  );
+  registerStaticResource(
+    server,
+    "docs://sdk/file-upload",
+    metadata47,
+    handler17
+  );
+  registerStaticResource(
+    server,
+    "docs://sdk/webhook",
+    metadata48,
+    handler18
+  );
+  registerStaticResource(
+    server,
+    "docs://sdk/product-detail",
+    metadata49,
+    handler19
+  );
   return server;
 }
 
@@ -6134,7 +6730,10 @@ function setCors(res) {
     "Access-Control-Allow-Headers",
     "Authorization, Content-Type, mcp-session-id"
   );
-  res.setHeader("Access-Control-Expose-Headers", "Mcp-Session-Id, Mcp-Protocol-Version");
+  res.setHeader(
+    "Access-Control-Expose-Headers",
+    "Mcp-Session-Id, Mcp-Protocol-Version"
+  );
 }
 function getHeaderValue(headers, name) {
   const value = headers[name.toLowerCase()];
@@ -6214,7 +6813,7 @@ HTTP OAuth Tools
 ----------------
 
 Schema       get-collection-schema
-Context      get-tenant-context
+Context      get-tenant-context, check-feature-progress
 Field Config list-configurable-fields, update-field-config
 Guidance     sdk-get-recipe, sdk-search-docs, sdk-get-auth-setup, sdk-get-collection-pattern
 
@@ -6233,9 +6832,9 @@ Resources (12): config, collections-schema, getting-started, guides, api, query-
 Links
 -----
 
-Docs            https://docs.01.software/docs/developers/integrations/mcp
-SDK             https://docs.01.software/docs/developers/sdk/client
-API Reference   https://docs.01.software/docs/developers/api/rest-api
+Integrations    https://docs.01.software/integrations
+Readiness       https://docs.01.software/readiness
+OpenAPI         https://docs.01.software/api/openapi
 Console         https://console.01.software
 `;
 var PROTECTED_RESOURCE_METADATA = JSON.stringify({
@@ -6258,9 +6857,11 @@ function writeOAuthError(res, status, error, description) {
 function acceptsEventStream(req) {
   const accept = getHeaderValue(req.headers, "accept");
   if (!accept) return false;
-  return accept.split(",").some((entry) => entry.trim().split(";")[0]?.toLowerCase() === "text/event-stream");
+  return accept.split(",").some(
+    (entry) => entry.trim().split(";")[0]?.toLowerCase() === "text/event-stream"
+  );
 }
-async function handler18(req, res) {
+async function handler20(req, res) {
   setCors(res);
   if (req.method === "OPTIONS") {
     res.writeHead(204);
@@ -6310,7 +6911,12 @@ async function handler18(req, res) {
     getHeaderValue(req.headers, "authorization")
   );
   if (!auth.valid) {
-    writeOAuthError(res, auth.error === "insufficient_scope" ? 403 : 401, auth.error, auth.errorDescription);
+    writeOAuthError(
+      res,
+      auth.error === "insufficient_scope" ? 403 : 401,
+      auth.error,
+      auth.errorDescription
+    );
     return;
   }
   const server = createServer({ toolSurface: "oauth" });
@@ -6365,5 +6971,5 @@ function writeRequestError(res, err) {
   res.end(JSON.stringify({ error: "Internal server error" }));
 }
 export {
-  handler18 as default
+  handler20 as default
 };