agentrinse 0.3.0 → 0.5.0

package/dist/adapters/claude-debug.js

@@ -0,0 +1,100 @@
+import { lstat, readdir } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { sha256 } from "../core/digest.js";
+import { inspectProviderFile } from "../core/provider-file-identity.js";
+import { CLAUDE_DEBUG_LOG_MIN_AGE_MINUTES, CLAUDE_DEBUG_LOG_POLICY_ID, isClaudeDebugLogRelativePath, } from "../core/provider-file-policy.js";
+function isMissing(error) {
+    return (error instanceof Error && "code" in error && error.code === "ENOENT");
+}
+export async function collectClaudeDebugLogs(context, ownerRoot, maxEntries) {
+    const debugRoot = join(ownerRoot, "debug");
+    const diagnostics = [];
+    let entries;
+    try {
+        const rootStats = await lstat(debugRoot);
+        if (rootStats.isSymbolicLink() || !rootStats.isDirectory()) {
+            return { resources: [], diagnostics };
+        }
+        entries = await readdir(debugRoot, { withFileTypes: true });
+    }
+    catch (error) {
+        if (isMissing(error)) {
+            return { resources: [], diagnostics };
+        }
+        return {
+            resources: [],
+            diagnostics: [
+                {
+                    severity: "warning",
+                    code: "CLAUDE_DEBUG_ENUMERATION_FAILED",
+                    message: error instanceof Error ? error.message : String(error),
+                    adapter: "claude",
+                },
+            ],
+        };
+    }
+    if (entries.length > maxEntries) {
+        return {
+            resources: [],
+            diagnostics: [
+                {
+                    severity: "warning",
+                    code: "CLAUDE_DEBUG_ENUMERATION_TRUNCATED",
+                    message: `Claude debug cleanup requires at most ${maxEntries} direct entries`,
+                    adapter: "claude",
+                },
+            ],
+        };
+    }
+    const cutoffMs = context.now.getTime() - CLAUDE_DEBUG_LOG_MIN_AGE_MINUTES * 60_000;
+    const resources = [];
+    for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
+        context.signal?.throwIfAborted();
+        const path = join(debugRoot, entry.name);
+        const relativePath = join("debug", entry.name);
+        if (!isClaudeDebugLogRelativePath(relativePath)) {
+            continue;
+        }
+        try {
+            const stats = await lstat(path);
+            if (!stats.isFile() || stats.isSymbolicLink() || stats.mtimeMs > cutoffMs) {
+                continue;
+            }
+            const identity = await inspectProviderFile(path, ownerRoot, "claude");
+            const canonicalKey = `claude:debug-log:${identity.path}`;
+            resources.push({
+                resource: {
+                    id: `claude:agent-log-store:${sha256(canonicalKey)}`,
+                    adapter: "claude",
+                    kind: "agent-log-store",
+                    canonicalKey,
+                    displayName: `Claude debug log ${basename(identity.path)}`,
+                    path: identity.path,
+                },
+                observedAt: context.now.toISOString(),
+                exists: true,
+                measuredBytes: identity.measuredBytes,
+                facts: {
+                    reportOnly: false,
+                    maintenanceAction: "provider.file-quarantine",
+                    policyId: CLAUDE_DEBUG_LOG_POLICY_ID,
+                    minAgeMinutes: CLAUDE_DEBUG_LOG_MIN_AGE_MINUTES,
+                    providerFileIdentity: identity,
+                },
+            });
+        }
+        catch (error) {
+            if (isMissing(error)) {
+                continue;
+            }
+            diagnostics.push({
+                severity: "warning",
+                code: "CLAUDE_DEBUG_FILE_INSPECTION_FAILED",
+                message: error instanceof Error ? error.message : String(error),
+                adapter: "claude",
+            });
+        }
+    }
+    return { resources, diagnostics };
+}
+//# sourceMappingURL=claude-debug.js.map

package/dist/adapters/claude-debug.js.map

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

package/dist/adapters/claude-retention.d.ts

