agent-rulebook 0.2.0 → 0.3.0
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 +58 -4
- package/dist/commands/dashboard.d.ts +7 -0
- package/dist/commands/dashboard.js +42 -0
- package/dist/commands/dashboard.js.map +1 -0
- package/dist/commands/diagnostics.d.ts +2 -0
- package/dist/commands/diagnostics.js +38 -0
- package/dist/commands/diagnostics.js.map +1 -0
- package/dist/commands/home.d.ts +2 -0
- package/dist/commands/home.js +59 -0
- package/dist/commands/home.js.map +1 -0
- package/dist/commands/import.d.ts +2 -0
- package/dist/commands/import.js +34 -0
- package/dist/commands/import.js.map +1 -0
- package/dist/commands/pending.d.ts +2 -0
- package/dist/commands/pending.js +27 -0
- package/dist/commands/pending.js.map +1 -0
- package/dist/commands/resolution.js +25 -11
- package/dist/commands/resolution.js.map +1 -1
- package/dist/commands/stats-renderer.d.ts +3 -0
- package/dist/commands/stats-renderer.js +76 -0
- package/dist/commands/stats-renderer.js.map +1 -0
- package/dist/commands/stats.d.ts +4 -0
- package/dist/commands/stats.js +107 -0
- package/dist/commands/stats.js.map +1 -0
- package/dist/commands/status.d.ts +2 -0
- package/dist/commands/status.js +17 -0
- package/dist/commands/status.js.map +1 -0
- package/dist/commands/sync.js +1 -1
- package/dist/commands/sync.js.map +1 -1
- package/dist/commands/usage.d.ts +2 -0
- package/dist/commands/usage.js +25 -0
- package/dist/commands/usage.js.map +1 -0
- package/dist/core/codex-call-parser.d.ts +10 -0
- package/dist/core/codex-call-parser.js +97 -0
- package/dist/core/codex-call-parser.js.map +1 -0
- package/dist/core/codex-usage-import.d.ts +24 -0
- package/dist/core/codex-usage-import.js +259 -0
- package/dist/core/codex-usage-import.js.map +1 -0
- package/dist/core/diagnostic-cluster.d.ts +37 -0
- package/dist/core/diagnostic-cluster.js +20 -0
- package/dist/core/diagnostic-cluster.js.map +1 -0
- package/dist/core/environment-normalization.d.ts +21 -0
- package/dist/core/environment-normalization.js +42 -0
- package/dist/core/environment-normalization.js.map +1 -0
- package/dist/core/index.d.ts +1 -0
- package/dist/core/index.js +1 -0
- package/dist/core/index.js.map +1 -1
- package/dist/core/invocation-diagnostics.d.ts +40 -0
- package/dist/core/invocation-diagnostics.js +91 -0
- package/dist/core/invocation-diagnostics.js.map +1 -0
- package/dist/core/legacy-candidate.d.ts +159 -0
- package/dist/core/legacy-candidate.js +73 -0
- package/dist/core/legacy-candidate.js.map +1 -0
- package/dist/core/legacy-import-apply.d.ts +215 -0
- package/dist/core/legacy-import-apply.js +172 -0
- package/dist/core/legacy-import-apply.js.map +1 -0
- package/dist/core/legacy-import-manifest.d.ts +197 -0
- package/dist/core/legacy-import-manifest.js +63 -0
- package/dist/core/legacy-import-manifest.js.map +1 -0
- package/dist/core/legacy-scan.d.ts +71 -0
- package/dist/core/legacy-scan.js +99 -0
- package/dist/core/legacy-scan.js.map +1 -0
- package/dist/core/pending-replay.d.ts +4 -0
- package/dist/core/pending-replay.js +96 -0
- package/dist/core/pending-replay.js.map +1 -0
- package/dist/core/resolution-applicability.d.ts +1 -0
- package/dist/core/resolution-applicability.js +28 -11
- package/dist/core/resolution-applicability.js.map +1 -1
- package/dist/core/resolution-ranker.js +9 -2
- package/dist/core/resolution-ranker.js.map +1 -1
- package/dist/core/resolution-search-types.d.ts +9 -0
- package/dist/core/statistics-data.d.ts +98 -0
- package/dist/core/statistics-data.js +53 -0
- package/dist/core/statistics-data.js.map +1 -0
- package/dist/core/statistics-pages.d.ts +3 -0
- package/dist/core/statistics-pages.js +107 -0
- package/dist/core/statistics-pages.js.map +1 -0
- package/dist/core/statistics-query.d.ts +86 -0
- package/dist/core/statistics-query.js +51 -0
- package/dist/core/statistics-query.js.map +1 -0
- package/dist/core/statistics-types.d.ts +286 -0
- package/dist/core/statistics-types.js +2 -0
- package/dist/core/statistics-types.js.map +1 -0
- package/dist/core/statistics.d.ts +5 -0
- package/dist/core/statistics.js +101 -0
- package/dist/core/statistics.js.map +1 -0
- package/dist/core/sync-status.d.ts +53 -0
- package/dist/core/sync-status.js +85 -0
- package/dist/core/sync-status.js.map +1 -0
- package/dist/core/usage-context.d.ts +15 -0
- package/dist/core/usage-context.js +22 -0
- package/dist/core/usage-context.js.map +1 -0
- package/dist/core/usage-observer.d.ts +36 -0
- package/dist/core/usage-observer.js +112 -0
- package/dist/core/usage-observer.js.map +1 -0
- package/dist/core/usage-schema.d.ts +113 -0
- package/dist/core/usage-schema.js +33 -0
- package/dist/core/usage-schema.js.map +1 -0
- package/dist/dashboard/public/api.js +41 -0
- package/dist/dashboard/public/app.js +111 -0
- package/dist/dashboard/public/components/detail-panel.js +21 -0
- package/dist/dashboard/public/components/index.js +216 -0
- package/dist/dashboard/public/components/input-diff.js +15 -0
- package/dist/dashboard/public/diagnostic-detail.js +25 -0
- package/dist/dashboard/public/diagnostics.js +46 -0
- package/dist/dashboard/public/index.html +28 -0
- package/dist/dashboard/public/knowledge.js +57 -0
- package/dist/dashboard/public/overview.js +101 -0
- package/dist/dashboard/public/solution-detail.js +42 -0
- package/dist/dashboard/public/styles.css +205 -0
- package/dist/dashboard/server.d.ts +10 -0
- package/dist/dashboard/server.js +133 -0
- package/dist/dashboard/server.js.map +1 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.js +3 -0
- package/dist/index.js.map +1 -1
- package/dist/mcp/observed-transport.d.ts +20 -0
- package/dist/mcp/observed-transport.js +99 -0
- package/dist/mcp/observed-transport.js.map +1 -0
- package/dist/mcp/resolution-change.d.ts +1 -1
- package/dist/mcp/resolution-change.js +24 -9
- package/dist/mcp/resolution-change.js.map +1 -1
- package/dist/mcp/resolutions-commit-change-tool.d.ts +5 -0
- package/dist/mcp/resolutions-commit-change-tool.js +22 -4
- package/dist/mcp/resolutions-commit-change-tool.js.map +1 -1
- package/dist/mcp/resolutions-find-tool.d.ts +1 -2
- package/dist/mcp/resolutions-find-tool.js +43 -8
- package/dist/mcp/resolutions-find-tool.js.map +1 -1
- package/dist/mcp/resolutions-list-facets-tool.d.ts +1 -1
- package/dist/mcp/resolutions-list-facets-tool.js +16 -2
- package/dist/mcp/resolutions-list-facets-tool.js.map +1 -1
- package/dist/mcp/resolutions-report-attempt-tool.d.ts +1 -0
- package/dist/mcp/resolutions-report-attempt-tool.js +44 -55
- package/dist/mcp/resolutions-report-attempt-tool.js.map +1 -1
- package/dist/mcp/schemas.d.ts +299 -14
- package/dist/mcp/schemas.js +31 -10
- package/dist/mcp/schemas.js.map +1 -1
- package/dist/mcp/server.js +20 -5
- package/dist/mcp/server.js.map +1 -1
- package/dist/mcp/stats-get-tool.d.ts +99 -0
- package/dist/mcp/stats-get-tool.js +17 -0
- package/dist/mcp/stats-get-tool.js.map +1 -0
- package/dist/mcp/tool-call.d.ts +99 -0
- package/dist/mcp/tool-call.js +20 -0
- package/dist/mcp/tool-call.js.map +1 -0
- package/dist/mcp/tool-output.d.ts +9 -0
- package/dist/mcp/tool-output.js +22 -0
- package/dist/mcp/tool-output.js.map +1 -1
- package/dist/mcp/tools.d.ts +182 -27
- package/dist/mcp/tools.js +9 -2
- package/dist/mcp/tools.js.map +1 -1
- package/dist/program.js +16 -0
- package/dist/program.js.map +1 -1
- package/dist/storage/canonical-write-lock.d.ts +2 -0
- package/dist/storage/canonical-write-lock.js +32 -0
- package/dist/storage/canonical-write-lock.js.map +1 -0
- package/dist/storage/diagnostic-store.d.ts +21 -0
- package/dist/storage/diagnostic-store.js +50 -0
- package/dist/storage/diagnostic-store.js.map +1 -0
- package/dist/storage/import-manifest.d.ts +6 -0
- package/dist/storage/import-manifest.js +41 -0
- package/dist/storage/import-manifest.js.map +1 -0
- package/dist/storage/pending-store.d.ts +329 -0
- package/dist/storage/pending-store.js +164 -0
- package/dist/storage/pending-store.js.map +1 -0
- package/dist/storage/resolution-candidate-service.js +2 -1
- package/dist/storage/resolution-candidate-service.js.map +1 -1
- package/dist/storage/resolution-change-transaction.d.ts +41 -3
- package/dist/storage/resolution-change-transaction.js +101 -12
- package/dist/storage/resolution-change-transaction.js.map +1 -1
- package/dist/storage/resolution-home.d.ts +2 -1
- package/dist/storage/resolution-home.js +5 -2
- package/dist/storage/resolution-home.js.map +1 -1
- package/dist/storage/resolution-index-check.js +3 -2
- package/dist/storage/resolution-index-check.js.map +1 -1
- package/dist/storage/resolution-indexer.js +3 -1
- package/dist/storage/resolution-indexer.js.map +1 -1
- package/dist/storage/usage-store.d.ts +80 -0
- package/dist/storage/usage-store.js +239 -0
- package/dist/storage/usage-store.js.map +1 -0
- package/package.json +11 -4
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
import Database from 'better-sqlite3';
|
|
2
|
+
import { type UsageEvent } from '../core/usage-schema.js';
|
|
3
|
+
export declare const USAGE_DATABASE_VERSION = 3;
|
|
4
|
+
export type UsageWriteResult = {
|
|
5
|
+
status: 'recorded' | 'already_recorded' | 'degraded' | 'disabled';
|
|
6
|
+
invocation_id?: string;
|
|
7
|
+
};
|
|
8
|
+
export declare function openUsageDatabase(home: string, readonly?: boolean): Database.Database;
|
|
9
|
+
/** Recording errors never change the original tool/CLI result. No submitted values reach stderr. */
|
|
10
|
+
export declare function recordUsageStart(home: string, input: unknown, options?: {
|
|
11
|
+
disabled?: boolean;
|
|
12
|
+
stderr?: (text: string) => void;
|
|
13
|
+
}): UsageWriteResult;
|
|
14
|
+
export declare function completeUsageInvocation(home: string, invocationId: string, input: unknown, stderr?: (text: string) => void): UsageWriteResult;
|
|
15
|
+
/** Explicit history import is atomic and may improve inferred history; live events remain immutable. */
|
|
16
|
+
export declare function recordImportedUsage(home: string, input: unknown, completed: unknown): UsageWriteResult;
|
|
17
|
+
export declare function interruptUsageCollector(home: string, collectorId: string, endedAt?: string): void;
|
|
18
|
+
export declare function readUsageStore(home: string): {
|
|
19
|
+
status: string;
|
|
20
|
+
events: UsageEvent[];
|
|
21
|
+
coverage: {
|
|
22
|
+
recorded_from: string | null;
|
|
23
|
+
sources: Record<string, string>;
|
|
24
|
+
pruned: Array<{
|
|
25
|
+
source: string;
|
|
26
|
+
usage_kind?: string | null;
|
|
27
|
+
from_at: string;
|
|
28
|
+
to_at: string;
|
|
29
|
+
pruned_at: string;
|
|
30
|
+
removed_count: number;
|
|
31
|
+
}>;
|
|
32
|
+
};
|
|
33
|
+
health: {
|
|
34
|
+
status: string;
|
|
35
|
+
failure_count: number;
|
|
36
|
+
last_failure_at: string | null;
|
|
37
|
+
code: string | null;
|
|
38
|
+
};
|
|
39
|
+
} | {
|
|
40
|
+
status: string;
|
|
41
|
+
events: null;
|
|
42
|
+
health: {
|
|
43
|
+
status: string;
|
|
44
|
+
code: string;
|
|
45
|
+
failure_count: number;
|
|
46
|
+
last_failure_at: string | null;
|
|
47
|
+
};
|
|
48
|
+
coverage: {
|
|
49
|
+
recorded_from: string | null;
|
|
50
|
+
sources: Record<string, string>;
|
|
51
|
+
pruned: Array<{
|
|
52
|
+
source: string;
|
|
53
|
+
usage_kind?: string | null;
|
|
54
|
+
from_at: string;
|
|
55
|
+
to_at: string;
|
|
56
|
+
pruned_at: string;
|
|
57
|
+
removed_count: number;
|
|
58
|
+
}>;
|
|
59
|
+
};
|
|
60
|
+
};
|
|
61
|
+
export declare function pruneUsage(home: string, before: string, execute?: boolean): {
|
|
62
|
+
status: string;
|
|
63
|
+
before: string;
|
|
64
|
+
count: number;
|
|
65
|
+
retained: number;
|
|
66
|
+
sources: ("live" | "codex_history")[];
|
|
67
|
+
coverage: {
|
|
68
|
+
recorded_from: string | null;
|
|
69
|
+
sources: Record<string, string>;
|
|
70
|
+
pruned: Array<{
|
|
71
|
+
source: string;
|
|
72
|
+
usage_kind?: string | null;
|
|
73
|
+
from_at: string;
|
|
74
|
+
to_at: string;
|
|
75
|
+
pruned_at: string;
|
|
76
|
+
removed_count: number;
|
|
77
|
+
}>;
|
|
78
|
+
};
|
|
79
|
+
};
|
|
80
|
+
export declare function guardUsageWrite(home: string, stderr: ((text: string) => void) | undefined, operation: () => UsageWriteResult): UsageWriteResult;
|
|
@@ -0,0 +1,239 @@
|
|
|
1
|
+
import Database from 'better-sqlite3';
|
|
2
|
+
import { accessSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
|
|
3
|
+
import { randomUUID } from 'node:crypto';
|
|
4
|
+
import { join } from 'node:path';
|
|
5
|
+
import { UsageStartSchema, UsageCompletionSchema } from '../core/usage-schema.js';
|
|
6
|
+
import { isSqliteCorruptionError } from './sqlite-errors.js';
|
|
7
|
+
export const USAGE_DATABASE_VERSION = 3;
|
|
8
|
+
const failures = new Map();
|
|
9
|
+
const warned = new Set();
|
|
10
|
+
export function openUsageDatabase(home, readonly = false) {
|
|
11
|
+
const deadline = Date.now() + 1000;
|
|
12
|
+
while (true) {
|
|
13
|
+
try {
|
|
14
|
+
return openUsageDatabaseOnce(home, readonly);
|
|
15
|
+
}
|
|
16
|
+
catch (error) {
|
|
17
|
+
// WAL mode transitions may return BUSY before SQLite's busy handler waits.
|
|
18
|
+
if (error.code !== 'SQLITE_BUSY' || Date.now() >= deadline)
|
|
19
|
+
throw error;
|
|
20
|
+
Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 10);
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
function openUsageDatabaseOnce(home, readonly) {
|
|
25
|
+
const path = join(home, 'logs/usage.sqlite');
|
|
26
|
+
if (!readonly)
|
|
27
|
+
mkdirSync(join(home, 'logs'), { recursive: true, mode: 0o700 });
|
|
28
|
+
const database = new Database(path, { readonly, fileMustExist: readonly, timeout: 1000 });
|
|
29
|
+
try {
|
|
30
|
+
database.pragma('foreign_keys = ON');
|
|
31
|
+
if (!readonly) {
|
|
32
|
+
if (database.pragma('journal_mode', { simple: true }) !== 'wal')
|
|
33
|
+
database.pragma('journal_mode = WAL');
|
|
34
|
+
database.pragma('synchronous = FULL');
|
|
35
|
+
const existingVersion = database.pragma('user_version', { simple: true });
|
|
36
|
+
if (existingVersion > USAGE_DATABASE_VERSION)
|
|
37
|
+
throw new Error('usage_schema_unsupported');
|
|
38
|
+
if (existingVersion < USAGE_DATABASE_VERSION)
|
|
39
|
+
database.transaction(() => {
|
|
40
|
+
const version = database.pragma('user_version', { simple: true });
|
|
41
|
+
if (version > USAGE_DATABASE_VERSION)
|
|
42
|
+
throw new Error('usage_schema_unsupported');
|
|
43
|
+
if (version === 0)
|
|
44
|
+
database.exec(`
|
|
45
|
+
CREATE TABLE invocations (invocation_id TEXT PRIMARY KEY, source_identity TEXT UNIQUE, collector_instance_id TEXT NOT NULL, started_at TEXT NOT NULL, ended_at TEXT, status TEXT NOT NULL, tool TEXT NOT NULL, surface TEXT NOT NULL, source TEXT NOT NULL, usage_kind TEXT NOT NULL, project_key TEXT, event_json TEXT NOT NULL);
|
|
46
|
+
CREATE INDEX usage_period ON invocations(source, usage_kind, started_at);
|
|
47
|
+
CREATE INDEX usage_tool ON invocations(tool, started_at);
|
|
48
|
+
CREATE TABLE usage_metadata (key TEXT PRIMARY KEY, value TEXT NOT NULL);
|
|
49
|
+
CREATE TABLE pruned_intervals (source TEXT NOT NULL, from_at TEXT NOT NULL, to_at TEXT NOT NULL, pruned_at TEXT NOT NULL, removed_count INTEGER NOT NULL);
|
|
50
|
+
PRAGMA user_version = 1;
|
|
51
|
+
`);
|
|
52
|
+
if (version < 2)
|
|
53
|
+
database.exec(`
|
|
54
|
+
CREATE TABLE diagnostics (diagnostic_id TEXT PRIMARY KEY, invocation_id TEXT NOT NULL UNIQUE REFERENCES invocations(invocation_id) ON DELETE CASCADE, created_at TEXT NOT NULL, tool TEXT NOT NULL, schema_digest TEXT NOT NULL, cluster_key TEXT NOT NULL, diagnostic_json TEXT NOT NULL);
|
|
55
|
+
CREATE INDEX diagnostic_clusters ON diagnostics(cluster_key,created_at);
|
|
56
|
+
PRAGMA user_version = 2;
|
|
57
|
+
`);
|
|
58
|
+
if (version < 3)
|
|
59
|
+
database.exec('ALTER TABLE pruned_intervals ADD COLUMN usage_kind TEXT; PRAGMA user_version = 3;');
|
|
60
|
+
}).immediate();
|
|
61
|
+
}
|
|
62
|
+
else if (![1, 2, USAGE_DATABASE_VERSION].includes(database.pragma('user_version', { simple: true })))
|
|
63
|
+
throw new Error('usage_schema_unsupported');
|
|
64
|
+
return database;
|
|
65
|
+
}
|
|
66
|
+
catch (error) {
|
|
67
|
+
database.close();
|
|
68
|
+
throw error;
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
/** Recording errors never change the original tool/CLI result. No submitted values reach stderr. */
|
|
72
|
+
export function recordUsageStart(home, input, options = {}) {
|
|
73
|
+
if (options.disabled ?? process.env.AGENT_RULEBOOK_USAGE === 'off')
|
|
74
|
+
return { status: 'disabled' };
|
|
75
|
+
return guardUsageWrite(home, options.stderr, () => {
|
|
76
|
+
const start = UsageStartSchema.parse(input);
|
|
77
|
+
const database = openUsageDatabase(home);
|
|
78
|
+
try {
|
|
79
|
+
const event = { ...start, status: 'started', ended_at: null, duration_ms: null, category: null, result_summary: {}, diagnostic_ref: null };
|
|
80
|
+
return database.transaction(() => {
|
|
81
|
+
const saved = database.prepare('INSERT OR IGNORE INTO invocations VALUES (@invocation_id,@source_identity,@collector_instance_id,@started_at,NULL,\'started\',@tool,@surface,@source,@usage_kind,@project_key,@event_json)').run({ ...start, event_json: JSON.stringify(event) });
|
|
82
|
+
if (saved.changes)
|
|
83
|
+
for (const key of [`recorded_from:${start.source}`, `recorded_from:${start.source}:${start.usage_kind}`])
|
|
84
|
+
database.prepare('INSERT INTO usage_metadata VALUES (?,?) ON CONFLICT(key) DO UPDATE SET value = min(value, excluded.value)').run(key, start.started_at);
|
|
85
|
+
const existing = database.prepare('SELECT invocation_id FROM invocations WHERE invocation_id=? OR source_identity=?').get(start.invocation_id, start.source_identity);
|
|
86
|
+
return { status: saved.changes ? 'recorded' : 'already_recorded', invocation_id: existing.invocation_id };
|
|
87
|
+
}).immediate();
|
|
88
|
+
}
|
|
89
|
+
finally {
|
|
90
|
+
database.close();
|
|
91
|
+
}
|
|
92
|
+
});
|
|
93
|
+
}
|
|
94
|
+
export function completeUsageInvocation(home, invocationId, input, stderr) {
|
|
95
|
+
return guardUsageWrite(home, stderr, () => {
|
|
96
|
+
const completion = UsageCompletionSchema.parse(input);
|
|
97
|
+
const database = openUsageDatabase(home);
|
|
98
|
+
try {
|
|
99
|
+
return database.transaction(() => {
|
|
100
|
+
const row = database.prepare('SELECT event_json,status FROM invocations WHERE invocation_id=?').get(invocationId);
|
|
101
|
+
if (!row)
|
|
102
|
+
throw new Error('usage_start_missing');
|
|
103
|
+
if (row.status !== 'started')
|
|
104
|
+
return { status: 'already_recorded', invocation_id: invocationId };
|
|
105
|
+
const start = JSON.parse(row.event_json);
|
|
106
|
+
if (completion.ended_at < start.started_at)
|
|
107
|
+
throw new Error('usage_time_invalid');
|
|
108
|
+
const event = { ...start, ...completion, diagnostic_ref: completion.diagnostic_ref ?? start.diagnostic_ref };
|
|
109
|
+
database.prepare('UPDATE invocations SET ended_at=?,status=?,event_json=? WHERE invocation_id=?').run(completion.ended_at, completion.status, JSON.stringify(event), invocationId);
|
|
110
|
+
return { status: 'recorded', invocation_id: invocationId };
|
|
111
|
+
}).immediate();
|
|
112
|
+
}
|
|
113
|
+
finally {
|
|
114
|
+
database.close();
|
|
115
|
+
}
|
|
116
|
+
});
|
|
117
|
+
}
|
|
118
|
+
/** Explicit history import is atomic and may improve inferred history; live events remain immutable. */
|
|
119
|
+
export function recordImportedUsage(home, input, completed) {
|
|
120
|
+
return guardUsageWrite(home, undefined, () => {
|
|
121
|
+
const start = UsageStartSchema.parse(input);
|
|
122
|
+
const completion = UsageCompletionSchema.parse(completed);
|
|
123
|
+
if (start.source !== 'codex_history' || !start.source_identity || !start.import_provenance || completion.ended_at < start.started_at)
|
|
124
|
+
throw new Error('invalid_import_event');
|
|
125
|
+
const database = openUsageDatabase(home);
|
|
126
|
+
try {
|
|
127
|
+
return database.transaction(() => {
|
|
128
|
+
const row = database.prepare('SELECT event_json FROM invocations WHERE source_identity=?').get(start.source_identity);
|
|
129
|
+
const previous = row ? JSON.parse(row.event_json) : undefined;
|
|
130
|
+
const rank = (value) => value === 'confirmed' || value === 'observed' ? 2 : value === 'inferred' ? 1 : 0;
|
|
131
|
+
if (previous && (previous.source !== 'codex_history' || previous.usage_kind !== start.usage_kind || rank(previous.confidence) >= rank(start.confidence)))
|
|
132
|
+
return { status: 'already_recorded', invocation_id: previous.invocation_id };
|
|
133
|
+
const event = { ...start, ...completion, collector_instance_id: previous?.collector_instance_id ?? start.collector_instance_id, invocation_id: previous?.invocation_id ?? start.invocation_id, diagnostic_ref: previous?.diagnostic_ref ?? completion.diagnostic_ref };
|
|
134
|
+
if (previous)
|
|
135
|
+
database.prepare('UPDATE invocations SET ended_at=?,status=?,event_json=? WHERE invocation_id=?').run(completion.ended_at, completion.status, JSON.stringify(event), previous.invocation_id);
|
|
136
|
+
else
|
|
137
|
+
database.prepare('INSERT INTO invocations VALUES (@invocation_id,@source_identity,@collector_instance_id,@started_at,@ended_at,@status,@tool,@surface,@source,@usage_kind,@project_key,@event_json)').run({ ...event, event_json: JSON.stringify(event) });
|
|
138
|
+
for (const key of [`recorded_from:${start.source}`, `recorded_from:${start.source}:${start.usage_kind}`])
|
|
139
|
+
database.prepare('INSERT INTO usage_metadata VALUES (?,?) ON CONFLICT(key) DO UPDATE SET value=min(value,excluded.value)').run(key, start.started_at);
|
|
140
|
+
return { status: 'recorded', invocation_id: event.invocation_id };
|
|
141
|
+
}).immediate();
|
|
142
|
+
}
|
|
143
|
+
finally {
|
|
144
|
+
database.close();
|
|
145
|
+
}
|
|
146
|
+
});
|
|
147
|
+
}
|
|
148
|
+
export function interruptUsageCollector(home, collectorId, endedAt = new Date().toISOString()) {
|
|
149
|
+
const snapshot = readUsageStore(home);
|
|
150
|
+
for (const event of snapshot.events ?? [])
|
|
151
|
+
if (event.collector_instance_id === collectorId && event.status === 'started')
|
|
152
|
+
completeUsageInvocation(home, event.invocation_id, { ended_at: endedAt, duration_ms: null, status: 'interrupted', category: null });
|
|
153
|
+
}
|
|
154
|
+
export function readUsageStore(home) {
|
|
155
|
+
const health = readHealth(home);
|
|
156
|
+
const empty = { events: [], coverage: { recorded_from: null, sources: {}, pruned: [] }, health };
|
|
157
|
+
let database;
|
|
158
|
+
try {
|
|
159
|
+
accessSync(join(home, 'logs/usage.sqlite'));
|
|
160
|
+
database = openUsageDatabase(home, true);
|
|
161
|
+
const events = database.prepare('SELECT event_json FROM invocations ORDER BY started_at,invocation_id').all().map(({ event_json }) => JSON.parse(event_json));
|
|
162
|
+
const metadata = database.prepare("SELECT key,value FROM usage_metadata WHERE key LIKE 'recorded_from:%'").all();
|
|
163
|
+
const sources = Object.fromEntries(metadata.map(({ key, value }) => [key.slice('recorded_from:'.length), value]));
|
|
164
|
+
const pruned = database.prepare('SELECT * FROM pruned_intervals ORDER BY to_at').all();
|
|
165
|
+
return { status: process.env.AGENT_RULEBOOK_USAGE === 'off' ? 'disabled' : health.status === 'degraded' ? 'degraded' : pruned.length ? 'partial' : 'ok', events, coverage: { recorded_from: sources.live ?? null, sources, pruned }, health };
|
|
166
|
+
}
|
|
167
|
+
catch (error) {
|
|
168
|
+
if (error.code === 'ENOENT')
|
|
169
|
+
return { ...empty, status: process.env.AGENT_RULEBOOK_USAGE === 'off' ? 'disabled' : health.status === 'degraded' ? 'degraded' : 'not_recorded' };
|
|
170
|
+
return { ...empty, status: 'degraded', events: null, health: { ...health, status: 'degraded', code: failureCode(error) } };
|
|
171
|
+
}
|
|
172
|
+
finally {
|
|
173
|
+
database?.close();
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
export function pruneUsage(home, before, execute = false) {
|
|
177
|
+
if (!/^\d{4}-\d{2}-\d{2}T/.test(before) || !Number.isFinite(Date.parse(before)) || Date.parse(before) > Date.now())
|
|
178
|
+
throw new Error('invalid_prune_boundary');
|
|
179
|
+
const cutoff = new Date(before).toISOString();
|
|
180
|
+
const snapshot = readUsageStore(home);
|
|
181
|
+
if (!snapshot.events)
|
|
182
|
+
throw new Error('usage_unavailable');
|
|
183
|
+
const selected = snapshot.events.filter((event) => event.started_at < cutoff);
|
|
184
|
+
const preview = { status: 'preview', before: cutoff, count: selected.length, retained: snapshot.events.length - selected.length, sources: [...new Set(selected.map(({ source }) => source))], coverage: snapshot.coverage };
|
|
185
|
+
if (!execute || !selected.length)
|
|
186
|
+
return { ...preview, status: execute ? 'pruned' : 'preview' };
|
|
187
|
+
const database = openUsageDatabase(home);
|
|
188
|
+
try {
|
|
189
|
+
const removed = database.transaction(() => {
|
|
190
|
+
const groups = database.prepare('SELECT source,usage_kind,min(started_at) AS from_at,count(*) AS count FROM invocations WHERE started_at < ? GROUP BY source,usage_kind').all(cutoff);
|
|
191
|
+
for (const group of groups)
|
|
192
|
+
database.prepare('INSERT INTO pruned_intervals (source,from_at,to_at,pruned_at,removed_count,usage_kind) VALUES (?,?,?,?,?,?)').run(group.source, group.from_at, cutoff, new Date().toISOString(), group.count, group.usage_kind);
|
|
193
|
+
const count = database.prepare('DELETE FROM invocations WHERE started_at < ?').run(cutoff).changes;
|
|
194
|
+
const retained = database.prepare('SELECT count(*) AS n FROM invocations').get().n;
|
|
195
|
+
return { count, retained };
|
|
196
|
+
}).immediate();
|
|
197
|
+
database.pragma('wal_checkpoint(PASSIVE)');
|
|
198
|
+
return { ...preview, ...removed, status: 'pruned', coverage: readUsageStore(home).coverage };
|
|
199
|
+
}
|
|
200
|
+
finally {
|
|
201
|
+
database.close();
|
|
202
|
+
}
|
|
203
|
+
}
|
|
204
|
+
export function guardUsageWrite(home, stderr, operation) {
|
|
205
|
+
try {
|
|
206
|
+
return operation();
|
|
207
|
+
}
|
|
208
|
+
catch (error) {
|
|
209
|
+
const code = failureCode(error);
|
|
210
|
+
const previous = readHealth(home);
|
|
211
|
+
const value = { count: previous.failure_count + 1, last_failure_at: new Date().toISOString(), code };
|
|
212
|
+
failures.set(home, value);
|
|
213
|
+
try {
|
|
214
|
+
mkdirSync(join(home, 'logs'), { recursive: true, mode: 0o700 });
|
|
215
|
+
const temp = join(home, 'logs', `.usage-health-${randomUUID()}.tmp`);
|
|
216
|
+
writeFileSync(temp, JSON.stringify(value), { mode: 0o600 });
|
|
217
|
+
renameSync(temp, join(home, 'logs/usage-health.json'));
|
|
218
|
+
}
|
|
219
|
+
catch { /* The in-process health remains degraded even when storage is unavailable. */ }
|
|
220
|
+
if (!warned.has(`${home}:${code}`)) {
|
|
221
|
+
warned.add(`${home}:${code}`);
|
|
222
|
+
(stderr ?? ((text) => process.stderr.write(text)))(`Agent Rulebook usage recording degraded (${code}).\n`);
|
|
223
|
+
}
|
|
224
|
+
return { status: 'degraded' };
|
|
225
|
+
}
|
|
226
|
+
}
|
|
227
|
+
function readHealth(home) {
|
|
228
|
+
let value = failures.get(home);
|
|
229
|
+
if (!value)
|
|
230
|
+
try {
|
|
231
|
+
const stored = JSON.parse(readFileSync(join(home, 'logs/usage-health.json'), 'utf8'));
|
|
232
|
+
if (Number.isSafeInteger(stored.count) && stored.count > 0)
|
|
233
|
+
value = { count: stored.count, last_failure_at: Number.isFinite(Date.parse(stored.last_failure_at)) ? new Date(stored.last_failure_at).toISOString() : '', code: ['usage_corrupt', 'usage_busy', 'usage_invalid_event', 'usage_unavailable'].includes(stored.code) ? stored.code : 'usage_unavailable' };
|
|
234
|
+
}
|
|
235
|
+
catch { /* No health record. */ }
|
|
236
|
+
return { status: value ? 'degraded' : 'ok', failure_count: value?.count ?? 0, last_failure_at: value?.last_failure_at ?? null, code: value?.code ?? null };
|
|
237
|
+
}
|
|
238
|
+
function failureCode(error) { return isSqliteCorruptionError(error) ? 'usage_corrupt' : error.code === 'SQLITE_BUSY' ? 'usage_busy' : error.name === 'ZodError' ? 'usage_invalid_event' : 'usage_unavailable'; }
|
|
239
|
+
//# sourceMappingURL=usage-store.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"usage-store.js","sourceRoot":"","sources":["../../src/storage/usage-store.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-rulebook",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.3.0",
|
|
4
4
|
"description": "Agent-native MCP memory for retrieving verified problems, solutions, outcomes, and source evidence.",
|
|
5
5
|
"license": "UNLICENSED",
|
|
6
6
|
"keywords": [
|
|
@@ -35,27 +35,34 @@
|
|
|
35
35
|
"scripts": {
|
|
36
36
|
"clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
|
|
37
37
|
"prebuild": "npm run clean",
|
|
38
|
-
"build": "tsc -p tsconfig.build.json",
|
|
38
|
+
"build": "tsc -p tsconfig.build.json && tsc -p tsconfig.dashboard.json && node scripts/build-dashboard.mjs",
|
|
39
|
+
"typecheck:dashboard": "tsc -p tsconfig.dashboard.json --noEmit",
|
|
39
40
|
"dev": "tsx src/cli.ts",
|
|
40
41
|
"pretest": "npm run build",
|
|
41
42
|
"acceptance": "node scripts/run-acceptance.mjs",
|
|
42
43
|
"check:package": "node scripts/check-package.mjs",
|
|
43
44
|
"smoke:package": "node scripts/smoke-packed-package.mjs",
|
|
44
45
|
"smoke:registry": "node scripts/smoke-registry-package.mjs",
|
|
45
|
-
"release:verify": "npm run build && npm run typecheck && npm test && npm run acceptance",
|
|
46
|
+
"release:verify": "npm run build && npm run typecheck && npm run typecheck:dashboard && npm test && npm run acceptance",
|
|
46
47
|
"prepack": "npm run release:verify && npm run check:package",
|
|
47
48
|
"prepublishOnly": "npm run release:verify",
|
|
48
49
|
"typecheck": "tsc --noEmit",
|
|
49
|
-
"test": "vitest run"
|
|
50
|
+
"test": "vitest run",
|
|
51
|
+
"build:dashboard:dev": "tsc -p tsconfig.dashboard.json && node scripts/build-dashboard.mjs --dev",
|
|
52
|
+
"dashboard:dev": "npm run build:dashboard:dev && node scripts/dashboard-dev.mjs",
|
|
53
|
+
"test:browser": "playwright test",
|
|
54
|
+
"prepare-release": "node scripts/prepare-release.mjs"
|
|
50
55
|
},
|
|
51
56
|
"dependencies": {
|
|
52
57
|
"@modelcontextprotocol/sdk": "^1.17.0",
|
|
58
|
+
"acorn": "8.19.0",
|
|
53
59
|
"better-sqlite3": "12.11.1",
|
|
54
60
|
"commander": "^14.0.0",
|
|
55
61
|
"yaml": "^2.8.0",
|
|
56
62
|
"zod": "^4.0.0"
|
|
57
63
|
},
|
|
58
64
|
"devDependencies": {
|
|
65
|
+
"@playwright/test": "1.63.0",
|
|
59
66
|
"@types/better-sqlite3": "^7.6.13",
|
|
60
67
|
"@types/node": "^24.0.0",
|
|
61
68
|
"tsx": "^4.20.0",
|