mcp-scraper 0.44.0 → 0.44.2

package/README.md

@@ -90,7 +90,7 @@ Build the branded one-click bundle:
 npm run build:mcpb
 ```
 
-The generated bundle is written to `build/mcpb/mcp-scraper-<version>.mcpb` and copied to `public/downloads/` for the hosted download. The current public bundle is `https://mcpscraper.dev/downloads/mcp-scraper.mcpb` (`0.44.0`, SHA-256 `83ce32972445fc1b3b308d7e79d6ad7248fb1485d4a13635249b85ea47ac6a61`). Install it by opening or dragging it into Claude Desktop. Claude displays the `MCP Scraper` install card, icon, and API-key configuration field from the bundle manifest.
+The generated bundle is written to `build/mcpb/mcp-scraper-<version>.mcpb` and copied to `public/downloads/` for the hosted download. The current public bundle is `https://mcpscraper.dev/downloads/mcp-scraper.mcpb` (`0.44.2`, SHA-256 `6ce5675c82d1fa0b7c645e0337aaac97de7760282067e5744259e8d0a4f03fc2`). Install it by opening or dragging it into Claude Desktop. Claude displays the `MCP Scraper` install card, icon, and API-key configuration field from the bundle manifest.
 
 The MCPB install exposes every tool — web-intelligence plus all `browser_*` tools — through the one `mcp-scraper` server.
 

package/dist/bin/api-server.cjs

@@ -24602,6 +24602,7 @@ function ensureLocalSourcebookSchema() {
       metadata_json TEXT NOT NULL DEFAULT '{}',
       created_at TEXT NOT NULL DEFAULT (datetime('now'))
     )`);
+    await publishEligibleEvidenceBackedLocalSourcebookRevisions(db);
   })().catch((error) => {
     schemaPromise3 = null;
     schemaDb3 = null;
@@ -24609,6 +24610,19 @@ function ensureLocalSourcebookSchema() {
   });
   return schemaPromise3;
 }
+async function publishEligibleEvidenceBackedLocalSourcebookRevisions(db = getDb()) {
+  const result = await db.execute(`UPDATE local_sourcebook_submissions
+    SET status = 'published', published_revision = draft_revision, updated_at = datetime('now')
+    WHERE status = 'needs_review'
+      AND EXISTS (
+        SELECT 1 FROM local_sourcebook_revisions r
+        WHERE r.submission_id = local_sourcebook_submissions.id
+          AND r.revision = local_sourcebook_submissions.draft_revision
+          AND r.actor_kind = 'system'
+          AND r.actor_id = 'local-sourcebook-worker'
+      )`);
+  return Number(result.rowsAffected ?? 0);
+}
 function rowValue(row, key) {
   return row[key];
 }
@@ -24678,23 +24692,12 @@ async function getLocalSourcebookDraft(id, ownerUserId) {
   const result = await getDb().execute({ sql: `SELECT payload_json FROM local_sourcebook_revisions WHERE submission_id = ? AND revision = ?`, args: [id, submission.draftRevision] });
   return result.rows[0] ? parseJson2(result.rows[0].payload_json) : null;
 }
-async function reviseLocalSourcebookDraft(id, ownerUserId, payload, baseRevision) {
-  const submission = await getLocalSourcebookSubmission(id, ownerUserId);
-  if (!submission) return null;
-  if (baseRevision !== void 0 && baseRevision !== submission.draftRevision) {
-    throw new Error(`Draft revision conflict: current revision is ${submission.draftRevision}, but the write targeted ${baseRevision}.`);
-  }
-  const revision = submission.draftRevision + 1;
-  await getDb().batch([
-    { sql: `INSERT INTO local_sourcebook_revisions (submission_id, revision, payload_json, actor_kind, actor_id) VALUES (?, ?, ?, 'owner', ?)`, args: [id, revision, JSON.stringify(payload), String(ownerUserId)] },
-    { sql: `UPDATE local_sourcebook_submissions SET draft_revision = ?, status = CASE WHEN status = 'published' THEN status ELSE 'needs_review' END, updated_at = datetime('now') WHERE id = ? AND owner_user_id = ?`, args: [revision, id, ownerUserId] }
-  ], "write");
-  await event(id, "draft.revised", "owner", String(ownerUserId), { revision });
-  return getLocalSourcebookSubmission(id, ownerUserId);
-}
 async function queueLocalSourcebookRefresh(id, ownerUserId) {
   const existing = await getLocalSourcebookSubmission(id, ownerUserId);
   if (!existing) return null;
+  if (existing.status === "rejected" || existing.status === "unpublished") {
+    throw new Error(`A ${existing.status} Local Sourcebook listing cannot be refreshed by its owner.`);
+  }
   const coverage = { ...existing.coverage, refreshRequestedAt: (/* @__PURE__ */ new Date()).toISOString() };
   await getDb().execute({ sql: `UPDATE local_sourcebook_submissions SET status = 'queued', coverage_json = ?, acquisition_claimed_at = NULL, acquisition_error = NULL, updated_at = datetime('now') WHERE id = ? AND owner_user_id = ?`, args: [JSON.stringify(coverage), id, ownerUserId] });
   await event(id, "enrichment.queued", "owner", String(ownerUserId));
@@ -24732,12 +24735,13 @@ async function completeLocalSourcebookAcquisition(id, payload, coverage, baseRev
         WHERE EXISTS (SELECT 1 FROM local_sourcebook_submissions WHERE id = ? AND status = 'enriching' AND draft_revision = ?)`,
       args: [id, revision, JSON.stringify(payload), id, expectedRevision]
     },
