@fingerskier/augment 0.3.1 → 0.5.0

package/dist/tally.d.ts

@@ -1,46 +0,0 @@
-/**
- * Phase-2 dogfood tally (council 2026-06-30): ~30 human-scored datapoints over
- * ~2 weeks of real use, per injection surface, never a CI gate. Data lives as
- * JSONL under `<stateDir>/tally/` — deliberately OUTSIDE the memory corpus so
- * the corpus Phase 2 measures stays clean.
- */
-export declare const TALLY_TARGET = 30;
-export declare const TALLY_VERDICTS: readonly ["helpful", "harmless", "harmful", "correct-abstention"];
-export type TallyVerdict = (typeof TALLY_VERDICTS)[number];
-/** One human rating of a recall outcome. */
-export interface TallyRating {
-    ts: string;
-    verdict: TallyVerdict;
-    /** Injection surface being rated: user-prompt-submit | pre-tool-use | mcp-search | cli-recall | unknown. */
-    surface: string;
-    note?: string;
-}
-/** One automatically-logged injection event (what search actually returned). */
-export interface TallyEvent {
-    ts: string;
-    surface: string;
-    project?: string;
-    /** Query text, truncated by the writer — context for later audit, not for ranking. */
-    query: string;
-    abstained: boolean;
-    result_count: number;
-    top_score?: number;
-    /** Durable relative paths of the memories injected. */
-    paths: string[];
-}
-export interface TallySummary {
-    total: number;
-    target: number;
-    by_verdict: Record<TallyVerdict, number>;
-    by_surface: Record<string, number>;
-    first_at?: string;
-    last_at?: string;
-}
-export declare function isTallyVerdict(value: unknown): value is TallyVerdict;
-export declare function ratingsPath(stateDir: string): string;
-export declare function eventsPath(stateDir: string): string;
-export declare function appendTallyRating(stateDir: string, rating: TallyRating): Promise<void>;
-export declare function appendTallyEvent(stateDir: string, event: TallyEvent): Promise<void>;
-export declare function readTallyRatings(stateDir: string): Promise<TallyRating[]>;
-export declare function summarizeTally(ratings: TallyRating[]): TallySummary;
-export declare function renderTallySummary(summary: TallySummary): string;

package/dist/tally.js

@@ -1,94 +0,0 @@
-import { appendFile, mkdir, readFile } from "node:fs/promises";
-import path from "node:path";
-/**
- * Phase-2 dogfood tally (council 2026-06-30): ~30 human-scored datapoints over
- * ~2 weeks of real use, per injection surface, never a CI gate. Data lives as
- * JSONL under `<stateDir>/tally/` — deliberately OUTSIDE the memory corpus so
- * the corpus Phase 2 measures stays clean.
- */
-export const TALLY_TARGET = 30;
-export const TALLY_VERDICTS = ["helpful", "harmless", "harmful", "correct-abstention"];
-export function isTallyVerdict(value) {
-    return typeof value === "string" && TALLY_VERDICTS.includes(value);
-}
-export function ratingsPath(stateDir) {
-    return path.join(stateDir, "tally", "ratings.jsonl");
-}
-export function eventsPath(stateDir) {
-    return path.join(stateDir, "tally", "events.jsonl");
-}
-async function appendLine(file, record) {
-    await mkdir(path.dirname(file), { recursive: true });
-    await appendFile(file, `${JSON.stringify(record)}\n`, "utf8");
-}
-export async function appendTallyRating(stateDir, rating) {
-    await appendLine(ratingsPath(stateDir), rating);
-}
-export async function appendTallyEvent(stateDir, event) {
-    await appendLine(eventsPath(stateDir), event);
-}
-export async function readTallyRatings(stateDir) {
-    let raw;
-    try {
-        raw = await readFile(ratingsPath(stateDir), "utf8");
-    }
-    catch {
-        return [];
-    }
-    const ratings = [];
-    for (const line of raw.split("\n")) {
-        if (!line.trim()) {
-            continue;
-        }
-        try {
-            const parsed = JSON.parse(line);
-            if (isTallyVerdict(parsed.verdict)) {
-                ratings.push(parsed);
-            }
-        }
-        catch {
-            // A corrupt line loses one datapoint, never the tally.
-        }
-    }
-    return ratings;
-}
-export function summarizeTally(ratings) {
-    const by_verdict = {
-        helpful: 0,
-        harmless: 0,
-        harmful: 0,
-        "correct-abstention": 0,
-    };
-    const by_surface = {};
-    for (const rating of ratings) {
-        by_verdict[rating.verdict] += 1;
-        by_surface[rating.surface || "unknown"] = (by_surface[rating.surface || "unknown"] ?? 0) + 1;
-    }
-    return {
-        total: ratings.length,
-        target: TALLY_TARGET,
-        by_verdict,
-        by_surface,
-        ...(ratings.length > 0
-            ? { first_at: ratings[0].ts, last_at: ratings[ratings.length - 1].ts }
-            : {}),
-    };
-}
-export function renderTallySummary(summary) {
-    const lines = [
-        `Dogfood tally: ${summary.total}/${summary.target} datapoints`,
-        `  helpful: ${summary.by_verdict.helpful}  harmless: ${summary.by_verdict.harmless}  ` +
-            `harmful: ${summary.by_verdict.harmful}  correct-abstention: ${summary.by_verdict["correct-abstention"]}`,
-    ];
-    const surfaces = Object.entries(summary.by_surface)
-        .map(([surface, count]) => `${surface}:${count}`)
-        .join("  ");
-    if (surfaces) {
-        lines.push(`  by surface: ${surfaces}`);
-    }
-    if (summary.first_at && summary.last_at) {
-        lines.push(`  window: ${summary.first_at} .. ${summary.last_at}`);
-    }
-    return lines.join("\n");
-}
-//# sourceMappingURL=tally.js.map

package/dist/tally.js.map

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