Hoppa till huvudinnehållet

CLI och konfigurationsdistribution

De publicerade CLI- och config-paketen @openstaticfish/chattybox-cli@0.3.1 och @openstaticfish/chattybox-config@0.3.1 implementerar konfigurations-/backendkontraktet 0.3.0. Den lokala validatorn och backendvalidatorn använder samma regler och avvisar okända nycklar.

CLI:t skapar, validerar, distribuerar, promoterar och återställer oföränderliga ChattyBox-konfigurationsversioner. Varje distributionstoken är begränsad till ett befintligt projekt och valda miljöetiketter. JavaScript-SDK:t @openstaticfish/chattybox@0.1.4 är ett separat paket och ingår inte i configkontraktet. Paketversioner och schemaVersion: "1" är separata versionssystem. status visar miljöversionen, medan runtimeConfigVersionId är den senaste konfigurationen som tillämpats på den gemensamma runtime-miljön och kan skilja sig. När mode utelämnas väljs crawl utan att ett uttryckligt maxDepth: 0 ändras.

CLI:t är ett ESM-kommandoradsprogram som kräver Node.js 20 eller senare. bunx följer som standard CLI:ts Node-shebang, så installera Node eller välj uttryckligen Bun med bunx --bun @openstaticfish/chattybox-cli .... Det är inte ett webbläsarverktyg. CI för publicerade paket testar Node 20, 22 och 24 på Linux, inte en allmän kompatibilitetsmatris för operativsystem eller webbläsare. Lås en testad paketversion i produktionsautomatisering; exemplen utan version använder det installerade, cachade eller publicerade paketet, inte källkoden i detta arkiv.

Vad konfiguration som kod hanterar​

Konfigurationen styr projektets namn och beskrivning, assistentens persona och reservbeteende, upptäckt och uppdatering av webbplatsinnehåll, språkinställningar samt den hostade widgetens utseende. En distribution till preview eller production tillämpar värdena och köar en uppdatering av den befintliga korpusen. Med konfigurationslås ändras konfigurationsägda inställningar via versionshanterade distributioner, med undantag för varumärkesinställningen enligt planens behörighet.

Projektet skapas först i instrumentpanelen. Publika widgetnycklar och valfria originbegränsningar, hantering av distributionstoken, analysdata, konversationer, innehållsluckor, destruktiva åtgärder och uppladdade ikonfiler ingår inte i konfigurationen. Använd en URL eller emoji för en deklarativ anpassad ikon. Konfigurationen innehåller inget projekt-ID; den hemliga distributionstoken väljer det enda projekt som tar emot konfigurationen. Behandla en konfigurationsfil och en projektbegränsad token som ett hanterat ChattyBox-projekt.

En publik widgetnyckel används för chatt och widgetkonfiguration och kan finnas i webbläsarkod. Nycklar utan begränsningar fungerar mellan origins, medan en nyckel som förberetts för en webbplats redan kan vara begränsad. Valfria originbegränsningar är extra skydd, inte besökarautentisering. En distributionstoken används för deploy, promote, rollback och status för ett projekt och valda miljöer; den ska hållas hemlig lokalt eller i CI och får inte användas i webbläsarkod.

Skapa en konfiguration​

bunx @openstaticfish/chattybox-cli init

Detta skapar chattybox.config.json:

{
"schemaVersion": "1",
"assistant": {
"name": "Support"
},
"knowledge": {
"sources": [
{
"type": "website",
"url": "https://example.com"
}
]
},
"widget": {
"enabled": true
}
}

Använd en anpassad sökväg när konfigurationen hör hemma i en underkatalog:

bunx @openstaticfish/chattybox-cli init config/chattybox.config.json

Validera lokalt eller i CI​

bunx @openstaticfish/chattybox-cli validate
bunx @openstaticfish/chattybox-cli validate config/chattybox.config.json

Lokal validering och backendvalidering använder samma konfigurationsregler och avvisar okända fält på alla objektnivåer. Valideringen läser bara JSON, gör inga nätverksanrop, kontrollerar inte token eller planbehörighet och tillämpar inga standardvärden. knowledge kan utelämnas vid lokal validering eller i development, men måste innehålla exakt en webbplatskälla om det anges; preview och production kräver källan. Om widget anges är widget.enabled obligatoriskt. Lokal validering är ingen distributionsgaranti.

