@design-ai/cli 4.55.0 → 4.56.0

package/cli/lib/site-bundle-repair-report.mjs

@@ -0,0 +1,143 @@
+// Repair report orchestration for Website Improvement handoff bundles.
+
+import path from "node:path";
+
+import {
+  addIssue,
+  analyzeSiteWorkspace,
+  loadSiteWorkspaceInput,
+  statusFromIssues,
+} from "./site-analysis.mjs";
+import { buildSiteHandoffBundle } from "./site-bundle-build.mjs";
+import { buildSiteBundleCheckReport } from "./site-bundle-check.mjs";
+import {
+  formatBundleRepairGuidanceLines,
+  summarizeBundleRepairCheck,
+} from "./site-bundle-repair.mjs";
+
+function buildSiteBundleRepairReportFromChecks({
+  beforeReport,
+  afterReport = null,
+  written = null,
+  applied = false,
+} = {}) {
+  const issues = [];
+  const repairGuidance = beforeReport.repairGuidance;
+
+  if (!repairGuidance.available) {
+    addIssue(issues, "fail", "bundle-repair-unavailable", repairGuidance.reason);
+  } else if (!applied) {
+    addIssue(issues, "pass", "bundle-repair-preview-ready", "Bundle repair preview is ready; run again with --yes to rewrite the handoff bundle directory");
+  } else if (!afterReport || afterReport.status !== "pass") {
+    addIssue(issues, "fail", "bundle-repair-verify-fail", "Bundle repair applied, but the repaired bundle did not pass bundle-check verification");
+  } else {
+    addIssue(issues, "pass", "bundle-repair-applied", "Bundle repair applied and the regenerated bundle passed local bundle-check verification");
+  }
+
+  const status = statusFromIssues(issues);
+  return {
+    directory: beforeReport.directory,
+    workspaceFile: path.join(beforeReport.directory, "website-workspace.tasks.json"),
+    dryRun: !applied,
+    applied,
+    valid: status !== "fail",
+    status,
+    repairGuidance,
+    before: summarizeBundleRepairCheck(beforeReport),
+    after: afterReport ? summarizeBundleRepairCheck(afterReport) : null,
+    written: written ? {
+      directory: written.directory,
+      files: written.files,
+      count: written.files.length,
+    } : null,
+    issues,
+  };
+}
+
+export function buildSiteBundleRepairPreview({
+  target,
+  cwd = process.cwd(),
+} = {}) {
+  const beforeReport = buildSiteBundleCheckReport({ target, cwd });
+  return buildSiteBundleRepairReportFromChecks({ beforeReport });
+}
+
+export function buildSiteBundleRepairBundle({
+  target,
+  cwd = process.cwd(),
+} = {}) {
+  const beforeReport = buildSiteBundleCheckReport({ target, cwd });
+  const preview = buildSiteBundleRepairReportFromChecks({ beforeReport });
+  if (!preview.repairGuidance.available) {
+    return {
+      preview,
+      beforeReport,
+      bundle: null,
+    };
+  }
+
+  const input = loadSiteWorkspaceInput({
+    target: preview.workspaceFile,
+    cwd,
+  });
+  const analyzed = analyzeSiteWorkspace(input.raw, { filePath: input.filePath });
+  const bundle = buildSiteHandoffBundle(analyzed.workspace, analyzed.summary);
+  return {
+    preview,
+    beforeReport,
+    bundle,
+  };
+}
+
+export function buildSiteBundleRepairAppliedReport({
+  beforeReport,
+  written,
+  cwd = process.cwd(),
+} = {}) {
+  const afterReport = buildSiteBundleCheckReport({
+    target: beforeReport.directory,
+    cwd,
+  });
+  return buildSiteBundleRepairReportFromChecks({
+    beforeReport,
+    afterReport,
+    written,
+    applied: true,
+  });
+}
+
+export function formatSiteBundleRepairJson(report) {
+  return JSON.stringify(report, null, 2);
+}
+
+export function formatSiteBundleRepairHuman(report) {
+  const afterLines = report.after ? [
+    `After status: ${report.after.status}`,
+    `After generated drift files: ${report.after.generatedDriftFiles.length ? report.after.generatedDriftFiles.join(", ") : "none"}`,
+    `After bundle digest: ${report.after.checksumBundleDigest || "not recorded"}`,
+  ] : [
+    "After status: not applied",
+  ];
+  return [
+    `Website Improvement handoff bundle repair: ${report.directory}`,
+    "",
+    `Status: ${report.status}`,
+    `Dry run: ${report.dryRun ? "yes" : "no"}`,
+    `Applied: ${report.applied ? "yes" : "no"}`,
+    `Workspace: ${report.workspaceFile}`,
+    `Before status: ${report.before.status}`,
+    `Before generated drift files: ${report.before.generatedDriftFiles.length ? report.before.generatedDriftFiles.join(", ") : "none"}`,
+    `Before bundle digest: ${report.before.checksumBundleDigest || "not recorded"}`,
+    ...afterLines,
+    ...(report.written ? [
+      `Written directory: ${report.written.directory}`,
+      `Written files: ${report.written.count}`,
+    ] : []),
+    "",
+    "Repair guidance:",
+    ...formatBundleRepairGuidanceLines(report.repairGuidance),
+    "",
+    "Issues:",
+    ...report.issues.map((issue) => `- [${issue.level}] ${issue.id}: ${issue.message}`),
+  ].join("\n");
+}

