@kenkaiiii/ggcoder 5.73.0 → 5.74.0

package/dist/core/checklist-items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checklist-items.js","sourceRoot":"","sources":["../../src/core/checklist-items.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,yEAAyE;AACzE,wDAAwD;AAExD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEvC,2FAA2F;AAC3F,MAAM,CAAC,MAAM,cAAc,GAAG,oBAAoB,CAAC;AAEnD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,aAAa;IACb,gBAAgB;IAChB,cAAc;IACd,aAAa;IACb,QAAQ;IACR,aAAa;IACb,UAAU;CACF,CAAC;AAkBX,gCAAgC;AAChC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B;QACE,EAAE,EAAE,aAAa;QACjB,KAAK,EAAE,aAAa;QACpB,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,+FAA+F;QACjG,KAAK,EACH,oKAAoK;QACtK,YAAY,EAAE,MAAM;KACrB;IACD;QACE,EAAE,EAAE,MAAM;QACV,KAAK,EAAE,aAAa;QACpB,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,4EAA4E;QACzF,KAAK,EACH,8IAA8I;KACjJ;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,aAAa;QACpB,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,qEAAqE;QAClF,KAAK,EACH,8KAA8K;QAChL,KAAK,EAAE,iBAAiB;KACzB;IACD;QACE,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,gBAAgB;QACvB,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,2EAA2E;QACxF,KAAK,EACH,4NAA4N;QAC9N,YAAY,EAAE,UAAU;KACzB;IACD;QACE,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,gBAAgB;QACvB,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,gFAAgF;QAC7F,KAAK,EACH,iKAAiK;QACnK,KAAK,EAAE,aAAa;KACrB;IACD;QACE,EAAE,EAAE,eAAe;QACnB,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE,4BAA4B;QACnC,WAAW,EAAE,2EAA2E;QACxF,KAAK,EACH,oIAAoI;KACvI;IACD;QACE,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,6EAA6E;QAC1F,KAAK,EACH,kHAAkH;QACpH,KAAK,EAAE,KAAK;KACb;IACD;QACE,EAAE,EAAE,IAAI;QACR,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE,IAAI;QACX,WAAW,EAAE,kFAAkF;QAC/F,KAAK,EACH,sLAAsL;QACxL,YAAY,EAAE,UAAU;KACzB;IACD;QACE,EAAE,EAAE,aAAa;QACjB,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,mFAAmF;QACrF,KAAK,EACH,iGAAiG;QACnG,YAAY,EAAE,cAAc;KAC7B;IACD;QACE,EAAE,EAAE,aAAa;QACjB,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,wFAAwF;QAC1F,KAAK,EACH,wHAAwH;QAC1H,KAAK,EAAE,aAAa;KACrB;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,mFAAmF;QACrF,KAAK,EACH,8JAA8J;KACjK;IACD;QACE,EAAE,EAAE,cAAc;QAClB,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,uDAAuD;QACpE,KAAK,EACH,uIAAuI;QACzI,KAAK,EAAE,aAAa;KACrB;IACD;QACE,EAAE,EAAE,eAAe;QACnB,KAAK,EAAE,aAAa;QACpB,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,sFAAsF;QACxF,KAAK,EACH,4IAA4I;QAC9I,KAAK,EAAE,iBAAiB;KACzB;IACD;QACE,EAAE,EAAE,qBAAqB;QACzB,KAAK,EAAE,aAAa;QACpB,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,0EAA0E;QACvF,KAAK,EACH,oIAAoI;QACtI,KAAK,EAAE,iBAAiB;KACzB;IACD;QACE,EAAE,EAAE,oBAAoB;QACxB,KAAK,EAAE,aAAa;QACpB,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,iFAAiF;QAC9F,KAAK,EACH,yHAAyH;QAC3H,KAAK,EAAE,iBAAiB;KACzB;IACD;QACE,EAAE,EAAE,eAAe;QACnB,KAAK,EAAE,aAAa;QACpB,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,mFAAmF;QACrF,KAAK,EACH,6JAA6J;QAC/J,KAAK,EAAE,iBAAiB;KACzB;IACD;QACE,EAAE,EAAE,WAAW;QACf,KAAK,EAAE,aAAa;QACpB,KAAK,EAAE,+BAA+B;QACtC,WAAW,EACT,2FAA2F;QAC7F,KAAK,EACH,qIAAqI;QACvI,KAAK,EAAE,iBAAiB;KACzB;IACD;QACE,EAAE,EAAE,UAAU;QACd,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,wDAAwD;QACrE,KAAK,EAAE,+DAA+D;QACtE,KAAK,EAAE,aAAa;KACrB;IACD;QACE,EAAE,EAAE,aAAa;QACjB,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,+EAA+E;QAC5F,KAAK,EACH,kKAAkK;QACpK,KAAK,EAAE,SAAS;KACjB;IACD;QACE,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,uEAAuE;QACpF,KAAK,EACH,0JAA0J;QAC5J,KAAK,EAAE,kBAAkB;KAC1B;IACD;QACE,EAAE,EAAE,aAAa;QACjB,KAAK,EAAE,aAAa;QACpB,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,2DAA2D;QACxE,KAAK,EAAE,kEAAkE;QACzE,KAAK,EAAE,MAAM;KACd;IACD;QACE,EAAE,EAAE,eAAe;QACnB,KAAK,EAAE,UAAU;QACjB,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,+EAA+E;QAC5F,KAAK,EACH,kJAAkJ;KACrJ;IACD;QACE,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,UAAU;QACjB,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,0EAA0E;QACvF,KAAK,EACH,sLAAsL;KACzL;CAC0C,CAAC;AAI9C,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAGjE,CAAC;AAEF,MAAM,WAAW,GAAuC,IAAI,GAAG,CAC7D,eAAe,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAC/C,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,EAAU;IACzC,OAAO,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/dist/core/checklist-prompt.d.ts

