@vectorize-io/hindsight-coding-agents 0.3.0 → 0.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +28 -0
- package/dist/antigravity-hook.js +32 -6
- package/dist/antigravity-statusline.js +124 -98
- package/dist/antigravity-stop-hook.js +32 -6
- package/dist/claude-hook.js +32 -6
- package/dist/claude-sessionstart-hook.js +32 -6
- package/dist/claude-stop-hook.js +32 -6
- package/dist/cline.js +131 -101
- package/dist/codex-hook.js +32 -6
- package/dist/codex-sessionstart-hook.js +32 -6
- package/dist/codex-stop-hook.js +32 -6
- package/dist/copilot-hook.js +32 -6
- package/dist/copilot-sessionstart-hook.js +32 -6
- package/dist/copilot-stop-hook.js +32 -6
- package/dist/cursor-hook.js +32 -6
- package/dist/cursor-sessionstart-hook.js +32 -6
- package/dist/cursor-stop-hook.js +32 -6
- package/dist/daemon-start.js +24 -12
- package/dist/deepen.js +32 -6
- package/dist/devin-hook.js +32 -6
- package/dist/devin-sessionstart-hook.js +32 -6
- package/dist/devin-stop-hook.js +32 -6
- package/dist/grok-hook.js +32 -6
- package/dist/grok-sessionstart-hook.js +32 -6
- package/dist/grok-stop-hook.js +32 -6
- package/dist/hindsight-seed.js +108 -96
- package/dist/index.js +36 -6
- package/dist/kilo.js +36 -6
- package/dist/mcp-server.js +127 -101
- package/dist/prime-agent.js +32 -6
- package/dist/status.js +31 -5
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -277,6 +277,32 @@ The map-valued settings (`mapPathToBank`, `harnesses`, `banks`, `retainMetadata`
|
|
|
277
277
|
per-key branching doesn't survive flattening into one variable. `maxParallelRetains` is available
|
|
278
278
|
as `HINDSIGHT_MAX_PARALLEL_RETAINS` for containers and CI.
|
|
279
279
|
|
|
280
|
+
### Opt-in only
|
|
281
|
+
|
|
282
|
+
By default every project gets memory — that is what makes the plugin zero-setup. If you would
|
|
283
|
+
rather nothing be remembered until you say so, turn memory off everywhere and name the projects
|
|
284
|
+
that may use it:
|
|
285
|
+
|
|
286
|
+
```jsonc
|
|
287
|
+
{
|
|
288
|
+
"optInOnly": true,
|
|
289
|
+
"optInPaths": ["~/work/client-x", "~/oss"],
|
|
290
|
+
}
|
|
291
|
+
```
|
|
292
|
+
|
|
293
|
+
Anything outside those paths is **inert**: no bank is created, nothing is retained, no seed runs,
|
|
294
|
+
and the agent behaves exactly as it would without the plugin. Approving costs nothing else —
|
|
295
|
+
`optInPaths` says _which projects_, not _which bank_, so an approved repo keeps its usual
|
|
296
|
+
`coding-agent::{gitProject}` name. Paths are prefixes, so approving `~/work` approves every repo
|
|
297
|
+
under it while each still gets its own bank.
|
|
298
|
+
|
|
299
|
+
A `mapPathToBank` entry counts as opted in too, since routing a path to a named bank already
|
|
300
|
+
declares that project. A bare `bankId` does not: it names a bank rather than a project, so it
|
|
301
|
+
cannot say which work may be remembered, and a privacy switch has to fail closed.
|
|
302
|
+
|
|
303
|
+
There is no per-repo opt-in file, for the same reason there is no repo-carried config at all: a
|
|
304
|
+
cloned repository must not be able to turn memory on.
|
|
305
|
+
|
|
280
306
|
There is deliberately no repo-carried config file — per-repo bank routing is `mapPathToBank`,
|
|
281
307
|
per-agent differences are `harnesses.<name>`.
|
|
282
308
|
|
|
@@ -303,6 +329,8 @@ hook by Codex...), so one shared config serves several agents side by side:
|
|
|
303
329
|
| `dynamicBankId` | dynamic iff no `bankId` | force dynamic (`true`) or static (`false`) resolution |
|
|
304
330
|
| `bankIdTemplate` | `"coding-agent::{gitProject}"` | dynamic bank id format; the default makes every agent share one bank per repo |
|
|
305
331
|
| `mapPathToBank` | — | absolute path → bank; **longest prefix wins**; overrides everything |
|
|
332
|
+
| `optInOnly` | `false` | run memory ONLY in opted-in projects — everything else is inert, with no bank created; see [Opt-in only](#opt-in-only) |
|
|
333
|
+
| `optInPaths` | — | directories opted in, matched as prefixes with `~` expanded; each repo beneath keeps its own dynamic bank |
|
|
306
334
|
| `resolveWorktrees` | `true` | `{gitProject}`: linked worktrees share the main repo's bank |
|
|
307
335
|
| `retainTags` | — | extra tags on every document written by the integration, e.g. `["project:{gitProject}"]` — see **Recording where a memory came from** below |
|
|
308
336
|
| `retainMetadata` | — | extra metadata on every document written by the integration, e.g. `{"repo": "{gitProject}"}` |
|
package/dist/antigravity-hook.js
CHANGED
|
@@ -68,18 +68,32 @@ function gitProjectName(directory, resolveWorktrees) {
|
|
|
68
68
|
}
|
|
69
69
|
return dirName(directory);
|
|
70
70
|
}
|
|
71
|
+
function configuredDir(dir) {
|
|
72
|
+
const expanded = dir === "~" || dir.startsWith("~/") ? join(homedir(), dir.slice(1)) : dir;
|
|
73
|
+
return normalize(expanded).replace(new RegExp(`\\${sep}+$`), "");
|
|
74
|
+
}
|
|
75
|
+
function isWithin(directory, configured) {
|
|
76
|
+
return directory === configured || directory.startsWith(configured + sep);
|
|
77
|
+
}
|
|
71
78
|
function mapLookup(map, directory) {
|
|
72
79
|
const cwd = normalize(directory);
|
|
73
80
|
let best;
|
|
74
81
|
for (const [dir, bank] of Object.entries(map)) {
|
|
75
|
-
const
|
|
76
|
-
|
|
77
|
-
if (cwd === p || cwd.startsWith(p + sep)) {
|
|
82
|
+
const p = configuredDir(dir);
|
|
83
|
+
if (isWithin(cwd, p)) {
|
|
78
84
|
if (!best || p.length > best.len) best = { len: p.length, bank };
|
|
79
85
|
}
|
|
80
86
|
}
|
|
81
87
|
return best?.bank;
|
|
82
88
|
}
|
|
89
|
+
function isOptedIn(config, directory) {
|
|
90
|
+
if (!config.optInOnly) return true;
|
|
91
|
+
if (!directory) return false;
|
|
92
|
+
const cwd = normalize(directory);
|
|
93
|
+
if ((config.optInPaths ?? []).some((dir) => dir && isWithin(cwd, configuredDir(dir))))
|
|
94
|
+
return true;
|
|
95
|
+
return Boolean(config.mapPathToBank && mapLookup(config.mapPathToBank, directory));
|
|
96
|
+
}
|
|
83
97
|
function deriveBankId(config, directory, harness = "coding") {
|
|
84
98
|
const mapped = directory && config.mapPathToBank ? mapLookup(config.mapPathToBank, directory) : void 0;
|
|
85
99
|
if (mapped) return mapped;
|
|
@@ -157,6 +171,9 @@ function resolveConfig(raw = {}) {
|
|
|
157
171
|
bankIdTemplate: raw.bankIdTemplate,
|
|
158
172
|
mapPathToBank: raw.mapPathToBank,
|
|
159
173
|
resolveWorktrees: raw.resolveWorktrees,
|
|
174
|
+
optInOnly: raw.optInOnly ?? false,
|
|
175
|
+
// Same shape as retainTags: a config typo must not become a path that silently approves nothing.
|
|
176
|
+
optInPaths: Array.isArray(raw.optInPaths) ? raw.optInPaths.filter((p) => typeof p === "string" && p.trim() !== "") : [],
|
|
160
177
|
harness: raw.harness ?? "opencode",
|
|
161
178
|
disabled: raw.disabled ?? false,
|
|
162
179
|
retainSessions: raw.retainSessions ?? true,
|
|
@@ -217,6 +234,8 @@ var ENV_KEYS = {
|
|
|
217
234
|
dynamicBankId: "HINDSIGHT_DYNAMIC_BANK_ID",
|
|
218
235
|
bankIdTemplate: "HINDSIGHT_BANK_ID_TEMPLATE",
|
|
219
236
|
resolveWorktrees: "HINDSIGHT_RESOLVE_WORKTREES",
|
|
237
|
+
optInOnly: "HINDSIGHT_OPT_IN_ONLY",
|
|
238
|
+
optInPaths: "HINDSIGHT_OPT_IN_PATHS",
|
|
220
239
|
harness: "HINDSIGHT_HARNESS",
|
|
221
240
|
disabled: "HINDSIGHT_DISABLED",
|
|
222
241
|
retainSessions: "HINDSIGHT_RETAIN_SESSIONS",
|
|
@@ -239,13 +258,14 @@ var ENV_KEYS = {
|
|
|
239
258
|
var ENV_BOOLEANS = /* @__PURE__ */ new Set([
|
|
240
259
|
"dynamicBankId",
|
|
241
260
|
"resolveWorktrees",
|
|
261
|
+
"optInOnly",
|
|
242
262
|
"disabled",
|
|
243
263
|
"retainSessions",
|
|
244
264
|
"autoReflect",
|
|
245
265
|
"autoSeed",
|
|
246
266
|
"codebaseSurvey"
|
|
247
267
|
]);
|
|
248
|
-
var ENV_LISTS = /* @__PURE__ */ new Set(["retainTags"]);
|
|
268
|
+
var ENV_LISTS = /* @__PURE__ */ new Set(["retainTags", "optInPaths"]);
|
|
249
269
|
var ENV_NUMBERS = /* @__PURE__ */ new Set([
|
|
250
270
|
"apiPort",
|
|
251
271
|
"daemonIdleTimeout",
|
|
@@ -289,9 +309,15 @@ var BANK_OVERRIDE_EXCLUDED = [
|
|
|
289
309
|
"mapPathToBank",
|
|
290
310
|
"dynamicBankId",
|
|
291
311
|
"resolveWorktrees",
|
|
312
|
+
// Approval is decided BEFORE the bank is resolved, so a `banks.<id>` section naming these could
|
|
313
|
+
// only ever arrive too late to matter — strip them rather than let them read as effective.
|
|
314
|
+
"optInOnly",
|
|
315
|
+
"optInPaths",
|
|
292
316
|
"harness"
|
|
293
317
|
];
|
|
294
|
-
function applyBankConfig(cfg, resolvedId) {
|
|
318
|
+
function applyBankConfig(cfg, resolvedId, directory) {
|
|
319
|
+
if (directory !== void 0 && !isOptedIn(cfg, directory))
|
|
320
|
+
return { cfg: { ...cfg, disabled: true }, bankId: resolvedId };
|
|
295
321
|
const section = cfg.banks[resolvedId];
|
|
296
322
|
if (!section) return { cfg, bankId: resolvedId };
|
|
297
323
|
const safe = { ...section };
|
|
@@ -1204,7 +1230,7 @@ async function runHook(spec, makeClient = (o) => new HindsightClient(o)) {
|
|
|
1204
1230
|
return;
|
|
1205
1231
|
}
|
|
1206
1232
|
const out = (context, notice) => process.stdout.write(JSON.stringify(spec.emit(context ?? "", notice, ev)));
|
|
1207
|
-
const resolved = applyBankConfig(cfg, deriveBankId(cfg, cwd, spec.harness));
|
|
1233
|
+
const resolved = applyBankConfig(cfg, deriveBankId(cfg, cwd, spec.harness), cwd);
|
|
1208
1234
|
cfg = resolved.cfg;
|
|
1209
1235
|
const bankId = resolved.bankId;
|
|
1210
1236
|
if (cfg.disabled) {
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
// src/core/config.ts
|
|
4
4
|
import { readFileSync } from "fs";
|
|
5
|
-
import { homedir } from "os";
|
|
6
|
-
import { join as
|
|
5
|
+
import { homedir as homedir2 } from "os";
|
|
6
|
+
import { join as join3 } from "path";
|
|
7
7
|
|
|
8
8
|
// src/core/seed.ts
|
|
9
9
|
import { spawn as realSpawn } from "child_process";
|
|
@@ -11,8 +11,114 @@ import { dirname, join } from "path";
|
|
|
11
11
|
import { fileURLToPath } from "url";
|
|
12
12
|
var DEFAULT_SEED_LIMIT = 300;
|
|
13
13
|
|
|
14
|
+
// src/core/bank.ts
|
|
15
|
+
import { execFileSync } from "child_process";
|
|
16
|
+
import { existsSync } from "fs";
|
|
17
|
+
import { homedir } from "os";
|
|
18
|
+
import { basename, dirname as dirname2, join as join2, normalize, sep } from "path";
|
|
19
|
+
|
|
20
|
+
// src/core/template.ts
|
|
21
|
+
var PLACEHOLDER = /\{([a-zA-Z_]+)\}/g;
|
|
22
|
+
function applyTemplate(template, resolvers, what) {
|
|
23
|
+
return template.replace(PLACEHOLDER, (_, name) => {
|
|
24
|
+
const resolve = resolvers[name];
|
|
25
|
+
if (!resolve) {
|
|
26
|
+
console.error(
|
|
27
|
+
`hindsight: unknown ${what} placeholder "{${name}}" \u2014 valid: ` + Object.keys(resolvers).sort().map((k) => `{${k}}`).join(", ")
|
|
28
|
+
);
|
|
29
|
+
return "unknown";
|
|
30
|
+
}
|
|
31
|
+
return resolve();
|
|
32
|
+
});
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
// src/core/bank.ts
|
|
36
|
+
var DEFAULT_BANK_NAME = "coding";
|
|
37
|
+
var DEFAULT_TEMPLATE = "coding-agent::{gitProject}";
|
|
38
|
+
function getProjectRootFromGit(directory) {
|
|
39
|
+
if (!directory) return null;
|
|
40
|
+
try {
|
|
41
|
+
const commonDir = execFileSync(
|
|
42
|
+
"git",
|
|
43
|
+
["rev-parse", "--path-format=absolute", "--git-common-dir"],
|
|
44
|
+
{ cwd: directory, encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"], timeout: 1e3 }
|
|
45
|
+
).trim();
|
|
46
|
+
if (!commonDir) return null;
|
|
47
|
+
return basename(commonDir) === ".git" ? dirname2(commonDir) : commonDir;
|
|
48
|
+
} catch {
|
|
49
|
+
return null;
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
var PROJECT_ROOT_ENV = ["CLAUDE_PROJECT_DIR"];
|
|
53
|
+
function nearestExistingDir(directory) {
|
|
54
|
+
let current = directory;
|
|
55
|
+
while (current) {
|
|
56
|
+
if (existsSync(current)) return current;
|
|
57
|
+
const parent = dirname2(current);
|
|
58
|
+
if (parent === current) return "";
|
|
59
|
+
current = parent;
|
|
60
|
+
}
|
|
61
|
+
return "";
|
|
62
|
+
}
|
|
63
|
+
function dirName(directory) {
|
|
64
|
+
return directory && basename(directory) || "unknown";
|
|
65
|
+
}
|
|
66
|
+
function gitProjectName(directory, resolveWorktrees) {
|
|
67
|
+
if (resolveWorktrees) {
|
|
68
|
+
const candidates = [
|
|
69
|
+
nearestExistingDir(directory),
|
|
70
|
+
...PROJECT_ROOT_ENV.map((v) => process.env[v] || "")
|
|
71
|
+
];
|
|
72
|
+
for (const candidate of candidates) {
|
|
73
|
+
const root = candidate ? getProjectRootFromGit(candidate) : null;
|
|
74
|
+
if (root) return basename(root);
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
return dirName(directory);
|
|
78
|
+
}
|
|
79
|
+
function configuredDir(dir) {
|
|
80
|
+
const expanded = dir === "~" || dir.startsWith("~/") ? join2(homedir(), dir.slice(1)) : dir;
|
|
81
|
+
return normalize(expanded).replace(new RegExp(`\\${sep}+$`), "");
|
|
82
|
+
}
|
|
83
|
+
function isWithin(directory, configured) {
|
|
84
|
+
return directory === configured || directory.startsWith(configured + sep);
|
|
85
|
+
}
|
|
86
|
+
function mapLookup(map, directory) {
|
|
87
|
+
const cwd = normalize(directory);
|
|
88
|
+
let best;
|
|
89
|
+
for (const [dir, bank] of Object.entries(map)) {
|
|
90
|
+
const p = configuredDir(dir);
|
|
91
|
+
if (isWithin(cwd, p)) {
|
|
92
|
+
if (!best || p.length > best.len) best = { len: p.length, bank };
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
return best?.bank;
|
|
96
|
+
}
|
|
97
|
+
function isOptedIn(config, directory) {
|
|
98
|
+
if (!config.optInOnly) return true;
|
|
99
|
+
if (!directory) return false;
|
|
100
|
+
const cwd = normalize(directory);
|
|
101
|
+
if ((config.optInPaths ?? []).some((dir) => dir && isWithin(cwd, configuredDir(dir))))
|
|
102
|
+
return true;
|
|
103
|
+
return Boolean(config.mapPathToBank && mapLookup(config.mapPathToBank, directory));
|
|
104
|
+
}
|
|
105
|
+
function deriveBankId(config, directory, harness = "coding") {
|
|
106
|
+
const mapped = directory && config.mapPathToBank ? mapLookup(config.mapPathToBank, directory) : void 0;
|
|
107
|
+
if (mapped) return mapped;
|
|
108
|
+
const dynamic = config.dynamicBankId ?? !config.bankId;
|
|
109
|
+
if (!dynamic) return config.bankId || DEFAULT_BANK_NAME;
|
|
110
|
+
const resolvers = {
|
|
111
|
+
harness: () => harness,
|
|
112
|
+
project: () => dirName(directory),
|
|
113
|
+
gitProject: () => gitProjectName(directory, config.resolveWorktrees ?? true),
|
|
114
|
+
channel: () => process.env.HINDSIGHT_CHANNEL_ID || "default",
|
|
115
|
+
user: () => process.env.HINDSIGHT_USER_ID || "anonymous"
|
|
116
|
+
};
|
|
117
|
+
return applyTemplate(config.bankIdTemplate || DEFAULT_TEMPLATE, resolvers, "bankIdTemplate");
|
|
118
|
+
}
|
|
119
|
+
|
|
14
120
|
// src/core/config.ts
|
|
15
|
-
var CONFIG_PATH = process.env.HINDSIGHT_CONFIG ||
|
|
121
|
+
var CONFIG_PATH = process.env.HINDSIGHT_CONFIG || join3(homedir2(), ".hindsight", "coding-agent.json");
|
|
16
122
|
var DEFAULT_DAEMON_PORT = 9077;
|
|
17
123
|
var DEFAULT_DAEMON_IDLE_TIMEOUT = 300;
|
|
18
124
|
var DEFAULT_DAEMON_PROFILE = "coding-agent";
|
|
@@ -36,6 +142,9 @@ function resolveConfig(raw = {}) {
|
|
|
36
142
|
bankIdTemplate: raw.bankIdTemplate,
|
|
37
143
|
mapPathToBank: raw.mapPathToBank,
|
|
38
144
|
resolveWorktrees: raw.resolveWorktrees,
|
|
145
|
+
optInOnly: raw.optInOnly ?? false,
|
|
146
|
+
// Same shape as retainTags: a config typo must not become a path that silently approves nothing.
|
|
147
|
+
optInPaths: Array.isArray(raw.optInPaths) ? raw.optInPaths.filter((p) => typeof p === "string" && p.trim() !== "") : [],
|
|
39
148
|
harness: raw.harness ?? "opencode",
|
|
40
149
|
disabled: raw.disabled ?? false,
|
|
41
150
|
retainSessions: raw.retainSessions ?? true,
|
|
@@ -96,6 +205,8 @@ var ENV_KEYS = {
|
|
|
96
205
|
dynamicBankId: "HINDSIGHT_DYNAMIC_BANK_ID",
|
|
97
206
|
bankIdTemplate: "HINDSIGHT_BANK_ID_TEMPLATE",
|
|
98
207
|
resolveWorktrees: "HINDSIGHT_RESOLVE_WORKTREES",
|
|
208
|
+
optInOnly: "HINDSIGHT_OPT_IN_ONLY",
|
|
209
|
+
optInPaths: "HINDSIGHT_OPT_IN_PATHS",
|
|
99
210
|
harness: "HINDSIGHT_HARNESS",
|
|
100
211
|
disabled: "HINDSIGHT_DISABLED",
|
|
101
212
|
retainSessions: "HINDSIGHT_RETAIN_SESSIONS",
|
|
@@ -118,13 +229,14 @@ var ENV_KEYS = {
|
|
|
118
229
|
var ENV_BOOLEANS = /* @__PURE__ */ new Set([
|
|
119
230
|
"dynamicBankId",
|
|
120
231
|
"resolveWorktrees",
|
|
232
|
+
"optInOnly",
|
|
121
233
|
"disabled",
|
|
122
234
|
"retainSessions",
|
|
123
235
|
"autoReflect",
|
|
124
236
|
"autoSeed",
|
|
125
237
|
"codebaseSurvey"
|
|
126
238
|
]);
|
|
127
|
-
var ENV_LISTS = /* @__PURE__ */ new Set(["retainTags"]);
|
|
239
|
+
var ENV_LISTS = /* @__PURE__ */ new Set(["retainTags", "optInPaths"]);
|
|
128
240
|
var ENV_NUMBERS = /* @__PURE__ */ new Set([
|
|
129
241
|
"apiPort",
|
|
130
242
|
"daemonIdleTimeout",
|
|
@@ -168,9 +280,15 @@ var BANK_OVERRIDE_EXCLUDED = [
|
|
|
168
280
|
"mapPathToBank",
|
|
169
281
|
"dynamicBankId",
|
|
170
282
|
"resolveWorktrees",
|
|
283
|
+
// Approval is decided BEFORE the bank is resolved, so a `banks.<id>` section naming these could
|
|
284
|
+
// only ever arrive too late to matter — strip them rather than let them read as effective.
|
|
285
|
+
"optInOnly",
|
|
286
|
+
"optInPaths",
|
|
171
287
|
"harness"
|
|
172
288
|
];
|
|
173
|
-
function applyBankConfig(cfg, resolvedId) {
|
|
289
|
+
function applyBankConfig(cfg, resolvedId, directory) {
|
|
290
|
+
if (directory !== void 0 && !isOptedIn(cfg, directory))
|
|
291
|
+
return { cfg: { ...cfg, disabled: true }, bankId: resolvedId };
|
|
174
292
|
const section = cfg.banks[resolvedId];
|
|
175
293
|
if (!section) return { cfg, bankId: resolvedId };
|
|
176
294
|
const safe = { ...section };
|
|
@@ -190,98 +308,6 @@ function resolvePartial(cfg, patch) {
|
|
|
190
308
|
return out;
|
|
191
309
|
}
|
|
192
310
|
|
|
193
|
-
// src/core/bank.ts
|
|
194
|
-
import { execFileSync } from "child_process";
|
|
195
|
-
import { existsSync } from "fs";
|
|
196
|
-
import { homedir as homedir2 } from "os";
|
|
197
|
-
import { basename, dirname as dirname2, join as join3, normalize, sep } from "path";
|
|
198
|
-
|
|
199
|
-
// src/core/template.ts
|
|
200
|
-
var PLACEHOLDER = /\{([a-zA-Z_]+)\}/g;
|
|
201
|
-
function applyTemplate(template, resolvers, what) {
|
|
202
|
-
return template.replace(PLACEHOLDER, (_, name) => {
|
|
203
|
-
const resolve = resolvers[name];
|
|
204
|
-
if (!resolve) {
|
|
205
|
-
console.error(
|
|
206
|
-
`hindsight: unknown ${what} placeholder "{${name}}" \u2014 valid: ` + Object.keys(resolvers).sort().map((k) => `{${k}}`).join(", ")
|
|
207
|
-
);
|
|
208
|
-
return "unknown";
|
|
209
|
-
}
|
|
210
|
-
return resolve();
|
|
211
|
-
});
|
|
212
|
-
}
|
|
213
|
-
|
|
214
|
-
// src/core/bank.ts
|
|
215
|
-
var DEFAULT_BANK_NAME = "coding";
|
|
216
|
-
var DEFAULT_TEMPLATE = "coding-agent::{gitProject}";
|
|
217
|
-
function getProjectRootFromGit(directory) {
|
|
218
|
-
if (!directory) return null;
|
|
219
|
-
try {
|
|
220
|
-
const commonDir = execFileSync(
|
|
221
|
-
"git",
|
|
222
|
-
["rev-parse", "--path-format=absolute", "--git-common-dir"],
|
|
223
|
-
{ cwd: directory, encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"], timeout: 1e3 }
|
|
224
|
-
).trim();
|
|
225
|
-
if (!commonDir) return null;
|
|
226
|
-
return basename(commonDir) === ".git" ? dirname2(commonDir) : commonDir;
|
|
227
|
-
} catch {
|
|
228
|
-
return null;
|
|
229
|
-
}
|
|
230
|
-
}
|
|
231
|
-
var PROJECT_ROOT_ENV = ["CLAUDE_PROJECT_DIR"];
|
|
232
|
-
function nearestExistingDir(directory) {
|
|
233
|
-
let current = directory;
|
|
234
|
-
while (current) {
|
|
235
|
-
if (existsSync(current)) return current;
|
|
236
|
-
const parent = dirname2(current);
|
|
237
|
-
if (parent === current) return "";
|
|
238
|
-
current = parent;
|
|
239
|
-
}
|
|
240
|
-
return "";
|
|
241
|
-
}
|
|
242
|
-
function dirName(directory) {
|
|
243
|
-
return directory && basename(directory) || "unknown";
|
|
244
|
-
}
|
|
245
|
-
function gitProjectName(directory, resolveWorktrees) {
|
|
246
|
-
if (resolveWorktrees) {
|
|
247
|
-
const candidates = [
|
|
248
|
-
nearestExistingDir(directory),
|
|
249
|
-
...PROJECT_ROOT_ENV.map((v) => process.env[v] || "")
|
|
250
|
-
];
|
|
251
|
-
for (const candidate of candidates) {
|
|
252
|
-
const root = candidate ? getProjectRootFromGit(candidate) : null;
|
|
253
|
-
if (root) return basename(root);
|
|
254
|
-
}
|
|
255
|
-
}
|
|
256
|
-
return dirName(directory);
|
|
257
|
-
}
|
|
258
|
-
function mapLookup(map, directory) {
|
|
259
|
-
const cwd = normalize(directory);
|
|
260
|
-
let best;
|
|
261
|
-
for (const [dir, bank] of Object.entries(map)) {
|
|
262
|
-
const expanded = dir === "~" || dir.startsWith("~/") ? join3(homedir2(), dir.slice(1)) : dir;
|
|
263
|
-
const p = normalize(expanded).replace(new RegExp(`\\${sep}+$`), "");
|
|
264
|
-
if (cwd === p || cwd.startsWith(p + sep)) {
|
|
265
|
-
if (!best || p.length > best.len) best = { len: p.length, bank };
|
|
266
|
-
}
|
|
267
|
-
}
|
|
268
|
-
return best?.bank;
|
|
269
|
-
}
|
|
270
|
-
function deriveBankId(config, directory, harness = "coding") {
|
|
271
|
-
const mapped = directory && config.mapPathToBank ? mapLookup(config.mapPathToBank, directory) : void 0;
|
|
272
|
-
if (mapped) return mapped;
|
|
273
|
-
const dynamic = config.dynamicBankId ?? !config.bankId;
|
|
274
|
-
if (!dynamic) return config.bankId || DEFAULT_BANK_NAME;
|
|
275
|
-
const resolvers = {
|
|
276
|
-
harness: () => harness,
|
|
277
|
-
project: () => dirName(directory),
|
|
278
|
-
gitProject: () => gitProjectName(directory, config.resolveWorktrees ?? true),
|
|
279
|
-
channel: () => process.env.HINDSIGHT_CHANNEL_ID || "default",
|
|
280
|
-
user: () => process.env.HINDSIGHT_USER_ID || "anonymous"
|
|
281
|
-
};
|
|
282
|
-
return applyTemplate(config.bankIdTemplate || DEFAULT_TEMPLATE, resolvers, "bankIdTemplate");
|
|
283
|
-
}
|
|
284
|
-
|
|
285
311
|
// src/core/brand.ts
|
|
286
312
|
function brandWord() {
|
|
287
313
|
const start = [0, 116, 217];
|
|
@@ -300,7 +326,7 @@ function brandWord() {
|
|
|
300
326
|
function buildAntigravityStatusLine(state, cfg) {
|
|
301
327
|
const cwd = state.cwd || state.workspace?.current_dir;
|
|
302
328
|
if (!cwd) return brandWord();
|
|
303
|
-
const resolved = applyBankConfig(cfg, deriveBankId(cfg, cwd, "antigravity-cli"));
|
|
329
|
+
const resolved = applyBankConfig(cfg, deriveBankId(cfg, cwd, "antigravity-cli"), cwd);
|
|
304
330
|
return resolved.cfg.disabled ? "" : `${brandWord()} \xB7 ${resolved.bankId}`;
|
|
305
331
|
}
|
|
306
332
|
async function main() {
|
|
@@ -71,18 +71,32 @@ function gitProjectName(directory, resolveWorktrees) {
|
|
|
71
71
|
}
|
|
72
72
|
return dirName(directory);
|
|
73
73
|
}
|
|
74
|
+
function configuredDir(dir) {
|
|
75
|
+
const expanded = dir === "~" || dir.startsWith("~/") ? join(homedir(), dir.slice(1)) : dir;
|
|
76
|
+
return normalize(expanded).replace(new RegExp(`\\${sep}+$`), "");
|
|
77
|
+
}
|
|
78
|
+
function isWithin(directory, configured) {
|
|
79
|
+
return directory === configured || directory.startsWith(configured + sep);
|
|
80
|
+
}
|
|
74
81
|
function mapLookup(map, directory) {
|
|
75
82
|
const cwd = normalize(directory);
|
|
76
83
|
let best;
|
|
77
84
|
for (const [dir, bank] of Object.entries(map)) {
|
|
78
|
-
const
|
|
79
|
-
|
|
80
|
-
if (cwd === p || cwd.startsWith(p + sep)) {
|
|
85
|
+
const p = configuredDir(dir);
|
|
86
|
+
if (isWithin(cwd, p)) {
|
|
81
87
|
if (!best || p.length > best.len) best = { len: p.length, bank };
|
|
82
88
|
}
|
|
83
89
|
}
|
|
84
90
|
return best?.bank;
|
|
85
91
|
}
|
|
92
|
+
function isOptedIn(config, directory) {
|
|
93
|
+
if (!config.optInOnly) return true;
|
|
94
|
+
if (!directory) return false;
|
|
95
|
+
const cwd = normalize(directory);
|
|
96
|
+
if ((config.optInPaths ?? []).some((dir) => dir && isWithin(cwd, configuredDir(dir))))
|
|
97
|
+
return true;
|
|
98
|
+
return Boolean(config.mapPathToBank && mapLookup(config.mapPathToBank, directory));
|
|
99
|
+
}
|
|
86
100
|
function deriveBankId(config, directory, harness = "coding") {
|
|
87
101
|
const mapped = directory && config.mapPathToBank ? mapLookup(config.mapPathToBank, directory) : void 0;
|
|
88
102
|
if (mapped) return mapped;
|
|
@@ -134,6 +148,9 @@ function resolveConfig(raw = {}) {
|
|
|
134
148
|
bankIdTemplate: raw.bankIdTemplate,
|
|
135
149
|
mapPathToBank: raw.mapPathToBank,
|
|
136
150
|
resolveWorktrees: raw.resolveWorktrees,
|
|
151
|
+
optInOnly: raw.optInOnly ?? false,
|
|
152
|
+
// Same shape as retainTags: a config typo must not become a path that silently approves nothing.
|
|
153
|
+
optInPaths: Array.isArray(raw.optInPaths) ? raw.optInPaths.filter((p) => typeof p === "string" && p.trim() !== "") : [],
|
|
137
154
|
harness: raw.harness ?? "opencode",
|
|
138
155
|
disabled: raw.disabled ?? false,
|
|
139
156
|
retainSessions: raw.retainSessions ?? true,
|
|
@@ -194,6 +211,8 @@ var ENV_KEYS = {
|
|
|
194
211
|
dynamicBankId: "HINDSIGHT_DYNAMIC_BANK_ID",
|
|
195
212
|
bankIdTemplate: "HINDSIGHT_BANK_ID_TEMPLATE",
|
|
196
213
|
resolveWorktrees: "HINDSIGHT_RESOLVE_WORKTREES",
|
|
214
|
+
optInOnly: "HINDSIGHT_OPT_IN_ONLY",
|
|
215
|
+
optInPaths: "HINDSIGHT_OPT_IN_PATHS",
|
|
197
216
|
harness: "HINDSIGHT_HARNESS",
|
|
198
217
|
disabled: "HINDSIGHT_DISABLED",
|
|
199
218
|
retainSessions: "HINDSIGHT_RETAIN_SESSIONS",
|
|
@@ -216,13 +235,14 @@ var ENV_KEYS = {
|
|
|
216
235
|
var ENV_BOOLEANS = /* @__PURE__ */ new Set([
|
|
217
236
|
"dynamicBankId",
|
|
218
237
|
"resolveWorktrees",
|
|
238
|
+
"optInOnly",
|
|
219
239
|
"disabled",
|
|
220
240
|
"retainSessions",
|
|
221
241
|
"autoReflect",
|
|
222
242
|
"autoSeed",
|
|
223
243
|
"codebaseSurvey"
|
|
224
244
|
]);
|
|
225
|
-
var ENV_LISTS = /* @__PURE__ */ new Set(["retainTags"]);
|
|
245
|
+
var ENV_LISTS = /* @__PURE__ */ new Set(["retainTags", "optInPaths"]);
|
|
226
246
|
var ENV_NUMBERS = /* @__PURE__ */ new Set([
|
|
227
247
|
"apiPort",
|
|
228
248
|
"daemonIdleTimeout",
|
|
@@ -266,9 +286,15 @@ var BANK_OVERRIDE_EXCLUDED = [
|
|
|
266
286
|
"mapPathToBank",
|
|
267
287
|
"dynamicBankId",
|
|
268
288
|
"resolveWorktrees",
|
|
289
|
+
// Approval is decided BEFORE the bank is resolved, so a `banks.<id>` section naming these could
|
|
290
|
+
// only ever arrive too late to matter — strip them rather than let them read as effective.
|
|
291
|
+
"optInOnly",
|
|
292
|
+
"optInPaths",
|
|
269
293
|
"harness"
|
|
270
294
|
];
|
|
271
|
-
function applyBankConfig(cfg, resolvedId) {
|
|
295
|
+
function applyBankConfig(cfg, resolvedId, directory) {
|
|
296
|
+
if (directory !== void 0 && !isOptedIn(cfg, directory))
|
|
297
|
+
return { cfg: { ...cfg, disabled: true }, bankId: resolvedId };
|
|
272
298
|
const section = cfg.banks[resolvedId];
|
|
273
299
|
if (!section) return { cfg, bankId: resolvedId };
|
|
274
300
|
const safe = { ...section };
|
|
@@ -1507,7 +1533,7 @@ async function runRetainHook(spec, makeClient = (o) => new HindsightClient(o)) {
|
|
|
1507
1533
|
setLogLevel(cfg.logLevel);
|
|
1508
1534
|
if (cfg.disabled) return;
|
|
1509
1535
|
if (!transcriptPath) return;
|
|
1510
|
-
const resolved = applyBankConfig(cfg, deriveBankId(cfg, cwd, spec.harness));
|
|
1536
|
+
const resolved = applyBankConfig(cfg, deriveBankId(cfg, cwd, spec.harness), cwd);
|
|
1511
1537
|
cfg = resolved.cfg;
|
|
1512
1538
|
const bankId = resolved.bankId;
|
|
1513
1539
|
if (cfg.disabled) return;
|
package/dist/claude-hook.js
CHANGED
|
@@ -68,18 +68,32 @@ function gitProjectName(directory, resolveWorktrees) {
|
|
|
68
68
|
}
|
|
69
69
|
return dirName(directory);
|
|
70
70
|
}
|
|
71
|
+
function configuredDir(dir) {
|
|
72
|
+
const expanded = dir === "~" || dir.startsWith("~/") ? join(homedir(), dir.slice(1)) : dir;
|
|
73
|
+
return normalize(expanded).replace(new RegExp(`\\${sep}+$`), "");
|
|
74
|
+
}
|
|
75
|
+
function isWithin(directory, configured) {
|
|
76
|
+
return directory === configured || directory.startsWith(configured + sep);
|
|
77
|
+
}
|
|
71
78
|
function mapLookup(map, directory) {
|
|
72
79
|
const cwd = normalize(directory);
|
|
73
80
|
let best;
|
|
74
81
|
for (const [dir, bank] of Object.entries(map)) {
|
|
75
|
-
const
|
|
76
|
-
|
|
77
|
-
if (cwd === p || cwd.startsWith(p + sep)) {
|
|
82
|
+
const p = configuredDir(dir);
|
|
83
|
+
if (isWithin(cwd, p)) {
|
|
78
84
|
if (!best || p.length > best.len) best = { len: p.length, bank };
|
|
79
85
|
}
|
|
80
86
|
}
|
|
81
87
|
return best?.bank;
|
|
82
88
|
}
|
|
89
|
+
function isOptedIn(config, directory) {
|
|
90
|
+
if (!config.optInOnly) return true;
|
|
91
|
+
if (!directory) return false;
|
|
92
|
+
const cwd = normalize(directory);
|
|
93
|
+
if ((config.optInPaths ?? []).some((dir) => dir && isWithin(cwd, configuredDir(dir))))
|
|
94
|
+
return true;
|
|
95
|
+
return Boolean(config.mapPathToBank && mapLookup(config.mapPathToBank, directory));
|
|
96
|
+
}
|
|
83
97
|
function deriveBankId(config, directory, harness = "coding") {
|
|
84
98
|
const mapped = directory && config.mapPathToBank ? mapLookup(config.mapPathToBank, directory) : void 0;
|
|
85
99
|
if (mapped) return mapped;
|
|
@@ -157,6 +171,9 @@ function resolveConfig(raw = {}) {
|
|
|
157
171
|
bankIdTemplate: raw.bankIdTemplate,
|
|
158
172
|
mapPathToBank: raw.mapPathToBank,
|
|
159
173
|
resolveWorktrees: raw.resolveWorktrees,
|
|
174
|
+
optInOnly: raw.optInOnly ?? false,
|
|
175
|
+
// Same shape as retainTags: a config typo must not become a path that silently approves nothing.
|
|
176
|
+
optInPaths: Array.isArray(raw.optInPaths) ? raw.optInPaths.filter((p) => typeof p === "string" && p.trim() !== "") : [],
|
|
160
177
|
harness: raw.harness ?? "opencode",
|
|
161
178
|
disabled: raw.disabled ?? false,
|
|
162
179
|
retainSessions: raw.retainSessions ?? true,
|
|
@@ -217,6 +234,8 @@ var ENV_KEYS = {
|
|
|
217
234
|
dynamicBankId: "HINDSIGHT_DYNAMIC_BANK_ID",
|
|
218
235
|
bankIdTemplate: "HINDSIGHT_BANK_ID_TEMPLATE",
|
|
219
236
|
resolveWorktrees: "HINDSIGHT_RESOLVE_WORKTREES",
|
|
237
|
+
optInOnly: "HINDSIGHT_OPT_IN_ONLY",
|
|
238
|
+
optInPaths: "HINDSIGHT_OPT_IN_PATHS",
|
|
220
239
|
harness: "HINDSIGHT_HARNESS",
|
|
221
240
|
disabled: "HINDSIGHT_DISABLED",
|
|
222
241
|
retainSessions: "HINDSIGHT_RETAIN_SESSIONS",
|
|
@@ -239,13 +258,14 @@ var ENV_KEYS = {
|
|
|
239
258
|
var ENV_BOOLEANS = /* @__PURE__ */ new Set([
|
|
240
259
|
"dynamicBankId",
|
|
241
260
|
"resolveWorktrees",
|
|
261
|
+
"optInOnly",
|
|
242
262
|
"disabled",
|
|
243
263
|
"retainSessions",
|
|
244
264
|
"autoReflect",
|
|
245
265
|
"autoSeed",
|
|
246
266
|
"codebaseSurvey"
|
|
247
267
|
]);
|
|
248
|
-
var ENV_LISTS = /* @__PURE__ */ new Set(["retainTags"]);
|
|
268
|
+
var ENV_LISTS = /* @__PURE__ */ new Set(["retainTags", "optInPaths"]);
|
|
249
269
|
var ENV_NUMBERS = /* @__PURE__ */ new Set([
|
|
250
270
|
"apiPort",
|
|
251
271
|
"daemonIdleTimeout",
|
|
@@ -289,9 +309,15 @@ var BANK_OVERRIDE_EXCLUDED = [
|
|
|
289
309
|
"mapPathToBank",
|
|
290
310
|
"dynamicBankId",
|
|
291
311
|
"resolveWorktrees",
|
|
312
|
+
// Approval is decided BEFORE the bank is resolved, so a `banks.<id>` section naming these could
|
|
313
|
+
// only ever arrive too late to matter — strip them rather than let them read as effective.
|
|
314
|
+
"optInOnly",
|
|
315
|
+
"optInPaths",
|
|
292
316
|
"harness"
|
|
293
317
|
];
|
|
294
|
-
function applyBankConfig(cfg, resolvedId) {
|
|
318
|
+
function applyBankConfig(cfg, resolvedId, directory) {
|
|
319
|
+
if (directory !== void 0 && !isOptedIn(cfg, directory))
|
|
320
|
+
return { cfg: { ...cfg, disabled: true }, bankId: resolvedId };
|
|
295
321
|
const section = cfg.banks[resolvedId];
|
|
296
322
|
if (!section) return { cfg, bankId: resolvedId };
|
|
297
323
|
const safe = { ...section };
|
|
@@ -1204,7 +1230,7 @@ async function runHook(spec, makeClient = (o) => new HindsightClient(o)) {
|
|
|
1204
1230
|
return;
|
|
1205
1231
|
}
|
|
1206
1232
|
const out = (context, notice) => process.stdout.write(JSON.stringify(spec.emit(context ?? "", notice, ev)));
|
|
1207
|
-
const resolved = applyBankConfig(cfg, deriveBankId(cfg, cwd, spec.harness));
|
|
1233
|
+
const resolved = applyBankConfig(cfg, deriveBankId(cfg, cwd, spec.harness), cwd);
|
|
1208
1234
|
cfg = resolved.cfg;
|
|
1209
1235
|
const bankId = resolved.bankId;
|
|
1210
1236
|
if (cfg.disabled) {
|