@neurcode-ai/cli 0.16.6 → 0.16.8

package/.telemetry-bundle/dist/index.d.ts

@@ -1,10 +0,0 @@
-export { GOVERNANCE_TELEMETRY_SCHEMA_VERSION } from './contracts';
-export type { GovernanceTelemetryEnvelope, GovernanceTelemetryEventType, GovernanceTelemetryPayload, GovernanceVerifyCompletedPayload, FindingLifecyclePayload, RuleTriggerPayload, ReplayArtifactPayload, CiBypassPayload, ReviewerInteractionPayload, } from './contracts';
-export { stableStringify } from './stable-json';
-export { harvestGovernanceVerifyCompleted } from './harvest-verify';
-export { appendGovernanceTelemetryEvent, appendVerifyCompletedFromCanonical, telemetryEventsPath, } from './store';
-export { readGovernanceTelemetryEvents } from './reader';
-export { rollupRulePrecisionFromEvents, noisyRuleLeaderboard, highTrustRuleLeaderboard, } from './precision/leaderboards';
-export type { RulePrecisionRollup, TelemetryRollup } from './precision/leaderboards';
-export { trustFromVerifyPayload, trustFromRollups } from './trust-scoring';
-export type { BoundedTrustScores } from './trust-scoring';

package/.telemetry-bundle/dist/index.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.trustFromRollups = exports.trustFromVerifyPayload = exports.highTrustRuleLeaderboard = exports.noisyRuleLeaderboard = exports.rollupRulePrecisionFromEvents = exports.readGovernanceTelemetryEvents = exports.telemetryEventsPath = exports.appendVerifyCompletedFromCanonical = exports.appendGovernanceTelemetryEvent = exports.harvestGovernanceVerifyCompleted = exports.stableStringify = exports.GOVERNANCE_TELEMETRY_SCHEMA_VERSION = void 0;
-var contracts_1 = require("./contracts");
-Object.defineProperty(exports, "GOVERNANCE_TELEMETRY_SCHEMA_VERSION", { enumerable: true, get: function () { return contracts_1.GOVERNANCE_TELEMETRY_SCHEMA_VERSION; } });
-var stable_json_1 = require("./stable-json");
-Object.defineProperty(exports, "stableStringify", { enumerable: true, get: function () { return stable_json_1.stableStringify; } });
-var harvest_verify_1 = require("./harvest-verify");
-Object.defineProperty(exports, "harvestGovernanceVerifyCompleted", { enumerable: true, get: function () { return harvest_verify_1.harvestGovernanceVerifyCompleted; } });
-var store_1 = require("./store");
-Object.defineProperty(exports, "appendGovernanceTelemetryEvent", { enumerable: true, get: function () { return store_1.appendGovernanceTelemetryEvent; } });
-Object.defineProperty(exports, "appendVerifyCompletedFromCanonical", { enumerable: true, get: function () { return store_1.appendVerifyCompletedFromCanonical; } });
-Object.defineProperty(exports, "telemetryEventsPath", { enumerable: true, get: function () { return store_1.telemetryEventsPath; } });
-var reader_1 = require("./reader");
-Object.defineProperty(exports, "readGovernanceTelemetryEvents", { enumerable: true, get: function () { return reader_1.readGovernanceTelemetryEvents; } });
-var leaderboards_1 = require("./precision/leaderboards");
-Object.defineProperty(exports, "rollupRulePrecisionFromEvents", { enumerable: true, get: function () { return leaderboards_1.rollupRulePrecisionFromEvents; } });
-Object.defineProperty(exports, "noisyRuleLeaderboard", { enumerable: true, get: function () { return leaderboards_1.noisyRuleLeaderboard; } });
-Object.defineProperty(exports, "highTrustRuleLeaderboard", { enumerable: true, get: function () { return leaderboards_1.highTrustRuleLeaderboard; } });
-var trust_scoring_1 = require("./trust-scoring");
-Object.defineProperty(exports, "trustFromVerifyPayload", { enumerable: true, get: function () { return trust_scoring_1.trustFromVerifyPayload; } });
-Object.defineProperty(exports, "trustFromRollups", { enumerable: true, get: function () { return trust_scoring_1.trustFromRollups; } });

package/.telemetry-bundle/dist/precision/leaderboards.d.ts