package/cli/lib/site-bundle-repair.mjs

@@ -0,0 +1,68 @@
+// Repair guidance helpers for Website Improvement handoff bundles.
+
+import {
+  existsSync,
+  statSync,
+} from "node:fs";
+import path from "node:path";
+
+import { shellQuote } from "./site-bundle-commands.mjs";
+
+export function buildBundleRepairGuidance(directory, generatedContract) {
+  const workspacePath = path.join(directory, "website-workspace.tasks.json");
+  const reportBaseName = path.basename(directory);
+  const reportDirectory = path.dirname(directory);
+  const previewReportPath = path.join(reportDirectory, `${reportBaseName}-repair-preview.json`);
+  const appliedReportPath = path.join(reportDirectory, `${reportBaseName}-repair-applied.json`);
+  const hasWorkspace = existsSync(workspacePath) && statSync(workspacePath).isFile();
+  const available = Boolean(generatedContract.available && hasWorkspace);
+  return {
+    available,
+    reason: available
+      ? "Regenerate the bundle from its embedded website-workspace.tasks.json when generated contract drift is reported."
+      : "Repair guidance requires a readable website-workspace.tasks.json and generated contract analysis.",
+    command: available ? `design-ai site ${shellQuote(workspacePath)} --bundle --out ${shellQuote(directory)} --force` : "",
+    previewCommand: available ? `design-ai site ${shellQuote(directory)} --bundle-repair --json` : "",
+    applyCommand: available ? `design-ai site ${shellQuote(directory)} --bundle-repair --yes --json` : "",
+    previewReportCommand: available ? `design-ai site ${shellQuote(directory)} --bundle-repair --json --out ${shellQuote(previewReportPath)}` : "",
+    applyReportCommand: available ? `design-ai site ${shellQuote(directory)} --bundle-repair --yes --json --out ${shellQuote(appliedReportPath)}` : "",
+    verifyCommand: available ? `design-ai site ${shellQuote(directory)} --bundle-check --strict --json` : "",
+    mutates: available ? "handoff-bundle-directory-only" : "none",
+    targetRepoMutation: false,
+    externalCalls: false,
+  };
+}
+
+export function formatBundleRepairGuidanceLines(repairGuidance) {
+  if (!repairGuidance.available) {
+    return [
+      `- Available: no`,
+      `- Reason: ${repairGuidance.reason}`,
+    ];
+  }
+  return [
+    "- Available: yes",
+    `- Reason: ${repairGuidance.reason}`,
+    `- Regenerate: ${repairGuidance.command}`,
+    `- Preview repair: ${repairGuidance.previewCommand}`,
+    `- Apply repair: ${repairGuidance.applyCommand}`,
+    `- Preview report: ${repairGuidance.previewReportCommand}`,
+    `- Apply report: ${repairGuidance.applyReportCommand}`,
+    `- Verify: ${repairGuidance.verifyCommand}`,
+    `- Scope: ${repairGuidance.mutates}; target repo mutation ${repairGuidance.targetRepoMutation ? "yes" : "no"}; external calls ${repairGuidance.externalCalls ? "yes" : "no"}`,
+  ];
+}
+
+export function summarizeBundleRepairCheck(report) {
+  return {
+    status: report.status,
+    valid: report.valid,
+    checksumBundleDigest: report.summary.checksumBundleDigest || "",
+    checksumFailures: report.counts.checksumFailures,
+    generatedFailures: report.counts.generatedFailures,
+    verifiedGeneratedFiles: report.counts.verifiedGeneratedFiles,
+    expectedGeneratedFiles: report.counts.expectedGeneratedFiles,
+    generatedDriftFiles: [...report.generatedContract.driftFiles],
+    issueCount: report.issues.length,
+  };
+}

