Admin-API

Aŭtentigitaj finpunktoj kiuj redaktas la enhavon de la retejo per validigitaj git-commit-oj.

Ĉiuj administraj finpunktoj bezonas Authorization: Bearer <admin token> (Jenks tenas ĝin en la macOS Keychain kiel agent-env:JENKSGUO_ADMIN_TOKEN; iloj legas env JENKSGUO_ADMIN_TOKEN). Skriboj estas validigitaj per la sama skemo kiel la konstruo, poste commit-itaj al GitHub. CI tradukas ŝanĝitajn erojn en ĉiun lingvon, rekonstruas kaj deplojas: main → jenksguo.xyz, dev → dev.jenksguo.xyz.

Metodo	Vojo	Ilo
GET	`/api/admin/whoami`	—
POST	`/api/admin/login` · `/api/admin/logout`	— (konsola seanca kuketo)
GET	`/api/admin/schema`	`admin_schema`
GET	`/api/admin/files`	`admin_list_files`
GET	`/api/admin/file`	`admin_read_file`
POST	`/api/admin/validate`	`admin_validate`
PUT	`/api/admin/file`	`admin_write_file`
DELETE	`/api/admin/file`	`admin_delete_file`
POST	`/api/admin/changes`	`admin_commit_changes`
POST	`/api/admin/ai-edit`	`admin_ai_edit`
GET	`/api/admin/deploys`	`admin_deploy_status`
POST	`/api/admin/promote`	`admin_promote`

Eraroj: 401 unauthorized, 403 forbidden_path (nur enhavaj dosieroj estas skribeblaj), 422 invalid kun errors[], 409/502 github_error, 503 github_not_configured.

`admin_schema` — Enhava skemo

La enhava modelo: erkampoj kaj reguloj, etikedoj, lensoj, specoj, skribeblaj vojoj, dokumentoj, kaj redaktaj konvencioj. Legu tion ĉi antaŭ ol skribi.

MCP: admin_schema ĉe https://jenksguo.xyz/mcp/admin
REST: GET /api/admin/schema (admin token)
CLI: jenks admin schema

Neniuj argumentoj.

curl -s "https://jenksguo.xyz/api/admin/schema" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

`admin_list_files` — Listigi enhavajn dosierojn

Listigu redakteblajn enhavajn dosierojn en branĉo (vojo, grandeco, sha), laŭvole ene de unu dosierujo kiel content/corpus/experiences.

MCP: admin_list_files ĉe https://jenksguo.xyz/mcp/admin
REST: GET /api/admin/files?dir=&branch= (admin token)
CLI: jenks admin ls [dir]

Argumento	Tipo	Postulata	Notoj
`dir`	ĉeno	ne	ekz. content/corpus/projects (defaŭlte: tuta enhavo)
`branch`	`main` · `dev`	ne	main publikigas al jenksguo.xyz; dev antaŭmontras sur dev.jenksguo.xyz (defaŭlte main).

curl -s "https://jenksguo.xyz/api/admin/files" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

`admin_read_file` — Legi enhavan dosieron

Legu la krudan Markdown/JSON-fonton de enhava dosiero (kun ĝia sha). Transdonu path, aŭ slug por ero, lenso aŭ kapablo.

MCP: admin_read_file ĉe https://jenksguo.xyz/mcp/admin
REST: GET /api/admin/file?path=&slug=&branch= (admin token)
CLI: jenks admin get <slug|path>

Argumento	Tipo	Postulata	Notoj
`path`	ĉeno	ne
`slug`	ĉeno	ne
`branch`	`main` · `dev`	ne	main publikigas al jenksguo.xyz; dev antaŭmontras sur dev.jenksguo.xyz (defaŭlte main).

curl -s "https://jenksguo.xyz/api/admin/file" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

`admin_validate` — Validigi ŝanĝon

Validigu dosierenhavon kontraŭ la enhava skemo sen commit-i. Redonas liston de problemoj (malplena = valida).

MCP: admin_validate ĉe https://jenksguo.xyz/mcp/admin
REST: POST /api/admin/validate (admin token)
CLI: jenks admin validate <path> <file>

Argumento	Tipo	Postulata	Notoj
`path`	ĉeno	jes
`content`	ĉeno	jes

curl -s -X POST https://jenksguo.xyz/api/admin/validate \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"path":"content/corpus/projects/example.md","content":"<content>"}'

`admin_write_file` — Krei aŭ ĝisdatigi enhavan dosieron

Validigu kaj commit-u unu enhavan dosieron (krei aŭ anstataŭigi). Publikigado estas aŭtomata: CI re-tradukas ŝanĝitajn erojn en ĉiujn lingvojn, rekonstruas kaj deplojas (main → jenksguo.xyz, dev → dev.jenksguo.xyz) post kelkaj minutoj.

MCP: admin_write_file ĉe https://jenksguo.xyz/mcp/admin
REST: PUT /api/admin/file (admin token)
CLI: jenks admin put <path> <file> -m <message>

