agent-rulebook 0.3.2 → 0.3.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 +8 -4
- package/dist/commands/diagnostics.js +13 -2
- package/dist/commands/diagnostics.js.map +1 -1
- package/dist/commands/stats-renderer.js +1 -1
- package/dist/commands/stats-renderer.js.map +1 -1
- package/dist/core/diagnostic-cluster.d.ts +5 -1
- package/dist/core/diagnostic-cluster.js +6 -3
- package/dist/core/diagnostic-cluster.js.map +1 -1
- package/dist/core/diagnostic-guidance.d.ts +21 -0
- package/dist/core/diagnostic-guidance.js +25 -0
- package/dist/core/diagnostic-guidance.js.map +1 -0
- package/dist/core/invocation-diagnostics.d.ts +3 -0
- package/dist/core/invocation-diagnostics.js +6 -1
- package/dist/core/invocation-diagnostics.js.map +1 -1
- package/dist/core/statistics-pages.js +5 -4
- package/dist/core/statistics-pages.js.map +1 -1
- package/dist/core/statistics-query.d.ts +5 -0
- package/dist/core/statistics-query.js +2 -1
- package/dist/core/statistics-query.js.map +1 -1
- package/dist/core/statistics-types.d.ts +17 -0
- package/dist/core/statistics.js +3 -3
- package/dist/core/statistics.js.map +1 -1
- package/dist/core/usage-context.js +1 -1
- package/dist/core/usage-context.js.map +1 -1
- package/dist/core/usage-observer.d.ts +10 -1
- package/dist/core/usage-observer.js +2 -1
- package/dist/core/usage-observer.js.map +1 -1
- package/dist/dashboard/public/components/input-diff.js +1 -1
- package/dist/dashboard/public/diagnostic-detail.js +4 -1
- package/dist/dashboard/public/diagnostics.js +15 -3
- package/dist/dashboard/server.js +1 -1
- package/dist/dashboard/server.js.map +1 -1
- package/dist/mcp/stats-get-tool.js +1 -1
- package/dist/mcp/stats-get-tool.js.map +1 -1
- package/dist/mcp/tool-output.d.ts +1 -0
- package/dist/mcp/tool-output.js +38 -2
- package/dist/mcp/tool-output.js.map +1 -1
- package/dist/mcp/tools.js +3 -3
- package/dist/mcp/tools.js.map +1 -1
- package/dist/storage/diagnostic-store.d.ts +2 -0
- package/dist/storage/diagnostic-store.js +6 -1
- package/dist/storage/diagnostic-store.js.map +1 -1
- package/dist/storage/diagnostic-triage-store.d.ts +36 -0
- package/dist/storage/diagnostic-triage-store.js +69 -0
- package/dist/storage/diagnostic-triage-store.js.map +1 -0
- package/package.json +1 -1
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import { readFileSync } from 'node:fs';
|
|
2
|
+
import { mkdir, open, rename, rm } from 'node:fs/promises';
|
|
3
|
+
import { randomUUID } from 'node:crypto';
|
|
4
|
+
import { join } from 'node:path';
|
|
5
|
+
import { z } from 'zod';
|
|
6
|
+
import { withCanonicalWriteLock } from './canonical-write-lock.js';
|
|
7
|
+
import { redactSensitiveText } from '../core/redaction.js';
|
|
8
|
+
export const DiagnosticStateSchema = z.enum(['open', 'resolved', 'all']);
|
|
9
|
+
const ReasonSchema = z.string().regex(/^[a-z][a-z0-9_]{0,63}$/).refine(value => redactSensitiveText(value) === value, 'Expected a safe review reason code');
|
|
10
|
+
const TriageSchema = z.object({ state: z.enum(['open', 'resolved']), reason: ReasonSchema, updated_at: z.iso.datetime() }).strict();
|
|
11
|
+
const StateSchema = z.object({ version: z.literal(1), records: z.record(z.uuid(), TriageSchema) }).strict();
|
|
12
|
+
/** Missing state is open; malformed state is surfaced as degraded without hiding any records. */
|
|
13
|
+
export function readDiagnosticTriage(home) {
|
|
14
|
+
try {
|
|
15
|
+
return { status: 'ok', ...StateSchema.parse(JSON.parse(readFileSync(join(home, '.state/diagnostic-triage.json'), 'utf8'))) };
|
|
16
|
+
}
|
|
17
|
+
catch (error) {
|
|
18
|
+
return { status: error.code === 'ENOENT' ? 'ok' : 'degraded', version: 1, records: {} };
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
/** Exact-ID local review state; original diagnostic and invocation rows are never updated. */
|
|
22
|
+
export async function updateDiagnosticTriage(home, input, availableIds) {
|
|
23
|
+
const ids = [...new Set(z.array(z.uuid()).min(1).max(10_000).parse(input.ids))];
|
|
24
|
+
const reason = ReasonSchema.parse(input.reason);
|
|
25
|
+
z.enum(['open', 'resolved']).parse(input.state);
|
|
26
|
+
const known = new Set(availableIds);
|
|
27
|
+
if (ids.some(id => !known.has(id)))
|
|
28
|
+
throw new Error('diagnostic_not_found');
|
|
29
|
+
const preview = { status: 'preview', state: input.state, reason, matched: ids.length, diagnostic_ids: ids };
|
|
30
|
+
if (!input.execute)
|
|
31
|
+
return preview;
|
|
32
|
+
return withCanonicalWriteLock(join(home, '.state/diagnostic-triage-lock'), async () => {
|
|
33
|
+
const prior = readDiagnosticTriage(home);
|
|
34
|
+
if (prior.status === 'degraded')
|
|
35
|
+
throw new Error('diagnostic_triage_degraded');
|
|
36
|
+
const records = { ...prior.records };
|
|
37
|
+
const now = new Date().toISOString();
|
|
38
|
+
for (const id of ids) {
|
|
39
|
+
if (records[id]?.state !== input.state || records[id]?.reason !== reason)
|
|
40
|
+
records[id] = { state: input.state, reason, updated_at: now };
|
|
41
|
+
}
|
|
42
|
+
const directory = join(home, '.state');
|
|
43
|
+
await mkdir(directory, { recursive: true, mode: 0o700 });
|
|
44
|
+
const temp = join(directory, `.diagnostic-triage-${randomUUID()}.tmp`);
|
|
45
|
+
try {
|
|
46
|
+
const file = await open(temp, 'wx', 0o600);
|
|
47
|
+
try {
|
|
48
|
+
await file.writeFile(JSON.stringify({ version: 1, records }) + '\n');
|
|
49
|
+
await file.sync();
|
|
50
|
+
}
|
|
51
|
+
finally {
|
|
52
|
+
await file.close();
|
|
53
|
+
}
|
|
54
|
+
await rename(temp, join(directory, 'diagnostic-triage.json'));
|
|
55
|
+
const dir = await open(directory, 'r');
|
|
56
|
+
try {
|
|
57
|
+
await dir.sync();
|
|
58
|
+
}
|
|
59
|
+
finally {
|
|
60
|
+
await dir.close();
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
finally {
|
|
64
|
+
await rm(temp, { force: true });
|
|
65
|
+
}
|
|
66
|
+
return { ...preview, status: input.state === 'resolved' ? 'resolved' : 'reopened' };
|
|
67
|
+
});
|
|
68
|
+
}
|
|
69
|
+
//# sourceMappingURL=diagnostic-triage-store.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"diagnostic-triage-store.js","sourceRoot":"","sources":["../../src/storage/diagnostic-triage-store.ts"],"names":[],"mappings":"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"}
|