@wrongstack/core 0.313.0 → 0.316.1

package/dist/observability/tool-usage-source.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Hybrid stats source for the auto-thinning pipeline. The Chronicle rollup
+ * (`tool_daily`) is the cross-session source of truth; the in-process bridge
+ * Map fills the gap when Chronicle is unavailable (no node:sqlite at runtime)
+ * or hasn't been refreshed yet. The source returns a unified
+ * `UnderusedToolCandidate[]` so the policy layer never has to branch on
+ * which backend answered.
+ *
+ * The resolver prefers Chronicle whenever it has at least one row in the
+ * requested window — even when the in-process Map also has data, because the
+ * cross-session history is what the user actually wants to thin against.
+ */
+import type { ChronicleMetricsStore } from '../chronicle/metrics-store.js';
+import type { ToolUsageSnapshot } from './event-bridge.js';
+export interface UnderusedToolCandidate {
+    /** Stable tool name. For MCP names, this is the full `mcp__server__tool` form. */
+    name: string;
+    invocations: number;
+    failures: number;
+    durationMsTotal: number;
+    /** Epoch ms; null when the tool has never been observed in the source's window. */
+    lastInvokedAt: number | null;
+    /** Calendar days since `lastInvokedAt`; null when the tool was never observed. */
+    daysSinceLastUse: number | null;
+    /** Which backend produced the row — useful for the slash command's "source" badge. */
+    source: 'chronicle' | 'in-process';
+}
+export interface UnderusedQueryOptions {
+    /** Calendar days of inactivity. Tools not invoked in this window are candidates. */
+    idleDays: number;
+    /** Tools with `invocations <= minInvocations` in the window are candidates. */
+    minInvocations: number;
+    /** Inclusive lower bound on the Chronicle day range (YYYY-MM-DD). */
+    fromDay?: string;
+    /** Inclusive upper bound on the Chronicle day range (YYYY-MM-DD). */
+    toDay?: string;
+    /** Cap on the returned candidate set. Default 500. */
+    limit?: number;
+}
+export interface ToolUsageSource {
+    kind: 'chronicle' | 'in-process';
+    candidates(opts: UnderusedQueryOptions): Promise<UnderusedToolCandidate[]>;
+    /** Force Chronicle to fold any new journal bytes before answering. */
+    refresh?(): Promise<void>;
+}
+export interface CreateToolUsageSourceDeps {
+    chronicle?: ChronicleMetricsStore | undefined;
+    bridge?: ToolUsageSnapshot | undefined;
+    /**
+     * Wall-clock anchor for "days since last use". Defaults to `Date.now()`. Tests
+     * pass a fixed value to make the boundary deterministic.
+     */
+    now?: () => number;
+}
+export declare function createToolUsageSource(deps: CreateToolUsageSourceDeps): ToolUsageSource;
+/**
+ * Apply the auto-thinning policy to a candidate set: keep only tools that
+ *   - have been seen (or never seen but the source is in-process),
+ *   - sit at or below `minInvocations` in the window, AND
+ *   - have not been invoked in the last `idleDays` days.
+ *
+ * Pure function so the policy is testable without I/O.
+ */
+export declare function filterUnderused(candidates: readonly UnderusedToolCandidate[], opts: UnderusedQueryOptions, now?: number): UnderusedToolCandidate[];
+//# sourceMappingURL=tool-usage-source.d.ts.map

package/dist/plugin/index.d.ts

@@ -13,6 +13,11 @@ export { type ParsedReviewReport, parseChimeraReviewReport, } from '../plugins/r
 export { verifyFindingsAgainstDisk, type VerifyFindingsOptions, } from '../plugins/review-finding-verification.js';
 export { persistReviewReport, type ReportIntegrationResult, updateReviewReportEvidence, } from '../plugins/review-report-integration.js';
 export { maybeCompactReviewStores, type ReviewStoreMaintenanceResult, } from '../plugins/review-store-maintenance.js';
+export { FINDING_STORE_FILE, JsonlFindingStore, resolveFindingStorePath, type FindingStore, type UpsertContext, type UpsertResult, type ListOptions as FindingListOptions, } from '../plugins/review-finding-store.js';
+export { REPORT_STORE_FILE, JsonlReportStore, resolveReportStorePath, type ReportStore, type PersistReportInput, type ListReportsOptions, } from '../plugins/review-report-store.js';
+export { syncReportCompletion, syncReportReopen, type ReportSyncResult, type ReportReopenResult, } from '../plugins/review-report-integration.js';
+export type { ChimeraFinding, ChimeraFindingLocation, ChimeraFindingOrigin, ChimeraFindingResolution, FindingCategory, FindingConfidence, FindingEventType, FindingLifecycleEvent, FindingSeverity, FindingSource, FindingStatus, FindingVerification, FindingVerificationStatus, ResolutionOutcome, } from '../plugins/review-finding-types.js';
+export type { ReportActorKind, ReportEventType, ReportLifecycleStatus, ReviewReport, ReviewReportCounts, ReviewReportEvent, ReviewReportFile, } from '../plugins/review-report-types.js';
 export { createSkillsPlugin } from '../plugins/skills-plugin.js';
 export { createSyncPlugin } from '../plugins/sync-plugin.js';
 export { createCloudConfigSyncPlugin } from '../plugins/cloud-config-sync-plugin.js';