@@ -1,20 +0,0 @@
-import type { GovernanceTelemetryEnvelope } from '../contracts';
-export interface RulePrecisionRollup {
-    ruleId: string;
-    triggerCount: number;
-    suppressionCount: number;
-    suppressionRate: number;
-}
-export interface TelemetryRollup {
-    verifyCompletedEvents: number;
-    ruleRollups: RulePrecisionRollup[];
-}
-/**
- * Aggregate rule-level signals from governance.verify.completed events only.
- * Deterministic: rules sorted by ruleId for stable output order.
- */
-export declare function rollupRulePrecisionFromEvents(events: GovernanceTelemetryEnvelope[]): TelemetryRollup;
-/** Higher score = more noise (suppressions relative to triggers). */
-export declare function noisyRuleLeaderboard(rollup: TelemetryRollup, limit?: number): RulePrecisionRollup[];
-/** Higher score = fewer suppressions per trigger (reviewer trust proxy). */
-export declare function highTrustRuleLeaderboard(rollup: TelemetryRollup, limit?: number): RulePrecisionRollup[];

package/.telemetry-bundle/dist/precision/leaderboards.js

@@ -1,72 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.rollupRulePrecisionFromEvents = rollupRulePrecisionFromEvents;
-exports.noisyRuleLeaderboard = noisyRuleLeaderboard;
-exports.highTrustRuleLeaderboard = highTrustRuleLeaderboard;
-function isVerifyCompletedPayload(p) {
-    return (typeof p === 'object' &&
-        p !== null &&
-        'structuralRuleTriggerHistogram' in p &&
-        'structuralRuleSuppressionHistogram' in p);
-}
-/**
- * Aggregate rule-level signals from governance.verify.completed events only.
- * Deterministic: rules sorted by ruleId for stable output order.
- */
-function rollupRulePrecisionFromEvents(events) {
-    const triggers = {};
-    const suppressions = {};
-    let verifyCompletedEvents = 0;
-    for (const ev of events) {
-        if (ev.eventType !== 'governance.verify.completed') {
-            continue;
-        }
-        if (!isVerifyCompletedPayload(ev.payload)) {
-            continue;
-        }
-        verifyCompletedEvents += 1;
-        const p = ev.payload;
-        for (const [ruleId, c] of Object.entries(p.structuralRuleTriggerHistogram)) {
-            triggers[ruleId] = (triggers[ruleId] ?? 0) + c;
-        }
-        for (const [ruleId, c] of Object.entries(p.structuralRuleSuppressionHistogram)) {
-            suppressions[ruleId] = (suppressions[ruleId] ?? 0) + c;
-        }
-    }
-    const ruleIds = new Set([...Object.keys(triggers), ...Object.keys(suppressions)]);
-    const ruleRollups = [...ruleIds]
-        .sort()
-        .map(ruleId => {
-        const triggerCount = triggers[ruleId] ?? 0;
-        const suppressionCount = suppressions[ruleId] ?? 0;
-        const suppressionRate = triggerCount > 0 ? suppressionCount / triggerCount : 0;
-        return { ruleId, triggerCount, suppressionCount, suppressionRate };
-    });
-    return { verifyCompletedEvents, ruleRollups };
-}
-/** Higher score = more noise (suppressions relative to triggers). */
-function noisyRuleLeaderboard(rollup, limit = 20) {
-    return [...rollup.ruleRollups]
-        .filter(r => r.triggerCount > 0)
-        .sort((a, b) => {
-        const dr = b.suppressionRate - a.suppressionRate;
-        if (dr !== 0) {
-            return dr;
-        }
-        return b.triggerCount - a.triggerCount;
-    })
-        .slice(0, limit);
-}
-/** Higher score = fewer suppressions per trigger (reviewer trust proxy). */
-function highTrustRuleLeaderboard(rollup, limit = 20) {
-    return [...rollup.ruleRollups]
-        .filter(r => r.triggerCount >= 3)
-        .sort((a, b) => {
-        const dr = a.suppressionRate - b.suppressionRate;
-        if (dr !== 0) {
-            return dr;
-        }
-        return b.triggerCount - a.triggerCount;
-    })
-        .slice(0, limit);
-}

package/.telemetry-bundle/dist/reader.d.ts

@@ -1,5 +0,0 @@
-import type { GovernanceTelemetryEnvelope } from './contracts';
-/**
- * Load all telemetry envelopes from the local JSONL store (newest lines last).
- */
-export declare function readGovernanceTelemetryEvents(repoRoot: string): GovernanceTelemetryEnvelope[];

package/.telemetry-bundle/dist/reader.js