package/cli/lib/site-content.mjs

@@ -0,0 +1,399 @@
+// Static Website Improvement content catalogs shared by the site CLI helpers.
+
+export const SITE_INTAKE_TEMPLATE_SECTIONS = [
+  "site-profile",
+  "priority-pages",
+  "primary-user-flows",
+  "brand-and-content-notes",
+  "mcp-readiness-notes",
+  "initial-audit-findings",
+  "first-bundle-commands",
+  "target-repo-verification-plan",
+  "stop-conditions",
+];
+
+export const SITE_INTAKE_TEMPLATE_MARKDOWN = `# Company Website Intake Template
+
+Fill this template before the first Website Improvement dogfood pass. Keep sensitive credentials, private tokens, production secrets, and customer data out of this document.
+
+## Site Profile
+
+| Field | Value |
+|---|---|
+| Site name | |
+| Live URL | |
+| Target repo URL | |
+| Target repo local path | |
+| Figma URL | |
+| Deploy provider | \`vercel\` / \`netlify\` / \`cloudflare\` / \`other\` / \`none\` |
+| Sentry project | |
+| CMS | \`sanity\` / \`contentful\` / \`wordpress\` / \`shopify\` / \`none\` / \`other\` |
+| Database | \`supabase\` / \`neon\` / \`postgres\` / \`none\` / \`other\` |
+
+## Priority Pages
+
+List 2-5 pages for the first pilot. Start with pages that affect conversion, trust, signup, inquiry, purchase, or onboarding.
+
+| Priority | Path or URL | Why it matters |
+|---:|---|---|
+| 1 | \`/\` | |
+| 2 | | |
+| 3 | | |
+| 4 | | |
+| 5 | | |
+
+## Primary User Flows
+
+| Priority | Flow | Success signal |
+|---:|---|---|
+| 1 | | |
+| 2 | | |
+| 3 | | |
+
+## Brand And Content Notes
+
+| Area | Notes |
+|---|---|
+| Brand tone | |
+| Typography constraints | |
+| Color constraints | |
+| Korean copy rules | |
+| Legal or compliance copy | |
+| Trust signals | |
+| Competitors or references | |
+
+## MCP Readiness Notes
+
+Mark each external system as \`required\`, \`optional\`, \`unused\`, or \`unavailable\`.
+
+| System | Status | Evidence or fallback |
+|---|---|---|
+| GitHub | | |
+| Figma | | |
+| Browser / Playwright | | |
+| Chrome DevTools | | |
+| Deploy provider | | |
+| Sentry | | |
+| Database | | |
+| CMS | | |
+| Collaboration tool | | |
+| Research tool | | |
+
+## Initial Audit Findings
+
+Capture only findings that are grounded in inspection. Do not invent Lighthouse, axe, crawler, or analytics results unless those tools were actually run in the target repo or browser.
+
+| Category | Finding | Evidence | Page |
+|---|---|---|---|
+| Visual design | | | |
+| UX flow | | | |
+| Responsive | | | |
+| Accessibility | | | |
+| Performance | | | |
+| SEO | | | |
+| Technical quality | | | |
+| Runtime issues | | | |
+| Content quality | | | |
+
+## First Bundle Commands
+
+Replace placeholders and run from the \`design-ai\` repository.
+
+\`\`\`bash
+design-ai site --init \\
+  --name "<site name>" \\
+  --live-url <live-url> \\
+  --local-path <absolute-target-repo-path> \\
+  --page / \\
+  --page <priority-page-2> \\
+  --flow "<primary user flow>" \\
+  --next-actions \\
+  --out website-next-actions.md \\
+  --force
+\`\`\`
+
+\`\`\`bash
+design-ai site --init \\
+  --name "<site name>" \\
+  --live-url <live-url> \\
+  --local-path <absolute-target-repo-path> \\
+  --page / \\
+  --page <priority-page-2> \\
+  --flow "<primary user flow>" \\
+  --bundle \\
+  --out website-handoff-bundle \\
+  --strict \\
+  --force
+\`\`\`
+
+\`\`\`bash
+design-ai site website-handoff-bundle --bundle-check --strict --json --out website-bundle-check.json --force
+design-ai site website-handoff-bundle --bundle-handoff --strict --out target-repo-handoff.md --force
+\`\`\`
+
+## Target Repo Verification Plan
+
+Fill this before implementation so the target-repo agent has a clear quality gate.
+
+| Gate | Command or manual check | Required for pilot |
+|---|---|---:|
+| Install | | yes |
+| Lint | | yes |
+| Typecheck | | if available |
+| Unit tests | | if available |
+| Build | | yes |
+| Browser smoke | | yes |
+| Accessibility spot check | | yes |
+| Deployment preview | | if available |
+
+## Stop Conditions
+
+Stop before target-repo edits when any answer is unclear:
+
+- Which repo and branch should be modified?
+- Which single task should be implemented first?
+- Which verification commands must pass?
+- Which credentials or production systems are off limits?
+- Where should implementation evidence be recorded after the target-repo pass?
+`;
+
+export const SITE_INTAKE_TEMPLATE_MARKDOWN_KO = `# 회사 웹사이트 Intake Template
+
+첫 Website Improvement dogfood 전에 이 template을 채웁니다. 민감한 credential, private token, production secret, 고객 데이터는 이 문서에 적지 않습니다.
+
+## Site Profile
+
+| 항목 | 값 |
+|---|---|
+| 사이트 이름 | |
+| Live URL | |
+| 대상 repo URL | |
+| 대상 repo local path | |
+| Figma URL | |
+| 배포 플랫폼 | \`vercel\` / \`netlify\` / \`cloudflare\` / \`other\` / \`none\` |
+| Sentry 프로젝트 | |
+| CMS | \`sanity\` / \`contentful\` / \`wordpress\` / \`shopify\` / \`none\` / \`other\` |
+| Database | \`supabase\` / \`neon\` / \`postgres\` / \`none\` / \`other\` |
+
+## 우선순위 페이지
+
+첫 pilot에서는 2-5개 페이지를 고릅니다. 전환, 신뢰, 가입, 문의, 구매, 온보딩에 영향을 주는 페이지부터 시작합니다.
+
+| 우선순위 | Path 또는 URL | 중요한 이유 |
+|---:|---|---|
+| 1 | \`/\` | |
+| 2 | | |
+| 3 | | |
+| 4 | | |
+| 5 | | |
+
+## 주요 사용자 흐름
+
+| 우선순위 | Flow | 성공 신호 |
+|---:|---|---|
+| 1 | | |
+| 2 | | |
+| 3 | | |
+
+## Brand And Content Notes
+
+| 영역 | 메모 |
+|---|---|
+| 브랜드 톤 | |
+| 타이포그래피 제약 | |
+| 컬러 제약 | |
+| 한국어 카피 규칙 | |
+| 법무 또는 compliance 문구 | |
+| 신뢰 요소 | |
+| 경쟁사 또는 레퍼런스 | |
+
+## MCP Readiness Notes
+
+각 외부 시스템을 \`required\`, \`optional\`, \`unused\`, \`unavailable\` 중 하나로 표시합니다.
+
+| 시스템 | 상태 | 근거 또는 fallback |
+|---|---|---|
+| GitHub | | |
+| Figma | | |
+| Browser / Playwright | | |
+| Chrome DevTools | | |
+| 배포 플랫폼 | | |
+| Sentry | | |
+| Database | | |
+| CMS | | |
+| 협업 도구 | | |
+| 리서치 도구 | | |
+
+## 초기 Audit Findings
+
+실제로 확인한 finding만 기록합니다. Lighthouse, axe, crawler, analytics를 실제로 실행하지 않았다면 해당 결과를 만들어 쓰지 않습니다.
+
+| Category | Finding | Evidence | Page |
+|---|---|---|---|
+| Visual design | | | |
+| UX flow | | | |
+| Responsive | | | |
+| Accessibility | | | |
+| Performance | | | |
+| SEO | | | |
+| Technical quality | | | |
+| Runtime issues | | | |
+| Content quality | | | |
+
+## 첫 Bundle Commands
+
+placeholder를 바꾼 뒤 \`design-ai\` repo에서 실행합니다.
+
+\`\`\`bash
+design-ai site --init \\
+  --name "<site name>" \\
+  --live-url <live-url> \\
+  --local-path <absolute-target-repo-path> \\
+  --page / \\
+  --page <priority-page-2> \\
+  --flow "<primary user flow>" \\
+  --next-actions \\
+  --out website-next-actions.md \\
+  --force
+\`\`\`
+
+\`\`\`bash
+design-ai site --init \\
+  --name "<site name>" \\
+  --live-url <live-url> \\
+  --local-path <absolute-target-repo-path> \\
+  --page / \\
+  --page <priority-page-2> \\
+  --flow "<primary user flow>" \\
+  --bundle \\
+  --out website-handoff-bundle \\
+  --strict \\
+  --force
+\`\`\`
+
+\`\`\`bash
+design-ai site website-handoff-bundle --bundle-check --strict --json --out website-bundle-check.json --force
+design-ai site website-handoff-bundle --bundle-handoff --strict --out target-repo-handoff.md --force
+\`\`\`
+
+## Target Repo Verification Plan
+
+구현 전에 채워서 target-repo agent가 명확한 quality gate를 갖게 합니다.
+
+| Gate | 명령 또는 수동 확인 | Pilot 필수 |
+|---|---|---:|
+| Install | | 예 |
+| Lint | | 예 |
+| Typecheck | | 가능하면 |
+| Unit tests | | 가능하면 |
+| Build | | 예 |
+| Browser smoke | | 예 |
+| Accessibility spot check | | 예 |
+| Deployment preview | | 가능하면 |
+
+## Stop Conditions
+
+아래 질문 중 하나라도 불명확하면 target repo 수정 전에 멈춥니다.
+
+- 어떤 repo와 branch를 수정해야 하는가?
+- 첫 번째로 구현할 single task는 무엇인가?
+- 어떤 verification command가 반드시 통과해야 하는가?
+- 어떤 credential 또는 production system이 off limits인가?
+- target-repo pass 이후 implementation evidence를 어디에 기록해야 하는가?
+`;
+
+export const SITE_PROMPT_TEMPLATE_IDS = [
+  "codex-repo-intake",
+  "codex-implementation",
+  "codex-visual-qa",
+  "codex-deployment",
+  "claude-design-review",
+  "claude-competitor",
+  "claude-copy-ux",
+  "handoff-report",
+];
+
+export const SITE_BUNDLE_FILES = [
+  "README.md",
+  "summary.json",
+  "website-workspace.tasks.json",
+  "mcp-check.json",
+  "mcp-probes.json",
+  "mcp-action-plan.md",
+  "website-handoff.md",
+  "website-prompts.md",
+  "codex-implementation.md",
+];
+
+export const SITE_BUNDLE_CHECKSUM_FILES = SITE_BUNDLE_FILES.filter((filePath) => filePath !== "summary.json");
+
+export const SITE_PROMPT_TEMPLATES = [
+  {
+    id: "codex-repo-intake",
+    label: "Codex repo intake",
+    agent: "codex",
+    output: "Repository inspection plan",
+    description: "Inspect the target website repo and return structure, likely touch points, risks, and verification commands.",
+    taskSelectable: false,
+  },
+  {
+    id: "codex-implementation",
+    label: "Codex implementation",
+    agent: "codex",
+    output: "Focused implementation prompt",
+    description: "Implement the selected website improvement task in the target repo with scoped verification.",
+    taskSelectable: true,
+  },
+  {
+    id: "codex-visual-qa",
+    label: "Codex visual QA",
+    agent: "codex",
+    output: "Browser/Playwright QA checklist",
+    description: "Verify priority pages across configured viewports for layout, focus, console, and asset issues.",
+    taskSelectable: false,
+  },
+  {
+    id: "codex-deployment",
+    label: "Codex deployment verification",
+    agent: "codex",
+    output: "Deployment verification prompt",
+    description: "Check preview or production deployment, logs, metadata, user flows, and remaining launch risks.",
+    taskSelectable: false,
+  },
+  {
+    id: "claude-design-review",
+    label: "Claude design review",
+    agent: "claude",
+    output: "Senior design critique",
+    description: "Review visual hierarchy, layout rhythm, typography, CTA clarity, responsive behavior, and accessibility concerns.",
+    taskSelectable: false,
+  },
+  {
+    id: "claude-competitor",
+    label: "Claude competitor research",
+    agent: "claude",
+    output: "Competitor opportunity map",
+    description: "Compare relevant peer sites for structure, conversion path, proof, pricing, tone, content, and SEO positioning.",
+    taskSelectable: false,
+  },
+  {
+    id: "claude-copy-ux",
+    label: "Claude copy/UX critique",
+    agent: "claude",
+    output: "Copy and UX improvement notes",
+    description: "Critique copy, information architecture, trust signals, CTA language, and conversion flow.",
+    taskSelectable: false,
+  },
+  {
+    id: "handoff-report",
+    label: "Final handoff report",
+    agent: "codex-or-claude",
+    output: "Final handoff report prompt",
+    description: "Generate a final report covering target site info, audit summary, recommendations, executed work, verification, risks, and next actions.",
+    taskSelectable: false,
+  },
+];
+
+if (SITE_PROMPT_TEMPLATE_IDS.join("\n") !== SITE_PROMPT_TEMPLATES.map((template) => template.id).join("\n")) {
+  throw new Error("SITE_PROMPT_TEMPLATES must match SITE_PROMPT_TEMPLATE_IDS order");
+}