@@ -0,0 +1,36 @@
+import { type Stats } from "node:fs";
+import { type FileHandle } from "node:fs/promises";
+import { z } from "zod";
+import type { Diagnostic } from "../contracts/diagnostic.js";
+export declare const CLAUDE_NATIVE_RETENTION_DEFAULT_DAYS = 30;
+export declare const claudeNativeRetentionFactsSchema: z.ZodObject<{
+    mechanism: z.ZodLiteral<"cleanupPeriodDays">;
+    documentedDefaultDays: z.ZodLiteral<30>;
+    startupSweep: z.ZodLiteral<true>;
+    effectiveDaysKnown: z.ZodLiteral<false>;
+    userSettingsStatus: z.ZodEnum<{
+        changed: "changed";
+        invalid: "invalid";
+        missing: "missing";
+        "too-large": "too-large";
+        unreadable: "unreadable";
+        unsupported: "unsupported";
+        unverified: "unverified";
+        valid: "valid";
+    }>;
+    userConfiguredDays: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type ClaudeNativeRetentionFacts = z.infer<typeof claudeNativeRetentionFactsSchema>;
+type SettingsFileHandle = Pick<FileHandle, "close" | "read" | "stat">;
+export type ClaudeRetentionDependencies = {
+    lstat(path: string): Promise<Stats>;
+    open(path: string, flags: number): Promise<SettingsFileHandle>;
+};
+export type ClaudeRetentionInspection = {
+    facts: ClaudeNativeRetentionFacts;
+    diagnostics: Diagnostic[];
+};
+export declare function usesClaudeNativeRetention(relativePath: string): boolean;
+export declare function inspectClaudeNativeRetention(ownerRoot: string, platform?: NodeJS.Platform, dependencies?: ClaudeRetentionDependencies): Promise<ClaudeRetentionInspection>;
+export {};
+//# sourceMappingURL=claude-retention.d.ts.map

package/dist/adapters/claude-retention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-retention.d.ts","sourceRoot":"","sources":["../../src/adapters/claude-retention.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGhE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAI7D,eAAO,MAAM,oCAAoC,KAAK,CAAC;AAEvD,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;iBAgB3C,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F,KAAK,kBAAkB,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;AAEtE,MAAM,MAAM,2BAA2B,GAAG;IACxC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAChE,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,0BAA0B,CAAC;IAClC,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B,CAAC;AA0EF,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAEvE;AAED,wBAAsB,4BAA4B,CAChD,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,YAAY,GAAE,2BAAkD,GAC/D,OAAO,CAAC,yBAAyB,CAAC,CAyIpC"}

package/dist/adapters/claude-retention.js

@@ -0,0 +1,176 @@
+import { constants } from "node:fs";
+import { lstat, open } from "node:fs/promises";
+import { join } from "node:path";
+import { z } from "zod";
+const MAX_SETTINGS_BYTES = 1024 * 1024;
+export const CLAUDE_NATIVE_RETENTION_DEFAULT_DAYS = 30;
+export const claudeNativeRetentionFactsSchema = z.object({
+    mechanism: z.literal("cleanupPeriodDays"),
+    documentedDefaultDays: z.literal(CLAUDE_NATIVE_RETENTION_DEFAULT_DAYS),
+    startupSweep: z.literal(true),
+    effectiveDaysKnown: z.literal(false),
+    userSettingsStatus: z.enum([
+        "missing",
+        "valid",
+        "invalid",
+        "changed",
+        "unreadable",
+        "unsupported",
+        "too-large",
+        "unverified",
+    ]),
+    userConfiguredDays: z.number().int().min(1).optional(),
+});
+const DEFAULT_DEPENDENCIES = {
+    lstat,
+    open,
+};
+const NATIVE_RETENTION_PATHS = new Set(["projects", "debug", "paste-cache", "image-cache"]);
+function isMissing(error) {
+    return (error instanceof Error && "code" in error && error.code === "ENOENT");
+}
+function stableStats(before, after) {
+    return (before.dev === after.dev &&
+        before.ino === after.ino &&
+        before.mode === after.mode &&
+        before.mtimeMs === after.mtimeMs &&
+        before.ctimeMs === after.ctimeMs &&
+        before.size === after.size);
+}
+async function readBoundedSettings(handle) {
+    const buffer = Buffer.allocUnsafe(MAX_SETTINGS_BYTES + 1);
+    let offset = 0;
+    while (offset < buffer.length) {
+        const result = await handle.read(buffer, offset, buffer.length - offset, offset);
+        if (result.bytesRead === 0) {
+            break;
+        }
+        offset += result.bytesRead;
+    }
+    if (offset > MAX_SETTINGS_BYTES) {
+        return { overflow: true };
+    }
+    return {
+        contents: buffer.subarray(0, offset).toString("utf8"),
+        overflow: false,
+    };
+}
+function inspection(userSettingsStatus, diagnostics = [], userConfiguredDays) {
+    return {
+        facts: {
+            mechanism: "cleanupPeriodDays",
+            documentedDefaultDays: CLAUDE_NATIVE_RETENTION_DEFAULT_DAYS,
+            startupSweep: true,
+            effectiveDaysKnown: false,
+            userSettingsStatus,
+            ...(userConfiguredDays === undefined ? {} : { userConfiguredDays }),
+        },
+        diagnostics,
+    };
+}
+function warning(code, message) {
+    return {
+        severity: "warning",
+        code,
+        message,
+        adapter: "claude",
+    };
+}
+export function usesClaudeNativeRetention(relativePath) {
+    return NATIVE_RETENTION_PATHS.has(relativePath);
+}
+export async function inspectClaudeNativeRetention(ownerRoot, platform = process.platform, dependencies = DEFAULT_DEPENDENCIES) {
+    const settingsPath = join(ownerRoot, "settings.json");
+    let entryStats;
+    try {
+        entryStats = await dependencies.lstat(settingsPath);
+    }
+    catch (error) {
+        if (isMissing(error)) {
+            return inspection("missing");
+        }
+        return inspection("unreadable", [
+            warning("CLAUDE_RETENTION_SETTINGS_UNREADABLE", "Claude user settings could not be inspected; native retention is uncertain."),
+        ]);
+    }
+    if (entryStats.isSymbolicLink() || !entryStats.isFile()) {
+        return inspection("unsupported", [
+            warning("CLAUDE_RETENTION_SETTINGS_UNSUPPORTED", "Claude user settings are not a direct regular file; native retention is uncertain."),
+        ]);
+    }
+    if (entryStats.size > MAX_SETTINGS_BYTES) {
+        return inspection("too-large", [
+            warning("CLAUDE_RETENTION_SETTINGS_TOO_LARGE", "Claude user settings exceed the inspection limit; native retention is uncertain."),
+        ]);
+    }
+    let handle;
+    try {
+        const flags = platform === "win32" ? constants.O_RDONLY : constants.O_RDONLY | constants.O_NOFOLLOW;
+        handle = await dependencies.open(settingsPath, flags);
+    }
+    catch {
+        return inspection("unreadable", [
+            warning("CLAUDE_RETENTION_SETTINGS_UNREADABLE", "Claude user settings could not be opened safely; native retention is uncertain."),
+        ]);
+    }
+    let contents;
+    try {
+        const before = await handle.stat();
+        if (!before.isFile() || !stableStats(entryStats, before) || before.size > MAX_SETTINGS_BYTES) {
+            return inspection("changed", [
+                warning("CLAUDE_RETENTION_SETTINGS_CHANGED", "Claude user settings changed during inspection; native retention is uncertain."),
+            ]);
+        }
+        const boundedRead = await readBoundedSettings(handle);
+        const after = await handle.stat();
+        if (!stableStats(before, after)) {
+            return inspection("changed", [
+                warning("CLAUDE_RETENTION_SETTINGS_CHANGED", "Claude user settings changed during inspection; native retention is uncertain."),
+            ]);
+        }
+        if (boundedRead.overflow || boundedRead.contents === undefined) {
+            return inspection("too-large", [
+                warning("CLAUDE_RETENTION_SETTINGS_TOO_LARGE", "Claude user settings exceed the inspection limit; native retention is uncertain."),
+            ]);
+        }
+        contents = boundedRead.contents;
+    }
+    catch {
+        return inspection("unreadable", [
+            warning("CLAUDE_RETENTION_SETTINGS_UNREADABLE", "Claude user settings could not be read safely; native retention is uncertain."),
+        ]);
+    }
+    finally {
+        await handle.close().catch(() => undefined);
+    }
+    let value;
+    try {
+        value = JSON.parse(contents.replace(/^\uFEFF/u, ""));
+    }
+    catch {
+        return inspection("invalid", [
+            warning("CLAUDE_RETENTION_SETTINGS_INVALID", "Claude user settings are not valid JSON; Claude may pause its native retention sweep."),
+        ]);
+    }
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return inspection("invalid", [
+            warning("CLAUDE_RETENTION_SETTINGS_INVALID", "Claude user settings must be a JSON object; Claude may pause its native retention sweep."),
+        ]);
+    }
+    const settings = value;
+    const cleanupPeriodDays = settings.cleanupPeriodDays;
+    if (cleanupPeriodDays !== undefined &&
+        (!Number.isInteger(cleanupPeriodDays) || cleanupPeriodDays < 1)) {
+        return inspection("invalid", [
+            warning("CLAUDE_RETENTION_SETTINGS_INVALID", "Claude cleanupPeriodDays must be an integer of at least 1; native retention is uncertain."),
+        ]);
+    }
+    const userConfiguredDays = cleanupPeriodDays === undefined ? undefined : cleanupPeriodDays;
+    if (Object.keys(settings).some((key) => key !== "cleanupPeriodDays")) {
+        return inspection("unverified", [
+            warning("CLAUDE_RETENTION_SETTINGS_UNVERIFIED", "Claude user settings contain fields AgentRinse does not validate; native retention is uncertain."),
+        ], userConfiguredDays);
+    }
+    return inspection("valid", [], userConfiguredDays);
+}
+//# sourceMappingURL=claude-retention.js.map

