mewkit 1.10.7 → 1.11.1

package/dist/core/derived-index.d.ts

@@ -0,0 +1,34 @@
+export declare const SCHEMA_VERSION = 1;
+export declare function dbPath(claudeDir: string): string;
+export interface IndexResult {
+    dbPath: string;
+    schemaVersion: number;
+    traceRows: number;
+    costRows: number;
+}
+/** Build/refresh the derived index from the canonical logs. Full re-ingest = deterministic and
+ *  rebuild-able. Creates the DB (WAL) if absent. Never mutates the source logs. */
+export declare function buildIndex(claudeDir: string): IndexResult;
+export interface QueryResult {
+    schemaVersion: number;
+    eventsByType: {
+        event: string;
+        n: number;
+    }[];
+    runsByTier: {
+        run_id: string;
+        events: number;
+    }[];
+    frictionByResponsibility: {
+        responsibility: string;
+        n: number;
+    }[];
+    costByModel: {
+        model: string;
+        entries: number;
+        tokens: number;
+    }[];
+}
+/** Read-only aggregate/join queries. Opens the DB read-only; only static SELECTs run. */
+export declare function queryIndex(claudeDir: string): QueryResult;
+//# sourceMappingURL=derived-index.d.ts.map

package/dist/core/derived-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derived-index.d.ts","sourceRoot":"","sources":["../../src/core/derived-index.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,cAAc,IAAI,CAAC;AAuBhC,wBAAgB,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhD;AA0ED,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED;mFACmF;AACnF,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAezD;AAED,MAAM,WAAW,WAAW;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjD,wBAAwB,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClE,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAClE;AAED,yFAAyF;AACzF,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAyBzD"}

package/dist/core/derived-index.js

