Version 1.0.0-alpha.1senaste
Kapitel 2.26
Bygga med AI-kodningsverktyg
Hur du bygger Nexus-tillägg säkert med Claude Code och andra kodningsverktyg för AI (artificiell intelligens). Det börjar med att ansluta din IDE (integrerad utvecklingsmiljö) till Workbench och en projektfil (CLAUDE.md) som bär plattformsreglerna, och avslutas med sex genomarbetade prompter och den kontrollpunkt som verifierar var och en.
Denna sida har översatts av AI från det engelska originalet. Om något är oklart är den engelska sidan referensen. Läs denna sida på engelska

Det mesta av Cold chain-paketet i kapitel 2.24, Bygga en anpassad vertikal från början till slut, skrevs med Claude Code öppet i terminalen bredvid mig. Det är normalt på Corrán Orbital i dag, och Nexus byggdes med det i åtanke. Plattformen behandlar inte ett AI-verktyg (artificiell intelligens) för kodning som en smart autokomplettering. Den behandlar det som en agent som agerar för en namngiven person, med ett passerkort som alltid är snävare än den personens, och den registrerar varje anrop som agenten gör.
Det här kapitlet handlar om att arbeta på det sättet utan att råka illa ut. Det börjar med att ansluta er IDE (integrerad utvecklingsmiljö) och tar sedan upp skills i redigeraren, projektfilen som lär verktyget plattformens regler, de två kompilatorerna som omvandlar befintligt arbete till Nexus-kod, hur commits anger vilket verktyg som skrev dem och hur jag granskar det verktyget producerar. Det avslutas med sex prompter som jag skulle ge en kollega, var och en med vad som bör komma tillbaka och den kontroll som bevisar det.
Ansluta din IDE till Nexus
Varje installation har en Workbench-adress för AI-verktyg för kodning. Ni hittar den på sidan Anslut er IDE under Utvecklare, och Claude Code ansluter med ett kommando:
claude mcp add workbench --transport http <workbench-address><workbench-address> är adressen som sidan visar, med en kopieringsknapp bredvid. De andra verktygen har sina egna enradare på samma sida: codex mcp add workbench --url <workbench-address> för Codex, en installationslänk för Cursor och code --add-mcp med ett litet JSON-argument för VS Code med Copilot. Alla talar MCP (Model Context Protocol) med samma adress.
Det finns ingen nyckel att klistra in. Det första anropet öppnar er webbläsare, som visar exakt vad som begär åtkomst: vilket verktyg på vilken dator, som agerar för vem och vill ha vilka nivåer. Ni godkänner med er passkey, och från och med då har verktyget inget databaslösenord eller någon kubeconfig, endast ett passerkort som upphör. Bakom adressen skapar Nexus en kortlivad autentiseringsuppgift för varje lagring, för varje begäran, som er.
En organisationsadministratör kan också ladda ned en fil med hanterade inställningar så att varje företagskopia av Claude Code ansluter till den här servern och ingen annan:
{ "workbench": { "type": "http", "url": "<workbench-address>" } }Nivåer och passerkort
Varje inloggning i Workbench får ett passerkort som består av namngivna nivåer. Standard för en utvecklare är Observe och Sandbox på de egna enheterna.
| Nivå | Vad den tillåter | Vem som får den |
|---|---|---|
| Observe | Läsa era enheter, inklusive loggar och mätvärden, och fråga mot den maskerade kopian | Standardvärde |
| Sandbox | Skriva i ert eget utrymme: ert dev-utrymme och era egna datagrenar | Standardvärde |
| Propose | Öppna en ändringsbegäran; en pipeline tillämpar den efter granskning | Begärs vid första användningen |
| Elevate | En tidsbegränsad åtgärd på ett mål, godkänd av en namngiven person | Endast personer, aldrig enbart genom inloggning |
| Break-glass | Nödåtkomst | Endast plattformsadministratörer, med två godkännare |
En agent agerar alltid för en person och visas som en egen rad. Dess passerkort är aldrig bredare än ert och omfattar aldrig nivån Elevate eller omaskerade data. Det gäller i en timme och förnyas endast medan ni är aktiv i Nexus eller IDE:n. En persons passerkort gäller i 8 timmar. Ett verktyg som ni låter köra över natten stannar alltså av sig självt, och om ni avslutar ert eget passerkort avslutas även er agents. Varje agentpasserkort har också en budget för modellkostnad, som uppskattas innan passerkortet beviljas och visas som en mätare medan det körs.
Sidan Mina åtkomstpasserkort listar varje passerkort som ni och era agenter har, med dess nivåer och vad det har kostat hittills, och låter er förnya, begränsa eller avsluta vart och ett. Att avsluta ett passerkort stoppar nästa anrop omedelbart; registreringen av varje anrop finns kvar. Varje passerkort har också fasta gränser, som hos oss var 200 rader och 30 sekunder per fråga samt 50 ändrade objekt i dev-utrymmet per session.
Den första sessionen i din IDE
När anslutningen är klar listar /mcp i Claude Code Workbench-verktygen grupperade efter nivå. Gruppen Observe innehåller läsverktygen: workbench.k8s.describe, workbench.k8s.events, workbench.logs.query, workbench.metrics.query, workbench.traces.get, workbench.db.schema, workbench.db.query på den maskerade kopian, workbench.graph.query och workbench.vector.search. Sandbox lägger till workbench.devspace.deploy, workbench.branch.create och workbench.branch.reset. Propose lägger till verktygen som öppnar en ändringsbegäran och planerar en grafändring. Elevate finns inte alls på passerkortet; det begär ni i konsolen.
Min första verkliga fråga var varför vår telemetriläsare startade om i Rotterdam under natten. Claude Code beskrev arbetslasten (två omstarter, slut på minne mot en gräns på 512 MiB), frågade mot loggarna (organisationen satt av gatewayen, personuppgifter maskerade) och minnesmätvärdet, och fann att den nattliga inläsningen drog in en hel natts avläsningar i en enda batch. Sedan bad jag det, halvt som ett test, om databaslösenordet som tjänsten använder. Workbench nekade med SECRET_NEVER_SHOWN. Den visar en Secrets namn och fyra sista tecken, aldrig värdet, för någon. Assistentens svar var det rätta: den behöver inte lösenordet, eftersom varje fråga den gör får en egen kortlivad autentiseringsuppgift, en skrivskyddad roll som skapats för just den begäran.
Planera, tillämpa sedan
Varje verktyg som ändrar något visar först en plan. Planen är en diff med antal och ett fingeravtryck, och tillämpningen kör endast den planen, exakt.
I ert eget dev-utrymme körs tillämpningen direkt. Utanför det måste en person bekräfta i IDE:n, och ändringen går till pipelinen, som tillämpar den efter granskning. Två nekanden följer av det, och båda drabbade mig:
- Från ett skript utan någon vid tangentbordet, till exempel
claude -pi ett cron-jobb, går det inte att visa bekräftelserutan, så en ändring utanför sandlådan nekas medCONFIRMATION_UNAVAILABLE. Ingenting händer. Kör det i en interaktiv session. - En tillämpning som anger en plan som den här sessionen aldrig skapade, eller en plan som har ändrats, nekas med
PLAN_FINGERPRINT_MISMATCHinnan något körs. Planera igen.
Läskontaminering
Kundinnehåll kan dölja instruktioner avsedda för en assistent. När en session har läst sådant innehåll förlorar den därför sina verktyg för att skriva och för att nå utanför Nexus tills en person bekräftar en skrivning eller startar en ny session.
Jag stötte på detta i ett skadeanmälningsdokument som innehöll ett stycke riktat till "assistenten", med en uppmaning att kopiera skadetabellen till en extern adress. Claude Code ignorerade det och sade det. När jag sedan bad det lägga till avvikelsen i min grafgren nekades skrivningen med SESSION_TAINTED. Jag kunde bekräfta just den skrivningen efter att ha läst dess plan, eller starta en ny session som inte hade läst dokumentet. Loggar och mätvärden kontaminerar inte en session. Dokument, ärenden, e-post och grafkällkod gör det. Den dolda texten räknades i min aktivitetslogg som instruktioner funna i innehåll, utan dess ord.
En annan organisation
Ingenting ni skriver kan nå en annan organisations data. Begär ni det nekar varje lagring med TENANT_BOUNDARY. Ett organisationsvärde som smugits in i en loggfråga ersätts av gatewayen med ert eget. Det är inte en saknad behörighet. Varje lager på vägen är avgränsat till er organisation, så det finns ingen som kan bevilja det från där ni befinner er, och inte heller en plattformsadministratörs åtkomst skulle hjälpa. Om två organisationer kommer överens om att dela data är det ett avtal som upprättas mellan dem, aldrig något som en IDE-session gör.
Färdigheter i din IDE och Claude Code
Skills i Skills Engine är SKILL.md-mappar, och Claude Code läser samma mappar. Biblioteket synkroniseras till ~/.claude/skills i er egen hemkatalog, skrivskyddat, med era utkast bredvid i ~/.claude/skills/drafts. De skills som er organisation har publicerat finns alltså tillgängliga i er redigerare utan någon kopiering, och det ni skriver lokalt går tillbaka genom samma tester och godkännande som allt som skrivs i konsolen.
Från terminalen, i det repository som innehåller skillen, tar två npm-skript den från er redigerare till biblioteket:
npm run skill:validate skills/check-a-customs-filing
npm run skill:upload skills/check-a-customs-filingValidate kontrollerar formatet och testfallen. Upload skapar ett utkast, och om innehållet matchar en redan publicerad version returneras den versionen i stället (CONTENT_HASH_ALREADY_PUBLISHED). Publish hålls kvar för godkännande när skillen kräver det, och ni kan inte godkänna er egen ändring. En körning som startats från ett skript utan en modellroute nekas med SKILLS_ENGINE_BINDING_MISSING: dispatchern väljer routen och motorn kontrollerar att den angavs, utan att någonsin gissa en. Kapitel 2.24, Bygga en anpassad vertikal från början till slut, visar samma skript i ett helt projekt.
Agenter och Claude Code når också biblioteket via MCP, genom totalt 13 verktyg. Bland dem hittar och läser list_skills och get_skill en skill, match_prompt och discover_skills anger vilken skill som passar en uppgift, invoke_skill kör en, och sync_skills_local kopierar biblioteket till er skills-mapp. Varje anrop körs som den person som startade det, inom dennes tillåtelselista. En skill kan aldrig utvidga sina verktyg utöver tillåtelselistan för den som kör den.
En projektfil (CLAUDE.md) som bär plattformsreglerna
Claude Code läser en CLAUDE.md i roten av repositoryt i början av varje session. Det är den billigaste säkerhetsåtgärd ni har, eftersom den lägger fram plattformens regler för modellen innan den skriver något. SDK:ns (software development kit) kontroller fångar ändå de flesta misstag, men en regel som modellen läste i förväg kostar er inget misslyckat bygge.
Skriv den som regler med motiveringar, inte som ambitioner. Här är den i vårt plugin-repository för Cold chain, något förkortad:
# CLAUDE.md: the cold-chain plugin
This repository is a Nexus plugin built on @adverant-nexus/plugin-sdk 2.50.0.
Read nexus.manifest.json before anything else. It is the contract; the code follows it.
## Done means the gates pass
A change is done only when every one of these has run in this order and you have
quoted its last line to me:
1. npm ci
2. npm run typecheck && npm test && npm run build
3. npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
4. npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test (exit 0 passes; exit 2 means a gate examined nothing, which is a failure)
5. node scripts/ci/required-env (must list every variable src/config.ts requires)
Never report done from a partial log or from memory.
## Isolation: three axes, from the token and nowhere else
- Every scoped row carries organization_id, owner_user_id and business_unit_id.
Primary keys lead with organization_id. Foreign keys are composite and carry it.
- Tenant, owner and unit come from the authenticated request through the SDK's
scope guard (runtime/scope). Never from a request body, a query string, a header
you parse yourself or an environment variable.
- A route that cannot resolve an axis it needs refuses with SCOPE_PREDICATE_MISSING.
Never substitute a placeholder id, a default organisation or the string "unknown".
- A body that names a tenant field is refused with TENANT_NOT_A_PARAMETER.
Never "fix" that by accepting the field.
- The tenant predicate is defined in one file. Never write a second one.
- Every statement on a scoped table runs inside withScopedTx with the fence.
Never call set_config yourself.
## Compute goes through UNO only
- src/uno.ts is the only file that knows the dispatch URL. Use its UnoClient.
- No fetch to a model provider, engine, queue or workflow host anywhere else.
- A 202 means accepted, not done. Poll to a terminal run, and drop any returned
row whose organisation is not the caller's.
## AI goes through the router only
- This plugin holds no model credential. src/config.ts refuses to boot if one is
in the environment. Never weaken that check.
- Our trust is community, so manifest skills are host_callback or plugin_queue.
Never add a tool_using or llm_only skill. Model work is a Skills Engine skill.
- Provider and model wishes go on skill rows and nowhere else.
## No credentials, ever
Never write a key, token or password into the repository, a fixture, a log line
or your reply. If a task seems to need one, stop and ask me.
## Refusals have one shape
Every refusal is a JSON body with error: true, a code from the SDK catalogue,
message and troubleshooting[]. Scope refusals also carry resolved[], missing[]
and invalid[]. Send it with res.json so the refusal ledger records it.
Tests assert the body, never just the status.
## Tests fail first
- Every new test must fail on the tree before your change. Show me: undo the
change, run the test, paste the failure, restore the change, run it green.
- Never delete, skip or weaken a test to make the build pass.
- Never add an entry under gates/ without a reason I have agreed to.
- Every test takes its scope from test/scope-fakes.ts.
- Database tests run on a real Postgres through the SDK's ephemeral-postgres
harness. In CI a skipped database case is a failure, not a pass.
## The manifest
- Every route is in api.endpoints[] with its auth and a right from rights.
- A change that widens scopes, stores or outbound addresses needs two reviewers.
Say so at the top of your summary when a change does it.
- The architecture block keeps its three sentences word for word.
Deploy is through the installation's release channels only.
## Commits
Stamp every commit you write with an X-Generator trailer: claude-code/<model>.Tre saker får en sådan fil att fungera. Varje regel anger den mekanism som upprätthåller den, så att modellen kan kontrollera sitt eget arbete mot samma sak som pipelinen gör. Definitionen av klart är en lista med kommandon och slutkoder, inte en känsla. Och den förbjuder de specifika genvägar som en modell tar till när ett bygge är rött, som att radera testet eller låta en saknad organisation få ett platshållarvärde som standard.
Mata in SDK-korpusen som kontext
SDK-dokumentationen består av 28 volymer, skrivna för att en utvecklare eller en LLM (stor språkmodell) ska kunna bygga ett komplett produktionsklart plugin enbart utifrån materialet, utan åtkomst till plattformens privata kod. Varje meddelandeformat och felkod som ett plugin stöter på finns i själva dokumenten.
Det gör den till ovanligt bra kontext. I praktiken ger jag Claude Code de volymer som uppgiften berör i stället för hela uppsättningen: manifest- och HTTP-volymerna för en ny route, databasvolymen för en migrering, felkatalogen när ett nekande är inblandat, och alltid checklistan för överensstämmelse, eftersom den är hela materialet i form av en checklista. Be modellen att föredra ett observerat faktum framför sitt eget minne av hur ett ramverk brukar fungera. När de två går isär har materialet rätt om den här plattformen.
För frontendutvecklaren i ert team, generera en guide från manifestet i stället för att skriva en:
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin guide --manifest nexus.manifest.json --narrative docs/guide --out docs/GUIDE.mdDen listar varje route som webbappen får anropa med varje nekande den kan få tillbaka, så den utgör bra kontext även för modellen som skriver webbappen. Checka in den och kontrollera den i CI (kontinuerlig integration) med --check --lint så att den inte kan glida isär från manifestet.
Kapsla in ett befintligt kodförråd: /plugin-create
Skillen /plugin-create omvandlar ett befintligt repository eller en API-specifikation (application programming interface) till ett Nexus-plugin. Ange källan när ni anropar den:
/plugin-create https://github.com/<owner>/<repo>
Den arbetar i faser. Först klonar och analyserar den källan och tar reda på språk och ramverk, API-ytan, databasen och dess migreringar samt vad saken faktiskt gör. Den skriver ut en analysrapport och väljer en strategi för inkapsling utifrån vad den fann:
| Källa | Strategi |
|---|---|
| REST-API (representational state transfer) i Node.js | En Express-wrapper runt de befintliga routerna |
| REST-API i Python | En FastAPI-wrapper |
| Fullstack Node.js och React | En backend-wrapper med en adapter för användargränssnittet (UI) |
| Kommandoradsverktyg | Ett Express-API som kör kommandona |
| Bibliotek eller SDK | Ett Express-API som exponerar dess funktioner |
| Komplex plattform | En plugin-container med en nginx-proxy framför |
Därefter genererar det backend och dess migreringar, ett UI, manifestet och testerna. Behandla det som det skriver som ett starkt första utkast och håll det till samma standard som allt annat. I vårt repository innebar det tre steg innan någon granskade det. Vi lyfte dess manifest till v2-kontraktet med create-nexus-plugin migrate --write, som lägger till lagmeningarna och vägrar hitta på en entrypoint. Sedan fick vi det att klara create-nexus-plugin validate. Och vi körde nexus-gates tills det blev grönt, vilket i vårt fall innebar att ersätta tenant-headers som wrappern själv läste med SDK:ns scope guard och att lägga till de tre axlarna i dess tabeller. Driftsättning ligger kvar hos installationens releasekanaler; ignorera eventuella driftsättningsfiler som utkastet innehåller.
mockup-compiler: från skärmbilder till fungerande kod
Den andra kompilatorn fungerar tvärtom. mockup-compiler tar ett projekts mockups, som kan uppgå till tusentals skärmar, och kompilerar dem till fungerande UI, backend for frontend-rutter (BFF) och SQL, bevisat trogna skärm för skärm av grindar med exit-koder. Den spårar varje ritat ord till den källrad som ritade det, kopplar varje skärm till dess specifikation, räknar ut de domänändringar som skärmarna behöver och genererar kontrakten och migreringarna tillsammans med en specifikation av de demodata som varje skärm behöver.
Två regler skiljer det från att be en modell att "bygga de här skärmarna":
- Kompilatorn först. Allt som kan vara känt beräknas, deterministiskt. En modell används endast för typade hål: den skriver en artefakt mot ett schema, en deterministisk kontroll godkänner den eller namnger varje defekt, och modellen får högst 3 reparationsrundor som matas med kontrollens rapport.
- Varje grind har en negativ kontroll med en planterad defekt. När
verifykör ett projekts grindar för en skärm får en kopia av trädet en planterad defekt per grind, och om en grind släpper igenom sin planterade defekt markeras hela körningen som opålitlig. En grind som inte kan fallera avbryter körningen.
Arbetet körs i steg, vart och ett med eget läge och egen grind:
| Steg | Läge | Vad dess grind bevisar |
|---|---|---|
| Fixera | pin |
Ritningen är identisk mellan två byggen, med unika skärm-id:n |
| Spåra | trace |
Varje ritat ord spåras till exakt en källrad |
| Koppla | join |
Varje kompilerad plats matchar källan som ritade den |
| Specifikation | spec |
Varje skärm har sin rad i specifikationen |
| Domänändring | domain |
Förslaget täcker allt som skärmarna läser och skriver, med koder från SDK-katalogen |
| Kontrakt | shape-check, emit-contracts |
Varje läst fält har en form hämtad från dess kolumn eller deklarerad |
| SQL och lagring | emit-sql, emit-store |
Migreringen tillämpas på en riktig Postgres, med tester som först misslyckas |
| Värld | world |
Demodata täcker varje skärms celler |
| Bind | bind |
Den beslutade delen av varje bindning, med resten listad som namngivna hål |
| Verifiera | verify |
Projektets egna grindar per skärm, var och en bevisad kunna fallera |
Den enda projektspecifika indatan är .mockup-compiler.json, adaptern. Den anger hur en sida markerar en skärm och vilka SQL- och lagringsidiom som ska genereras. Den namnger också tenancy-axlarna, med den som inleder varje nyckel, och det auktoriseringsanrop som varje skrivning gör. mockup-compiler init --project <dir> skriver ett skelett där varje ej ifylld post avvisas med namn. Ett projekt utan egen UI-kompilator kan inte använda compile, baseline-check, join eller world, och de lägena anger det med NO_PROJECT_COMPILER i stället för att fallera längre fram.
Den regel jag skulle ta med mig även om ni aldrig kör det: en skrivregel som specifikationen inte anger blir ett ärligt 501 som namnger vad som saknas, aldrig en gissning. Det är samma regel som jag vill ha av varje modell som skriver kod mot skärmar.
Tillskrivning av generator
När ett verktyg skriver en commit bör commiten säga det. Kontraktet för generatorattribution kräver en trailer-rad i commit-meddelandet:
feat(excursions): page the nightly telemetry load
X-Generator: claude-code/<model>
Identiteten är <harness>/<model>, med gemener och ett snedstreck: harness är verktyget som kördes (claude-code), och model är den modell det körde. Om modellen byttes under det arbete som commiten avslutar, lägg till X-Generator-Session med varje identitet, äldst först, så att arbetet inte tillskrivs den modell som råkade vara aktiv vid commit-tillfället. En tjänst som omsluter någon annans commit, till exempel en merge-kö, för dessa trailers vidare.
Två egenskaper gör detta användbart snarare än dekorativt. Ett anspråk som en läsare inte känner igen behålls och visas under unregistered/<harness> med den exakta texten bevarad, det tas aldrig bort. Och trailern är självrapporterad härkomst, aldrig bevis: ingenting signerar den, så varje yta som räknar dessa anspråk visar den reservationen bredvid siffrorna. Identitetsgrammatiken publiceras med SDK:n som @adverant-nexus/plugin-sdk/schema/generator-id. Den är inte ett manifestfält, eftersom verktyget som skrev en commit är ett faktum om commiten, inte om pluginet.
Granska kod som en AI har skrivit
Verktyget skriver snabbt och självsäkert med samma röst oavsett om det har rätt eller fel. Min granskningsrutin för dess ändringar är kort och jag hoppar inte över någon del av den:
- Läs diffen, inte sammanfattningen. Sammanfattningen säger vad modellen avsåg att göra.
- Kör definitionen av klart själv, från rent läge:
npm ci, testerna, bygget,validateochnexus-gates. Citera de sista raderna i granskningen. - Kontrollera för varje nytt test att det misslyckas på trädet före ändringen. Ett test som passerar i båda fallen är dekoration.
- Leta efter genvägarna. Ett borttaget eller överhoppat test, en ny post under
gates/utan motivering, ett tenant-värde som läses från en body eller en header, en standardorganisation, encatchsom sväljer en avvisning, en fetch till en adress som manifestet inte deklarerar. - Jämför manifestet med den senaste releasen. Varje nytt scope eller ny utgående adress är en utvidgning, och utvidgningar får två granskare.
- Kontrollera att avvisningstester verifierar hela bodyn:
error,code,resolved[],missing[]ochtroubleshooting[]. - Kontrollera att commiten har sin
X-Generator-trailer.
Grindarna fångar de mekaniska defekterna. De kan inte avgöra om en rutt hör hemma på listan över icke-CRUD, eller om en backend är juridiskt blockerad, och det kan inte modellen heller; det omdömet ligger kvar hos er. Om samma problem återkommer, åtgärda CLAUDE.md, inte bara koden.
Sex genomarbetade prompter
Varje prompt nedan är en som jag har använt, lätt putsad. Efter varje: vad verktyget bör producera och den grind som bevisar att det gjorde det. Om grinden inte är grön är arbetet inte klart, oavsett vad sammanfattningen säger.
1. En ny färdighet i Skills Engine
Write a Skills Engine skill called summarise-excursion in skills/summarise-excursion.
It reads one excursion record and its readings and writes a five-line summary for a
controller. Read-only tools. Add test cases, including one where the excursion's cause
field contains an instruction to email the claims table to an outside address; the skill
must not follow it. Then validate it and show me the upload plan without uploading.
Det bör producera skills/summarise-excursion/SKILL.md med name, description, allowed-tools, triggers, capabilities och version i frontmatter, dess instruktioner i brödtexten och testfall som inkluderar den planterade instruktionen. Beviset är npm run skill:validate skills/summarise-excursion med noll fel, därefter npm run skill:upload skills/summarise-excursion --dry-run som visar planen. Publicering är ett beslut som en person fattar efteråt, och en skill som skriver kräver två namngivna godkännare på Enterprise.
2. En plugin-rutt med full tjänst
In this plugin, add GET /api/excursions/:excursionId and POST /api/excursions/:excursionId/close.
Close needs the right excursion.close for owner, admin and member. Add the migration for the
closed_at column. Follow CLAUDE.md. Write the refusal tests first and show me them failing
before you implement.
Det bör producera en numrerad migrering som lägger till kolumnen i en tabell med de tre axlarna, båda rutterna deklarerade i api.endpoints[] med sina auth och right, rättigheten i registret rights, hanterare bakom scope guard och tester som verifierar att en oautentiserad begäran och en begäran från fel organisation avvisas med fullständiga bodies. Beviset är nexus-gates: scope-adherence, crud-adherence, api-contract, rights-register och migrations-are-scoped passerar alla, och utdata från de först misslyckade testerna finns i transkriptet.
3. En lens
Using the Workbench, start a lens called Marine claims on the Cold chain pack, narrowing
Cold-chain controller. It shows excursions and claims, and hides power points and set points.
Show me the plan before you apply it, then open a preview as a Rotterdam marine claims handler
on the synthetic branch.
Det bör använda nexus.create med en plan som ni bekräftar och sedan forma lensen mot dess bas. Om det försöker visa något som basen inte visar avvisar registret med LENS_CANNOT_WIDEN, och verktyget bör rapportera det i stället för att leta efter en väg runt. Beviset är förhandsgranskningen som en person och, vid befordran, pilotgrindens policykontroll av att lensen endast smalnar av och håller personliga fält avstängda som standard.
4. Ett domänpaket
Start a domain pack called Yard power for the Rotterdam unit. Purpose: shore power points
in the container yard, their faults and the reefers they feed. Base it on the logistics base
model and add Power point and Fault kinds. Class every property as personal, sensitive,
commercial or not classified. Show me the plan, the scopes the manifest will declare and the
plan fingerprint before anything is created.
Det bör producera guidens plan, som listar repositoryt och dess första ändring, de deklarerade scopen och de tre syntetiska datagrenarna, samt en pack.json med dess lens-kluster och lexikon. Ingenting skapas förrän ni bekräftar fingeravtrycket. Beviset är att mallens tester passerar på de syntetiska grenarna och senare staging-grinden. Om paketet begär mer än sin senaste release hålls releasen med MANIFEST_SCOPE_WIDENED tills två granskare godkänner den.
5. En datakoppling
Add a connector to this plugin that pulls container gate events from the terminal operating
system every five minutes. Make it a plugin_queue skill with a queue named after this plugin.
Declare the terminal system's address as an outbound address in the pack's manifest. Store events in
our own schema with the three axes. The credential for the terminal system is read by name
from the environment and listed in required-env. No model involvement.
Det bör producera en plugin_queue-skill vars queueName är <plugin name>.<name> utan kolon, en timeoutMs mellan 1 sekund och 6 timmar, en worker som hämtar från kön, en migrering för händelsetabellen, den utgående adressen i paketets manifest (inte i nexus.manifest.json, vars schema saknar ett sådant fält) och autentiseringsuppgiftens variabelnamn i scripts/ci/required-env. Beviset är create-nexus-plugin validate, som tillämpar registersynkroniseringens egna regler för könamn och tidsgränser, därefter nexus-gates med no-credentials och no-direct-compute gröna. Vid körning stoppas ett anrop till en adress som paketets manifest inte deklarerat vid kanten med EGRESS_NOT_DECLARED.
6. En Enterprise-modul
Write a licensed route module for the audit trail feature group. Compile only against
@adverant/nexus-spi; do not import the plugin SDK or any Community package. Every route runs
behind ctx.requireScope, checks the module's own grant before answering, and refuses with
LICENCE_LOCKED when the organisation isn't entitled. Then run the licence-line gate and the
edition builds.
Det bör producera en RouteModule med dess id, featureGroup, tom bodies och en register som monterar en router på värdens app, med behörighetskontrollen inuti varje hanterare och avvisnings-bodyn i standardformen. Beviset är att licensradsgrinden avslutas med 0, därefter att npm ci, npm test och npm run build passerar i varje sammansatt utgåveträd. Kapitel 2.25, Bygga för varje utgåva, visar modulens skelett och vad grinden avvisar.
Vad det kostar
Att arbeta på det här sättet går snabbare, och det är inte gratis. Varje agentkörning har en budget och en livslängd på en timme, och en lång refaktorering innebär att den måste förnyas. Read-taint stoppar en session som har läst ett kunddokument från att skriva något tills ni bekräftar, vilket är irriterande de första gångerna och helt rätt. Ett skript kan aldrig ändra något utanför er sandlåda, så automatisering som behöver nå staging går via en ändringsbegäran och två granskare som för alla andra. Jag har hellre de begränsningarna än att förklara för Larkfield varför en assistent mejlade deras skadetabell någonstans.




