Skip to content

Commit c8f54c6

Browse files
committed
update README.md - Repository Structure
1 parent 1fc727c commit c8f54c6

1 file changed

Lines changed: 6 additions & 2 deletions

File tree

README.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -114,10 +114,12 @@ your_repo/ <-- outer repo (your identity, has GitHu
114114
├── .env <-- gitignored, real secrets
115115
├── README.md
116116
├── .alcatrazer/ <-- gitignored via .git/info/exclude; tool state + installed source
117-
│ ├── src/alcatrazer/ <-- extracted package source (readable install, bundled tests)
118-
│ ├── schemas.json <-- schema history for state.json + config.toml + coding-environment.toml
117+
│ ├── src/alcatrazer/ <-- extracted package source incl. schemas.json (readable install, bundled tests)
118+
│ ├── Dockerfile <-- generated Alcatraz recipe (image build input)
119+
│ ├── entrypoint.sh <-- generated container entrypoint (chown, drop via gosu)
119120
│ ├── python -> /usr/bin/python3 <-- symlink to the Python that was used to install
120121
│ ├── config.toml <-- per-developer config (schema_version, identity, daemon settings)
122+
│ ├── coding-environment.toml.last <-- recipe snapshot at last build (stale-image detection)
121123
│ ├── uid <-- phantom UID
122124
│ ├── agent-identity <-- random agent name + email
123125
│ ├── workspace-dir <-- pointer to the workspace directory name
@@ -141,13 +143,15 @@ alcatrazer/
141143
├── docker_prison.py <-- Docker adapter of the Alcatraz port
142144
├── snapshot.py <-- flat snapshot from outer repo into the workspace
143145
├── promote.py <-- replay agent commits onto your branch via git format-patch | git am
146+
├── git_runner.py <-- central git command runner (safety funnel for all git subprocess calls)
144147
├── daemon.py <-- sync daemon (polls from the host side)
145148
├── daemon_lifecycle.py <-- launch / shutdown wiring for start / stop / clear
146149
├── identity.py <-- random agent identity + workspace dir generation
147150
├── languages.py <-- declared runtimes → Dockerfile fragments
148151
├── selftest.py <-- bundled security self-tests (phantom UID, etc.)
149152
├── state.py <-- .alcatrazer/state.json reader + schema-compatibility gate
150153
├── schema.py <-- loader for schemas.json (schema history, version constants)
154+
├── schemas.json <-- schema history for state.json + config.toml + coding-environment.toml
151155
├── status.py <-- cmd_status implementation
152156
├── container/entrypoint.sh <-- container entrypoint (chown, drop via gosu)
153157
├── scripts/ <-- bash bootstrap (runs before Python exists)

0 commit comments

Comments
 (0)