@@ -0,0 +1,137 @@
+import fs from "node:fs";
+import path from "node:path";
+import { DatabaseSync } from "node:sqlite";
+import { parseTraceLog } from "./trace-analysis.js";
+// A DERIVED, disposable SQLite index over the append logs. The JSONL/JSON logs stay the
+// canonical write-of-record; this DB is a rebuild-able read index (delete → reindex → identical).
+// Opt-in: nothing builds it automatically and no hook writes to it. All inserts are parameterized
+// (prepared statements); queries are static aggregates with no user-supplied SQL — no injection
+// surface. The DB lives under .claude/memory/ (already git-ignored, machine-local).
+export const SCHEMA_VERSION = 1;
+const DB_REL = path.join("memory", "index.db");
+/** Forward migrations, applied in order when the DB's PRAGMA user_version is behind. */
+const MIGRATIONS = [
+    {
+        version: 1,
+        sql: `
+		CREATE TABLE trace_events (
+			id INTEGER PRIMARY KEY,
+			ts TEXT, event TEXT, run_id TEXT, model TEXT, density TEXT,
+			responsibility TEXT, data TEXT
+		);
+		CREATE INDEX idx_trace_event ON trace_events(event);
+		CREATE INDEX idx_trace_run ON trace_events(run_id);
+		CREATE TABLE cost_entries (
+			id INTEGER PRIMARY KEY,
+			date TEXT, command TEXT, tier TEXT, model TEXT,
+			tokens INTEGER, task TEXT, raw TEXT
+		);`,
+    },
+];
+export function dbPath(claudeDir) {
+    return path.join(claudeDir, DB_REL);
+}
+function userVersion(db) {
+    const row = db.prepare("PRAGMA user_version").get();
+    const v = row?.["user_version"];
+    return typeof v === "number" ? v : 0;
+}
+/** Apply any pending forward migrations and stamp the schema version. */
+function migrate(db) {
+    let current = userVersion(db);
+    for (const m of MIGRATIONS) {
+        if (m.version > current) {
+            db.exec(m.sql);
+            db.exec(`PRAGMA user_version = ${m.version}`); // integer constant — not user input
+            current = m.version;
+        }
+    }
+}
+function asString(v) {
+    if (v === null || v === undefined)
+        return null;
+    return typeof v === "string" ? v : JSON.stringify(v);
+}
+function asNumber(v) {
+    return typeof v === "number" && Number.isFinite(v) ? v : null;
+}
+/** Ingest the trace log (full replace — deterministic rebuild). */
+function ingestTrace(db, claudeDir) {
+    const logPath = path.join(claudeDir, "memory", "trace-log.jsonl");
+    if (!fs.existsSync(logPath))
+        return 0;
+    const records = parseTraceLog(fs.readFileSync(logPath, "utf-8"));
+    const stmt = db.prepare("INSERT INTO trace_events (ts, event, run_id, model, density, responsibility, data) VALUES (?, ?, ?, ?, ?, ?, ?)");
+    for (const r of records) {
+        const data = r.data ?? {};
+        const resp = typeof data["responsibility"] === "string" ? data["responsibility"] : null;
+        stmt.run(asString(r.ts), asString(r.event), asString(r.run_id), asString(r.model), asString(r.density), resp, asString(data));
+    }
+    return records.length;
+}
+/** Ingest the cost log defensively (the CostEntry union varies; keep common columns + raw JSON). */
+function ingestCost(db, claudeDir) {
+    const logPath = path.join(claudeDir, "memory", "cost-log.json");
+    if (!fs.existsSync(logPath))
+        return 0;
+    let arr;
+    try {
+        arr = JSON.parse(fs.readFileSync(logPath, "utf-8"));
+    }
+    catch {
+        return 0;
+    }
+    if (!Array.isArray(arr))
+        return 0;
+    const stmt = db.prepare("INSERT INTO cost_entries (date, command, tier, model, tokens, task, raw) VALUES (?, ?, ?, ?, ?, ?, ?)");
+    for (const e of arr) {
+        const o = (e && typeof e === "object" ? e : {});
+        stmt.run(asString(o["date"] ?? o["ts"]), asString(o["command"]), asString(o["tier"]), asString(o["model"]), asNumber(o["tokens"]), asString(o["task"]), asString(o));
+    }
+    return arr.length;
+}
+/** Build/refresh the derived index from the canonical logs. Full re-ingest = deterministic and
+ *  rebuild-able. Creates the DB (WAL) if absent. Never mutates the source logs. */
+export function buildIndex(claudeDir) {
+    const target = dbPath(claudeDir);
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    const db = new DatabaseSync(target);
+    try {
+        db.exec("PRAGMA journal_mode = WAL");
+        migrate(db);
+        db.exec("DELETE FROM trace_events");
+        db.exec("DELETE FROM cost_entries");
+        const traceRows = ingestTrace(db, claudeDir);
+        const costRows = ingestCost(db, claudeDir);
+        return { dbPath: target, schemaVersion: userVersion(db), traceRows, costRows };
+    }
+    finally {
+        db.close();
+    }
+}
+/** Read-only aggregate/join queries. Opens the DB read-only; only static SELECTs run. */
+export function queryIndex(claudeDir) {
+    const target = dbPath(claudeDir);
+    if (!fs.existsSync(target))
+        throw new Error("no index — run `mewkit index` first");
+    const db = new DatabaseSync(target, { readOnly: true });
+    try {
+        const eventsByType = db
+            .prepare("SELECT event, COUNT(*) AS n FROM trace_events GROUP BY event ORDER BY n DESC, event")
+            .all();
+        const runsByTier = db
+            .prepare("SELECT run_id, COUNT(*) AS events FROM trace_events WHERE run_id <> '' GROUP BY run_id ORDER BY events DESC, run_id")
+            .all();
+        const frictionByResponsibility = db
+            .prepare("SELECT responsibility, COUNT(*) AS n FROM trace_events WHERE event = 'friction' AND responsibility IS NOT NULL GROUP BY responsibility ORDER BY n DESC, responsibility")
+            .all();
+        const costByModel = db
+            .prepare("SELECT COALESCE(model,'') AS model, COUNT(*) AS entries, COALESCE(SUM(tokens),0) AS tokens FROM cost_entries GROUP BY model ORDER BY tokens DESC, model")
+            .all();
+        return { schemaVersion: userVersion(db), eventsByType, runsByTier, frictionByResponsibility, costByModel };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=derived-index.js.map

package/dist/core/derived-index.js.map

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

package/dist/core/substrate.d.ts

@@ -0,0 +1,47 @@
+import type { CheckResult } from "../commands/validate.js";
+import type { Status } from "../commands/doctor-checks.js";
+/** Canonical taxonomy: 11 vendor-neutral responsibilities + 1 MeowKit-specific. Order is the
+ *  display order; `core` marks the 11 Runtime-Substrate values vs the kit-specific addition. */
+export declare const TAXONOMY: {
+    value: string;
+    label: string;
+    core: boolean;
+}[];
+export type Coverage = "covered" | "partial" | "missing";
+export interface ResponsibilityRow {
+    value: string;
+    label: string;
+    core: boolean;
+    coverage: Coverage;
+    count: number;
+    active: number;
+    examples: string[];
+}
+export interface SubstrateAggregate {
+    rows: ResponsibilityRow[];
+    /** Artifacts whose responsibility value is not in the taxonomy enum (always a problem). */
+    invalid: {
+        path: string;
+        value: string;
+    }[];
+    /** Registry-sourced artifacts with no responsibility (a hard gap — registry is the seeded set). */
+    untaggedRegistry: string[];
+    /** Frontmatter-sourced artifacts (skills/agents) with no responsibility (allowed; tag-on-touch). */
+    untaggedFrontmatter: string[];
+    totalArtifacts: number;
+}
+/** Load the allowed responsibility values from the schema; fall back to the taxonomy. */
+export declare function loadResponsibilityEnum(claudeDir: string): Set<string>;
+/** Build the responsibility×coverage aggregate from the live inventory. */
+export declare function aggregateSubstrate(claudeDir: string): SubstrateAggregate;
+/** Deterministic markdown view — generated, never hand-edited. Stable ordering keeps the
+ *  regenerate-and-diff drift check clean. */
+export declare function renderSubstrateView(agg: SubstrateAggregate): string;
+/** Validate substrate tagging + the committed view's freshness. Registry untagged / out-of-enum
+ *  / stale-view are FAIL; frontmatter untagged is WARN (tag-on-touch, reported not hidden). */
+export declare function checkSubstrate(claudeDir: string, opts?: {
+    missingViewSeverity?: Status;
+}): CheckResult[];
+/** Write/refresh the committed view from the live registry. Returns the absolute path. */
+export declare function emitSubstrateView(claudeDir: string): string;
+//# sourceMappingURL=substrate.d.ts.map

package/dist/core/substrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"substrate.d.ts","sourceRoot":"","sources":["../../src/core/substrate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAQ3D;gGACgG;AAChG,eAAO,MAAM,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,EAarE,CAAC;AAIF,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEzD,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,iBAAiB,EAAE,CAAC;IAC1B,2FAA2F;IAC3F,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3C,mGAAmG;IACnG,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,oGAAoG;IACpG,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,yFAAyF;AACzF,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAYrE;AAQD,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,CA8CxE;AAED;6CAC6C;AAC7C,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAgCnE;AAED;+FAC+F;AAC/F,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,WAAW,EAAE,CAwD5G;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAI3D"}

package/dist/core/substrate.js

@@ -0,0 +1,183 @@
+import fs from "node:fs";
+import path from "node:path";
+import { buildInventory } from "./build-inventory.js";
+// The responsibility substrate. Aggregates every harness artifact by the vendor-neutral
+// `responsibility` it serves, so coverage is auditable by responsibility rather than by file.
+// The matrix is GENERATED from the registry/frontmatter on every call — a hand-maintained map
+// would lie about state. A committed view (.claude/harness-substrate.md) is regenerated via
+// `inventory --substrate --emit` and drift-checked by `validate`.
+/** Canonical taxonomy: 11 vendor-neutral responsibilities + 1 MeowKit-specific. Order is the
+ *  display order; `core` marks the 11 Runtime-Substrate values vs the kit-specific addition. */
+export const TAXONOMY = [
+    { value: "task-specification", label: "Task specification", core: true },
+    { value: "context-selection", label: "Context selection", core: true },
+    { value: "tool-access", label: "Tool access", core: true },
+    { value: "project-memory", label: "Project memory", core: true },
+    { value: "task-state", label: "Task state", core: true },
+    { value: "observability", label: "Observability", core: true },
+    { value: "failure-attribution", label: "Failure attribution", core: true },
+    { value: "verification", label: "Verification", core: true },
+    { value: "permissions", label: "Permissions", core: true },
+    { value: "entropy-auditing", label: "Entropy auditing", core: true },
+    { value: "intervention-recording", label: "Intervention recording", core: true },
+    { value: "gate-enforcement", label: "Gate enforcement", core: false },
+];
+const VIEW_PATH = "harness-substrate.md";
+/** Load the allowed responsibility values from the schema; fall back to the taxonomy. */
+export function loadResponsibilityEnum(claudeDir) {
+    const schemaPath = path.join(claudeDir, "schemas", "harness-metadata-schema.json");
+    try {
+        const schema = JSON.parse(fs.readFileSync(schemaPath, "utf-8"));
+        const en = schema.properties?.responsibility?.enum;
+        if (Array.isArray(en) && en.length > 0)
+            return new Set(en);
+    }
+    catch {
+        /* fall through */
+    }
+    return new Set(TAXONOMY.map((t) => t.value));
+}
+function coverageOf(count, active) {
+    if (count === 0)
+        return "missing";
+    if (active === 0)
+        return "partial"; // served only by deprecated/experimental artifacts
+    return "covered";
+}
+/** Build the responsibility×coverage aggregate from the live inventory. */
+export function aggregateSubstrate(claudeDir) {
+    const { entries } = buildInventory(claudeDir);
+    const allowed = loadResponsibilityEnum(claudeDir);
+    const byResp = new Map();
+    const invalid = [];
+    const untaggedRegistry = [];
+    const untaggedFrontmatter = [];
+    for (const e of entries) {
+        const r = e.responsibility;
+        if (!r) {
+            if (e.source === "registry")
+                untaggedRegistry.push(e.path);
+            else
+                untaggedFrontmatter.push(e.path);
+            continue;
+        }
+        if (!allowed.has(r)) {
+            invalid.push({ path: e.path, value: r });
+            continue;
+        }
+        const list = byResp.get(r) ?? [];
+        list.push(e);
+        byResp.set(r, list);
+    }
+    const rows = TAXONOMY.map((t) => {
+        const list = byResp.get(t.value) ?? [];
+        const active = list.filter((e) => e.status === "active").length;
+        return {
+            value: t.value,
+            label: t.label,
+            core: t.core,
+            coverage: coverageOf(list.length, active),
+            count: list.length,
+            active,
+            examples: list.slice(0, 3).map((e) => e.id),
+        };
+    });
+    return {
+        rows,
+        invalid,
+        untaggedRegistry,
+        untaggedFrontmatter,
+        totalArtifacts: entries.length,
+    };
+}
+/** Deterministic markdown view — generated, never hand-edited. Stable ordering keeps the
+ *  regenerate-and-diff drift check clean. */
+export function renderSubstrateView(agg) {
+    const icon = { covered: "✅ covered", partial: "🟡 partial", missing: "⬜ missing" };
+    const lines = [];
+    lines.push("<!-- GENERATED by `mewkit inventory --substrate --emit` — DO NOT EDIT BY HAND. -->");
+    lines.push("<!-- Regenerate after tagging; `mewkit validate` fails if this drifts from the registry. -->");
+    lines.push("");
+    lines.push("# Harness Responsibility Substrate");
+    lines.push("");
+    lines.push("Coverage of each vendor-neutral substrate responsibility, generated from the harness registry " +
+        "+ artifact frontmatter. Eleven core values are the Runtime-Substrate taxonomy (repo-harness " +
+        "synthesis, Runtime-Substrate-rooted); `Gate enforcement` is the MeowKit-specific addition.");
+    lines.push("");
+    lines.push("| Responsibility | Coverage | Tagged | Active | Examples |");
+    lines.push("| -------------- | -------- | -----: | -----: | -------- |");
+    for (const r of agg.rows) {
+        const label = r.core ? r.label : `${r.label} *(kit)*`;
+        lines.push(`| ${label} | ${icon[r.coverage]} | ${r.count} | ${r.active} | ${r.examples.join(", ") || "—"} |`);
+    }
+    lines.push("");
+    const missing = agg.rows.filter((r) => r.coverage === "missing").map((r) => r.label);
+    lines.push(`**Coverage:** ${agg.rows.filter((r) => r.coverage === "covered").length}/${agg.rows.length} responsibilities have active artifacts.` +
+        (missing.length ? ` Missing: ${missing.join(", ")}.` : ""));
+    lines.push(`**Untagged:** ${agg.untaggedRegistry.length} registry + ${agg.untaggedFrontmatter.length} frontmatter ` +
+        `artifacts carry no responsibility (frontmatter is tag-on-touch; registry should be 100%).`);
+    lines.push("");
+    return lines.join("\n");
+}
+/** Validate substrate tagging + the committed view's freshness. Registry untagged / out-of-enum
+ *  / stale-view are FAIL; frontmatter untagged is WARN (tag-on-touch, reported not hidden). */
+export function checkSubstrate(claudeDir, opts = {}) {
+    const section = "Substrate";
+    const results = [];
+    const agg = aggregateSubstrate(claudeDir);
+    for (const inv of agg.invalid) {
+        results.push({ name: `Substrate: ${inv.path}`, status: "fail", detail: `responsibility="${inv.value}" not in taxonomy enum`, section });
+    }
+    for (const p of agg.untaggedRegistry) {
+        results.push({ name: `Substrate: ${p}`, status: "fail", detail: "registry artifact has no responsibility (seed it)", section });
+    }
+    if (agg.untaggedFrontmatter.length > 0) {
+        results.push({
+            name: "Substrate: untagged frontmatter artifacts",
+            status: "warn",
+            detail: `${agg.untaggedFrontmatter.length} skill/agent artifact(s) untagged — tag-on-touch (allowed, reported).`,
+            section,
+        });
+    }
+    // View freshness: regenerate and diff against the committed file.
+    const viewPath = path.join(claudeDir, VIEW_PATH);
+    const fresh = renderSubstrateView(agg);
+    if (!fs.existsSync(viewPath)) {
+        const status = opts.missingViewSeverity ?? "fail";
+        results.push({
+            name: "Substrate view present",
+            status,
+            detail: status === "warn"
+                ? "No .claude/harness-substrate.md — run `mewkit inventory --substrate --emit`"
+                : "Missing .claude/harness-substrate.md (run `mewkit inventory --substrate --emit`)",
+            section,
+        });
+    }
+    else {
+        const committed = fs.readFileSync(viewPath, "utf-8");
+        const inSync = committed.trim() === fresh.trim();
+        results.push({
+            name: "Substrate view in sync",
+            status: inSync ? "pass" : "fail",
+            detail: inSync ? viewPath : "harness-substrate.md is stale — run `mewkit inventory --substrate --emit`",
+            section,
+        });
+    }
+    const fails = results.filter((r) => r.status === "fail").length;
+    results.push({
+        name: "Substrate coverage",
+        status: fails === 0 ? "pass" : "fail",
+        detail: fails === 0
+            ? `${agg.totalArtifacts} artifacts; ${agg.rows.filter((r) => r.coverage === "covered").length}/${agg.rows.length} responsibilities covered`
+            : `${fails} substrate issue(s)`,
+        section,
+    });
+    return results;
+}
+/** Write/refresh the committed view from the live registry. Returns the absolute path. */
+export function emitSubstrateView(claudeDir) {
+    const viewPath = path.join(claudeDir, VIEW_PATH);
+    fs.writeFileSync(viewPath, renderSubstrateView(aggregateSubstrate(claudeDir)) + "\n");
+    return viewPath;
+}
+//# sourceMappingURL=substrate.js.map

package/dist/core/substrate.js.map

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

package/dist/core/trace-analysis.d.ts

@@ -0,0 +1,60 @@
+/** One JSONL trace record (shape written by hooks/append-trace.sh; fields are best-effort). */
+export interface TraceRecord {
+    schema_version?: string;
+    ts?: string;
+    event?: string;
+    run_id?: string;
+    model?: string;
+    density?: string;
+    data?: Record<string, unknown>;
+}
+export type TraceTier = "minimal" | "standard" | "detailed";
+/** Parse JSONL; skip blank/malformed lines rather than throwing (logs are append-only and
+ *  may contain a partially-written trailing line). */
+export declare function parseTraceLog(content: string): TraceRecord[];
+export interface ScoreResult {
+    tier: TraceTier;
+    events: number;
+    types: number;
+    hasVerification: boolean;
+}
+/** Trace-quality tier for a set of records: richer + more diverse + verified ⇒ higher tier. */
+export declare function scoreTier(records: TraceRecord[]): ScoreResult;
+/** Group records by run_id (a "lane") and score each. Records with no run_id share the
+ *  synthetic "(unattributed)" lane. */
+export declare function scoreByRun(records: TraceRecord[]): Map<string, ScoreResult>;
+/** Shannon entropy (bits) over the event-type distribution — a disorder measure. */
+export declare function shannonEntropy(records: TraceRecord[]): number;
+/** Normalize a friction message for grouping: lowercase, collapse whitespace, strip wrapping
+ *  quotes and trailing punctuation. Identical-in-meaning lines collapse to one key. */
+export declare function normalizeFriction(msg: string): string;
+export interface FrictionGroup {
+    message: string;
+    count: number;
+    responsibility?: string;
+}
+/** Group friction records by normalized message, descending by count then message. */
+export declare function groupFriction(records: TraceRecord[]): FrictionGroup[];
+export interface AuditResult {
+    total: number;
+    orphaned: number;
+    stale: number;
+    unverifiedRuns: number;
+    entropy: number;
+    repeatedFriction: FrictionGroup[];
+    frictionByResponsibility: Record<string, number>;
+}
+/** Entropy / drift audit. `now` + `staleDays` are injected for determinism. */
+export declare function auditTraces(records: TraceRecord[], opts: {
+    now: Date;
+    staleDays?: number;
+}): AuditResult;
+export interface ProposalItem {
+    kind: "friction" | "drift";
+    title: string;
+    evidenceCount: number;
+    responsibility?: string;
+}
+/** Advisory backlog proposals: repeated friction (≥2) + audit drift findings. Never gates. */
+export declare function proposeImprovements(audit: AuditResult): ProposalItem[];
+//# sourceMappingURL=trace-analysis.d.ts.map

package/dist/core/trace-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-analysis.d.ts","sourceRoot":"","sources":["../../src/core/trace-analysis.ts"],"names":[],"mappings":"AAIA,+FAA+F;AAC/F,MAAM,WAAW,WAAW;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAK5D;sDACsD;AACtD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAa5D;AAED,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,OAAO,CAAC;CACzB;AAED,+FAA+F;AAC/F,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,WAAW,CAQ7D;AAED;uCACuC;AACvC,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAW3E;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAc7D;AAED;uFACuF;AACvF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOrD;AAgBD,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,aAAa,EAAE,CAYrE;AAED,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClC,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjD;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE;IAAE,GAAG,EAAE,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CA2CxG;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,8FAA8F;AAC9F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,EAAE,CAWtE"}