Valideringen kontrollerar bland annat objektstruktur, obligatoriskt assistentnamn, uppräknade värden, HTTP(S)-URL:er, heltalsgränser, språkkombinationer och sexsiffriga hex-färger. Den läser inte TypeScript, JSONC, YAML eller ett fjärrschema. Include- och exclude-poster måste vara icke-tomma strängar. runtime.locale är en förkortning för fast språk med överskrivning avstängd och kan inte kombineras med localeMode, defaultLocale eller allowLocaleOverride: true. Servern kontrollerar planbehörighet och tokenens omfattning.

Skapa en distributionstoken​

Öppna Chatbot-inställningar → Utvecklarkonfiguration och skapa en token för de miljöer som arbetsflödet kan ändra. Kopiera hela tokenvärdet i klartext direkt; ChattyBox lagrar en hash och begränsade identifierings- och livscykelmetadata, men kan inte visa hela tokenvärdet igen.

Formuläret väljer först endast development och ingen utgångstid. Välj uttryckligen preview eller production när det behövs.

I instrumentpanelen kan du välja att token inte ska löpa ut eller att den ska löpa ut efter 7, 30, 90 eller 365 dagar. Det autentiserade API:t för att skapa token accepterar ett heltal från 1 till 365 dagar; om antalet dagar utelämnas löper token inte ut. Ett projekt får ha högst 20 aktiva token som inte har gått ut. Rotera en token genom att skapa en ersättning, uppdatera CI och sedan återkalla den gamla token. CLI:t har inga kommandon för inloggning eller för att skapa, lista eller återkalla token.

Ange token och widgetens API-URL. Under Installera → Installation på webbplatsen använder du kodsnuttens data-api-url när den finns; annars hämtar du HTTP-actions-distributionens URL från distributionskonfigurationen. Installationsflödet kan kräva att konfigurationen först är klar:

export CHATTYBOX_DEPLOY_TOKEN='cb_cfg_v1_...'
export CHATTYBOX_API_URL='https://your-deployment.convex.site/chat'

Checka aldrig in token och inkludera den aldrig i webbläsarkod. Lagra den i CI-leverantörens krypterade hemlighetslager. Distributionstoken autentiseras med Authorization: Bearer ...; publika widgetnycklar kan inte ersätta dem. Hanteringsrutterna skyddas inte av widgetens origin-begränsningar, kräver ingen Origin-header och har ingen webbläsar-CORS-åtkomst. Token är inte origin-bunden: den som har den kan anropa API:t från en server.

Saknade, felaktiga, utgångna, återkallade token, token för fel miljö eller på annat sätt ogiltiga token ger HTTP 401 INVALID_TOKEN. Token slutar också fungera när projektet eller ägaren saknas eller håller på att tas bort.

Använd HTTP-actions-distributionens rot-URL eller widgetens URL som slutar med /chat, inte en .convex.cloud-klient-URL eller en fullständig /v1/config/deployments-endpoint. CLI:t tar bort avslutande snedstreck och ett sista /chat och lägger sedan till hanteringsrutten. HTTPS krävs utom för localhost, 127.0.0.1 eller [::1]; autentiseringsuppgifter, frågesträngar och fragment i API-URL:en avvisas. Verifiera destinationen innan du anger en hemlighet.

När du har verifierat distributionsarbetsflödet kan du aktivera Config-as-code lock i samma inställningssektion. Låset är oåterkalleligt via den nuvarande instrumentpanelen, CLI och publika API; det finns ingen upplåsningsfunktion. Aktivering skapar varken en token eller en version. Ha ett testat tokenflöde innan du låser.

Låset blockerar skrivningar från instrumentpanelen till config-ägda projekt- och widgetinställningar, ikonuppladdningar och manuella korpusåtgärder som skrapning, sidborttagning, rensning av innehåll och återskapande av embeddings. Schemalagt arbete och projektradering fortsätter att fungera. Tokenhantering, hantering av publika nycklar och operativa läsåtgärder är fortfarande tillgängliga. Branding är undantaget: branding-inställningen i instrumentpanelen kan fortfarande ändras på låsta projekt enligt planens behörigheter. Att dölja attribution kräver Starter eller högre; om widget.showBranding utelämnas bevaras den befintliga inställningen (eller blir true om ingen finns), medan Free-planens runtime alltid visar branding.