package/dist/adapters/claude-retention.js.map

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

package/dist/adapters/codex-database.d.ts

@@ -0,0 +1,64 @@
+import { type FileHandle } from "node:fs/promises";
+import { type CodexDatabaseFilename, type CodexDatabaseName, type DatabaseIdentity } from "../contracts/action.js";
+export type CodexDatabaseContract = {
+    database: CodexDatabaseName;
+    filename: CodexDatabaseFilename;
+    migrationVersion: number;
+    migrationDigest: string;
+    schemaDigest: string;
+    requiredTables: string[];
+};
+export declare const CODEX_DATABASE_CONTRACTS: Record<CodexDatabaseFilename, CodexDatabaseContract>;
+export type CommandResult = {
+    stdout: string;
+    stderr: string;
+};
+export type SqliteRunOptions = {
+    timeoutMs: number;
+    signal?: AbortSignal;
+};
+export type CodexDatabaseDependencies = {
+    signal?: AbortSignal;
+    runSqlite?: (args: string[], options?: SqliteRunOptions) => Promise<CommandResult>;
+    runLsof?: (paths: string[]) => Promise<CommandResult>;
+    runPs?: () => Promise<CommandResult>;
+};
+export type OpenHandleInspection = {
+    status: "idle";
+    pids: [];
+} | {
+    status: "busy";
+    pids: number[];
+} | {
+    status: "unknown";
+    pids: [];
+    reason: string;
+};
+export type CodexProcessInspection = {
+    status: "idle";
+    pids: [];
+} | {
+    status: "busy";
+    pids: number[];
+} | {
+    status: "unknown";
+    pids: [];
+    reason: string;
+};
+export type CodexDatabaseInspection = {
+    identity: DatabaseIdentity;
+    estimatedReclaimBytes: number;
+    freePageRatio: number;
+    quickCheck: "ok";
+    walBytes: number;
+    shmBytes: number;
+    sidecarsPresent: boolean;
+};
+export declare function codexDatabaseContract(path: string): CodexDatabaseContract | undefined;
+export declare function inspectCodexDatabase(path: string, dependencies?: CodexDatabaseDependencies, contractPath?: string, identityPath?: string, lockedHandle?: FileHandle): Promise<CodexDatabaseInspection>;
+export declare function vacuumCodexDatabaseInto(sourcePath: string, destinationPath: string, dependencies?: CodexDatabaseDependencies): Promise<void>;
+export declare function verifyCodexDatabaseIntegrity(path: string, dependencies?: CodexDatabaseDependencies): Promise<void>;
+export declare function inspectDatabaseOpenHandles(path: string, dependencies?: CodexDatabaseDependencies): Promise<OpenHandleInspection>;
+export declare function inspectCodexProcesses(dependencies?: CodexDatabaseDependencies): Promise<CodexProcessInspection>;
+export declare function codexDatabaseContractMatches(identity: DatabaseIdentity): boolean;
+//# sourceMappingURL=codex-database.d.ts.map

package/dist/adapters/codex-database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-database.d.ts","sourceRoot":"","sources":["../../src/adapters/codex-database.ts"],"names":[],"mappings":"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"}