package/cli/lib/site-evidence.mjs

@@ -0,0 +1,35 @@
+// Implementation evidence helpers for Website Improvement workspaces.
+
+import { normalizeStringArray } from "./site-strings.mjs";
+
+export const IMPLEMENTATION_EVIDENCE_KEYS = ["executedWork", "verificationResults", "remainingRisks", "nextActions"];
+
+export const DEFAULT_IMPLEMENTATION_RISKS = [
+  "MCP readiness gaps may limit verification depth.",
+  "Copy or brand changes may require stakeholder review.",
+  "Automated performance/accessibility tooling is outside this MVP unless run in the target repo.",
+];
+
+function normalizeObject(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+
+export function normalizeImplementationEvidence(value) {
+  const source = normalizeObject(value);
+  return {
+    executedWork: normalizeStringArray(source.executedWork),
+    verificationResults: normalizeStringArray(source.verificationResults),
+    remainingRisks: normalizeStringArray(source.remainingRisks, DEFAULT_IMPLEMENTATION_RISKS),
+    nextActions: normalizeStringArray(source.nextActions),
+  };
+}
+
+export function countImplementationEvidence(value = {}) {
+  const source = normalizeObject(value);
+  return Object.fromEntries(IMPLEMENTATION_EVIDENCE_KEYS.map((key) => {
+    const items = source[key];
+    if (Array.isArray(items)) return [key, items.length];
+    if (Number.isInteger(items) && items >= 0) return [key, items];
+    return [key, 0];
+  }));
+}

package/cli/lib/site-mcp-commands.mjs

@@ -0,0 +1,28 @@
+// Command helpers for Website Improvement MCP readiness flows.
+
+export function siteMcpCommandTarget(filePath) {
+  return filePath === "stdin" ? "<workspace.json>" : filePath;
+}
+
+export function buildSiteMcpProbeCommandSet(commandTarget) {
+  return {
+    mcpCheckProbesHumanOut: `design-ai site ${commandTarget} --mcp-check --probes --out mcp-check-probes.txt`,
+    mcpCheckProbesJsonOut: `design-ai site ${commandTarget} --mcp-check --probes --json --out mcp-check-probes.json`,
+    mcpPlanProbesJson: `design-ai site ${commandTarget} --mcp-plan --probes --json`,
+    mcpPlanProbesJsonOut: `design-ai site ${commandTarget} --mcp-plan --probes --json --out mcp-action-plan-probes.json`,
+  };
+}
+
+export function buildSiteNextActionCommandSet(commandTarget) {
+  return {
+    summary: `design-ai site ${commandTarget} --json`,
+    mcpCheck: `design-ai site ${commandTarget} --mcp-check --strict --json`,
+    mcpPlan: `design-ai site ${commandTarget} --mcp-plan --out mcp-action-plan.md`,
+    mcpCheckProbes: `design-ai site ${commandTarget} --mcp-check --probes --json --out mcp-check-probes.json`,
+    mcpPlanProbes: `design-ai site ${commandTarget} --mcp-plan --probes --json --out mcp-action-plan-probes.json`,
+    tasks: `design-ai site ${commandTarget} --tasks --out website-workspace.tasks.json`,
+    implementationPrompt: `design-ai site ${commandTarget} --prompt codex-implementation --task 1 --out codex-implementation.md`,
+    handoffReport: `design-ai site ${commandTarget} --report --out website-handoff.md`,
+    handoffBundle: `design-ai site ${commandTarget} --bundle --out website-handoff-bundle`,
+  };
+}