agent-recall-core 3.5.2 → 3.5.3
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 +254 -143
- package/dist/digest/match.d.ts +2 -0
- package/dist/digest/match.d.ts.map +1 -1
- package/dist/digest/match.js +5 -0
- package/dist/digest/match.js.map +1 -1
- package/dist/digest/store.d.ts.map +1 -1
- package/dist/digest/store.js +2 -3
- package/dist/digest/store.js.map +1 -1
- package/dist/index.d.ts +17 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +10 -3
- package/dist/index.js.map +1 -1
- package/dist/palace/rooms.d.ts +7 -0
- package/dist/palace/rooms.d.ts.map +1 -1
- package/dist/palace/rooms.js +13 -0
- package/dist/palace/rooms.js.map +1 -1
- package/dist/retrieval/lexical-index.d.ts.map +1 -1
- package/dist/retrieval/lexical-index.js +3 -1
- package/dist/retrieval/lexical-index.js.map +1 -1
- package/dist/retrieval/query-memory.d.ts.map +1 -1
- package/dist/retrieval/query-memory.js +5 -3
- package/dist/retrieval/query-memory.js.map +1 -1
- package/dist/storage/classification.d.ts.map +1 -1
- package/dist/storage/classification.js +2 -0
- package/dist/storage/classification.js.map +1 -1
- package/dist/storage/content-guard.d.ts +6 -0
- package/dist/storage/content-guard.d.ts.map +1 -1
- package/dist/storage/content-guard.js +17 -0
- package/dist/storage/content-guard.js.map +1 -1
- package/dist/storage/corrections.d.ts +3 -1
- package/dist/storage/corrections.d.ts.map +1 -1
- package/dist/storage/corrections.js +5 -1
- package/dist/storage/corrections.js.map +1 -1
- package/dist/storage/cwd-allowlist.d.ts +2 -0
- package/dist/storage/cwd-allowlist.d.ts.map +1 -1
- package/dist/storage/cwd-allowlist.js +49 -14
- package/dist/storage/cwd-allowlist.js.map +1 -1
- package/dist/storage/deferred-bookkeeping.d.ts +34 -0
- package/dist/storage/deferred-bookkeeping.d.ts.map +1 -0
- package/dist/storage/deferred-bookkeeping.js +201 -0
- package/dist/storage/deferred-bookkeeping.js.map +1 -0
- package/dist/storage/frontmatter.d.ts +14 -0
- package/dist/storage/frontmatter.d.ts.map +1 -0
- package/dist/storage/frontmatter.js +22 -0
- package/dist/storage/frontmatter.js.map +1 -0
- package/dist/storage/fs-utils.d.ts +2 -0
- package/dist/storage/fs-utils.d.ts.map +1 -1
- package/dist/storage/fs-utils.js +17 -0
- package/dist/storage/fs-utils.js.map +1 -1
- package/dist/storage/hook-session.d.ts +9 -0
- package/dist/storage/hook-session.d.ts.map +1 -0
- package/dist/storage/hook-session.js +49 -0
- package/dist/storage/hook-session.js.map +1 -0
- package/dist/storage/identity-card.d.ts +27 -0
- package/dist/storage/identity-card.d.ts.map +1 -0
- package/dist/storage/identity-card.js +86 -0
- package/dist/storage/identity-card.js.map +1 -0
- package/dist/storage/lifecycle-telemetry.d.ts +1 -1
- package/dist/storage/lifecycle-telemetry.d.ts.map +1 -1
- package/dist/storage/lifecycle-telemetry.js +2 -2
- package/dist/storage/lifecycle-telemetry.js.map +1 -1
- package/dist/storage/pending.d.ts +39 -3
- package/dist/storage/pending.d.ts.map +1 -1
- package/dist/storage/pending.js +126 -20
- package/dist/storage/pending.js.map +1 -1
- package/dist/storage/project.d.ts.map +1 -1
- package/dist/storage/project.js +25 -7
- package/dist/storage/project.js.map +1 -1
- package/dist/storage/session.d.ts.map +1 -1
- package/dist/storage/session.js +43 -16
- package/dist/storage/session.js.map +1 -1
- package/dist/storage/state-card.d.ts +59 -0
- package/dist/storage/state-card.d.ts.map +1 -0
- package/dist/storage/state-card.js +162 -0
- package/dist/storage/state-card.js.map +1 -0
- package/dist/storage/unclaimed.js +2 -2
- package/dist/storage/unclaimed.js.map +1 -1
- package/dist/supabase/config.d.ts.map +1 -1
- package/dist/supabase/config.js +7 -1
- package/dist/supabase/config.js.map +1 -1
- package/dist/tools-logic/check.d.ts +62 -2
- package/dist/tools-logic/check.d.ts.map +1 -1
- package/dist/tools-logic/check.js +226 -13
- package/dist/tools-logic/check.js.map +1 -1
- package/dist/tools-logic/recall-backend.d.ts.map +1 -1
- package/dist/tools-logic/recall-backend.js +8 -0
- package/dist/tools-logic/recall-backend.js.map +1 -1
- package/dist/tools-logic/session-end.d.ts +18 -1
- package/dist/tools-logic/session-end.d.ts.map +1 -1
- package/dist/tools-logic/session-end.js +36 -5
- package/dist/tools-logic/session-end.js.map +1 -1
- package/dist/tools-logic/session-start-render.d.ts +35 -0
- package/dist/tools-logic/session-start-render.d.ts.map +1 -0
- package/dist/tools-logic/session-start-render.js +240 -0
- package/dist/tools-logic/session-start-render.js.map +1 -0
- package/dist/tools-logic/session-start.d.ts +21 -0
- package/dist/tools-logic/session-start.d.ts.map +1 -1
- package/dist/tools-logic/session-start.js +279 -225
- package/dist/tools-logic/session-start.js.map +1 -1
- package/dist/tools-logic/smart-recall.d.ts +8 -0
- package/dist/tools-logic/smart-recall.d.ts.map +1 -1
- package/dist/tools-logic/smart-recall.js +24 -5
- package/dist/tools-logic/smart-recall.js.map +1 -1
- package/dist/tools-logic/smart-remember.d.ts.map +1 -1
- package/dist/tools-logic/smart-remember.js +2 -3
- package/dist/tools-logic/smart-remember.js.map +1 -1
- package/dist/types.d.ts +82 -1
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +134 -1
- package/dist/types.js.map +1 -1
- package/dist/vector/embedding.d.ts.map +1 -1
- package/dist/vector/embedding.js +3 -0
- package/dist/vector/embedding.js.map +1 -1
- package/package.json +2 -2
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"deferred-bookkeeping.js","sourceRoot":"","sources":["../../src/storage/deferred-bookkeeping.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/** Shared frontmatter reader for the identity and state cards: BOM- and CRLF-tolerant, never throws. */
|
|
2
|
+
/** Strips one leading UTF-8 BOM (Notepad, PowerShell) and normalizes CRLF to LF; nothing else. */
|
|
3
|
+
export declare const normalizeCardText: (text: string) => string;
|
|
4
|
+
export interface Frontmatter {
|
|
5
|
+
fields: Map<string, string>;
|
|
6
|
+
body: string;
|
|
7
|
+
}
|
|
8
|
+
/**
|
|
9
|
+
* A `---` block at the very start of the (normalized) text → its `key: value` fields and the body after the closing `---`.
|
|
10
|
+
* Values keep inner colons and lose a trailing ` # comment` plus surrounding whitespace; lines without a colon are skipped.
|
|
11
|
+
* null when the text does not open with a complete block — the caller decides whether that means "malformed" or "no card".
|
|
12
|
+
*/
|
|
13
|
+
export declare function parseFrontmatter(text: string): Frontmatter | null;
|
|
14
|
+
//# sourceMappingURL=frontmatter.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/storage/frontmatter.ts"],"names":[],"mappings":"AAAA,wGAAwG;AAExG,kGAAkG;AAClG,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,MAA4D,CAAC;AAE9G,MAAM,WAAW,WAAW;IAAG,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAE1E;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAUjE"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/** Shared frontmatter reader for the identity and state cards: BOM- and CRLF-tolerant, never throws. */
|
|
2
|
+
/** Strips one leading UTF-8 BOM (Notepad, PowerShell) and normalizes CRLF to LF; nothing else. */
|
|
3
|
+
export const normalizeCardText = (text) => text.replace(/^\uFEFF/, "").replace(/\r\n/g, "\n");
|
|
4
|
+
/**
|
|
5
|
+
* A `---` block at the very start of the (normalized) text → its `key: value` fields and the body after the closing `---`.
|
|
6
|
+
* Values keep inner colons and lose a trailing ` # comment` plus surrounding whitespace; lines without a colon are skipped.
|
|
7
|
+
* null when the text does not open with a complete block — the caller decides whether that means "malformed" or "no card".
|
|
8
|
+
*/
|
|
9
|
+
export function parseFrontmatter(text) {
|
|
10
|
+
const m = /^---\n([\s\S]*?)\n---(?:\n|$)([\s\S]*)$/.exec(normalizeCardText(text));
|
|
11
|
+
if (!m)
|
|
12
|
+
return null;
|
|
13
|
+
const fields = new Map();
|
|
14
|
+
for (const line of m[1].split("\n")) {
|
|
15
|
+
const i = line.indexOf(":");
|
|
16
|
+
// `\s#` (one whitespace char, then #) is linear; `\s+#` backtracks quadratically on a long run of spaces — a poisoned card could stall session_start.
|
|
17
|
+
if (i > 0)
|
|
18
|
+
fields.set(line.slice(0, i).trim(), line.slice(i + 1).replace(/\s#.*$/, "").trim());
|
|
19
|
+
}
|
|
20
|
+
return { fields, body: m[2] };
|
|
21
|
+
}
|
|
22
|
+
//# sourceMappingURL=frontmatter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/storage/frontmatter.ts"],"names":[],"mappings":"AAAA,wGAAwG;AAExG,kGAAkG;AAClG,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAI9G;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,CAAC,GAAG,yCAAyC,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IAClF,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,sJAAsJ;QACtJ,IAAI,CAAC,GAAG,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAChC,CAAC"}
|
|
@@ -76,6 +76,8 @@ export declare function writeJsonAtomic(filePath: string, data: unknown): void;
|
|
|
76
76
|
* closes that without requiring readers to lock.
|
|
77
77
|
*/
|
|
78
78
|
export declare function writeTextAtomic(filePath: string, text: string): void;
|
|
79
|
+
/** Cards v1 — unique tmp (pid+random) so concurrent writers never share one; tmp removed if the rename fails. */
|
|
80
|
+
export declare function writeTextAtomicPrivate(filePath: string, text: string): void;
|
|
79
81
|
/**
|
|
80
82
|
* Largest N in [0, buf.length] such that `buf.subarray(0, N)` never ends
|
|
81
83
|
* mid-way through a multi-byte UTF-8 sequence. Used both for a plain
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"fs-utils.d.ts","sourceRoot":"","sources":["../../src/storage/fs-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;
|
|
1
|
+
{"version":3,"file":"fs-utils.d.ts","sourceRoot":"","sources":["../../src/storage/fs-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAI3C;AAED,wBAAgB,QAAQ,IAAI,MAAM,CAEjC;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAE1E;AAED;;2EAE2E;AAC3E,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAUxD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAO1D;AAUD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAS3E;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB,OAAQ,CAAC;AAM5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAkCnE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAKrE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAKpE;AAED,iHAAiH;AACjH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAK3E;AAgBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAuCzE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIzE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKzE"}
|
package/dist/storage/fs-utils.js
CHANGED
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
*/
|
|
4
4
|
import * as fs from "node:fs";
|
|
5
5
|
import * as path from "node:path";
|
|
6
|
+
import { randomBytes } from "node:crypto";
|
|
6
7
|
export function ensureDir(dir) {
|
|
7
8
|
if (!fs.existsSync(dir)) {
|
|
8
9
|
fs.mkdirSync(dir, { recursive: true });
|
|
@@ -175,6 +176,22 @@ export function writeTextAtomic(filePath, text) {
|
|
|
175
176
|
fs.writeFileSync(tmp, text, "utf-8");
|
|
176
177
|
renameAtomic(tmp, filePath); // atomic on POSIX; win32 transient-EPERM retry
|
|
177
178
|
}
|
|
179
|
+
/** Cards v1 — unique tmp (pid+random) so concurrent writers never share one; tmp removed if the rename fails. */
|
|
180
|
+
export function writeTextAtomicPrivate(filePath, text) {
|
|
181
|
+
ensureDir(path.dirname(filePath));
|
|
182
|
+
const tmp = `${filePath}.tmp.${process.pid}.${randomBytes(4).toString("hex")}`;
|
|
183
|
+
fs.writeFileSync(tmp, text, { encoding: "utf-8", mode: 0o600 });
|
|
184
|
+
try {
|
|
185
|
+
renameAtomic(tmp, filePath);
|
|
186
|
+
}
|
|
187
|
+
catch (err) {
|
|
188
|
+
try {
|
|
189
|
+
fs.rmSync(tmp, { force: true });
|
|
190
|
+
}
|
|
191
|
+
catch { /* best effort */ }
|
|
192
|
+
throw err;
|
|
193
|
+
}
|
|
194
|
+
}
|
|
178
195
|
// ---------------------------------------------------------------------------
|
|
179
196
|
// M8 (review fix, 2026-07-31) — shared UTF-8-safe byte-boundary helpers.
|
|
180
197
|
//
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"fs-utils.js","sourceRoot":"","sources":["../../src/storage/fs-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;
|
|
1
|
+
{"version":3,"file":"fs-utils.js","sourceRoot":"","sources":["../../src/storage/fs-utils.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/** Cards v1 (G1) — one session-id resolver for every CLI hook. Core getSessionId() is unchanged. */
|
|
2
|
+
import type { Readable } from "node:stream";
|
|
3
|
+
export declare function resolveHookSessionId(stdinPayload: Record<string, unknown> | undefined, env?: NodeJS.ProcessEnv): string | undefined;
|
|
4
|
+
export declare function hookLockKey(sid: string | undefined, now?: Date): string;
|
|
5
|
+
/** TTY → {} at once; a stream that never ends → {} after timeoutMs (stream destroyed). Invalid/non-object JSON → {}. */
|
|
6
|
+
export declare function readHookStdin(stream?: Readable & {
|
|
7
|
+
isTTY?: boolean;
|
|
8
|
+
}, timeoutMs?: number): Promise<Record<string, unknown>>;
|
|
9
|
+
//# sourceMappingURL=hook-session.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hook-session.d.ts","sourceRoot":"","sources":["../../src/storage/hook-session.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAM5C,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,SAAS,CAMhJ;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAEnF;AAED,wHAAwH;AACxH,wBAAgB,aAAa,CAAC,MAAM,GAAE,QAAQ,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAkB,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAuBxI"}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
const ENV_KEYS = ["CLAUDE_CODE_SESSION_ID", "CLAUDE_SESSION_ID", "SESSION_ID"];
|
|
2
|
+
const clean = (v) => typeof v === "number" && Number.isFinite(v) ? String(v) : typeof v === "string" && v.trim() ? v.trim() : undefined;
|
|
3
|
+
export function resolveHookSessionId(stdinPayload, env = process.env) {
|
|
4
|
+
for (const v of [stdinPayload?.["session_id"], ...ENV_KEYS.map((k) => env[k])]) {
|
|
5
|
+
const s = clean(v);
|
|
6
|
+
if (s)
|
|
7
|
+
return s;
|
|
8
|
+
}
|
|
9
|
+
return undefined;
|
|
10
|
+
}
|
|
11
|
+
export function hookLockKey(sid, now = new Date()) {
|
|
12
|
+
return sid ?? `nosid-${now.toISOString().slice(0, 13)}`;
|
|
13
|
+
}
|
|
14
|
+
/** TTY → {} at once; a stream that never ends → {} after timeoutMs (stream destroyed). Invalid/non-object JSON → {}. */
|
|
15
|
+
export function readHookStdin(stream = process.stdin, timeoutMs = 2000) {
|
|
16
|
+
if (stream.isTTY)
|
|
17
|
+
return Promise.resolve({});
|
|
18
|
+
return new Promise((resolve) => {
|
|
19
|
+
const chunks = [];
|
|
20
|
+
let timer;
|
|
21
|
+
let done = false;
|
|
22
|
+
const onData = (c) => { chunks.push(typeof c === "string" ? Buffer.from(c, "utf-8") : c); };
|
|
23
|
+
const finish = (timedOut) => {
|
|
24
|
+
if (done)
|
|
25
|
+
return;
|
|
26
|
+
done = true;
|
|
27
|
+
clearTimeout(timer);
|
|
28
|
+
stream.off("data", onData);
|
|
29
|
+
if (timedOut) {
|
|
30
|
+
try {
|
|
31
|
+
stream.destroy();
|
|
32
|
+
}
|
|
33
|
+
catch { /* best effort */ }
|
|
34
|
+
}
|
|
35
|
+
try {
|
|
36
|
+
const v = JSON.parse(Buffer.concat(chunks).toString("utf-8").trim() || "{}");
|
|
37
|
+
resolve(v !== null && typeof v === "object" && !Array.isArray(v) ? v : {});
|
|
38
|
+
}
|
|
39
|
+
catch {
|
|
40
|
+
resolve({});
|
|
41
|
+
}
|
|
42
|
+
};
|
|
43
|
+
stream.on("data", onData);
|
|
44
|
+
stream.once("end", () => finish(false));
|
|
45
|
+
stream.once("error", () => finish(false));
|
|
46
|
+
timer = setTimeout(() => finish(true), timeoutMs);
|
|
47
|
+
});
|
|
48
|
+
}
|
|
49
|
+
//# sourceMappingURL=hook-session.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hook-session.js","sourceRoot":"","sources":["../../src/storage/hook-session.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
export declare const IDENTITY_BODY_CAP = 1600;
|
|
2
|
+
export interface IdentityCard {
|
|
3
|
+
version: number;
|
|
4
|
+
updated: string;
|
|
5
|
+
body: string;
|
|
6
|
+
}
|
|
7
|
+
export declare class IdentityCardError extends Error {
|
|
8
|
+
readonly code: "empty" | "too_long" | "secret" | "binary";
|
|
9
|
+
constructor(code: "empty" | "too_long" | "secret" | "binary", message: string);
|
|
10
|
+
}
|
|
11
|
+
export declare const identityCardPath: () => string;
|
|
12
|
+
/** The on-disk form — what `write` stores and `ar identity show` prints, so a shown card feeds straight back into `set`. */
|
|
13
|
+
export declare const serializeIdentityCard: (c: IdentityCard) => string;
|
|
14
|
+
export declare function parseIdentityCard(text: string): {
|
|
15
|
+
card: IdentityCard;
|
|
16
|
+
malformed: boolean;
|
|
17
|
+
};
|
|
18
|
+
export declare function readIdentityCard(): IdentityCard | null;
|
|
19
|
+
export declare function writeIdentityCard(body: string, now?: Date): IdentityCard & {
|
|
20
|
+
path: string;
|
|
21
|
+
};
|
|
22
|
+
/** Shared renderer (MCP terse/verbose, CLI hook-start). */
|
|
23
|
+
export declare const formatOwnerSection: (o: {
|
|
24
|
+
version: number;
|
|
25
|
+
body: string;
|
|
26
|
+
}) => string[];
|
|
27
|
+
//# sourceMappingURL=identity-card.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"identity-card.d.ts","sourceRoot":"","sources":["../../src/storage/identity-card.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,MAAM,WAAW,YAAY;IAAG,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAChF,qBAAa,iBAAkB,SAAQ,KAAK;aACd,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ;gBAAhD,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,EAAE,OAAO,EAAE,MAAM;CAC9F;AACD,eAAO,MAAM,gBAAgB,QAAO,MAAkD,CAAC;AAGvF,4HAA4H;AAC5H,eAAO,MAAM,qBAAqB,GAAI,GAAG,YAAY,KAAG,MAAoG,CAAC;AAE7J,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAO1F;AAED,wBAAgB,gBAAgB,IAAI,YAAY,GAAG,IAAI,CAmBtD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAavG;AAED,2DAA2D;AAC3D,eAAO,MAAM,kBAAkB,GAAI,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KAAG,MAAM,EAAqD,CAAC"}
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
/** Cards v1 (G2) — <root>/identity-card.md. Personal tier, never synced; the CLI is the only writer. Reads never throw. */
|
|
2
|
+
import * as fs from "node:fs";
|
|
3
|
+
import * as path from "node:path";
|
|
4
|
+
import { getRoot } from "../types.js";
|
|
5
|
+
import { writeTextAtomicPrivate } from "./fs-utils.js";
|
|
6
|
+
import { scrubSecretContent } from "./content-guard.js";
|
|
7
|
+
import { normalizeCardText, parseFrontmatter } from "./frontmatter.js";
|
|
8
|
+
export const IDENTITY_BODY_CAP = 1600;
|
|
9
|
+
export class IdentityCardError extends Error {
|
|
10
|
+
code;
|
|
11
|
+
constructor(code, message) {
|
|
12
|
+
super(message);
|
|
13
|
+
this.code = code;
|
|
14
|
+
this.name = "IdentityCardError";
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
export const identityCardPath = () => path.join(getRoot(), "identity-card.md");
|
|
18
|
+
const warn = (msg) => { try {
|
|
19
|
+
process.stderr.write(`[AgentRecall] identity-card.md: ${msg}\n`);
|
|
20
|
+
}
|
|
21
|
+
catch { /* never throw */ } };
|
|
22
|
+
/** The on-disk form — what `write` stores and `ar identity show` prints, so a shown card feeds straight back into `set`. */
|
|
23
|
+
export const serializeIdentityCard = (c) => `---\nkind: identity-card\nversion: ${c.version}\nupdated: ${c.updated}\n---\n${c.body}\n`;
|
|
24
|
+
export function parseIdentityCard(text) {
|
|
25
|
+
const fm = parseFrontmatter(text), version = fm?.fields.get("version") ?? "";
|
|
26
|
+
// `version` must be a plain integer: "3.0", "1e1", "0x3" or "007" are hand edits the bump in writeIdentityCard would mangle.
|
|
27
|
+
if (fm && fm.fields.get("kind") === "identity-card" && /^(0|[1-9]\d*)$/.test(version) && Number.isSafeInteger(Number(version))) {
|
|
28
|
+
return { card: { version: Number(version), updated: fm.fields.get("updated") ?? "", body: fm.body.replace(/^\n+/, "").trimEnd() }, malformed: false };
|
|
29
|
+
}
|
|
30
|
+
return { card: { version: 0, updated: "", body: normalizeCardText(text).trimEnd() }, malformed: true };
|
|
31
|
+
}
|
|
32
|
+
export function readIdentityCard() {
|
|
33
|
+
let raw;
|
|
34
|
+
try {
|
|
35
|
+
if (!fs.existsSync(identityCardPath()))
|
|
36
|
+
return null;
|
|
37
|
+
raw = fs.readFileSync(identityCardPath(), "utf-8");
|
|
38
|
+
}
|
|
39
|
+
catch (err) {
|
|
40
|
+
warn(`unreadable (${String(err)}) — skipped`);
|
|
41
|
+
return null;
|
|
42
|
+
}
|
|
43
|
+
if (raw.includes("\u0000")) {
|
|
44
|
+
warn("binary content — skipped");
|
|
45
|
+
return null;
|
|
46
|
+
}
|
|
47
|
+
if (!raw.trim()) {
|
|
48
|
+
warn("empty file — skipped");
|
|
49
|
+
return null;
|
|
50
|
+
}
|
|
51
|
+
const { card, malformed } = parseIdentityCard(raw);
|
|
52
|
+
if (malformed)
|
|
53
|
+
warn("malformed frontmatter — whole file used as body");
|
|
54
|
+
else if (card.body.length > IDENTITY_BODY_CAP)
|
|
55
|
+
warn(`body over ${IDENTITY_BODY_CAP} chars — truncated for this load`);
|
|
56
|
+
// `set` rejects secrets, but a hand-edited live file bypasses it and is injected into every session.
|
|
57
|
+
const scan = scrubSecretContent(card.body);
|
|
58
|
+
if (scan.redactedCount > 0) {
|
|
59
|
+
card.body = scan.content;
|
|
60
|
+
warn(`contains a secret (${scan.labels[0] ?? "secret pattern"}) — redacted for this load; remove it from the file`);
|
|
61
|
+
}
|
|
62
|
+
if (card.body.length > IDENTITY_BODY_CAP)
|
|
63
|
+
card.body = card.body.slice(0, IDENTITY_BODY_CAP - 1) + "…";
|
|
64
|
+
return card;
|
|
65
|
+
}
|
|
66
|
+
export function writeIdentityCard(body, now = new Date()) {
|
|
67
|
+
const clean = body.replace(/\r\n/g, "\n").trim();
|
|
68
|
+
if (!clean)
|
|
69
|
+
throw new IdentityCardError("empty", "identity card body is empty — nothing written");
|
|
70
|
+
// A UTF-16 file read as UTF-8 (PowerShell 5.1 redirection) arrives NUL-laden; stored, it would be skipped as binary on every read.
|
|
71
|
+
if (clean.includes("\u0000"))
|
|
72
|
+
throw new IdentityCardError("binary", "identity card body contains NUL bytes (a UTF-16 file read as UTF-8?) — nothing written");
|
|
73
|
+
if (clean.length > IDENTITY_BODY_CAP)
|
|
74
|
+
throw new IdentityCardError("too_long", `identity card body is ${clean.length} chars; cap is ${IDENTITY_BODY_CAP} — nothing written`);
|
|
75
|
+
const scan = scrubSecretContent(clean);
|
|
76
|
+
if (scan.redactedCount > 0)
|
|
77
|
+
throw new IdentityCardError("secret", `identity card body contains a secret (${scan.labels[0] ?? "secret pattern"}) — nothing written`);
|
|
78
|
+
// Unlocked read-then-write: two concurrent `ar identity set` runs can both read version N and both store N+1. The last atomic
|
|
79
|
+
// rename wins and `version` is informational (one owner, CLI-only writer), so no lock is taken for it.
|
|
80
|
+
const card = { version: (readIdentityCard()?.version ?? 0) + 1, updated: now.toISOString(), body: clean };
|
|
81
|
+
writeTextAtomicPrivate(identityCardPath(), serializeIdentityCard(card));
|
|
82
|
+
return { ...card, path: identityCardPath() };
|
|
83
|
+
}
|
|
84
|
+
/** Shared renderer (MCP terse/verbose, CLI hook-start). */
|
|
85
|
+
export const formatOwnerSection = (o) => [`Owner (identity card v${o.version})`, o.body];
|
|
86
|
+
//# sourceMappingURL=identity-card.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"identity-card.js","sourceRoot":"","sources":["../../src/storage/identity-card.ts"],"names":[],"mappings":"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"}
|
|
@@ -52,7 +52,7 @@ export interface LifecycleTelemetryRow {
|
|
|
52
52
|
* Append one lifecycle event row. Best-effort: NEVER throws into the caller —
|
|
53
53
|
* telemetry must never break a lifecycle tool call.
|
|
54
54
|
*/
|
|
55
|
-
export declare function recordLifecycleEvent(event: LifecycleEvent, sessionId: string, project: string, dup: boolean): void;
|
|
55
|
+
export declare function recordLifecycleEvent(event: LifecycleEvent, sessionId: string, project: string, dup: boolean, at?: string): void;
|
|
56
56
|
export interface LifecycleStats {
|
|
57
57
|
total: number;
|
|
58
58
|
byEvent: Record<LifecycleEvent, number>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"lifecycle-telemetry.d.ts","sourceRoot":"","sources":["../../src/storage/lifecycle-telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAQH,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,aAAa,GAAG,UAAU,GAAG,OAAO,CAAC;AAEpF,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,cAAc,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,GAAG,EAAE,OAAO,CAAC;CACd;AAoCD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,OAAO,
|
|
1
|
+
{"version":3,"file":"lifecycle-telemetry.d.ts","sourceRoot":"","sources":["../../src/storage/lifecycle-telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAQH,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,aAAa,GAAG,UAAU,GAAG,OAAO,CAAC;AAEpF,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,cAAc,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,GAAG,EAAE,OAAO,CAAC;CACd;AAoCD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,OAAO,EACZ,EAAE,GAAE,MAAiC,GACpC,IAAI,CAkBN;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB;AAWD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,CA0B/D"}
|
|
@@ -73,7 +73,7 @@ function rotateIfNeeded(p) {
|
|
|
73
73
|
* Append one lifecycle event row. Best-effort: NEVER throws into the caller —
|
|
74
74
|
* telemetry must never break a lifecycle tool call.
|
|
75
75
|
*/
|
|
76
|
-
export function recordLifecycleEvent(event, sessionId, project, dup) {
|
|
76
|
+
export function recordLifecycleEvent(event, sessionId, project, dup, at = new Date().toISOString()) {
|
|
77
77
|
try {
|
|
78
78
|
const dir = telemetryDir();
|
|
79
79
|
ensureDir(dir);
|
|
@@ -84,7 +84,7 @@ export function recordLifecycleEvent(event, sessionId, project, dup) {
|
|
|
84
84
|
sessionId,
|
|
85
85
|
project,
|
|
86
86
|
host_tier: resolveHostProfile().tier,
|
|
87
|
-
at
|
|
87
|
+
at,
|
|
88
88
|
dup,
|
|
89
89
|
};
|
|
90
90
|
fs.appendFileSync(p, JSON.stringify(row) + "\n", "utf-8");
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"lifecycle-telemetry.js","sourceRoot":"","sources":["../../src/storage/lifecycle-telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAqBxD,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,MAAM;AAExC,SAAS,YAAY;IACnB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,aAAa;IACpB,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,iBAAiB,CAAC,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CAAC,CAAS;IAC/B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,CAAC;QACH,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,6CAA6C;IACvD,CAAC;IACD,IAAI,IAAI,IAAI,YAAY;QAAE,OAAO;IACjC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;IACzB,IAAI,CAAC;QACH,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,4EAA4E;QAC5E,kCAAkC;IACpC,CAAC;IACD,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAqB,EACrB,SAAiB,EACjB,OAAe,EACf,GAAY;
|
|
1
|
+
{"version":3,"file":"lifecycle-telemetry.js","sourceRoot":"","sources":["../../src/storage/lifecycle-telemetry.ts"],"names":[],"mappings":"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"}
|
|
@@ -14,6 +14,8 @@
|
|
|
14
14
|
* validation — stages HERE instead of the active corrections ledger. The
|
|
15
15
|
* active ledger is reachable ONLY through check()'s validated STRUCTURED
|
|
16
16
|
* form {rule, why, applies_when} (or an explicit promote of a staged item).
|
|
17
|
+
* Behind the owner gate (hosted server) that form is staged here too, as
|
|
18
|
+
* `check_structured_unconfirmed`, and only confirmPendingCorrection activates.
|
|
17
19
|
*
|
|
18
20
|
* INVARIANTS
|
|
19
21
|
* - Nothing is silently dropped: a capture either becomes a *.json row here
|
|
@@ -36,12 +38,13 @@
|
|
|
36
38
|
* proof_count on promote (proof accrual restarts from the active ledger's
|
|
37
39
|
* own consolidation rules).
|
|
38
40
|
*/
|
|
41
|
+
import { type CredentialRef } from "../types.js";
|
|
39
42
|
/** Hard cap on staged rows per project — oldest are evicted (logged) beyond it. */
|
|
40
43
|
export declare const PENDING_CAP = 200;
|
|
41
44
|
/** Days a staged row may await review before it expires (logged, pruned). */
|
|
42
45
|
export declare const PENDING_TTL_DAYS = 14;
|
|
43
46
|
export type PendingKind = "correction" | "insight";
|
|
44
|
-
export type PendingChannel = "check_string" | "check_structured_incomplete" | "hook" | "session_end_insight";
|
|
47
|
+
export type PendingChannel = "check_string" | "check_structured_incomplete" | "check_structured_unconfirmed" | "hook" | "session_end_insight";
|
|
45
48
|
export interface PendingRecord {
|
|
46
49
|
id: string;
|
|
47
50
|
ts: string;
|
|
@@ -55,6 +58,14 @@ export interface PendingRecord {
|
|
|
55
58
|
severity: "p0" | "p1";
|
|
56
59
|
applies_when?: string[];
|
|
57
60
|
reason: string;
|
|
61
|
+
/** Owner gate rows only: proposalDigest(context, applies_when), fixed for the life of the row. */
|
|
62
|
+
digest?: string;
|
|
63
|
+
/**
|
|
64
|
+
* Hosted server: the credential (an opaque id, never a token) of the agent that first
|
|
65
|
+
* proposed this row. Carried onto the active correction when the owner approves it. Absent on
|
|
66
|
+
* rows from before the field existed and on rows not written by a hosted agent request.
|
|
67
|
+
*/
|
|
68
|
+
authored_by?: CredentialRef;
|
|
58
69
|
provenance: {
|
|
59
70
|
source: string;
|
|
60
71
|
mode: "told" | "observed";
|
|
@@ -72,6 +83,10 @@ export interface StagePendingInput {
|
|
|
72
83
|
reason: string;
|
|
73
84
|
/** Provenance source — session id / hook name. Defaults to the channel. */
|
|
74
85
|
source?: string;
|
|
86
|
+
/** Severity decided by the caller; default classifies rule + text. */
|
|
87
|
+
severity?: "p0" | "p1";
|
|
88
|
+
/** Credential id ("token:<id>") of the proposing agent (see PendingRecord.authored_by). A malformed value is dropped. */
|
|
89
|
+
authoredBy?: string;
|
|
75
90
|
}
|
|
76
91
|
export interface StagePendingResult {
|
|
77
92
|
staged: boolean;
|
|
@@ -90,9 +105,24 @@ export interface ResolvePendingResult {
|
|
|
90
105
|
export declare function pendingDir(project: string): string;
|
|
91
106
|
/**
|
|
92
107
|
* List staged rows, newest (last_seen) first. Runs the TTL/cap sweep first so
|
|
93
|
-
* a reader never sees an expired row. Never throws
|
|
108
|
+
* a reader never sees an expired row. Never throws, unless `strict`: then a lock
|
|
109
|
+
* or directory read failure is thrown instead of looking like an empty queue
|
|
110
|
+
* (the owner's review page must not say "nothing waiting" when it could not look).
|
|
94
111
|
*/
|
|
95
|
-
export declare function listPendingCorrections(project: string
|
|
112
|
+
export declare function listPendingCorrections(project: string, opts?: {
|
|
113
|
+
strict?: boolean;
|
|
114
|
+
}): Promise<PendingRecord[]>;
|
|
115
|
+
/** Hex length of proposalDigest: 128 bits, so finding other content for a GIVEN digest is not feasible. */
|
|
116
|
+
export declare const PROPOSAL_DIGEST_HEX = 32;
|
|
117
|
+
/**
|
|
118
|
+
* Owner gate — digest of exactly what approving a staged proposal activates:
|
|
119
|
+
* the stored context (rule + why) and applies_when. It is stored on the row
|
|
120
|
+
* AND is the tail of the row's id (proposalIdMatchesDigest), so the id the
|
|
121
|
+
* owner approves names that content and nothing else.
|
|
122
|
+
*/
|
|
123
|
+
export declare function proposalDigest(context: string, appliesWhen: string[] | undefined): string;
|
|
124
|
+
/** True when `id` is an owner-gate proposal id carrying exactly `digest`. */
|
|
125
|
+
export declare function proposalIdMatchesDigest(id: string, digest: string): boolean;
|
|
96
126
|
/**
|
|
97
127
|
* Stage a capture into _pending/. Hard-noise input (corrections.ts's
|
|
98
128
|
* dropHardNoise floor, checked on rule AND context) goes straight to
|
|
@@ -106,10 +136,16 @@ export declare function stagePendingCorrection(project: string, input: StagePend
|
|
|
106
136
|
* promotion audit line (the ACTIVE write itself is the caller's job — check()
|
|
107
137
|
* runs the validated structured write first, then resolves). "reject" removes
|
|
108
138
|
* the row and appends it to _rejected.jsonl with the reviewer's reason.
|
|
139
|
+
*
|
|
140
|
+
* `detail.refuse` runs under the lock on the row about to be resolved; a
|
|
141
|
+
* returned string leaves the row untouched and becomes the error. The owner
|
|
142
|
+
* gate uses it so an agent channel can only discard partial captures, never a
|
|
143
|
+
* proposal that is waiting for the owner.
|
|
109
144
|
*/
|
|
110
145
|
export declare function resolvePendingCorrection(project: string, id: string, action: "promote" | "reject", detail?: {
|
|
111
146
|
reason?: string;
|
|
112
147
|
correction_id?: string;
|
|
148
|
+
refuse?: (row: PendingRecord) => string | undefined;
|
|
113
149
|
}): Promise<ResolvePendingResult>;
|
|
114
150
|
export interface CompletenessFailure {
|
|
115
151
|
field: "rule" | "title" | "why" | "evidence" | "applies_when";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"pending.d.ts","sourceRoot":"","sources":["../../src/storage/pending.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"pending.d.ts","sourceRoot":"","sources":["../../src/storage/pending.ts"],"names":[],"mappings":"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"}
|