apiblaze 0.21.65 → 0.21.67

package/dist/index.js

@@ -34,7 +34,7 @@ var __toESM = (mod, isNodeMode, target2) => (target2 = mod != null ? __create(__
 var version;
 var init_package = __esm({
   "package.json"() {
-    version = "0.21.65";
+    version = "0.21.67";
   }
 });
 
@@ -5166,6 +5166,12 @@ var init_key = __esm({
 });
 
 // src/lib/directory-probes.ts
+var directory_probes_exports = {};
+__export(directory_probes_exports, {
+  PROBE_TIMEOUT_MS: () => PROBE_TIMEOUT_MS,
+  asMetadataUrl: () => asMetadataUrl,
+  probeDirectoryTarget: () => probeDirectoryTarget
+});
 async function probe(url, init, deps) {
   const f2 = deps.fetch ?? fetch;
   const now = deps.now ?? (() => Date.now());
@@ -5311,6 +5317,7 @@ __export(directory_exports, {
   ATTESTATIONS: () => ATTESTATIONS,
   AUTH_MODES: () => AUTH_MODES,
   DATA_HANDLING_MODES: () => DATA_HANDLING_MODES,
+  DESCRIPTION_MIN: () => DESCRIPTION_MIN,
   PLATFORMS: () => PLATFORMS,
   attestationId: () => attestationId,
   blockerLines: () => blockerLines,
@@ -5445,7 +5452,7 @@ function printReport(r, json) {
     process.stdout.write(JSON.stringify(r) + "\n");
     return;
   }
-  console.log(r.rendered.text);
+  console.log(r.rendered.text.replace(/<project>/g, r.report.project.id));
   if (r.probe_note) console.log(import_chalk17.default.dim(r.probe_note));
 }
 function blockerLines(r, platforms) {
@@ -5456,7 +5463,7 @@ function blockerLines(r, platforms) {
 function isApiError(e, status2) {
   return e instanceof ApiError && (status2 === void 0 || e.status === status2);
 }
-var import_chalk17, PLATFORMS, ATTESTATIONS, AUTH_MODES, DATA_HANDLING_MODES, reportPath;
+var import_chalk17, PLATFORMS, ATTESTATIONS, AUTH_MODES, DATA_HANDLING_MODES, reportPath, DESCRIPTION_MIN;
 var init_directory = __esm({
   "src/lib/directory.ts"() {
     "use strict";
@@ -5482,6 +5489,7 @@ var init_directory = __esm({
     AUTH_MODES = ["signin", "open"];
     DATA_HANDLING_MODES = ["own", "proxied", "third-party"];
     reportPath = (proj2) => `/projects/${encodeURIComponent(proj2.projectId)}/${encodeURIComponent(proj2.apiVersion)}/directory-report`;
+    DESCRIPTION_MIN = 300;
   }
 });
 
@@ -7186,225 +7194,6 @@ var init_agent = __esm({
   }
 });
 
-// src/lib/directory-docs.ts
-function directoryDocsPrompt(facts) {
-  return [
-    `Write the three documents a connector listing needs for "${facts.name}", from the FACTS below and nothing else.`,
-    "Rules: plain English, second person, no marketing, no prices, no promo. Never invent a result: when you describe what a tool returns, cite only the recorded result shapes in the facts (keys, item counts, heads); if none is recorded, say what the tool is for and that the assistant will show the result.",
-    "Never write credentials, usernames, tokens or internal hostnames. Troubleshooting cites the failure modes with their exact texts.",
-    `The sign-in: ${facts.sign_in_shape}`,
-    `Answer with JSON matching the schema: docs_markdown (the public page "Using <name> in Claude": purpose \xB7 how it works from Claude's side \xB7 connect and sign in \xB7 the example prompts with what to expect \xB7 troubleshooting \xB7 support), reviewer_markdown (for someone who has never seen the product: add the connector, the sign-in screen, the account, what data it holds, one prompt per tool with the recorded result shape), portal_answers (use_cases 200+ chars, prerequisites one sentence, access, 1\u20135 categories).`,
-    "",
-    "FACTS:",
-    JSON.stringify(facts, null, 2)
-  ].join("\n");
-}
-function lintDocument(markdown, opts = {}) {
-  const out = [];
-  const text = markdown ?? "";
-  if (!text.trim()) out.push({ code: "EMPTY", detail: "the document is empty" });
-  if (text.length > DIRECTORY_DOC_MAX_CHARS) out.push({ code: "TOO_LONG", detail: `${text.length} characters; the limit is ${DIRECTORY_DOC_MAX_CHARS}` });
-  const u = (opts.reviewerUsername ?? "").trim();
-  if (u.length >= 3 && text.toLowerCase().includes(u.toLowerCase())) out.push({ code: "REVIEWER_USERNAME", detail: "the reviewer username appears; it belongs in the packet only" });
-  if (BEARER_LIKE.test(text)) out.push({ code: "BEARER_LIKE", detail: "a bearer-like or JWT-shaped string appears" });
-  if (KEY_LIKE.test(text)) out.push({ code: "KEY_LIKE", detail: "a key-like string (sk_/pk_/\u2026) appears" });
-  if (PASSWORD_LINE.test(text)) out.push({ code: "PASSWORD_LINE", detail: "a password-like line appears" });
-  if (opts.public && INTERNAL_HOST.test(text)) out.push({ code: "INTERNAL_HOST", detail: "an upstream or platform-internal host appears" });
-  return out;
-}
-function parseGeneratedDocs(stdout) {
-  const tryObj = (v) => {
-    if (!v || typeof v !== "object") return null;
-    const o = v;
-    const pa = o.portal_answers;
-    if (typeof o.docs_markdown !== "string" || typeof o.reviewer_markdown !== "string" || !pa || typeof pa !== "object") return null;
-    return { docs_markdown: o.docs_markdown, reviewer_markdown: o.reviewer_markdown, portal_answers: { use_cases: String(pa.use_cases ?? ""), prerequisites: String(pa.prerequisites ?? ""), access: ["read", "write", "both"].includes(String(pa.access)) ? String(pa.access) : "both", categories: Array.isArray(pa.categories) ? pa.categories.map(String).slice(0, 5) : [] } };
-  };
-  let parsed = null;
-  try {
-    parsed = JSON.parse(stdout.trim());
-  } catch {
-    parsed = null;
-  }
-  if (parsed && typeof parsed === "object") {
-    const o = parsed;
-    const direct = tryObj(o);
-    if (direct) return direct;
-    const so = tryObj(o.structured_output);
-    if (so) return so;
-    if (typeof o.result === "string") {
-      try {
-        const r = tryObj(JSON.parse(o.result));
-        if (r) return r;
-      } catch {
-      }
-    }
-  }
-  for (const line of stdout.split("\n").reverse()) {
-    const s = line.trim();
-    if (!s.startsWith("{")) continue;
-    try {
-      const ev = JSON.parse(s);
-      const so = tryObj(ev.structured_output);
-      if (so) return so;
-      if (typeof ev.result === "string") {
-        const r = tryObj(JSON.parse(ev.result));
-        if (r) return r;
-      }
-    } catch {
-    }
-  }
-  return null;
-}
-var DIRECTORY_DOCS_JSON_SCHEMA, DIRECTORY_DOC_MAX_CHARS, BEARER_LIKE, KEY_LIKE, PASSWORD_LINE, INTERNAL_HOST;
-var init_directory_docs = __esm({
-  "src/lib/directory-docs.ts"() {
-    "use strict";
-    DIRECTORY_DOCS_JSON_SCHEMA = {
-      type: "object",
-      additionalProperties: false,
-      required: ["docs_markdown", "reviewer_markdown", "portal_answers"],
-      properties: {
-        docs_markdown: { type: "string", description: `The public documentation page, Markdown: "Using <name> in Claude" \u2014 purpose, how it works from Claude's side, connect and sign in, the three prompts with what to expect, troubleshooting (the known failure modes with their exact texts), support.` },
-        reviewer_markdown: { type: "string", description: "Reviewer instructions for someone who has never seen the product: add the connector, the sign-in screen, the account, what data it holds, one prompt per tool with the recorded result shape. No credentials." },
-        portal_answers: {
-          type: "object",
-          additionalProperties: false,
-          required: ["use_cases", "prerequisites", "access", "categories"],
-          properties: {
-            use_cases: { type: "string", description: "What a person asks it, in their words; 200+ characters." },
-            prerequisites: { type: "string", description: "What a user needs before it works, one sentence." },
-            access: { type: "string", enum: ["read", "write", "both"] },
-            categories: { type: "array", items: { type: "string" }, minItems: 1, maxItems: 5, description: "Free-text category suggestions; the producer picks the closest in the portal." }
-          }
-        }
-      }
-    };
-    DIRECTORY_DOC_MAX_CHARS = 64e3;
-    BEARER_LIKE = /(?:bearer\s+[A-Za-z0-9._~+/=-]{8,}|\b[A-Za-z0-9_-]{20,}\.[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\b)/i;
-    KEY_LIKE = /\b(?:sk|pk|rk|key|tok|abz)_[A-Za-z0-9_-]{8,}\b/i;
-    PASSWORD_LINE = /^\s*(?:[-*]\s*)?(?:\*\*)?(?:password|passwd|pwd|secret)(?:\*\*)?\s*[:=]\s*\S+/im;
-    INTERNAL_HOST = /\b[a-z0-9.-]+\.(abz\.run|tryabz\.run|workers\.dev)\b/i;
-  }
-});
-
-// src/commands/connector-docs.ts
-var connector_docs_exports = {};
-__export(connector_docs_exports, {
-  askDocsQuestion: () => askDocsQuestion,
-  generateWithClaude: () => generateWithClaude,
-  runConnectorDocs: () => runConnectorDocs,
-  storeGeneratedDocs: () => storeGeneratedDocs,
-  verifyDocsUrl: () => verifyDocsUrl
-});
-function generateWithClaude(prompt, deps = {}) {
-  const spawn5 = deps.spawn ?? import_child_process5.spawnSync;
-  const res = spawn5("claude", ["-p", prompt, "--output-format", "json", "--json-schema", JSON.stringify(DIRECTORY_DOCS_JSON_SCHEMA), "--tools", "", "--max-budget-usd", "2", "--permission-mode", "dontAsk"], { encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"], timeout: 24e4, env: { ...process.env, CLAUDECODE: "" } });
-  const docs = parseGeneratedDocs(String(res.stdout ?? ""));
-  return { docs, detail: docs ? "generated on Claude Code" : `Claude Code answered without the three documents${res.status != null && res.status !== 0 ? ` (exit ${res.status})` : ""}` };
-}
-async function storeGeneratedDocs(caller, proj2, docs, o) {
-  const bad = [...lintDocument(docs.docs_markdown, { reviewerUsername: o.reviewerUsername, public: true }).map((f2) => `docs: ${f2.code}`), ...lintDocument(docs.reviewer_markdown, { reviewerUsername: o.reviewerUsername }).map((f2) => `reviewer: ${f2.code}`)];
-  if (bad.length) throw new Error(`The generated documents were refused by the lint (${bad.join(", ")}); nothing was stored. Run again, or write them by hand on the dashboard page.`);
-  const out = await producer(caller, { method: "PUT", path: `${projectPath(proj2)}/directory-documents`, body: { docs_markdown: docs.docs_markdown, reviewer_markdown: docs.reviewer_markdown, portal_answers: docs.portal_answers, source: "generated", facts_hash: o.factsHash, use_generated_docs_url: o.useGeneratedDocsUrl }, summary: "Store the generated documents" });
-  return out.changed ?? [];
-}
-async function verifyDocsUrl(url, serverName, f2 = fetch) {
-  if (!/^https:\/\/\S+$/i.test(url)) return { ok: false, reason: "not an https URL" };
-  try {
-    const r = await f2(url, { redirect: "follow", signal: AbortSignal.timeout(8e3), headers: { accept: "text/html, */*;q=0.5", "user-agent": "apiblaze-cli directory-check" } });
-    if (r.status !== 200) return { ok: false, reason: `answered ${r.status}` };
-    const body = (await r.text().catch(() => "")).toLowerCase();
-    if (serverName && !body.includes(serverName.toLowerCase())) return { ok: false, reason: `the page does not mention "${serverName}"` };
-    return { ok: true, reason: "live" };
-  } catch (e) {
-    return { ok: false, reason: e instanceof Error ? e.message : "unreachable" };
-  }
-}
-async function runConnectorDocs(project, opts = {}) {
-  const caller = await requireCaller();
-  const { teamId } = await resolveActingTeam(caller, opts.team);
-  const proj2 = await resolveProjectVia(caller, teamId, project, opts.apiversion);
-  const json = !!opts.json;
-  const say = (s) => {
-    if (!json) console.log(s);
-  };
-  const deps = opts.deps ?? {};
-  const fr = await producer(caller, { method: "GET", path: `${projectPath(proj2)}/directory-facts?view=packet`, summary: "The facts the generator reads" });
-  const prompt = directoryDocsPrompt(fr.facts);
-  let docs = null;
-  let how = "";
-  if (opts.from) {
-    docs = parseGeneratedDocs(import_fs5.default.readFileSync(opts.from, "utf8"));
-    if (!docs) throw new Error(`${opts.from} does not hold the three documents (docs_markdown, reviewer_markdown, portal_answers).`);
-    how = `from ${opts.from}`;
-  } else if (opts.promptOut) {
-    import_fs5.default.writeFileSync(opts.promptOut, prompt + "\n", { mode: 384 });
-    say(import_chalk26.default.green(`  \u2713 prompt written to ${opts.promptOut}`));
-    say(import_chalk26.default.dim(`  Run it through a model that answers JSON matching the schema, save the answer, then: ${B.cli} connector docs ${proj2.projectName} --from <answer.json>`));
-    return;
-  } else {
-    const installed3 = deps.claudeInstalled ?? detectExternalClis().some((c) => c.kind === "claude");
-    if (!installed3) {
-      const file2 = import_path4.default.join(import_os2.default.tmpdir(), `apiblaze-connector-docs-${proj2.projectId}.txt`);
-      import_fs5.default.writeFileSync(file2, prompt + "\n", { mode: 384 });
-      throw new Error(`Claude Code is not installed here, so the documents were not generated. The prompt is at ${file2}: run it through any model that answers JSON, then \`${B.cli} connector docs ${proj2.projectName} --from <answer.json>\`; or write them on the dashboard page.`);
-    }
-    say(import_chalk26.default.dim("  generating the three documents on Claude Code (30\u201390 s)\u2026"));
-    const g = generateWithClaude(prompt, deps);
-    if (!g.docs) throw new Error(`${g.detail}. Run again, or \`${B.cli} connector docs ${proj2.projectName} --prompt-out prompt.txt\` to use another model.`);
-    docs = g.docs;
-    how = g.detail;
-  }
-  const changed = await storeGeneratedDocs(caller, proj2, docs, { factsHash: fr.facts_hash, reviewerUsername: fr.facts.reviewer_username ?? null, useGeneratedDocsUrl: true });
-  if (json) {
-    process.stdout.write(JSON.stringify({ project: proj2.projectId, changed, docs_url: fr.generated_docs_url, how }) + "\n");
-    return;
-  }
-  console.log(import_chalk26.default.green(`  \u2713 documents stored (${how}): ${changed.join(", ")}`));
-  console.log(`  Documentation page: ${import_chalk26.default.cyan(fr.generated_docs_url)} \u2014 link it from your site; edit it on the dashboard any time.`);
-}
-async function askDocsQuestion(caller, proj2, state, interactive2, say, deps = {}) {
-  if (!interactive2) return false;
-  const { default: inquirer3 } = await import("inquirer");
-  const a = await inquirer3.prompt([{ type: "input", name: "value", message: `Documentation for this connector on your site? Paste the URL, or N to use the generated page at ${state.generatedDocsUrl} (and link it from your site):`, default: state.docsUrl ?? "N" }]);
-  const v = a.value.trim();
-  if (!v || /^n(o)?$/i.test(v)) {
-    say(import_chalk26.default.dim("  using the generated page"));
-    try {
-      await runConnectorDocs(proj2.projectName, { deps, yes: true });
-    } catch (e) {
-      say(import_chalk26.default.yellow(`  ${e instanceof Error ? e.message : String(e)}`));
-      await producer(caller, { method: "PUT", path: `${projectPath(proj2)}/directory-documents`, body: { use_generated_docs_url: true }, summary: "Point docs at the generated page" });
-    }
-    return true;
-  }
-  const check = await verifyDocsUrl(v, state.serverName, deps.fetch);
-  if (!check.ok) {
-    say(import_chalk26.default.yellow(`  ${v} is not usable as documentation yet: ${check.reason}. Not stored.`));
-    return false;
-  }
-  await producer(caller, { method: "PATCH", path: projectPath(proj2), body: { directory_metadata: { docs_url: v, docs_confirmed: true } }, summary: "Store the documentation URL" });
-  say(import_chalk26.default.green(`  \u2713 docs: ${v} (live, names ${state.serverName ?? "the server"})`));
-  return true;
-}
-var import_chalk26, import_fs5, import_os2, import_path4, import_child_process5, projectPath;
-var init_connector_docs = __esm({
-  "src/commands/connector-docs.ts"() {
-    "use strict";
-    import_chalk26 = __toESM(require("chalk"));
-    import_fs5 = __toESM(require("fs"));
-    import_os2 = __toESM(require("os"));
-    import_path4 = __toESM(require("path"));
-    import_child_process5 = require("child_process");
-    init_caller();
-    init_directory_docs();
-    init_external_mcp();
-    init_brand();
-    projectPath = (p) => `/projects/${encodeURIComponent(p.projectId)}/${encodeURIComponent(p.apiVersion)}`;
-  }
-});
-
 // src/lib/headless-login.ts
 async function discover(mcpUrl2, deps = {}) {
   const out = { mcpUrl: mcpUrl2, unauthStatus: 0, prmUrl: null, prm: null, asUrl: null, as: null };
@@ -7579,7 +7368,8 @@ function orderTools(tools) {
   const rank = { read: 0, create: 1, update: 2, write: 3, delete: 4 };
   return [...tools].sort((a, b) => rank[toolRole(a)] - rank[toolRole(b)] || a.name.localeCompare(b.name));
 }
-function exampleValue(name, p, known = {}) {
+function exampleValue(name, p, known = {}, given = {}) {
+  if (given[name] !== void 0) return given[name];
   if (p.example !== void 0 && p.example !== null) return p.example;
   if (known[name] !== void 0) return known[name];
   if (Array.isArray(p.enum) && p.enum.length) return p.enum[0];
@@ -7598,22 +7388,34 @@ function exampleValue(name, p, known = {}) {
   if (/(^|_)(q|query|search|term|text|name|title)$/i.test(name)) return "test";
   return "example";
 }
-function validArgs(t, known = {}) {
+function validArgs(t, known = {}, given = {}) {
   const out = {};
   const props = t.inputProperties ?? {};
   const pathParams = new Set([...(t.path ?? "").matchAll(/\{([^}]+)\}/g)].map((m) => m[1]));
   for (const [name, p] of Object.entries(props)) {
-    const wanted = p.required || pathParams.has(name) || p.example !== void 0 && p.example !== null || known[name] !== void 0;
+    const wanted = p.required || pathParams.has(name) || p.example !== void 0 && p.example !== null || known[name] !== void 0 || given[name] !== void 0;
     if (!wanted) continue;
-    out[name] = exampleValue(name, p, known);
+    out[name] = exampleValue(name, p, known, given);
   }
   return out;
 }
-function invalidArgs(t, known = {}) {
+function candidateFromPrompts(name, p, prompts) {
+  const fmt = (p.format ?? "").toLowerCase();
+  const text = prompts.join("\n");
+  if (fmt === "uri" || fmt === "url" || URLISH.test(name)) {
+    const m = text.match(/https?:\/\/[^\s"'<>)]+/);
+    if (m) return m[0].replace(/[.,;:!?]+$/, "");
+    const bare = text.match(/\b[a-z0-9-]+(\.[a-z0-9-]+)*\.[a-z]{2,}(\/[^\s"'<>)]*)?/i);
+    return bare ? bare[0].replace(/[.,;:!?]+$/, "") : null;
+  }
+  const quoted = text.match(/["“']([^"”']{1,80})["”']/);
+  return quoted ? quoted[1].trim() : null;
+}
+function invalidArgs(t, known = {}, given = {}) {
   const props = t.inputProperties ?? {};
   const names = Object.keys(props);
   if (!names.length) return null;
-  const base2 = validArgs(t, known);
+  const base2 = validArgs(t, known, given);
   const withEnum = names.find((n) => Array.isArray(props[n].enum) && props[n].enum.length);
   if (withEnum) return { args: { ...base2, [withEnum]: "not-a-valid-choice" }, broke: `${withEnum}: out of enum` };
   const typed = names.find((n) => ["integer", "number", "boolean"].includes((props[n].type ?? "").toLowerCase()));
@@ -7656,7 +7458,7 @@ function localOutcome(r) {
   if (b && typeof b === "object" && b.error) return { outcome: "no_call", text: typeof b.error.message === "string" ? b.error.message : "JSON-RPC error" };
   const result = b && typeof b === "object" ? b.result : null;
   if (result && typeof result === "object") {
-    const text = Array.isArray(result.content) ? result.content.filter((c) => c && c.type === "text").map((c) => String(c.text)).join(" ").slice(0, 200) : "";
+    const text = Array.isArray(result.content) ? result.content.filter((c) => c && c.type === "text").map((c) => String(c.text)).join(" ").slice(0, 65536) : "";
     return result.isError ? { outcome: "error", text } : { outcome: "ok", text };
   }
   return { outcome: "no_call", text: `HTTP ${r.status}` };
@@ -7684,8 +7486,9 @@ function claudeRecipe(o) {
     ""
   ];
 }
-function mcpConfigDocument(url, bearer) {
-  return JSON.stringify({ mcpServers: { abz: { type: "http", url, ...bearer ? { headers: { Authorization: `Bearer ${bearer}` } } : {} } } }, null, 2) + "\n";
+function mcpConfigDocument(url, bearer, runId2) {
+  const headers = { ...bearer ? { Authorization: `Bearer ${bearer}` } : {}, ...runId2 ? { "apiblaze-directory-run": runId2 } : {} };
+  return JSON.stringify({ mcpServers: { abz: { type: "http", url, ...Object.keys(headers).length ? { headers } : {} } } }, null, 2) + "\n";
 }
 function toolCallsInClaudeOutput(stdout) {
   const names = /* @__PURE__ */ new Set();
@@ -7707,21 +7510,143 @@ function toolCallsInClaudeOutput(stdout) {
 function redactHead(text, max = 200) {
   return text.replace(SECRETISH, "[redacted]").slice(0, max);
 }
-var ID_PARAM, SECRETISH;
+var ID_PARAM, URLISH, SECRETISH;
 var init_exercise = __esm({
   "src/lib/exercise.ts"() {
     "use strict";
     ID_PARAM = /(^|_)(id|uuid|key|slug|number|no)$/i;
+    URLISH = /(^|_)(url|uri|link|website|site|homepage|repo|repository)$/i;
     SECRETISH = /(bearer\s+[A-Za-z0-9._~+/=-]{8,}|[A-Za-z0-9_-]{20,}\.[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}|\b(?:sk|pk|rk|key|tok|abz)_[A-Za-z0-9_-]{8,})/gi;
   }
 });
 
+// src/lib/portal-drafts.ts
+var portal_drafts_exports = {};
+__export(portal_drafts_exports, {
+  ANSWER_MIN: () => ANSWER_MIN,
+  describeResult: () => describeResult,
+  draftDescription: () => draftDescription,
+  draftMissing: () => draftMissing,
+  draftReviewerInstructions: () => draftReviewerInstructions,
+  draftUseCases: () => draftUseCases
+});
+function describeResult(text) {
+  const t = (text ?? "").trim();
+  if (!t) return "an empty answer";
+  try {
+    const v = JSON.parse(t);
+    if (Array.isArray(v)) return v.length ? `a list of ${v.length} item${v.length === 1 ? "" : "s"}${v[0] && typeof v[0] === "object" ? ` with ${Object.keys(v[0]).slice(0, 8).join(", ")}` : ""}` : "an empty list";
+    if (v && typeof v === "object") {
+      const keys = Object.keys(v);
+      return keys.length ? `a JSON answer with ${keys.slice(0, 8).join(", ")}${keys.length > 8 ? ` (+${keys.length - 8} more)` : ""}` : "an empty object";
+    }
+  } catch {
+  }
+  const head = t.replace(/\s+/g, " ").slice(0, 80);
+  return `a text answer ("${head}${t.length > 80 ? "\u2026" : ""}")`;
+}
+function argsText(args) {
+  if (!args || !Object.keys(args).length) return "no arguments";
+  return Object.entries(args).map(([k, v]) => `${k}=${typeof v === "string" ? v : JSON.stringify(v)}`).join(", ");
+}
+function toolsCalledBy(i, prompt) {
+  const names = i.promptTools[prompt] ?? [];
+  return names.map((n) => i.tools.find((t) => t.name === n) ?? { name: n });
+}
+function draftUseCases(i) {
+  const parts = [];
+  const working = i.prompts.filter((p) => (i.promptTools[p] ?? []).length);
+  const list = working.length ? working : i.prompts;
+  if (list.length) parts.push(`People ask it, in their own words: ${list.map((p) => `"${p}"`).join(" \xB7 ")}.`);
+  const groups = /* @__PURE__ */ new Map();
+  for (const p of list) {
+    const called = toolsCalledBy(i, p);
+    if (!called.length) continue;
+    const key = called.map((t) => t.name).join("+");
+    if (!groups.has(key)) groups.set(key, { tools: called, prompts: [] });
+    groups.get(key).prompts.push(p);
+  }
+  const short = (p) => `"${p.length > 50 ? `${p.slice(0, 47)}\u2026` : p}"`;
+  for (const g of groups.values()) {
+    const row = i.rows.find((r) => r.tool === g.tools[0].name && r.valid === "ok");
+    const which = g.prompts.length === list.length && list.length > 1 ? "Each of these" : g.prompts.map(short).join(", ");
+    parts.push(`${which} make${g.prompts.length === 1 ? "s" : ""} Claude call ${g.tools.map(titleOf).join(" and ")}${row ? `, which returns ${shapeOf(row)}` : ""}.`);
+  }
+  const uncalled = i.tools.filter((t) => !Object.values(i.promptTools).some((ns) => ns.includes(t.name)));
+  if (uncalled.length) parts.push(`Also available: ${uncalled.map((t) => `${titleOf(t)}${(t.description ?? "").trim() ? ` (${(t.description ?? "").trim().replace(/\.$/, "")})` : ""}`).join("; ")}.`);
+  parts.push(readOnly(i) ? "Every tool only reads; nothing is created or changed." : "Write tools change data in the signed-in account only.");
+  return parts.join(" ");
+}
+function draftReviewerInstructions(i) {
+  const lines = [];
+  lines.push(`Add ${i.publishedUrl} as a custom connector in Claude (Settings \u2192 Connectors \u2192 Add custom connector).`);
+  lines.push(i.open ? "No sign-in: the data is public and every tool is read-only. Connect and ask." : `Sign in with the reviewer account in this packet${i.reviewerUsername ? ` (username ${i.reviewerUsername}; the password is in the packet, never in this text)` : ""}.`);
+  const seen = /* @__PURE__ */ new Set();
+  for (const p of i.prompts) {
+    const called = toolsCalledBy(i, p);
+    if (!called.length) continue;
+    const row = i.rows.find((r) => r.tool === called[0].name && r.valid === "ok");
+    called.forEach((t) => seen.add(t.name));
+    lines.push(`Ask: "${p}" \u2014 Claude calls ${called.map(titleOf).join(" and ")}${row ? `; expect ${shapeOf(row)}` : ""}.`);
+  }
+  for (const r of i.rows) {
+    if (seen.has(r.tool) || r.valid !== "ok") continue;
+    const t = i.tools.find((x) => x.name === r.tool) ?? { name: r.tool };
+    lines.push(`Ask Claude to ${titleOf(t).replace(/^./, (c) => c.toLowerCase())} (${argsText(r.args)}); expect ${shapeOf(r)}.`);
+  }
+  const errs = i.rows.filter((r) => r.invalid === "error" && r.invalidText);
+  for (const r of errs.slice(0, 2)) {
+    const [broke, ...rest] = r.invalidText.split(" \u2192 ");
+    const answer = rest.join(" \u2192 ").replace(/\s+/g, " ").slice(0, 100);
+    lines.push(`A bad argument (${r.tool}, ${broke}) answers "${answer}" \u2014 a message, not a crash.`);
+  }
+  const declined = i.rows.filter((r) => /declined|not exercised/i.test(r.note ?? ""));
+  if (declined.length) lines.push(`Not run in the test, by choice: ${declined.map((r) => r.tool).join(", ")} (write tools; they change data in the signed-in account only).`);
+  lines.push(readOnly(i) ? "Every tool only reads; nothing is created or changed." : "Every write in the test was on data the test itself created.");
+  return lines.map((l, n) => `${n + 1}. ${l}`).join("\n");
+}
+function draftDescription(i) {
+  const parts = [];
+  const base2 = (i.description ?? "").trim() || (i.tagline ?? "").trim();
+  if (base2) parts.push(base2.replace(/\.?$/, "."));
+  const toolLines = i.tools.map((t) => {
+    const d = (t.description ?? "").trim().replace(/\.$/, "");
+    return d && d.toLowerCase() !== titleOf(t).toLowerCase() ? `${titleOf(t)}: ${d}` : titleOf(t);
+  });
+  if (toolLines.length) parts.push(`${i.tools.length === 1 ? "One tool" : `${i.tools.length} tools`}: ${toolLines.join("; ")}.`);
+  const working = i.prompts.filter((p) => (i.promptTools[p] ?? []).length);
+  if (working.length) parts.push(`Ask it things like ${working.map((p) => `"${p}"`).join(", ")}.`);
+  const ok = i.rows.find((r) => r.valid === "ok");
+  if (ok) parts.push(`What comes back is ${shapeOf(ok)}, which Claude reads and explains.`);
+  parts.push(readOnly(i) ? "Every tool only reads; nothing is created or changed." : "Writes change data in the signed-in account only.");
+  return parts.join(" ");
+}
+function draftMissing(i, current) {
+  const out = [];
+  const len = (v) => (v ?? "").trim().length;
+  if (len(current.description) < ANSWER_MIN.description) out.push({ key: "description", label: "Listing description", draft: draftDescription({ ...i, description: current.description ?? i.description }), current: (current.description ?? "").trim() });
+  if (len(current.use_cases) < ANSWER_MIN.use_cases) out.push({ key: "use_cases", label: "Use cases", draft: draftUseCases(i), current: (current.use_cases ?? "").trim() });
+  if (len(current.reviewer_instructions) < ANSWER_MIN.reviewer_instructions) out.push({ key: "reviewer_instructions", label: "Reviewer instructions", draft: draftReviewerInstructions(i), current: (current.reviewer_instructions ?? "").trim() });
+  return out;
+}
+var ANSWER_MIN, titleOf, shapeOf, readOnly;
+var init_portal_drafts = __esm({
+  "src/lib/portal-drafts.ts"() {
+    "use strict";
+    ANSWER_MIN = { use_cases: 200, description: 300, reviewer_instructions: 400 };
+    titleOf = (t) => (t.title ?? "").trim() || t.name;
+    shapeOf = (row) => row ? row.resultShape ?? describeResult(row.validText) : "";
+    readOnly = (i) => i.tools.every((t) => i.rows.find((r) => r.tool === t.name)?.role === "read" || /^(get|head)$/i.test(t.method ?? "get"));
+  }
+});
+
 // src/commands/connector-exercise.ts
 var connector_exercise_exports = {};
 __export(connector_exercise_exports, {
   DASHBOARD_BASE: () => DASHBOARD_BASE8,
   RUN_HEADER: () => RUN_HEADER,
   RUN_META_KEY: () => RUN_META_KEY,
+  createPromptTester: () => createPromptTester,
   reportLink: () => reportLink,
   runConnectorAnswers: () => runConnectorAnswers,
   runConnectorExercise: () => runConnectorExercise
@@ -7745,60 +7670,87 @@ async function runConnectorExercise(project, opts = {}) {
     if (!json) console.log(s);
   };
   const deps = opts.deps ?? {};
-  say(import_chalk27.default.cyan(`  Report: ${reportLink(proj2.projectId, proj2.apiVersion)}`));
+  if (opts.report !== false) say(import_chalk26.default.cyan(`  Report: ${reportLink(proj2.projectId, proj2.apiVersion)}`));
   if (opts.emptyOk?.length) {
-    await producer(caller, { method: "PATCH", path: projectPath2(proj2), body: { directory_metadata: { empty_ok: opts.emptyOk } }, summary: "Mark tools legitimately empty" });
-    say(import_chalk27.default.dim(`  marked legitimately empty: ${opts.emptyOk.join(", ")}`));
+    await producer(caller, { method: "PATCH", path: projectPath(proj2), body: { directory_metadata: { empty_ok: opts.emptyOk } }, summary: "Mark tools legitimately empty" });
+    say(import_chalk26.default.dim(`  marked legitimately empty: ${opts.emptyOk.join(", ")}`));
   }
   let r = await fetchDirectoryReport(caller, proj2, { probe: false });
   const target2 = r.target ?? {};
   const tools = orderTools(target2.tools ?? []);
   const publishedUrl = r.report.project.publishedUrl;
-  if (!publishedUrl) throw new Error(`${proj2.projectName} has no published MCP URL yet (run \`${B.cli} connector ${proj2.projectName}\` first).`);
+  if (!publishedUrl) throw new Error(`${proj2.projectName} has no published MCP URL yet (run \`${B.cli} connector ${proj2.projectId}\` first).`);
   if (!tools.length) throw new Error(`${proj2.projectName} exposes no tools to exercise.`);
-  if (target2.project?.directoryReady === false) throw new Error(`Directory-ready mode is off for ${proj2.projectName} v${proj2.apiVersion}: nothing is recorded and the sign-in door is shut. Turn it on first (\`${B.cli} connector ${proj2.projectName}\`, or the switch on the dashboard) and run again.`);
+  if (target2.project?.directoryReady === false) throw new Error(`Directory-ready mode is off for ${proj2.projectName} v${proj2.apiVersion}: nothing is recorded and the sign-in door is shut. Turn it on first (\`${B.cli} connector ${proj2.projectId}\`, or the switch on the dashboard) and run again.`);
   const open = target2.project?.authMode === "open";
-  const opened = await producer(caller, { method: "POST", path: `${projectPath2(proj2)}/directory-runs`, body: { runner: "cli-direct" }, summary: "Open an exercise run" });
+  const opened = await producer(caller, { method: "POST", path: `${projectPath(proj2)}/directory-runs`, body: { runner: "cli-direct" }, summary: "Open an exercise run" });
   const runId2 = opened.run.run_id;
   const notes = [];
   const rows = [];
   let bearer = null;
   let asMeta = null;
   let configDir = null;
+  let reviewerUsername = null;
   try {
     if (!open) {
-      const packet = await producer(caller, { method: "GET", path: `${projectPath2(proj2)}/directory-packet?probe=0&force=1`, summary: "Reviewer account (for the login)" });
+      const packet = await producer(caller, { method: "GET", path: `${projectPath(proj2)}/directory-packet?probe=0&force=1`, summary: "Reviewer account (for the login)" });
       const acct = packet.json?.test_account ?? null;
-      if (!acct) throw new Error(`No reviewer account on ${proj2.projectName}: create it first (\`${B.cli} connector reviewer ${proj2.projectName}\`), or declare open mode for public read-only data.`);
+      if (!acct) throw new Error(`No reviewer account on ${proj2.projectName}: create it first (\`${B.cli} connector reviewer ${proj2.projectId}\`), or declare open mode for public read-only data.`);
       const login = await headlessPasswordLogin({ mcpUrl: publishedUrl, username: acct.username, password: acct.password }, deps);
       if (!login.accessToken) throw new Error(`The reviewer could not sign in at ${login.failedAt}: ${login.detail}. Fix the sign-in and run again.`);
       bearer = login.accessToken;
       asMeta = login.as;
-      say(import_chalk27.default.dim(`  signed in as the reviewer (${acct.username}); the token is revoked at the end`));
+      reviewerUsername = acct.username;
+      say(import_chalk26.default.dim(`  signed in as the reviewer (${acct.username}); the token is revoked at the end`));
     } else {
-      say(import_chalk27.default.dim("  open mode: no sign-in; this run's calls count as yours"));
+      say(import_chalk26.default.dim("  open mode: no sign-in; this run's calls count as yours"));
     }
     const ua = `apiblaze-cli/${version} directory-exercise`;
     const headers = { [RUN_HEADER]: runId2 };
     const call3 = (name, args) => mcpCall(publishedUrl, "tools/call", { name, arguments: args, _meta: { [RUN_META_KEY]: runId2 } }, { bearer, headers, userAgent: ua }, deps);
     const created = {};
-    for (const t of tools) {
+    const examples = { ...target2.metadata?.toolExamples ?? {} };
+    const learned = {};
+    const prompts = (target2.metadata?.examplePrompts ?? []).filter((p) => typeof p === "string");
+    for (const t of opts.promptsOnly ? [] : tools) {
       const role = toolRole(t);
       const row = { tool: t.name, role, valid: "no_call", validText: "", invalid: "skipped", invalidText: "" };
       rows.push(row);
-      const args = validArgs(t, created);
+      let args = validArgs(t, created, examples[t.name]);
       if (role !== "read") {
         const go = await confirm(`${t.name} (${(t.method ?? "POST").toUpperCase()} ${t.path ?? ""}) with ${JSON.stringify(args)} \u2014 call it?`, interactive2);
         if (!go) {
           row.note = "not exercised: producer declined";
           notes.push({ tool: t.name, note: "not exercised: producer declined" });
-          say(`  ${import_chalk27.default.yellow("\u2013")} ${t.name}  not exercised (${interactive2 ? "declined" : "non-interactive: writes need a y"})`);
+          say(`  ${import_chalk26.default.yellow("\u2013")} ${t.name}  not exercised (${interactive2 ? "declined" : "non-interactive: writes need a y"})`);
           continue;
         }
       }
-      const v = localOutcome(await call3(t.name, args));
+      let v = localOutcome(await call3(t.name, args));
+      if (role === "read" && v.outcome !== "ok" && interactive2 && Object.keys(args).length) {
+        const { default: inquirer3 } = await import("inquirer");
+        say(`  ${mark(v.outcome)} ${t.name} refused ${JSON.stringify(args)}: ${import_chalk26.default.dim(redactHead(v.text, 120) || v.outcome)}`);
+        const fixed = {};
+        for (const [name, cur] of Object.entries(args)) {
+          const p = t.inputProperties?.[name] ?? {};
+          const proposed = candidateFromPrompts(name, p, prompts);
+          const { value } = await inquirer3.prompt([{ type: "input", name: "value", message: `A value for ${name} that works (Enter to leave it):`, ...proposed && proposed !== String(cur) ? { default: proposed } : {} }]);
+          const s = (value ?? "").trim();
+          if (!s || s === String(cur)) continue;
+          const type = (p.type ?? "string").toLowerCase();
+          fixed[name] = type === "integer" || type === "number" ? Number.isFinite(Number(s)) ? Number(s) : s : type === "boolean" ? s === "true" : s;
+        }
+        if (Object.keys(fixed).length) {
+          examples[t.name] = { ...examples[t.name] ?? {}, ...fixed };
+          args = validArgs(t, created, examples[t.name]);
+          v = localOutcome(await call3(t.name, args));
+          if (v.outcome === "ok") learned[t.name] = fixed;
+        }
+      }
       row.valid = v.outcome;
       row.validText = redactHead(v.text);
+      row.args = args;
+      if (v.outcome === "ok") row.resultShape = describeResult(v.text);
       if (v.outcome === "ok" && role === "create") {
         const id = extractCreatedId(parseResultJson(v.text));
         if (id) {
@@ -7808,187 +7760,507 @@ async function runConnectorExercise(project, opts = {}) {
         }
       }
       if (role === "read") {
-        const bad = invalidArgs(t, created);
+        const bad = invalidArgs(t, created, examples[t.name]);
         if (bad) {
           const e = localOutcome(await call3(t.name, bad.args));
           row.invalid = e.outcome;
           row.invalidText = redactHead(`${bad.broke} \u2192 ${e.text}`);
         }
       }
-      say(`  ${mark(v.outcome)} ${t.name}  ${import_chalk27.default.dim(v.text.slice(0, 80))}${row.invalid !== "skipped" ? import_chalk27.default.dim(`  \xB7 bad arg: ${row.invalid}`) : ""}`);
+      say(`  ${mark(v.outcome)} ${t.name}  ${import_chalk26.default.dim(v.text.replace(/\s+/g, " ").slice(0, 80))}${row.invalid !== "skipped" ? import_chalk26.default.dim(`  \xB7 bad arg: ${row.invalid === "error" ? "refused with a message" : row.invalid}`) : ""}`);
+    }
+    if (Object.keys(learned).length) {
+      await producer(caller, { method: "PATCH", path: projectPath(proj2), body: { directory_metadata: { tool_examples: learned } }, summary: "Remember the working arguments" });
+      say(import_chalk26.default.green(`  \u2713 remembered the working arguments for ${Object.keys(learned).join(", ")} (used on every run from now on)`));
     }
     const claudeInstalled = deps.claudeInstalled ?? detectExternalClis().some((c) => c.kind === "claude");
     if (!opts.noClaude && claudeInstalled) {
-      const spawn5 = deps.spawn ?? import_child_process6.spawnSync;
-      configDir = import_fs6.default.mkdtempSync(import_path5.default.join(deps.tmpdir ?? import_os3.default.tmpdir(), "abz-exercise-"));
-      import_fs6.default.chmodSync(configDir, 448);
-      const cfgPath = import_path5.default.join(configDir, "mcp.json");
-      import_fs6.default.writeFileSync(cfgPath, mcpConfigDocument(publishedUrl, bearer), { mode: 384 });
-      const prompts = (target2.metadata?.examplePrompts ?? []).filter((p) => typeof p === "string" && p.trim()).slice(0, 3);
+      const spawn5 = deps.spawn ?? import_child_process5.spawnSync;
+      configDir = import_fs5.default.mkdtempSync(import_path4.default.join(deps.tmpdir ?? import_os2.default.tmpdir(), "abz-exercise-"));
+      import_fs5.default.chmodSync(configDir, 448);
+      const cfgPath = import_path4.default.join(configDir, "mcp.json");
+      import_fs5.default.writeFileSync(cfgPath, mcpConfigDocument(publishedUrl, bearer, runId2), { mode: 384 });
+      const proven = new Map((opts.provenPromptNotes ?? []).map((n) => [n.prompt.trim(), n]));
+      const prompts2 = (opts.promptsOnly ?? target2.metadata?.examplePrompts ?? []).filter((p) => typeof p === "string" && p.trim()).slice(0, 3);
       const firstRead = tools.find((t) => toolRole(t) === "read") ?? tools[0];
       const runs = [
-        { prompt: `Use the ${firstRead.title ?? firstRead.name} tool once and summarise what it returned in one sentence.`, allowed: [`mcp__abz__${firstRead.name}`], kind: "tool" },
-        ...prompts.map((p) => ({ prompt: p, allowed: ["mcp__abz__*"], kind: "prompt" }))
+        ...opts.promptsOnly ? [] : [{ prompt: `Use the ${firstRead.title ?? firstRead.name} tool once and summarise what it returned in one sentence.`, allowed: [`mcp__abz__${firstRead.name}`], kind: "tool" }],
+        ...prompts2.filter((p) => !proven.has(p.trim())).map((p) => ({ prompt: p, allowed: ["mcp__abz__*"], kind: "prompt" }))
       ];
-      say(import_chalk27.default.dim(`  Claude Code pass: ${runs.length} one-shot${runs.length > 1 ? "s" : ""} (10\u201325 s each)`));
+      for (const p of prompts2) {
+        const n = proven.get(p.trim());
+        if (n) notes.push({ ...n });
+      }
+      if (proven.size) say(import_chalk26.default.dim(`  ${proven.size} prompt${proven.size > 1 ? "s" : ""} already run through Claude Code as ${proven.size > 1 ? "they were" : "it was"} typed`));
+      say(import_chalk26.default.dim(`  Claude Code pass: ${runs.length} one-shot${runs.length > 1 ? "s" : ""} (10\u201325 s each)`));
       for (const x of runs) {
-        const res = spawn5("claude", claudeRecipe({ prompt: x.prompt, mcpConfigPath: cfgPath, allowedTools: x.allowed }), { encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"], timeout: 12e4, env: { ...process.env, CLAUDECODE: "" } });
-        const calls = toolCallsInClaudeOutput(String(res.stdout ?? ""));
+        const { calls, status: status2 } = claudeOneShot2(spawn5, cfgPath, x.prompt, x.allowed);
         if (x.kind === "prompt") notes.push({ kind: "prompt", prompt: x.prompt, tool_called: calls.length > 0, tools: calls });
         else notes.push({ kind: "claude-tool", tool: firstRead.name, tool_called: calls.length > 0 });
-        say(`  ${calls.length ? import_chalk27.default.green("\u2713") : import_chalk27.default.yellow("\u2013")} claude: "${x.prompt.slice(0, 60)}" \u2192 ${calls.length ? `called ${calls.join(", ")}` : "no tool call"}${res.status !== 0 && res.status != null ? import_chalk27.default.dim(` (exit ${res.status})`) : ""}`);
+        say(`  ${calls.length ? import_chalk26.default.green("\u2713") : import_chalk26.default.yellow("\u2013")} claude: "${x.prompt.slice(0, 60)}" \u2192 ${calls.length ? `called ${calls.join(", ")}` : "no tool call"}${status2 !== 0 && status2 != null ? import_chalk26.default.dim(` (exit ${status2})`) : ""}`);
       }
     } else if (!opts.noClaude) {
-      say(import_chalk27.default.dim("  Claude Code is not installed here: the Claude pass is skipped (TESTED_FROM_CLAUDE and EXAMPLE_PROMPTS_WORK stay open with their instruction)."));
+      say(import_chalk26.default.dim("  Claude Code is not installed here: the Claude pass is skipped (TESTED_FROM_CLAUDE and EXAMPLE_PROMPTS_WORK stay open with their instruction)."));
     }
   } finally {
     if (configDir) {
       try {
-        import_fs6.default.rmSync(configDir, { recursive: true, force: true });
+        import_fs5.default.rmSync(configDir, { recursive: true, force: true });
+      } catch {
+      }
+    }
+    if (bearer) {
+      await revokeToken(asMeta, bearer, void 0, deps).catch(() => false);
+    }
+  }
+  r = await fetchDirectoryReport(caller, proj2, { publishedUrl, ...opts.platforms ? { platforms: opts.platforms } : {} });
+  const verdicts = r.report.verdicts ?? null;
+  const closed = await producer(caller, { method: "PATCH", path: `${projectPath(proj2)}/directory-runs/${encodeURIComponent(runId2)}`, body: { verdicts, scores: verdicts?.groups ?? null, notes, runner: "cli-direct", ...opts.platforms?.length ? { platforms: opts.platforms } : {}, ...opts.noEmail ? { email: false } : {} }, summary: "Close the exercise run" });
+  const promptTools = {};
+  for (const n of notes) if (n.kind === "prompt" && typeof n.prompt === "string") promptTools[n.prompt] = Array.isArray(n.tools) ? n.tools : [];
+  const summary = {
+    failedPrompts: notes.filter((n) => n.kind === "prompt" && n.tool_called === false && typeof n.prompt === "string").map((n) => n.prompt),
+    rows,
+    promptTools,
+    publishedUrl,
+    open,
+    reviewerUsername,
+    tools
+  };
+  if (json) {
+    process.stdout.write(JSON.stringify({ project: proj2.projectId, run_id: runId2, link: reportLink(proj2.projectId, proj2.apiVersion), tools: rows, notes, headline: r.rendered.headline, verdicts, report: r.report }) + "\n");
+    return summary;
+  }
+  if (opts.report !== false) {
+    console.log();
+    printReport(r, false);
+    console.log(import_chalk26.default.cyan(`  Report: ${reportLink(proj2.projectId, proj2.apiVersion)}`));
+  }
+  console.log(import_chalk26.default.dim(opts.noEmail ? "  (no email for this run)" : closed?.emailed ? "  (the result was emailed to you; --no-email or the project setting turns it off)" : "  (no email: the run has no address to send to)"));
+  return summary;
+}
+function claudeOneShot2(spawn5, cfgPath, prompt, allowed) {
+  const res = spawn5("claude", claudeRecipe({ prompt, mcpConfigPath: cfgPath, allowedTools: allowed }), { encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"], timeout: 12e4, env: { ...process.env, CLAUDECODE: "" } });
+  return { calls: toolCallsInClaudeOutput(String(res.stdout ?? "")), status: res.status };
+}
+async function createPromptTester(caller, proj2, opts = {}) {
+  const say = opts.say ?? ((s) => console.log(s));
+  const deps = opts.deps ?? {};
+  const claudeInstalled = deps.claudeInstalled ?? detectExternalClis().some((c) => c.kind === "claude");
+  if (!claudeInstalled) {
+    say(import_chalk26.default.dim("  (Claude Code is not installed here: each prompt is run at the end, in the exercise)"));
+    return null;
+  }
+  const r = await fetchDirectoryReport(caller, proj2, { probe: false });
+  const target2 = r.target ?? {};
+  const publishedUrl = r.report.project.publishedUrl;
+  if (!publishedUrl || target2.project?.directoryReady === false) return null;
+  const open = target2.project?.authMode === "open";
+  let bearer = null;
+  let asMeta = null;
+  if (!open) {
+    const packet = await producer(caller, { method: "GET", path: `${projectPath(proj2)}/directory-packet?probe=0&force=1`, summary: "Reviewer account (for the login)" }).catch(() => null);
+    const acct = packet?.json?.test_account ?? null;
+    if (!acct) {
+      say(import_chalk26.default.dim("  (no reviewer account yet: each prompt is run at the end, in the exercise)"));
+      return null;
+    }
+    const login = await headlessPasswordLogin({ mcpUrl: publishedUrl, username: acct.username, password: acct.password }, deps);
+    if (!login.accessToken) {
+      say(import_chalk26.default.yellow(`  (the reviewer could not sign in at ${login.failedAt}: ${login.detail}; each prompt is run at the end, in the exercise)`));
+      return null;
+    }
+    bearer = login.accessToken;
+    asMeta = login.as;
+  }
+  const opened = await producer(caller, { method: "POST", path: `${projectPath(proj2)}/directory-runs`, body: { runner: "cli-direct" }, summary: "Open a prompt-test run" });
+  const runId2 = opened.run.run_id;
+  const spawn5 = deps.spawn ?? import_child_process5.spawnSync;
+  const configDir = import_fs5.default.mkdtempSync(import_path4.default.join(deps.tmpdir ?? import_os2.default.tmpdir(), "abz-prompt-"));
+  import_fs5.default.chmodSync(configDir, 448);
+  const cfgPath = import_path4.default.join(configDir, "mcp.json");
+  import_fs5.default.writeFileSync(cfgPath, mcpConfigDocument(publishedUrl, bearer, runId2), { mode: 384 });
+  const notes = [];
+  return {
+    async test(prompt) {
+      const { calls } = claudeOneShot2(spawn5, cfgPath, prompt, ["mcp__abz__*"]);
+      const note = { kind: "prompt", prompt, tool_called: calls.length > 0, tools: calls };
+      const at = notes.findIndex((n) => n.prompt === prompt);
+      if (at >= 0) notes[at] = note;
+      else notes.push(note);
+      return { called: calls.length > 0, tools: calls };
+    },
+    notes: () => [...notes],
+    async close() {
+      try {
+        import_fs5.default.rmSync(configDir, { recursive: true, force: true });
+      } catch {
+      }
+      if (bearer) await revokeToken(asMeta, bearer, void 0, deps).catch(() => false);
+      await producer(caller, { method: "PATCH", path: `${projectPath(proj2)}/directory-runs/${encodeURIComponent(runId2)}`, body: { notes, runner: "cli-direct", email: false }, summary: "Close the prompt-test run" }).catch(() => null);
+    }
+  };
+}
+function mark(o) {
+  return o === "ok" ? import_chalk26.default.green("\u2713") : o === "error" ? import_chalk26.default.yellow("!") : import_chalk26.default.red("\u2717");
+}
+function parseResultJson(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return null;
+  }
+}
+async function runConnectorAnswers(project, opts = {}) {
+  const caller = await requireCaller();
+  const { teamId } = await resolveActingTeam(caller, opts.team);
+  const proj2 = await resolveProjectVia(caller, teamId, project, opts.apiversion);
+  const json = !!opts.json;
+  const interactive2 = !!process.stdin.isTTY && !json && !opts.yes;
+  const dh = parseDataHandling(opts.dataHandling, opts.dataHandlingStatement);
+  const health = parseYesNo("--health-data", opts.healthData);
+  const sponsored = parseYesNo("--sponsored-content", opts.sponsoredContent);
+  const access = opts.access ? opts.access.trim().toLowerCase() : void 0;
+  if (access && !["read", "write", "both"].includes(access)) throw new Error("--access must be read, write or both.");
+  const answers = {};
+  for (const q of QUESTIONS) {
+    const v = opts[q.key];
+    if (typeof v === "string" && v.trim()) answers[q.field] = v.trim();
+  }
+  if (access) answers.access = access;
+  if (opts.category?.length) answers.categories = opts.category.map((c) => c.trim()).filter(Boolean).slice(0, 5);
+  const meta = {};
+  if (dh) meta.data_handling = dh;
+  if (health) meta.health_data = health;
+  if (sponsored) meta.sponsored_content = sponsored;
+  if (interactive2) {
+    const current = await producer(caller, { method: "POST", path: `${projectPath(proj2)}/directory-report`, body: { probe: false }, summary: "Current answers" });
+    const have = current.target?.metadata?.portalAnswers ?? {};
+    const { default: inquirer3 } = await import("inquirer");
+    const saveNow = async (part) => {
+      try {
+        await producer(caller, { method: "PATCH", path: projectPath(proj2), body: part, summary: "Save an answer" });
+      } catch (e) {
+        console.log(import_chalk26.default.yellow(`  not saved: ${e instanceof Error ? e.message : String(e)}`));
+      }
+    };
+    let headed = opts.derived !== false;
+    const ask3 = async (qs) => {
+      if (!headed) {
+        headed = true;
+        console.log(import_chalk26.default.bold("  What the portal asks that only you can answer (saved as you go):"));
+      }
+      return inquirer3.prompt(qs);
+    };
+    const desc = (current.target?.metadata?.description ?? "").trim();
+    if (opts.derived !== false && desc.length < DESCRIPTION_MIN) {
+      const a = await ask3([{ type: "input", name: "value", message: `Description (what people can do with it; ${DESCRIPTION_MIN}\u20132000 characters):`, default: desc || void 0, validate: (v) => v.trim().length >= DESCRIPTION_MIN ? true : `${v.trim().length}/${DESCRIPTION_MIN} characters \u2014 a reviewer needs to know what it does and what comes back` }]);
+      meta.description = a.value.trim();
+      await saveNow({ directory_metadata: { description: meta.description } });
+    }
+    for (const q of QUESTIONS) {
+      if (answers[q.field] !== void 0) continue;
+      if (opts.derived === false && (q.field === "use_cases" || q.field === "reviewer_instructions")) continue;
+      const existing = typeof have[q.field] === "string" ? String(have[q.field]) : "";
+      if (existing.length >= (q.min ?? 1)) continue;
+      const a = await ask3([{ type: "input", name: "value", message: q.message, default: existing || void 0, validate: (v) => v.trim().length >= (q.min ?? 1) ? true : `${q.min ?? 1}+ characters` }]);
+      answers[q.field] = a.value.trim();
+      await saveNow({ directory_portal_answers: { [q.field]: a.value.trim() } });
+    }
+    if (answers.access === void 0 && !have.access) {
+      const a = await ask3([{ type: "list", name: "value", message: "What the tools do:", choices: ["read", "write", "both"] }]);
+      answers.access = a.value;
+      await saveNow({ directory_portal_answers: { access: a.value } });
+    }
+    if (answers.categories === void 0 && !(Array.isArray(have.categories) && have.categories.length)) {
+      const a = await ask3([{ type: "input", name: "value", message: "Category suggestions (1\u20135, comma-separated; you pick the closest in the portal):", validate: (v) => v.trim() ? true : "one at least" }]);
+      answers.categories = a.value.split(",").map((c) => c.trim()).filter(Boolean).slice(0, 5);
+      await saveNow({ directory_portal_answers: { categories: answers.categories } });
+    }
+    if (!meta.data_handling && !current.target?.metadata?.dataHandling) {
+      const a = await ask3([
+        { type: "list", name: "mode", message: "Whose API is behind this connector?", choices: [{ name: "own \u2014 my API, on my domain", value: "own" }, { name: "proxied \u2014 someone else's API I hold permission for", value: "proxied" }, { name: "third-party \u2014 someone else's API, no permission (cannot be listed)", value: "third-party" }] },
+        { type: "input", name: "statement", message: "The permission you hold (who granted what, and when; goes into portal step 7):", when: (ans) => ans.mode === "proxied", validate: (v) => v.trim().length >= 20 ? true : "a sentence, please" }
+      ]);
+      meta.data_handling = { mode: a.mode, ...a.statement?.trim() ? { statement: a.statement.trim() } : {} };
+      await saveNow({ directory_metadata: { data_handling: meta.data_handling } });
+    }
+    if (!meta.health_data && !current.target?.metadata?.healthData) {
+      const a = await ask3([{ type: "confirm", name: "value", message: "Do the tools handle health data?", default: false }]);
+      meta.health_data = a.value ? "yes" : "no";
+      await saveNow({ directory_metadata: { health_data: meta.health_data } });
+    }
+    if (!meta.sponsored_content && !current.target?.metadata?.sponsoredContent) {
+      const a = await ask3([{ type: "confirm", name: "value", message: "Do tool results carry sponsored content?", default: false }]);
+      meta.sponsored_content = a.value ? "yes" : "no";
+      await saveNow({ directory_metadata: { sponsored_content: meta.sponsored_content } });
+    }
+  }
+  const body = {};
+  if (Object.keys(answers).length) body.directory_portal_answers = answers;
+  if (Object.keys(meta).length) body.directory_metadata = meta;
+  if (!Object.keys(body).length) {
+    if (json) process.stdout.write(JSON.stringify({ project: proj2.projectId, changed: [] }) + "\n");
+    else if (opts.derived !== false) console.log(import_chalk26.default.dim("  Nothing to record: pass flags (--use-cases, --data-handling \u2026) or run interactively."));
+    return;
+  }
+  await producer(caller, { method: "PATCH", path: projectPath(proj2), body, summary: "Store the portal answers" });
+  const r = await fetchDirectoryReport(caller, proj2, { probe: false, ...opts.platforms ? { platforms: opts.platforms } : {} });
+  if (json) {
+    process.stdout.write(JSON.stringify({ project: proj2.projectId, changed: Object.keys({ ...answers, ...meta }), headline: r.rendered.headline, report: r.report }) + "\n");
+    return;
+  }
+  console.log(import_chalk26.default.green(`  \u2713 recorded: ${Object.keys({ ...answers, ...meta }).join(", ")}`));
+  console.log(import_chalk26.default.dim(`  ${r.rendered.headline}`));
+}
+var import_chalk26, import_fs5, import_os2, import_path4, import_child_process5, DASHBOARD_BASE8, RUN_META_KEY, RUN_HEADER, projectPath, QUESTIONS;
+var init_connector_exercise = __esm({
+  "src/commands/connector-exercise.ts"() {
+    "use strict";
+    import_chalk26 = __toESM(require("chalk"));
+    import_fs5 = __toESM(require("fs"));
+    import_os2 = __toESM(require("os"));
+    import_path4 = __toESM(require("path"));
+    import_child_process5 = require("child_process");
+    init_package();
+    init_caller();
+    init_directory();
+    init_headless_login();
+    init_exercise();
+    init_brand();
+    init_portal_drafts();
+    init_external_mcp();
+    DASHBOARD_BASE8 = process.env.APIBLAZE_DASHBOARD_BASE || "https://dashboard.apiblaze.com";
+    RUN_META_KEY = "com.apiblaze/run";
+    RUN_HEADER = "apiblaze-directory-run";
+    projectPath = (p) => `/projects/${encodeURIComponent(p.projectId)}/${encodeURIComponent(p.apiVersion)}`;
+    QUESTIONS = [
+      { key: "useCases", field: "use_cases", message: "Use cases (what a person asks it, in their words; 200+ characters):", min: 200 },
+      { key: "prerequisites", field: "prerequisites", message: "Prerequisites (one sentence: what a user needs before it works):", min: 1 },
+      { key: "companyName", field: "company_name", message: "Company name:", min: 1 },
+      { key: "companyWebsite", field: "company_website", message: "Company website (https):", min: 8 },
+      { key: "companyContact", field: "company_contact", message: "Primary contact (email or URL):", min: 3 },
+      { key: "reviewerInstructions", field: "reviewer_instructions", message: "Reviewer instructions (how to add it, sign in, one prompt per tool and what to expect; 400+ characters):", min: 400 }
+    ];
+  }
+});
+
+// src/lib/directory-docs.ts
+function directoryDocsPrompt(facts) {
+  return [
+    `Write the three documents a connector listing needs for "${facts.name}", from the FACTS below and nothing else.`,
+    "Rules: plain English, second person, no marketing, no prices, no promo. Never invent a result: when you describe what a tool returns, cite only the recorded result shapes in the facts (keys, item counts, heads); if none is recorded, say what the tool is for and that the assistant will show the result.",
+    "Never write credentials, usernames, tokens or internal hostnames. Troubleshooting cites the failure modes with their exact texts.",
+    `The sign-in: ${facts.sign_in_shape}`,
+    `Answer with JSON matching the schema: docs_markdown (the public page "Using <name> in Claude": purpose \xB7 how it works from Claude's side \xB7 connect and sign in \xB7 the example prompts with what to expect \xB7 troubleshooting \xB7 support), reviewer_markdown (for someone who has never seen the product: add the connector, the sign-in screen, the account, what data it holds, one prompt per tool with the recorded result shape), portal_answers (use_cases 200+ chars, prerequisites one sentence, access, 1\u20135 categories).`,
+    "",
+    "FACTS:",
+    JSON.stringify(facts, null, 2)
+  ].join("\n");
+}
+function lintDocument(markdown, opts = {}) {
+  const out = [];
+  const text = markdown ?? "";
+  if (!text.trim()) out.push({ code: "EMPTY", detail: "the document is empty" });
+  if (text.length > DIRECTORY_DOC_MAX_CHARS) out.push({ code: "TOO_LONG", detail: `${text.length} characters; the limit is ${DIRECTORY_DOC_MAX_CHARS}` });
+  const u = (opts.reviewerUsername ?? "").trim();
+  if (u.length >= 3 && text.toLowerCase().includes(u.toLowerCase())) out.push({ code: "REVIEWER_USERNAME", detail: "the reviewer username appears; it belongs in the packet only" });
+  if (BEARER_LIKE.test(text)) out.push({ code: "BEARER_LIKE", detail: "a bearer-like or JWT-shaped string appears" });
+  if (KEY_LIKE.test(text)) out.push({ code: "KEY_LIKE", detail: "a key-like string (sk_/pk_/\u2026) appears" });
+  if (PASSWORD_LINE.test(text)) out.push({ code: "PASSWORD_LINE", detail: "a password-like line appears" });
+  if (opts.public && INTERNAL_HOST.test(text)) out.push({ code: "INTERNAL_HOST", detail: "an upstream or platform-internal host appears" });
+  return out;
+}
+function parseGeneratedDocs(stdout) {
+  const tryObj = (v) => {
+    if (!v || typeof v !== "object") return null;
+    const o = v;
+    const pa = o.portal_answers;
+    if (typeof o.docs_markdown !== "string" || typeof o.reviewer_markdown !== "string" || !pa || typeof pa !== "object") return null;
+    return { docs_markdown: o.docs_markdown, reviewer_markdown: o.reviewer_markdown, portal_answers: { use_cases: String(pa.use_cases ?? ""), prerequisites: String(pa.prerequisites ?? ""), access: ["read", "write", "both"].includes(String(pa.access)) ? String(pa.access) : "both", categories: Array.isArray(pa.categories) ? pa.categories.map(String).slice(0, 5) : [] } };
+  };
+  let parsed = null;
+  try {
+    parsed = JSON.parse(stdout.trim());
+  } catch {
+    parsed = null;
+  }
+  if (parsed && typeof parsed === "object") {
+    const o = parsed;
+    const direct = tryObj(o);
+    if (direct) return direct;
+    const so = tryObj(o.structured_output);
+    if (so) return so;
+    if (typeof o.result === "string") {
+      try {
+        const r = tryObj(JSON.parse(o.result));
+        if (r) return r;
       } catch {
       }
-    }
-    if (bearer) {
-      await revokeToken(asMeta, bearer, void 0, deps).catch(() => false);
     }
   }
-  r = await fetchDirectoryReport(caller, proj2, { publishedUrl });
-  const verdicts = r.report.verdicts ?? null;
-  const closed = await producer(caller, { method: "PATCH", path: `${projectPath2(proj2)}/directory-runs/${encodeURIComponent(runId2)}`, body: { verdicts, scores: verdicts?.groups ?? null, notes, runner: "cli-direct", ...opts.noEmail ? { email: false } : {} }, summary: "Close the exercise run" });
-  if (json) {
-    process.stdout.write(JSON.stringify({ project: proj2.projectId, run_id: runId2, link: reportLink(proj2.projectId, proj2.apiVersion), tools: rows, notes, headline: r.rendered.headline, verdicts, report: r.report }) + "\n");
-    return;
+  for (const line of stdout.split("\n").reverse()) {
+    const s = line.trim();
+    if (!s.startsWith("{")) continue;
+    try {
+      const ev = JSON.parse(s);
+      const so = tryObj(ev.structured_output);
+      if (so) return so;
+      if (typeof ev.result === "string") {
+        const r = tryObj(JSON.parse(ev.result));
+        if (r) return r;
+      }
+    } catch {
+    }
+  }
+  return null;
+}
+var DIRECTORY_DOCS_JSON_SCHEMA, DIRECTORY_DOC_MAX_CHARS, BEARER_LIKE, KEY_LIKE, PASSWORD_LINE, INTERNAL_HOST;
+var init_directory_docs = __esm({
+  "src/lib/directory-docs.ts"() {
+    "use strict";
+    DIRECTORY_DOCS_JSON_SCHEMA = {
+      type: "object",
+      additionalProperties: false,
+      required: ["docs_markdown", "reviewer_markdown", "portal_answers"],
+      properties: {
+        docs_markdown: { type: "string", description: `The public documentation page, Markdown: "Using <name> in Claude" \u2014 purpose, how it works from Claude's side, connect and sign in, the three prompts with what to expect, troubleshooting (the known failure modes with their exact texts), support.` },
+        reviewer_markdown: { type: "string", description: "Reviewer instructions for someone who has never seen the product: add the connector, the sign-in screen, the account, what data it holds, one prompt per tool with the recorded result shape. No credentials." },
+        portal_answers: {
+          type: "object",
+          additionalProperties: false,
+          required: ["use_cases", "prerequisites", "access", "categories"],
+          properties: {
+            use_cases: { type: "string", description: "What a person asks it, in their words; 200+ characters." },
+            prerequisites: { type: "string", description: "What a user needs before it works, one sentence." },
+            access: { type: "string", enum: ["read", "write", "both"] },
+            categories: { type: "array", items: { type: "string" }, minItems: 1, maxItems: 5, description: "Free-text category suggestions; the producer picks the closest in the portal." }
+          }
+        }
+      }
+    };
+    DIRECTORY_DOC_MAX_CHARS = 64e3;
+    BEARER_LIKE = /(?:bearer\s+[A-Za-z0-9._~+/=-]{8,}|\b[A-Za-z0-9_-]{20,}\.[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\b)/i;
+    KEY_LIKE = /\b(?:sk|pk|rk|key|tok|abz)_[A-Za-z0-9_-]{8,}\b/i;
+    PASSWORD_LINE = /^\s*(?:[-*]\s*)?(?:\*\*)?(?:password|passwd|pwd|secret)(?:\*\*)?\s*[:=]\s*\S+/im;
+    INTERNAL_HOST = /\b[a-z0-9.-]+\.(abz\.run|tryabz\.run|workers\.dev)\b/i;
   }
-  console.log();
-  printReport(r, false);
-  console.log(import_chalk27.default.cyan(`  Report: ${reportLink(proj2.projectId, proj2.apiVersion)}`));
-  console.log(import_chalk27.default.dim(opts.noEmail ? "  (no email for this run)" : closed?.emailed ? "  (the result was emailed to you; --no-email or the project setting turns it off)" : "  (no email: the run has no address to send to)"));
+});
+
+// src/commands/connector-docs.ts
+var connector_docs_exports = {};
+__export(connector_docs_exports, {
+  askDocsQuestion: () => askDocsQuestion,
+  generateWithClaude: () => generateWithClaude,
+  runConnectorDocs: () => runConnectorDocs,
+  storeGeneratedDocs: () => storeGeneratedDocs,
+  verifyDocsUrl: () => verifyDocsUrl
+});
+function generateWithClaude(prompt, deps = {}) {
+  const spawn5 = deps.spawn ?? import_child_process6.spawnSync;
+  const res = spawn5("claude", ["-p", prompt, "--output-format", "json", "--json-schema", JSON.stringify(DIRECTORY_DOCS_JSON_SCHEMA), "--tools", "", "--max-budget-usd", "2", "--permission-mode", "dontAsk"], { encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"], timeout: 24e4, env: { ...process.env, CLAUDECODE: "" } });
+  const docs = parseGeneratedDocs(String(res.stdout ?? ""));
+  return { docs, detail: docs ? "generated on Claude Code" : `Claude Code answered without the three documents${res.status != null && res.status !== 0 ? ` (exit ${res.status})` : ""}` };
 }
-function mark(o) {
-  return o === "ok" ? import_chalk27.default.green("\u2713") : o === "error" ? import_chalk27.default.yellow("!") : import_chalk27.default.red("\u2717");
+async function storeGeneratedDocs(caller, proj2, docs, o) {
+  const bad = [...lintDocument(docs.docs_markdown, { reviewerUsername: o.reviewerUsername, public: true }).map((f2) => `docs: ${f2.code}`), ...lintDocument(docs.reviewer_markdown, { reviewerUsername: o.reviewerUsername }).map((f2) => `reviewer: ${f2.code}`)];
+  if (bad.length) throw new Error(`The generated documents were refused by the lint (${bad.join(", ")}); nothing was stored. Run again, or write them by hand on the dashboard page.`);
+  const out = await producer(caller, { method: "PUT", path: `${projectPath2(proj2)}/directory-documents`, body: { docs_markdown: docs.docs_markdown, reviewer_markdown: docs.reviewer_markdown, portal_answers: docs.portal_answers, source: "generated", facts_hash: o.factsHash, use_generated_docs_url: o.useGeneratedDocsUrl }, summary: "Store the generated documents" });
+  return out.changed ?? [];
 }
-function parseResultJson(text) {
+async function verifyDocsUrl(url, serverName, f2 = fetch) {
+  if (!/^https:\/\/\S+$/i.test(url)) return { ok: false, reason: "not an https URL" };
   try {
-    return JSON.parse(text);
-  } catch {
-    return null;
+    const r = await f2(url, { redirect: "follow", signal: AbortSignal.timeout(8e3), headers: { accept: "text/html, */*;q=0.5", "user-agent": "apiblaze-cli directory-check" } });
+    if (r.status !== 200) return { ok: false, reason: `answered ${r.status}` };
+    const body = (await r.text().catch(() => "")).toLowerCase();
+    if (serverName && !body.includes(serverName.toLowerCase())) return { ok: false, reason: `the page does not mention "${serverName}"` };
+    return { ok: true, reason: "live" };
+  } catch (e) {
+    return { ok: false, reason: e instanceof Error ? e.message : "unreachable" };
   }
 }
-async function runConnectorAnswers(project, opts = {}) {
+async function runConnectorDocs(project, opts = {}) {
   const caller = await requireCaller();
   const { teamId } = await resolveActingTeam(caller, opts.team);
   const proj2 = await resolveProjectVia(caller, teamId, project, opts.apiversion);
   const json = !!opts.json;
-  const interactive2 = !!process.stdin.isTTY && !json && !opts.yes;
-  const dh = parseDataHandling(opts.dataHandling, opts.dataHandlingStatement);
-  const health = parseYesNo("--health-data", opts.healthData);
-  const sponsored = parseYesNo("--sponsored-content", opts.sponsoredContent);
-  const access = opts.access ? opts.access.trim().toLowerCase() : void 0;
-  if (access && !["read", "write", "both"].includes(access)) throw new Error("--access must be read, write or both.");
-  const answers = {};
-  for (const q of QUESTIONS) {
-    const v = opts[q.key];
-    if (typeof v === "string" && v.trim()) answers[q.field] = v.trim();
-  }
-  if (access) answers.access = access;
-  if (opts.category?.length) answers.categories = opts.category.map((c) => c.trim()).filter(Boolean).slice(0, 5);
-  const meta = {};
-  if (dh) meta.data_handling = dh;
-  if (health) meta.health_data = health;
-  if (sponsored) meta.sponsored_content = sponsored;
-  if (interactive2) {
-    const current = await producer(caller, { method: "POST", path: `${projectPath2(proj2)}/directory-report`, body: { probe: false }, summary: "Current answers" });
-    const have = current.target?.metadata?.portalAnswers ?? {};
-    const { default: inquirer3 } = await import("inquirer");
-    const saveNow = async (part) => {
-      try {
-        await producer(caller, { method: "PATCH", path: projectPath2(proj2), body: part, summary: "Save an answer" });
-      } catch (e) {
-        console.log(import_chalk27.default.yellow(`  not saved: ${e instanceof Error ? e.message : String(e)}`));
-      }
-    };
-    for (const q of QUESTIONS) {
-      if (answers[q.field] !== void 0) continue;
-      const existing = typeof have[q.field] === "string" ? String(have[q.field]) : "";
-      if (existing.length >= (q.min ?? 1)) continue;
-      const a = await inquirer3.prompt([{ type: "input", name: "value", message: q.message, default: existing || void 0, validate: (v) => v.trim().length >= (q.min ?? 1) ? true : `${q.min ?? 1}+ characters` }]);
-      answers[q.field] = a.value.trim();
-      await saveNow({ directory_portal_answers: { [q.field]: a.value.trim() } });
-    }
-    if (answers.access === void 0 && !have.access) {
-      const a = await inquirer3.prompt([{ type: "list", name: "value", message: "What the tools do:", choices: ["read", "write", "both"] }]);
-      answers.access = a.value;
-      await saveNow({ directory_portal_answers: { access: a.value } });
-    }
-    if (answers.categories === void 0 && !(Array.isArray(have.categories) && have.categories.length)) {
-      const a = await inquirer3.prompt([{ type: "input", name: "value", message: "Category suggestions (1\u20135, comma-separated; you pick the closest in the portal):", validate: (v) => v.trim() ? true : "one at least" }]);
-      answers.categories = a.value.split(",").map((c) => c.trim()).filter(Boolean).slice(0, 5);
-      await saveNow({ directory_portal_answers: { categories: answers.categories } });
-    }
-    if (!meta.data_handling && !current.target?.metadata?.dataHandling) {
-      const a = await inquirer3.prompt([
-        { type: "list", name: "mode", message: "Whose API is behind this connector?", choices: [{ name: "own \u2014 my API, on my domain", value: "own" }, { name: "proxied \u2014 someone else's API I hold permission for", value: "proxied" }, { name: "third-party \u2014 someone else's API, no permission (cannot be listed)", value: "third-party" }] },
-        { type: "input", name: "statement", message: "The permission you hold (who granted what, and when; goes into portal step 7):", when: (ans) => ans.mode === "proxied", validate: (v) => v.trim().length >= 20 ? true : "a sentence, please" }
-      ]);
-      meta.data_handling = { mode: a.mode, ...a.statement?.trim() ? { statement: a.statement.trim() } : {} };
-      await saveNow({ directory_metadata: { data_handling: meta.data_handling } });
-    }
-    if (!meta.health_data && !current.target?.metadata?.healthData) {
-      const a = await inquirer3.prompt([{ type: "confirm", name: "value", message: "Do the tools handle health data?", default: false }]);
-      meta.health_data = a.value ? "yes" : "no";
-      await saveNow({ directory_metadata: { health_data: meta.health_data } });
-    }
-    if (!meta.sponsored_content && !current.target?.metadata?.sponsoredContent) {
-      const a = await inquirer3.prompt([{ type: "confirm", name: "value", message: "Do tool results carry sponsored content?", default: false }]);
-      meta.sponsored_content = a.value ? "yes" : "no";
-      await saveNow({ directory_metadata: { sponsored_content: meta.sponsored_content } });
-    }
-  }
-  const body = {};
-  if (Object.keys(answers).length) body.directory_portal_answers = answers;
-  if (Object.keys(meta).length) body.directory_metadata = meta;
-  if (!Object.keys(body).length) {
-    if (json) process.stdout.write(JSON.stringify({ project: proj2.projectId, changed: [] }) + "\n");
-    else console.log(import_chalk27.default.dim("  Nothing to record: pass flags (--use-cases, --data-handling \u2026) or run interactively."));
+  const say = (s) => {
+    if (!json) console.log(s);
+  };
+  const deps = opts.deps ?? {};
+  const fr = await producer(caller, { method: "GET", path: `${projectPath2(proj2)}/directory-facts?view=packet`, summary: "The facts the generator reads" });
+  const prompt = directoryDocsPrompt(fr.facts);
+  let docs = null;
+  let how = "";
+  if (opts.from) {
+    docs = parseGeneratedDocs(import_fs6.default.readFileSync(opts.from, "utf8"));
+    if (!docs) throw new Error(`${opts.from} does not hold the three documents (docs_markdown, reviewer_markdown, portal_answers).`);
+    how = `from ${opts.from}`;
+  } else if (opts.promptOut) {
+    import_fs6.default.writeFileSync(opts.promptOut, prompt + "\n", { mode: 384 });
+    say(import_chalk27.default.green(`  \u2713 prompt written to ${opts.promptOut}`));
+    say(import_chalk27.default.dim(`  Run it through a model that answers JSON matching the schema, save the answer, then: ${B.cli} connector docs ${proj2.projectName} --from <answer.json>`));
     return;
+  } else {
+    const installed3 = deps.claudeInstalled ?? detectExternalClis().some((c) => c.kind === "claude");
+    if (!installed3) {
+      const file2 = import_path5.default.join(import_os3.default.tmpdir(), `apiblaze-connector-docs-${proj2.projectId}.txt`);
+      import_fs6.default.writeFileSync(file2, prompt + "\n", { mode: 384 });
+      throw new Error(`Claude Code is not installed here, so the documents were not generated. The prompt is at ${file2}: run it through any model that answers JSON, then \`${B.cli} connector docs ${proj2.projectName} --from <answer.json>\`; or write them on the dashboard page.`);
+    }
+    say(import_chalk27.default.dim("  generating the three documents on Claude Code (30\u201390 s)\u2026"));
+    const g = generateWithClaude(prompt, deps);
+    if (!g.docs) throw new Error(`${g.detail}. Run again, or \`${B.cli} connector docs ${proj2.projectName} --prompt-out prompt.txt\` to use another model.`);
+    docs = g.docs;
+    how = g.detail;
   }
-  await producer(caller, { method: "PATCH", path: projectPath2(proj2), body, summary: "Store the portal answers" });
-  const r = await fetchDirectoryReport(caller, proj2, { probe: false });
+  const changed = await storeGeneratedDocs(caller, proj2, docs, { factsHash: fr.facts_hash, reviewerUsername: fr.facts.reviewer_username ?? null, useGeneratedDocsUrl: true });
   if (json) {
-    process.stdout.write(JSON.stringify({ project: proj2.projectId, changed: Object.keys({ ...answers, ...meta }), headline: r.rendered.headline, report: r.report }) + "\n");
+    process.stdout.write(JSON.stringify({ project: proj2.projectId, changed, docs_url: fr.generated_docs_url, how }) + "\n");
     return;
   }
-  console.log(import_chalk27.default.green(`  \u2713 recorded: ${Object.keys({ ...answers, ...meta }).join(", ")}`));
-  console.log(import_chalk27.default.dim(`  ${r.rendered.headline}`));
+  console.log(import_chalk27.default.green(`  \u2713 documents stored (${how}): ${changed.join(", ")}`));
+  console.log(`  Documentation page: ${import_chalk27.default.cyan(fr.generated_docs_url)} \u2014 link it from your site; edit it on the dashboard any time.`);
 }
-var import_chalk27, import_fs6, import_os3, import_path5, import_child_process6, DASHBOARD_BASE8, RUN_META_KEY, RUN_HEADER, projectPath2, QUESTIONS;
-var init_connector_exercise = __esm({
-  "src/commands/connector-exercise.ts"() {
+async function askDocsQuestion(caller, proj2, state, interactive2, say, deps = {}) {
+  if (!interactive2) return false;
+  const { default: inquirer3 } = await import("inquirer");
+  const a = await inquirer3.prompt([{ type: "input", name: "value", message: `Documentation for this connector on your site? Paste the URL, or N to use the generated page at ${state.generatedDocsUrl} (and link it from your site):`, default: state.docsUrl ?? "N" }]);
+  const v = a.value.trim();
+  if (!v || /^n(o)?$/i.test(v)) {
+    say(import_chalk27.default.dim("  using the generated page"));
+    try {
+      await runConnectorDocs(proj2.projectName, { deps, yes: true });
+    } catch (e) {
+      say(import_chalk27.default.yellow(`  ${e instanceof Error ? e.message : String(e)}`));
+      await producer(caller, { method: "PUT", path: `${projectPath2(proj2)}/directory-documents`, body: { use_generated_docs_url: true }, summary: "Point docs at the generated page" });
+    }
+    return true;
+  }
+  const check = await verifyDocsUrl(v, state.serverName, deps.fetch);
+  if (!check.ok) {
+    say(import_chalk27.default.yellow(`  ${v} is not usable as documentation yet: ${check.reason}. Not stored.`));
+    return false;
+  }
+  await producer(caller, { method: "PATCH", path: projectPath2(proj2), body: { directory_metadata: { docs_url: v, docs_confirmed: true } }, summary: "Store the documentation URL" });
+  say(import_chalk27.default.green(`  \u2713 docs: ${v} (live, names ${state.serverName ?? "the server"})`));
+  return true;
+}
+var import_chalk27, import_fs6, import_os3, import_path5, import_child_process6, projectPath2;
+var init_connector_docs = __esm({
+  "src/commands/connector-docs.ts"() {
     "use strict";
     import_chalk27 = __toESM(require("chalk"));
     import_fs6 = __toESM(require("fs"));
     import_os3 = __toESM(require("os"));
     import_path5 = __toESM(require("path"));
     import_child_process6 = require("child_process");
-    init_package();
     init_caller();
-    init_directory();
-    init_headless_login();
-    init_exercise();
-    init_brand();
+    init_directory_docs();
     init_external_mcp();
-    DASHBOARD_BASE8 = process.env.APIBLAZE_DASHBOARD_BASE || "https://dashboard.apiblaze.com";
-    RUN_META_KEY = "com.apiblaze/run";
-    RUN_HEADER = "apiblaze-directory-run";
+    init_brand();
     projectPath2 = (p) => `/projects/${encodeURIComponent(p.projectId)}/${encodeURIComponent(p.apiVersion)}`;
-    QUESTIONS = [
-      { key: "useCases", field: "use_cases", message: "Use cases (what a person asks it, in their words; 200+ characters):", min: 200 },
-      { key: "prerequisites", field: "prerequisites", message: "Prerequisites (one sentence: what a user needs before it works):", min: 1 },
-      { key: "companyName", field: "company_name", message: "Company name:", min: 1 },
-      { key: "companyWebsite", field: "company_website", message: "Company website (https):", min: 8 },
-      { key: "companyContact", field: "company_contact", message: "Primary contact (email or URL):", min: 3 },
-      { key: "reviewerInstructions", field: "reviewer_instructions", message: "Reviewer instructions (how to add it, sign in, one prompt per tool and what to expect; 400+ characters):", min: 400 }
-    ];
   }
 });
 
@@ -8172,10 +8444,10 @@ function derivedBehavior(method) {
 }
 function effectiveBehavior(method, o) {
   const d = derivedBehavior(method);
-  const readOnly = o?.readOnly ?? d.readOnly;
-  const destructive = readOnly ? false : o?.destructive ?? d.destructive;
+  const readOnly2 = o?.readOnly ?? d.readOnly;
+  const destructive = readOnly2 ? false : o?.destructive ?? d.destructive;
   return {
-    readOnly,
+    readOnly: readOnly2,
     destructive,
     idempotent: o?.idempotent ?? d.idempotent,
     confirm: o?.confirm ?? destructive,
@@ -11835,7 +12107,7 @@ function shortenTo(text, limit) {
   const base2 = atWord >= Math.floor(limit * 0.4) ? cut.slice(0, atWord) : cut;
   return base2.replace(/[\s,;:(\-–—]+$/g, "").trim();
 }
-async function promptForMissing(r, interactive2, defaults = { prompts: [] }, platforms = PLATFORMS, given = {}, save) {
+async function promptForMissing(r, interactive2, defaults = { prompts: [] }, platforms = PLATFORMS, given = {}, save, testPrompt) {
   const out = {};
   const failing = r.report.results.filter((x) => !x.pass && !x.unverified);
   const answered = (k) => {
@@ -11896,7 +12168,20 @@ async function promptForMissing(r, interactive2, defaults = { prompts: [] }, pla
           if (i >= 3) break;
           continue;
         }
-        lines.push(line.trim());
+        let text = line.trim();
+        if (testPrompt) {
+          let res = await testPrompt(text);
+          if (!res.called) {
+            say_(import_chalk30.default.yellow(`  \u2013 Claude called no tool for "${text}". A prompt should say what the tool does (a real URL, name or id helps).`));
+            const again = await inquirer3.prompt([{ type: "input", name: "line", message: "Reword it (Enter keeps it):", default: text, validate: withinLimit(a) }]);
+            if (again.line?.trim() && again.line.trim() !== text) {
+              text = again.line.trim();
+              res = await testPrompt(text);
+            }
+          }
+          say_(res.called ? import_chalk30.default.green(`  \u2713 Claude called ${res.tools.join(", ")}`) : import_chalk30.default.yellow("  \u2013 still no tool call; kept (the report will say so)"));
+        }
+        lines.push(text);
       }
       if (lines.length) {
         out.prompt = lines;
@@ -12214,7 +12499,6 @@ async function runConnector(target2, opts) {
     throw e;
   });
   for (const f2 of fixes.applied ?? []) say(import_chalk30.default.green(`  \u2713 fixed: ${f2}`));
-  for (const s of fixes.skipped ?? []) say(import_chalk30.default.dim(`  \u2013 ${s.fix}: ${s.reason}`));
   if (fixes.applied?.length) r = await fetchDirectoryReport(caller, proj2, { platforms });
   const domainWasBlocking = r.report.results.some((x) => x.id === DOMAIN_RULE && !x.pass);
   const domain2 = await ensureMcpDomain(caller, proj2, r, opts, defaults, interactive2, say);
@@ -12224,6 +12508,15 @@ async function runConnector(target2, opts) {
     if (changed) r = await fetchDirectoryReport(caller, proj2, { platforms });
   }
   if (await askOpenMode(caller, proj2, r, opts, interactive2, say)) r = await fetchDirectoryReport(caller, proj2, { platforms });
+  let reviewer = null;
+  if (r.report.results.some((x) => x.id === "TEST_ACCOUNT_SET" && !x.pass)) {
+    reviewer = await ensureReviewerAccount(caller, teamId, proj2);
+    if (!json) {
+      console.log();
+      printReviewer(reviewer, proj2);
+    }
+    r = await fetchDirectoryReport(caller, proj2, { platforms });
+  }
   const saveAnswer = async (f2) => {
     try {
       await patchProject(caller, proj2, { ...directoryBodyFromFlags(f2) }, "Save an answer");
@@ -12233,14 +12526,28 @@ async function runConnector(target2, opts) {
     }
   };
   const basics = await promptListingBasics(r, interactive2, defaults, opts, platforms, interactive2 ? saveAnswer : void 0);
+  let tester = null;
+  let testerTried = false;
+  const testPrompt = async (p) => {
+    if (!tester && !testerTried) {
+      testerTried = true;
+      const { createPromptTester: createPromptTester2 } = await Promise.resolve().then(() => (init_connector_exercise(), connector_exercise_exports));
+      tester = await createPromptTester2(caller, proj2, { say });
+    }
+    if (!tester) return { called: true, tools: [] };
+    say(import_chalk30.default.dim("  trying it through Claude Code\u2026"));
+    return tester.test(p);
+  };
   if (!isReady(r, platforms) || Object.keys(basics).length) {
-    const asked = { ...basics, ...isReady(r, platforms) ? {} : await promptForMissing(r, interactive2, defaults, platforms, basics, interactive2 ? saveAnswer : void 0) };
+    const asked = { ...basics, ...isReady(r, platforms) ? {} : await promptForMissing(r, interactive2, defaults, platforms, basics, interactive2 ? saveAnswer : void 0, interactive2 && opts.exercise !== false ? testPrompt : void 0) };
     const body = directoryBodyFromFlags(asked);
     if (body.directory_metadata || body.directory_attestations || body.openai_challenge_token) {
       await patchProject(caller, proj2, { ...body }, "Save listing details");
       r = await fetchDirectoryReport(caller, proj2, { platforms });
     }
   }
+  const provenPromptNotes = tester ? tester.notes() : [];
+  if (tester) await tester.close();
   const DOCS_RULES = ["DOCS_URL", "DOCS_PAGE_LIVE", "DOCS_IS_PROSE"];
   if (interactive2 && r.report.results.some((x) => DOCS_RULES.includes(x.id) && !x.pass)) {
     const { askDocsQuestion: askDocsQuestion2 } = await Promise.resolve().then(() => (init_connector_docs(), connector_docs_exports));
@@ -12248,43 +12555,41 @@ async function runConnector(target2, opts) {
     const generated = `https://${proj2.tenant ?? teamId}.portal.apiblaze.com/connector`;
     if (await askDocsQuestion2(caller, proj2, { docsUrl: meta.docsUrl ?? null, serverName: meta.serverName ?? null, generatedDocsUrl: generated }, interactive2, say)) r = await fetchDirectoryReport(caller, proj2, { platforms });
   }
-  let reviewer = null;
-  if (r.report.results.some((x) => x.id === "TEST_ACCOUNT_SET" && !x.pass)) {
-    reviewer = await ensureReviewerAccount(caller, teamId, proj2);
-    if (!json) {
-      console.log();
-      printReviewer(reviewer, proj2);
-    }
-    r = await fetchDirectoryReport(caller, proj2, { platforms });
-  }
   if (interactive2 && r.report.results.some((x) => ANSWER_RULES.includes(x.id) && !x.pass)) {
     const { runConnectorAnswers: runConnectorAnswers2 } = await Promise.resolve().then(() => (init_connector_exercise(), connector_exercise_exports));
-    say(import_chalk30.default.bold("  The review answers the portal asks for (saved as you go):"));
-    await runConnectorAnswers2(proj2.projectName, { team: opts.team, apiversion: opts.apiversion });
+    await runConnectorAnswers2(proj2.projectName, { team: opts.team, apiversion: opts.apiversion, platforms: [...platforms], derived: false });
     r = await fetchDirectoryReport(caller, proj2, { platforms });
   }
-  if (!readyExcept(r, platforms, [SNAPSHOT_RULE, ...EVIDENCE_RULES])) {
-    if (!domain2.active && domain2.hostname && !json) {
-      console.error(import_chalk30.default.yellow(`
-  ${domain2.hostname} is not active yet. Once the CNAME is in place, run again: ${B.cli} connector ${proj2.projectName}`));
-    }
-    exitWithReport(r, proj2, platforms, json);
-  }
   if (opts.exercise !== false) {
     let run2 = !!opts.yes;
     if (interactive2) {
       const { default: inquirer3 } = await import("inquirer");
-      run2 = (await inquirer3.prompt([{ type: "confirm", name: "run", message: "Run every tool now, as the reviewer, so the report can prove it works? (Y/n)", default: true }])).run;
+      run2 = (await inquirer3.prompt([{ type: "confirm", name: "run", message: `Run every tool now, ${isOpenMode(r) ? "the way a reviewer would" : "as the reviewer"}, so the report can prove it works?`, default: true }])).run;
     }
     if (run2) {
       const { runConnectorExercise: runConnectorExercise2 } = await Promise.resolve().then(() => (init_connector_exercise(), connector_exercise_exports));
-      await runConnectorExercise2(proj2.projectName, { team: opts.team, apiversion: opts.apiversion, json, yes: opts.yes, noEmail: opts.email === false });
+      const ran = await runConnectorExercise2(proj2.projectName, { team: opts.team, apiversion: opts.apiversion, json, yes: opts.yes, noEmail: opts.email === false, report: false, platforms: [...platforms], provenPromptNotes });
+      if (interactive2 && ran.failedPrompts.length) {
+        const { rewritten, prompts } = await rewriteFailedPrompts(r, ran.failedPrompts, saveAnswer, say);
+        if (rewritten.length) {
+          say(import_chalk30.default.dim(`  Running the ${prompts.length} prompts through Claude Code again (the report reads the last run)\u2026`));
+          await runConnectorExercise2(proj2.projectName, { team: opts.team, apiversion: opts.apiversion, json, noEmail: opts.email === false, report: false, platforms: [...platforms], promptsOnly: prompts });
+        }
+      }
+      if (interactive2 || opts.yes) await offerDrafts(caller, proj2, r, ran, interactive2, say);
       r = await fetchDirectoryReport(caller, proj2, { platforms, publishedUrl: r.report.project.publishedUrl ?? null });
     }
   }
-  if (!readyExceptSnapshot(r, platforms)) exitWithReport(r, proj2, platforms, json);
+  if (!readyExceptSnapshot(r, platforms)) {
+    if (!domain2.active && domain2.hostname && !json) {
+      console.error(import_chalk30.default.yellow(`
+  ${domain2.hostname} is not active yet. Once the CNAME is in place, run again: ${B.cli} connector ${proj2.projectId}`));
+    }
+    exitWithReport(r, proj2, platforms, json, interactive2);
+  }
   r = await fetchDirectoryReport(caller, proj2, { platforms, refreshSnapshot: true, publishedUrl: r.report.project.publishedUrl ?? null });
-  const packet = await producer(caller, { method: "GET", path: `${projectPath3(proj2)}/directory-packet`, summary: "Submission packet" });
+  const probes = await packetProbes(r);
+  const packet = await producer(caller, { method: "POST", path: `${projectPath3(proj2)}/directory-packet`, body: { platforms, ...probes ? { probes } : {} }, summary: "Submission packet" });
   const dir = opts.out ?? process.cwd();
   const mdPath = import_path6.default.join(dir, `connector-packet-${proj2.projectId}.md`);
   const jsonPath = import_path6.default.join(dir, `connector-packet-${proj2.projectId}.json`);
@@ -12304,13 +12609,93 @@ async function runConnector(target2, opts) {
   console.log(import_chalk30.default.green.bold(`  ${r.rendered.headline}`));
   console.log(`  Submission packet: ${import_chalk30.default.cyan(mdPath)} and ${import_chalk30.default.cyan(jsonPath)}`);
   console.log(import_chalk30.default.dim(isOpenMode(r) ? "  (open mode: no reviewer credentials in the packet; the connector takes no sign-in)" : "  (the packet carries the reviewer credentials \u2014 keep it out of git)"));
-  printSubmitSteps(r, mdPath);
+  printSubmitSteps(r, mdPath, platforms);
   console.log(import_chalk30.default.dim(`  ${r.report.disclaimer}`));
 }
+async function rewriteFailedPrompts(r, failed, save, say) {
+  const current = currentListingValue(r, "prompt");
+  const list = Array.isArray(current) ? [...current] : [];
+  const { default: inquirer3 } = await import("inquirer");
+  const rewritten = [];
+  say(import_chalk30.default.yellow(`  ${failed.length === 1 ? "This prompt" : `${failed.length} prompts`} made Claude call no tool; a prompt should name what the tool does${failed.length === 1 ? "" : ", one at a time"}:`));
+  for (const old of failed) {
+    const { value } = await inquirer3.prompt([{ type: "input", name: "value", message: `Rewrite "${old}" (Enter keeps it):`, default: old, validate: (v) => v.trim().length <= 300 ? true : `${v.trim().length} characters; 300 at most` }]);
+    const next = (value ?? "").trim();
+    if (!next || next === old) continue;
+    const at = list.indexOf(old);
+    if (at >= 0) list[at] = next;
+    else list.push(next);
+    rewritten.push(next);
+  }
+  if (rewritten.length) {
+    const why = await save({ prompt: list });
+    if (why) {
+      say_(import_chalk30.default.yellow(`  not saved: ${why}`));
+      return { rewritten: [], prompts: list };
+    }
+  }
+  return { rewritten, prompts: list };
+}
+async function packetProbes(r) {
+  const publishedUrl = r.report.project.publishedUrl;
+  if (!publishedUrl) return null;
+  const meta = r.target?.metadata ?? {};
+  try {
+    const { probeDirectoryTarget: probeDirectoryTarget2 } = await Promise.resolve().then(() => (init_directory_probes(), directory_probes_exports));
+    return await probeDirectoryTarget2({ publishedUrl, privacyUrl: meta.privacyUrl ?? null, docsUrl: meta.docsUrl ?? null, serverName: meta.serverName ?? null });
+  } catch {
+    return null;
+  }
+}
+async function offerDrafts(caller, proj2, r, ran, interactive2, say) {
+  if (!ran || !Array.isArray(ran.rows) || !ran.publishedUrl) return false;
+  const { draftMissing: draftMissing2, ANSWER_MIN: ANSWER_MIN2 } = await Promise.resolve().then(() => (init_portal_drafts(), portal_drafts_exports));
+  const meta = r.target?.metadata ?? {};
+  const prompts = (meta.examplePrompts ?? []).filter((p) => typeof p === "string" && !!p.trim());
+  const drafts = draftMissing2({
+    publishedUrl: ran.publishedUrl,
+    open: ran.open,
+    reviewerUsername: ran.reviewerUsername,
+    tools: ran.tools,
+    rows: ran.rows,
+    prompts,
+    promptTools: ran.promptTools,
+    serverName: meta.serverName,
+    tagline: meta.tagline,
+    description: meta.description
+  }, { use_cases: meta.portalAnswers?.use_cases, reviewer_instructions: meta.portalAnswers?.reviewer_instructions, description: meta.description });
+  if (!drafts.length) return false;
+  const inquirer3 = interactive2 ? (await import("inquirer")).default : null;
+  let saved = false;
+  say("");
+  say(import_chalk30.default.bold(`  Written from the run \u2014 the portal's ${drafts.map((d) => d.label.toLowerCase()).join(", ")}${drafts.length > 1 ? "" : ""}:`));
+  for (const d of drafts) {
+    let text = d.draft;
+    say("");
+    say(import_chalk30.default.bold(`  ${d.label}`) + import_chalk30.default.dim(` (${d.draft.length} characters; the portal wants ${ANSWER_MIN2[d.key]}+)`));
+    for (const line of d.draft.split("\n")) say(`    ${line}`);
+    if (inquirer3) {
+      const { ok } = await inquirer3.prompt([{ type: "confirm", name: "ok", message: `Use this ${d.label.toLowerCase()}? (n = type your own)`, default: true }]);
+      if (!ok) {
+        const { value } = await inquirer3.prompt([{ type: "input", name: "value", message: `${d.label}:`, ...d.current ? { default: d.current } : {}, validate: (v) => v.trim().length >= ANSWER_MIN2[d.key] ? true : `${v.trim().length}/${ANSWER_MIN2[d.key]} characters` }]);
+        text = value.trim();
+      }
+    }
+    const body = d.key === "description" ? { directory_metadata: { description: text } } : { directory_portal_answers: { [d.key]: text } };
+    try {
+      await patchProject(caller, proj2, body, `Save the ${d.label.toLowerCase()}`);
+      saved = true;
+      say(import_chalk30.default.green(`  \u2713 ${d.label.toLowerCase()} saved`));
+    } catch (e) {
+      say(import_chalk30.default.yellow(`  not saved: ${e instanceof Error ? e.message : String(e)}`));
+    }
+  }
+  return saved;
+}
 var SNAPSHOT_RULE = "LISTING_SNAPSHOT_MATCH";
+var withProject = (s, projectId) => s.replace(/<project>/g, projectId);
 var ANSWER_RULES = ["PORTAL_ANSWERS_COMPLETE", "HEALTH_SPONSORED_DECLARED", "API_OWNERSHIP_DOMAIN"];
-var EVIDENCE_RULES = ["TOOL_EXERCISED_EACH", "TOOL_ERROR_PATH_EACH", "REVIEWER_ACCOUNT_POPULATED", "TESTED_IN_CLAUDE_OR_INSPECTOR", "TESTED_FROM_CLAUDE", "EXAMPLE_PROMPTS_WORK", "OAUTH_FLOW_COMPLETED"];
-function exitWithReport(r, proj2, platforms, json) {
+function exitWithReport(r, proj2, platforms, json, interactive2 = false) {
   if (json) {
     process.stdout.write(JSON.stringify({ ready: false, project: proj2.projectId, headline: r.rendered.headline, report: r.report }) + "\n");
     process.exit(1);
@@ -12318,10 +12703,13 @@ function exitWithReport(r, proj2, platforms, json) {
   printReport(r, false);
   const want = platforms;
   const blocking = r.report.results.filter((x) => !x.pass && x.severity === "block" && !x.unverified && x.platforms.some((p) => want.includes(p)));
-  const first = blocking.find((x) => x.id !== SNAPSHOT_RULE) ?? blocking[0];
+  const real = blocking.filter((x) => x.id !== SNAPSHOT_RULE);
+  const first = real.find((x) => x.tier !== "review") ?? real[0] ?? blocking[0];
   console.error(import_chalk30.default.red(`
 Not ready: ${blocking.length} blocker${blocking.length === 1 ? "" : "s"} (${blocking.map((x) => x.id).join(", ")}).`));
-  if (first) console.error(`  Next: ${first.fix ?? first.message ?? first.title}`);
+  const name = proj2.projectId;
+  if (real.some((x) => ANSWER_RULES.includes(x.id))) console.error(`  Next: run \`${B.cli} connector ${name}\` in a terminal with the exercise on \u2014 it asks what only you can answer and writes the use cases, the reviewer instructions and the description from the run; or pass them: \`${B.cli} connector answers ${name} --use-cases \u2026 --data-handling own --health-data no --sponsored-content no\`.`);
+  else if (first) console.error(`  Next: ${withProject(first.fix ?? first.message ?? first.title, name)}`);
   console.error(import_chalk30.default.dim(`  Report page: ${DASHBOARD_BASE6}/directory/${encodeURIComponent(proj2.projectId)}/${encodeURIComponent(proj2.apiVersion)}`));
   process.exit(1);
 }
@@ -12437,15 +12825,21 @@ async function headStatus(u) {
     return 0;
   }
 }
-function printSubmitSteps(r, mdPath) {
+function printSubmitSteps(r, mdPath, platforms = PLATFORMS) {
   const url = r.report.project.publishedUrl ?? "(the MCP URL in the packet)";
   const open = isOpenMode(r);
+  const claude = platforms.includes("claude");
+  const chatgpt = platforms.includes("chatgpt");
+  const where = [claude ? "Claude (Settings \u2192 Connectors)" : null, chatgpt ? "ChatGPT (Developer mode)" : null].filter(Boolean).join(" and in ");
+  const steps = [
+    `Test it yourself first: add ${import_chalk30.default.cyan(url)} as a custom connector in ${where}, ${open ? "no sign-in needed (open mode)" : "sign in with the reviewer account"}, run a tool.`,
+    ...claude ? [`Claude: ${import_chalk30.default.underline(PORTALS.claude)} \u2192 Submit new \u2192 MCP connector. Paste the listing, ${open ? "Authentication: None with the access instructions" : "the reviewer credentials"} and the test steps from ${import_chalk30.default.cyan(import_path6.default.basename(mdPath))}.`] : [],
+    ...chatgpt ? [`ChatGPT: ${import_chalk30.default.underline(PORTALS.chatgpt)} \u2192 ${claude ? "the same packet" : `the packet (${import_chalk30.default.cyan(import_path6.default.basename(mdPath))})`}, plus the 5 + 3 test cases it lists.`] : [],
+    open ? "A nightly re-check emails you if the listing drifts." : "Keep the reviewer account alive; a nightly re-check emails you if the listing drifts."
+  ];
   console.log();
   console.log(import_chalk30.default.bold("  Submit (you do this part; the packet has every value to paste):"));
-  console.log(`  1. Test it yourself first: add ${import_chalk30.default.cyan(url)} as a custom connector in Claude (Settings \u2192 Connectors) and in ChatGPT (Developer mode), ${open ? "no sign-in needed (open mode)" : "sign in with the reviewer account"}, run a tool.`);
-  console.log(`  2. Claude: ${import_chalk30.default.underline(PORTALS.claude)} \u2192 Submit new \u2192 MCP connector. Paste the listing, ${open ? "Authentication: None with the access instructions" : "the reviewer credentials"} and the test steps from ${import_chalk30.default.cyan(import_path6.default.basename(mdPath))}.`);
-  console.log(`  3. ChatGPT: ${import_chalk30.default.underline(PORTALS.chatgpt)} \u2192 the same packet, plus the 5 + 3 test cases it lists.`);
-  console.log(`  4. Keep the reviewer account alive; a nightly re-check emails you if the listing drifts.`);
+  steps.forEach((s, i) => console.log(`  ${i + 1}. ${s}`));
   console.log();
 }
 
@@ -21260,7 +21654,9 @@ var connector = program.command("connector").description(`A compliant Claude con
   if (!project) throw new Error(`Which ${B.thingShort}? ${B.cli} connector <project>  \xB7  ${B.cli} connector https://\u2026/openapi.yaml  \xB7  ${B.cli} connector reviewer <project>  \xB7  ${B.cli} connector exercise <project>  \xB7  ${B.cli} connector answers <project>`);
   await runConnector(project, opts);
 }));
-connector.command("exercise").description("Call every tool the way a reviewer would, as the reviewer account (open mode: as you): reads with a valid and an invalid argument, writes only on ids the run created and only after a y, then the three listing prompts through Claude Code when it is installed. The gateway records the outcomes; the report reads them.").argument("<project>", `The ${B.thingShort} (project name)`).option("--empty-ok <tool>", 'A read-only tool whose correct answer is "nothing" (repeatable)', collect, []).option("--no-claude", "Skip the Claude Code pass").option("--no-email", "No email at the end of the run").option("-y, --yes", "No questions: writes are not exercised (they need a y), the rest runs").option("--team <id|name>", "Team the project is in (defaults to your active team)").option("--apiversion <version>", "API version (defaults to the project's)").option("--json", "Output machine-readable JSON").action(action((project, opts) => runConnectorExercise(project, { ...withConnectorOpts(opts), noClaude: opts.claude === false, noEmail: opts.email === false })));
+connector.command("exercise").description("Call every tool the way a reviewer would, as the reviewer account (open mode: as you): reads with a valid and an invalid argument, writes only on ids the run created and only after a y, then the three listing prompts through Claude Code when it is installed. The gateway records the outcomes; the report reads them.").argument("<project>", `The ${B.thingShort} (project name)`).option("--empty-ok <tool>", 'A read-only tool whose correct answer is "nothing" (repeatable)', collect, []).option("--no-claude", "Skip the Claude Code pass").option("--no-email", "No email at the end of the run").option("-y, --yes", "No questions: writes are not exercised (they need a y), the rest runs").option("--team <id|name>", "Team the project is in (defaults to your active team)").option("--apiversion <version>", "API version (defaults to the project's)").option("--json", "Output machine-readable JSON").action(action(async (project, opts) => {
+  await runConnectorExercise(project, { ...withConnectorOpts(opts), noClaude: opts.claude === false, noEmail: opts.email === false });
+}));
 connector.command("docs").description('Generate the three documents a listing needs \u2014 the public page "Using <name> in Claude" (served at <portal>/connector), the reviewer instructions and the portal answers \u2014 on your Claude Code from the facts of the connector; lint them, store them, point the docs URL at the page. Edit them on the dashboard any time.').argument("<project>", `The ${B.thingShort} (project name)`).option("--from <file>", "Paste back a JSON answer produced elsewhere (see --prompt-out)").option("--prompt-out <file>", "Write the prompt + facts to a file instead of running Claude Code").option("--team <id|name>", "Team the project is in (defaults to your active team)").option("--apiversion <version>", "API version (defaults to the project's)").option("--json", "Output machine-readable JSON").action(action((project, opts) => runConnectorDocs(project, withConnectorOpts(opts))));
 connector.command("answers").description("The portal's free-text steps 3\u20138 (use cases, prerequisites, access, categories, company, data handling, health data, sponsored content, reviewer instructions): asked when missing, or passed as flags").argument("<project>", `The ${B.thingShort} (project name)`).option("--use-cases <text>", "Use cases (200+ characters)").option("--prerequisites <text>", "What a user needs before it works (one sentence)").option("--access <read|write|both>", "What the tools do").option("--category <name>", "A category suggestion (repeatable, up to five; you pick the closest in the portal)", collect, []).option("--company-name <name>", "Company name").option("--company-website <url>", "Company website (https)").option("--company-contact <email|url>", "Primary contact").option("--reviewer-instructions <text>", "How to add it, sign in, one prompt per tool and what to expect (400+ characters)").option("--data-handling <mode>", "own \xB7 proxied (add --data-handling-statement) \xB7 third-party").option("--data-handling-statement <text>", "For proxied: the permission you hold").option("--health-data <yes|no>", "The tools handle health data").option("--sponsored-content <yes|no>", "Tool results carry sponsored content").option("-y, --yes", "No questions: record the flags only").option("--team <id|name>", "Team the project is in (defaults to your active team)").option("--apiversion <version>", "API version (defaults to the project's)").option("--json", "Output machine-readable JSON").action(action((project, opts) => runConnectorAnswers(project, withConnectorOpts(opts))));
 var withConnectorOpts = (opts) => ({ ...connector.opts(), ...opts ?? {} });