aicoded.dev

Error catalogue

Every error the framework, the generator, the CLI or a runner reports on purpose has a code E-<AREA>-<NNN>, a one-line fix and a page here named after the code.

Area Reported by
GEN generator and templates
WEB web runtime
RPC calls between apps: the generator, aicoded rpc add, the runner and the called app
MAN aicoded.yaml
RUN app↔runner protocol, what a runner refuses to serve, and a runner's enrolment and connection to the platform
DEV aicoded dev, its control socket and its dev UI, and the apps of a workspace in aicoded check, aicoded describe and aicoded mcp
CHK aicoded check and the Go build it runs, also in aicoded dev
LINT the rules for app code that aicoded check applies after go vet, listed in the rules guide
CLI aicoded init, aicoded explain, aicoded login, logout and whoami, the sign-in that aicoded publish and status use, and the app_create and howto tools of aicoded mcp
PUB aicoded publish, aicoded status and aicoded preview, and the publish, release_status, preview_publish and preview_end tools of aicoded mcp
GATE the security checks of the platform's delivery pipeline, in the problems and notes of a publish
REL the platform's release of a publish to production, the approval of an approval card in the console, and an app's preview
DATA notes on where the app's data goes, in aicoded check and the delivery pipeline: they never stop a check or a publish
MIG schema changes: the draft .aicoded/migration.sql in aicoded check, aicoded dev and the delivery pipeline, and the migrations applied to a database
SQL the app's database connection (mysql.sock)
FILE file stores
MAIL mail rules, the mailbox where a target keeps none, the messages a runner takes at once, a preview's messages, received messages and folders a runner cannot read, a company mail relay a runner cannot sign in to, and the operator's mail domains
OUT the requests an app sends to outside services with outbound.Client(), which the runner checks against egress
LOGIN company login, which signs people in to the apps of their organisation
ORG the platform operator's deletion of an organisation

Calls between apps use these codes:

Workspaces use these codes:

The permission list uses these codes for what its fields may hold:

Signing in to the platform uses these codes:

Publishing uses these codes:

Schema changes use these codes:

E-LINT-013 refuses a schema change in app code, which goes in the draft, and SQL in app code that names aicoded_migrations, the platform's journal of migrations.

Notes on where data goes, which never stop a check or a publish, use these codes:

Releasing uses these codes, each a release that the platform refuses before anything runs:

Approving an approval card in the console uses these codes, each an approval that the platform refuses, so that nothing is released. The card still waits, unless E-REL-026 refuses it because it was approved or declined already:

Starting a preview with aicoded preview or the preview_publish tool uses these codes, each a start that the platform refuses, so that a preview that runs keeps its version:

Asking for the release of a publish held for its owner's preview, with aicoded release, the release tool or the console, uses these codes, each a request that the platform refuses, so that nothing is released:

E-REL-039 is a note on a held publish, for an aicoded older than v0.13.0, which does not know the held state.

E-REL-031 refuses the app's owner a sixth person to see the app's preview, in the console.

E-REL-032 refuses a release or a preview that the platform could not sign, so that nothing is released.

E-REL-009 refuses the operator's purge of a publish that a live or pending release, or the app's running preview, runs.

E-REL-016 refuses the operator's renaming or archiving of an app that has a release live or pending: such an app keeps its name and stays active until releases can be stopped.

E-REL-028 refuses the operator's setting or deleting a secret of an app of another organisation: the app's owner or a security admin sets it in the console.

The operator's deletion of an organisation with admin orgs delete uses these codes:

E-FILE-003 refuses an app's list, or removal, of a folder of a file store that holds more than the runner lists of files and folders directly in it: 10 000 entries In your own cloud, a listing of 4 MiB Hosted by us.

E-MAIL-009 refuses the operator's adding or verifying a mail domain of an organisation that has no target to register it at: one placed on no server, or whose server's target the platform cannot reach.

E-MAIL-010 refuses, on the platform, a message with a new idempotency key while 10 000 of the app's messages are being sent, and, In your own cloud, a read of a message that waited until its call's deadline while two of the mailbox's messages were being read.

E-MAIL-011 refuses, in a preview on the platform, a message over 1 MiB: a preview sends no mail, and keeps each message for the app's owner to read in the console.

E-MAIL-012 refuses, In your own cloud, an app's read of a received message the runner cannot hand it: one over 10 MiB, or one that is not a message it can read. The message stays in the mailbox, listed with its id and size, so the app can move or delete it.

E-MAIL-013 refuses, In your own cloud, an app's list of a mail folder of more than 20 000 messages: the runner lists the newest 10 000 of a folder, and reads at most 20 000 to find them.

E-MAIL-014 refuses, In your own cloud, an app's message while the runner cannot read the sign-in of the company's mail relay, which then sends every app's mail, or for a few seconds after the relay refused it or refused AUTH PLAIN: nothing was sent, and the message can be sent again later with the same idempotency key.

E-RUN-005 refuses an app's call to a building block the runner does not provide; none on the platform today.

E-RUN-006 is the page a runner shows to a signed-in person whom the app's audience does not name, and the page the platform shows at an app's preview to a person the preview does not admit.

E-RUN-009 is the reason a runner reports for a release whose grants it cannot tell the resources of: a grant of a kind it does not know, or two of one kind.

E-RUN-011 refuses, on the platform, an app's read of a declared secret that has no value where the app runs.

E-RUN-012 refuses, on the platform, an app's read of a secret past the runner's bound of its reads: 100 at once, then 20 a second, and 8 under way at once.

E-RUN-014 refuses the start of an app built with a framework older than v0.10.0 whose permission list declares egress, and E-RUN-015 an app's read of a secret that egress binds to a host.

E-RUN-016 and E-RUN-017 are the reasons a runner reports for a release or a preview it refuses to start: one with no signature of the platform, or one that does not match it, and one signed earlier than the newest this server has served for the app in that environment.

E-RUN-013 is the page a runner shows, with status 503, for an app whose new version did not start after a destructive schema change, which the earlier version cannot run on.

E-RUN-007, E-RUN-008 and E-RUN-010 are what the platform answers a server's runner that enrols or connects: a refused enrolment token or certificate request, a runner certificate that is missing, expired, revoked or of another server, and a runner of another protocol version. E-RUN-018 is what it answers the runner of a server In your own cloud that enrols with its EC2 instance's role, and is refused.

E-LOGIN-001 refuses to sign a person in to an app when the sign-in provider gives them an issuer or a subject of more than 255 characters, or an identity of more than 512 bytes joined.

aicoded explain <CODE> prints the page.

Retired codes are never reused:

Markdown · Source on GitHub · framework f46741f