Merge pull request #111 from baalimago/feat/minor-tweaks

Features of note:
* There's a notification via `\a` bell character
* Added `clai confdir` which simply returns path to conf dir
* Moved context shell to system prompt instead of user message. This is to make indexing easier

Author: baalimago

AGENTS.md

@@ -5,7 +5,6 @@ You're working on a project called "clai".
 ## Always read:
 
 - ./main.go - This contains usage which gives a functional overview
-- ./main_test.go - This contains goldenfile tests, which explains functionality in further detail
 - ./go.mod - This shows which libraries are used, do not add additional third party libraries
 - ./architecture - This is a directory with many files explaining the architecture of sub-features. Read the document regarding the feature you wish to know more about.
 

architecture/CHAT.md architecture/chat.mdarchitecture/CHAT.md renamed to architecture/chat.md

@@ -25,7 +25,7 @@ The file is automatically created with defaults if missing.
 
 ### Theme fields
 
-All fields are raw ANSI escape sequences represented as JSON strings.
+All colour fields are raw ANSI escape sequences represented as JSON strings.
 
 | Field | Purpose |
 |------:|---------|
@@ -36,9 +36,27 @@ All fields are raw ANSI escape sequences represented as JSON strings.
 | `roleUser` | Colour for `user` role labels. |
 | `roleTool` | Colour for `tool` role labels. |
 | `roleOther` | Fallback colour for any other/unknown role. |
+| `notificationBell` | Whether clai should emit terminal BEL (`\a`) after successful task completion. |
 
 Defaults are chosen to match the existing `AttemptPrettyPrint` role palette (system=blue, user=cyan, tool=magenta).
 
+Example:
+
+```json
+{
+  "primary": "\u001b[38;2;110;130;150m",
+  "secondary": "\u001b[38;2;140;165;190m",
+  "breadtext": "\u001b[38;2;200;210;220m",
+  "roleSystem": "\u001b[34m",
+  "roleUser": "\u001b[36m",
+  "roleTool": "\u001b[35m",
+  "roleOther": "\u001b[34m",
+  "notificationBell": true
+}
+```
+
+`notificationBell` is intended for terminal/tmux attention behavior. Depending on terminal and tmux configuration, BEL may produce an audible bell, visual flash, or other attention marker.
+
 ## Disabling colour: `NO_COLOR`
 
 clai follows the common `NO_COLOR` convention (see also `main.go` usage text).
@@ -84,6 +102,14 @@ All colouring is applied via `utils.Colorize(...)`, so it automatically respects
 - Table rows: `theme.breadtext`
 - Interactive prompt line: `theme.secondary`
 
+### 4) Completion notification
+
+After a successful task/query completes, clai may emit terminal BEL depending on `theme.notificationBell`.
+
+Implementation:
+- `main.go:triggerCompletionNotification()`
+- `internal/utils.NotificationBellEnabled()`
+
 ## Customization
 
 To customize colours, edit:

architecture/COLOURS.md architecture/colours.mdarchitecture/COLOURS.md renamed to architecture/colours.md

@@ -111,7 +111,7 @@ Stored under:
 - `<config>/conversations/globalScope.json` (global reply context)
 - `<config>/conversations/dirs/*` (directory-scoped binding metadata)
 
-These are described in `architecture/CHAT.md`.
+These are described in `architecture/chat.md`.
 
 They aren’t traditional config, but they influence prompt assembly (`-re`, `-dre`, `chat continue`, etc.).
 

architecture/CONFIG.md architecture/config.mdarchitecture/CONFIG.md renamed to architecture/config.md

@@ -28,7 +28,7 @@ main.go:run()
 | `internal/dre.go` | Implements the `dre` command querier (`dreQuerier`) |
 | `internal/chat/replay.go` | `Replay(raw, dirScoped)` + `replayDirScoped` |
 | `internal/chat/dirscope.go` | Directory binding storage + lookup (`LoadDirScope`) |
-| `architecture/CHAT.md` | Background: how conversations and dir bindings work |
+| `architecture/chat.md` | Background: how conversations and dir bindings work |
 
 ## How it finds the conversation