Distribuera konfigurationen​

En distribution skapar en oföränderlig version och promoterar den till den valda miljön:

bunx @openstaticfish/chattybox-cli deploy --environment preview
bunx @openstaticfish/chattybox-cli deploy --environment production

development registrerar endast en version/pekare (applied: false, indexingStatus: "not_required"). preview och production skriver över samma projekts runtime-inställningar och använder samma korpus och publika widgetnycklar; den senaste runtime-promoteringen vinner även om den andra miljöns pekare fortfarande visar en äldre version. En preview-begränsad token kan därför ändra ett projekt som betjänar produktionstrafik. Använd separata projekt med respektive token och nycklar för verklig isolering. Båda miljöerna tillämpar konfigurationen atomiskt och köar ett skrapningsjobb (applied: true, indexingStatus: "pending"), men väntar inte på skrapning eller embeddings. Korpusen är ingen versionshanterad ögonblicksbild, och en misslyckad uppdatering återställer inte den tillämpade konfigurationen.

Uppdateringar ändrar sidor på plats och begär embeddings när innehållet ändras; gamla URL:er raderas inte bara för att en ny källa eller ett nytt filter utelämnar dem. Delvisa uppdateringar kan finnas kvar efter ett fel. Jobben registrerar ett konfigurationsversions-ID men läser också ändringsbara skrapningsinställningar; undvik överlappande distributioner när konsekvent indexering är viktig.

Distribuera hela den önskade konfigurationen, inte en patch. Utelämnade config-ägda värden kan rensa eller återställa tidigare inställningar från instrumentpanelen. Om widget utelämnas aktiveras widgeten. Om widget finns med gäller dess obligatoriska värde för enabled; utelämnade inställningar för widgetens text, tema och placering rensas separat så att runtime-standardvärden används. Vid runtime-promotering raderas en tidigare uppladdad ikonfil oavsett om en deklarativ ersättningsikon anges. Standardikonen väljs endast när widget.icon utelämnas; den väljs inte vid varje promotering.

Om project.description eller assistentens prompt, profil eller reservtext utelämnas rensas respektive lagrad åsidosättning. Utelämnat runtime återställer automatiskt språkval, standardspråket en och tillåten språkändring via skript. Utelämnade källfilter rensas och automatisk uppdatering stängs av; lägesspecifika inställningar tillämpas bara för motsvarande läge. widget.showBranding är undantaget: ett utelämnat värde bevarar den lagrade inställningen, medan ett uttryckligt värde skriver över den vid nästa runtime-promotering.

Om mode är sitemap och sitemapUrl utelämnas används först en upptäckt webbplatskarta; därefter provas /sitemap.xml och /sitemap_index.xml, och om ingen av dem ger URL:er används den sparade webbplatsadressen.

Den oföränderliga konfigurationsversionen behåller det begärda maxPages-värdet, medan runtime-promotering begränsar den operativa skrapningsinställningen till 100 000. Om maxPages utelämnas blir begäran planens inkluderade sidutrymme för kontot: Free 10, Starter 150, Pro 5 000 och Business 25 000. Urvalet begränsas av det begärda värdet och av det högsta av leverantörskapaciteten och projektets befintliga sidantal; därmed kan befintliga sidor uppdateras även om leverantörskapaciteten är lägre. Nya sidor prövas separat mot ägarens sammanlagda sidutrymme på kontot. Upptäckt av webbplatskartor kan hämta kartdokument och räkna upp URL:er före urvalet; kapacitetsgränsen är därför varken en integritetsgräns eller en gräns för utgående förfrågningar. Värdet garanterar inte att alla begärda sidor indexeras.

Automatisk daglig uppdatering och ett uttryckligt showBranding: false kräver Starter eller högre; Free tillåter automatisk uppdatering varje vecka eller månad. Behörigheten kontrolleras vid promotering till preview eller production, även vid rollback, inte vid lokal validering eller registrering för development. En tidigare giltig version kan misslyckas efter ett planbyte. Promoteringen använder servercachade planuppgifter, inte ett direkt anrop till faktureringsleverantören; kontrollera faktureringssynkronisering och faktisk skrapningskvot separat vid nyliga plan- eller PAYG-ändringar.