@@ -1,46 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readGovernanceTelemetryEvents = readGovernanceTelemetryEvents;
-const fs_1 = require("fs");
-const contracts_1 = require("./contracts");
-const store_1 = require("./store");
-function isRecord(x) {
-    return typeof x === 'object' && x !== null && !Array.isArray(x);
-}
-/**
- * Load all telemetry envelopes from the local JSONL store (newest lines last).
- */
-function readGovernanceTelemetryEvents(repoRoot) {
-    const path = (0, store_1.telemetryEventsPath)(repoRoot);
-    if (!(0, fs_1.existsSync)(path)) {
-        return [];
-    }
-    let raw;
-    try {
-        raw = (0, fs_1.readFileSync)(path, 'utf8');
-    }
-    catch {
-        return [];
-    }
-    const out = [];
-    for (const line of raw.split('\n')) {
-        const t = line.trim();
-        if (!t) {
-            continue;
-        }
-        try {
-            const parsed = JSON.parse(t);
-            if (!isRecord(parsed)) {
-                continue;
-            }
-            if (parsed.schemaVersion !== contracts_1.GOVERNANCE_TELEMETRY_SCHEMA_VERSION) {
-                continue;
-            }
-            out.push(parsed);
-        }
-        catch {
-            continue;
-        }
-    }
-    return out;
-}

package/.telemetry-bundle/dist/stable-json.d.ts

@@ -1,5 +0,0 @@
-/**
- * Deterministic JSON serialization: sorted object keys at every depth.
- * Used so identical logical events stringify identically across Node versions.
- */
-export declare function stableStringify(value: unknown): string;

package/.telemetry-bundle/dist/stable-json.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.stableStringify = stableStringify;
-/**
- * Deterministic JSON serialization: sorted object keys at every depth.
- * Used so identical logical events stringify identically across Node versions.
- */
-function stableStringify(value) {
-    return JSON.stringify(sortKeysDeep(value));
-}
-function sortKeysDeep(value) {
-    if (value === null || typeof value !== 'object') {
-        return value;
-    }
-    if (Array.isArray(value)) {
-        return value.map(sortKeysDeep);
-    }
-    const obj = value;
-    const out = {};
-    for (const key of Object.keys(obj).sort()) {
-        out[key] = sortKeysDeep(obj[key]);
-    }
-    return out;
-}

package/.telemetry-bundle/dist/store.d.ts

@@ -1,10 +0,0 @@
-import type { GovernanceTelemetryEnvelope } from './contracts';
-export declare function telemetryEventsPath(repoRoot: string): string;
-/**
- * Append one telemetry line. Never throws — calibration must not break verify.
- */
-export declare function appendGovernanceTelemetryEvent(repoRoot: string, envelope: GovernanceTelemetryEnvelope): void;
-/**
- * Record verify completion from canonical CLI verify JSON (already normalized).
- */
-export declare function appendVerifyCompletedFromCanonical(repoRoot: string, canonical: Record<string, unknown> | null, runId?: string | null): void;

package/.telemetry-bundle/dist/store.js

@@ -1,52 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.telemetryEventsPath = telemetryEventsPath;
-exports.appendGovernanceTelemetryEvent = appendGovernanceTelemetryEvent;
-exports.appendVerifyCompletedFromCanonical = appendVerifyCompletedFromCanonical;
-const fs_1 = require("fs");
-const path_1 = require("path");
-const contracts_1 = require("./contracts");
-const harvest_verify_1 = require("./harvest-verify");
-const stable_json_1 = require("./stable-json");
-const REL_DIR = (0, path_1.join)('.neurcode', 'telemetry');
-const EVENTS_FILE = 'governance-events.jsonl';
-function telemetryEventsPath(repoRoot) {
-    return (0, path_1.join)(repoRoot, REL_DIR, EVENTS_FILE);
-}
-/**
- * Append one telemetry line. Never throws — calibration must not break verify.
- */
-function appendGovernanceTelemetryEvent(repoRoot, envelope) {
-    try {
-        const dir = (0, path_1.join)(repoRoot, REL_DIR);
-        if (!(0, fs_1.existsSync)(dir)) {
-            (0, fs_1.mkdirSync)(dir, { recursive: true });
-        }
-        const line = (0, stable_json_1.stableStringify)({
-            ...envelope,
-            schemaVersion: contracts_1.GOVERNANCE_TELEMETRY_SCHEMA_VERSION,
-        });
-        (0, fs_1.appendFileSync)(telemetryEventsPath(repoRoot), `${line}\n`, 'utf8');
-    }
-    catch {
-        // intentional swallow
-    }
-}
-/**
- * Record verify completion from canonical CLI verify JSON (already normalized).
- */
-function appendVerifyCompletedFromCanonical(repoRoot, canonical, runId) {
-    const harvested = (0, harvest_verify_1.harvestGovernanceVerifyCompleted)(canonical);
-    if (!harvested) {
-        return;
-    }
-    const envelope = {
-        schemaVersion: contracts_1.GOVERNANCE_TELEMETRY_SCHEMA_VERSION,
-        emittedAt: new Date().toISOString(),
-        eventType: 'governance.verify.completed',
-        runId: runId ?? null,
-        findingSetDigest: harvested.findingSetDigest,
-        payload: harvested.payload,
-    };
-    appendGovernanceTelemetryEvent(repoRoot, envelope);
-}

