You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
SKILL.md is the file an agent reads before it writes anything, and its
"Which origin you are talking to" section taught the coarse question. It
now teaches both: which tracker (jira | linear | gadak) and where it runs
(local | remote), with the paired workspace named as the case worth
remembering — gadak, remote, no Atlassian credential anywhere. `kind` is
still documented, as the older field to fall back on when a gadak is too
old to send the pair.
That section also said the durable file is `origin/issuetap.yaml`. It has
been `.db` since the persist migration; the sentence was simply stale.
README (both), CONCEPT, MIRROR, INSTALL, CONFIGURATION, NETWORK, FAQ,
RECIPES, AGENT_SETUP, SECURITY, the specs, the site and this repo's own
CLAUDE.md follow. `docs/decisions/` and CHANGELOG do not: those are
history, and history is not revised.
The `standalone-jira:` / `standalone-confluence:` id prefixes in
data-model.md stay exactly as they are — they are stored bytes, not
vocabulary.
GDK-1282 (epic GDK-1278). Gates: go, doc-checks.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: docs/CONFIGURATION.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -459,9 +459,9 @@ is nothing to say, and a client-supplied value is ignored.
459
459
|`confluence`| object or absent | absent = wiki mirror off. `gadak init --local` writes the block scoped to `LOC`| Settings → Sources / `gadak config set confluence`| Next Confluence pass |
460
460
|`linear`| object or absent | absent = Linear source off. `apiKey` (personal API key, sent bare in the Authorization header) turns the source on; writes to Linear-owned keys route through it | edit `config.json` (no Settings surface yet) | Next `sync --source linear`|
461
461
|`linear.teamIds`| string[]|`[]` = every team the key can see; team UUIDs restrict the mirror scope | edit `config.json`| Next Linear pass |
462
-
|`devStatus`| bool |**false**|`gadak config set devStatus true` / `config.json` (not on Settings UI or Settings PUT) | Next sync; connected Cloud: mirror Jira's development-status API into `dev_links` (one extra request per issue). Standalone always fetches; `gadak dev link` / `dev scan` write the same table |
463
-
|`actor`| object or absent | absent = no acting identity; env `GADAK_ACTOR` (`slug\|display name`) overrides, and Claude Code sessions are auto-detected when both are unset |`gadak config set actor 'slug\|display name'` / `config.json` (not on Settings UI or Settings PUT; never team-exported) | Next origin session; writes to an issuetap origin (standalone/paired) carry `X-Issuetap-Actor` and attribute to that agent account. Never sent to connected Jira/Linear |
464
-
|`locale`| string |_(empty)_ = English; `en`\|`ko`\|`ja`\|`de`|`gadak config set locale ko` / `config.json` (not on Settings UI or Settings PUT) |Standalone only: the origin's display-name language — status / issue-type / field names and agent aliases follow it; priority names stay English, like a live Cloud site. Changing it rebuilds the mirror on the next sync (display names are cached). A connected workspace ignores it: its language is the Atlassian account's |
462
+
|`devStatus`| bool |**false**|`gadak config set devStatus true` / `config.json` (not on Settings UI or Settings PUT) | Next sync; connected Cloud: mirror Jira's development-status API into `dev_links` (one extra request per issue). A gadak origin always fetches; `gadak dev link` / `dev scan` write the same table |
463
+
|`actor`| object or absent | absent = no acting identity; env `GADAK_ACTOR` (`slug\|display name`) overrides, and Claude Code sessions are auto-detected when both are unset |`gadak config set actor 'slug\|display name'` / `config.json` (not on Settings UI or Settings PUT; never team-exported) | Next origin session; writes to a gadak origin (local or paired) carry `X-Issuetap-Actor` and attribute to that agent account. Never sent to connected Jira/Linear |
464
+
|`locale`| string |_(empty)_ = English; `en`\|`ko`\|`ja`\|`de`|`gadak config set locale ko` / `config.json` (not on Settings UI or Settings PUT) |A gadak origin only: the origin's display-name language — status / issue-type / field names and agent aliases follow it; priority names stay English, like a live Cloud site. Changing it rebuilds the mirror on the next sync (display names are cached). A connected workspace ignores it: its language is the Atlassian account's |
465
465
|`confluence.spaces`| string[]|`[]` = every *global* space; personal spaces only if named (`internal/config/config.go`) | Settings → Sources / `gadak config set confluence.spaces`| Next Confluence pass |
466
466
|`terminal`|`{shell, workingDir, scrollback, cursorBlink}`| absent = all defaults (see below) |`gadak config set terminal` or `terminal.<leaf>` (not on Settings UI or Settings PUT; never team-exported — shell and workingDir are this machine's paths) | Next terminal session create; a block set replaces the whole object, a leaf set merges |
467
467
@@ -652,7 +652,7 @@ into `fields`.
652
652
watches, favorites, and recents (`cmd/gadak/export.go`; help in
653
653
`cmd/gadak/help.go`). Credentials never appear in the file — a credential-shaped
654
654
string is refused (`secretscan`). It is not a `gadak team export` file (team
655
-
settings live in that other command) and it does not include the standalone
655
+
settings live in that other command) and it does not include the gadak-origin
656
656
persist file (`origin/issuetap.db`) or the issue rows in `gadak.db`.
657
657
658
658
`gadak import <FILE>` restores those four lists. On a name/key conflict the
@@ -717,8 +717,8 @@ against `/myself` before anything is written.
717
717
| --- | --- |
718
718
|`$GADAK_HOME/config.json` or `~/.gadak/config.json`| Settings + credential (0600) |
719
719
|`$GADAK_HOME/gadak.db`| SQLite mirror (a cache; the next sync rebuilds it from the origin) |
720
-
|`$GADAK_HOME/origin/issuetap.db`|Standalone origin persist (`internal/origin/origin.go``PersistRel`). SQLite (WAL); this is the record on a standalone workspace. Copy while gadak is not running (include `-wal`/`-shm`), or `sqlite3 <db> ".backup"`. Absent on a connected workspace. A sibling `origin/issuetap.yaml` is a one-shot seed if the db is missing. |
721
-
|`~/.gadak/profiles/<name>/`| Isolated config + mirror (and, on standalone, persist) per profile |
720
+
|`$GADAK_HOME/origin/issuetap.db`|A gadak origin's persist file (`internal/origin/origin.go``PersistRel`). SQLite (WAL); this is the record on a workspace whose origin is gadak's own tracker. Copy while gadak is not running (include `-wal`/`-shm`), or `sqlite3 <db> ".backup"`. Absent on a connected workspace. A sibling `origin/issuetap.yaml` is a one-shot seed if the db is missing. |
721
+
|`~/.gadak/profiles/<name>/`| Isolated config + mirror (and, on a gadak origin, persist) per profile |
722
722
723
723
Never write issue rows into the DB by hand — the next sync overwrites them. The
724
724
supported external write table is `enrichments` (see [PLUGINS.md](PLUGINS.md)).
0 commit comments