Använd --json i automatisering för att få API-resultatet, inklusive version._id, miljöpekaren, applied, indexingStatus och ID:t för skrapningsjobbet. Spara version._id från deploy-/promote-/rollback-utdata eller activeVersion._id från statusutdata; det synliga versionsnumret kan inte användas som --version.

Status, promotering och återställning​

bunx @openstaticfish/chattybox-cli status --environment production

bunx @openstaticfish/chattybox-cli promote \
--version '<config-version-id>' \
--environment production

bunx @openstaticfish/chattybox-cli rollback \
--version '<known-good-config-version-id>' \
--environment production

--version använder det opaka konfigurationsversions-ID:t från deploy/promote/rollback-utdata (version._id) eller statusutdata (activeVersion._id), inte det synliga versionsnumret. Återställning använder samma backendåtgärd som promotion, behöver inte rikta in sig på en äldre version och skriver över den valda miljöns pekare och promotionsmetadata; någon append-only-promotionshistorik finns inte. För preview eller production tillämpar den konfigurationen på nytt med aktuella behörigheter och köar en ny uppdatering i stället för att återställa historiskt korpusinnehåll.

status visar den valda miljöetikettens version och pekare, inte den faktiska runtime-konfigurationen, skillnader mot instrumentpanelen eller skrapnings- och embeddingförloppet. En miljö utan distribution ger environment: null och activeVersion: null. runtimeConfigVersionId visar den senaste konfigurationen som tillämpats på den gemensamma runtime-miljön och kan skilja sig från miljöpekaren. Instrumentpanelsändringar kan också ändra runtime-fält utan att ändra ID:t om konfigurationen inte är låst. Lyckade statusanrop uppdaterar tokenens lastUsedAt och använder kapacitet i hanteringens anropsgräns. Kontrollera indexeringen separat i instrumentpanelen.

Kommandon och fel​

init [path] skapar vid behov överordnade kataloger men skriver inte över en befintlig fil. validate [path] läser och validerar JSON lokalt. Båda använder chattybox.config.json som standardsökväg och accepterar endast en positionssökväg utan extra flaggor. deploy kräver --environment och accepterar valfritt --config <path>. promote och rollback kräver både --environment och --version <opaque-id>; status kräver --environment. De tre sistnämnda läser inte en lokal konfigurationsfil.

De fyra hanteringskommandona accepterar --token, --api-url och --json. Uttryckliga flaggor har företräde framför CHATTYBOX_DEPLOY_TOKEN och CHATTYBOX_API_URL; föredra hemliga miljövariabler framför token i skalhistorik eller processargument. Det finns ingen standardmiljö. Okända, dubbla, tomma och för kommandot otillämpliga alternativ avvisas. Använd chattybox --help för hjälp på toppnivå; CLI:ts --version på toppnivå är inte samma sak som promote-flaggan.

CLI:t har inga flaggor för --dry-run, --wait, --force, --project, meddelande eller optimistisk samtidighetskontroll. HTTP-API:t stöder fält för förväntad version, men CLI:t skickar dem inte; kör CI-distributioner till samma projekt i följd. Lyckade kommandon avslutas med kod 0 och fil-, validerings-, argument-, transport- och HTTP-fel med kod 1. --json formaterar bara lyckade resultat. CLI:t har ingen automatisk omförsökning, polling eller konfigurerad timeout; kontrollera status före ett nytt försök efter ett transportfel eftersom servern redan kan ha genomfört distributionen.

Hanteringsrutterna delar en gräns på 20 anrop per minut och token. HTTP 429 använder den gemensamma begränsningsformen och Retry-After. API-fel kan bland annat vara 401 INVALID_TOKEN, 404 NOT_FOUND, 409 CONFIG_CONFLICT, 413 BODY_TOO_LARGE, 422 INVALID_CONFIG eller 500 INTERNAL_ERROR; felaktigt formade typade ID:n ger 422. Maximal begäranskropp är 262 144 byte. Ett helt saknat POST-innehåll ger för närvarande 500, till skillnad från felaktig JSON som ger 422.

CI/CD-arbetsflöden​