Argumento	Tipo	Postulata	Notoj
`path`	ĉeno	jes
`content`	ĉeno	jes
`message`	ĉeno	jes	Mesaĝo de commit
`branch`	`main` · `dev`	ne	main publikigas al jenksguo.xyz; dev antaŭmontras sur dev.jenksguo.xyz (defaŭlte main).

curl -s -X PUT https://jenksguo.xyz/api/admin/file \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"path":"content/corpus/projects/example.md","content":"<content>","message":"<message>"}'

`admin_delete_file` — Forigi enhavan dosieron

Forigu unu enhavan dosieron (ekz. forigu eron) kun mesaĝo de commit. Git-historio tenas ĝin reakirebla.

MCP: admin_delete_file ĉe https://jenksguo.xyz/mcp/admin
REST: DELETE /api/admin/file?path=&message=&branch= (admin token)
CLI: jenks admin rm <path> -m <message>

Argumento	Tipo	Postulata	Notoj
`path`	ĉeno	jes
`message`	ĉeno	jes
`branch`	`main` · `dev`	ne	main publikigas al jenksguo.xyz; dev antaŭmontras sur dev.jenksguo.xyz (defaŭlte main).

curl -s -X DELETE https://jenksguo.xyz/api/admin/file \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"path":"content/corpus/projects/example.md","message":"<message>"}'

`admin_commit_changes` — Commit-i plurajn dosierojn samtempe

Validigu kaj commit-u plurajn dosierŝanĝojn kiel UNU commit. Ĉiu ŝanĝo estas {path, content} aŭ {path, delete: true}.

MCP: admin_commit_changes ĉe https://jenksguo.xyz/mcp/admin
REST: POST /api/admin/changes (admin token)
CLI: jenks admin commit <changes.json> -m <message>

Argumento	Tipo	Postulata	Notoj
`changes`	aro	jes
`message`	ĉeno	jes
`branch`	`main` · `dev`	ne	main publikigas al jenksguo.xyz; dev antaŭmontras sur dev.jenksguo.xyz (defaŭlte main).

curl -s -X POST https://jenksguo.xyz/api/admin/changes \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"changes":"<changes>","message":"<message>"}'

`admin_ai_edit` — Skizi redakton per AI

Petu la modelon de la retejo reskribi unu enhavan dosieron el simpla-angla instrukcio. Redonas la proponitan enhavon, diferencon kaj validigajn problemojn. NE commit-as — reviziu, poste voku admin_write_file.

MCP: admin_ai_edit ĉe https://jenksguo.xyz/mcp/admin
REST: POST /api/admin/ai-edit (admin token)
CLI: jenks admin ai-edit <slug|path> "<instruction>" [--apply]

Argumento	Tipo	Postulata	Notoj
`path`	ĉeno	ne
`slug`	ĉeno	ne
`instruction`	ĉeno	jes
`branch`	`main` · `dev`	ne	main publikigas al jenksguo.xyz; dev antaŭmontras sur dev.jenksguo.xyz (defaŭlte main).
`content`	ĉeno	ne	Laŭvola nekonservita dosierteksto por skizi el ĝi (defaŭlte: la konservita dosiero).

curl -s -X POST https://jenksguo.xyz/api/admin/ai-edit \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"instruction":"<instruction>"}'

`admin_deploy_status` — Deplojstato

Lastatempaj CI-ruladoj (translate → build → deploy) kun stato, branĉo, commit kaj ligiloj.

MCP: admin_deploy_status ĉe https://jenksguo.xyz/mcp/admin
REST: GET /api/admin/deploys?branch= (admin token)
CLI: jenks admin deploys

Argumento	Tipo	Postulata	Notoj
`branch`	`main` · `dev`	ne	main publikigas al jenksguo.xyz; dev antaŭmontras sur dev.jenksguo.xyz (defaŭlte main).

curl -s "https://jenksguo.xyz/api/admin/deploys" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

`admin_promote` — Promocii dev al produktado

Kunfandu la dev-branĉon en main, publikigante ĉion antaŭmontritan en dev.jenksguo.xyz al jenksguo.xyz.

MCP: admin_promote ĉe https://jenksguo.xyz/mcp/admin
REST: POST /api/admin/promote (admin token)
CLI: jenks admin promote

Argumento	Tipo	Postulata	Notoj
`message`	ĉeno	ne

curl -s -X POST https://jenksguo.xyz/api/admin/promote \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{}'

.mdĈi tiu paĝo estas tradukita kun helpo de AI; oficialaj titoloj restas en la angla.

Admin-API

admin_schema — Enhava skemo

admin_list_files — Listigi enhavajn dosierojn

admin_read_file — Legi enhavan dosieron

admin_validate — Validigi ŝanĝon

admin_write_file — Krei aŭ ĝisdatigi enhavan dosieron

admin_delete_file — Forigi enhavan dosieron

admin_commit_changes — Commit-i plurajn dosierojn samtempe

admin_ai_edit — Skizi redakton per AI

admin_deploy_status — Deplojstato

admin_promote — Promocii dev al produktado