@vectorize-io/hindsight-coding-agents 0.5.2 → 0.5.4
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 +42 -8
- package/dist/antigravity-hook.js +335 -91
- package/dist/antigravity-statusline.js +17 -10
- package/dist/antigravity-stop-hook.js +340 -92
- package/dist/claude-hook.js +335 -91
- package/dist/claude-sessionstart-hook.js +459 -132
- package/dist/claude-stop-hook.js +340 -92
- package/dist/cline.js +283 -64
- package/dist/codex-hook.js +335 -91
- package/dist/codex-sessionstart-hook.js +459 -132
- package/dist/codex-stop-hook.js +340 -92
- package/dist/copilot-hook.js +335 -91
- package/dist/copilot-sessionstart-hook.js +459 -132
- package/dist/copilot-stop-hook.js +340 -92
- package/dist/cursor-hook.js +335 -91
- package/dist/cursor-sessionstart-hook.js +459 -132
- package/dist/cursor-stop-hook.js +340 -92
- package/dist/daemon-start.js +17 -10
- package/dist/dcode-hook.js +335 -91
- package/dist/dcode-sessionstart-hook.js +459 -132
- package/dist/dcode-stop-hook.js +340 -92
- package/dist/deepen.js +113 -32
- package/dist/devin-hook.js +335 -91
- package/dist/devin-sessionstart-hook.js +459 -132
- package/dist/devin-stop-hook.js +340 -92
- package/dist/droid-hook.js +335 -91
- package/dist/droid-sessionstart-hook.js +459 -132
- package/dist/droid-stop-hook.js +340 -92
- package/dist/dsh.js +322 -101
- package/dist/grok-hook.js +335 -91
- package/dist/grok-sessionstart-hook.js +459 -132
- package/dist/grok-stop-hook.js +340 -92
- package/dist/hindsight-seed.js +17 -10
- package/dist/index.js +322 -101
- package/dist/installer.js +1252 -325
- package/dist/kilo.js +322 -101
- package/dist/mcp-server.js +100 -23
- package/dist/opencode2.js +322 -101
- package/dist/pi.js +321 -100
- package/dist/prime-agent.js +321 -100
- package/dist/qwen-hook.js +335 -91
- package/dist/qwen-sessionstart-hook.js +459 -132
- package/dist/qwen-stop-hook.js +340 -92
- package/dist/status.js +98 -21
- package/dist/survey-supervisor.js +81 -0
- package/dist/zcode-hook.js +2954 -0
- package/dist/zcode-sessionstart-hook.js +3655 -0
- package/dist/zcode-stop-hook.js +3218 -0
- package/package.json +7 -3
- package/plugin.json +1 -1
- package/skill/SKILL.md +17 -7
package/dist/dsh.js
CHANGED
|
@@ -5,7 +5,7 @@ var __export = (target, all) => {
|
|
|
5
5
|
};
|
|
6
6
|
|
|
7
7
|
// src/dsh.ts
|
|
8
|
-
import { randomUUID } from "crypto";
|
|
8
|
+
import { randomUUID as randomUUID2 } from "crypto";
|
|
9
9
|
|
|
10
10
|
// src/core/config.ts
|
|
11
11
|
import { readFileSync as readFileSync2 } from "fs";
|
|
@@ -478,6 +478,7 @@ function pagesFor(project) {
|
|
|
478
478
|
var PAGE_MAX_TOKENS = 4096;
|
|
479
479
|
var PAGE_TAGS_MATCH = "all";
|
|
480
480
|
var PAGE_FACT_TYPES = ["world", "experience", "observation"];
|
|
481
|
+
var DEFAULT_PAGE_TRIGGER_CRON = "H * * * *";
|
|
481
482
|
var CRON_FIELD_RANGES = [
|
|
482
483
|
[0, 59],
|
|
483
484
|
// minute
|
|
@@ -531,14 +532,23 @@ function pageTriggerFor(trigger, bank, page) {
|
|
|
531
532
|
function buildPageTrigger(cfg = {}) {
|
|
532
533
|
const base = { fact_types: PAGE_FACT_TYPES, tags_match: PAGE_TAGS_MATCH };
|
|
533
534
|
switch (cfg.pageTriggerType) {
|
|
534
|
-
case "
|
|
535
|
-
return { ...base,
|
|
535
|
+
case "auto-refresh":
|
|
536
|
+
return { ...base, refresh_after_consolidation: true };
|
|
536
537
|
case "manual":
|
|
537
538
|
return { ...base, refresh_after_consolidation: false };
|
|
539
|
+
// "cron" and an unset type alike: the default schedule stands in for a missing expression, so
|
|
540
|
+
// a trigger built from a partial config is never a cron trigger with nothing to fire on.
|
|
538
541
|
default:
|
|
539
|
-
return { ...base,
|
|
542
|
+
return { ...base, refresh_cron: cfg.pageTriggerCron || DEFAULT_PAGE_TRIGGER_CRON };
|
|
540
543
|
}
|
|
541
544
|
}
|
|
545
|
+
function pageTriggerDrifted(current2, desired) {
|
|
546
|
+
return current2.tags_match !== desired.tags_match || (current2.refresh_cron ?? null) !== (desired.refresh_cron ?? null) || Boolean(current2.refresh_after_consolidation) !== Boolean(desired.refresh_after_consolidation);
|
|
547
|
+
}
|
|
548
|
+
function pageTriggerPatch(desired) {
|
|
549
|
+
if (desired.refresh_after_consolidation === false) return { ...desired, refresh_cron: null };
|
|
550
|
+
return desired;
|
|
551
|
+
}
|
|
542
552
|
var CODING_BANK_TEMPLATE = {
|
|
543
553
|
version: "1",
|
|
544
554
|
bank: {
|
|
@@ -962,9 +972,16 @@ var HindsightClient = class {
|
|
|
962
972
|
body: JSON.stringify({ query, budget: opts.budget ?? "high" }),
|
|
963
973
|
signal: ctrl.signal
|
|
964
974
|
});
|
|
965
|
-
if (!resp.ok)
|
|
975
|
+
if (!resp.ok)
|
|
976
|
+
throw new Error(
|
|
977
|
+
`reflect ${resp.status} ${(await resp.text()).slice(0, 1e3)}${this.authHint(resp.status)}`
|
|
978
|
+
);
|
|
966
979
|
const data = await resp.json();
|
|
967
980
|
return (data.text || "").trim();
|
|
981
|
+
} catch (e) {
|
|
982
|
+
if (ctrl.signal.aborted)
|
|
983
|
+
throw new Error(`reflect timed out after ${opts.timeoutMs}ms`, { cause: e });
|
|
984
|
+
throw e;
|
|
968
985
|
} finally {
|
|
969
986
|
clearTimeout(timer);
|
|
970
987
|
}
|
|
@@ -1097,14 +1114,14 @@ var HindsightClient = class {
|
|
|
1097
1114
|
if (r.status !== 409) created++;
|
|
1098
1115
|
} else {
|
|
1099
1116
|
const sourceDrift = hit.description !== page.source_query;
|
|
1100
|
-
const triggerDrift = hit.trigger != null && hit.trigger
|
|
1117
|
+
const triggerDrift = hit.trigger != null && pageTriggerDrifted(hit.trigger, body.trigger);
|
|
1101
1118
|
if (!sourceDrift && !triggerDrift) continue;
|
|
1102
1119
|
const patch = {};
|
|
1103
1120
|
if (sourceDrift) {
|
|
1104
1121
|
patch.source_query = page.source_query;
|
|
1105
1122
|
patch.tags = page.tags;
|
|
1106
1123
|
}
|
|
1107
|
-
if (triggerDrift) patch.trigger =
|
|
1124
|
+
if (triggerDrift) patch.trigger = pageTriggerPatch(body.trigger);
|
|
1108
1125
|
const r = await this.req(
|
|
1109
1126
|
"PATCH",
|
|
1110
1127
|
this.bankUrl(`/knowledge-base/nodes/${encodeURIComponent(hit.id)}`),
|
|
@@ -1120,9 +1137,41 @@ var HindsightClient = class {
|
|
|
1120
1137
|
updated++;
|
|
1121
1138
|
}
|
|
1122
1139
|
}
|
|
1140
|
+
const initiatives = await this.resyncInitiativeTriggers(roots, pageTrigger);
|
|
1123
1141
|
this.log(
|
|
1124
|
-
`[bank] knowledge pages seeded on ${this.bank} (scoped to ${this.project ?? this.bank}): ${created} created, ${updated} re-synced, ${pages.length - created - updated} unchanged`
|
|
1142
|
+
`[bank] knowledge pages seeded on ${this.bank} (scoped to ${this.project ?? this.bank}): ${created} created, ${updated} re-synced, ${pages.length - created - updated} unchanged` + (initiatives ? `, ${initiatives} initiative pages re-synced` : "")
|
|
1143
|
+
);
|
|
1144
|
+
}
|
|
1145
|
+
/**
|
|
1146
|
+
* Bring the captured initiative pages onto the same refresh policy as the seeded taxonomy.
|
|
1147
|
+
*
|
|
1148
|
+
* `captureInitiative` stamps this very trigger when it creates a page, so on a bank seeded under
|
|
1149
|
+
* an older default they are the same drift as the taxonomy — and on a real repo they are most of
|
|
1150
|
+
* it: five taxonomy pages against one page per initiative, each an LLM synthesis per
|
|
1151
|
+
* consolidation under the auto-refresh that used to be the default (#3506).
|
|
1152
|
+
*
|
|
1153
|
+
* Only the trigger is touched. Their `name` and `source_query` are written once, from the
|
|
1154
|
+
* initiative's own title, and re-stating either would rebuild a page whose question never
|
|
1155
|
+
* changed. The tree read above is reused rather than re-fetched.
|
|
1156
|
+
*/
|
|
1157
|
+
async resyncInitiativeTriggers(roots, pageTrigger) {
|
|
1158
|
+
const folder = roots.find(
|
|
1159
|
+
(n) => n.kind === "folder" && (n.name || "").toLowerCase() === "initiatives"
|
|
1125
1160
|
);
|
|
1161
|
+
let updated = 0;
|
|
1162
|
+
for (const page of folder?.children ?? []) {
|
|
1163
|
+
if (page.kind !== "page" || page.trigger == null) continue;
|
|
1164
|
+
const desired = pageTriggerFor(pageTrigger, this.bank, page.name);
|
|
1165
|
+
if (!pageTriggerDrifted(page.trigger, desired)) continue;
|
|
1166
|
+
const r = await this.req(
|
|
1167
|
+
"PATCH",
|
|
1168
|
+
this.bankUrl(`/knowledge-base/nodes/${encodeURIComponent(page.id)}`),
|
|
1169
|
+
{ trigger: pageTriggerPatch(desired) }
|
|
1170
|
+
);
|
|
1171
|
+
if ([404, 405, 501].includes(r.status)) break;
|
|
1172
|
+
updated++;
|
|
1173
|
+
}
|
|
1174
|
+
return updated;
|
|
1126
1175
|
}
|
|
1127
1176
|
/** URL/id-safe slug: lowercase, non-alphanumerics → "-", trim dashes, cap length; fallback "initiative". */
|
|
1128
1177
|
slugify(s) {
|
|
@@ -1145,11 +1194,13 @@ var HindsightClient = class {
|
|
|
1145
1194
|
let pageId = args.relatesToPageId;
|
|
1146
1195
|
if (!pageId) {
|
|
1147
1196
|
const folderId = await this.ensureFolder("Initiatives");
|
|
1197
|
+
const subject = this.project ?? this.bank;
|
|
1148
1198
|
const r = await this.req("POST", this.bankUrl("/knowledge-base/pages"), {
|
|
1149
1199
|
name: args.title,
|
|
1150
|
-
source_query: `Summarize the "${args.title}" initiative: what is being built or changed and why, and its current state \u2014 drawn from the project's memory
|
|
1200
|
+
source_query: `Summarize the "${args.title}" initiative: what is being built or changed and why, and its current state \u2014 drawn from the project's memory.` + pageScopeRule(subject),
|
|
1151
1201
|
parent_id: folderId,
|
|
1152
1202
|
tags: ["knowledge:feature-work"],
|
|
1203
|
+
max_tokens: PAGE_MAX_TOKENS,
|
|
1153
1204
|
trigger: pageTriggerFor(args.pageTrigger ?? buildPageTrigger(), this.bank, args.title)
|
|
1154
1205
|
});
|
|
1155
1206
|
try {
|
|
@@ -1192,17 +1243,22 @@ var HindsightClient = class {
|
|
|
1192
1243
|
var CONFIG_PATH = process.env.HINDSIGHT_CONFIG || join6(homedir2(), ".hindsight", "coding-agent.json");
|
|
1193
1244
|
var DEFAULT_DAEMON_PORT = 9077;
|
|
1194
1245
|
var DEFAULT_DAEMON_PROFILE = "coding-agent";
|
|
1195
|
-
function
|
|
1196
|
-
if (raw.pageTriggerType === "manual") return "manual";
|
|
1197
|
-
if (raw.pageTriggerType === "
|
|
1198
|
-
|
|
1199
|
-
if (cron && (!isHashedCron(cron) || parseHashedCron(cron))) return "cron";
|
|
1246
|
+
function resolvePageTrigger(raw) {
|
|
1247
|
+
if (raw.pageTriggerType === "manual") return { type: "manual" };
|
|
1248
|
+
if (raw.pageTriggerType === "auto-refresh") return { type: "auto-refresh" };
|
|
1249
|
+
if (raw.pageTriggerType !== void 0 && raw.pageTriggerType !== "cron")
|
|
1200
1250
|
log.warn(
|
|
1201
1251
|
"config",
|
|
1202
|
-
|
|
1252
|
+
`ignoring pageTriggerType=${JSON.stringify(raw.pageTriggerType)} \u2014 expected cron|auto-refresh|manual`
|
|
1203
1253
|
);
|
|
1204
|
-
|
|
1205
|
-
return "
|
|
1254
|
+
const cron = raw.pageTriggerCron?.trim();
|
|
1255
|
+
if (!cron) return { type: "cron", cron: DEFAULT_PAGE_TRIGGER_CRON };
|
|
1256
|
+
if (!isHashedCron(cron) || parseHashedCron(cron)) return { type: "cron", cron };
|
|
1257
|
+
log.warn(
|
|
1258
|
+
"config",
|
|
1259
|
+
`pageTriggerCron ${JSON.stringify(cron)} has a malformed hashed field \u2014 write \`H\` or \`H(<lo>-<hi>)\` within the field's own range, e.g. "H H(0-5) * * *" \u2014 falling back to ${JSON.stringify(DEFAULT_PAGE_TRIGGER_CRON)}`
|
|
1260
|
+
);
|
|
1261
|
+
return { type: "cron", cron: DEFAULT_PAGE_TRIGGER_CRON };
|
|
1206
1262
|
}
|
|
1207
1263
|
var DEFAULT_REFLECT_TOOL_TIMEOUT_MS = 33e4;
|
|
1208
1264
|
var REFLECT_BUDGETS = ["low", "mid", "high"];
|
|
@@ -1234,6 +1290,7 @@ function resolveObservationScopes(raw) {
|
|
|
1234
1290
|
function resolveConfig(raw = {}) {
|
|
1235
1291
|
const serverMode = ["cloud", "self-hosted", "daemon"].includes(raw.serverMode) ? raw.serverMode : "cloud";
|
|
1236
1292
|
const apiPort = raw.apiPort || DEFAULT_DAEMON_PORT;
|
|
1293
|
+
const pageTrigger = resolvePageTrigger(raw);
|
|
1237
1294
|
return {
|
|
1238
1295
|
serverMode,
|
|
1239
1296
|
// Daemon mode resolves the URL HERE rather than at each call site: every entry point already
|
|
@@ -1268,8 +1325,8 @@ function resolveConfig(raw = {}) {
|
|
|
1268
1325
|
reflectBudget: resolveReflectBudget(raw),
|
|
1269
1326
|
autoReflect: raw.autoReflect ?? true,
|
|
1270
1327
|
pageRefreshEveryTurns: raw.pageRefreshEveryTurns || 10,
|
|
1271
|
-
pageTriggerType:
|
|
1272
|
-
pageTriggerCron:
|
|
1328
|
+
pageTriggerType: pageTrigger.type,
|
|
1329
|
+
pageTriggerCron: pageTrigger.cron,
|
|
1273
1330
|
autoSeed: raw.autoSeed ?? true,
|
|
1274
1331
|
seedLimit: raw.seedLimit || DEFAULT_SEED_LIMIT,
|
|
1275
1332
|
codebaseSurvey: raw.codebaseSurvey ?? true,
|
|
@@ -16306,7 +16363,7 @@ config(en_default());
|
|
|
16306
16363
|
// src/core/knowledge-tools.ts
|
|
16307
16364
|
import { existsSync as existsSync4 } from "fs";
|
|
16308
16365
|
import { homedir as homedir5 } from "os";
|
|
16309
|
-
import { join as
|
|
16366
|
+
import { join as join11 } from "path";
|
|
16310
16367
|
|
|
16311
16368
|
// src/core/status.ts
|
|
16312
16369
|
import { execFileSync as execFileSync3 } from "child_process";
|
|
@@ -16392,11 +16449,86 @@ ${toolGuide(opts)}
|
|
|
16392
16449
|
}
|
|
16393
16450
|
|
|
16394
16451
|
// src/core/survey.ts
|
|
16395
|
-
import { spawn as
|
|
16452
|
+
import { spawn as realSpawn5 } from "child_process";
|
|
16453
|
+
import { createHash as createHash2 } from "crypto";
|
|
16396
16454
|
import { existsSync as existsSync3 } from "fs";
|
|
16397
|
-
import { homedir as homedir4 } from "os";
|
|
16398
|
-
import { dirname as dirname7, join as
|
|
16455
|
+
import { homedir as homedir4, tmpdir as tmpdir3 } from "os";
|
|
16456
|
+
import { dirname as dirname7, join as join10 } from "path";
|
|
16399
16457
|
import { fileURLToPath as fileURLToPath4 } from "url";
|
|
16458
|
+
|
|
16459
|
+
// src/core/survey-lease.ts
|
|
16460
|
+
import { spawn as realSpawn4 } from "child_process";
|
|
16461
|
+
import { randomUUID } from "crypto";
|
|
16462
|
+
import {
|
|
16463
|
+
mkdirSync as mkdirSync3,
|
|
16464
|
+
mkdtempSync,
|
|
16465
|
+
readdirSync,
|
|
16466
|
+
renameSync,
|
|
16467
|
+
rmdirSync,
|
|
16468
|
+
rmSync,
|
|
16469
|
+
statSync,
|
|
16470
|
+
unlinkSync as unlinkSync2,
|
|
16471
|
+
utimesSync,
|
|
16472
|
+
writeFileSync as writeFileSync2
|
|
16473
|
+
} from "fs";
|
|
16474
|
+
import { join as join9 } from "path";
|
|
16475
|
+
var LEASE_STALE_MS = 3e4;
|
|
16476
|
+
var SURVEY_SPEC_ENV = "HINDSIGHT_SURVEY_SPEC";
|
|
16477
|
+
function tryRename(from, to) {
|
|
16478
|
+
try {
|
|
16479
|
+
renameSync(from, to);
|
|
16480
|
+
return true;
|
|
16481
|
+
} catch {
|
|
16482
|
+
return false;
|
|
16483
|
+
}
|
|
16484
|
+
}
|
|
16485
|
+
function releaseLease(lease) {
|
|
16486
|
+
try {
|
|
16487
|
+
unlinkSync2(join9(lease.directory, lease.owner));
|
|
16488
|
+
} catch {
|
|
16489
|
+
return;
|
|
16490
|
+
}
|
|
16491
|
+
try {
|
|
16492
|
+
rmdirSync(lease.directory);
|
|
16493
|
+
} catch {
|
|
16494
|
+
}
|
|
16495
|
+
}
|
|
16496
|
+
function reclaimIfStale(directory, staleMs) {
|
|
16497
|
+
const owners = readdirSync(directory);
|
|
16498
|
+
if (owners.length === 0) {
|
|
16499
|
+
try {
|
|
16500
|
+
rmdirSync(directory);
|
|
16501
|
+
} catch {
|
|
16502
|
+
}
|
|
16503
|
+
return true;
|
|
16504
|
+
}
|
|
16505
|
+
if (owners.length !== 1) return false;
|
|
16506
|
+
const age = Date.now() - statSync(join9(directory, owners[0])).mtimeMs;
|
|
16507
|
+
if (Math.abs(age) <= staleMs) return false;
|
|
16508
|
+
releaseLease({ directory, owner: owners[0] });
|
|
16509
|
+
return true;
|
|
16510
|
+
}
|
|
16511
|
+
function acquireLease(root, key, staleMs = LEASE_STALE_MS) {
|
|
16512
|
+
let staging;
|
|
16513
|
+
try {
|
|
16514
|
+
mkdirSync3(root, { recursive: true, mode: 448 });
|
|
16515
|
+
staging = mkdtempSync(join9(root, "claim-"));
|
|
16516
|
+
const owner = randomUUID();
|
|
16517
|
+
writeFileSync2(join9(staging, owner), "", { flag: "wx", mode: 384 });
|
|
16518
|
+
const directory = join9(root, `survey-${key}.lock`);
|
|
16519
|
+
if (!tryRename(staging, directory)) {
|
|
16520
|
+
if (!reclaimIfStale(directory, staleMs)) return void 0;
|
|
16521
|
+
if (!tryRename(staging, directory)) return void 0;
|
|
16522
|
+
}
|
|
16523
|
+
return { directory, owner };
|
|
16524
|
+
} catch {
|
|
16525
|
+
return void 0;
|
|
16526
|
+
} finally {
|
|
16527
|
+
if (staging) rmSync(staging, { recursive: true, force: true });
|
|
16528
|
+
}
|
|
16529
|
+
}
|
|
16530
|
+
|
|
16531
|
+
// src/core/survey.ts
|
|
16400
16532
|
var SURVEY_DOC_IDS = [
|
|
16401
16533
|
"repository-component-map",
|
|
16402
16534
|
"repository-core-concepts",
|
|
@@ -16406,7 +16538,7 @@ var SURVEY_DOC_IDS = [
|
|
|
16406
16538
|
function resolveClaudeBin(explicit) {
|
|
16407
16539
|
if (explicit) return explicit;
|
|
16408
16540
|
if (process.env.HINDSIGHT_CLAUDE_BIN) return process.env.HINDSIGHT_CLAUDE_BIN;
|
|
16409
|
-
const nativeInstallPath =
|
|
16541
|
+
const nativeInstallPath = join10(homedir4(), ".claude", "local", "claude");
|
|
16410
16542
|
try {
|
|
16411
16543
|
if (existsSync3(nativeInstallPath)) return nativeInstallPath;
|
|
16412
16544
|
} catch {
|
|
@@ -16520,11 +16652,11 @@ function buildSurveyPlan(harness, bin, repoDir, opts) {
|
|
|
16520
16652
|
}
|
|
16521
16653
|
}
|
|
16522
16654
|
}
|
|
16523
|
-
function startCodebaseSurvey(repoDir, opts = {}) {
|
|
16655
|
+
async function startCodebaseSurvey(repoDir, opts = {}) {
|
|
16524
16656
|
try {
|
|
16525
|
-
const spawnFn = opts.spawn ??
|
|
16657
|
+
const spawnFn = opts.spawn ?? realSpawn5;
|
|
16526
16658
|
const exists = opts.exists ?? binOnPath;
|
|
16527
|
-
const mcpServerPath = opts.mcpServerPath ??
|
|
16659
|
+
const mcpServerPath = opts.mcpServerPath ?? join10(dirname7(fileURLToPath4(import.meta.url)), "mcp-server.js");
|
|
16528
16660
|
const preferred = opts.harness ?? "claude-code";
|
|
16529
16661
|
const order = [
|
|
16530
16662
|
preferred,
|
|
@@ -16544,20 +16676,51 @@ function startCodebaseSurvey(repoDir, opts = {}) {
|
|
|
16544
16676
|
budgetUsd: opts.budgetUsd,
|
|
16545
16677
|
mcpServerPath
|
|
16546
16678
|
});
|
|
16547
|
-
const
|
|
16548
|
-
|
|
16549
|
-
|
|
16550
|
-
|
|
16551
|
-
|
|
16552
|
-
|
|
16553
|
-
|
|
16554
|
-
|
|
16679
|
+
const { cfg, bankId } = resolveHostConfig(harness, repoDir);
|
|
16680
|
+
if (cfg.disabled) return false;
|
|
16681
|
+
const key = createHash2("sha256").update(JSON.stringify([cfg.apiUrl.replace(/\/+$/, ""), cfg.apiToken ?? "", bankId])).digest("hex");
|
|
16682
|
+
const lease = acquireLease(
|
|
16683
|
+
opts.lease?.dir ?? join10(tmpdir3(), "hindsight-coding-agent", "surveys"),
|
|
16684
|
+
key,
|
|
16685
|
+
opts.lease?.staleMs ?? LEASE_STALE_MS
|
|
16686
|
+
);
|
|
16687
|
+
if (!lease) return false;
|
|
16688
|
+
const spec = {
|
|
16689
|
+
lease,
|
|
16690
|
+
bin: plan.bin,
|
|
16691
|
+
args: plan.args,
|
|
16692
|
+
...opts.lease?.heartbeatMs ? { heartbeatMs: opts.lease.heartbeatMs } : {}
|
|
16693
|
+
};
|
|
16694
|
+
const supervisorPath = opts.supervisorPath ?? join10(dirname7(fileURLToPath4(import.meta.url)), "survey-supervisor.js");
|
|
16695
|
+
return await new Promise((resolve3) => {
|
|
16696
|
+
try {
|
|
16697
|
+
const child = spawnFn("node", [supervisorPath], {
|
|
16698
|
+
cwd: repoDir,
|
|
16699
|
+
detached: true,
|
|
16700
|
+
stdio: "ignore",
|
|
16701
|
+
windowsHide: true,
|
|
16702
|
+
env: { ...plan.env, [SURVEY_SPEC_ENV]: JSON.stringify(spec) }
|
|
16703
|
+
});
|
|
16704
|
+
let spawned = false;
|
|
16705
|
+
child.on("error", () => {
|
|
16706
|
+
if (spawned) return;
|
|
16707
|
+
releaseLease(lease);
|
|
16708
|
+
resolve3(false);
|
|
16709
|
+
});
|
|
16710
|
+
child.once("spawn", () => {
|
|
16711
|
+
spawned = true;
|
|
16712
|
+
child.unref();
|
|
16713
|
+
resolve3(true);
|
|
16714
|
+
});
|
|
16715
|
+
} catch {
|
|
16716
|
+
releaseLease(lease);
|
|
16717
|
+
resolve3(false);
|
|
16718
|
+
}
|
|
16555
16719
|
});
|
|
16556
|
-
child.unref();
|
|
16557
|
-
return;
|
|
16558
16720
|
}
|
|
16559
16721
|
} catch {
|
|
16560
16722
|
}
|
|
16723
|
+
return false;
|
|
16561
16724
|
}
|
|
16562
16725
|
|
|
16563
16726
|
// src/core/status.ts
|
|
@@ -16670,7 +16833,7 @@ function buildKnowledgeTools(client, bankId, opts = {}) {
|
|
|
16670
16833
|
inputSchema: {},
|
|
16671
16834
|
annotations: READ_ONLY_ANNOTATIONS,
|
|
16672
16835
|
handler: async (_args) => {
|
|
16673
|
-
const configPath = process.env.HINDSIGHT_CONFIG ||
|
|
16836
|
+
const configPath = process.env.HINDSIGHT_CONFIG || join11(homedir5(), ".hindsight", "coding-agent.json");
|
|
16674
16837
|
const harness = opts.harness ?? "unknown";
|
|
16675
16838
|
const cfg = applyBankConfig(
|
|
16676
16839
|
loadConfig({ harness: opts.harness }),
|
|
@@ -16806,7 +16969,7 @@ function buildKnowledgeTools(client, bankId, opts = {}) {
|
|
|
16806
16969
|
}
|
|
16807
16970
|
|
|
16808
16971
|
// src/core/retain-cursor.ts
|
|
16809
|
-
import { createHash as
|
|
16972
|
+
import { createHash as createHash3 } from "crypto";
|
|
16810
16973
|
var PENDING_MAX_AGE_MS = 12 * 60 * 60 * 1e3;
|
|
16811
16974
|
var PENDING_MAX_BYTES = 256 * 1024;
|
|
16812
16975
|
function pendingReplayable(cursor, now) {
|
|
@@ -16816,7 +16979,7 @@ function pendingReplayable(cursor, now) {
|
|
|
16816
16979
|
return pending.reduce((n, p) => n + p.content.length, 0) <= PENDING_MAX_BYTES;
|
|
16817
16980
|
}
|
|
16818
16981
|
function fingerprintTurns(turns, count) {
|
|
16819
|
-
const h =
|
|
16982
|
+
const h = createHash3("sha1").update(String(count));
|
|
16820
16983
|
for (let i = 0; i < count; i++) h.update("\n" + JSON.stringify(turns[i]));
|
|
16821
16984
|
return h.digest("hex");
|
|
16822
16985
|
}
|
|
@@ -16839,13 +17002,13 @@ function memoryCursorStore() {
|
|
|
16839
17002
|
}
|
|
16840
17003
|
|
|
16841
17004
|
// src/core/uuid.ts
|
|
16842
|
-
import { createHash as
|
|
17005
|
+
import { createHash as createHash4 } from "crypto";
|
|
16843
17006
|
var HINDSIGHT_NAMESPACE = "e75686a4-e923-4326-a0d1-358f1c6c3eb4";
|
|
16844
17007
|
function uuidV5(name2, namespace = HINDSIGHT_NAMESPACE) {
|
|
16845
17008
|
const ns = Buffer.from(namespace.replace(/-/g, ""), "hex");
|
|
16846
17009
|
if (ns.length !== 16) throw new Error(`invalid UUID namespace: ${namespace}`);
|
|
16847
17010
|
const bytes = Buffer.from(
|
|
16848
|
-
|
|
17011
|
+
createHash4("sha1").update(ns).update(Buffer.from(name2, "utf8")).digest().subarray(0, 16)
|
|
16849
17012
|
);
|
|
16850
17013
|
bytes[6] = bytes[6] & 15 | 80;
|
|
16851
17014
|
bytes[8] = bytes[8] & 63 | 128;
|
|
@@ -17049,12 +17212,12 @@ function buildRetainStamp(cfg, ctx) {
|
|
|
17049
17212
|
}
|
|
17050
17213
|
|
|
17051
17214
|
// src/core/session-start.ts
|
|
17052
|
-
import { readFileSync as
|
|
17215
|
+
import { readFileSync as readFileSync7 } from "fs";
|
|
17053
17216
|
|
|
17054
17217
|
// src/core/skill-sync.ts
|
|
17055
17218
|
import { cpSync, existsSync as existsSync5, readFileSync as readFileSync4 } from "fs";
|
|
17056
17219
|
import { homedir as homedir6 } from "os";
|
|
17057
|
-
import { dirname as dirname8, join as
|
|
17220
|
+
import { dirname as dirname8, join as join12 } from "path";
|
|
17058
17221
|
import { fileURLToPath as fileURLToPath5 } from "url";
|
|
17059
17222
|
|
|
17060
17223
|
// src/core/brand.ts
|
|
@@ -17071,29 +17234,66 @@ function brandWord() {
|
|
|
17071
17234
|
return `${out}\x1B[0m`;
|
|
17072
17235
|
}
|
|
17073
17236
|
|
|
17237
|
+
// src/core/legacy.ts
|
|
17238
|
+
import { existsSync as existsSync6, readFileSync as readFileSync5 } from "fs";
|
|
17239
|
+
import { homedir as homedir7 } from "os";
|
|
17240
|
+
import { join as join13, relative, isAbsolute as isAbsolute2 } from "path";
|
|
17241
|
+
var LEGACY_CLAUDE_PLUGIN = "hindsight-memory";
|
|
17242
|
+
function detectLegacyClaudePlugin(cwd, claudeDir = join13(homedir7(), ".claude")) {
|
|
17243
|
+
const registry2 = readJson(join13(claudeDir, "plugins", "installed_plugins.json"));
|
|
17244
|
+
const plugins = registry2?.plugins;
|
|
17245
|
+
if (!plugins || typeof plugins !== "object") return void 0;
|
|
17246
|
+
const enabled = readJson(join13(claudeDir, "settings.json"))?.enabledPlugins;
|
|
17247
|
+
for (const [key, raw] of Object.entries(plugins)) {
|
|
17248
|
+
if (key.split("@")[0] !== LEGACY_CLAUDE_PLUGIN) continue;
|
|
17249
|
+
if (enabled && enabled[key] === false) continue;
|
|
17250
|
+
const installs = Array.isArray(raw) ? raw : [raw];
|
|
17251
|
+
const active = installs.some((i) => {
|
|
17252
|
+
if (!i || typeof i !== "object") return false;
|
|
17253
|
+
if (typeof i.projectPath !== "string") return true;
|
|
17254
|
+
const rel = relative(i.projectPath, cwd);
|
|
17255
|
+
return rel === "" || !rel.startsWith("..") && !isAbsolute2(rel);
|
|
17256
|
+
});
|
|
17257
|
+
if (active) return key;
|
|
17258
|
+
}
|
|
17259
|
+
return void 0;
|
|
17260
|
+
}
|
|
17261
|
+
function readJson(path) {
|
|
17262
|
+
try {
|
|
17263
|
+
const parsed = JSON.parse(readFileSync5(path, "utf8"));
|
|
17264
|
+
return parsed && typeof parsed === "object" ? parsed : void 0;
|
|
17265
|
+
} catch {
|
|
17266
|
+
return void 0;
|
|
17267
|
+
}
|
|
17268
|
+
}
|
|
17269
|
+
function legacyClaudePluginWarning(key) {
|
|
17270
|
+
return `\u26A0\uFE0F The old Hindsight Claude Code plugin (${key}) is still installed \u2014 it runs alongside this one, so memory is recalled and retained twice.
|
|
17271
|
+
\u21B3 remove it: claude plugin uninstall ${key}`;
|
|
17272
|
+
}
|
|
17273
|
+
|
|
17074
17274
|
// src/core/session-cache.ts
|
|
17075
|
-
import { mkdirSync as
|
|
17076
|
-
import { tmpdir as
|
|
17077
|
-
import { dirname as dirname9, join as
|
|
17275
|
+
import { mkdirSync as mkdirSync4, readFileSync as readFileSync6, renameSync as renameSync2, rmSync as rmSync2, writeFileSync as writeFileSync3 } from "fs";
|
|
17276
|
+
import { tmpdir as tmpdir4 } from "os";
|
|
17277
|
+
import { dirname as dirname9, join as join14 } from "path";
|
|
17078
17278
|
function sessionCacheFile(harness, sessionId) {
|
|
17079
|
-
return
|
|
17279
|
+
return join14(tmpdir4(), `hindsight-${harness}`, `${sessionId}.json`);
|
|
17080
17280
|
}
|
|
17081
17281
|
function readSessionCache(cacheFile) {
|
|
17082
17282
|
try {
|
|
17083
|
-
return JSON.parse(
|
|
17283
|
+
return JSON.parse(readFileSync6(cacheFile, "utf8"));
|
|
17084
17284
|
} catch {
|
|
17085
17285
|
return {};
|
|
17086
17286
|
}
|
|
17087
17287
|
}
|
|
17088
17288
|
function writeFileAtomic(path, body) {
|
|
17089
|
-
|
|
17289
|
+
mkdirSync4(dirname9(path), { recursive: true });
|
|
17090
17290
|
const tmp = `${path}.${process.pid}.tmp`;
|
|
17091
17291
|
try {
|
|
17092
|
-
|
|
17093
|
-
|
|
17292
|
+
writeFileSync3(tmp, body);
|
|
17293
|
+
renameSync2(tmp, path);
|
|
17094
17294
|
} catch (e) {
|
|
17095
17295
|
try {
|
|
17096
|
-
|
|
17296
|
+
rmSync2(tmp, { force: true });
|
|
17097
17297
|
} catch {
|
|
17098
17298
|
}
|
|
17099
17299
|
throw e;
|
|
@@ -17186,13 +17386,13 @@ async function buildSessionStartContext(args) {
|
|
|
17186
17386
|
startSeed(cwd, { limit: cfg.seedLimit, harness });
|
|
17187
17387
|
if (docIds.size === 0) {
|
|
17188
17388
|
if (cfg.codebaseSurvey !== false) {
|
|
17189
|
-
startSurvey(cwd, {
|
|
17389
|
+
const started = await startSurvey(cwd, {
|
|
17190
17390
|
harness,
|
|
17191
17391
|
model: cfg.surveyModel,
|
|
17192
17392
|
budgetUsd: cfg.surveyBudgetUsd
|
|
17193
17393
|
});
|
|
17194
17394
|
const sha = resolveHeadSha(cwd);
|
|
17195
|
-
if (sha) recordSurveyBaseline(sha);
|
|
17395
|
+
if (started && sha) recordSurveyBaseline(sha);
|
|
17196
17396
|
}
|
|
17197
17397
|
diag(harness, "seed_started", { bank: bankId });
|
|
17198
17398
|
} else if (cfg.codebaseSurvey !== false && cfg.surveyRefreshCommits > 0) {
|
|
@@ -17209,17 +17409,19 @@ async function buildSessionStartContext(args) {
|
|
|
17209
17409
|
const uploads = await client.listDocumentIds("source:upload", "all_strict").catch(() => /* @__PURE__ */ new Set());
|
|
17210
17410
|
const findingsAbsent = counts.length > 0 && !SURVEY_DOC_IDS.some((id) => uploads.has(id));
|
|
17211
17411
|
if (sinceLast !== null && sinceLast >= cfg.surveyRefreshCommits || findingsAbsent) {
|
|
17212
|
-
startSurvey(cwd, {
|
|
17412
|
+
const started = await startSurvey(cwd, {
|
|
17213
17413
|
harness,
|
|
17214
17414
|
model: cfg.surveyModel,
|
|
17215
17415
|
budgetUsd: cfg.surveyBudgetUsd
|
|
17216
17416
|
});
|
|
17217
|
-
|
|
17218
|
-
|
|
17219
|
-
|
|
17220
|
-
|
|
17221
|
-
|
|
17222
|
-
|
|
17417
|
+
if (started) {
|
|
17418
|
+
recordSurveyBaseline(sha);
|
|
17419
|
+
diag(harness, "survey_refresh", {
|
|
17420
|
+
bank: bankId,
|
|
17421
|
+
commits: sinceLast,
|
|
17422
|
+
retry: findingsAbsent
|
|
17423
|
+
});
|
|
17424
|
+
}
|
|
17223
17425
|
} else if (sinceLast === null) {
|
|
17224
17426
|
recordSurveyBaseline(sha);
|
|
17225
17427
|
}
|
|
@@ -17252,12 +17454,19 @@ async function buildSessionStartContext(args) {
|
|
|
17252
17454
|
}).catch(() => void 0);
|
|
17253
17455
|
}
|
|
17254
17456
|
systemMessage = buildSeedBanner(bankId, cold === true, gitNote);
|
|
17457
|
+
const detectLegacy = args.detectLegacyPlugin ?? (harness === "claude-code" ? detectLegacyClaudePlugin : void 0);
|
|
17458
|
+
const legacyPlugin = detectLegacy?.(cwd);
|
|
17459
|
+
if (legacyPlugin) {
|
|
17460
|
+
systemMessage += `
|
|
17461
|
+
${legacyClaudePluginWarning(legacyPlugin)}`;
|
|
17462
|
+
diag(harness, "legacy_plugin_active", { plugin: legacyPlugin });
|
|
17463
|
+
}
|
|
17255
17464
|
diag(harness, "session_start", { bank: bankId, cold, pages: pages.length, ms: Date.now() - t0 });
|
|
17256
17465
|
return { systemMessage, additionalContext, deferInitialReflect };
|
|
17257
17466
|
}
|
|
17258
17467
|
|
|
17259
17468
|
// src/core/hook.ts
|
|
17260
|
-
import { existsSync as
|
|
17469
|
+
import { existsSync as existsSync7, readFileSync as readFileSync9 } from "fs";
|
|
17261
17470
|
|
|
17262
17471
|
// src/core/inject.ts
|
|
17263
17472
|
function buildReflectQuery(prompt) {
|
|
@@ -17288,6 +17497,49 @@ If you VERIFY this memory is wrong or outdated (the code or facts contradict it)
|
|
|
17288
17497
|
` + memory + "\n</hindsight_memory>";
|
|
17289
17498
|
}
|
|
17290
17499
|
|
|
17500
|
+
// src/core/turn-journal.ts
|
|
17501
|
+
import { appendFileSync as appendFileSync3, mkdirSync as mkdirSync5, readFileSync as readFileSync8, statSync as statSync2 } from "fs";
|
|
17502
|
+
import { tmpdir as tmpdir5 } from "os";
|
|
17503
|
+
import { dirname as dirname10, join as join15 } from "path";
|
|
17504
|
+
|
|
17505
|
+
// src/core/transcript-util.ts
|
|
17506
|
+
var MEMORY_TAG_RE = /<(hook_prompt|task-notification|system-reminder|hindsight_memory|hindsight_memories|hindsight_bank|relevant_memories|user_feedback|hindsight_knowledge|hindsight_knowledge_refresh)\b[\s\S]*?<\/\1>/g;
|
|
17507
|
+
function stripInjectedMemory(s) {
|
|
17508
|
+
return s.replace(MEMORY_TAG_RE, "");
|
|
17509
|
+
}
|
|
17510
|
+
var TARGET_KEYS = [
|
|
17511
|
+
"file_path",
|
|
17512
|
+
"path",
|
|
17513
|
+
"notebook_path",
|
|
17514
|
+
"command",
|
|
17515
|
+
"pattern",
|
|
17516
|
+
"query",
|
|
17517
|
+
"url",
|
|
17518
|
+
"name",
|
|
17519
|
+
"id"
|
|
17520
|
+
];
|
|
17521
|
+
var ACTION_TARGET_CAP = 100;
|
|
17522
|
+
function actionLine(tool, input) {
|
|
17523
|
+
let target = "";
|
|
17524
|
+
if (input && typeof input === "object") {
|
|
17525
|
+
const rec = input;
|
|
17526
|
+
for (const k of TARGET_KEYS) {
|
|
17527
|
+
const v = rec[k];
|
|
17528
|
+
if (typeof v === "string" && v.trim()) {
|
|
17529
|
+
target = v.trim().split("\n")[0];
|
|
17530
|
+
break;
|
|
17531
|
+
}
|
|
17532
|
+
}
|
|
17533
|
+
} else if (typeof input === "string") {
|
|
17534
|
+
target = input.trim().split("\n")[0];
|
|
17535
|
+
}
|
|
17536
|
+
if (target.length > ACTION_TARGET_CAP) target = `${target.slice(0, ACTION_TARGET_CAP)}\u2026`;
|
|
17537
|
+
return target ? `${tool} ${target}` : tool;
|
|
17538
|
+
}
|
|
17539
|
+
|
|
17540
|
+
// src/core/turn-journal.ts
|
|
17541
|
+
var JOURNAL_MAX_BYTES = 8 * 1024 * 1024;
|
|
17542
|
+
|
|
17291
17543
|
// src/core/hook.ts
|
|
17292
17544
|
var HOOK_REFLECT_CAP_MS = 25e3;
|
|
17293
17545
|
async function buildHookOutput(args) {
|
|
@@ -17303,13 +17555,14 @@ async function buildHookOutput(args) {
|
|
|
17303
17555
|
} else if (cfg.autoReflect && reflectAnswer === void 0) {
|
|
17304
17556
|
reflectRanThisTurn = true;
|
|
17305
17557
|
const t0 = Date.now();
|
|
17558
|
+
const timeoutMs = Math.min(cfg.reflectTimeoutMs, HOOK_REFLECT_CAP_MS);
|
|
17306
17559
|
try {
|
|
17307
17560
|
reflectAnswer = await client.reflect(buildReflectQuery(prompt), {
|
|
17308
17561
|
// Automatic reflection runs inside a hard 25s hook window. Hindsight's low budget is the
|
|
17309
17562
|
// supported default for bounded reflect calls; callers that explicitly invoke the MCP
|
|
17310
17563
|
// tool still get the deeper high-budget path.
|
|
17311
17564
|
budget: "low",
|
|
17312
|
-
timeoutMs
|
|
17565
|
+
timeoutMs
|
|
17313
17566
|
});
|
|
17314
17567
|
diag(harness, reflectAnswer ? "reflect_ok" : "reflect_empty", {
|
|
17315
17568
|
ms: Date.now() - t0,
|
|
@@ -17327,7 +17580,10 @@ async function buildHookOutput(args) {
|
|
|
17327
17580
|
});
|
|
17328
17581
|
diag(harness, "reflect_failed", {
|
|
17329
17582
|
ms: Date.now() - t0,
|
|
17330
|
-
|
|
17583
|
+
bank: client.bank,
|
|
17584
|
+
timeoutMs,
|
|
17585
|
+
// Wider than describeError's default: the server's error body is the useful part.
|
|
17586
|
+
error: describeError(e, 1500),
|
|
17331
17587
|
query: prompt.slice(0, 80)
|
|
17332
17588
|
});
|
|
17333
17589
|
}
|
|
@@ -17597,41 +17853,6 @@ var RuntimeCore = class {
|
|
|
17597
17853
|
}
|
|
17598
17854
|
};
|
|
17599
17855
|
|
|
17600
|
-
// src/core/transcript-util.ts
|
|
17601
|
-
var MEMORY_TAG_RE = /<(hook_prompt|task-notification|system-reminder|hindsight_memory|hindsight_memories|hindsight_bank|relevant_memories|user_feedback|hindsight_knowledge|hindsight_knowledge_refresh)\b[\s\S]*?<\/\1>/g;
|
|
17602
|
-
function stripInjectedMemory(s) {
|
|
17603
|
-
return s.replace(MEMORY_TAG_RE, "");
|
|
17604
|
-
}
|
|
17605
|
-
var TARGET_KEYS = [
|
|
17606
|
-
"file_path",
|
|
17607
|
-
"path",
|
|
17608
|
-
"notebook_path",
|
|
17609
|
-
"command",
|
|
17610
|
-
"pattern",
|
|
17611
|
-
"query",
|
|
17612
|
-
"url",
|
|
17613
|
-
"name",
|
|
17614
|
-
"id"
|
|
17615
|
-
];
|
|
17616
|
-
var ACTION_TARGET_CAP = 100;
|
|
17617
|
-
function actionLine(tool, input) {
|
|
17618
|
-
let target = "";
|
|
17619
|
-
if (input && typeof input === "object") {
|
|
17620
|
-
const rec = input;
|
|
17621
|
-
for (const k of TARGET_KEYS) {
|
|
17622
|
-
const v = rec[k];
|
|
17623
|
-
if (typeof v === "string" && v.trim()) {
|
|
17624
|
-
target = v.trim().split("\n")[0];
|
|
17625
|
-
break;
|
|
17626
|
-
}
|
|
17627
|
-
}
|
|
17628
|
-
} else if (typeof input === "string") {
|
|
17629
|
-
target = input.trim().split("\n")[0];
|
|
17630
|
-
}
|
|
17631
|
-
if (target.length > ACTION_TARGET_CAP) target = `${target.slice(0, ACTION_TARGET_CAP)}\u2026`;
|
|
17632
|
-
return target ? `${tool} ${target}` : tool;
|
|
17633
|
-
}
|
|
17634
|
-
|
|
17635
17856
|
// src/core/transcript-dsh.ts
|
|
17636
17857
|
var HINDSIGHT_PLUGIN = "hindsight";
|
|
17637
17858
|
function textOf(message) {
|
|
@@ -17717,7 +17938,7 @@ function promptOf(messages) {
|
|
|
17717
17938
|
}
|
|
17718
17939
|
function injectionMessage(text) {
|
|
17719
17940
|
return {
|
|
17720
|
-
id:
|
|
17941
|
+
id: randomUUID2(),
|
|
17721
17942
|
role: "user",
|
|
17722
17943
|
content: [{ type: "text", text }],
|
|
17723
17944
|
source: { kind: "plugin", plugin: HINDSIGHT_PLUGIN, form: "recall" }
|