Lägg till CHATTYBOX_DEPLOY_TOKEN som en krypterad produktionsbegränsad hemlighet hos din CI-leverantör. Lägg till CHATTYBOX_API_URL som en hemlighet eller variabel med HTTP-actions-distributionens URL eller widgetens API-URL från Installera → Installation på webbplatsen, när den finns. Kör validering på pull requests, men begränsa produktionsdistribution till din skyddade standardgren eller en godkänd distributionsmiljö.

GitHub Actions​

name: Deploy ChattyBox configuration

on:
pull_request:
push:
branches: [main]

jobs:
validate:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: oven-sh/setup-bun@v2
- uses: actions/setup-node@v6
with:
node-version: 24
- run: bunx @openstaticfish/chattybox-cli validate

deploy:
if: github.event_name == 'push'
needs: validate
runs-on: ubuntu-latest
environment: production
steps:
- uses: actions/checkout@v4
- uses: oven-sh/setup-bun@v2
- uses: actions/setup-node@v6
with:
node-version: 24
- name: Validate and deploy
env:
CHATTYBOX_DEPLOY_TOKEN: ${{ secrets.CHATTYBOX_DEPLOY_TOKEN }}
CHATTYBOX_API_URL: ${{ vars.CHATTYBOX_API_URL }}
run: |
bunx @openstaticfish/chattybox-cli validate
bunx @openstaticfish/chattybox-cli deploy --environment production --json

Använd en produktionshemlighet som är begränsad till miljön och kräv godkännande av distributionen när ditt arkiv stöder det. CLI:t registrerar vanliga CI-variabler för commit och branch tillsammans med den oföränderliga versionen.

GitLab CI/CD​

Lagra båda värdena under Settings → CI/CD → Variables. Skydda distributionstoken, maskera den och begränsa den till miljön production.

.gitlab-ci.yml
image: oven/bun:1

validate_chattybox:
stage: test
rules:
- if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
script:
- bunx --bun @openstaticfish/chattybox-cli validate

deploy_chattybox:
stage: deploy
environment: production
rules:
- if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH'
script:
- bunx --bun @openstaticfish/chattybox-cli validate
- bunx --bun @openstaticfish/chattybox-cli deploy --environment production --json

GitLab exponerar automatiskt CHATTYBOX_DEPLOY_TOKEN och CHATTYBOX_API_URL för jobbet med deras variabelnamn. Använd en skyddad standardgren så att skyddade variabler inte är tillgängliga för opålitliga grenar. Bun-containerexemplen använder uttryckligen --bun och behöver därför inte en separat Node-installation; verifiera den låsta Bun- eller image-versionen i CI.

Bitbucket Pipelines​

Lägg till båda värdena som distributionsvariabler under Repository settings → Pipelines → Deployments → Production. Markera distributionstoken som säkrad.

bitbucket-pipelines.yml
image: oven/bun:1

pipelines:
pull-requests:
'**':
- step:
name: Validate ChattyBox configuration
script:
- bunx --bun @openstaticfish/chattybox-cli validate
branches:
main:
- step:
name: Deploy ChattyBox configuration
deployment: Production
script:
- bunx --bun @openstaticfish/chattybox-cli validate
- bunx --bun @openstaticfish/chattybox-cli deploy --environment production --json

Ersätt main om din standardgren har ett annat namn. Bitbucket injicerar distributionsvariabler endast i steg som är kopplade till den distributionsmiljön. CLI:t har ingen särskild BITBUCKET_*-mappning för metadata utan använder lokal Git för commit och gren, vilket kan sakna grennamn i en frikopplad checkout.

Konfigurationsavsnitt​

AvsnittSyfte
schemaVersionVäljer det offentliga konfigurationskontraktet. Version 1 stöds för närvarande.
projectValfria projektmetadata, exempelvis beskrivningen i instrumentpanelen.
assistantNamnger assistenten och definierar valfritt dess promptprofil och systemprompt.
knowledge.sourcesDeklarerar webbplatskällor och valfria mönster för inkludering och exkludering.
runtimeStyr Auto/Fixed-locale, standardspråk och sidans locale-overrides.
widgetStyr aktivering, placering, text, färger och presentation med standard-, emoji- eller URL-ikon i den utökade konfigurationen.

Persona och kunskapskällor​