@@ -0,0 +1,3 @@
+import { type ChecklistItem } from "./checklist-items.js";
+/** Instructions for checking one checklist item, report-only, recorded through the `checklist` tool. */
+export declare function checklistRunPrompt(item: ChecklistItem): string;

package/dist/core/checklist-prompt.js

@@ -0,0 +1,34 @@
+// The prompt the app's Checklist screen sends when the user checks one item.
+// Generated from the item definition so it can't drift from the list.
+import { CHECKLIST_FILE, CHECKLIST_STALE_DAYS } from "./checklist-items.js";
+/** Instructions for checking one checklist item, report-only, recorded through the `checklist` tool. */
+export function checklistRunPrompt(item) {
+    const skillStep = item.skill
+        ? `Load the \`${item.skill}\` skill with the \`skill\` tool and follow its method in report-only mode.`
+        : "No skill applies; use your own judgment.";
+    const setupNote = item.setupCommand
+        ? ` Say that \`/${item.setupCommand}\` would fix most gaps.`
+        : "";
+    return `# Checklist: ${item.title}
+
+Check this project for one item of its health checklist and report in plain words. Results are stored in \`${CHECKLIST_FILE}\` at the project root and become due again after ${CHECKLIST_STALE_DAYS} days.
+
+**Check and report only. Do not edit, create, delete, install or commit any project file. Only the \`checklist\` tool writes the record.**
+
+## The item
+
+- id: \`${item.id}\`
+- group: ${item.group}
+- what to check: ${item.check}
+
+## Steps
+
+1. The \`checklist\` tool is loaded on demand. Call \`tool_search\` with the query "checklist" first.
+2. Profile the project briefly: what it is, its stack, whether it has a UI, a deployment, user data.
+3. Decide whether the item applies. If it clearly doesn't (for example design items for a project with no UI), record \`not-applicable\` with a one-line reason and stop.
+4. ${skillStep}
+5. Inspect the code and config, and run the project's real checks where relevant (lint, typecheck, tests, audits). Don't guess what a command would print: run it. Configuration being present is not a passing check. Do not run fix/write flags or checks that would alter project files.
+6. Report in plain words: a bold verdict limited to the reviewed scope, then each finding with file:line, severity and a suggested fix.${setupNote} State what you checked and what you did not check. Never describe a project as safe or fully covered merely because this review found no issues.
+7. Call \`checklist\` with \`action: "record"\`, \`id: "${item.id}"\`, \`result\` (\`pass\`, \`issues\` or \`not-applicable\`), a one-line \`summary\`, the \`findings\` (required for \`issues\`, empty for \`pass\`) and \`evidence\`: the commands you ran with their outcome, the files you read, and the skill you loaded. Include one evidence line beginning \`Scope:\` and another beginning \`Not checked:\` describing exclusions or missing access. Loading a skill alone is not review evidence. Keep any limited scope explicit in the summary; a narrow check must not claim to resolve unrelated findings from an earlier review. The tool stamps the date and commit itself.`;
+}
+//# sourceMappingURL=checklist-prompt.js.map