package/.telemetry-bundle/dist/trust-scoring.d.ts

@@ -1,20 +0,0 @@
-/**
- * Bounded, explainable trust signals — no opaque ML.
- * All outputs are in [0, 1] unless noted.
- */
-import type { GovernanceVerifyCompletedPayload } from './contracts';
-import type { TelemetryRollup } from './precision/leaderboards';
-export interface BoundedTrustScores {
-    /** 1 − (suppressed findings / max(1, total findings)) from the last completed verify slice. */
-    findingTrustScore: number;
-    /** Mean of per-rule (1 − suppressionRate) over rules with ≥1 trigger, from rollups. */
-    ruleTrustScore: number;
-    /** 1 if replay exact, 0.65 if bounded degradation, 0.5 if unknown/missing. */
-    replayTrustScore: number;
-    /** Density of blocking findings vs advisory (blocking / max(1, total)). */
-    reviewerTrustDensity: number;
-    /** Harmonic-style blend of finding + rule trust (operational usefulness proxy). */
-    governanceUsefulnessScore: number;
-}
-export declare function trustFromVerifyPayload(p: GovernanceVerifyCompletedPayload): BoundedTrustScores;
-export declare function trustFromRollups(rollup: TelemetryRollup): Pick<BoundedTrustScores, 'ruleTrustScore'>;

package/.telemetry-bundle/dist/trust-scoring.js

@@ -1,58 +0,0 @@
-"use strict";
-/**
- * Bounded, explainable trust signals — no opaque ML.
- * All outputs are in [0, 1] unless noted.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.trustFromVerifyPayload = trustFromVerifyPayload;
-exports.trustFromRollups = trustFromRollups;
-function trustFromVerifyPayload(p) {
-    const n = Math.max(1, p.governanceFindingCount);
-    const findingTrustScore = clamp01(1 - p.suppressedFindingCount / n);
-    const ruleIds = Object.keys(p.structuralRuleTriggerHistogram);
-    let sum = 0;
-    let count = 0;
-    for (const ruleId of ruleIds) {
-        const t = p.structuralRuleTriggerHistogram[ruleId] ?? 0;
-        const s = p.structuralRuleSuppressionHistogram[ruleId] ?? 0;
-        if (t <= 0) {
-            continue;
-        }
-        sum += 1 - s / t;
-        count += 1;
-    }
-    const ruleTrustScore = count > 0 ? clamp01(sum / count) : 1;
-    let replayTrustScore = 0.5;
-    if (p.replayIntegrityStatus === 'exact') {
-        replayTrustScore = 1;
-    }
-    else if (p.replayIntegrityStatus === 'bounded-degradation') {
-        replayTrustScore = 0.65;
-    }
-    const reviewerTrustDensity = clamp01(p.blockingFindingCount / n);
-    const governanceUsefulnessScore = clamp01(0.45 * findingTrustScore + 0.35 * ruleTrustScore + 0.2 * replayTrustScore);
-    return {
-        findingTrustScore,
-        ruleTrustScore,
-        replayTrustScore,
-        reviewerTrustDensity,
-        governanceUsefulnessScore,
-    };
-}
-function trustFromRollups(rollup) {
-    const rows = rollup.ruleRollups.filter(r => r.triggerCount > 0);
-    if (rows.length === 0) {
-        return { ruleTrustScore: 1 };
-    }
-    const acc = rows.reduce((s, r) => s + (1 - r.suppressionRate), 0) / rows.length;
-    return { ruleTrustScore: clamp01(acc) };
-}
-function clamp01(x) {
-    if (x < 0) {
-        return 0;
-    }
-    if (x > 1) {
-        return 1;
-    }
-    return x;
-}

package/.telemetry-bundle/package.json

@@ -1,8 +0,0 @@
-{
-  "name": "@neurcode-ai/telemetry",
-  "version": "0.1.0",
-  "description": "Deterministic, local governance telemetry for calibration and pilot intelligence",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "license": "MIT"
-}