Det här exemplet är en post i knowledge.sources, inte en fullständig konfiguration. Det kräver de publicerade CLI/config-paketen 0.3.1 och motsvarande backendkontrakt 0.3.0. Daglig uppdatering kräver Starter eller högre; maxPages: 500 är en begäran som begränsas av tillgänglig kapacitet, inte en garanti för indexering.

{
"type": "website",
"url": "https://docs.example.com",
"mode": "sitemap",
"sitemapUrl": "https://docs.example.com/docs-sitemap.xml",
"include": ["/docs/"],
"exclude": ["/private/"],
"maxPages": 500,
"autoRescrape": true,
"rescrapeInterval": "daily"
}

Välj promptProfile som default, support, sales eller sarcastic för en inbyggd persona, eller custom med systemPrompt för en egen. Om en inbyggd profil och systemPrompt båda anges har den uttryckliga prompten företräde.

Källägena är homepage för enbart url, sitemap för webbplatskartor, manual för en icke-tom manualUrls-lista och crawl för konventionella webbplatskartor följt av länkar upp till maxDepth om kartorna inte ger URL:er. En uttrycklig webbplatskarta utan URL:er gör att jobbet misslyckas. Inget av dessa urval raderar automatiskt tidigare sparade sidor.

include och exclude matchar skiftlägeskänsliga delsträngar i URL:er, inte globmönster eller reguljära uttryck. En exclude-träff avvisar URL:en även vid en include-träff; tomma listor filtrerar inte. Filtren gäller även startsida och manuellt urval. maxPages ska vara ett positivt heltal och begränsas vid körning enligt kapacitetskontrollerna ovan. maxDepth ska vara ett heltal från 0 till 20 och styr länkföljning som reserv, inte uppräkning via webbplatskarta. autoRescrape: true kräver rescrapeInterval med daily, weekly eller monthly; ett intervall ensamt aktiverar inte schemaläggning. Månatligen betyder 30 dagar och schemaläggaren kan köra efter den avsedda tiden.

Språk och widget​

Språkkoderna som stöds är en, de, fr, es, it, nl, pl, pt, sv, fi, et, cs, cy och id. localeMode är auto eller fixed; fixed kräver defaultLocale. allowLocaleOverride kan konfigureras separat. Förkortningen runtime.locale väljer fast läge och stänger av överskrivning.

Widgetens position kan vara bottom-right, bottom-left, top-right eller top-left. Alla tre temafärger använder #RRGGBB. Ikoner använder default, emoji med en icke-tom emoji-sträng eller url med en HTTP(S)-url, samt valfri storlek small, medium eller large. Valideringen hämtar inte ikon-URL:er, kontrollerar inte bildens MIME-typ och kräver inte exakt en emoji. Käll- och ikon-URL:er kontrolleras för syntax och protokoll, inte åtkomst eller tillstånd att genomsöka dem. Valfri beskrivning, assistentprompt eller reservtext, widgettitel och välkomsttext måste vara icke-tomma när de anges; utelämna dem för att rensa åsidosättningarna.

Typad konfigurationshjälp​

Installera konfigurationspaketet när du bygger separata TypeScript-verktyg kring schemat:

bun add -d @openstaticfish/chattybox-config
import { defineConfig } from '@openstaticfish/chattybox-config';

const config = defineConfig({
schemaVersion: '1',
assistant: { name: 'Support' },
knowledge: {
sources: [{ type: 'website', url: 'https://docs.example.com' }],
},
widget: { enabled: true },
});

CLI:t läser själv JSON-filer. defineConfig() är avsedd för typade program eller byggverktyg; den gör inte TypeScript-filer direkt läsbara för CLI:t. Både defineConfig(config) och validateConfig(config) validerar synkront, kastar ett vanligt Error vid första felet och returnerar samma objekt utan att klona, frysa, typomvandla eller lägga till standardvärden. Paketet exporterar TypeScript-typer och dessa funktioner, inte ett JSON Schema-dokument eller en $schema-URL.

För en fungerande produktionsintegration i dag kan du använda den hostade widgeten eller bygga ett anpassat gränssnitt med JavaScript SDK.

development är endast en pekare och preview/production delar samma runtime, korpus och publika nycklar; använd separata projekt för isolering. Rollback/promote återställer inte historiskt korpusinnehåll eller en append-only promotionshistorik och köar arbete enligt aktuella planregler.