package/dist/core/checklist-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checklist-prompt.js","sourceRoot":"","sources":["../../src/core/checklist-prompt.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,sEAAsE;AAEtE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAsB,MAAM,sBAAsB,CAAC;AAEhG,wGAAwG;AACxG,MAAM,UAAU,kBAAkB,CAAC,IAAmB;IACpD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK;QAC1B,CAAC,CAAC,cAAc,IAAI,CAAC,KAAK,6EAA6E;QACvG,CAAC,CAAC,0CAA0C,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY;QACjC,CAAC,CAAC,gBAAgB,IAAI,CAAC,YAAY,yBAAyB;QAC5D,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,gBAAgB,IAAI,CAAC,KAAK;;6GAE0E,cAAc,qDAAqD,oBAAoB;;;;;;UAM1L,IAAI,CAAC,EAAE;WACN,IAAI,CAAC,KAAK;mBACF,IAAI,CAAC,KAAK;;;;;;;KAOxB,SAAS;;yIAE2H,SAAS;0DACxF,IAAI,CAAC,EAAE,4lBAA4lB,CAAC;AAC9pB,CAAC"}

package/dist/core/checklist-snapshot.d.ts

@@ -0,0 +1,13 @@
+import { type ChecklistDetection } from "./checklist-detection.js";
+import { type ChecklistRow, type Result } from "./checklist-store.js";
+export interface ChecklistSnapshotRow extends ChecklistRow {
+    readonly detection: ChecklistDetection | null;
+    readonly runPrompt: string | null;
+}
+export interface ChecklistSnapshot {
+    readonly staleAfterDays: number;
+    readonly detectionWarnings: readonly string[];
+    readonly items: readonly ChecklistSnapshotRow[];
+}
+/** Read-only snapshot shared by the app and the agent tool. */
+export declare function readChecklistSnapshot(cwd: string, now: Date, signal?: AbortSignal): Promise<Result<ChecklistSnapshot>>;

package/dist/core/checklist-snapshot.js

@@ -0,0 +1,29 @@
+import { CHECKLIST_ITEMS, CHECKLIST_STALE_DAYS, getChecklistItem } from "./checklist-items.js";
+import { detectChecklist } from "./checklist-detection.js";
+import { checklistRunPrompt } from "./checklist-prompt.js";
+import { checklistView, readChecklist } from "./checklist-store.js";
+/** Read-only snapshot shared by the app and the agent tool. */
+export async function readChecklistSnapshot(cwd, now, signal) {
+    const [record, detection] = await Promise.all([
+        readChecklist(cwd, now, signal),
+        detectChecklist(cwd, signal),
+    ]);
+    if (!record.ok)
+        return record;
+    return {
+        ok: true,
+        value: {
+            staleAfterDays: CHECKLIST_STALE_DAYS,
+            detectionWarnings: detection.warnings,
+            items: checklistView(CHECKLIST_ITEMS, record.value, now).map((row) => {
+                const item = getChecklistItem(row.id);
+                return {
+                    ...row,
+                    detection: detection.items[row.id] ?? null,
+                    runPrompt: item ? checklistRunPrompt(item) : null,
+                };
+            }),
+        },
+    };
+}
+//# sourceMappingURL=checklist-snapshot.js.map

