@vectorize-io/hindsight-coding-agents 0.3.0 → 0.3.2
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 +39 -6
- package/dist/antigravity-statusline.js +124 -98
- package/dist/antigravity-stop-hook.js +63 -16
- package/dist/claude-hook.js +39 -6
- package/dist/claude-sessionstart-hook.js +39 -6
- package/dist/claude-stop-hook.js +63 -16
- package/dist/cline.js +150 -110
- package/dist/codex-hook.js +39 -6
- package/dist/codex-sessionstart-hook.js +39 -6
- package/dist/codex-stop-hook.js +63 -16
- package/dist/copilot-hook.js +39 -6
- package/dist/copilot-sessionstart-hook.js +39 -6
- package/dist/copilot-stop-hook.js +63 -16
- package/dist/cursor-hook.js +39 -6
- package/dist/cursor-sessionstart-hook.js +39 -6
- package/dist/cursor-stop-hook.js +63 -16
- package/dist/daemon-start.js +24 -12
- package/dist/deepen.js +32 -6
- package/dist/devin-hook.js +39 -6
- package/dist/devin-sessionstart-hook.js +39 -6
- package/dist/devin-stop-hook.js +63 -16
- package/dist/grok-hook.js +39 -6
- package/dist/grok-sessionstart-hook.js +39 -6
- package/dist/grok-stop-hook.js +63 -16
- package/dist/hindsight-seed.js +108 -96
- package/dist/index.js +55 -15
- package/dist/installer.js +7 -0
- package/dist/kilo.js +55 -15
- package/dist/mcp-server.js +127 -101
- package/dist/prime-agent.js +51 -15
- package/dist/status.js +31 -5
- package/package.json +1 -1
package/dist/claude-stop-hook.js
CHANGED
|
@@ -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 };
|
|
@@ -1062,10 +1088,10 @@ async function supportsAppend(client) {
|
|
|
1062
1088
|
return false;
|
|
1063
1089
|
}
|
|
1064
1090
|
}
|
|
1091
|
+
var DEFAULT_RETRY_WINDOW_MS = 6e4;
|
|
1065
1092
|
var RETAIN_RETRY_ATTEMPTS = 2;
|
|
1066
|
-
var
|
|
1067
|
-
async function submitWithRetry(send, isStillNewest) {
|
|
1068
|
-
let spent = 0;
|
|
1093
|
+
var REQUEST_BUDGET_MS = 15e3;
|
|
1094
|
+
async function submitWithRetry(send, isStillNewest, retryUntil) {
|
|
1069
1095
|
for (let attempt = 0; ; attempt++) {
|
|
1070
1096
|
try {
|
|
1071
1097
|
return await send();
|
|
@@ -1073,8 +1099,7 @@ async function submitWithRetry(send, isStillNewest) {
|
|
|
1073
1099
|
const limited = e instanceof RateLimitedError;
|
|
1074
1100
|
if (!limited || attempt >= RETAIN_RETRY_ATTEMPTS || !isStillNewest()) throw e;
|
|
1075
1101
|
const wait = e.retryAfterMs || 1e3;
|
|
1076
|
-
if (wait
|
|
1077
|
-
spent += wait;
|
|
1102
|
+
if (Date.now() + wait + REQUEST_BUDGET_MS > retryUntil) throw e;
|
|
1078
1103
|
await sleep(wait);
|
|
1079
1104
|
}
|
|
1080
1105
|
}
|
|
@@ -1094,14 +1119,24 @@ function serialize(cursors, sessionId, write2) {
|
|
|
1094
1119
|
}
|
|
1095
1120
|
async function retainLiveSession(client, sessionId, turns, startTs, harness, opts = {}) {
|
|
1096
1121
|
const cursors = opts.cursors;
|
|
1097
|
-
if (!cursors)
|
|
1122
|
+
if (!cursors)
|
|
1123
|
+
return writeSession(
|
|
1124
|
+
client,
|
|
1125
|
+
sessionId,
|
|
1126
|
+
turns,
|
|
1127
|
+
startTs,
|
|
1128
|
+
harness,
|
|
1129
|
+
opts.stamp,
|
|
1130
|
+
void 0,
|
|
1131
|
+
opts.retryUntil
|
|
1132
|
+
);
|
|
1098
1133
|
return serialize(
|
|
1099
1134
|
cursors,
|
|
1100
1135
|
sessionId,
|
|
1101
|
-
() => writeSession(client, sessionId, turns, startTs, harness, opts.stamp, cursors)
|
|
1136
|
+
() => writeSession(client, sessionId, turns, startTs, harness, opts.stamp, cursors, opts.retryUntil)
|
|
1102
1137
|
);
|
|
1103
1138
|
}
|
|
1104
|
-
async function writeSession(client, sessionId, turns, startTs, harness, stamp, cursors) {
|
|
1139
|
+
async function writeSession(client, sessionId, turns, startTs, harness, stamp, cursors, retryUntil = Date.now() + DEFAULT_RETRY_WINDOW_MS) {
|
|
1105
1140
|
const refId = `conversation:${sessionId}`;
|
|
1106
1141
|
const appendSupported = Boolean(cursors) && await supportsAppend(client);
|
|
1107
1142
|
const plan = planRetain(turns, cursors?.read(sessionId), { appendSupported, bank: client.bank });
|
|
@@ -1153,7 +1188,8 @@ ${content}`),
|
|
|
1153
1188
|
if (!cursors) return true;
|
|
1154
1189
|
const now = cursors.read(sessionId);
|
|
1155
1190
|
return now?.turns === claimed.turns && now?.fingerprint === claimed.fingerprint;
|
|
1156
|
-
}
|
|
1191
|
+
},
|
|
1192
|
+
retryUntil
|
|
1157
1193
|
);
|
|
1158
1194
|
cursors?.write(sessionId, next);
|
|
1159
1195
|
}
|
|
@@ -1469,6 +1505,7 @@ function readClaudeTranscript(path) {
|
|
|
1469
1505
|
}
|
|
1470
1506
|
|
|
1471
1507
|
// src/core/retain-hook.ts
|
|
1508
|
+
var HOST_DEADLINE_MARGIN_MS = 2e3;
|
|
1472
1509
|
async function buildRetain(args) {
|
|
1473
1510
|
const { harness, sessionId, transcriptPath, client } = args;
|
|
1474
1511
|
const readTranscript = args.readTranscript ?? readClaudeTranscript;
|
|
@@ -1479,7 +1516,8 @@ async function buildRetain(args) {
|
|
|
1479
1516
|
try {
|
|
1480
1517
|
await retainLiveSession(client, sessionId, turns, startTs, harness, {
|
|
1481
1518
|
cursors: args.cursors ?? fileCursorStore(harness),
|
|
1482
|
-
stamp: args.stamp
|
|
1519
|
+
stamp: args.stamp,
|
|
1520
|
+
retryUntil: args.retryUntil
|
|
1483
1521
|
});
|
|
1484
1522
|
diag(harness, "retain_ok", { ms: Date.now() - t0, turns: turns.length, session: sessionId });
|
|
1485
1523
|
} catch (e) {
|
|
@@ -1495,6 +1533,7 @@ async function buildRetain(args) {
|
|
|
1495
1533
|
}
|
|
1496
1534
|
async function runRetainHook(spec, makeClient = (o) => new HindsightClient(o)) {
|
|
1497
1535
|
if (process.env.HINDSIGHT_DISABLE_HOOKS) return;
|
|
1536
|
+
const hostDeadline = Date.now() + spec.hostTimeoutSec * 1e3 - HOST_DEADLINE_MARGIN_MS;
|
|
1498
1537
|
let ev = {};
|
|
1499
1538
|
try {
|
|
1500
1539
|
ev = JSON.parse(readFileSync4(0, "utf8"));
|
|
@@ -1507,7 +1546,7 @@ async function runRetainHook(spec, makeClient = (o) => new HindsightClient(o)) {
|
|
|
1507
1546
|
setLogLevel(cfg.logLevel);
|
|
1508
1547
|
if (cfg.disabled) return;
|
|
1509
1548
|
if (!transcriptPath) return;
|
|
1510
|
-
const resolved = applyBankConfig(cfg, deriveBankId(cfg, cwd, spec.harness));
|
|
1549
|
+
const resolved = applyBankConfig(cfg, deriveBankId(cfg, cwd, spec.harness), cwd);
|
|
1511
1550
|
cfg = resolved.cfg;
|
|
1512
1551
|
const bankId = resolved.bankId;
|
|
1513
1552
|
if (cfg.disabled) return;
|
|
@@ -1524,6 +1563,7 @@ async function runRetainHook(spec, makeClient = (o) => new HindsightClient(o)) {
|
|
|
1524
1563
|
transcriptPath,
|
|
1525
1564
|
client,
|
|
1526
1565
|
readTranscript: spec.readTranscript,
|
|
1566
|
+
retryUntil: hostDeadline,
|
|
1527
1567
|
stamp: buildRetainStamp(cfg, {
|
|
1528
1568
|
directory: cwd,
|
|
1529
1569
|
harness: spec.harness,
|
|
@@ -1895,6 +1935,7 @@ var HOOK_HARNESSES = {
|
|
|
1895
1935
|
sessionStart: standardSessionStart("claude-code"),
|
|
1896
1936
|
prompt: claudePrompt,
|
|
1897
1937
|
retain: {
|
|
1938
|
+
hostTimeoutSec: 60,
|
|
1898
1939
|
harness: "claude-code",
|
|
1899
1940
|
parse: (ev) => ({
|
|
1900
1941
|
sessionId: ev.session_id,
|
|
@@ -1913,6 +1954,7 @@ var HOOK_HARNESSES = {
|
|
|
1913
1954
|
sessionStart: standardSessionStart("codex"),
|
|
1914
1955
|
prompt: codexPrompt,
|
|
1915
1956
|
retain: {
|
|
1957
|
+
hostTimeoutSec: 60,
|
|
1916
1958
|
harness: "codex",
|
|
1917
1959
|
parse: (ev) => ({
|
|
1918
1960
|
sessionId: ev.session_id,
|
|
@@ -1941,6 +1983,7 @@ var HOOK_HARNESSES = {
|
|
|
1941
1983
|
},
|
|
1942
1984
|
prompt: antigravityPrompt,
|
|
1943
1985
|
retain: {
|
|
1986
|
+
hostTimeoutSec: 30,
|
|
1944
1987
|
harness: "antigravity-cli",
|
|
1945
1988
|
parse: (ev) => ({
|
|
1946
1989
|
sessionId: ev.conversationId,
|
|
@@ -1969,6 +2012,7 @@ var HOOK_HARNESSES = {
|
|
|
1969
2012
|
},
|
|
1970
2013
|
prompt: cursorPrompt,
|
|
1971
2014
|
retain: {
|
|
2015
|
+
hostTimeoutSec: 30,
|
|
1972
2016
|
harness: "cursor-cli",
|
|
1973
2017
|
parse: (ev) => ({
|
|
1974
2018
|
sessionId: ev.conversation_id ?? ev.session_id,
|
|
@@ -2002,6 +2046,7 @@ var HOOK_HARNESSES = {
|
|
|
2002
2046
|
},
|
|
2003
2047
|
prompt: copilotPrompt,
|
|
2004
2048
|
retain: {
|
|
2049
|
+
hostTimeoutSec: 60,
|
|
2005
2050
|
harness: "copilot-cli",
|
|
2006
2051
|
parse: (ev) => ({
|
|
2007
2052
|
sessionId: ev.sessionId,
|
|
@@ -2030,6 +2075,7 @@ var HOOK_HARNESSES = {
|
|
|
2030
2075
|
},
|
|
2031
2076
|
prompt: devinPrompt,
|
|
2032
2077
|
retain: {
|
|
2078
|
+
hostTimeoutSec: 60,
|
|
2033
2079
|
harness: "devin-cli",
|
|
2034
2080
|
parse: (ev) => {
|
|
2035
2081
|
const sessionId = ev.session_id;
|
|
@@ -2069,6 +2115,7 @@ var HOOK_HARNESSES = {
|
|
|
2069
2115
|
})
|
|
2070
2116
|
},
|
|
2071
2117
|
retain: {
|
|
2118
|
+
hostTimeoutSec: 60,
|
|
2072
2119
|
harness: "grok-build",
|
|
2073
2120
|
parse: (ev) => ({
|
|
2074
2121
|
sessionId: ev.sessionId,
|
package/dist/cline.js
CHANGED
|
@@ -6,8 +6,8 @@ var __export = (target, all) => {
|
|
|
6
6
|
|
|
7
7
|
// src/core/config.ts
|
|
8
8
|
import { readFileSync } from "fs";
|
|
9
|
-
import { homedir } from "os";
|
|
10
|
-
import { join as
|
|
9
|
+
import { homedir as homedir2 } from "os";
|
|
10
|
+
import { join as join3 } from "path";
|
|
11
11
|
|
|
12
12
|
// src/core/seed.ts
|
|
13
13
|
import { spawn as realSpawn } from "child_process";
|
|
@@ -41,8 +41,117 @@ function startBackgroundSeed(repoDir, opts = {}) {
|
|
|
41
41
|
}
|
|
42
42
|
}
|
|
43
43
|
|
|
44
|
+
// src/core/bank.ts
|
|
45
|
+
import { execFileSync } from "child_process";
|
|
46
|
+
import { existsSync } from "fs";
|
|
47
|
+
import { homedir } from "os";
|
|
48
|
+
import { basename, dirname as dirname2, join as join2, normalize, sep } from "path";
|
|
49
|
+
|
|
50
|
+
// src/core/template.ts
|
|
51
|
+
var PLACEHOLDER = /\{([a-zA-Z_]+)\}/g;
|
|
52
|
+
function applyTemplate(template, resolvers, what) {
|
|
53
|
+
return template.replace(PLACEHOLDER, (_, name) => {
|
|
54
|
+
const resolve2 = resolvers[name];
|
|
55
|
+
if (!resolve2) {
|
|
56
|
+
console.error(
|
|
57
|
+
`hindsight: unknown ${what} placeholder "{${name}}" \u2014 valid: ` + Object.keys(resolvers).sort().map((k) => `{${k}}`).join(", ")
|
|
58
|
+
);
|
|
59
|
+
return "unknown";
|
|
60
|
+
}
|
|
61
|
+
return resolve2();
|
|
62
|
+
});
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
// src/core/bank.ts
|
|
66
|
+
var DEFAULT_BANK_NAME = "coding";
|
|
67
|
+
var DEFAULT_TEMPLATE = "coding-agent::{gitProject}";
|
|
68
|
+
function getProjectRootFromGit(directory) {
|
|
69
|
+
if (!directory) return null;
|
|
70
|
+
try {
|
|
71
|
+
const commonDir = execFileSync(
|
|
72
|
+
"git",
|
|
73
|
+
["rev-parse", "--path-format=absolute", "--git-common-dir"],
|
|
74
|
+
{ cwd: directory, encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"], timeout: 1e3 }
|
|
75
|
+
).trim();
|
|
76
|
+
if (!commonDir) return null;
|
|
77
|
+
return basename(commonDir) === ".git" ? dirname2(commonDir) : commonDir;
|
|
78
|
+
} catch {
|
|
79
|
+
return null;
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
function projectNameOf(directory) {
|
|
83
|
+
return gitProjectName(directory, true);
|
|
84
|
+
}
|
|
85
|
+
var PROJECT_ROOT_ENV = ["CLAUDE_PROJECT_DIR"];
|
|
86
|
+
function nearestExistingDir(directory) {
|
|
87
|
+
let current2 = directory;
|
|
88
|
+
while (current2) {
|
|
89
|
+
if (existsSync(current2)) return current2;
|
|
90
|
+
const parent = dirname2(current2);
|
|
91
|
+
if (parent === current2) return "";
|
|
92
|
+
current2 = parent;
|
|
93
|
+
}
|
|
94
|
+
return "";
|
|
95
|
+
}
|
|
96
|
+
function dirName(directory) {
|
|
97
|
+
return directory && basename(directory) || "unknown";
|
|
98
|
+
}
|
|
99
|
+
function gitProjectName(directory, resolveWorktrees) {
|
|
100
|
+
if (resolveWorktrees) {
|
|
101
|
+
const candidates = [
|
|
102
|
+
nearestExistingDir(directory),
|
|
103
|
+
...PROJECT_ROOT_ENV.map((v) => process.env[v] || "")
|
|
104
|
+
];
|
|
105
|
+
for (const candidate of candidates) {
|
|
106
|
+
const root = candidate ? getProjectRootFromGit(candidate) : null;
|
|
107
|
+
if (root) return basename(root);
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
return dirName(directory);
|
|
111
|
+
}
|
|
112
|
+
function configuredDir(dir) {
|
|
113
|
+
const expanded = dir === "~" || dir.startsWith("~/") ? join2(homedir(), dir.slice(1)) : dir;
|
|
114
|
+
return normalize(expanded).replace(new RegExp(`\\${sep}+$`), "");
|
|
115
|
+
}
|
|
116
|
+
function isWithin(directory, configured) {
|
|
117
|
+
return directory === configured || directory.startsWith(configured + sep);
|
|
118
|
+
}
|
|
119
|
+
function mapLookup(map2, directory) {
|
|
120
|
+
const cwd = normalize(directory);
|
|
121
|
+
let best;
|
|
122
|
+
for (const [dir, bank] of Object.entries(map2)) {
|
|
123
|
+
const p = configuredDir(dir);
|
|
124
|
+
if (isWithin(cwd, p)) {
|
|
125
|
+
if (!best || p.length > best.len) best = { len: p.length, bank };
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
return best?.bank;
|
|
129
|
+
}
|
|
130
|
+
function isOptedIn(config2, directory) {
|
|
131
|
+
if (!config2.optInOnly) return true;
|
|
132
|
+
if (!directory) return false;
|
|
133
|
+
const cwd = normalize(directory);
|
|
134
|
+
if ((config2.optInPaths ?? []).some((dir) => dir && isWithin(cwd, configuredDir(dir))))
|
|
135
|
+
return true;
|
|
136
|
+
return Boolean(config2.mapPathToBank && mapLookup(config2.mapPathToBank, directory));
|
|
137
|
+
}
|
|
138
|
+
function deriveBankId(config2, directory, harness = "coding") {
|
|
139
|
+
const mapped = directory && config2.mapPathToBank ? mapLookup(config2.mapPathToBank, directory) : void 0;
|
|
140
|
+
if (mapped) return mapped;
|
|
141
|
+
const dynamic = config2.dynamicBankId ?? !config2.bankId;
|
|
142
|
+
if (!dynamic) return config2.bankId || DEFAULT_BANK_NAME;
|
|
143
|
+
const resolvers = {
|
|
144
|
+
harness: () => harness,
|
|
145
|
+
project: () => dirName(directory),
|
|
146
|
+
gitProject: () => gitProjectName(directory, config2.resolveWorktrees ?? true),
|
|
147
|
+
channel: () => process.env.HINDSIGHT_CHANNEL_ID || "default",
|
|
148
|
+
user: () => process.env.HINDSIGHT_USER_ID || "anonymous"
|
|
149
|
+
};
|
|
150
|
+
return applyTemplate(config2.bankIdTemplate || DEFAULT_TEMPLATE, resolvers, "bankIdTemplate");
|
|
151
|
+
}
|
|
152
|
+
|
|
44
153
|
// src/core/config.ts
|
|
45
|
-
var CONFIG_PATH = process.env.HINDSIGHT_CONFIG ||
|
|
154
|
+
var CONFIG_PATH = process.env.HINDSIGHT_CONFIG || join3(homedir2(), ".hindsight", "coding-agent.json");
|
|
46
155
|
var DEFAULT_DAEMON_PORT = 9077;
|
|
47
156
|
var DEFAULT_DAEMON_IDLE_TIMEOUT = 300;
|
|
48
157
|
var DEFAULT_DAEMON_PROFILE = "coding-agent";
|
|
@@ -66,6 +175,9 @@ function resolveConfig(raw = {}) {
|
|
|
66
175
|
bankIdTemplate: raw.bankIdTemplate,
|
|
67
176
|
mapPathToBank: raw.mapPathToBank,
|
|
68
177
|
resolveWorktrees: raw.resolveWorktrees,
|
|
178
|
+
optInOnly: raw.optInOnly ?? false,
|
|
179
|
+
// Same shape as retainTags: a config typo must not become a path that silently approves nothing.
|
|
180
|
+
optInPaths: Array.isArray(raw.optInPaths) ? raw.optInPaths.filter((p) => typeof p === "string" && p.trim() !== "") : [],
|
|
69
181
|
harness: raw.harness ?? "opencode",
|
|
70
182
|
disabled: raw.disabled ?? false,
|
|
71
183
|
retainSessions: raw.retainSessions ?? true,
|
|
@@ -126,6 +238,8 @@ var ENV_KEYS = {
|
|
|
126
238
|
dynamicBankId: "HINDSIGHT_DYNAMIC_BANK_ID",
|
|
127
239
|
bankIdTemplate: "HINDSIGHT_BANK_ID_TEMPLATE",
|
|
128
240
|
resolveWorktrees: "HINDSIGHT_RESOLVE_WORKTREES",
|
|
241
|
+
optInOnly: "HINDSIGHT_OPT_IN_ONLY",
|
|
242
|
+
optInPaths: "HINDSIGHT_OPT_IN_PATHS",
|
|
129
243
|
harness: "HINDSIGHT_HARNESS",
|
|
130
244
|
disabled: "HINDSIGHT_DISABLED",
|
|
131
245
|
retainSessions: "HINDSIGHT_RETAIN_SESSIONS",
|
|
@@ -148,13 +262,14 @@ var ENV_KEYS = {
|
|
|
148
262
|
var ENV_BOOLEANS = /* @__PURE__ */ new Set([
|
|
149
263
|
"dynamicBankId",
|
|
150
264
|
"resolveWorktrees",
|
|
265
|
+
"optInOnly",
|
|
151
266
|
"disabled",
|
|
152
267
|
"retainSessions",
|
|
153
268
|
"autoReflect",
|
|
154
269
|
"autoSeed",
|
|
155
270
|
"codebaseSurvey"
|
|
156
271
|
]);
|
|
157
|
-
var ENV_LISTS = /* @__PURE__ */ new Set(["retainTags"]);
|
|
272
|
+
var ENV_LISTS = /* @__PURE__ */ new Set(["retainTags", "optInPaths"]);
|
|
158
273
|
var ENV_NUMBERS = /* @__PURE__ */ new Set([
|
|
159
274
|
"apiPort",
|
|
160
275
|
"daemonIdleTimeout",
|
|
@@ -198,9 +313,15 @@ var BANK_OVERRIDE_EXCLUDED = [
|
|
|
198
313
|
"mapPathToBank",
|
|
199
314
|
"dynamicBankId",
|
|
200
315
|
"resolveWorktrees",
|
|
316
|
+
// Approval is decided BEFORE the bank is resolved, so a `banks.<id>` section naming these could
|
|
317
|
+
// only ever arrive too late to matter — strip them rather than let them read as effective.
|
|
318
|
+
"optInOnly",
|
|
319
|
+
"optInPaths",
|
|
201
320
|
"harness"
|
|
202
321
|
];
|
|
203
|
-
function applyBankConfig(cfg, resolvedId) {
|
|
322
|
+
function applyBankConfig(cfg, resolvedId, directory) {
|
|
323
|
+
if (directory !== void 0 && !isOptedIn(cfg, directory))
|
|
324
|
+
return { cfg: { ...cfg, disabled: true }, bankId: resolvedId };
|
|
204
325
|
const section = cfg.banks[resolvedId];
|
|
205
326
|
if (!section) return { cfg, bankId: resolvedId };
|
|
206
327
|
const safe = { ...section };
|
|
@@ -220,101 +341,6 @@ function resolvePartial(cfg, patch) {
|
|
|
220
341
|
return out;
|
|
221
342
|
}
|
|
222
343
|
|
|
223
|
-
// src/core/bank.ts
|
|
224
|
-
import { execFileSync } from "child_process";
|
|
225
|
-
import { existsSync } from "fs";
|
|
226
|
-
import { homedir as homedir2 } from "os";
|
|
227
|
-
import { basename, dirname as dirname2, join as join3, normalize, sep } from "path";
|
|
228
|
-
|
|
229
|
-
// src/core/template.ts
|
|
230
|
-
var PLACEHOLDER = /\{([a-zA-Z_]+)\}/g;
|
|
231
|
-
function applyTemplate(template, resolvers, what) {
|
|
232
|
-
return template.replace(PLACEHOLDER, (_, name) => {
|
|
233
|
-
const resolve2 = resolvers[name];
|
|
234
|
-
if (!resolve2) {
|
|
235
|
-
console.error(
|
|
236
|
-
`hindsight: unknown ${what} placeholder "{${name}}" \u2014 valid: ` + Object.keys(resolvers).sort().map((k) => `{${k}}`).join(", ")
|
|
237
|
-
);
|
|
238
|
-
return "unknown";
|
|
239
|
-
}
|
|
240
|
-
return resolve2();
|
|
241
|
-
});
|
|
242
|
-
}
|
|
243
|
-
|
|
244
|
-
// src/core/bank.ts
|
|
245
|
-
var DEFAULT_BANK_NAME = "coding";
|
|
246
|
-
var DEFAULT_TEMPLATE = "coding-agent::{gitProject}";
|
|
247
|
-
function getProjectRootFromGit(directory) {
|
|
248
|
-
if (!directory) return null;
|
|
249
|
-
try {
|
|
250
|
-
const commonDir = execFileSync(
|
|
251
|
-
"git",
|
|
252
|
-
["rev-parse", "--path-format=absolute", "--git-common-dir"],
|
|
253
|
-
{ cwd: directory, encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"], timeout: 1e3 }
|
|
254
|
-
).trim();
|
|
255
|
-
if (!commonDir) return null;
|
|
256
|
-
return basename(commonDir) === ".git" ? dirname2(commonDir) : commonDir;
|
|
257
|
-
} catch {
|
|
258
|
-
return null;
|
|
259
|
-
}
|
|
260
|
-
}
|
|
261
|
-
function projectNameOf(directory) {
|
|
262
|
-
return gitProjectName(directory, true);
|
|
263
|
-
}
|
|
264
|
-
var PROJECT_ROOT_ENV = ["CLAUDE_PROJECT_DIR"];
|
|
265
|
-
function nearestExistingDir(directory) {
|
|
266
|
-
let current2 = directory;
|
|
267
|
-
while (current2) {
|
|
268
|
-
if (existsSync(current2)) return current2;
|
|
269
|
-
const parent = dirname2(current2);
|
|
270
|
-
if (parent === current2) return "";
|
|
271
|
-
current2 = parent;
|
|
272
|
-
}
|
|
273
|
-
return "";
|
|
274
|
-
}
|
|
275
|
-
function dirName(directory) {
|
|
276
|
-
return directory && basename(directory) || "unknown";
|
|
277
|
-
}
|
|
278
|
-
function gitProjectName(directory, resolveWorktrees) {
|
|
279
|
-
if (resolveWorktrees) {
|
|
280
|
-
const candidates = [
|
|
281
|
-
nearestExistingDir(directory),
|
|
282
|
-
...PROJECT_ROOT_ENV.map((v) => process.env[v] || "")
|
|
283
|
-
];
|
|
284
|
-
for (const candidate of candidates) {
|
|
285
|
-
const root = candidate ? getProjectRootFromGit(candidate) : null;
|
|
286
|
-
if (root) return basename(root);
|
|
287
|
-
}
|
|
288
|
-
}
|
|
289
|
-
return dirName(directory);
|
|
290
|
-
}
|
|
291
|
-
function mapLookup(map2, directory) {
|
|
292
|
-
const cwd = normalize(directory);
|
|
293
|
-
let best;
|
|
294
|
-
for (const [dir, bank] of Object.entries(map2)) {
|
|
295
|
-
const expanded = dir === "~" || dir.startsWith("~/") ? join3(homedir2(), dir.slice(1)) : dir;
|
|
296
|
-
const p = normalize(expanded).replace(new RegExp(`\\${sep}+$`), "");
|
|
297
|
-
if (cwd === p || cwd.startsWith(p + sep)) {
|
|
298
|
-
if (!best || p.length > best.len) best = { len: p.length, bank };
|
|
299
|
-
}
|
|
300
|
-
}
|
|
301
|
-
return best?.bank;
|
|
302
|
-
}
|
|
303
|
-
function deriveBankId(config2, directory, harness = "coding") {
|
|
304
|
-
const mapped = directory && config2.mapPathToBank ? mapLookup(config2.mapPathToBank, directory) : void 0;
|
|
305
|
-
if (mapped) return mapped;
|
|
306
|
-
const dynamic = config2.dynamicBankId ?? !config2.bankId;
|
|
307
|
-
if (!dynamic) return config2.bankId || DEFAULT_BANK_NAME;
|
|
308
|
-
const resolvers = {
|
|
309
|
-
harness: () => harness,
|
|
310
|
-
project: () => dirName(directory),
|
|
311
|
-
gitProject: () => gitProjectName(directory, config2.resolveWorktrees ?? true),
|
|
312
|
-
channel: () => process.env.HINDSIGHT_CHANNEL_ID || "default",
|
|
313
|
-
user: () => process.env.HINDSIGHT_USER_ID || "anonymous"
|
|
314
|
-
};
|
|
315
|
-
return applyTemplate(config2.bankIdTemplate || DEFAULT_TEMPLATE, resolvers, "bankIdTemplate");
|
|
316
|
-
}
|
|
317
|
-
|
|
318
344
|
// src/core/missions.ts
|
|
319
345
|
var GIT_MISSION = "You are ingesting a single git commit: its message and its full diff. Extract the concrete technical DECISION and the CAUSE/INVARIANT it encodes, bound to the specific code entities (functions, methods, files) and behaviors it changes. Preserve exact identifiers, paths, and literal values verbatim. Preserve the 'REF-ID: <token>' marker verbatim in every fact. Capture both WHAT changed and WHY. Issue/PR references (#123, GH-123, PROJ-123) are load-bearing: keep them VERBATIM in the fact text and emit each as an ENTITY, so a later question about that issue or PR retrieves this decision.";
|
|
320
346
|
var GITLOG_MISSION = "You are ingesting an aggregated block of git commit MESSAGES ONLY (no diffs) \u2014 the project's recent commit-message history, newest first. Extract the project's INITIATIVES, FEATURES, ENHANCEMENTS, and notable changes or THEMES over time \u2014 what the project has been working on and how it has evolved. Do NOT extract per-line code detail (there is no diff to draw it from). Group related commits into a coherent initiative/theme where the messages make that clear; preserve exact identifiers and literal values verbatim when quoting a subject line. Keep issue/PR references (#123, GH-123) VERBATIM and emit each as an ENTITY \u2014 they are how future sessions will ask about this work.";
|
|
@@ -16047,10 +16073,10 @@ async function supportsAppend(client) {
|
|
|
16047
16073
|
return false;
|
|
16048
16074
|
}
|
|
16049
16075
|
}
|
|
16076
|
+
var DEFAULT_RETRY_WINDOW_MS = 6e4;
|
|
16050
16077
|
var RETAIN_RETRY_ATTEMPTS = 2;
|
|
16051
|
-
var
|
|
16052
|
-
async function submitWithRetry(send, isStillNewest) {
|
|
16053
|
-
let spent = 0;
|
|
16078
|
+
var REQUEST_BUDGET_MS = 15e3;
|
|
16079
|
+
async function submitWithRetry(send, isStillNewest, retryUntil) {
|
|
16054
16080
|
for (let attempt = 0; ; attempt++) {
|
|
16055
16081
|
try {
|
|
16056
16082
|
return await send();
|
|
@@ -16058,8 +16084,7 @@ async function submitWithRetry(send, isStillNewest) {
|
|
|
16058
16084
|
const limited = e instanceof RateLimitedError;
|
|
16059
16085
|
if (!limited || attempt >= RETAIN_RETRY_ATTEMPTS || !isStillNewest()) throw e;
|
|
16060
16086
|
const wait = e.retryAfterMs || 1e3;
|
|
16061
|
-
if (wait
|
|
16062
|
-
spent += wait;
|
|
16087
|
+
if (Date.now() + wait + REQUEST_BUDGET_MS > retryUntil) throw e;
|
|
16063
16088
|
await sleep(wait);
|
|
16064
16089
|
}
|
|
16065
16090
|
}
|
|
@@ -16079,14 +16104,24 @@ function serialize(cursors, sessionId2, write2) {
|
|
|
16079
16104
|
}
|
|
16080
16105
|
async function retainLiveSession(client, sessionId2, turns, startTs, harness, opts = {}) {
|
|
16081
16106
|
const cursors = opts.cursors;
|
|
16082
|
-
if (!cursors)
|
|
16107
|
+
if (!cursors)
|
|
16108
|
+
return writeSession(
|
|
16109
|
+
client,
|
|
16110
|
+
sessionId2,
|
|
16111
|
+
turns,
|
|
16112
|
+
startTs,
|
|
16113
|
+
harness,
|
|
16114
|
+
opts.stamp,
|
|
16115
|
+
void 0,
|
|
16116
|
+
opts.retryUntil
|
|
16117
|
+
);
|
|
16083
16118
|
return serialize(
|
|
16084
16119
|
cursors,
|
|
16085
16120
|
sessionId2,
|
|
16086
|
-
() => writeSession(client, sessionId2, turns, startTs, harness, opts.stamp, cursors)
|
|
16121
|
+
() => writeSession(client, sessionId2, turns, startTs, harness, opts.stamp, cursors, opts.retryUntil)
|
|
16087
16122
|
);
|
|
16088
16123
|
}
|
|
16089
|
-
async function writeSession(client, sessionId2, turns, startTs, harness, stamp, cursors) {
|
|
16124
|
+
async function writeSession(client, sessionId2, turns, startTs, harness, stamp, cursors, retryUntil = Date.now() + DEFAULT_RETRY_WINDOW_MS) {
|
|
16090
16125
|
const refId = `conversation:${sessionId2}`;
|
|
16091
16126
|
const appendSupported = Boolean(cursors) && await supportsAppend(client);
|
|
16092
16127
|
const plan = planRetain(turns, cursors?.read(sessionId2), { appendSupported, bank: client.bank });
|
|
@@ -16138,7 +16173,8 @@ ${content}`),
|
|
|
16138
16173
|
if (!cursors) return true;
|
|
16139
16174
|
const now = cursors.read(sessionId2);
|
|
16140
16175
|
return now?.turns === claimed.turns && now?.fingerprint === claimed.fingerprint;
|
|
16141
|
-
}
|
|
16176
|
+
},
|
|
16177
|
+
retryUntil
|
|
16142
16178
|
);
|
|
16143
16179
|
cursors?.write(sessionId2, next);
|
|
16144
16180
|
}
|
|
@@ -16827,7 +16863,11 @@ function createClineHooks(core, configuredSessionId, sessionStart) {
|
|
|
16827
16863
|
function createRuntime(workspaceRoot) {
|
|
16828
16864
|
let cfg = loadConfig({ harness: HARNESS2 });
|
|
16829
16865
|
if (cfg.disabled) return void 0;
|
|
16830
|
-
const resolved = applyBankConfig(
|
|
16866
|
+
const resolved = applyBankConfig(
|
|
16867
|
+
cfg,
|
|
16868
|
+
deriveBankId(cfg, workspaceRoot || process.cwd(), HARNESS2),
|
|
16869
|
+
workspaceRoot || process.cwd()
|
|
16870
|
+
);
|
|
16831
16871
|
cfg = resolved.cfg;
|
|
16832
16872
|
if (cfg.disabled) return void 0;
|
|
16833
16873
|
const client = new HindsightClient({
|