Jadpo is experimental and not ready for production. These docs follow the compiler's main branch as of 5 Nov 2026. What's built · Install 0.3.0
jadpo
ReferenceErrors

ErrorsTools · rule

toolchain.artifact_write_failed

On this page

A file Jadpo writes for you, such as a record, couldn't be written, usually because it or its folder is read-only.

Area 14, Tools; not declinable; the next step is usually the human's.

Why Jadpo refuses it

Commands such as jadpo records update, jadpo api update, jadpo migrate new and jadpo build write files you commit or deploy. When the operating system refuses one, the command stops there and says which file and why, rather than carry on as if the project were up to date.

Jadpo won't change permissions for you: who may write in the project is a decision about your machine, not about the app.

What it looks like

The project's folder is read-only, and access.jadpo_record, the record of who can do what, has to be written again:

shell
rm access.jadpo_recordchmod a-w .jadpo records update
jadpo records

error access.jadpo_record couldn't be written

reason
Writing it failed: Permission denied (os error 13).
next
Check that the folder can be written, then run jadpo records update again (human)
rule
toolchain.artifact_write_failed
help
https://jadpo.dev/docs/errors/toolchain.artifact_write_failed

(human) at the end of the next: line tells your coding agent to stop and ask you which fix you want, because the choice is yours to make: it decides who may write in the project.

How to fix it

If the folder or the file should be writable, let yourself write to it, then run the command again:

shell
chmod u+w . access.jadpo_recordjadpo records update

The record is written, ready to commit with the code.

If a tool keeps the files read-only until you open them for editing, open the record for editing with that tool, then run the command again:

shell
jadpo records update

The record is written, and the tool shows it as changed, ready to commit with the code.

Markdown for agents: /docs/errors/toolchain.artifact_write_failed.md.Built from Jadpo main at aee2e8f.