package/dist/core/checklist-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checklist-snapshot.js","sourceRoot":"","sources":["../../src/core/checklist-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC/F,OAAO,EAAE,eAAe,EAA2B,MAAM,0BAA0B,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAkC,MAAM,sBAAsB,CAAC;AAYpG,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAW,EACX,GAAS,EACT,MAAoB;IAEpB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC5C,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC;QAC/B,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC;KAC7B,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC;IAC9B,OAAO;QACL,EAAE,EAAE,IAAI;QACR,KAAK,EAAE;YACL,cAAc,EAAE,oBAAoB;YACpC,iBAAiB,EAAE,SAAS,CAAC,QAAQ;YACrC,KAAK,EAAE,aAAa,CAAC,eAAe,EAAE,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBACnE,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACtC,OAAO;oBACL,GAAG,GAAG;oBACN,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI;oBAC1C,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;iBAClD,CAAC;YACJ,CAAC,CAAC;SACH;KACF,CAAC;AACJ,CAAC"}

package/dist/core/checklist-store.d.ts

@@ -0,0 +1,59 @@
+import { type ChecklistItem } from "./checklist-items.js";
+export declare const CHECKLIST_RESULTS: readonly ["pass", "issues", "not-applicable"];
+export type ChecklistResult = (typeof CHECKLIST_RESULTS)[number];
+export type ChecklistStatus = "not-run" | "not-applicable" | "due" | "passed" | "needs-work";
+export declare const SUMMARY_MAX = 300;
+export declare const FINDING_MAX = 300;
+export declare const EVIDENCE_MAX = 200;
+export declare const LIST_MAX = 10;
+export interface ChecklistEntry {
+    readonly checkedAt: string;
+    readonly commit: string | null;
+    readonly uncommittedChanges: boolean;
+    readonly result: ChecklistResult;
+    readonly summary: string;
+    readonly findings: readonly string[];
+    readonly evidence: readonly string[];
+}
+export interface ChecklistRecord {
+    readonly version: 1;
+    readonly items: Readonly<Record<string, ChecklistEntry>>;
+}
+export type Result<T, E = string> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: E;
+};
+export declare function checklistPath(cwd: string): string;
+/**
+ * Read and validate the record. A missing file is an empty record; a file that
+ * is not valid JSON (or not a version-1 record) is an error, so a write never
+ * silently replaces a teammate's data. Invalid entries are dropped, not fatal.
+ */
+export declare function readChecklist(cwd: string, now: Date, signal?: AbortSignal): Promise<Result<ChecklistRecord>>;
+/** Canonical JSON: ids sorted, fixed key order, 2-space indent, trailing newline. */
+export declare function serializeChecklist(record: ChecklistRecord): string;
+/** Lock the whole read/merge/write transaction, then replace the record atomically. */
+export declare function writeChecklistEntry(cwd: string, id: string, entry: ChecklistEntry, now: Date, signal?: AbortSignal): Promise<Result<ChecklistRecord>>;
+export declare function checklistStatus(entry: ChecklistEntry | undefined, now: Date): ChecklistStatus;
+export interface ChecklistRow {
+    readonly id: string;
+    readonly group: ChecklistItem["group"];
+    readonly title: string;
+    readonly description: string;
+    readonly check: string;
+    readonly skill: string | null;
+    readonly setupCommand: string | null;
+    readonly status: ChecklistStatus;
+    readonly checkedAt: string | null;
+    readonly commit: string | null;
+    readonly uncommittedChanges: boolean;
+    readonly result: ChecklistResult | null;
+    readonly summary: string | null;
+    readonly findings: readonly string[];
+    readonly evidence: readonly string[];
+}
+/** Every item in list order, joined with its recorded entry and current status. */
+export declare function checklistView(items: readonly ChecklistItem[], record: ChecklistRecord, now: Date): ChecklistRow[];

package/dist/core/checklist-store.js

