@indigoai-us/hq-cloud 6.14.28 → 6.14.30
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/dist/bin/sync-runner-company.d.ts +4 -0
- package/dist/bin/sync-runner-company.d.ts.map +1 -1
- package/dist/bin/sync-runner-company.js +3 -0
- package/dist/bin/sync-runner-company.js.map +1 -1
- package/dist/bin/sync-runner-planning.d.ts +7 -6
- package/dist/bin/sync-runner-planning.d.ts.map +1 -1
- package/dist/bin/sync-runner-planning.js +1 -1
- package/dist/bin/sync-runner-planning.js.map +1 -1
- package/dist/bin/sync-runner-planning.test.js +23 -0
- package/dist/bin/sync-runner-planning.test.js.map +1 -1
- package/dist/bin/sync-runner-rollup.d.ts.map +1 -1
- package/dist/bin/sync-runner-rollup.js +3 -1
- package/dist/bin/sync-runner-rollup.js.map +1 -1
- package/dist/bin/sync-runner-rollup.test.d.ts +2 -0
- package/dist/bin/sync-runner-rollup.test.d.ts.map +1 -0
- package/dist/bin/sync-runner-rollup.test.js +24 -0
- package/dist/bin/sync-runner-rollup.test.js.map +1 -0
- package/dist/bin/sync-runner-watch-loop.d.ts.map +1 -1
- package/dist/bin/sync-runner-watch-loop.js +15 -1
- package/dist/bin/sync-runner-watch-loop.js.map +1 -1
- package/dist/bin/sync-runner.d.ts +11 -7
- package/dist/bin/sync-runner.d.ts.map +1 -1
- package/dist/bin/sync-runner.js +51 -9
- package/dist/bin/sync-runner.js.map +1 -1
- package/dist/bin/sync-runner.test.js +97 -0
- package/dist/bin/sync-runner.test.js.map +1 -1
- package/dist/cli/doctor.d.ts.map +1 -1
- package/dist/cli/doctor.js +3 -1
- package/dist/cli/doctor.js.map +1 -1
- package/dist/cli/reindex.d.ts.map +1 -1
- package/dist/cli/reindex.js +24 -13
- package/dist/cli/reindex.js.map +1 -1
- package/dist/cli/rescue-core.js +3 -1
- package/dist/cli/rescue-core.js.map +1 -1
- package/dist/cli/share.d.ts +35 -0
- package/dist/cli/share.d.ts.map +1 -1
- package/dist/cli/share.js +29 -11
- package/dist/cli/share.js.map +1 -1
- package/dist/cli/share.test.js +46 -0
- package/dist/cli/share.test.js.map +1 -1
- package/dist/ignore.d.ts.map +1 -1
- package/dist/ignore.js +5 -0
- package/dist/ignore.js.map +1 -1
- package/dist/ignore.test.js +9 -0
- package/dist/ignore.test.js.map +1 -1
- package/dist/outcome-telemetry.d.ts +167 -0
- package/dist/outcome-telemetry.d.ts.map +1 -0
- package/dist/outcome-telemetry.js +479 -0
- package/dist/outcome-telemetry.js.map +1 -0
- package/dist/outcome-telemetry.test.d.ts +9 -0
- package/dist/outcome-telemetry.test.d.ts.map +1 -0
- package/dist/outcome-telemetry.test.js +412 -0
- package/dist/outcome-telemetry.test.js.map +1 -0
- package/dist/qmd-reindex.d.ts +48 -35
- package/dist/qmd-reindex.d.ts.map +1 -1
- package/dist/qmd-reindex.js +188 -60
- package/dist/qmd-reindex.js.map +1 -1
- package/dist/qmd-reindex.test.d.ts +3 -3
- package/dist/qmd-reindex.test.js +203 -41
- package/dist/qmd-reindex.test.js.map +1 -1
- package/dist/telemetry.d.ts +5 -4
- package/dist/telemetry.d.ts.map +1 -1
- package/dist/telemetry.js +187 -13
- package/dist/telemetry.js.map +1 -1
- package/dist/telemetry.test.js +157 -0
- package/dist/telemetry.test.js.map +1 -1
- package/dist/vault-client.d.ts +34 -0
- package/dist/vault-client.d.ts.map +1 -1
- package/dist/vault-client.js +23 -0
- package/dist/vault-client.js.map +1 -1
- package/package.json +1 -1
- package/src/bin/sync-runner-company.ts +4 -0
- package/src/bin/sync-runner-planning.test.ts +26 -0
- package/src/bin/sync-runner-planning.ts +8 -7
- package/src/bin/sync-runner-rollup.test.ts +37 -0
- package/src/bin/sync-runner-rollup.ts +3 -1
- package/src/bin/sync-runner-watch-loop.ts +22 -1
- package/src/bin/sync-runner.test.ts +111 -0
- package/src/bin/sync-runner.ts +62 -17
- package/src/cli/doctor.ts +3 -1
- package/src/cli/reindex.ts +24 -12
- package/src/cli/rescue-core.ts +3 -1
- package/src/cli/share.test.ts +60 -0
- package/src/cli/share.ts +29 -11
- package/src/ignore.test.ts +10 -0
- package/src/ignore.ts +5 -0
- package/src/outcome-telemetry.test.ts +498 -0
- package/src/outcome-telemetry.ts +639 -0
- package/src/qmd-reindex.test.ts +226 -40
- package/src/qmd-reindex.ts +209 -61
- package/src/telemetry.test.ts +194 -0
- package/src/telemetry.ts +233 -14
- package/src/vault-client.ts +55 -0
|
@@ -0,0 +1,412 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Tests for the outcome-event collector (outcome-leaderboard US-004).
|
|
3
|
+
*
|
|
4
|
+
* The vault client is stubbed structurally (the production boundary is
|
|
5
|
+
* `OutcomeTelemetryClientSurface`, not the HTTP layer), and a real temp HQ root
|
|
6
|
+
* with `companies/manifest.yaml` + prd.json/board.json fixtures drives the scan.
|
|
7
|
+
*/
|
|
8
|
+
import { describe, it, expect, beforeEach, afterEach } from "vitest";
|
|
9
|
+
import { promises as fsp } from "fs";
|
|
10
|
+
import * as os from "os";
|
|
11
|
+
import * as path from "path";
|
|
12
|
+
import { collectAndSendOutcomeTelemetry, extractStoryTransitions, extractProjectTransitions, toWireRow, isDoneStatus, wireRowRejectReason, MAX_FIELD_CHARS, MAX_EVENT_BYTES, } from "./outcome-telemetry.js";
|
|
13
|
+
function makeClient(opts = {}) {
|
|
14
|
+
const optInResponse = opts.optInResponse ?? { enabled: true, updatedAt: null };
|
|
15
|
+
const postResponse = opts.postResponse ?? { ok: true, written: 0, deduped: 0 };
|
|
16
|
+
const posts = [];
|
|
17
|
+
return {
|
|
18
|
+
posts,
|
|
19
|
+
optInCalls: 0,
|
|
20
|
+
async getTelemetryOptIn() {
|
|
21
|
+
this.optInCalls++;
|
|
22
|
+
if (optInResponse instanceof Error)
|
|
23
|
+
throw optInResponse;
|
|
24
|
+
return optInResponse;
|
|
25
|
+
},
|
|
26
|
+
async postOutcomeEvents(batch) {
|
|
27
|
+
posts.push(batch);
|
|
28
|
+
if (postResponse instanceof Error)
|
|
29
|
+
throw postResponse;
|
|
30
|
+
return postResponse;
|
|
31
|
+
},
|
|
32
|
+
};
|
|
33
|
+
}
|
|
34
|
+
// ── HQ-root fixture ─────────────────────────────────────────────────────────
|
|
35
|
+
const COMPANY_UID = "cmp_01TESTCOMPANY0000000000000";
|
|
36
|
+
async function makeHqRoot() {
|
|
37
|
+
const root = await fsp.mkdtemp(path.join(os.tmpdir(), "outcome-hq-"));
|
|
38
|
+
const companies = path.join(root, "companies");
|
|
39
|
+
await fsp.mkdir(companies, { recursive: true });
|
|
40
|
+
await fsp.writeFile(path.join(companies, "manifest.yaml"), [
|
|
41
|
+
"companies:",
|
|
42
|
+
" acme:",
|
|
43
|
+
" name: Acme",
|
|
44
|
+
" path: companies/acme",
|
|
45
|
+
" repos: []",
|
|
46
|
+
` cloud_uid: ${COMPANY_UID}`,
|
|
47
|
+
// A second company with NO cloud_uid — its projects must be skipped.
|
|
48
|
+
" local-only:",
|
|
49
|
+
" name: Local Only",
|
|
50
|
+
" path: companies/local-only",
|
|
51
|
+
" repos: []",
|
|
52
|
+
"",
|
|
53
|
+
].join("\n"), "utf-8");
|
|
54
|
+
return root;
|
|
55
|
+
}
|
|
56
|
+
async function writePrd(root, slug, project, prd) {
|
|
57
|
+
const dir = path.join(root, "companies", slug, "projects", project);
|
|
58
|
+
await fsp.mkdir(dir, { recursive: true });
|
|
59
|
+
const p = path.join(dir, "prd.json");
|
|
60
|
+
await fsp.writeFile(p, JSON.stringify(prd), "utf-8");
|
|
61
|
+
return p;
|
|
62
|
+
}
|
|
63
|
+
async function writeBoard(root, slug, board) {
|
|
64
|
+
const dir = path.join(root, "companies", slug);
|
|
65
|
+
await fsp.mkdir(dir, { recursive: true });
|
|
66
|
+
const p = path.join(dir, "board.json");
|
|
67
|
+
await fsp.writeFile(p, JSON.stringify(board), "utf-8");
|
|
68
|
+
return p;
|
|
69
|
+
}
|
|
70
|
+
// ── Suite ──────────────────────────────────────────────────────────────────
|
|
71
|
+
describe("isDoneStatus", () => {
|
|
72
|
+
it("matches done/completed/shipped/complete case-insensitively", () => {
|
|
73
|
+
for (const s of ["done", "completed", "Shipped", "COMPLETE", " done "]) {
|
|
74
|
+
expect(isDoneStatus(s)).toBe(true);
|
|
75
|
+
}
|
|
76
|
+
});
|
|
77
|
+
it("rejects non-done statuses and non-strings", () => {
|
|
78
|
+
for (const s of ["in_progress", "prd_created", "archived", "", undefined, 3, null]) {
|
|
79
|
+
expect(isDoneStatus(s)).toBe(false);
|
|
80
|
+
}
|
|
81
|
+
});
|
|
82
|
+
});
|
|
83
|
+
describe("extractStoryTransitions (false→true detection + allowlist)", () => {
|
|
84
|
+
it("emits ONLY stories whose passes === true", () => {
|
|
85
|
+
const prd = {
|
|
86
|
+
name: "my-project",
|
|
87
|
+
description: "should not leak",
|
|
88
|
+
userStories: [
|
|
89
|
+
{ id: "US-001", passes: true, notes: "secret", acceptanceCriteria: ["x"] },
|
|
90
|
+
{ id: "US-002", passes: false },
|
|
91
|
+
{ id: "US-003" }, // no passes → not complete
|
|
92
|
+
{ id: "US-004", passes: "true" }, // string, not boolean → not complete
|
|
93
|
+
],
|
|
94
|
+
};
|
|
95
|
+
const ts = extractStoryTransitions(prd, COMPANY_UID);
|
|
96
|
+
expect(ts.map((t) => t.storyId)).toEqual(["US-001"]);
|
|
97
|
+
expect(ts[0]).toEqual({
|
|
98
|
+
type: "story-completed",
|
|
99
|
+
companyUid: COMPANY_UID,
|
|
100
|
+
projectName: "my-project",
|
|
101
|
+
storyId: "US-001",
|
|
102
|
+
dedupeKey: `${COMPANY_UID}#my-project#US-001`,
|
|
103
|
+
});
|
|
104
|
+
});
|
|
105
|
+
it("skips a prd with no project name and one with no userStories", () => {
|
|
106
|
+
expect(extractStoryTransitions({ userStories: [{ id: "US-1", passes: true }] }, COMPANY_UID)).toEqual([]);
|
|
107
|
+
expect(extractStoryTransitions({ name: "p" }, COMPANY_UID)).toEqual([]);
|
|
108
|
+
expect(extractStoryTransitions(null, COMPANY_UID)).toEqual([]);
|
|
109
|
+
});
|
|
110
|
+
});
|
|
111
|
+
describe("extractProjectTransitions (→done detection)", () => {
|
|
112
|
+
it("emits only done-status projects, titled by title||id", () => {
|
|
113
|
+
const board = {
|
|
114
|
+
projects: [
|
|
115
|
+
{ id: "p1", title: "Alpha", status: "done", description: "leak?" },
|
|
116
|
+
{ id: "p2", title: "Beta", status: "in_progress" },
|
|
117
|
+
{ id: "p3", status: "completed" }, // no title → falls back to id
|
|
118
|
+
],
|
|
119
|
+
};
|
|
120
|
+
const ts = extractProjectTransitions(board, COMPANY_UID);
|
|
121
|
+
expect(ts.map((t) => t.projectName)).toEqual(["Alpha", "p3"]);
|
|
122
|
+
expect(ts[0].dedupeKey).toBe(`${COMPANY_UID}#Alpha`);
|
|
123
|
+
expect(ts[0].storyId).toBeUndefined();
|
|
124
|
+
});
|
|
125
|
+
});
|
|
126
|
+
describe("toWireRow (transmits nothing beyond name/id/transition — allowlist proof)", () => {
|
|
127
|
+
const ctx = { occurredAt: "2026-07-29T00:00:00.000Z", repo: "hq", branch: "main" };
|
|
128
|
+
it("story-completed carries exactly the allowlisted fields", () => {
|
|
129
|
+
const row = toWireRow({
|
|
130
|
+
type: "story-completed",
|
|
131
|
+
companyUid: COMPANY_UID,
|
|
132
|
+
projectName: "proj",
|
|
133
|
+
storyId: "US-9",
|
|
134
|
+
dedupeKey: `${COMPANY_UID}#proj#US-9`,
|
|
135
|
+
}, ctx);
|
|
136
|
+
expect(new Set(Object.keys(row))).toEqual(new Set(["type", "occurredAt", "companyUid", "repo", "branch", "dedupeKey", "projectName", "storyId"]));
|
|
137
|
+
expect(row).toMatchObject({ type: "story-completed", storyId: "US-9", projectName: "proj" });
|
|
138
|
+
// Defense-in-depth: never leak a person identifier or any content field.
|
|
139
|
+
expect(row).not.toHaveProperty("personUid");
|
|
140
|
+
expect(row).not.toHaveProperty("acceptanceCriteria");
|
|
141
|
+
expect(row).not.toHaveProperty("notes");
|
|
142
|
+
expect(row).not.toHaveProperty("description");
|
|
143
|
+
});
|
|
144
|
+
it("project-shipped carries NO storyId", () => {
|
|
145
|
+
const row = toWireRow({ type: "project-shipped", companyUid: COMPANY_UID, projectName: "proj", dedupeKey: `${COMPANY_UID}#proj` }, ctx);
|
|
146
|
+
expect(new Set(Object.keys(row))).toEqual(new Set(["type", "occurredAt", "companyUid", "repo", "branch", "dedupeKey", "projectName"]));
|
|
147
|
+
expect(row).not.toHaveProperty("storyId");
|
|
148
|
+
});
|
|
149
|
+
});
|
|
150
|
+
describe("wireRowRejectReason (local ingest-limit guard — Fix 2)", () => {
|
|
151
|
+
const base = {
|
|
152
|
+
type: "story-completed",
|
|
153
|
+
occurredAt: "2026-07-29T00:00:00.000Z",
|
|
154
|
+
companyUid: COMPANY_UID,
|
|
155
|
+
repo: "hq",
|
|
156
|
+
branch: "main",
|
|
157
|
+
dedupeKey: `${COMPANY_UID}#p#US-1`,
|
|
158
|
+
projectName: "p",
|
|
159
|
+
storyId: "US-1",
|
|
160
|
+
};
|
|
161
|
+
it("accepts a normal row", () => {
|
|
162
|
+
expect(wireRowRejectReason({ ...base })).toBeNull();
|
|
163
|
+
});
|
|
164
|
+
it("rejects a row whose string field exceeds the char limit", () => {
|
|
165
|
+
const reason = wireRowRejectReason({ ...base, projectName: "x".repeat(MAX_FIELD_CHARS + 1) });
|
|
166
|
+
expect(reason).toContain("projectName");
|
|
167
|
+
expect(reason).toContain(String(MAX_FIELD_CHARS));
|
|
168
|
+
});
|
|
169
|
+
it("rejects a row whose serialized size exceeds the byte limit", () => {
|
|
170
|
+
// Two just-under-field-limit strings still push the event JSON over 4 KB.
|
|
171
|
+
const big = "y".repeat(MAX_FIELD_CHARS);
|
|
172
|
+
const reason = wireRowRejectReason({ ...base, projectName: big, storyId: big });
|
|
173
|
+
expect(reason).toContain(String(MAX_EVENT_BYTES));
|
|
174
|
+
});
|
|
175
|
+
});
|
|
176
|
+
describe("collectAndSendOutcomeTelemetry", () => {
|
|
177
|
+
let root;
|
|
178
|
+
let cursorPath;
|
|
179
|
+
let menubarPath;
|
|
180
|
+
beforeEach(async () => {
|
|
181
|
+
root = await makeHqRoot();
|
|
182
|
+
const dot = await fsp.mkdtemp(path.join(os.tmpdir(), "outcome-dot-"));
|
|
183
|
+
cursorPath = path.join(dot, "outcome-telemetry-cursor.json");
|
|
184
|
+
menubarPath = path.join(dot, "menubar.json");
|
|
185
|
+
});
|
|
186
|
+
afterEach(async () => {
|
|
187
|
+
await fsp.rm(root, { recursive: true, force: true });
|
|
188
|
+
});
|
|
189
|
+
it("opt-in gate: emits nothing when telemetry is disabled", async () => {
|
|
190
|
+
await writePrd(root, "acme", "p", { name: "p", userStories: [{ id: "US-1", passes: true }] });
|
|
191
|
+
const client = makeClient({ optInResponse: { enabled: false, updatedAt: null } });
|
|
192
|
+
const res = await collectAndSendOutcomeTelemetry({ client, hqRoot: root, cursorPath, menubarPath });
|
|
193
|
+
expect(res.enabled).toBe(false);
|
|
194
|
+
expect(client.posts).toHaveLength(0);
|
|
195
|
+
// Cursor is not written when disabled.
|
|
196
|
+
await expect(fsp.readFile(cursorPath, "utf-8")).rejects.toBeTruthy();
|
|
197
|
+
});
|
|
198
|
+
it("opt-in gate: falls back to local menubar.json when the server check throws", async () => {
|
|
199
|
+
await writePrd(root, "acme", "p", { name: "p", userStories: [{ id: "US-1", passes: true }] });
|
|
200
|
+
await fsp.writeFile(menubarPath, JSON.stringify({ telemetryEnabled: true }), "utf-8");
|
|
201
|
+
const client = makeClient({ optInResponse: new Error("network") });
|
|
202
|
+
const res = await collectAndSendOutcomeTelemetry({
|
|
203
|
+
client,
|
|
204
|
+
hqRoot: root,
|
|
205
|
+
cursorPath,
|
|
206
|
+
menubarPath,
|
|
207
|
+
now: () => "2026-07-29T00:00:00.000Z",
|
|
208
|
+
});
|
|
209
|
+
expect(res.optInSource).toBe("menubar-fallback");
|
|
210
|
+
expect(res.eventsSent).toBe(1);
|
|
211
|
+
});
|
|
212
|
+
it("emits a story-completed event for a passing story and a project-shipped event for a done board project", async () => {
|
|
213
|
+
await writePrd(root, "acme", "outcome-leaderboard", {
|
|
214
|
+
name: "outcome-leaderboard",
|
|
215
|
+
userStories: [
|
|
216
|
+
{ id: "US-002", passes: true },
|
|
217
|
+
{ id: "US-003", passes: false },
|
|
218
|
+
],
|
|
219
|
+
});
|
|
220
|
+
await writeBoard(root, "acme", {
|
|
221
|
+
projects: [
|
|
222
|
+
{ id: "in-proj-1", title: "Shipped Thing", status: "done" },
|
|
223
|
+
{ id: "in-proj-2", title: "WIP", status: "in_progress" },
|
|
224
|
+
],
|
|
225
|
+
});
|
|
226
|
+
const client = makeClient();
|
|
227
|
+
const res = await collectAndSendOutcomeTelemetry({
|
|
228
|
+
client,
|
|
229
|
+
hqRoot: root,
|
|
230
|
+
cursorPath,
|
|
231
|
+
menubarPath,
|
|
232
|
+
now: () => "2026-07-29T00:00:00.000Z",
|
|
233
|
+
});
|
|
234
|
+
expect(res.eventsSent).toBe(2);
|
|
235
|
+
expect(client.posts).toHaveLength(1);
|
|
236
|
+
const events = client.posts[0].events;
|
|
237
|
+
const byType = Object.fromEntries(events.map((e) => [e.type, e]));
|
|
238
|
+
expect(byType["story-completed"]).toMatchObject({
|
|
239
|
+
projectName: "outcome-leaderboard",
|
|
240
|
+
storyId: "US-002",
|
|
241
|
+
companyUid: COMPANY_UID,
|
|
242
|
+
dedupeKey: `${COMPANY_UID}#outcome-leaderboard#US-002`,
|
|
243
|
+
});
|
|
244
|
+
expect(byType["project-shipped"]).toMatchObject({
|
|
245
|
+
projectName: "Shipped Thing",
|
|
246
|
+
companyUid: COMPANY_UID,
|
|
247
|
+
dedupeKey: `${COMPANY_UID}#Shipped Thing`,
|
|
248
|
+
});
|
|
249
|
+
});
|
|
250
|
+
it("skips projects belonging to a company that is not cloud-backed", async () => {
|
|
251
|
+
await writePrd(root, "local-only", "p", { name: "p", userStories: [{ id: "US-1", passes: true }] });
|
|
252
|
+
const client = makeClient();
|
|
253
|
+
const res = await collectAndSendOutcomeTelemetry({ client, hqRoot: root, cursorPath, menubarPath });
|
|
254
|
+
expect(res.eventsSent).toBe(0);
|
|
255
|
+
expect(client.posts).toHaveLength(0);
|
|
256
|
+
});
|
|
257
|
+
it("cursor persistence + dedupe: a second sync with no new transition emits nothing", async () => {
|
|
258
|
+
await writePrd(root, "acme", "p", { name: "p", userStories: [{ id: "US-1", passes: true }] });
|
|
259
|
+
const c1 = makeClient();
|
|
260
|
+
const r1 = await collectAndSendOutcomeTelemetry({ client: c1, hqRoot: root, cursorPath, menubarPath });
|
|
261
|
+
expect(r1.eventsSent).toBe(1);
|
|
262
|
+
// Cursor was written and records the emitted transition (confirmed, with a
|
|
263
|
+
// pinned occurredAt and no lingering `pending` flag).
|
|
264
|
+
const cursor = JSON.parse(await fsp.readFile(cursorPath, "utf-8"));
|
|
265
|
+
const entry = cursor.emitted[`${COMPANY_UID}#p#US-1`];
|
|
266
|
+
expect(entry.type).toBe("story-completed");
|
|
267
|
+
expect(typeof entry.occurredAt).toBe("string");
|
|
268
|
+
expect(entry.occurredAt.length).toBeGreaterThan(0);
|
|
269
|
+
expect(entry.pending).toBeUndefined();
|
|
270
|
+
const c2 = makeClient();
|
|
271
|
+
const r2 = await collectAndSendOutcomeTelemetry({ client: c2, hqRoot: root, cursorPath, menubarPath });
|
|
272
|
+
expect(r2.eventsSent).toBe(0);
|
|
273
|
+
expect(c2.posts).toHaveLength(0);
|
|
274
|
+
});
|
|
275
|
+
it("dedupe within a single scan: the same completion in two files emits one event", async () => {
|
|
276
|
+
// Two prd.json with the SAME project name + story id → identical dedupeKey.
|
|
277
|
+
await writePrd(root, "acme", "a", { name: "dup", userStories: [{ id: "US-1", passes: true }] });
|
|
278
|
+
await writePrd(root, "acme", "b", { name: "dup", userStories: [{ id: "US-1", passes: true }] });
|
|
279
|
+
const client = makeClient();
|
|
280
|
+
const res = await collectAndSendOutcomeTelemetry({ client, hqRoot: root, cursorPath, menubarPath });
|
|
281
|
+
expect(res.eventsSent).toBe(1);
|
|
282
|
+
});
|
|
283
|
+
it("emits a NEW event only after a false→true transition on the second sync", async () => {
|
|
284
|
+
const prdPath = await writePrd(root, "acme", "p", {
|
|
285
|
+
name: "p",
|
|
286
|
+
userStories: [{ id: "US-1", passes: false }],
|
|
287
|
+
});
|
|
288
|
+
const c1 = makeClient();
|
|
289
|
+
const r1 = await collectAndSendOutcomeTelemetry({ client: c1, hqRoot: root, cursorPath, menubarPath });
|
|
290
|
+
expect(r1.eventsSent).toBe(0);
|
|
291
|
+
// Flip the story to passing, then sync again.
|
|
292
|
+
await fsp.writeFile(prdPath, JSON.stringify({ name: "p", userStories: [{ id: "US-1", passes: true }] }), "utf-8");
|
|
293
|
+
const c2 = makeClient();
|
|
294
|
+
const r2 = await collectAndSendOutcomeTelemetry({ client: c2, hqRoot: root, cursorPath, menubarPath });
|
|
295
|
+
expect(r2.eventsSent).toBe(1);
|
|
296
|
+
expect(c2.posts[0].events[0]).toMatchObject({ type: "story-completed", storyId: "US-1" });
|
|
297
|
+
});
|
|
298
|
+
it("swallows a POST error and leaves the cursor un-advanced so the row re-sends", async () => {
|
|
299
|
+
await writePrd(root, "acme", "p", { name: "p", userStories: [{ id: "US-1", passes: true }] });
|
|
300
|
+
const failing = makeClient({ postResponse: new Error("boom") });
|
|
301
|
+
// Must not throw — telemetry never blocks sync.
|
|
302
|
+
const res = await collectAndSendOutcomeTelemetry({ client: failing, hqRoot: root, cursorPath, menubarPath });
|
|
303
|
+
expect(res.eventsSent).toBe(0);
|
|
304
|
+
// Cursor did not record the failed transition, so a healthy sync re-sends it.
|
|
305
|
+
const healthy = makeClient();
|
|
306
|
+
const res2 = await collectAndSendOutcomeTelemetry({ client: healthy, hqRoot: root, cursorPath, menubarPath });
|
|
307
|
+
expect(res2.eventsSent).toBe(1);
|
|
308
|
+
});
|
|
309
|
+
it("stable replay timestamp: a re-sent transition reuses the ORIGINAL occurredAt (Fix 1)", async () => {
|
|
310
|
+
await writePrd(root, "acme", "p", { name: "p", userStories: [{ id: "US-1", passes: true }] });
|
|
311
|
+
// Sync 1: POST succeeds server-side but we simulate the cursor CONFIRM being
|
|
312
|
+
// lost — the post-flush cursor write records the entry as `pending` (as if
|
|
313
|
+
// the process died between POST-success and the final confirm-flush). We
|
|
314
|
+
// achieve this by using a client that throws AFTER capturing the batch, so
|
|
315
|
+
// the transition stays `pending` in the cursor with its pinned occurredAt.
|
|
316
|
+
let call = 0;
|
|
317
|
+
const client = {
|
|
318
|
+
posts: [],
|
|
319
|
+
async getTelemetryOptIn() {
|
|
320
|
+
return { enabled: true, updatedAt: null };
|
|
321
|
+
},
|
|
322
|
+
async postOutcomeEvents(batch) {
|
|
323
|
+
this.posts.push(batch);
|
|
324
|
+
call++;
|
|
325
|
+
// First call: capture the batch but throw, so the cursor stays pending
|
|
326
|
+
// with its pinned occurredAt (server may or may not have written it —
|
|
327
|
+
// the emitter must send the SAME occurredAt on retry either way).
|
|
328
|
+
if (call === 1)
|
|
329
|
+
throw new Error("cursor-confirm-lost");
|
|
330
|
+
return { ok: true, written: 0, deduped: 1 };
|
|
331
|
+
},
|
|
332
|
+
};
|
|
333
|
+
let clock = 1000;
|
|
334
|
+
const r1 = await collectAndSendOutcomeTelemetry({
|
|
335
|
+
client,
|
|
336
|
+
hqRoot: root,
|
|
337
|
+
cursorPath,
|
|
338
|
+
menubarPath,
|
|
339
|
+
now: () => new Date(clock).toISOString(),
|
|
340
|
+
});
|
|
341
|
+
expect(r1.eventsSent).toBe(0); // POST threw
|
|
342
|
+
const firstOccurredAt = client.posts[0].events[0].occurredAt;
|
|
343
|
+
expect(typeof firstOccurredAt).toBe("string");
|
|
344
|
+
// The cursor pinned the occurredAt before the POST.
|
|
345
|
+
const pinned = JSON.parse(await fsp.readFile(cursorPath, "utf-8"));
|
|
346
|
+
const entry = pinned.emitted[`${COMPANY_UID}#p#US-1`];
|
|
347
|
+
expect(entry.pending).toBe(true);
|
|
348
|
+
expect(entry.occurredAt).toBe(firstOccurredAt);
|
|
349
|
+
// Sync 2: clock has advanced, but the re-send MUST reuse the pinned
|
|
350
|
+
// occurredAt — otherwise the server stores a duplicate row under a new key.
|
|
351
|
+
clock = 999999;
|
|
352
|
+
const r2 = await collectAndSendOutcomeTelemetry({
|
|
353
|
+
client,
|
|
354
|
+
hqRoot: root,
|
|
355
|
+
cursorPath,
|
|
356
|
+
menubarPath,
|
|
357
|
+
now: () => new Date(clock).toISOString(),
|
|
358
|
+
});
|
|
359
|
+
expect(r2.eventsSent).toBe(1);
|
|
360
|
+
const secondOccurredAt = client.posts[1].events[0].occurredAt;
|
|
361
|
+
expect(secondOccurredAt).toBe(firstOccurredAt); // SAME timestamp, not the advanced clock
|
|
362
|
+
// Now confirmed (no longer pending).
|
|
363
|
+
const confirmed = JSON.parse(await fsp.readFile(cursorPath, "utf-8"));
|
|
364
|
+
const confEntry = confirmed.emitted[`${COMPANY_UID}#p#US-1`];
|
|
365
|
+
expect(confEntry.pending).toBeUndefined();
|
|
366
|
+
expect(confEntry.occurredAt).toBe(firstOccurredAt);
|
|
367
|
+
});
|
|
368
|
+
it("oversized field poisons nothing: valid events in the batch still send, over-limit one is skipped (Fix 2)", async () => {
|
|
369
|
+
const huge = "x".repeat(MAX_FIELD_CHARS + 1);
|
|
370
|
+
// One prd whose project name is over the field limit (its story is valid but
|
|
371
|
+
// the projectName is on every wire row → the row is rejected wholesale), and
|
|
372
|
+
// one perfectly valid prd. The valid one must still send.
|
|
373
|
+
await writePrd(root, "acme", "bad", {
|
|
374
|
+
name: huge,
|
|
375
|
+
userStories: [{ id: "US-1", passes: true }],
|
|
376
|
+
});
|
|
377
|
+
await writePrd(root, "acme", "good", {
|
|
378
|
+
name: "good-project",
|
|
379
|
+
userStories: [{ id: "US-2", passes: true }],
|
|
380
|
+
});
|
|
381
|
+
const skips = [];
|
|
382
|
+
const client = makeClient();
|
|
383
|
+
const res = await collectAndSendOutcomeTelemetry({
|
|
384
|
+
client,
|
|
385
|
+
hqRoot: root,
|
|
386
|
+
cursorPath,
|
|
387
|
+
menubarPath,
|
|
388
|
+
now: () => "2026-07-29T00:00:00.000Z",
|
|
389
|
+
log: (m) => skips.push(m),
|
|
390
|
+
});
|
|
391
|
+
// Exactly the valid outcome went out; the oversized one was dropped.
|
|
392
|
+
expect(res.eventsSent).toBe(1);
|
|
393
|
+
expect(client.posts).toHaveLength(1);
|
|
394
|
+
const ids = client.posts[0].events.map((e) => e.storyId);
|
|
395
|
+
expect(ids).toEqual(["US-2"]);
|
|
396
|
+
// The skip was logged.
|
|
397
|
+
expect(skips.some((m) => m.includes("skipping") && m.includes("US-1"))).toBe(true);
|
|
398
|
+
// The skipped transition is NOT confirmed in the cursor (so if the field is
|
|
399
|
+
// later fixed it can send), and the valid one IS.
|
|
400
|
+
const cursor = JSON.parse(await fsp.readFile(cursorPath, "utf-8"));
|
|
401
|
+
expect(cursor.emitted[`${COMPANY_UID}#good-project#US-2`].type).toBe("story-completed");
|
|
402
|
+
expect(cursor.emitted[`${COMPANY_UID}#${huge}#US-1`]).toBeUndefined();
|
|
403
|
+
});
|
|
404
|
+
it("no hqRoot → no scan, no events (but opt-in still resolved)", async () => {
|
|
405
|
+
const client = makeClient();
|
|
406
|
+
const res = await collectAndSendOutcomeTelemetry({ client, cursorPath, menubarPath });
|
|
407
|
+
expect(res.enabled).toBe(true);
|
|
408
|
+
expect(res.eventsSent).toBe(0);
|
|
409
|
+
expect(client.posts).toHaveLength(0);
|
|
410
|
+
});
|
|
411
|
+
});
|
|
412
|
+
//# sourceMappingURL=outcome-telemetry.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"outcome-telemetry.test.js","sourceRoot":"","sources":["../src/outcome-telemetry.test.ts"],"names":[],"mappings":"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"}
|
package/dist/qmd-reindex.d.ts
CHANGED
|
@@ -16,48 +16,29 @@
|
|
|
16
16
|
*
|
|
17
17
|
* What it does, best-effort and idempotent:
|
|
18
18
|
* 1. Auto-registers any `companies/<slug>/knowledge` dir that isn't yet a
|
|
19
|
-
* qmd collection (kills the manual "map" step).
|
|
19
|
+
* qmd collection (kills the manual "map" step). Detects path drift when
|
|
20
|
+
* the name exists but points elsewhere; repairs only when
|
|
21
|
+
* `HQ_QMD_REPAIR_PATH_DRIFT=1` (non-breaking default: detect-only).
|
|
20
22
|
* 2. Runs an incremental lexical `qmd update` (fast — qmd skips unchanged
|
|
21
23
|
* files by mtime).
|
|
22
24
|
* 3. Rebuilds embeddings only when `embed: true` (slow on a multi-GB
|
|
23
|
-
* index; meant for an idle pass, not every sync).
|
|
25
|
+
* index; meant for an idle pass, not every sync). Never embeds in the
|
|
26
|
+
* same cycle as a path-drift repair (repair drops that collection's
|
|
27
|
+
* vectors).
|
|
24
28
|
*
|
|
25
29
|
* The index itself is never synced — it is large, binary, and embeds absolute
|
|
26
30
|
* local paths. Only its *freshness* is automated here.
|
|
27
31
|
*
|
|
28
|
-
* ## Corruption safety (feedback_b9a369ff)
|
|
32
|
+
* ## Corruption safety (feedback_b9a369ff + feedback_332c7ccc)
|
|
29
33
|
*
|
|
30
|
-
* The qmd store (
|
|
31
|
-
*
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
*
|
|
35
|
-
*
|
|
36
|
-
*
|
|
37
|
-
*
|
|
38
|
-
* runner-spawned `qmd update` overlapped with near certainty.
|
|
39
|
-
*
|
|
40
|
-
* The mitigations here, all inside the runner so every teammate gets them on
|
|
41
|
-
* their next sync:
|
|
42
|
-
* - The exec timeout is raised substantially so a legitimate long pass is no
|
|
43
|
-
* longer killed mid-write in the first place. A timed-out pass is treated as
|
|
44
|
-
* "not done" (left dirty, retried next cycle) and NEVER advances to embed.
|
|
45
|
-
* That not-done handling — together with the writer serialization below — is
|
|
46
|
-
* the real protection; the signal used for the (now rare) kill is secondary.
|
|
47
|
-
* When the bound does fire the child is sent SIGINT rather than the default
|
|
48
|
-
* SIGTERM, but qmd 2.5.3 traps both identically (each just restores the
|
|
49
|
-
* cursor and exits), so this is only the same clean exit path qmd takes on
|
|
50
|
-
* Ctrl-C — not a guarantee the in-flight SQLite write unwinds.
|
|
51
|
-
* - A shared advisory lock at `<hqRoot>/.qmd/.reindex.lock` serializes qmd
|
|
52
|
-
* writers. The runner takes it before touching qmd and SKIPS the cycle (and
|
|
53
|
-
* marks the tree dirty so the next sync retries) when another writer holds
|
|
54
|
-
* it. The lock path sits next to the DB so interactive HQ qmd maintenance
|
|
55
|
-
* can honor the same rendezvous.
|
|
56
|
-
* - Corruption is detected cheaply from qmd's own output (the SQLITE_CORRUPT
|
|
57
|
-
* signature). On detection the corrupt DB files are quarantined aside (moved
|
|
58
|
-
* to `index.sqlite.corrupt-<ts>`, never deleted) and the cycle stops writing
|
|
59
|
-
* so a clean rebuild happens on the next pass — instead of writing further
|
|
60
|
-
* onto an already-damaged store.
|
|
34
|
+
* The qmd store (sqlite-vec) was being corrupted on the vector side because
|
|
35
|
+
* TWO uncoordinated writers raced on it. Mitigations:
|
|
36
|
+
* - Raised exec timeout so legitimate long passes are not killed mid-write.
|
|
37
|
+
* - Dual advisory lock: legacy `<hqRoot>/.qmd/.reindex.lock` AND
|
|
38
|
+
* `<resolvedIndexDir>/.reindex.lock` (deduped when equal). Default index
|
|
39
|
+
* is often `~/.cache/qmd/index.sqlite`, not `<hqRoot>/.qmd`.
|
|
40
|
+
* - Corruption quarantine targets the resolved index dir; reports success
|
|
41
|
+
* only when files were actually moved.
|
|
61
42
|
*/
|
|
62
43
|
/** Result of a single `qmd` invocation. */
|
|
63
44
|
export interface QmdExecResult {
|
|
@@ -84,6 +65,17 @@ export interface QmdExec {
|
|
|
84
65
|
export declare const DEFAULT_QMD_EXEC_TIMEOUT_MS = 900000;
|
|
85
66
|
/** Resolve the exec timeout, honoring `HQ_QMD_EXEC_TIMEOUT_MS` (ms) if valid. */
|
|
86
67
|
export declare function resolveExecTimeoutMs(env?: NodeJS.ProcessEnv): number;
|
|
68
|
+
/** Opt-in destructive path-drift repair (remove + re-add). Default off. */
|
|
69
|
+
export declare function repairPathDriftEnabled(env?: NodeJS.ProcessEnv): boolean;
|
|
70
|
+
/**
|
|
71
|
+
* Parse the directory that holds `index.sqlite` from `qmd status` output.
|
|
72
|
+
* Returns null when the Index line is missing/unparseable.
|
|
73
|
+
*/
|
|
74
|
+
export declare function parseIndexDirFromStatus(stdout: string): string | null;
|
|
75
|
+
/** Parse `Path:` from `qmd collection show` human output. */
|
|
76
|
+
export declare function parseCollectionPathFromShow(stdout: string): string | null;
|
|
77
|
+
/** Case-insensitive, trailing-separator-tolerant path equality after realpath. */
|
|
78
|
+
export declare function pathsEquivalent(a: string, b: string, realpathSync?: (p: string) => string): boolean;
|
|
87
79
|
/** True if a qmd result reports SQLite corruption on stdout or stderr. */
|
|
88
80
|
export declare function looksCorrupt(r: Partial<Pick<QmdExecResult, "stdout" | "stderr">>): boolean;
|
|
89
81
|
/** Handle returned by an acquired reindex lock. `release()` is idempotent. */
|
|
@@ -96,6 +88,15 @@ export interface ReindexLockHandle {
|
|
|
96
88
|
* cycle). Must never throw — coordination is advisory and must not fail a sync.
|
|
97
89
|
*/
|
|
98
90
|
export type AcquireReindexLock = (lockPath: string) => ReindexLockHandle | null;
|
|
91
|
+
/**
|
|
92
|
+
* Acquire unique lock paths (legacy + resolved index). If any is busy, release
|
|
93
|
+
* what was acquired and return busy. Dedupes when both paths are the same so a
|
|
94
|
+
* process never O_EXCL-locks itself out.
|
|
95
|
+
*/
|
|
96
|
+
export declare function acquireDualReindexLocks(acquireLock: AcquireReindexLock, lockPaths: string[]): {
|
|
97
|
+
locks: ReindexLockHandle[];
|
|
98
|
+
busy: boolean;
|
|
99
|
+
};
|
|
99
100
|
/** Move corrupt DB files aside (never delete) so a clean rebuild can follow. */
|
|
100
101
|
export type QuarantineCorruptIndex = (qmdDir: string, timestampSuffix: string) => string | null;
|
|
101
102
|
export interface ReindexOptions {
|
|
@@ -126,6 +127,10 @@ export interface ReindexOptions {
|
|
|
126
127
|
acquireReindexLock?: AcquireReindexLock;
|
|
127
128
|
/** Corrupt-index quarantine override for tests. */
|
|
128
129
|
quarantineCorruptIndex?: QuarantineCorruptIndex;
|
|
130
|
+
/** realpath override for path-drift comparison in tests. */
|
|
131
|
+
realpathSync?: (p: string) => string;
|
|
132
|
+
/** Env override for tests (repair flag, etc.). */
|
|
133
|
+
env?: NodeJS.ProcessEnv;
|
|
129
134
|
/** Optional diagnostic sink for unexpected swallowed failures. */
|
|
130
135
|
log?: (diagnostic: {
|
|
131
136
|
event: string;
|
|
@@ -137,6 +142,10 @@ export interface ReindexOptions {
|
|
|
137
142
|
export interface ReindexResult {
|
|
138
143
|
qmdAvailable: boolean;
|
|
139
144
|
collectionsAdded: string[];
|
|
145
|
+
/** HQ-convention collections whose registered path differs from desired. */
|
|
146
|
+
pathDriftDetected: string[];
|
|
147
|
+
/** Collections successfully remove+re-added when repair was enabled. */
|
|
148
|
+
collectionsRepaired: string[];
|
|
140
149
|
updated: boolean;
|
|
141
150
|
embedded: boolean;
|
|
142
151
|
pendingDirty: boolean;
|
|
@@ -144,8 +153,12 @@ export interface ReindexResult {
|
|
|
144
153
|
lockBusy: boolean;
|
|
145
154
|
/** True when a qmd command exceeded the exec timeout and was aborted. */
|
|
146
155
|
timedOut: boolean;
|
|
147
|
-
/** True when a corrupt index was detected and
|
|
156
|
+
/** True when a corrupt index was detected and files were quarantined. */
|
|
148
157
|
corruptionQuarantined: boolean;
|
|
158
|
+
/** True when corruption was detected but quarantine moved nothing. */
|
|
159
|
+
corruptionQuarantineFailed: boolean;
|
|
160
|
+
/** Directory used for quarantine / index-side lock (resolved or fallback). */
|
|
161
|
+
indexDir: string | null;
|
|
149
162
|
}
|
|
150
163
|
/**
|
|
151
164
|
* Reindex qmd for an HQ tree after a sync. Never throws — all failures are
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"qmd-reindex.d.ts","sourceRoot":"","sources":["../src/qmd-reindex.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"qmd-reindex.d.ts","sourceRoot":"","sources":["../src/qmd-reindex.ts"],"names":[],"mappings":"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"}
|