Factory docs, home
Page navigation

Historical local qualification: Source 7cf4b26e focused Core 22/22 and Dashboard 26/26 checks passed. The historical bounded local record keeps their exact scope. Historical source 7cf4b26e passed the 3,286/3,286 full checks and all 36 installed families. Independent bounded local evidence acceptance passed; exact-final-head CI is recorded separately from this frozen local proof. Module-specific and broader limits remain below.

See the input → responsibility → output diagram.

Status: In progress. Reviewed local candidate, 3 October 2026. Independent source and retained installed stage evidence passed. The independently reviewed concert retains its 7/7 snapshot. Historical source 7cf4b26e passed the 3,286/3,286 full checks and all 36 installed families. Independent bounded local evidence acceptance passed; exact-final-head CI is recorded separately from this frozen local proof. Fact-linked rendering and durable drafting retain original jobs and replay accounting; no live drafter, publication or customer benefit is qualified. Historical reviewed scope.

Release copy is easy to get subtly wrong. A figure loses its population, a planned feature sounds available, or a benefit is claimed before anyone has measured it. A withdrawn fact can also stay in last month's announcement.

A teal bob with a small megaphone, checking an index card of facts.

Meet the careful crier. Only what the facts support. Turns confirmed product facts into marketing copy and refuses any claim, figure or promise a fact does not support. Meet the whole Plumb family.

The Marketing Workflow builds copy only from typed facts. Each block of a brief is written with placeholders such as {fact:export-csv}, and code fills each one from its fact, keeping the population, dates and qualification beside the figure. Every block shows which facts it cites.

A block is refused, not rewritten, when a fact is missing, out of date, withdrawn or for another product. Some claims need evidence:

  • a benefit needs a Supported Assessment;
  • availability needs a release record and a recent passing check;
  • a competitor comparison needs a citation under 30 days old that the owner approved.

Wording that no fact supports is refused too: figures typed into the text (in digits, other numerals such as ½ or Ⅻ, or words), superlatives, guarantees, pricing and personal details. Words that claim a cause, availability or a benefit, such as "because", "now available" or "saves", must be the wording of a fact of that kind; written beside such a fact, they are still refused, because nothing ties them to it. Broad scope such as "worldwide" or "every customer" must come from a fact too. Outside a typed quantity, its unit's scale and its dates, a figure is refused wherever a fact renders it: in its unit, population or qualification, or in the text of a measurement, benefit or competitor fact. The finished text is checked as a whole, so a figure or word split across a placeholder is still caught, and so is a sign, decimal point or symbol typed against a fact's figure (-{fact:x} reading -38). A refusal never repeats personal details.

A pack keeps its original meaning. Checking it again later shows, block by block, whether it is still current. A withdrawn or changed fact marks the pack invalidated without rewriting it.

The step 2 draft runs this as a job that records each step in the caller's own journal. Running the same job again gives the same answer without redoing work; a run that records its start reports fresh work even if another run completes the job before it reads it; changing its inputs needs a new revision. A drafting tool can be plugged in to suggest better wording for each block. It sees only the facts it may cite, never one whose own wording holds personal details, and it can only write placeholders; the same rules check every suggestion, and a refused one is dropped, as is one that would make the whole pack too large. The job has a fixed budget of calls, bytes and time that never grows. If a call fails, is cancelled or runs out of time, its result is unknown: it is counted against the budget and never repeated, and the block keeps its original wording. A reply that arrives after the deadline is not used, and once the job is cancelled or out of time the tool is not asked at all.

Honest limits:

  • The checker and renderer are pure. The job stores only its own record in the caller's journal. Its drafting tool has been tried only with test stand-ins, never with a real model, and nothing publishes a pack.
  • A job interrupted mid-call waits until its deadline before treating that call as lost, because another run may still be waiting on it.
  • Stopping a drafting tool is a request, not a guarantee. The job tells the tool to stop and ignores anything it sends later, but a tool that ignores the request keeps running; once its call is marked unknown, what the tool goes on to do is unknown too.
  • The job's record has a fixed size limit. A suggestion whose result would not fit, such as one refused for hundreds of figures, is dropped whole and counted as too large, so the job can always finish.
  • A tool that hands back a Promise inside its reply is refused, and that Promise is watched so its failure cannot crash the process. A Promise built to refuse being watched (one whose constructor lookup throws), or one buried deeper than the fixed limits, cannot be; the tool runs in the same process and can always crash it.
  • Invisible format characters (zero-width spaces, soft hyphens, word joiners) are refused as malformed input, because they could hide a listed word or figure. Look-alike letters from other scripts (a Cyrillic "е" in "thrее") are not detected, so a word screen can be evaded that way.
  • The screens are fixed word lists. They catch common unsupported wording, not every misleading sentence or paraphrase, and they do not check British spelling. Short words such as "one" or "cut" are refused even when they make no claim. Some wording is not checked against the facts at all: a plain sentence that uses none of the listed words ("Payroll exports CSV."); a place, segment or product named in the template ("in the US", "Payroll:"), which is not compared with the fact's population, qualification or subject; and number words outside the lists, such as "thrice", "quarter" or "first". A capability or availability fact's own text may carry figures, such as a version, and is trusted as written.
  • The private installed consumer now proves historical packs, current source changes, restart replay and the job's bounded drafting behaviour. Historical 7cf bounded installed/full execution and independent evidence acceptance passed. Separately scoped component review, a live drafting tool and publication remain distinct gates.

Standalone adoption · Agent contract · W33 packet

Shared value implementation: common contracts. Owning errors, limits, stored identities and authority remain as specified above.

Source: docs/guide/marketing-workflow.md