Changelog for AI assistants
Changes to the API that AI assistants build apps with. Newest first.
Unreleased
-
Every publish that passes is held for its owner's preview: it does not go live, and has no approval card, until its owner asks for its release (
release.stateheld, the textHeld for preview, not live: its owner asks for its release with aicoded release <id>., and the note E-REL-039 for olderaicoded, which this one leaves out).aicoded publishstarts the preview itself, prints its address and a line on its limits, and exits with 0 even when the preview does not start; over MCP,release_statusof a held publish says innextto callpreview_publishunless its preview runs or the person ended it, then to give the person the preview's address. Its output never tells the reader to release:It is not live. When the app's owner asks for its release: aicoded release <id>.aicoded release <id>, or the new toolreleasewithpublish, asks for the release: the platform decides again, and the publish goes live, waits for an approver or is refused; calling it again shows the publish as it is. Callreleaseonly when the person asks.aicoded publish --release, or thepublishtool withrelease: true, skips the preview and asks for the release at once: pass it only when the person asks to publish straight to production.--previewis gone. A held publish that Needs approval saysIt will need approval once you ask for its release.A new publish replaces one waiting for approval or going live, and says so:This publish replaced <id>, ...,release.replaced. E-REL-037 refuses the release of a publish that is not held, or one asked for by the platform's operator; E-REL-038 one that a newer publish superseded; and E-PUB-007 of a held publish's commit has the fix to preview it withaicoded preview <id>, and to release it only when the owner asks:aicoded release <id>. The preview reaches no outside service that production does not reach yet, keeps its mail in the console and keeps its first end. A declined card saysPublish again and ask for its release to get a new approval card.Thereleasetool is marked destructive.aicodedalways sendsrelease; an older platform refuses it, which is E-CLI-010. -
Never open, print or copy
dev.yaml,credentials.jsonor any other file ofaicoded's config folder: they hold passwords and keys.AGENTS.mdand the MCP server's instructions say so;describetells what you need from them, andaicoded whoamithe organisation and the sign-in. -
aicoded describeand thedescribetool give each app's local setup indev.yaml, aslocalin JSON andlocallines in text, asaicoded devrun in the described folder uses it: whetherdev.yamlholds a workspace for that folder (anotenames a folder above it that has one), whethermysql:is set for an app that declaressqldb, the personas with their roles and groups, and each setting and secret of the permission list with whether it has a local value. They never show a value, the MySQL DSN included; adev.yamlthataicoded devrefuses shows asproblem, with its code. -
Once a release is live,
aicoded publishandaicoded statusprintLive at <address>, andrelease_statusandaicoded status --jsongive the address asrelease.url, such ashttps://room-maintenance.acme.apps.aicoded.cloud/. Tell the person that address; never work one out from the app's name. A platform older than thisaicodedsends none. -
E-ORG-001 to E-ORG-006: the deletion of an organisation by the platform's operator, with
admin orgs delete. Apps and builders do not meet them: an organisation being deleted refuses every sign-in, publish and preview, and its apps stop. -
go install aicoded.dev/framework/cmd/aicoded@latestinstalls the releasedaicoded, from v0.11.0 on;aicoded initof a releasedaicodedwrites its framework version intogo.modwith noreplaceline, so the app publishes as it is created. -
On the platform, In your own cloud and Hosted by us alike,
ReadDirof a folder of a file store with more entries than the runner lists is E-FILE-003; the bound differs by where the app runs. Where the runner lists a folder to remove it,Removeof such a folder is E-FILE-003 too. Keep fewer files and folders directly in one folder: spread them over folders below it. -
A
mailer.Getcan be refused with E-MAIL-010 while other reads of the mailbox are under way: read the message again. -
In a preview, E-OUT-001 has the fix "release the app with this host first: a preview reaches only the hosts the app's live release reaches; the app type decides whether that needs approval"; outside a preview its fix stays "add the host to egress in aicoded.yaml".
-
E-REL-017 refuses
egressonly for an app built with a framework older than v0.10.0, with the fix "update aicoded.dev/framework to v0.10.0 or newer and publish again"; the platform releases outside services of v0.10.0 and newer. It still refusesschedule. A preview reaches only the hosts of the app's live release, each with the same key bound the same way (E-OUT-001). -
E-GATE-048 is a note of the step
decision, a reason a release Needs approval whatever the app type allows: a key thategressbinds to an outside service is new, or its secret, header or prefix differs from the live version's. The approval card saysthe key <secret> goes to <host> in <header>, thenafter "<prefix>"when the binding has a prefix. A host beyond the app type is still E-GATE-042, alone or with a key. -
aicoded devsends an app's requests to outside services to the real service, with the platform's checks of the permission list and its limits: a host that resolves to a private or local address, such as loopback, a private network, link-local or cloud metadata, is E-OUT-003, and the key thategressbinds to a host comes from the secret's value indev.yaml. The platform's runner also refuses its server's own and the platform's addresses;aicoded devdoes not refuse the computer's public addresses. During the delivery pipeline's simulated attacks, every request to an outside service is E-OUT-008: they never call outside services. The Traces page shows a spanoutboundfor each request, with the host, the method, the status and the bytes, never the path, the headers or the key. The guideguides/outboundand the recipetasks/call-an-outside-servicedescribe the block; keep the client ofoutbound.Client()in an unexported field ofDeps, which AGENTS.md now says too. -
Runner protocol 4 adds requests to outside services:
OutboundService.Doonrunner.socktakes a method, a URL, headers in order and a body, and answers with the status, headers and body. The runner sends onlyhttpsto port 443 of a host thategresslists (E-OUT-001, E-OUT-002), never to the platform's own hosts (E-OUT-003), with a body up to 10 MiB each way (E-OUT-004, E-OUT-005), 30 s for the whole request (E-OUT-006) and 16 requests under way at once per instance (E-OUT-007). It sends only GET, HEAD, POST, PUT, PATCH, DELETE and OPTIONS (E-OUT-002). It drops the hop-by-hop headers,HostandContent-Length, refuses a header name that is not a token or a value with a control character such as CR, LF or NUL (E-OUT-009), passes the response headers on sorted by name, follows no redirect, and puts a key thategressbinds to the host in its header in place of the app's. A service it cannot reach is E-OUT-008.secrets.Getof a bound key is E-RUN-015. A runner of this framework still serves protocol 3, apps of v0.7.0 to v0.9.0, unless their permission list declaresegress(E-RUN-014); any other version is E-RUN-002.runnerprotoaddsMinProtocolVersion(3),MaxOutboundBody(10 MiB),MaxOutboundRequests(16) andOutboundDeadline(30 s);runnerproto/serveraddsProviders.Outbound, theOutboundprovider, andOptions.Egress, which replaces the manifest'segressfor a preview.runnerproto/egressis the client behind a runner'sOutboundprovider: it resolves the host for each connection, refuses the request when any address of the answer is denied (egress.Denied, the base list, plusOptions.Deny), dials only an address it checked and follows no redirect;CloseIdleConnectionsmakes the next request to each host resolve and check it again. -
The building block
outboundcalls outside services:outbound.Client()returns an*http.Clientwhose requests go to the runner over runner protocol 4. Build each request withhttp.NewRequestWithContextand the context of the request or job it serves (E-RUN-004 without it); a request body over 10 MiB is refused before it is sent (E-OUT-004), the client follows no redirect, and a runner's refusal comes back as its coded error, E-OUT-006 for a request over 30 s among them. The client's ownTimeoutis 35 s, for a runner that does not answer. E-LINT-009 now lets app code usehttp.Clientas*http.Client,NewRequest,NewRequestWithContext,NoBodyandResponse. It refuses, with the fix "call outside services with outbound.Client(), which goes through the runner", a client the app makes (http.Client{},new(http.Client),[]*http.Client{{}}) and the client names ofnet/http(Get,Post,Head,PostForm,DefaultClient,DefaultTransport,Transport). It refuses, with the fix "use the client from outbound.Client() as it is: build requests with http.NewRequestWithContext and send them with its Do method", anhttp.Clientheld by value and anything done to the clientoutbound.Client()returns: its fields, itsGet,Head,PostandPostFormmethods,*c = ..., turning it into an interface value or passing it as a type argument. A declared module still may not usehttp.Clientand the other names (E-LINT-003). -
An
egressentry is a host alone, as before, or a mapping that binds a key to the host:{host: api.partner.example, secret: partner_api_key, header: Authorization, prefix: "Bearer "}. The runner adds the secret's value, after the prefix, in the header of every request to the host, so the app never reads it. The secret is declared insecrets; a bad binding is E-MAN-025, and an unknown key in an entry E-MAN-014. Each host is listed once, alone or with a key, and the platform's own hosts, such asaicoded.cloud,aicoded.devand their subdomains, are refused (E-MAN-018). In Go,manifest.Manifest.Egressis a[]manifest.EgressofHost,Secret,HeaderandPrefix;EgressHosts,Binding,BoundSecretandmanifest.PlatformHostread it. The canonical form and hash of a permission list whose entries are hosts alone are unchanged; a binding is an object in it, sorted by host.manifest.Difflists each host added or removed as before, then each key binding that changed, keyed by its host, assecret <name> in <header>withafter "<prefix>"when it has one.aicoded describelists the bindings, with the secret's name and never its value. -
aicoded preview <id>and the MCP toolpreview_publish {publish}run a publish that passed as its app's preview on the platform, at<app>.<organisation>.preview.aicoded.cloud, for 14 days from its first start; a newer publish replaces the version it runs.aicoded preview end [dir]and the toolpreview_end {app}end it and delete its data. Only the app's owner does either, with the new builder scopeapp:<id>:preview, and only when the person asks; the person picks up to five people to see the preview in the console, and the AI assistant invites no one. The localpreviewtool ofaicoded devis unchanged. See the guideguides/publishing. A sign-in made before has noapp:<id>:preview, andaicoded previewgets it by refreshing the sign-in once, asaicoded publishdoes for a new app. -
E-RUN-006 is also the page of a person of the organisation whom an app's preview does not admit: anyone but its owner, the people the owner picked, and the approvers of the app's waiting approval card. Its fix then asks the app's owner to add the person to the preview's viewers.
-
E-REL-029 refuses a preview of a publish that has not passed its checks or whose approval card was declined, and E-REL-030 one whose permission list declares a setting or a secret with no value set for the preview. E-REL-031 refuses the owner a sixth person to see the preview, in the console. E-MAIL-011 refuses a preview's message over 1 MiB: a preview sends no mail, and keeps each message for the app's owner to read in the console.
-
E-REL-009 also refuses the platform's operator the purge of a publish that the app's running preview runs.
-
E-REL-028 refuses the platform's operator
admin secrets putanddeletefor an app of another organisation: the app's owner or a security admin sets its values in the console. -
After
Declined by <email>: <reason>.andPublish again to ask for a new approval.,aicoded publishandaicoded statusprintIf it changed the schema, put the changes you still want back in .aicoded/migration.sql: they left the app's migrations.: a declined publish's schema changes leave the app's migrations, and the draft was cleared when it passed. A publish made on top of them before the decline fails at its stepmigrationswith E-MIG-004. -
E-GATE-047 also counts a function that gains
apps=trueor its firstrole=as open to more callers. -
E-REL-022 refuses a rollback, too, to a release whose permission list declares a value deleted since. A setting deleted while a release runs reaches the app as an empty string at its next start.
-
Settings and secrets get their production values in the console, from the app's owner or a security admin. E-REL-005 now refuses only secrets on a target that does not keep them: settings are released. E-REL-022 refuses a release whose permission list declares a setting or a secret with no value set, and lists the names. E-RUN-011's fix now asks the app's owner or a security admin. See the guide
guides/settings-and-secrets. -
E-REL-023 refuses the platform's operator a release or a rollback that Needs approval: such a release goes live only through an approval card in the console. E-REL-024 to E-REL-027 refuse an approval of a card: by the publish's builder (024), after a sign-in more than five minutes old (025), of a card that changed since it was opened (026), and by a person outside the app type's approver group (027).
-
E-GATE-047 is a note of the step
decision, a reason a release Needs approval: a function ofrpc/that the live version has is open to more callers, through a new app incaller=or arole=that admits more viewers. -
E-RUN-013 is the page, with status 503, of an app whose new version did not start after a destructive schema change: the runner never starts the earlier version on the changed schema, and the app stays stopped until a fixed version goes live.
-
When an approver declines a publish's approval card,
aicoded publishandaicoded statusprintDeclined by <email>: <reason>.andPublish again to ask for a new approval.after the decision, and exit 1.aicoded status --jsonandrelease_statuscarry it asdeclined, withby,reasonandat; a platform that sends nodeclinedleaves it out, and the publish is not declined. -
migrate.Normalizeupper-cases only SQL keywords, types and functions, from a fixed list; every other word keeps its case, soINSERT INTO VisitorsandINSERT INTO visitorsno longer compare alike, whilecreate tableandCREATE TABLEstill do. -
A publish that passes is decided on at once, against its app type (
class; left out, it isinternal-tool).aicoded publishandaicoded statusprint the decision before the status line:Pre-approved by app type <type>: going live.(thenlive),Needs approval:with a line for each reason andAn approver must approve it before it goes live.(thenReleased: live.),Released: replaced by a newer release.,Not allowed: <reason>.,Release failed: <reason>.orNot released: <reason>..aicoded status --jsonandrelease_statuscarry it asrelease, withtier(R1,R2orR3),app_type(<name>@<version>),reasons,state(due,waiting,released,failed,replaced,refusedorsuperseded),reasonandlive; a platform that decides nothing leaves it out. The new guideguides/app-typesexplains app types, the decision, the group map and the source registry. -
E-GATE-039 to E-GATE-046 are notes of the new step
decisionthat say why a release Needs approval: an audience group (039), a data class (040), a mail domain (041) or an outside service (042) beyond the app type, people outside the company (043), a destructive schema change (044), data that reaches mail in a new way (045), and a page open to more people than in the live version (046). Each page's fix says what an approver sees and how to stay Pre-approved. E-GATE-044 names the step as<publish>#<index>and never quotes its statement. -
E-REL-019 (an app type the organisation does not have), E-REL-020 (a group or a role its group map does not have) and E-REL-021 (a source its source registry classes
health,hrorcard) fail a publish when it is decided, and refuse a release the same way. Only the audience entryeveryoneneeds no mapping; a roleeveryoneorgroup:everyonemust be mapped. -
E-REL-001 also refuses a rollback to a release that never went live, or that is live already.
-
The delivery pipeline's step
migrations(L9) lists each destructive statement of the draft as an E-MIG-003 note at its line, and passes; the publish then Needs approval (E-GATE-044). -
E-REL-004 now refuses only
audience.external: groups inaudience.internalare released. E-RUN-006 is now the page of a signed-in person whom the app's audience does not name. On the platform,auth.Viewergives the group-map names the person is in, of those the app uses, as bothRolesandGroups, checked again every 15 minutes. -
A draft may hold destructive schema changes in a fixed set of forms:
DROP TABLE [IF EXISTS],DROP INDEX … ON,RENAME TABLE,TRUNCATE [TABLE], andALTER TABLEwithDROP [COLUMN],DROP INDEX/KEY/FOREIGN KEY/PRIMARY KEY/CHECK/CONSTRAINT,MODIFY,CHANGE,RENAME TO/AS/COLUMN/INDEX/KEY, orALTER [COLUMN] … SET DEFAULT,DROP DEFAULT,SET VISIBLEorSET INVISIBLEclauses. E-MIG-003 is now a note at the statement's line, whichaicoded checkshows without failing the app, andaicoded devapplies the statement to the dev database. Its fix: the release needs an approval, and the app stops briefly while the change is applied. Every otherDROP,RENAME,TRUNCATEorALTER, such asDROP DATABASE,DROP VIEWorALTER TABLE … ENGINE, and any statement onaicoded_migrations, is E-MIG-002. E-MIG-007 refuses a rollback to a release before a destructive change that ran in production: release a newer publish.migrate.Classifyreturnsmigrate.Destructivefor the destructive forms,migrate.Destructivesandmigrate.Notesfind them, andmigrate.Applytakes a fourth argument,destructive, without which it refuses a destructive step with E-MIG-003. -
The permission list needs an
audiencethat lists someone: one left out, or with neitherinternalnorexternalentries, is Not allowed (E-MAN-024).aicoded initwritesinternal: [everyone]underaudience, and the examples state it. Give an app without oneaudience:withinternal: [everyone], or the groups that use it. -
Data classes are fixed:
public,internal,confidentialandpersonal, from the least sensitive to the most. Any other class is E-MAN-008, whose message lists the four, andhealth,hrandcardare Not allowed (E-MAN-024).manifest.Classes,manifest.ReservedClassesandmanifest.ClassRankgive them to runners and the platform. -
manifest.Canonicalandmanifest.Hashgive a permission list's canonical form, its JSON with every list sorted and each item once and what is empty left out, and its hash,sha256:<64 hex digits>: the order of keys and of list items, and comments, do not change it. The manifest types carry JSON names equal to their YAML keys. -
manifest.ValidHostis the host check ofegress(E-MAN-018), andAudience.Admitsreports whether an audience's internal entries admit a member of the given groups. -
migrate.Normalizereturns the form of a statement in which two statements that MySQL reads alike are the same. The platform compares a draft with the app's published steps in that form, so a published statement sent again with other spacing or keyword case is refused with E-MIG-001, as its page says. -
A step whose statement ran but whose row could not be added to the journal
aicoded_migrationsis tried twice more on new connections, under the database's migration lock. When it still cannot be added, E-MIG-005 says the stepran but was not recorded: on the platform nothing is rejected, the publish shows it as a note, and the platform's operator records the step before the next release. The pages of E-MIG-005,guides/publishingandguides/schema-changessay so. -
A step of the migrations that MySQL refuses on production data stops the release, and the version that runs keeps serving; the schema changes after the steps that ran are rejected, so no publish that holds them is ever released.
aicoded statusandrelease_statusshow E-MIG-005 as a problem of each such publish, which stayspassed, and a release of one is refused with E-MIG-004. Put a corrected version of the unreleased changes in.aicoded/migration.sql, leaving out the steps that ran, and publish again;aicoded devmakes the dev database again. A step that could not finish, through a lock wait, a deadlock, a time limit or a broken connection, rejects nothing: the publish shows E-MIG-005 as a note, and the next release tries it again. On the platform the message names the step and MySQL's error number with a fixed short text, such asMySQL error 1062 (duplicate key), never MySQL's own message. The pages of E-MIG-004 and E-MIG-005 say so, andguides/publishingandguides/schema-changestoo. -
The delivery pipeline runs two more steps after
capabilities:migrations(L9, Safe data changes), which checks the draft that the publish carried and refuses a commit that holds it (E-MIG-001 to E-MIG-003, E-MIG-006), anddata(L8, part of Stays in its limits), which carries the notes E-DATA-001 and E-DATA-002 and never fails a publish. -
aicoded publishandaicoded statusprintchecks: all-but-l7, which the platform gives oncelint,migrationsanddataran, aschecks: the security checks of layers L1 to L5, L8 and L9 ran; simulated attacks (L7) come later, andallaschecks: the security checks of layers L1 to L5, L8 and L9, and the simulated attacks (L7), ran. -
E-GATE-007: the platform builds apps with v0.6.0 and later only; for an app older than v0.6.0 the fix is to require v0.6.0 or a later listed version and move DDL from the app's code to
.aicoded/migration.sql. -
E-GATE-018: the delivery pipeline scans the draft of schema changes for secrets too, and a secret there is at
.aicoded/migration.sql:<line>. -
aicoded devandaicoded checkno longer ask the platform for the published migrations without a sign-in, or when the sign-in cannot be read, and no longer report the configuration folder's lock or mode then: they print one line,E-CLI-004: not signed in to the platform at <address>; only the draft is applied, or apply the migrations cached in.aicoded/migrations.jsonand say so. A sign-in that others can read is still E-CLI-007. -
Schema changes moved out of app code into the draft
.aicoded/migration.sql, which stays out of git and travels withaicoded publish; the platform applies it, as the database's owner, when a release rolls out, and the app's own database user reads and writes rows only. Move everyCREATE TABLEand other schema change fromOnStartto the draft, and keep only the code that fills tables. The examples,guides/sql-database,tasks/new-app,tasks/list-from-databaseand the package doc ofsqldbnow do so, the examples' tests usesqltest.Open(t), and the new guideguides/schema-changestells what a draft may hold and what happens at publish and at release. A new app'sAGENTS.mdsays: schema changes go in.aicoded/migration.sql; never commit it;aicoded publishsends it. -
The floor: apps below v0.6.0 are not released (E-REL-003). Require v0.6.0 or later and move DDL to
.aicoded/migration.sql. -
New codes: E-MIG-001 to E-MIG-006 (the draft and the migrations), E-LINT-013 (a schema change in app code), E-DATA-001 and E-DATA-002 (notes on data). Changed: E-LINT-007 (DDL is no longer allowed) and E-REL-003 (the floor is v0.6.0).
-
aicoded devgives an app that declaressqldba data-only database user:mysql.socklogs in asac-dev-<app>, which may onlySELECT,INSERT,UPDATEandDELETE, so a schema change from app code gets MySQL's access-denied error. Before every start, it applies, as the ownerao-dev-<app>, the migrations the app published, fetched from the platform with the sign-in and cached in.aicoded/migrations.json, then the draft,.aicoded/migration.sql. A changed draft, or a database whose journal does not match, makes the dev database again. A refused draft or a failed step stops the app (E-MIG-001 to E-MIG-006). A cache it cannot read is a warning line, and only the draft is applied. -
aicoded checkmakes a test database for each app that declaressqldb, whendev.yamlnamesmysql:, and runs its tests withAICODED_TEST_DBset. New packageaicoded.dev/framework/sqldb/sqltest:sqltest.Open(t)opens it as the data user, and skips the test without it. -
aicoded publishand thepublishtool send the draft with the commit, and refuse a commit or index that holds it (E-MIG-001). Once the publish passed, the draft is deleted and the cache refreshed, byaicoded publish,aicoded status,release_statusor the next publish; a failed publish leaves it. While the publish that carried the draft has not ended, a new publish is refused (E-MIG-001). Thepublishandrelease_statustools adddraft(sent,settledornone) anddraft_noteto their answers. New apps'.gitignorelists.aicoded/migration.sqland.aicoded/migrations.json. -
aicoded l7-runner --migrations <file>applies the steps in the file,{"steps": [...]}, to the app's database before it serves. -
E-LINT-013: app code may not change the schema. SQL passed to
database/sqlthat starts withCREATE,ALTER,DROP,RENAMEorTRUNCATEis refused; write the change in.aicoded/migration.sql. SQL that namesaicoded_migrations, the platform's journal of migrations, is refused with E-LINT-013 too. E-LINT-007 now allows onlySELECT,INSERT,UPDATE,DELETE,REPLACEandWITH. -
aicoded checkchecks the app's draft,.aicoded/migration.sql, when it has one, with the rules ofmigrate(E-MIG-001 to E-MIG-003, at the draft's lines), and refuses a draft of an app that declares nosqldb(E-MIG-006). -
Notes, which never fail
aicoded checkor a publish:aicoded checkprints each app's notes, andaicoded check --jsonlists them inapps[].notes, with the fields ofproblems. New codes: E-DATA-001 (data from the app's database, its files, its inbox or a secret that a call ofmailer.Sendmay send) and E-DATA-002 (a data class that the permission list adds, noted by the delivery pipeline). -
New package
migrate, for the aicoded CLI and the platform: it checks a schema-change draft,.aicoded/migration.sql, and applies migrations to a database. A draft may only add:CREATE TABLE,CREATE INDEXandALTER TABLE … ADD, with a newNOT NULLcolumn given aDEFAULT. New codes: E-MIG-001 (a draft over 64 KiB or 100 statements, not UTF-8, empty, or committed), E-MIG-002 (a statement not allowed, such asINSERT,/*! … */ordb.table), E-MIG-003 (a destructive statement), E-MIG-004 (migrations that differ from what the database ran), E-MIG-005 (a step that failed) and E-MIG-006 (a draft withoutsqldb). App code may not importmigrate(E-LINT-001). -
E-RUN-012: on the platform, the runner bounds an app's reads of its secrets to 100 at once, then 20 a second, and 8 under way at once, all its instances together; past either,
secrets.Getfails with E-RUN-012 and nothing is read. Read each secret once, when the app starts or first needs it, and keep the value in memory rather than reading it at every request. -
E-REL-005 now refuses
settings, which the platform does not keep yet, andsecretsonly where the target of the organisation's server does not keep them. Where it keeps them, an app that declaressecretsis released, andsecrets.Getreads their values as inaicoded dev. A declared secret with no value there fails with E-RUN-011. -
aicoded logsandaicoded tracesread an app's log lines and spans on the platform, with--env previewor--env production, which must be given, and--since,--until,--level,--traceand--limit; and thelogs,tracesandtracetools ofaicoded mcptakeenv,sinceanduntilto do the same, in the shape of their answers fromaicoded dev. A sign-in reads only apps it owns, at most 7 days and 1000 rows at once. New codes: E-PUB-015 (over 7 days), E-PUB-016 (over 1000 rows), E-PUB-017 (a value that is not valid), E-PUB-018 (logs and traces cannot be read right now), E-PUB-019 (no app of that name on the platform), E-PUB-020 (more than one answer holds) and E-PUB-021 (rows the platform cannot read); an archived app is E-PUB-006. With--trace,--limitis how many of the trace's spans to read, 1000 by default. Read production only when the developer asks: its logs hold what the app's users entered. Seetasks/find-why-a-published-app-fails. -
For runners:
(*runnerproto/server.Server).SetDatabaseand(*mysqlproxy.Proxy).SetUpstreamchange wheremysql.socklogs in from the next connection the app opens; open sessions keep their login. Nothing changes for apps. -
E-REL-017: the platform does not run outside services or schedules yet, so it refuses to release an app whose permission list declares
egresshosts orschedulejobs, and its runner refuses to start one. Keep both out of aicoded.yaml, and the code that uses them, until it runs them. -
A coded refusal of the runner, whatever its status, such as E-MAIL-008 or E-MAIL-010, reaches the app from
mailerandfilestoreas that coded error, with its fix and docs lines; a file store's keeps theio/fserror of its status, such asfs.ErrInvalid. -
E-MAIL-010: on the platform, a message with a new
IdempotencyKeywhile 10 000 of the app's messages are still being sent, as many as the runner remembers. Nothing is sent; send it again once the sends under way end. -
E-REL-016: the platform's operator cannot rename or archive an app that has a release live or pending. Such an app keeps its name and stays active until releases can be stopped, so publish under another name as a new app.
-
The headers a message may set,
In-Reply-To,References,List-Id,List-Unsubscribe,List-Unsubscribe-Post,Auto-SubmittedandPrecedence, take printable ASCII only, from space to~: any other character, a tab or a letter such aséamong them, is E-MAIL-004, inaicoded devand on the platform alike. -
On the platform, the runner remembers the app's last 10 000
IdempotencyKeys within 24 hours, until it restarts: a retry of a key it remembers sends nothing again, and one of a key it forgot sends the message again, as a retry afteraicoded devrestarts does. The mail guide,mailer.Messageand E-MAIL-001 say so. -
E-RUN-006: on the platform, the runner shows an app only to
audience.internal: [everyone]with noexternal; for any other audience every page of the app is this error, although a release refuses such a permission list already (E-REL-004). The runner serves the login under/_aicoded/and answers every path there itself, but the app's assets under/_aicoded/assets/. -
E-RUN-005: a call to a building block the runner does not provide; none on the platform today. Nothing is read, written or sent.
-
A new lint rule, E-LINT-012: app code sets only
__Host-cookies withPath: "/",Secure: trueand noDomain, and reads only__Host-cookies. Make each cookie with anhttp.Cookieliteral whoseNameis a constant starting with__Host-, and set it withw.Header().Add("Set-Cookie", c.String()); delete one with the same fields andMaxAge: -1. Lint also refuses changing a cookie'sName,Path,SecureorDomainto anything else, an empty cookie fromneworvar, aSet-Cookieheader whose value is notc.String()or a constant__Host-cookie,r.Cookieorr.CookiesNamedwith a constant name that does not start with__Host-, andAddandSetof a header, orr.Cookie, passed around as values. -
auth.Viewer(ctx).Subjectis at most 512 bytes: the app refuses a viewer token whose subject is empty or longer. Store it, and any column compared with it, asVARCHAR(512) COLLATE utf8mb4_0900_bin, as the examples, thesqldbexamples and theJSON_TABLEofguides/sql-databasenow do. A persona indev.yamlwhose name, itsSubject, is empty or longer is E-DEV-021. -
On the platform,
auth.Viewer(ctx).Subjectis<iss>|<sub>, the issuer of the company login and the person's id there, the same on every visit;Nameis the name the login shows, andGroupsandRolesare empty for now. The runner serves the login under/_aicoded/, which no page folder may be named at any depth (E-GEN-016). -
aicoded devand the runner of the simulated attacks serve apps throughrunnerproto/server, so an app meets the runner's checks on your computer too: the bounds of file names and spans below, and a call to another app thatservices.callsdoes not name is refused (E-RPC-008) before the runner looks for the app. An error of a file store that is not about the file, such as a store that cannot be reached, reaches the app asinternal error. -
New codes for releases to production, which the platform refuses before anything runs: E-REL-001 to E-REL-008. E-MAIL-008 is a mailbox call where the platform keeps no mailbox yet; sending works there.
-
The runner side of the runner protocol is public, for runners:
runnerproto/serverservesrunner.sockto one app, andmysql.sockthroughrunnerproto/mysqlproxy, with the building blocks behind provider interfaces. It checks what the app sends before any provider sees it, accepts the environmentsdev,previewandproduction, and hands the app the form key its runner chose, so two instances of an app with one key take each other's form tokens. A file name in a store is at most 1024 bytes, each part at most 255 bytes, with no control characters (E-FILE-001). Of the spans an app exports, the runner keeps at most 1024 per export, drops those with ids of the wrong size, cuts names, errors and attribute values at 4 KiB, and keeps at most 64 attributes, whose keys are at most 256 bytes. Apps cannot import either package (E-LINT-001). -
The delivery pipeline attacks the app it built, as the security checks of layer L7, in two new steps after
tests, which run only when the tests passed.attacksstarts the app, sends requests without a valid session to every page, form, live connection and served function (E-GATE-029), sends a viewer with no role to every page whose access rules name a role (E-GATE-030), tests each guarded page with another viewer, who holds only the roles that the access rules ask for up to the page that declares theGuard(E-GATE-031 and E-GATE-032, and E-GATE-033 for a guarded page of which it reached no record), and posts markup in every text field (E-GATE-034); an app that does not start, or stops, is E-GATE-036.personal-datasearches the app's output and spans for every value entered in its forms (E-GATE-035), and fails an app that writes more than it reads (E-GATE-037). A page the attacks did not reach is the note E-GATE-038.checksgains the valueall, whichaicoded publishandaicoded statusprint aschecks: the security checks of layers L1 to L5 and the simulated attacks (L7) ran, for a publish whoseattacksstep ran. The new guideguides/simulated-attackssays what each attack does, who the test viewers are, and how to let the attacks reach every page: link every page from a page its viewers reach, and let a form on a page without an id create the records. -
The runner protocol's
HelloResponsegainsapp_socket_open, for a runner that reachesapp.sockas another user, such as the one the delivery pipeline runs the simulated attacks with. When it is set, the app makesapp.sockmode 0666 right after it listens; otherwiseapp.sockstays 0600.runnerproto/socketaddsShare, which makes a socket usable by every user, andListenShared, which listens and shares. The protocol stays 3: an app built with an older framework ignores the field, so the delivery pipeline needs framework v0.4.0 or newer to attack it. -
aicoded describe --jsonand the MCP tooldescribegive each approutes: every page and layout, sorted by path, with itstemplate,layout, URLparamsand their kinds,require,guard,guard_at(the path of the route whose template declares the nearestGuard),shared,live,calls, and theformsof its own template with each field'sname,kind,go_type,requiredandmultiple. The delivery pipeline builds its simulated attacks from them. The text summary does not change. -
A page with an id in its URL says whose records it shows. Every template at or below a parameter folder, page or layout, needs
guard="true"on its own<ssr:access>or on that of a template between it and its deepest parameter folder, when itsGuarddecides who sees each record, or the newshared="true", when everyone the rules admit may see every record.aicoded generaterefuses a template with neither (E-GEN-054), andshared="true"next toguard="true", on a template whose URL has no parameter, or below a template withguard="true"(E-GEN-055).guard="true"belowshared="true"narrows it, androle="*" shared="true"keeps the rules above, asrole="*" guard="true"does. An app with such a page failsaicoded checkuntil each one declares: addshared="true"to the layout or page at the parameter folder, such as<ssr:access role="staff" shared="true"/>, orguard="true"and aGuard. The permission list'saccessentries gainshared: true(manifest.Access.Shared), and an entry with bothguardandsharedis E-MAN-023. The difference between two permission lists writes an entry asrequire <rules>, then; guardor; shared, then; calls <names>.aicoded describeshowssharednext to the page, andpages[].sharedin--json. -
aicoded devreports an app asfailed, with its problems, or asstoppedas soon as its address shows that, and prints the failure then. It used to wait until the app's old process had ended, which takes seconds while that process still serves a request; until thenwhat_brokeand the dev UI saidstartingorrunning. -
Apps are on Go 1.26: the framework's
go.modsaysgo 1.26.0, and so does thego.modof an app thataicoded initcreates. An app'sgoline selects Go's security defaults, and the delivery pipeline refuses agoline older than the release of the Go it builds with, such asgo 1.25.0when it builds with Go 1.26 (E-GATE-026). When an app moves to framework v0.3.0,go get aicoded.dev/framework@v0.3.0raises itsgoline; otherwise rungo mod edit -go=1.26.0, thengo mod tidy.aicodedfrom v0.3.0 on, and every app, need Go 1.26: with the defaultGOTOOLCHAIN=autoan older go command downloads it, and withGOTOOLCHAIN=localit refuses. The fix of E-CHK-005 now asks for Go 1.26 or newer. -
aicoded generateends the code that it writes from a page's template with a comment//line route_gen.go:<n>, so the go command,aicoded checkand the delivery pipeline's checks report a problem in the code after it at its own line ofroute_gen.go, not at a line of the page that it does not come from, which could be past the page's end. Every page needs its code generated again: runaicoded generate, oraicoded check, which does; until thenaicoded check --frozenandaicoded publishreport the old file (E-CHK-001). -
aicoded checkruns the tests with-count=1, as the delivery pipeline does, so a result in the go command's test cache never stands for a run: every test runs each time. -
aicoded generatewrites eachssr:else-ifas anifinside theelseblock of the branch before it, not aselse if, which staticcheck would offer to turn into aswitch(QF1003) in code nobody can change. The page shows the same branch as before. A page withssr:else-ifneeds its code generated again: runaicoded generate, oraicoded check, which does. -
A go command that a signal stops while
aicoded checkoraicoded devruns it, such as thego testthat a test kills, is the new E-CHK-008, which names the command and the signal, rather than E-CHK-002: its output is cut short, so it reports nothing else. In the delivery pipeline the tests step reports it as E-GATE-028. -
aicoded checkreports whatgo vetfinds (E-CHK-003) with Go 1.26 too, which prints it on stdout; with Go 1.26 it used to pass over those findings. Whengo vetprints anything else it cannot read, the check fails with E-CHK-002, which quotes whatgo vetprinted. It runsgo vetwith-v=false -x=false, so a GOFLAGS of-vor-xadds nothing to that output. -
A publish has notes: findings in the shape of problems that do not stop it.
aicoded publishandaicoded statusprint each after the problems, on a line that starts withnote:;aicoded status --jsonand therelease_statustool ofaicoded mcpreturn them asnotes, afterproblems. The last line of a failed publish still counts the problems only. A platform that sends no notes shows none. The delivery pipeline's steps arecheckout,modules,check,lint(golangci-lint with staticcheck's checks of bugs and style but not its simplifications or quick fixes, gosec, errcheck, bodyclose and sqlclosecheck),secrets(gitleaks over the commit and its history),vulnerabilities(OSV-Scanner and govulncheck),licences(go-licenses),sbom(Syft),capabilities(capslock),buildandtests.checksgains the valueall-but-l7, printed aschecks: the security checks of layers L1 to L5 ran; simulated attacks (L7) come later, for a publish whoselintstep ran.partialis now printed aspartial checks: not every security check ran; the steps above say which: a publish whoselintstep did not run has it, and so has every publish to an older platform that runs onlyaicoded checkand the tests. The steps fromchecktocapabilitiesrun whatever one of them finds, except that whencheckfinds Go that does not compile (E-CHK-002) orgo mod tidyfails (E-CHK-006),lint,vulnerabilities,licencesandcapabilitiesareskipped, whilesecretsandsbomstill run.//nolint,#nosecand//gosec:disableare honoured for now, but each is a note that security sees: fix what the check reports instead. E-GATE-011 now means only anaicoded.yamlthat names another app; one that is missing, cannot be read or names no app is E-GATE-027. The guideguides/publishinglists the steps and their layers. New codes: E-GATE-000 (a finding with no code of its own), E-GATE-013 to E-GATE-017 (staticcheck, gosec, errcheck, bodyclose and sqlclosecheck), E-GATE-018 and E-GATE-019 (a secret in the code or in its history), E-GATE-020 (a critical known weakness the app calls), E-GATE-026 (agodebugline ingo.mod, a//go:debugcomment in a Go file, or agoline older than the Go of the delivery pipeline, which change Go's security defaults), E-GATE-027 (anaicoded.yamlthat is missing, cannot be read or names no app), E-GATE-028 (tests that stopped the checks), and the notes E-GATE-021 to E-GATE-025 (a known weakness that the app calls but that is not critical or is in the Go standard library, one that the app does not call, a licence that is forbidden or not recognised, a capability reached without a building block, and a directive that silences a check). -
aicoded describeand thedescribetool ofaicoded mcpshow the new fields of the permission list, each only when the app has it. The text gains the linesclass,owner,audienceandexternal audienceafter theappline,connectorsafterfiles,egressand oneschedule <job> cron <expression>for each job after the mail, andsize,resourcesandttlaftermodules. The JSON gainsclass,owner,audience(withinternalandexternal),connectors,egress,schedule(withjobandcron),size,resourcesandttl. The surface counts each scheduled job as an entry point, and each connector and eachegresshost as an effect. -
The permission list,
aicoded.yaml, takes every field: besidesapp,data,access,services,email,settings,secretsandmodules, the optionalclass(the app type),owner(group:<name>),audience(internal:group:<name>oreveryone;external:idp:<name>ormagic-link),egress(host names, such asapi.partner.example),schedule({cron: "0 6 * * *", job: daily-summary}, five numeric cron fields in UTC),size(S,MorL),resources(small,mediumorlarge) andttl(1dto3650d). A field left out or empty is not stated. Writeownerandaudiencewhen the person says who owns and uses the app; leaveclass,size,resourcesandttlout unless the person or their administrator gives them. The platform records these fields and shows their changes in the change record; nothing holds the app to them yet. An unknown key, at the top level or in a section with fixed keys, is now an error (E-MAN-014), and so are anchors, aliases and merge keys,&name,*nameand<<(E-MAN-003). Every command that reads the permission list reports all its problems at once, in line order, instead of the first: fix them all, then runaicoded checkagain. The guideguides/permission-listcovers every field. The permission list's schema is now the public packageaicoded.dev/framework/manifest, withLoadandParse, for runners and the platform; app code may not import it (E-LINT-001). The package also hasDiff, which lists what changed between two permission lists field by field, as the platform's change records show it. New codes: E-MAN-014 (an unknown key), E-MAN-015 (class), E-MAN-016 (owner), E-MAN-017 (audience), E-MAN-018 (egress), E-MAN-019 (schedule), E-MAN-020 (size), E-MAN-021 (resources) and E-MAN-022 (ttl). -
New commands publish an app to the platform:
aicoded publish [--app <name>] [-m <summary>] [--no-wait] [dir]sends the commitHEADnames, of an app folder that is the top level of its own git repository, to the platform's delivery pipeline, once nothing is left uncommitted andaicoded check --frozen --no-testsfinds no problem, and waits for the outcome;aicoded status [--json] <id>shows a publish's steps, problems and status. The first publish of a name creates the app, owned by the builder. A publish sends a git bundle of the history since the app's last verified publish, or all of it, at most 32 MiB, and needs git 2.31 or later.aicoded mcpgains the toolspublish, which takes an app and a summary and returns a publish id at once, andrelease_status, which takes that id. Publish only when the person asks, commit first, report the outcome, and fix its problems as those ofaicoded check; on E-CLI-004, ask the person to runaicoded login. When the platform does not accept the sign-in's token, or lacks an app's scopes in it, both commands and both tools refresh the sign-in once and ask again; only a token it still refuses is E-CLI-004. The guide "Releasing" is now "Publishing",guides/publishing. New codes: E-PUB-001 to E-PUB-014 (publishing) and E-GATE-001 to E-GATE-012 (the checks of the delivery pipeline). -
aicoded check --no-testsruns every step ofcheckbut the tests, and does not probe-race; the report has"no_tests": truein JSON, and its text ends withtests did not run (--no-tests). Thechecktool ofaicoded mcpdoes not take it: run the full check. Commands that use the sign-in to the platform at the same time now take turns throughcredentials.lock, next tocredentials.json, so that only one refreshes it. When the platform cannot refresh the sign-in right now (no connection, no answer in time, a 5xx status,server_errorortemporarily_unavailable), the sign-in is kept and the command fails with E-CLI-009: try again in a minute.aicoded loginwith an organisation the platform does not know fails with E-CLI-006, whose fix says to check the name with your administrator; Ctrl-C duringaicoded loginprintssign-in cancelled.AICODED_PLATFORMmay end in:443, which names the same platform as the address without it. New codes: E-CLI-009 (a sign-in the platform could not refresh right now). -
New commands sign a builder in to the platform:
aicoded login [--org <organisation>] [--device]signs in, at an address it prints for a browser on this computer, or, with--deviceon a computer without a browser, with a code entered in a browser on any device, and never opens a browser itself;aicoded logoutrevokes the sign-in and deletes it;aicoded whoami [--json]prints the organisation, email and scopes of the sign-in. The first login needs--org, and later ones remember it.AICODED_PLATFORMnames the platform,https://api.aicoded.cloudby default. The sign-in needs a person and a browser, so no MCP tool offers it: when a command says you are not signed in (E-CLI-004), ask the person to runaicoded login. New codes: E-CLI-004 (not signed in), E-CLI-005 (an address inAICODED_PLATFORMthat is not valid), E-CLI-006 (a sign-in the platform refused), E-CLI-007 (a credentials file that others can read) and E-CLI-008 (a sign-in not finished in time). -
The fixes of E-LINT-010 and E-MAN-007 put code in code spans, such as
filestore:<name>. -
The framework's module path is now
aicoded.dev/framework(it wasgopkg.aicoded.cloud/framework). Imports, therequireandreplacelines of an app'sgo.modandgo docuse the new path, such asaicoded.dev/framework/web/form, and the CLI's module isaicoded.dev/framework/cmd/aicoded. Docs links are underhttps://aicoded.dev/docs/, such as thedocs:line of every error,https://aicoded.dev/docs/errors/<code>. -
aicoded generaterefuses an<ssr:access>that adds nothing to a rule above it on the path (E-GEN-053): a list of two or more different roles that includes every role of that rule, such asrole="staff,people"belowrole="staff", with or withoutguard="true", since a list admits anyone with one of its roles; androle="*"withoutguard="true"below a rule that is not*. A single role repeated from above,*below*, and a single role or*withguard="true"are allowed. The error names the nearest such rule, and its fix lists only the roles the page adds. AGENTS.md and the access guide say that a list admits anyone with one of its roles, and that two roles are required by putting them on templates at different levels of the path. -
The
Init<Form>stub thataicoded generatewrites says that the hook runs every time the page shows or receives the form, on a GET too, and must not change data:Process<Form>does. AGENTS.md, the forms guide andtasks/add-formsay so too. AGENTS.md lists the framework's packages for app code, among themaicoded.dev/framework/web/formfor the types of form fields. -
A new recipe,
tasks/list-by-role, lists a viewer's own records, or every record for a role, with one constant statement for each case, from the room-maintenance example. E-LINT-007's page and fix point to it.tasks/ownership-checksays that the framework calls a page'sGuardonly withguard="true"in its own<ssr:access>(E-GEN-032). -
aicoded checkandaicoded devname the framework's package when an app imports a path underaicoded.dev/frameworkthat the framework does not have. The E-CHK-002 of the import adds the packages for app code whose last path element is the same, and its fix imports them instead: an import ofaicoded.dev/framework/formgetsimport "aicoded.dev/framework/web/form" instead. The packages named are the ones thataicoded explain E-LINT-001lists. -
dev.yamltakesenv:per workspace:dev, the default, orpreview, which runs the workspace's apps as a preview. Underpreview,app.Envreturnspreview, each app's database and user areac-preview-<app>, and the framework records errors and panics by their kinds and codes only, as outsideaicoded dev. Any other value is E-DEV-020. -
The framework has a third example app,
examples/room-maintenance, the reference for records with an owner: hotel staff report problems in rooms and see and edit only their own tickets, andhotel-opssee every ticket and change its status, which shows live in every open list that holds the ticket. Every page has an access rule, aGuardon each ticket answersweb.Forbidden(), the SQL filters by the author too, and a live list wakes only when a ticket its viewer may open changes, through areactive.Topickeyed by author, and reads its tickets again with the viewer's own rights. ItsREADME.mdshows where each check is. The examples' personas gain dana, with the rolesstaffandhotel-ops. -
E-LINT-008 follows outside data through the setters of form fields, such as
SetError,SetValueandSetOptions, so logging a field's error that quotes outside data is refused, and throughWriteHtmlof a select field's options; through theString,Error,FormatandMarshalJSONmethods thatfmt,log/slogandencoding/jsoncall on a value and on what it holds through pointers, elements, exported fields and embedded structs, and a context held there, which prints its values; and through more functions of the standard library that write into an argument, such asSumof a hash,slices.Insert,slices.Replace,io.CopyBufferandExpandStringof aregexp.Regexp. A call of a function value that may record through several functions is refused once, naming them all. -
E-LINT-008 follows outside data along more paths. Into a context: through any value whose type is or can become a context, such as a struct that embeds
context.Contextand holds the viewer's name, or an interface type of the app with the methods ofcontext.Context, also when the value is written after it became a context; through the key and the value ofcontext.WithValue; and through every call of a function value of typefunc(error), such as the cancel function ofcontext.WithCancelCause. Out of a context: throughValue,context.Cause, a type assertion, the app's own methods, or the context itself in a log line. What one context of the app holds counts for all of them. And through theAppendfunctions, such asfmt.Appendf,strconv.AppendQuoteandAppendEncodeofbase64.StdEncoding, into the slice they are given. -
E-LINT-008 also checks the code that
aicoded generatewrites from templates, and points to the template's line: with a*slog.Loggerinlog,{{ log.With('q', form.Q.GetValue()) }}is refused like the same call in Go. The people example returns the errors of its file store as they are, since the framework records them without the file names outsideaicoded dev, andnamelessis gone. AGENTS.md names E-LINT-008, and the guides list it among the checks. -
E-LINT-008: lint refuses outside data in a log line, a print or a span: a form value, a URL parameter, the request, the viewer's identity, a value from the database, a mail from the inbox, a stored file, a secret, the input of a page call,
Validatehook or RPC function, or another app's answer, or any string, error or struct made from one, that reacheslog/slog,fmt.Print,fmt.Printf,fmt.Println,print,println, the name oftelemetry.StartorSetAttrof a span. Numbers and booleans may be recorded; returned errors andRecordErrorare not checked. -
The framework records no error text outside
aicoded dev. Wherever it logs or traces an error, it keeps only the error's kinds and codes, such asE-FILE-001,MySQL error 1062 (23000),fs.PathError write: fs.ErrNotExist,HTTP 403,rpc not_foundor*errors.errorString, and a panic's value only by its Go type: for an error a hook returns that answers 500, a refused live value, a failed subscription, page call or function, a panic,Span.RecordErrorand the errorapp.Mainprints. Underaicoded devit records the whole text and value. Generated live pages log throughweb.LogError, which is for generated code only (E-LINT-005), andSnapshotofweb.Reactivetakes the connection's context. -
E-LINT-004 holds
mainto one form: the options ofapp.Mainandapp.Runare anapp.Optionsliteral written in the call, such asapp.Main(app.Options{Handler: pages.NewHandler(d), OnStart: d.Start}). A conversion such asapp.Options(o), a value of an unnamed struct type with the same fields, a variable, and options that a function returns, also one of a declared module, are refused, and so is any use ofapp.Mainorapp.Runother than a direct call, such asf := app.Main. -
In a declared module, E-LINT-003 also refuses
slog.SetDefault,slog.SetLogLoggerLevelandslog.NewLogLogger, and a change of a package-level variable of the standard library or the framework, such astime.Local = loc,*time.Local = ...,crc32.IEEETable[0]++, arangethat assignsrand.Reader, or&time.Local. -
E-LINT-007 also refuses constant SQL that holds more than one statement, such as
DELETE FROM drafts; DROP TABLE notes(a;may only end the statement), and SQL that reads or writes a file of the database server withINTO OUTFILE,INTO DUMPFILEorLOAD_FILE. -
aicoded checkruns lint's precheck of GOFLAGS and thevendorfolder for every app before any other go command, so a GOFLAGS entry such as-toolexecnever reachesgo build; an app it refuses (E-LINT-011) gets no other step.aicoded describewarns that the surface counts no writes when the precheck stops lint. PackagelintexportsPrecheck,Result.StoppedandFramework, the framework's module path. -
E-LINT-001 refuses the import of a package of the app that the checks do not read, in
testdata, in a folder whose name starts with_or., or in a folder that anignoredirective ofgo.modnames, and says so; and a path underaicoded.dev/frameworkthat is not a package of the framework module. E-LINT-010 says when a Go file is in a folder thatgo.modignores. A finding or error that quotes the go command gives the first line of what it printed that is not ago: downloadingnotice, writes the module cache as$GOMODCACHE, and a file of a module asmodule@version/path. Whengo envitself cannot run, such as for ago.modthat asks for a Go thatGOTOOLCHAINcannot download, E-LINT-011 says to fix what it reports, such as thegoline ofgo.modorGOTOOLCHAIN. -
E-GEN-042 also reserves the package-level names that a page's generated files declare, in expressions, loops,
<ssr:var>names and the types of<ssr:var>and<ssr:call>:routeKey,route,state,NewRoute,RouteData,RouteDataProvider,ReactiveState,NewHandler,assets,assetsDir, names starting withrenderBlock_, and a form'sForm<Name>Values. -
E-LINT-004 refuses a composite literal whose type is a type parameter or a pointer to one, such as
T{h, ...}or each{...}in[]T{{...}}, whatever the constraint, and a field namedHandlerorRPCwhose type mentions a type parameter, wherever it is set, such asg.Handler = hin a generic struct: use the concrete type. A literal that only holds values of a type parameter, such as[]T{a, b}, is allowed, and a keyed field such asHandler:is checked in every literal. E-LINT-009 refuses a conversion to or from a pointer to a type parameter, or a type parameter whose type set holds a pointer type or cannot be listed, such as(*logger)(p)for apof typeP *slog.Logger;int(v)for a type parameter constrained to number types, and a conversion to an interface type that is not a type parameter, such asany(v), stay allowed. -
E-LINT-009 now also refuses writing through a pointer whose pointee is a type parameter (
*p = vin a generic function), and converting a pointer to a standard-library or framework named type into a different pointer type ((*myLogger)(slog.Default())); both could change a value the app may not. Writing through your own pointer to such a type, such as*out = time.Now()for anout *time.Time, is refused for the same reason: return the value instead. -
E-LINT-011 is now "replace, go.work or vendor not allowed": besides a
replaceline and ago.workfile,aicoded checkrefuses avendorfolder at the app root, a module cache thatgo mod verifydoes not pass (fix:go clean -modcache), and every GOFLAGS entry outside a short list. Before lint runs a go command of its own, it reads GOFLAGS from the environment and then fromgo env -json, and splits each at spaces, tabs and line breaks; a quote, a backslash or a control character is refused, and only-mod=mod,-mod=readonly,-modcacherw,-trimpath,-buildvcs=true,-buildvcs=false,-buildvcs=auto,-vand-xare allowed. Ago envthat fails or prints anything else, as a GOFLAGS of-uor-wmakes it do, is refused too. The one allowedreplaceis still the framework pointed at the checkout thisaicodedwas installed from. -
E-LINT-007 now accepts only statements whose first keyword is
SELECT,INSERT,UPDATE,DELETE,REPLACE,WITH,CREATE TABLE,CREATE INDEX,ALTER TABLE,DROP TABLEorDROP INDEX;SET,PREPARE,EXECUTE,CALL,TRUNCATEand the like are refused, because they can run a string as SQL or change how SQL is lexed. Its parser follows MySQL's lexing, so a--comment needs a space after it and a doubled backquote inside a name is one backquote. In a declared module, E-LINT-003 also refusesreflect.NewAt,reflect.Value'sPointer,UnsafeAddrandUnsafePointer, and every method of thedatabase/sql/driverconnection, statement, transaction and driver interfaces. -
E-LINT-004 also reads a literal whose type is left out, such as each element of
[]*options{{h, ...}}. E-LINT-009 also refuses an assignment through*to a value of a named type of the standard library or the framework, such as*slog.Default() = ...;sql.ColumnType.ScanType; and any method or field of packagereflectused on areflect.Valueorreflect.Typethe app gets from a value it is given, such ase.Type.MethodByName(...)for ane *json.UnmarshalTypeError(reading theTypefield itself is allowed). -
E-LINT-011:
aicoded checkrefuses everyreplaceline in an app'sgo.mod, and ago.workfile that the go command reads for the app. The one exception is the framework'sreplacethataicoded initwrites from a framework checkout, accepted only by theaicodedinstalled from that checkout. In a declared module, E-LINT-003 also refuses a Go file that the checks cannot parse. -
E-LINT-007 also refuses SQL that comes from a call with several results, such as
db.QueryContext(statement()), and SQL that holds an executable comment,/*!or/*M!. A method of an interface, or of a type parameter's constraint, is checked as a method ofdatabase/sqlthat takes SQL when its name and signature match once each type parameter in it stands for any type, such asQueryContext(ctx context.Context, query string, args ...any) (R, error); one with such a name whose signature has a type parameter and does not match is refused. E-LINT-005, E-LINT-006 and E-LINT-009 match interface methods the same way. The surface counts the write that follows aWITHclause. In a declared module, E-LINT-003 refusesreflect.Value'sCall,CallSlice,MethodandMethodByNameandreflect.Type'sMethodandMethodByName. -
Lint also reads the code that
aicoded generatewrites from templates: E-LINT-006, E-LINT-007 and E-LINT-009 apply to it, and a problem in it points to the template's line, such aspages/index.html:12. So{{ store.DB.QueryRow('SELECT ' + q) }}is refused like the same call in Go, and the tables a template's SQL writes count in the surface. App code may usesql.Namedandsql.ErrConnDone(E-LINT-009). -
The guide
guides/ruleslists every rule that lint applies to app code: what not to do, what to do instead, and the error code. AGENTS.md points to it, and its "Never" bullets name imports and calls that lint refuses, such asos,log,sql.Open,web.Newandhttp.Get. -
E-LINT-007: the SQL passed to
Query,QueryContext,QueryRow,QueryRowContext,Exec,ExecContext,PrepareandPrepareContextof*sql.DB,*sql.Txand*sql.Conn, or of an interface with such a method, is a constant expression, and these methods are only called directly. A list forINgoes in as one JSON array read withJSON_TABLE, asguides/sql-databaseshows. A declared module runs no SQL at all (E-LINT-003). -
aicoded describe, thedescribetool andaicoded checkshow each app's surface: the larger of its entry points (pages, page calls for each page that offers them, functions served) and its effects (each table its constant SQL writes, once per kind of write, and each mail domain).describelists the writes aswrites INSERT users, and its JSON hassurfacewithsize,entry_points,effectsandwrites;check's JSON hassurfacefor every app that lint has read.describenow runs lint to read the SQL, and warns when it cannot. -
The permission list has a hand-written
modules:section: the third-party Go modules the app's code uses, by module path, such asgolang.org/x/text, each once and without a version (E-MAN-013). Lint refuses a third-party module that the app, or a declared module, imports without declaring it (E-LINT-002); the framework, the modules only it imports and the modules only tests use need no entry. It checks every package of a declared module that the app's build uses (E-LINT-003): no import ofos/exec,net,syscall,plugin,unsafe,C,crypto/tls,log/syslog,go/build,go/importer, the framework or anynet/...package other thannet/http,net/url,net/mailandnet/netip; noos.StartProcess,os.FindProcessoros.Process; no//go:linkname; no assembly or other source that is not Go; only the names ofnet/httpapp code may use; and no way to open a database or reach its driver.aicoded describeand thedescribetool list the declared modules. -
Lint has four more rules for hand-written code. E-LINT-004:
app.Options.Handleris a direct call of the generatedpages.NewHandler(...)andapp.Options.RPCof the generatedrpc.Server(), set in theapp.Optionsliteral, never a raw mux or a wrapped handler. E-LINT-005: functions for generated code, whose go doc now says "Generated code only.", such asrpc.Call,web.New,r.CSRFToken(), a form field'sProcessandreactive.HTMLBinding, are not called, and an unexported name of a generated file is not used. E-LINT-006:sql.Open,sql.OpenDB,sql.Registeranddb.Driver()are refused; the database comes fromsqldb.Open. E-LINT-009: fromnet/httponly the request, response, header and cookie types,StatusText,DetectContentTypeand the constants are used, fromdatabase/sqlits types, isolation levels,ErrNoRowsandErrTxDone, andconn.Raw,slog.SetDefault,slog.SetLogLoggerLevelandslog.NewLogLoggerare refused; nor does app code change a variable of the standard library or the framework, such asrand.Readerortime.Local. -
aicoded checkand thechecktool lint every app that builds and vets cleanly, before its tests. Lint applies the rules for app code, whose problems have E-LINT codes; test files are not linted, and nothing in the code, such as//nolint, turns a finding off. E-LINT-001: an app imports only its own packages, the building blocks and the standard packages that its page lists, so neveros,net,reflect,unsafeorrunnerproto;embed,rpc/wire,web/renderandprotowireare for generated files, and a file counts as generated only whenaicoded generatewrote it. E-LINT-010: an app holds only plain Go files built on every machine, with no assembly, C or object files, no cgo, and no//go:buildline or_<os>or_<arch>file name that leaves a file out of this build. When the go command is a newer Go than the oneaicodedwas built with, lint cannot run and every app gets E-CHK-007, whose fix names both versions. -
aicoded init <name>and theapp_createtool also writeAGENTS.md: the rules for AI assistants that build the app, what they must never do, the loop ofaicoded devandaicoded check, and where to read more. The framework repository has the same file at its root. Thenextofapp_createsays to read it first. -
Every package an app imports documents itself:
go doc aicoded.dev/framework/<package>prints what the package is for, its rules and the guide that covers it, and the package'sExamplefunctions show it in use. -
The framework has two example apps.
examples/peoplehas pages, forms with every field type, live values, a database, a file store, mail and a call toexamples/contacts, which serves that call from its own database and checks ownership again. Neither puts personal data in its logs or spans.examples/README.mdsays how to run them withaicoded dev. -
The docs are built into
aicoded: guides, task recipes, the changelog and the error pages.aicoded explain <topic>and thehowtotool print a page by its path, such asguides/overview,tasks/add-form,changelogorE-DEV-001. Without a topic, both list the guides, the tasks andchangelog, then the error codes, andhowtogives each page itssummary. A topic that names no page is E-CLI-001, now titled "no page for this topic or error code". The pages are also the resourcesaicoded://docs/<path>, such asaicoded://docs/guides/forms, and the MCP server's instructions start athowto guides/overview. The task recipes take their code from the example apps, and a test keeps it the same.llms.txtat the framework's root lists every guide and task, and a test refuses hidden Unicode in the repository. -
aicoded dev --manual <app> [dir]runs an app by hand, as under a debugger:aicoded devkeeps its runner up in a run folder that stays the same, never builds or starts the app, and prints the command that starts it:cd <dir> && AICODED_RUNNER_DIR=<run folder> go run .. Thepreviewtool reports such an app withstate: "manual"and the fieldscommandandrunner_dir, which only that state has;previewgenerates it and keeps its runner, unless its permission list ordev.yamlvalues changed. A--manualname that no app has is E-DEV-014. E-RUN-001's fix now names manual mode. -
aicoded devserves a dev UI for the developer athttp://localhost:<port>, behind a login link it prints; that address no longer lists the apps, so take an app's address frompreview. The developer can stop an app there: its address then answers 503 and it is not rebuilt when its files change, untilpreviewor the developer starts it again. Anaicoded devfor a folder above a running one is E-DEV-012 too. A token file of the dev UI that is not valid is E-DEV-018, and a request to the dev UI without logging in is E-DEV-019. No tool result holds the dev UI's token. -
aicoded init <name>creates an app:go.mod,aicoded.yaml,main.goandpages/index.html. A bad or taken name is E-CLI-002; anaicodedthat knows no framework version is E-CLI-003. -
aicoded check [--frozen] [--json] [--app <name>] [dir]runsaicoded generate, the held snapshot check,go build,go vetandgo testfor every app, and lists each problem with its code,file:lineand fix: E-CHK-002 (build), E-CHK-003 (vet), E-CHK-004 (test), E-CHK-005 (nogo) and E-CHK-006 (go mod tidy).--frozenwrites nothing and reports each generated file that is out of date as E-CHK-001. Tests run with-racewhen cgo works, and otherwise without it, with a note. -
aicoded describe [--json] [--app <name>] [dir]summarises the apps and never writes;aicoded explain [CODE]prints an error page or lists them. -
aicoded mcp [dir]serves the toolsapp_create,check,preview,what_broke,describe,howto,logs,traces,trace,mail_list,mail_getandmail_receiveover stdio, and the resourcesaicoded://errors/<CODE>andaicoded://changelog. Tools take app names, never paths; a name no app of the workspace has is E-DEV-014. It uses theaicoded devthat runs for the folder, or runs one itself for the session. -
aicoded devwatches the apps and rebuilds one when its files change. An app that fails to generate, holds a broken snapshot, fails to build or start, lacksdev.yamlvalues, exits or gets a new name on itsapp:line (E-DEV-015) stops alone, and its address answers 503 with its problems until a change builds.dev.yamlvalues are read at every start of an app. A port in use is E-DEV-011; a secondaicoded devfor the same workspace is E-DEV-012, and one of another version is E-DEV-013. A control socket path that holds something else is E-DEV-016, and one too long for a Unix socket is E-DEV-017. Logs, spans and caught mail survive restarts, with secret values of 4 bytes or more shown as[secret <name>]. -
aicoded generatechecks every snapshot the workspace's apps hold of this app before it writes anything, so a breaking change torpc/fails with E-RPC-013 and leaves.aicoded/rpc.jsonas it was. A file other thanclient_gen.goinservices/<app>/is E-RPC-014. It prints esbuild warnings. -
aicoded devcarries calls between the apps it runs and checks each one against both permission lists. It refuses a call thatservices.callsdoes not name (E-RPC-008), a call to an app that is not running (E-RPC-011), and a viewer token that the runner did not issue to the calling app, that is an app's own, or that it issued more than 10 minutes ago (E-RPC-012): call with the context of the request or call being served. An app whose held snapshot a called app broke fails alone (E-RPC-013); a snapshot of an app outside the workspace only prints a warning. -
aicoded devrun in a folder above apps runs all of them. It generates each app, starts each one after the apps it calls, and keeps the others running when one fails. Of apps that call each other, the first in folder order starts first, so never call, inOnStart, an app that calls this app too (E-RPC-011). Two apps with one name are refused (E-DEV-010). The folder may be reached through a symbolic link; links below it are not followed. An app with no pages that serves calls has no address. Withoutpersonas,all-roleshas the roles of every app's pages and functions. -
aicoded rpc add <app>, run in the calling app, finds<app>in the folder above it and copies its snapshot to.aicoded/services/<app>.json.aicoded generatethen writes the clientservices/<package>/client_gen.go, whose package is<app>without dashes, andservices.calls. Before it writes anything in the calling app,rpc addrefuses a name that no app or two apps there have, the calling app itself and an app with no function inrpc/(E-RPC-007), and a package name that is a Go keyword, is predeclared or is taken (E-RPC-006). -
services.callslists the client functions the app's code names, found without type-checking: a local variable named like a client package can add a function the app never calls, and a client imported with.is not seen, so its calls are refused (E-RPC-008). Keep the client's name for the client alone. -
For an app with
rpc/,aicoded generatewritesrpc/server_gen.go, the snapshot.aicoded/rpc.jsonandservices.serves; never edit them. An app with no pages getsaccess: {}. -
Calls between apps: exported functions in
rpc/(package rpc) of the shapefunc Name(ctx context.Context, in In) (Out, error), each with//ssr:access caller=<apps> role=<a|b> apps=true.caller=and one ofrole=andapps=trueare required. A function without the line is E-RPC-001; a malformed line, a line on anything but an exported function and a line written// ssr:accessare E-RPC-002; another shape, or a name that Go orrpc/server_gen.gouses, is E-RPC-003. A function withapps=trueand norole=takes no viewer's calls. Fields arebool,int32,int64,uint32,uint64,float32,float64,string,[]byte,time.Time, exported structs ofrpc/, slices of these, and pointers for optional values;int, maps, other packages' types, slices of pointers and pointers to slices are refused (E-RPC-004). -
.aicoded/rpc.jsonpins every field's number, and a removed field's number is never used again in its struct. A struct that no function reaches any more, or that is renamed, loses its numbers, and its fields are numbered afresh. Renaming or removing a function or field, or changing a field's type or number, breaks its callers. A snapshot file that is not valid is E-RPC-005. -
rpc.Error(code, msg)andrpc.Errorfwithrpc.InvalidArgument,NotFound,AlreadyExists,PermissionDenied,FailedPreconditionorUnavailablereach the caller with their message, cut at 1 KiB. Any other error or a panic reaches it asrpc.Internal"internal error".rpc.CodeOf(err)reads the code andrpc.Caller(ctx)names the calling app. A call gets 10 s when its context has no deadline, and at most 30 s; one cut short matchescontext.DeadlineExceededorcontext.Canceledwitherrors.Is.app.Options.RPCserves the generatedrpc.Server(), and an app with onlyRPCneeds noHandler. -
Runner protocol 3 adds calls between apps:
RpcService.Callonrunner.sockandAppService.Serveonapp.sock.runnerprotoaddsDefaultCallDeadline(10 s),MaxCallDeadline(30 s) andMaxForwardedTokenAge(10 min), andOriginHeaderandOriginRunner: the runner marks its own refusals with the error metadataAicoded-Origin: runner. Only a refusal with that mark reaches the caller as a coded error, whose text starts with the code and carries its fix line; a called app's own refusal reaches the caller as plain text, whatever it looks like.rpc.CodeOfreads the status of every error. Viewer tokens gainClaims.App, for a call an app makes as itself, andviewer.VerifyIssuedchecks a token an app hands back to the runner. An app built with this framework needs anaicodedthat speaks protocol 3; the runner refuses a mismatch when the app starts (E-RUN-002). -
sqldb.Open(ctx)returns the app's own MySQL database as a*sql.DB, with no DSN or password; it needs- source: sqldbunderdata(E-MAN-010). Open it once inOnStartand pass values with?placeholders; one statement runs per call, and times are in UTC. -
mailer.Send(ctx, mailer.Message{…})sends fromemail.fromtoemail.to_domainsonly (E-MAIL-003);IdempotencyKeyis required, and a repeated key sends nothing.mailer.List,Get,DeleteandMoveread the app's one mailbox:mailer.Inbox,ArchiveandTrash. -
filestore.Open(ctx, name)returnsfilestore:<name>as anfs.FSwithCreate,WriteFile,Mkdir,RemoveandRename; a file appears only whenClosesucceeds. Names are paths inside the store (E-FILE-001), a file is at most 1 GiB (E-FILE-002), an undeclared store is E-MAN-011. -
aicoded devoffers the personasall-roles, with every role theaccesssection names, andno-roleswhendev.yamlnames none. -
aicoded generatewrites theaccesssection ofaicoded.yaml: one entry per page a viewer can open, keyed by URL pattern, withrequire,guardandcalls. Never edit it. The file must be one YAML document in block style, or generate refuses it (E-MAN-003). -
Runner protocol 2 adds the file and mail services. An app built with this framework needs an
aicodedthat speaks protocol 2; the runner refuses a mismatch when the app starts (E-RUN-002). -
<ssr:assets/>,<ssr:content/>and<html>insidessr:if,ssr:else-if,ssr:elseorssr:forare refused (E-GEN-051), and so is a page that renders without an<html>element (E-GEN-052). -
The permission list (
aicoded.yaml) gainsdata, entries ofsource(sqldb,filestore:<name>,connector:<name>) with theirclasses, andemailwithfromandto_domains(E-MAN-007..009). Using an undeclared database, store or mail is E-MAN-010..012. -
Pages: folders under
pages/with anindex.htmlare pages;aicoded generatewrites their code. Every page path needs<ssr:access role="a,b"/>, with lower-case role names; rules along a path are combined, so the viewer needs a role from each, androle="*"admits every viewer. -
Parameter folders:
s_namecaptures one URL part as a string andn_namea whole number made of digits; a part that is not one answers 404. Read both withr.URLParam("name");r.URLParamInt("name")returns ann_value as anint64. Folder names are ASCII letters, digits and_, starting with a letter, and notmainor a Go keyword. No folder underpages/starts with_or is namedtestdata. -
A page with pages below it is their layout when it contains
<ssr:content/>, and their gate when it does not. A layout shows the page below where<ssr:content/>stands. Opening it sends the viewer to its default page, or answers 404 without one. Name the default by the folders of a page below the layout, relative to it, as<ssr:content default="settings"/>inpages/admin/index.htmlfor/admin/settings.aicoded generaterefuses a default that names no such page, or a parameter folder (E-GEN-049); otherwise leavedefaultout and return the page fromDefaultRoute. A gate's access rule andGuardapply to every page below it, but its forms,Data, live values, calls, markup and assets stay on its own page, which opening it shows: put a list atpages/notesand its items atpages/notes/n_id. When the root page is a gate, each page below it writes its whole document:<!doctype html>,<html>, a<head>with<ssr:assets/>, and<body>. -
<ssr:assets/>writes the scripts and styles of its page and of every page shown inside it; a page whose scripts or styles would never load is refused (E-GEN-050). -
<ssr:access … guard="true"/>addsGuard(ctx, r) errorto the page's data provider; returnweb.Forbidden()for records the viewer may not see, orweb.NotFound()only when even their existence must stay hidden. -
Hooks run in this order: the access rules of every page on the path, then their
Guards, root first, then the form token (on a post), andInit<Form>,Process<Form>(only the posted form, and only when it is valid) andDatafor the layouts on the path and the page itself. Hooks get*web.Request(r.URLParam(name)) andweb.ResponseWriter, which has onlyHeader(): set a cookie withw.Header().Add("Set-Cookie", c.String()). -
End a request with
web.NotFound(),web.Forbidden(),web.Error(status, message)orweb.Redirect("/path"); redirects go only to paths on the same site. -
Templates escape
{{ }}for where the value lands (text, attribute, URL). Inhref="/{{ slug }}"a leading/of the value is encoded and an empty value becomes., so the link never leads to another site. Inline<script>code,srcdoc,<style>,on*andstyleattributes are errors: put code inindex.tsand styles inindex.cssnext toindex.html. Pass data to scripts with<ssr:json name="id" value="expr"/>, one name per template. -
{{$ expr }}writes markup, only in element text, and takes onlyweb.SafeHTML(web.HTMLConst,web.EscapeHTML,web.JoinHTML). Declare such a variable with<ssr:var name="intro" type="web.SafeHTML"/>: a variable's type may be an exported type of packageweb, but of no other package. -
A variable the template declares but never reads, or only binds to an input, builds.
-
Whitespace between elements shows as one space, as in the browser:
<b>a</b> <i>b</i>shows "a b". Text in<pre>,<textarea>and raw-text elements such as<noscript>keeps its whitespace as written. -
Page scripts import only files of the app, by a path such as
./label; packages andnode_modulesare refused. Images in<img src>, next to the template or as/assets/<file>, are embedded in the app and served under/_aicoded/assets/.pages/assets_gen/holds no source maps. -
Select fields accept only the options
Init<Form>set. -
Live values:
<ssr:var … reactive="true"/>withSubscribe(ctx, r, state)andstate.Set<Name>(v);client-writable="true"addsValidate<Name>. Page scripts importssrfrom./reactive_gen.ssr:bindworks on<input>(nottype="file", and only with a fixedtype),<select>and<textarea>. -
Page calls:
<ssr:call name="star" in="StarIn" out="StarOut"/>addsCallStar(ctx, r, in StarIn) (StarOut, error)to the page's data provider; the page script callsawait ssr.call("star", {...})over the page's live connection. Access rules andGuardrun again for every call; the roles are those the connection opened with, so a role change takes effect when the page reconnects, at the latest after 10 minutes. A failed call rejects with{status, message}; onlyweb.Errormessages reach the page. -
app.Main(app.Options{Handler: h})runs an app under its runner. Every request reachinghhas a verified viewer; there is no login code in apps. -
app.Run(ctx, opts)does the same untilctxis done and returns the error instead of exiting; use it in tests or to embed the app.maincallsapp.Main. -
app.Options.OnStart(ctx)runs after the handshake and before the app reports ready; itsctxcan read settings and secrets. An error stops the app. -
app.Name(ctx),app.Env(ctx)andapp.Version(ctx)return the app's name, environment (for exampledev) and release version. -
auth.Viewer(ctx)returns the viewer:.Subject, the stable id to store as a record's owner,.Name,.HasRole(r),.InGroup(g). -
config.String(ctx, name)reads a setting declared undersettings:inaicoded.yaml. -
secrets.Get(ctx, name)reads a secret declared undersecrets:; call.Reveal()only where the value is used. Printing or logging a secret shows[REDACTED]. -
telemetry.Start(ctx, name)starts a span;defer span.End().span.SetAttr(key, value)records an attribute andspan.RecordError(err)marks the span as failed. -
aicoded devruns apps locally with test personas. It runsaicoded generatefirst, so pages are always built from their current templates.