Janady13/AI_Brain_Control / sub_brains/codex/JOB_FORMAT.md

Source identity

Field	Recorded value
Source type	GitHub source
Original record	Janady13/AI_Brain_Control / sub_brains/codex/JOB_FORMAT.md
Date	Not specified in source
Repository	Janady13/AI_Brain_Control
Revision	38c95c6b67d12a7096301e2eaa2892c027e411d7
Branch	main
Path or archive member	sub_brains/codex/JOB_FORMAT.md
Original SHA-256	9ded04689a2f89bb7f624cec728e817d08efbda869746fc853abcab632313f84
Git blob SHA	5573646cfefad62df6dc53d9a8ba149d58fbaed6
Reading-copy SHA-256	9ded04689a2f89bb7f624cec728e817d08efbda869746fc853abcab632313f84

Original source ↗

Recovered source transcript

Download complete source text ↓70 lines · 1.8 KB

# Codex Job Format (line-based mini-DSL)
Each job file is plain text with KEY=VALUE pairs and an ACTION line.

Required:
  ACTION=<one of: SCAFFOLD, WRITE, BUILD_SHARDS, HANDSHAKE, SHELL, VERIFY>

Optional common keys:
  NOTE=free form text

Actions:

1) SCAFFOLD
   - Creates a code/project scaffold under OUT_DIR.
   Keys:
     OUT_DIR=<abs or relative path under BODY or BRAIN>
     KIND=<fastapi|bash|html|python_pkg>
     NAME=<project name>
   Example:
     ACTION=SCAFFOLD
     OUT_DIR=$HOME/Desktop/AI_Body/scaffolds/fastapi_demo
     KIND=fastapi
     NAME=demo_api

2) WRITE
   - Writes a file with given content (base64) safely.
   Keys:
     PATH=<absolute path>
     MODE=<644|755> (optional, default 644; if endswith .sh -> 755)
     CONTENT_B64=<base64 payload>
   Example:
     ACTION=WRITE
     PATH=/Volumes/BrainSSD/AI_Brain_Control/docs/hello.md
     CONTENT_B64=IyBIZWxsbyEKVGhpcyBpcyBhIGRvYy4K

3) BUILD_SHARDS
   - Asks the Body builder to build N shards with profile/size.
   Keys:
     PROFILE=<nvme|ssd|hdd>
     TOTAL_SHARDS=<int> (0 means run-forever batch; default 2)
     TARGET_MB=<int> default 256
     COMPRESSOR=<auto|zstd|gzip> default auto
     COMPRESS_LEVEL=<int> default 3
   Example:
     ACTION=BUILD_SHARDS
     PROFILE=ssd
     TOTAL_SHARDS=4
     TARGET_MB=256
     COMPRESS_LEVEL=3

4) HANDSHAKE
   - Refreshes/extends the Brain handshake docs.
   Keys:
     APPEND_TEXT_B64=<base64 text> (optional)
   Example:
     ACTION=HANDSHAKE
     APPEND_TEXT_B64=LS0gQ29kZXggaGFuZHNob3RlIGFkZGVkLgo=

5) SHELL
   - Run a bounded shell command and capture output to OUT/.
   Keys:
     CMD=<shell command>
   Example:
     ACTION=SHELL
     CMD=ls -la "$HOME"

6) VERIFY
   - Runs integrity verifier for shards and writes report to OUT/.
   Example:
     ACTION=VERIFY