@tanqory/dev-mcp 0.1.2 → 0.1.3

package/README.md

@@ -75,7 +75,9 @@ next.
 | `screenshot {path, viewport, locale?, market?, fullPage?}`                              | Returns a PNG, as an MCP image block, from local Playwright.                                                                                                                                                                                                                                                                                                         |
 | `list_dev_stores`                                                                       | Runs `tanqory stores --json` and reports the store this theme is linked to.                                                                                                                                                                                                                                                                                          |
 | `get_store_data_summary`                                                                | Calls `GET /__tq/store-summary` on the dev server: the products, collections, markets, languages and content you can design against.                                                                                                                                                                                                                                 |
-| `push_draft`, `get_build_status`, `get_preview_url`                                     | **Always refuse today** with `draft_push_unavailable`. The platform's build lane for developer themes is not live yet. These tools never upload, never install, never publish and never invent a URL.                                                                                                                                                                |
+| `push_draft {confirm?, planDigest?}`                                                    | Two steps. Without `confirm`: runs `tanqory theme push --build-only --dry-run` and returns the plan (files, bytes, sha256, target development store, `planDigest`); nothing is uploaded. With `confirm: true` and that `planDigest`: runs `tanqory theme push --build-only --plan-digest <d>`: the platform builds the theme in its sandboxed lane, runs conformance and signs it, **private to your development store**. `plan_changed` if the theme changed in between. Nothing is installed or published. |
+| `get_build_status {buildId?}`                                                           | Runs `tanqory theme builds [--id <buildId>] --json`: one build (status, verdict, conformance summary, signature, error) or the store's recent builds and the daily quota.                                                                                                                                                                                             |
+| `get_preview_url`                                                                       | **Refuses today** with `preview_unavailable`: a pushed build is not installed as a draft yet, so no preview URL exists. It never invents one.                                                                                                                                                                                                                        |
 
 **Prompts:** `new-theme`, `new-section`, `fix-check-report` and `port-from-another-template-language`.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanqory/dev-mcp",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Local MCP server (stdio) for building Tanqory storefront themes with coding agents: versioned docs and schemas, kit examples, section scaffolding, theme checks, and pages and screenshots of the running dev server.",
   "keywords": [
     "tanqory",
@@ -43,7 +43,7 @@
     "zod": "^3.25.76"
   },
   "devDependencies": {
-    "create-tanqory-theme": "0.2.5"
+    "create-tanqory-theme": "0.2.6"
   },
   "publishConfig": {
     "registry": "https://npm.pkg.github.com"

package/src/server.mjs

@@ -35,7 +35,7 @@ const INSTRUCTIONS = `Tanqory theme development (Theme ABI v2). Use these tools,
 4. Verify with check_theme, not \`npm run check\`: fix every failure it reports, including ones you did not cause, until passed is true.
 5. Stop the dev server with stop_dev_server (shell fallback \`npm run dev -- --stop\`). Never pkill, killall or a pid found by name.
 Never start \`tanqory mcp\`, Playwright or \`theme check\` yourself from a sandboxed shell: Chromium cannot start there; these tools do it.
-You are not done until check_theme returned passed: true and you have seen the change in a screenshot; never say a check is green otherwise. Every storefront function (cart, variants, search, filters, markets, forms, SEO, i18n, live edit) comes from @tanqory/theme-kit; the theme owns markup and CSS. This server never calls a model, never takes a store id and never publishes.`
+You are not done until check_theme returned passed: true and you have seen the change in a screenshot; never say a check is green otherwise. Every storefront function (cart, variants, search, filters, markets, forms, SEO, i18n, live edit) comes from @tanqory/theme-kit; the theme owns markup and CSS. This server never calls a model, never takes a store id and never publishes; push_draft builds and signs privately for your development store and installs nothing.`
 
 const errorSchema = z.object({ code: z.string(), message: z.string(), hint: z.string().optional() }).passthrough()
 const base = { ok: z.boolean().describe('false when the tool could not do what was asked; see error'), error: errorSchema.optional() }
@@ -597,49 +597,97 @@ Two steps: call WITHOUT confirm to get the plan (every file, full new contents,
     }),
   )
 
-  // ── draft push (backend not live yet: typed refusals) ─────────────────────
-  const REFUSAL = {
-    code: 'draft_push_unavailable',
+  // ── platform builds (P5): push_draft builds + signs privately; install/preview arrive with P6 ──
+  const PREVIEW_REFUSAL = {
+    code: 'preview_unavailable',
     message:
-      "Pushing a theme draft is not available yet: the platform's sandboxed build lane for developer themes, draft install and preview channel are not live. Nothing was uploaded, built, installed or published, and no preview URL exists.",
-    hint: 'Keep developing locally: `tanqory theme dev` + check_theme until every tier passes. When `tanqory theme push` ships, this tool will wrap it with the same two-step confirm.',
-    instead: ['tanqory theme dev (localhost with store data)', 'check_theme (all tiers)', 'screenshot / get_page against the dev server'],
+      'Installing a pushed theme as an unpublished draft, and its preview URL, are not available yet: push_draft builds, checks and signs the theme privately for your development store, and installs nothing. No preview URL exists, so none is returned.',
+    hint: 'Use localhost (dev_server_status / screenshot) to look at the theme. push_draft + get_build_status tell you whether the platform build passed.',
+  }
+  const buildOut = { ...base, mode: z.string().optional(), planDigest: z.string().optional(), buildId: z.string().optional(), verdict: z.string().optional(), build: z.any().optional(), store: z.any().optional(), theme: z.any().optional(), upload: z.any().optional(), notUploaded: z.any().optional(), builds: z.array(z.any()).optional(), quota: z.any().optional() }
+  const buildLines = (b) => {
+    const c = b?.conformance ?? {}
+    return [
+      `build ${b?.id}: ${b?.status} (verdict ${b?.verdict})${b?.signed ? ', signed' : ''}, private to store ${b?.storeId}`,
+      ...(c.status ? [`conformance: ${c.status}${c.basis ? ` on the ${c.basis}` : ''}`] : []),
+      ...(c.warnings ?? []).map((w) => `budget warning: ${w.name} ${w.value} ${w.unit} (budget ${w.budget})`),
+      ...(b?.error ? [`${b.status}: [${b.error.kind}${b.error.code ? `/${b.error.code}` : ''}] ${b.error.message}${b.error.path ? ` (${b.error.path})` : ''}`] : []),
+    ]
   }
-  const refusalOut = { ...base, refused: z.literal(true).optional() }
-  const refuse = () => ({ isError: true, content: [{ type: 'text', text: `${REFUSAL.code}: ${REFUSAL.message}\nWhat to do instead: ${REFUSAL.instead.join('; ')}. ${REFUSAL.hint}` }], structuredContent: { ok: false, refused: true, error: REFUSAL } })
 
   server.registerTool(
     'push_draft',
     {
-      title: 'Push the theme as an unpublished draft (not available yet)',
-      description: `Would upload the theme for a sandboxed platform build and install it as an UNPUBLISHED draft on your dev store (two-step: a plan, then confirm). ALWAYS REFUSES TODAY with ${REFUSAL.code}: the platform build lane is not live. It never uploads, never installs, never publishes, and never returns a preview URL. Do not report a push as done.`,
-      inputSchema: { confirm: z.boolean().optional().describe('Second step (refused today)'), planDigest: z.string().optional() },
-      outputSchema: refusalOut,
-      annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+      title: 'Build the theme on the platform (private, signed; installs nothing)',
+      description:
+        'Uploads the theme SOURCE (git-tracked files, .gitignore respected; node_modules, dist, reports, .tanqory/dev and credential files are never uploaded) to the platform\'s sandboxed build lane for your linked DEVELOPMENT store, and waits for build → conformance → signing (`tanqory theme push --build-only`). Two steps: call WITHOUT confirm to get the plan (files, bytes, sha256, target store, planDigest; nothing is uploaded). Then call again with confirm: true and that planDigest; if the theme changed in between it refuses with plan_changed. The result is a signed build PRIVATE to that development store: nothing is installed, previewed or published, and there is no preview URL yet. Run check_theme first: a theme that fails it fails the platform build too. Needs a developer login (`tanqory login`) and a linked development store.',
+      inputSchema: {
+        confirm: z.boolean().optional().describe('true = upload the plan identified by planDigest'),
+        planDigest: z.string().max(100).optional().describe('From the plan step; required with confirm: true'),
+      },
+      outputSchema: buildOut,
+      annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
     },
-    guard(async () => refuse()),
+    guard(async ({ confirm, planDigest }) => {
+      const root = needTheme()
+      if (!confirm) {
+        const env = await runCli(['theme', 'push', '--build-only', '--dry-run'], { ...cliOpts, root })
+        if (!env.ok) return fail(env.error?.code ?? 'push_plan_failed', env.error?.message ?? '`tanqory theme push --dry-run` failed', env.error?.hint)
+        const d = env.data ?? {}
+        const text = [
+          `PLAN (nothing uploaded): ${d.upload?.files} files, ${d.upload?.bytes} bytes, sha256 ${String(d.upload?.sha256 ?? '').slice(0, 12)}…, theme "${d.theme?.handle}" → development store ${d.store?.handle ?? d.store?.id}.`,
+          ...(d.notUploaded?.secrets?.length ? [`Never uploaded (look like credentials): ${d.notUploaded.secrets.join(', ')}`] : []),
+          `To build it, call push_draft again with confirm: true, planDigest: "${d.planDigest}". The build is private to that development store; nothing is installed.`,
+        ].join('\n')
+        return done({ mode: 'plan', planDigest: d.planDigest, store: d.store, theme: d.theme, upload: d.upload, notUploaded: d.notUploaded }, text)
+      }
+      if (!planDigest) return fail('plan_digest_required', 'confirm: true needs the planDigest of a plan you reviewed.', 'Call push_draft without confirm first.')
+      const env = await runCli(['theme', 'push', '--build-only', '--plan-digest', planDigest], { ...cliOpts, root, timeoutMs: 25 * 60 * 1000 })
+      const d = env.data ?? {}
+      if (!env.ok) {
+        const lines = d.build ? buildLines(d.build) : []
+        return {
+          isError: true,
+          content: [{ type: 'text', text: [`${env.error?.code}: ${env.error?.message}`, ...lines, env.error?.hint ? `What to do: ${env.error.hint}` : ''].filter(Boolean).join('\n') }],
+          structuredContent: { ok: false, error: env.error ?? { code: 'push_failed', message: 'push failed' }, ...(d.build ? { mode: 'build', buildId: d.build.id, verdict: d.build.verdict, build: d.build, store: d.store, theme: d.theme } : {}), ...(d.planDigest ? { planDigest: d.planDigest } : {}) },
+        }
+      }
+      return done(
+        { mode: 'build', planDigest: d.planDigest, buildId: d.buildId, verdict: d.verdict, build: d.build, store: d.store, theme: d.theme, upload: d.upload, quota: d.quota },
+        [...buildLines(d.build), 'Nothing was installed or published; there is no preview URL yet. Follow up with get_build_status if it is still pending.'].join('\n'),
+      )
+    }),
   )
   server.registerTool(
     'get_build_status',
     {
-      title: 'Status of a pushed draft build (not available yet)',
-      description: `Would report the platform build of a pushed draft. ALWAYS REFUSES TODAY with ${REFUSAL.code}: no draft can be pushed yet, so no build exists.`,
-      inputSchema: { buildId: z.string().max(100).optional() },
-      outputSchema: refusalOut,
+      title: 'Status of your platform theme builds',
+      description:
+        'With buildId: that build of your linked development store (status, verdict, conformance summary, signature, error with kind/code/path). Without: the store\'s recent builds and the daily build quota (`tanqory theme builds --json`). Read-only.',
+      inputSchema: { buildId: z.string().uuid().optional().describe('From push_draft; omit for the recent builds') },
+      outputSchema: buildOut,
       annotations: { ...READ, openWorldHint: true },
     },
-    guard(async () => refuse()),
+    guard(async ({ buildId }) => {
+      const root = needTheme()
+      const env = await runCli(['theme', 'builds', ...(buildId ? ['--id', buildId] : [])], { ...cliOpts, root })
+      if (!env.ok) return fail(env.error?.code ?? 'builds_failed', env.error?.message ?? '`tanqory theme builds` failed', env.error?.hint)
+      const d = env.data ?? {}
+      if (buildId) return done({ buildId, verdict: d.build?.verdict, build: d.build, store: d.store }, buildLines(d.build).join('\n'))
+      const builds = d.builds ?? []
+      return done({ builds, store: d.store, quota: d.quota }, [`${builds.length} recent build(s) for ${d.store?.handle ?? d.store?.id}; ${d.quota?.used ?? '?'} of ${d.quota?.limit ?? '?'} used in 24 h`, ...builds.map((b) => `- ${b.id} ${b.status} (${b.verdict})${b.theme?.handle ? ` theme ${b.theme.handle}` : ''} ${b.createdAt}`)].join('\n'))
+    }),
   )
   server.registerTool(
     'get_preview_url',
     {
       title: 'Preview URL of a draft (not available yet)',
-      description: `Would return the shareable preview and editor URLs of a pushed draft. ALWAYS REFUSES TODAY with ${REFUSAL.code}: there is no draft and no preview URL. Never invent one; localhost (dev_server_status) is the only preview today.`,
+      description: `Would return the shareable preview and editor URLs of an installed draft. ALWAYS REFUSES TODAY with ${PREVIEW_REFUSAL.code}: push_draft builds and signs privately but installs nothing, so no preview URL exists. Never invent one; localhost (dev_server_status) is the only preview today.`,
       inputSchema: {},
-      outputSchema: refusalOut,
+      outputSchema: { ...base, refused: z.literal(true).optional() },
       annotations: { ...READ, openWorldHint: true },
     },
-    guard(async () => refuse()),
+    guard(async () => ({ isError: true, content: [{ type: 'text', text: `${PREVIEW_REFUSAL.code}: ${PREVIEW_REFUSAL.message}\nWhat to do instead: ${PREVIEW_REFUSAL.hint}` }], structuredContent: { ok: false, refused: true, error: PREVIEW_REFUSAL } })),
   )
 
   // ── resources: every document as tanqory://docs/<id> ──────────────────────