turbo-editors/turbo-python · 2026-09-15-acp.md

turbo-editors/turbo-pythonpublic⑂ Fork 0

⑂ main

2026-09-15-acp.md · 29 lines · 1.9 KBmarkdown    Blame HistoryRaw
📦 Turbo Python   1# Handoff — 2026-09-15 — ACP agent windows, ported
5**Done.** Branch `feature/acp`, local, **not committed and not pushed**.
7The feature is turbo-core's; this repository contributes `internal/*/acp.toml.tmpl` and one line in the profile. Tests green, quality gate PASS, documentation EN + FR.
9Read **turbo-core's** handoff of the same date first: it holds the design, and every trap worth knowing.
11## In flight
15## Next steps
171. **turbo-core must be released first.** This repository cannot build against an unreleased library from a clean clone. Order: tag and release turbo-core → `go get codeberg.org/turbo-editors/turbo-core@vX.Y.Z` here → **`GOWORK=off make check`** → tag and release this.
182. Open the editor, press `Alt-A`, and talk to an agent. Nobody has done that from **this** editor — only from turbo-go.
20## Watch out for
22- **`go.work` is what makes this build against the local turbo-core**, and it is gitignored. `GOWORK=off` is the only way to see what a clean clone sees.
23- **The sandbox's filesystem corrupts `cp` for some recently-written inodes** — a file reads correctly through `cat`, `git` and `go build`, and comes out of `cp` as the right number of NUL bytes. It bit this port twice. Never use `cp` or a cross-filesystem `mv` to back a file up here; use `cat`.
24- **One sentence in the starter file is about this editor and not the protocol** — the ```python fence and the file extension beside it. `TestTheCreatedAgentsFileNamesThisEditorsOwnLanguage` is what stops a future copy-paste leaving another editor's language in it.
25- **The documentation was adapted, not copied.** The slug, the language name, the fence, the build command and the language server were all replaced. If you add a page, do the same rather than translating turbo-go's wholesale.
27## Never touched by a human, here
29Everything. The agent window has only ever been opened from turbo-go.

📦 Turbo Python 6fc62ea k33g 12h ago	1	# Handoff — 2026-09-15 — ACP agent windows, ported
	2
	3	## State
	4
	5	Done. Branch `feature/acp`, local, not committed and not pushed.
	6
	7	The feature is turbo-core's; this repository contributes `internal/*/acp.toml.tmpl` and one line in the profile. Tests green, quality gate PASS, documentation EN + FR.
	8
	9	Read turbo-core's handoff of the same date first: it holds the design, and every trap worth knowing.
	10
	11	## In flight
	12
	13	Nothing.
	14
	15	## Next steps
	16
	17	1. turbo-core must be released first. This repository cannot build against an unreleased library from a clean clone. Order: tag and release turbo-core → `go get codeberg.org/turbo-editors/turbo-core@vX.Y.Z` here → `GOWORK=off make check` → tag and release this.
	18	2. Open the editor, press `Alt-A`, and talk to an agent. Nobody has done that from this editor — only from turbo-go.
	19
	20	## Watch out for
	21
	22	- `go.work` is what makes this build against the local turbo-core, and it is gitignored. `GOWORK=off` is the only way to see what a clean clone sees.
	23	- The sandbox's filesystem corrupts `cp` for some recently-written inodes — a file reads correctly through `cat`, `git` and `go build`, and comes out of `cp` as the right number of NUL bytes. It bit this port twice. Never use `cp` or a cross-filesystem `mv` to back a file up here; use `cat`.
	24	- One sentence in the starter file is about this editor and not the protocol — the ```python fence and the file extension beside it. `TestTheCreatedAgentsFileNamesThisEditorsOwnLanguage` is what stops a future copy-paste leaving another editor's language in it.
	25	- The documentation was adapted, not copied. The slug, the language name, the fence, the build command and the language server were all replaced. If you add a page, do the same rather than translating turbo-go's wholesale.
	26
	27	## Never touched by a human, here
	28
	29	Everything. The agent window has only ever been opened from turbo-go.