-    { sql: `UPDATE local_sourcebook_submissions SET draft_revision = ?, status = 'needs_review', coverage_json = ?, acquisition_claimed_at = NULL, acquisition_error = NULL, updated_at = datetime('now') WHERE id = ? AND status = 'enriching' AND draft_revision = ?`, args: [revision, JSON.stringify(coverage), id, expectedRevision] }
+    { sql: `UPDATE local_sourcebook_submissions SET draft_revision = ?, published_revision = ?, status = 'published', coverage_json = ?, acquisition_claimed_at = NULL, acquisition_error = NULL, updated_at = datetime('now') WHERE id = ? AND status = 'enriching' AND draft_revision = ?`, args: [revision, revision, JSON.stringify(coverage), id, expectedRevision] }
   ], "write");
   if (Number(results[0]?.rowsAffected ?? 0) !== 1 || Number(results[1]?.rowsAffected ?? 0) !== 1) {
     throw new Error(`Local Sourcebook acquisition revision conflict: revision ${expectedRevision} changed before completion.`);
   }
   await event(id, "enrichment.completed", "system", "local-sourcebook-worker", { revision, coverage });
+  await event(id, "publication.auto_published", "system", "local-sourcebook-worker", { revision });
   return getLocalSourcebookSubmission(id);
 }
 async function failLocalSourcebookAcquisition(id, message) {
@@ -24760,6 +24764,15 @@ async function listQueuedLocalSourcebookSubmissionIds(limit = 25) {
 async function publishLocalSourcebookSubmission(id) {
   const submission = await getLocalSourcebookSubmission(id);
   if (!submission) return null;
+  const revision = await getDb().execute({
+    sql: `SELECT actor_kind, actor_id FROM local_sourcebook_revisions WHERE submission_id = ? AND revision = ? LIMIT 1`,
+    args: [id, submission.draftRevision]
+  });
+  const actorKind = revision.rows[0] ? String(revision.rows[0].actor_kind) : "";
+  const actorId = revision.rows[0] ? String(revision.rows[0].actor_id) : "";
+  if (actorKind !== "system" || actorId !== "local-sourcebook-worker") {
+    throw new Error("Only a system-compiled Local Sourcebook revision can be published.");
+  }
   await getDb().execute({ sql: `UPDATE local_sourcebook_submissions SET status = 'published', published_revision = draft_revision, updated_at = datetime('now') WHERE id = ?`, args: [id] });
   await event(id, "publication.published", "admin", "admin", { revision: submission.draftRevision });
   return getLocalSourcebookSubmission(id);
@@ -26016,11 +26029,12 @@ async function runLocalSourcebookAcquisition(submission, provider = createDefaul
     await logRequestEvent({ userId: submission.ownerUserId, source: "local_sourcebook_maps", status: "done", query: submission.businessName, location: submission.state.toUpperCase(), resultCount: maps.reviews.length, result: { submissionId: submission.id, placeUrl: maps.placeUrl, cid: maps.cidDecimal ?? maps.cid, reviewsStatus: maps.reviewsStatus, reviewsRetained: maps.reviews.length, services: maps.services.length, areasServed: maps.areasServed.length } });
   } catch (error) {
     mapsError = errorMessage2(error);
+    maps = null;
     await creditMcIdempotent(submission.ownerUserId, MC_COSTS.maps_place, LedgerOperation.REFUND, `Local Sourcebook failed exact-place acquisition: ${submission.id}`, `${billingCycle}:maps-failure-refund`);
     mapsRefunded = true;
     await logRequestEvent({ userId: submission.ownerUserId, source: "local_sourcebook_maps", status: "failed", query: submission.businessName, location: submission.state.toUpperCase(), error: mapsError });
   }
-  if (!site && !maps) throw new Error(`Website and exact-place acquisition both failed. Website: ${siteError || "not available"}. Maps: ${mapsError || "not available"}.`);
+  if (!maps) throw new Error(`Exact-place acquisition is required before publication. Maps: ${mapsError || "not available"}. Website: ${siteError || (site ? "captured" : "not available")}.`);
   const compiled = compileLocalSourcebookListing({
     submission,
     site,
@@ -36602,18 +36616,18 @@ async function resolveLocalSourcebookTags(candidates) {
 function getLocalSourcebookContract(category) {
   return {
     name: "Local Sourcebook listing",
-    version: "local_sourcebook_listing_v1",
+    version: "local_sourcebook_listing_v2",
     purpose: "An owner-scoped, evidence-backed local business record with a separate public profile and complete captured-review archive.",
     categories: LOCAL_SOURCEBOOK_CATEGORIES,
     selectedCategory: category ?? null,
     categoryTag: category ? CATEGORY_TAG[category] : null,
     canonicalRoutes: { profile: "/{state}/{business-slug}/", reviews: "/{state}/{business-slug}/reviews" },
     requiredCreateFields: ["category", "state", "businessName", "websiteUrl", "tags", "idempotencyKey"],
-    requiredDraftSections: ["identity", "services/products", "service areas/locations", "genuine media", "reviews and theme counts", "evidence", "answered FAQ", "collection receipts"],
+    systemCompiledSections: ["identity", "services/products", "service areas/locations", "genuine media", "reviews and theme counts", "evidence", "answered FAQ", "collection receipts"],
     workflow: ["list-local-sourcebook-tags", "get-local-sourcebook-contract", "prepare-local-sourcebook-write", "validate-local-sourcebook-write", "local-sourcebook-capture", "local_sourcebook_submission_status"],
-    ownership: "Only the MCP Scraper account that captures a listing can read or revise its draft.",
+    ownership: "Only the MCP Scraper account that captures a listing can read it or request a paid evidence refresh.",
     acquisition: { websitePagesMaximum: 100, reviewsMaximum: 500, exactMapsIdentityRequired: true, partialResultsRequireStoppingReasons: true },
-    publication: { automatic: false, adminReviewRequired: true, lastPublishedRevisionRemainsPublicDuringRefresh: true },
+    publication: { automatic: true, evidenceCompiledOnly: true, ownerAuthoredClaimsAccepted: false, adminReviewRequired: false, lastPublishedRevisionRemainsPublicDuringRefresh: true },
     tagPolicy: { inspectVocabularyFirst: true, minimum: 1, maximum: 20, newTagsRequire: ["central=true", "reusable=true", "description"], newTagsStartAs: "pending" }
   };
 }
@@ -36636,7 +36650,8 @@ async function prepareLocalSourcebookWrite(input) {
     instructions: [
       "Resolve every review candidate before capture; do not silently create a near-duplicate tag.",
       "Call validate-local-sourcebook-write with the proposed identity, resolved tags, and any required tag decisions.",
-      "Call local-sourcebook-capture only after validation returns valid=true. Capture creates a private draft and queues paid acquisition; it does not publish."
+      "Call local-sourcebook-capture only after validation returns valid=true. Capture queues paid acquisition and automatically publishes the resulting system-compiled evidence revision.",
+      "Owners cannot supply public listing claims directly. Request local_sourcebook_refresh when source-backed public facts need to be reacquired."
     ]
   };
 }
@@ -36644,17 +36659,9 @@ async function validateLocalSourcebookWrite(input) {
   const errors = [];
   const warnings = [];
   let normalizedIdentity2;
-  let normalizedListing;
-  if (input.submissionId) {
-    if (!Number.isInteger(input.baseRevision) || Number(input.baseRevision) < 1) errors.push("baseRevision is required for an existing draft edit.");
-    const parsedListing = DirectoryListingDraftSchema.safeParse(input.listing);
-    if (!parsedListing.success) errors.push(...parsedListing.error.issues.map((issue) => `listing.${issue.path.join(".")}: ${issue.message}`));
-    else normalizedListing = parsedListing.data;
-  } else {
-    const parsedIdentity = DirectoryIdentitySchema.safeParse(input.identity);
-    if (!parsedIdentity.success) errors.push(...parsedIdentity.error.issues.map((issue) => `identity.${issue.path.join(".")}: ${issue.message}`));
-    else normalizedIdentity2 = parsedIdentity.data;
-  }
+  const parsedIdentity = DirectoryIdentitySchema.safeParse(input.identity);
+  if (!parsedIdentity.success) errors.push(...parsedIdentity.error.issues.map((issue) => `identity.${issue.path.join(".")}: ${issue.message}`));
+  else normalizedIdentity2 = parsedIdentity.data;
   const candidates = input.tagCandidates ?? (normalizedIdentity2?.tags.map((tag) => ({ tag })) ?? []);
   const resolutions = await resolveLocalSourcebookTags(candidates);
   const decisions = new Map((input.tagDecisions ?? []).map((decision) => [normalizeTag(decision.tag), decision]));
@@ -36673,12 +36680,12 @@ async function validateLocalSourcebookWrite(input) {
     }
     if (resolution2.action === "omit") warnings.push(`Tag \u201C${resolution2.candidate}\u201D will be omitted: ${resolution2.reason}`);
   }
-  if (!input.submissionId && normalizedIdentity2) {
+  if (normalizedIdentity2) {
     const categoryTag = CATEGORY_TAG[normalizedIdentity2.category];
     if (!normalizedTags.includes(categoryTag)) normalizedTags.unshift(categoryTag);
   }
   if (!normalizedTags.length) errors.push("At least one canonical directory tag is required.");
-  return { ok: true, valid: errors.length === 0, errors, warnings, normalizedIdentity: normalizedIdentity2, normalizedListing, normalizedTags: [...new Set(normalizedTags)], tagResolutions: resolutions };
+  return { ok: true, valid: errors.length === 0, errors, warnings, normalizedIdentity: normalizedIdentity2, normalizedTags: [...new Set(normalizedTags)], tagResolutions: resolutions };
 }
 async function persistLocalSourcebookTags(submissionId, userId, tags, decisions = []) {
   await ensureLocalSourcebookTags();
@@ -36695,12 +36702,7 @@ async function persistLocalSourcebookTags(submissionId, userId, tags, decisions
     await db.execute({ sql: `INSERT OR IGNORE INTO local_sourcebook_submission_tags (submission_id, tag) VALUES (?, ?)`, args: [submissionId, tag] });
   }
 }
-async function replaceLocalSourcebookTags(submissionId, userId, tags, decisions = []) {
-  await ensureLocalSourcebookTags();
-  await getDb().execute({ sql: `DELETE FROM local_sourcebook_submission_tags WHERE submission_id = ?`, args: [submissionId] });
-  await persistLocalSourcebookTags(submissionId, userId, tags, decisions);
-}
-var import_zod29, DIRECTORY_TAG_SEEDS, CATEGORY_TAG, DirectoryTagCandidateSchema, DirectoryTagDecisionSchema, DirectoryIdentitySchema, DirectoryListingDraftSchema;
+var import_zod29, DIRECTORY_TAG_SEEDS, CATEGORY_TAG, DirectoryTagCandidateSchema, DirectoryTagDecisionSchema, DirectoryIdentitySchema;
 var init_local_sourcebook_governance = __esm({
   "src/api/local-sourcebook-governance.ts"() {
     "use strict";
@@ -36753,23 +36755,6 @@ var init_local_sourcebook_governance = __esm({
       tags: import_zod29.z.array(import_zod29.z.string().trim().min(1).max(60)).max(20).default([]),
       idempotencyKey: import_zod29.z.string().trim().min(8).max(200)
     });
-    DirectoryListingDraftSchema = import_zod29.z.object({
-      id: import_zod29.z.string().min(1),
-      category: import_zod29.z.enum(LOCAL_SOURCEBOOK_CATEGORIES),
-      state: import_zod29.z.string().trim().length(2),
-      slug: import_zod29.z.string().trim().min(1),
-      name: import_zod29.z.string().trim().min(2),
-      summary: import_zod29.z.string().trim().min(20),
-      description: import_zod29.z.string().trim().min(20),
-      website: import_zod29.z.url(),
-      services: import_zod29.z.array(import_zod29.z.string()),
-      products: import_zod29.z.array(import_zod29.z.string()),
-      serviceAreas: import_zod29.z.array(import_zod29.z.string()),
-      media: import_zod29.z.array(import_zod29.z.record(import_zod29.z.string(), import_zod29.z.unknown())),
-      reviews: import_zod29.z.array(import_zod29.z.record(import_zod29.z.string(), import_zod29.z.unknown())),
-      evidence: import_zod29.z.array(import_zod29.z.record(import_zod29.z.string(), import_zod29.z.unknown())),
-      faq: import_zod29.z.array(import_zod29.z.object({ question: import_zod29.z.string().min(3), answer: import_zod29.z.string().min(12), evidenceIds: import_zod29.z.array(import_zod29.z.string()) }))
-    }).passthrough();
   }
 });
 
@@ -36779,10 +36764,10 @@ function acquisitionPlan(websiteUrl) {
     website: { startUrl: websiteUrl, mode: "broad_site_crawl", capture: ["homepage", "services", "products", "locations", "service_areas", "about", "team_staff", "contact", "policies"] },
     media: { requirement: "genuine_business_images_only", sources: ["business_website", "business_team_pages", "verified_business_profiles"] },
     reviews: { mode: "exhaust_accessible_continuation", requirement: "retain_each_review_and_source", disclosure: "report captured count, reported available count, and exact stopping reason" },
-    publication: { automatic: false, adminReviewRequired: true }
+    publication: { automatic: true, evidenceCompiledOnly: true, adminReviewRequired: false }
   };
 }
-var import_hono17, import_zod30, slug, SubmitSchema, DraftSchema, PrepareWriteSchema, ValidateWriteSchema, CaptureWriteSchema, localSourcebookApp, publicLocalSourcebookApp, adminLocalSourcebookApp;
+var import_hono17, import_zod30, slug, SubmitSchema, PrepareWriteSchema, ValidateWriteSchema, CaptureWriteSchema, localSourcebookApp, publicLocalSourcebookApp, adminLocalSourcebookApp;
 var init_local_sourcebook_routes = __esm({
   "src/api/local-sourcebook-routes.ts"() {
     "use strict";
@@ -36802,13 +36787,9 @@ var init_local_sourcebook_routes = __esm({
       slug: import_zod30.z.string().trim().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/).max(100).optional(),
       idempotencyKey: import_zod30.z.string().trim().min(8).max(200).optional()
     }).strict();
-    DraftSchema = import_zod30.z.object({ payload: import_zod30.z.record(import_zod30.z.string(), import_zod30.z.unknown()) }).strict();
     PrepareWriteSchema = DirectoryIdentitySchema.extend({ tagCandidates: import_zod30.z.array(DirectoryTagCandidateSchema).max(20).optional() });
     ValidateWriteSchema = import_zod30.z.object({
       identity: DirectoryIdentitySchema.optional(),
-      listing: import_zod30.z.record(import_zod30.z.string(), import_zod30.z.unknown()).optional(),
-      submissionId: import_zod30.z.string().trim().min(1).optional(),
-      baseRevision: import_zod30.z.number().int().min(1).optional(),
       tagCandidates: import_zod30.z.array(DirectoryTagCandidateSchema).max(20).optional(),
       tagDecisions: import_zod30.z.array(DirectoryTagDecisionSchema).max(20).optional()
     }).strict();
@@ -36840,13 +36821,6 @@ var init_local_sourcebook_routes = __esm({
       const validation = await validateLocalSourcebookWrite(parsed.data);
       if (!validation.valid) return c.json({ error: "invalid_directory_write", ...validation }, 400);
       try {
-        if (parsed.data.submissionId) {
-          const submission2 = await getLocalSourcebookSubmission(parsed.data.submissionId, Number(user.id));
-          if (!submission2) return c.json({ error: "not_found" }, 404);
-          const updated = await reviseLocalSourcebookDraft(submission2.id, Number(user.id), validation.normalizedListing, parsed.data.baseRevision);
-          await replaceLocalSourcebookTags(submission2.id, Number(user.id), validation.normalizedTags, parsed.data.tagDecisions);
-          return c.json({ ok: true, valid: true, submission: updated, normalizedTags: validation.normalizedTags, captured: "draft_revision", acquisitionQueued: false });
-        }
         const identity = validation.normalizedIdentity;
         if (!parsed.data.idempotencyKey && !identity.idempotencyKey) {
           return c.json({ error: "idempotency_key_required", message: "A stable idempotencyKey is required for a new Local Sourcebook capture." }, 400);
@@ -36924,22 +36898,21 @@ var init_local_sourcebook_routes = __esm({
       if (!submission) return c.json({ error: "not_found" }, 404);
       return c.json({ ok: true, submission, draft: await getLocalSourcebookDraft(submission.id, userId) });
     });
-    localSourcebookApp.on(["PATCH", "POST"], "/submissions/:id/draft", createApiKeyAuth(), async (c) => {
-      const user = c.get("user");
-      if (!user.subscription_tier) return c.json({ error: "subscription_required" }, 402);
-      const parsed = DraftSchema.safeParse(await c.req.json().catch(() => null));
-      if (!parsed.success) return c.json({ error: "invalid_draft", issues: parsed.error.issues }, 400);
-      const submission = await reviseLocalSourcebookDraft(c.req.param("id"), Number(user.id), parsed.data.payload);
-      if (!submission) return c.json({ error: "not_found" }, 404);
-      return c.json({ ok: true, submission });
-    });
+    localSourcebookApp.on(["PATCH", "POST"], "/submissions/:id/draft", createApiKeyAuth(), (c) => c.json({
+      error: "evidence_refresh_required",
+      message: "Owner-authored listing payloads are not accepted. Request a refresh so MCP Scraper can reacquire and compile the public evidence."
+    }, 409));
     localSourcebookApp.post("/submissions/:id/refresh", createApiKeyAuth(), async (c) => {
       const user = c.get("user");
       if (!user.subscription_tier) return c.json({ error: "subscription_required" }, 402);
-      const submission = await queueLocalSourcebookRefresh(c.req.param("id"), Number(user.id));
-      if (!submission) return c.json({ error: "not_found" }, 404);
-      const dispatched = await dispatchLocalSourcebookAcquisition(submission.id).catch(() => false);
-      return c.json({ ok: true, submission, acquisition: { queued: true, dispatched }, acquisitionPlan: acquisitionPlan(submission.websiteUrl) }, 202);
+      try {
+        const submission = await queueLocalSourcebookRefresh(c.req.param("id"), Number(user.id));
+        if (!submission) return c.json({ error: "not_found" }, 404);
+        const dispatched = await dispatchLocalSourcebookAcquisition(submission.id).catch(() => false);
+        return c.json({ ok: true, submission, acquisition: { queued: true, dispatched }, acquisitionPlan: acquisitionPlan(submission.websiteUrl) }, 202);
+      } catch (error) {
+        return c.json({ error: "moderated_listing", message: error instanceof Error ? error.message : String(error) }, 409);
+      }
     });
     publicLocalSourcebookApp = new import_hono17.Hono();
     publicLocalSourcebookApp.get("/:category/:state", async (c) => c.json({ ok: true, listings: await listPublicLocalSourcebook(c.req.param("category"), c.req.param("state").toLowerCase()) }));
@@ -40959,7 +40932,7 @@ var PACKAGE_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    PACKAGE_VERSION = "0.44.0";
+    PACKAGE_VERSION = "0.44.2";
   }
 });
 
@@ -41125,13 +41098,13 @@ Multi-step orchestrations \u2014 prefer these over hand-chaining primitives when
   **get-local-sourcebook-contract**, then **prepare-local-sourcebook-write**, inspect every tag resolution,
   and call **validate-local-sourcebook-write**. Call **local-sourcebook-capture** only when validation returns
   \`valid:true\`.
-- A new capture creates an owner-scoped private draft and queues paid broad website, exact Maps place,
-  maximum-accessible review, service-area, staff, and genuine-media acquisition. It does not publish.
-- Read progress and the compiled draft with **local_sourcebook_submission_status**. Revise an existing draft
-  through **validate-local-sourcebook-write** and **local-sourcebook-capture** with its current \`baseRevision\`.
-  Use **local_sourcebook_refresh** only when the owner intentionally wants to pay for a new acquisition pass.
-- The last approved revision remains public during refresh. Only an administrator can publish, reject, or
-  unpublish a listing.
+- A new capture queues paid broad website, exact Maps place, maximum-accessible review, service-area, staff,
+  and genuine-media acquisition. When compilation succeeds, that exact system-authored evidence revision
+  publishes automatically. Never supply owner-authored services, reviews, images, or other public claims.
+- Read progress and the compiled record with **local_sourcebook_submission_status**. Use
+  **local_sourcebook_refresh** only when the owner intentionally wants to pay for a new acquisition pass.
+- The last published revision remains public during refresh. Administrators can reject or unpublish an
+  exceptional record, but routine subscriber publication does not require administrator review.
 
 ## Notes
 - For current prices, balances, or limits, call \`credits_info\`. The public machine-readable rate contract is
@@ -41755,7 +41728,7 @@ var init_contracts = __esm({
 });
 
 // src/mcp/mcp-tool-schemas.ts
-var import_zod41, WEBSITE_URL_OR_DOMAIN_ERROR, WebsiteUrlOrDomainSchema, HarvestPaaInputSchema, ExtractUrlBaseInputSchema, ExtractUrlInputSchema, ExtractUrlLocalInputSchema, DiffPageBaseInputSchema, DiffPageInputSchema, DiffPageLocalInputSchema, MapSiteUrlsInputSchema, MapWaybackSnapshotsInputSchema, ExtractSiteInputSchema, AuditSiteInputSchema, CheckSiteExportInputSchema, ArchiveReadInputSchema, YoutubeHarvestInputSchema, YoutubeTranscribeInputSchema, FacebookPageIntelInputSchema, FacebookAdSearchInputSchema, RedditThreadInputSchema, RedditTrendingInputSchema, VideoFrameAnalysisInputSchema, VideoFrameAnalysisStatusInputSchema, FacebookAdTranscribeInputSchema, FacebookVideoTranscribeInputSchema, GoogleAdsSearchInputSchema, GoogleAdsPageIntelInputSchema, GoogleAdsTranscribeInputSchema, InstagramProfileContentInputSchema, InstagramMediaDownloadInputSchema, MapsPlaceIntelInputSchema, TrustpilotReviewsInputSchema, G2ReviewsInputSchema, ReviewCardSchema, MapsSearchInputSchema, DirectoryWorkflowInputSchema, LocationMarketsInputSchema, CommonsSearchEntitiesInputSchema, CommonsGetEntityInputSchema, CommonsFeaturedImageInputSchema, CommonsMediaInputSchema, CommonsCitationInputSchema, CommonsSourceInputSchema, CommonsRelatedLinkInputSchema, CommonsPrepareEntityInputSchema, CommonsSubmitEntityInputSchema, CommonsValidateEntityInputSchema, CommonsGetEntityLedgerInputSchema, CommonsSaveFilterInputSchema, CommonsListFiltersInputSchema, CommonsListNeedsLinksInputSchema, CommonsGenericOutputSchema, DirectoryWorkflowStatusInputSchema, LocalSourcebookSubmitInputSchema, LocalSourcebookCategorySchema, LocalSourcebookTagCandidateObjectSchema, LocalSourcebookTagDecisionObjectSchema, LocalSourcebookIdentityObjectSchema, GetLocalSourcebookContractInputSchema, ListLocalSourcebookTagsInputSchema, ResolveLocalSourcebookTagsInputSchema, PrepareLocalSourcebookWriteInputSchema, ValidateLocalSourcebookWriteInputSchema, LocalSourcebookCaptureInputSchema, LocalSourcebookSubmissionStatusInputSchema, LocalSourcebookUpdateDraftInputSchema, LocalSourcebookRefreshInputSchema, LocalSourcebookOutputSchema, ArtifactPointerOutputSchema, EditorialReadingRoomSiteSchema, EditorialReadingRoomArticleSchema, EditorialReadingRoomGuideInputSchema, EditorialReadingRoomGuideOutputSchema, CreateEditorialReadingRoomInputSchema, EditorialReadingRoomArtifactSchema, CreateEditorialReadingRoomOutputSchema, RenewEditorialReadingRoomDownloadInputSchema, RenewEditorialReadingRoomDownloadOutputSchema, RankTrackerModeSchema, RankTrackerBlueprintInputSchema, NullableString, MapsSearchAttemptOutput, MapsSearchOutputSchema, DirectoryMapsBusinessOutput, DirectoryCsvArtifactOutput, DirectoryWorkflowOutputSchema, LocationDatasetProvenanceOutput, LocationMarketsOutputSchema, RankTrackerToolPlanOutput, RankTrackerTableOutput, RankTrackerCronJobOutput, RankTrackerBlueprintOutputSchema, OrganicResultOutput, AiOverviewOutput, EntityIdsOutput, HarvestPaaOutputSchema, SearchSerpOutputSchema, ExtractUrlOutputSchema, DiffPageOutputSchema, ExtractSiteOutputSchema, AuditSiteOutputSchema, CheckSiteExportOutputSchema, ArchiveEntryOutputSchema, ArchiveReadOutputSchema, MapsPlaceIntelOutputSchema, TrustpilotReviewsOutputSchema, G2ReviewsOutputSchema, CreditsInfoOutputSchema, MapSiteUrlsOutputSchema, WaybackCaptureOutputSchema, MapWaybackSnapshotsOutputSchema, YoutubeHarvestOutputSchema, FacebookAdSearchOutputSchema, VideoFrameAnalysisOutputSchema, VideoFrameAnalysisStatusOutputSchema, RedditThreadOutputSchema, RedditTrendingOutputSchema, FacebookPageIntelOutputSchema, GoogleAdsSearchOutputSchema, GoogleAdsPageIntelOutputSchema, TranscriptSignalOutput, FacebookVideoTranscribeOutputSchema, TranscriptChunkOutput, InstagramBrowserOutput, InstagramPaginationOutput, InstagramProfileContentOutputSchema, InstagramMediaTrackOutput, InstagramDownloadOutput, InstagramMediaDownloadOutputSchema, YoutubeTranscribeOutputSchema, FacebookAdTranscribeOutputSchema, GoogleAdsTranscribeOutputSchema, CaptureSerpSnapshotOutputSchema, CaptureSerpPageSnapshotsOutputSchema, CreditsInfoInputSchema, WorkflowIdSchema2, WorkflowListInputSchema, WorkflowSuggestInputSchema, WorkflowRunInputSchema, WorkflowStepInputSchema, WorkflowStatusInputSchema, WorkflowArtifactReadInputSchema, WorkflowRecipeOutput, WorkflowDefinitionOutput, WorkflowArtifactOutput, WorkflowListOutputSchema, WorkflowSuggestOutputSchema, WorkflowRunOutputSchema, WorkflowStepOutputSchema, WorkflowStatusOutputSchema, WorkflowArtifactReadOutputSchema, SearchSerpInputSchema, CaptureSerpSnapshotInputSchema, ScreenshotInputSchema, CaptureSerpPageSnapshotsInputSchema, ReportArtifactReadInputSchema, ReportArtifactReadOutputSchema, ListServiceConnectionsInputSchema, ListServiceConnectionsOutputSchema, TestServiceConnectionInputSchema, TestServiceConnectionOutputSchema, ReadServiceConnectionInputSchema, ReadServiceConnectionOutputSchema, MetaAdCreativeMediaInputSchema, MetaAdCreativeMediaOutputSchema, ImportServiceConnectionToMemoryInputSchema, ImportServiceConnectionToMemoryOutputSchema, DescribeServiceConnectionToolInputSchema, DescribeServiceConnectionToolOutputSchema, ConnectedDataContinuationSchema, ExportConnectedServiceDataInputSchema, ConnectedDataArtifactSchema, ExportConnectedServiceDataOutputSchema, SearchConsoleTableColumnSchema, SearchConsoleTableFilterSchema, ExportSearchConsoleTableDataInputSchema, ExportSearchConsoleTableDataOutputSchema, RenewConnectedDataExportDownloadInputSchema, RenewConnectedDataExportDownloadOutputSchema, CallServiceConnectionActionInputSchema, CallServiceConnectionActionOutputSchema, SetScheduledActionConnectionsInputSchema, SetScheduledActionConnectionsOutputSchema, SlackSendMessageInputSchema, SlackSendMessageOutputSchema, GmailSendMessageInputSchema, GmailSendMessageOutputSchema, GmailSearchContactsInputSchema, GmailSearchContactsOutputSchema, GoogleCalendarCreateEventInputSchema, GoogleCalendarCreateEventOutputSchema, ZoomCreateMeetingInputSchema, ZoomCreateMeetingOutputSchema;
+var import_zod41, WEBSITE_URL_OR_DOMAIN_ERROR, WebsiteUrlOrDomainSchema, HarvestPaaInputSchema, ExtractUrlBaseInputSchema, ExtractUrlInputSchema, ExtractUrlLocalInputSchema, DiffPageBaseInputSchema, DiffPageInputSchema, DiffPageLocalInputSchema, MapSiteUrlsInputSchema, MapWaybackSnapshotsInputSchema, ExtractSiteInputSchema, AuditSiteInputSchema, CheckSiteExportInputSchema, ArchiveReadInputSchema, YoutubeHarvestInputSchema, YoutubeTranscribeInputSchema, FacebookPageIntelInputSchema, FacebookAdSearchInputSchema, RedditThreadInputSchema, RedditTrendingInputSchema, VideoFrameAnalysisInputSchema, VideoFrameAnalysisStatusInputSchema, FacebookAdTranscribeInputSchema, FacebookVideoTranscribeInputSchema, GoogleAdsSearchInputSchema, GoogleAdsPageIntelInputSchema, GoogleAdsTranscribeInputSchema, InstagramProfileContentInputSchema, InstagramMediaDownloadInputSchema, MapsPlaceIntelInputSchema, TrustpilotReviewsInputSchema, G2ReviewsInputSchema, ReviewCardSchema, MapsSearchInputSchema, DirectoryWorkflowInputSchema, LocationMarketsInputSchema, CommonsSearchEntitiesInputSchema, CommonsGetEntityInputSchema, CommonsFeaturedImageInputSchema, CommonsMediaInputSchema, CommonsCitationInputSchema, CommonsSourceInputSchema, CommonsRelatedLinkInputSchema, CommonsPrepareEntityInputSchema, CommonsSubmitEntityInputSchema, CommonsValidateEntityInputSchema, CommonsGetEntityLedgerInputSchema, CommonsSaveFilterInputSchema, CommonsListFiltersInputSchema, CommonsListNeedsLinksInputSchema, CommonsGenericOutputSchema, DirectoryWorkflowStatusInputSchema, LocalSourcebookSubmitInputSchema, LocalSourcebookCategorySchema, LocalSourcebookTagCandidateObjectSchema, LocalSourcebookTagDecisionObjectSchema, LocalSourcebookIdentityObjectSchema, GetLocalSourcebookContractInputSchema, ListLocalSourcebookTagsInputSchema, ResolveLocalSourcebookTagsInputSchema, PrepareLocalSourcebookWriteInputSchema, ValidateLocalSourcebookWriteInputSchema, LocalSourcebookCaptureInputSchema, LocalSourcebookSubmissionStatusInputSchema, LocalSourcebookRefreshInputSchema, LocalSourcebookOutputSchema, ArtifactPointerOutputSchema, EditorialReadingRoomSiteSchema, EditorialReadingRoomArticleSchema, EditorialReadingRoomGuideInputSchema, EditorialReadingRoomGuideOutputSchema, CreateEditorialReadingRoomInputSchema, EditorialReadingRoomArtifactSchema, CreateEditorialReadingRoomOutputSchema, RenewEditorialReadingRoomDownloadInputSchema, RenewEditorialReadingRoomDownloadOutputSchema, RankTrackerModeSchema, RankTrackerBlueprintInputSchema, NullableString, MapsSearchAttemptOutput, MapsSearchOutputSchema, DirectoryMapsBusinessOutput, DirectoryCsvArtifactOutput, DirectoryWorkflowOutputSchema, LocationDatasetProvenanceOutput, LocationMarketsOutputSchema, RankTrackerToolPlanOutput, RankTrackerTableOutput, RankTrackerCronJobOutput, RankTrackerBlueprintOutputSchema, OrganicResultOutput, AiOverviewOutput, EntityIdsOutput, HarvestPaaOutputSchema, SearchSerpOutputSchema, ExtractUrlOutputSchema, DiffPageOutputSchema, ExtractSiteOutputSchema, AuditSiteOutputSchema, CheckSiteExportOutputSchema, ArchiveEntryOutputSchema, ArchiveReadOutputSchema, MapsPlaceIntelOutputSchema, TrustpilotReviewsOutputSchema, G2ReviewsOutputSchema, CreditsInfoOutputSchema, MapSiteUrlsOutputSchema, WaybackCaptureOutputSchema, MapWaybackSnapshotsOutputSchema, YoutubeHarvestOutputSchema, FacebookAdSearchOutputSchema, VideoFrameAnalysisOutputSchema, VideoFrameAnalysisStatusOutputSchema, RedditThreadOutputSchema, RedditTrendingOutputSchema, FacebookPageIntelOutputSchema, GoogleAdsSearchOutputSchema, GoogleAdsPageIntelOutputSchema, TranscriptSignalOutput, FacebookVideoTranscribeOutputSchema, TranscriptChunkOutput, InstagramBrowserOutput, InstagramPaginationOutput, InstagramProfileContentOutputSchema, InstagramMediaTrackOutput, InstagramDownloadOutput, InstagramMediaDownloadOutputSchema, YoutubeTranscribeOutputSchema, FacebookAdTranscribeOutputSchema, GoogleAdsTranscribeOutputSchema, CaptureSerpSnapshotOutputSchema, CaptureSerpPageSnapshotsOutputSchema, CreditsInfoInputSchema, WorkflowIdSchema2, WorkflowListInputSchema, WorkflowSuggestInputSchema, WorkflowRunInputSchema, WorkflowStepInputSchema, WorkflowStatusInputSchema, WorkflowArtifactReadInputSchema, WorkflowRecipeOutput, WorkflowDefinitionOutput, WorkflowArtifactOutput, WorkflowListOutputSchema, WorkflowSuggestOutputSchema, WorkflowRunOutputSchema, WorkflowStepOutputSchema, WorkflowStatusOutputSchema, WorkflowArtifactReadOutputSchema, SearchSerpInputSchema, CaptureSerpSnapshotInputSchema, ScreenshotInputSchema, CaptureSerpPageSnapshotsInputSchema, ReportArtifactReadInputSchema, ReportArtifactReadOutputSchema, ListServiceConnectionsInputSchema, ListServiceConnectionsOutputSchema, TestServiceConnectionInputSchema, TestServiceConnectionOutputSchema, ReadServiceConnectionInputSchema, ReadServiceConnectionOutputSchema, MetaAdCreativeMediaInputSchema, MetaAdCreativeMediaOutputSchema, ImportServiceConnectionToMemoryInputSchema, ImportServiceConnectionToMemoryOutputSchema, DescribeServiceConnectionToolInputSchema, DescribeServiceConnectionToolOutputSchema, ConnectedDataContinuationSchema, ExportConnectedServiceDataInputSchema, ConnectedDataArtifactSchema, ExportConnectedServiceDataOutputSchema, SearchConsoleTableColumnSchema, SearchConsoleTableFilterSchema, ExportSearchConsoleTableDataInputSchema, ExportSearchConsoleTableDataOutputSchema, RenewConnectedDataExportDownloadInputSchema, RenewConnectedDataExportDownloadOutputSchema, CallServiceConnectionActionInputSchema, CallServiceConnectionActionOutputSchema, SetScheduledActionConnectionsInputSchema, SetScheduledActionConnectionsOutputSchema, SlackSendMessageInputSchema, SlackSendMessageOutputSchema, GmailSendMessageInputSchema, GmailSendMessageOutputSchema, GmailSearchContactsInputSchema, GmailSearchContactsOutputSchema, GoogleCalendarCreateEventInputSchema, GoogleCalendarCreateEventOutputSchema, ZoomCreateMeetingInputSchema, ZoomCreateMeetingOutputSchema;
 var init_mcp_tool_schemas = __esm({
   "src/mcp/mcp-tool-schemas.ts"() {
     "use strict";
@@ -42276,24 +42249,17 @@ var init_mcp_tool_schemas = __esm({
       tagCandidates: import_zod41.z.array(LocalSourcebookTagCandidateObjectSchema).max(20).optional()
     };
     ValidateLocalSourcebookWriteInputSchema = {
-      identity: LocalSourcebookIdentityObjectSchema.optional().describe("New-listing identity returned by prepare-local-sourcebook-write."),
-      listing: import_zod41.z.record(import_zod41.z.string(), import_zod41.z.unknown()).optional().describe("Complete replacement listing draft for an existing owner-scoped submission."),
-      submissionId: import_zod41.z.string().trim().min(1).optional().describe("Existing owner-scoped submission being revised. Omit for a new capture."),
-      baseRevision: import_zod41.z.number().int().min(1).optional().describe("Required current draft revision for an edit, preventing silent overwrites."),
+      identity: LocalSourcebookIdentityObjectSchema.describe("New-listing identity returned by prepare-local-sourcebook-write. Evidence-bearing public fields are compiled by MCP Scraper and cannot be supplied here."),
       tagCandidates: import_zod41.z.array(LocalSourcebookTagCandidateObjectSchema).max(20).optional(),
       tagDecisions: import_zod41.z.array(LocalSourcebookTagDecisionObjectSchema).max(20).optional()
     };
     LocalSourcebookCaptureInputSchema = {
       ...ValidateLocalSourcebookWriteInputSchema,
-      idempotencyKey: import_zod41.z.string().trim().min(8).max(200).optional().describe("Stable retry key for a new capture. Required for new listings; omit only when revising an existing submissionId.")
+      idempotencyKey: import_zod41.z.string().trim().min(8).max(200).optional().describe("Stable retry key for a new capture. Required either here or in identity.")
     };
     LocalSourcebookSubmissionStatusInputSchema = {
       submissionId: import_zod41.z.string().trim().min(1).describe("The owner-scoped submission ID returned by local-sourcebook-capture.")
     };
-    LocalSourcebookUpdateDraftInputSchema = {
-      submissionId: import_zod41.z.string().trim().min(1),
-      payload: import_zod41.z.record(import_zod41.z.string(), import_zod41.z.unknown()).describe("Complete replacement draft. The previous revision remains immutable in the audit history.")
-    };
     LocalSourcebookRefreshInputSchema = {
       submissionId: import_zod41.z.string().trim().min(1).describe("Owner-scoped listing submission to re-crawl and refresh.")
     };
@@ -45244,14 +45210,14 @@ function registerPaaExtractorMcpTools(server, executor, options = {}) {
   }, async (input) => executor.prepareLocalSourcebookWrite(input));
   server.registerTool("validate-local-sourcebook-write", {
     title: "Validate Local Sourcebook Write",
-    description: "Validate a proposed new listing or complete owner draft revision without writing it. Checks identity or listing completeness, canonical tags, tag decisions, and baseRevision requirements. Capture only when valid is true.",
+    description: "Validate a proposed new listing identity without writing it. Checks business identity, canonical tags, and explicit tag decisions. Public facts are compiled from MCP Scraper evidence rather than accepted from the owner. Capture only when valid is true.",
     inputSchema: ValidateLocalSourcebookWriteInputSchema,
     outputSchema: recordOutputSchema("validate-local-sourcebook-write", LocalSourcebookOutputSchema),
     annotations: localPlanningToolAnnotations("Validate Local Sourcebook Write")
   }, async (input) => executor.validateLocalSourcebookWrite(input));
   server.registerTool("local-sourcebook-capture", {
     title: "Capture Governed Local Sourcebook Listing",
-    description: "Strict owner-scoped write path after list, contract, prepare, and validate. A new capture registers canonical tags and queues paid website, exact-place, review, service-area, staff, and genuine-media acquisition. An edit requires the current baseRevision. Capture never publishes; admin review remains required.",
+    description: "Strict owner-scoped write path after list, contract, prepare, and validate. Capture registers canonical tags and queues paid website, exact-place, review, service-area, staff, and genuine-media acquisition. A successful system-compiled evidence revision publishes automatically; owner-authored public claims are not accepted.",
     inputSchema: LocalSourcebookCaptureInputSchema,
     outputSchema: recordOutputSchema("local-sourcebook-capture", LocalSourcebookOutputSchema),
     annotations: liveWebToolAnnotations("Capture Governed Local Sourcebook Listing")
@@ -45265,7 +45231,7 @@ function registerPaaExtractorMcpTools(server, executor, options = {}) {
   }, async (input) => executor.localSourcebookSubmissionStatus(input));
   server.registerTool("local_sourcebook_refresh", {
     title: "Refresh a Local Sourcebook Listing",
-    description: "Queue a new broad crawl and review/media acquisition pass for a listing owned by the authenticated MCP Scraper account.",
+    description: "Queue a new broad crawl and review/media acquisition pass for a listing owned by the authenticated MCP Scraper account. The last published revision remains public until the refreshed evidence revision completes and auto-publishes.",
     inputSchema: LocalSourcebookRefreshInputSchema,
     outputSchema: recordOutputSchema("local_sourcebook_refresh", LocalSourcebookOutputSchema),
     annotations: liveWebToolAnnotations("Refresh a Local Sourcebook Listing")
@@ -45891,9 +45857,6 @@ var init_http_mcp_tool_executor = __esm({
       localSourcebookSubmissionStatus(input) {
         return this.getJson(`/local-sourcebook/submissions/${encodeURIComponent(input.submissionId)}`);
       }
-      localSourcebookUpdateDraft(input) {
-        return this.call(`/local-sourcebook/submissions/${encodeURIComponent(input.submissionId)}/draft`, { payload: input.payload });
-      }
       localSourcebookRefresh(input) {
         return this.call(`/local-sourcebook/submissions/${encodeURIComponent(input.submissionId)}/refresh`, {});
       }