@@ -0,0 +1,242 @@
+// Read/write the project health checklist record (`<project>/.gg-checklist.json`).
+// The file is shared through Git, so it is treated as untrusted on the way in:
+// every entry is validated, unknown ids and bad dates are dropped, long text is
+// clipped. Writes are atomic (temp file + rename) and canonical (sorted ids,
+// fixed key order) so diffs between teammates stay small.
+import { randomUUID } from "node:crypto";
+import { constants } from "node:fs";
+import fs, {} from "node:fs/promises";
+import path from "node:path";
+import { setTimeout as delay } from "node:timers/promises";
+import { z } from "zod";
+import { CHECKLIST_FILE, CHECKLIST_STALE_DAYS, getChecklistItem, } from "./checklist-items.js";
+export const CHECKLIST_RESULTS = ["pass", "issues", "not-applicable"];
+export const SUMMARY_MAX = 300;
+export const FINDING_MAX = 300;
+export const EVIDENCE_MAX = 200;
+export const LIST_MAX = 10;
+/** Accept teammates' clocks running a little ahead; anything further is bogus. */
+const FUTURE_SLACK_MS = 24 * 60 * 60 * 1000;
+const STALE_MS = CHECKLIST_STALE_DAYS * 24 * 60 * 60 * 1000;
+const MAX_FILE_BYTES = 1024 * 1024;
+const clip = (max) => z.string().transform((s) => (s.length > max ? s.slice(0, max) : s));
+const clippedList = (max) => z
+    .array(z.unknown())
+    .catch([])
+    .transform((list) => list
+    .filter((v) => typeof v === "string" && v.trim() !== "")
+    .slice(0, LIST_MAX)
+    .map((s) => (s.length > max ? s.slice(0, max) : s)));
+const StoredEntry = z.object({
+    checkedAt: z.string().refine((s) => Number.isFinite(Date.parse(s))),
+    commit: z
+        .string()
+        .regex(/^[0-9a-f]{4,64}$/)
+        .nullable()
+        .catch(null),
+    uncommittedChanges: z.boolean().catch(false),
+    result: z.enum(CHECKLIST_RESULTS),
+    summary: clip(SUMMARY_MAX).catch(""),
+    findings: clippedList(FINDING_MAX),
+    evidence: clippedList(EVIDENCE_MAX),
+});
+const StoredFile = z.object({
+    version: z.literal(1),
+    items: z.record(z.string(), z.unknown()),
+});
+export function checklistPath(cwd) {
+    return path.join(cwd, CHECKLIST_FILE);
+}
+const EMPTY = { version: 1, items: {} };
+/**
+ * Read and validate the record. A missing file is an empty record; a file that
+ * is not valid JSON (or not a version-1 record) is an error, so a write never
+ * silently replaces a teammate's data. Invalid entries are dropped, not fatal.
+ */
+export async function readChecklist(cwd, now, signal) {
+    let raw;
+    let handle;
+    try {
+        if (signal?.aborted)
+            return { ok: false, error: "Checklist read cancelled" };
+        const file = checklistPath(cwd);
+        const link = await fs.lstat(file);
+        if (link.isSymbolicLink() || !link.isFile()) {
+            return { ok: false, error: `${CHECKLIST_FILE} must be a regular file, not a link` };
+        }
+        handle = await fs.open(file, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
+        const stat = await handle.stat();
+        if (!stat.isFile())
+            return { ok: false, error: `${CHECKLIST_FILE} must be a regular file` };
+        if (stat.size > MAX_FILE_BYTES) {
+            return { ok: false, error: `${CHECKLIST_FILE} is larger than 1 MB` };
+        }
+        const buffer = Buffer.alloc(MAX_FILE_BYTES + 1);
+        let length = 0;
+        while (length < buffer.length) {
+            if (signal?.aborted)
+                return { ok: false, error: "Checklist read cancelled" };
+            const { bytesRead } = await handle.read(buffer, length, buffer.length - length, null);
+            if (bytesRead === 0)
+                break;
+            length += bytesRead;
+        }
+        if (length > MAX_FILE_BYTES)
+            return { ok: false, error: `${CHECKLIST_FILE} is larger than 1 MB` };
+        raw = buffer.subarray(0, length).toString("utf-8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return { ok: true, value: EMPTY };
+        return { ok: false, error: `Could not read ${CHECKLIST_FILE}: ${err.message}` };
+    }
+    finally {
+        await handle?.close();
+    }
+    let json;
+    try {
+        json = JSON.parse(raw);
+    }
+    catch {
+        return { ok: false, error: `${CHECKLIST_FILE} is not valid JSON` };
+    }
+    const file = StoredFile.safeParse(json);
+    if (!file.success) {
+        return { ok: false, error: `${CHECKLIST_FILE} is not a version 1 checklist record` };
+    }
+    const items = {};
+    const latest = now.getTime() + FUTURE_SLACK_MS;
+    for (const [id, value] of Object.entries(file.data.items)) {
+        if (!getChecklistItem(id))
+            continue;
+        const entry = StoredEntry.safeParse(value);
+        if (!entry.success)
+            continue;
+        const checked = Date.parse(entry.data.checkedAt);
+        if (checked > latest)
+            continue;
+        items[id] = { ...entry.data, checkedAt: new Date(checked).toISOString() };
+    }
+    return { ok: true, value: { version: 1, items } };
+}
+/** Canonical JSON: ids sorted, fixed key order, 2-space indent, trailing newline. */
+export function serializeChecklist(record) {
+    const items = {};
+    for (const id of Object.keys(record.items).sort()) {
+        const e = record.items[id];
+        if (!e)
+            continue;
+        items[id] = {
+            checkedAt: e.checkedAt,
+            commit: e.commit,
+            uncommittedChanges: e.uncommittedChanges,
+            result: e.result,
+            summary: e.summary,
+            findings: [...e.findings],
+            evidence: [...e.evidence],
+        };
+    }
+    return JSON.stringify({ version: 1, items }, null, 2) + "\n";
+}
+/** Atomic directory creation serializes distinct tools/processes, not just one session.
+ * Fail closed on a busy/interrupted writer; never steal a live lock after a timeout. */
+async function acquireWriteLock(lockPath, signal) {
+    const started = performance.now();
+    while (true) {
+        if (signal?.aborted)
+            return { ok: false, error: "Checklist recording cancelled" };
+        try {
+            await fs.mkdir(lockPath);
+            return { ok: true, value: undefined };
+        }
+        catch (error) {
+            if (error.code !== "EEXIST") {
+                return {
+                    ok: false,
+                    error: `Could not lock ${CHECKLIST_FILE}: ${error.message}`,
+                };
+            }
+        }
+        if (performance.now() - started >= 2500) {
+            return {
+                ok: false,
+                error: `${CHECKLIST_FILE} is locked by another or interrupted write. Retry after it finishes; an interrupted write may require removing ${CHECKLIST_FILE}.lock when no checks are running.`,
+            };
+        }
+        try {
+            await delay(25, undefined, signal ? { signal } : undefined);
+        }
+        catch {
+            return { ok: false, error: "Checklist recording cancelled" };
+        }
+    }
+}
+/** Lock the whole read/merge/write transaction, then replace the record atomically. */
+export async function writeChecklistEntry(cwd, id, entry, now, signal) {
+    if (!getChecklistItem(id))
+        return { ok: false, error: `Unknown checklist item: ${id}` };
+    const target = checklistPath(cwd);
+    const lockPath = `${target}.lock`;
+    const locked = await acquireWriteLock(lockPath, signal);
+    if (!locked.ok)
+        return locked;
+    const temp = `${target}.${process.pid}.${randomUUID()}.tmp`;
+    try {
+        const current = await readChecklist(cwd, now, signal);
+        if (!current.ok)
+            return current;
+        const next = { version: 1, items: { ...current.value.items, [id]: entry } };
+        await fs.writeFile(temp, serializeChecklist(next), {
+            encoding: "utf-8",
+            flag: "wx",
+            ...(signal ? { signal } : {}),
+        });
+        if (signal?.aborted)
+            return { ok: false, error: "Checklist recording cancelled" };
+        await fs.rename(temp, target);
+        return { ok: true, value: next };
+    }
+    catch (err) {
+        return { ok: false, error: `Could not write ${CHECKLIST_FILE}: ${err.message}` };
+    }
+    finally {
+        await fs.rm(temp, { force: true }).catch(() => { });
+        await fs.rmdir(lockPath);
+    }
+}
+export function checklistStatus(entry, now) {
+    if (!entry)
+        return "not-run";
+    const checked = Date.parse(entry.checkedAt);
+    if (!Number.isFinite(checked) || checked > now.getTime() + FUTURE_SLACK_MS)
+        return "not-run";
+    if (entry.result === "not-applicable")
+        return "not-applicable";
+    if (now.getTime() - checked > STALE_MS)
+        return "due";
+    return entry.result === "pass" ? "passed" : "needs-work";
+}
+/** Every item in list order, joined with its recorded entry and current status. */
+export function checklistView(items, record, now) {
+    return items.map((item) => {
+        const entry = record.items[item.id];
+        return {
+            id: item.id,
+            group: item.group,
+            title: item.title,
+            description: item.description,
+            check: item.check,
+            skill: item.skill ?? null,
+            setupCommand: item.setupCommand ?? null,
+            status: checklistStatus(entry, now),
+            checkedAt: entry?.checkedAt ?? null,
+            commit: entry?.commit ?? null,
+            uncommittedChanges: entry?.uncommittedChanges ?? false,
+            result: entry?.result ?? null,
+            summary: entry?.summary ?? null,
+            findings: entry?.findings ?? [],
+            evidence: entry?.evidence ?? [],
+        };
+    });
+}
+//# sourceMappingURL=checklist-store.js.map

package/dist/core/checklist-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checklist-store.js","sourceRoot":"","sources":["../../src/core/checklist-store.ts"],"names":[],"mappings":"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"}

package/dist/core/lsp/client.d.ts

@@ -55,6 +55,7 @@ export interface LspSymbolEntry {
 export type LspRequestOutcome<T> = {
     status: "ok";
     value: T;
+    warning?: string;
 } | {
     status: "unsupported";
 } | {
@@ -115,6 +116,7 @@ export declare class LspClient {
     private alive;
     private readonly initializationOptions;
     private stderrBuffer;
+    private referenceProjectFiles;
     constructor(spec: LspServerSpec, rootPath: string, command: ResolvedCommand);
     get isAlive(): boolean;
     /** True while the server reports indexing/analysis through LSP work progress. */
@@ -158,6 +160,8 @@ export declare class LspClient {
     definition(uri: string, position: LspPosition, timeoutMs: number): Promise<LspRequestOutcome<LspLocation[]>>;
     /** Every reference to the symbol at `position`, declaration included. */
     references(uri: string, position: LspPosition, timeoutMs: number, includeDeclaration?: boolean): Promise<LspRequestOutcome<LspLocation[]>>;
+    /** Include unopened callers without creating configs or opening stale editor buffers. */
+    private prepareReferenceProject;
     /** Flattened symbol outline for a whole document. */
     documentSymbols(uri: string, timeoutMs: number): Promise<LspRequestOutcome<LspSymbolEntry[]>>;
     /** Type/signature summary at `position`, as plain text. */

package/dist/core/lsp/client.js

@@ -1,5 +1,8 @@
 import { spawn } from "node:child_process";
-import { pathToFileURL } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import path from "node:path";
+import { z } from "zod";
+import { collectReferenceProjectFiles } from "./reference-project.js";
 import { JsonRpcConnection, JsonRpcRequestError } from "./jsonrpc.js";
 import { getSafeToolEnv } from "../../tools/safe-env.js";
 import { killProcessTree } from "../../utils/process.js";
@@ -14,6 +17,11 @@ const REQUEST_TIMED_OUT = -32803;
 const PULL_POLL_INTERVAL_MS = 300;
 /** Bounded stderr retained per server for failure diagnostics. */
 const STDERR_TAIL_BYTES = 4000;
+const ProjectInfoReply = z.object({
+    success: z.literal(true),
+    body: z.object({ configFileName: z.string(), languageServiceDisabled: z.boolean().optional() }),
+});
+const PARTIAL_REFERENCE_COVERAGE = "Reference coverage is partial: the configless project exceeded its indexing budget or could not be fully read. Use grep to check additional callers.";
 const SHUTDOWN_TIMEOUT_MS = 2000;
 const KILL_GRACE_MS = 1500;
 /**
@@ -202,6 +210,7 @@ export class LspClient {
     alive = true;
     initializationOptions;
     stderrBuffer = "";
+    referenceProjectFiles;
     constructor(spec, rootPath, command) {
         this.spec = spec;
         this.rootPath = rootPath;
@@ -400,8 +409,67 @@ export class LspClient {
         return this.navigate("textDocument/definition", { textDocument: { uri }, position }, timeoutMs, "definitionProvider", parseLocations);
     }
     /** Every reference to the symbol at `position`, declaration included. */
-    references(uri, position, timeoutMs, includeDeclaration = true) {
-        return this.navigate("textDocument/references", { textDocument: { uri }, position, context: { includeDeclaration } }, timeoutMs, "referencesProvider", parseLocations);
+    async references(uri, position, timeoutMs, includeDeclaration = true) {
+        const started = Date.now();
+        const warning = this.spec.id === "typescript"
+            ? await this.prepareReferenceProject(uri, timeoutMs)
+            : undefined;
+        const outcome = await this.navigate("textDocument/references", { textDocument: { uri }, position, context: { includeDeclaration } }, Math.max(1, timeoutMs - (Date.now() - started)), "referencesProvider", parseLocations);
+        return outcome.status === "ok" && warning ? { ...outcome, warning } : outcome;
+    }
+    /** Include unopened callers without creating configs or opening stale editor buffers. */
+    async prepareReferenceProject(uri, timeoutMs) {
+        const started = Date.now();
+        const remaining = () => Math.max(1, timeoutMs - (Date.now() - started));
+        const projectFileName = path.join(this.rootPath, ".gg-lsp-reference-project");
+        try {
+            const reply = await this.conn.request("workspace/executeCommand", {
+                command: "typescript.tsserverRequest",
+                arguments: [
+                    "projectInfo",
+                    { file: fileURLToPath(uri), needFileNameList: false },
+                    { executionTarget: 0 },
+                ],
+            }, remaining());
+            const parsed = ProjectInfoReply.safeParse(reply);
+            if (!parsed.success || parsed.data.body.languageServiceDisabled)
+                return PARTIAL_REFERENCE_COVERAGE;
+            const config = parsed.data.body.configFileName;
+            if (!/[\\/]inferredProject\d+\*$/.test(config) &&
+                path.normalize(config) !== path.normalize(projectFileName))
+                return undefined;
+            const scan = await collectReferenceProjectFiles(this.rootPath, AbortSignal.timeout(Math.min(1000, remaining())));
+            const files = [...new Set([...scan.files, fileURLToPath(uri)])].sort();
+            const signature = JSON.stringify(files);
+            if (signature !== this.referenceProjectFiles) {
+                const opened = await this.conn.request("workspace/executeCommand", {
+                    command: "typescript.tsserverRequest",
+                    arguments: [
+                        "openExternalProject",
+                        {
+                            projectFileName,
+                            rootFiles: files.map((fileName) => ({ fileName })),
+                            options: { allowJs: true, checkJs: false, noEmit: true },
+                        },
+                        { executionTarget: 0 },
+                    ],
+                }, remaining());
+                if (!z.object({ success: z.literal(true) }).safeParse(opened).success)
+                    return PARTIAL_REFERENCE_COVERAGE;
+                this.referenceProjectFiles = signature;
+                log("DEBUG", "lsp", "Prepared configless reference project", {
+                    server: this.spec.id,
+                    root: this.rootPath,
+                    files: files.length,
+                    complete: scan.complete,
+                    durationMs: Date.now() - started,
+                });
+            }
+            return scan.complete ? undefined : PARTIAL_REFERENCE_COVERAGE;
+        }
+        catch {
+            return PARTIAL_REFERENCE_COVERAGE;
+        }
     }
     /** Flattened symbol outline for a whole document. */
     documentSymbols(uri, timeoutMs) {