Skip to content

armgit / Ix

Public Imported from GitHub
0

Understand any codebase instantly. System intelligence for codebases, built for humans and AI.

docs: document IX_PATCH_ACTOR

KageBinary1280d41fa675
diff --git a/docs-site/src/content/docs/reference/configuration.md b/docs-site/src/content/docs/reference/configuration.md
index e0f922a9..5ec387c6 100644
--- a/docs-site/src/content/docs/reference/configuration.md
+++ b/docs-site/src/content/docs/reference/configuration.md
@@ -25,6 +25,7 @@ ix config set format llm # set a value
| `IX_COMMIT_BASE_REV_RETRIES=<n>` | Re-sends of a commit after another writer on the same backend moved the graph revision under it (default 8) |
| `IX_PARSE_BUDGET_MS=<ms>` | How long `ix map` / `ix ingest` may spend parsing one file before skipping it and naming it in the summary (default 10000). A skipped file is tried again on every run, and `ix status` warns about it until it is in the graph. `0` turns the budget off |
| `IX_PARSE_WORKERS=<n>` | Most parse workers `ix map` / `ix ingest` starts (default 8, never more than the cores less one). Workers start as files need them, one per 50 files |
+| `IX_PATCH_ACTOR=<actor>` | The `actor` stamped on each graph patch `ix map` / `ix ingest` sends (default `ix/ingestion`; `ix ingest --github` uses `ix/github-ingest`). Set it to empty (`IX_PATCH_ACTOR=`) for a backend that authenticates writers and stamps the verified principal itself: such a backend rejects a non-empty actor that differs from the principal with 403 `body actor ... conflicts with verified principal`. Any other value is sent as the actor |
### Bootstrap script variables
diff --git a/skills/ix/references/troubleshooting.md b/skills/ix/references/troubleshooting.md
index dba49c2d..f6fc19aa 100644
--- a/skills/ix/references/troubleshooting.md
+++ b/skills/ix/references/troubleshooting.md
@@ -67,6 +67,12 @@ again.
- `IX_PARSE_WORKERS=N` — the most parse workers `ix map` / `ix ingest` starts
(default 8, never more than the cores less one). Each loads every grammar,
so a small edit starts one; raise it for a faster first map on a large machine.
+- `IX_PATCH_ACTOR=<actor>` — the `actor` on each graph patch `ix map` / `ix ingest`
+ sends (default `ix/ingestion`; GitHub ingest uses `ix/github-ingest`). Set it
+ empty (`IX_PATCH_ACTOR=`) for a backend that authenticates writers and stamps
+ the verified principal itself; such a backend answers 403 `body actor ...
+ conflicts with verified principal` to a non-empty actor that differs from it.
+ Any other value is sent as the actor.
## Harness presence (hermetic reproduction)