@aiassesstech/nole 0.1.0

package/dist/governance/governance-router.d.ts

@@ -0,0 +1,60 @@
+import type { ActionProposal, GovernanceResult, CreateProposalInput } from './types.js';
+import type { GrilloAssessmentSummary } from '../types/shared.js';
+import type { NoleStore } from '../store/types.js';
+import { VetoTracker } from './veto-tracker.js';
+import { AuditTrail } from './audit-trail.js';
+/**
+ * Callback for requesting Grillo assessment of a proposal.
+ * Returns assessment result, or null if assessment is not needed/available.
+ */
+export type AssessmentCallback = (proposal: ActionProposal) => Promise<GrilloAssessmentSummary | null>;
+/**
+ * Callback for escalating to the Commander (Jessie).
+ * Returns the Commander's decision and optional explanation.
+ */
+export type CommanderCallback = (proposal: ActionProposal, assessment: GrilloAssessmentSummary) => Promise<{
+    decision: 'approved' | 'vetoed';
+    explanation?: string;
+}>;
+/**
+ * The Governance Router — core of the three-tier decision engine.
+ *
+ * Decision flow (Patent Section 3.2):
+ * 1. Nole creates a proposal
+ * 2. If pre-assessment required → Grillo assesses
+ * 3. If Grillo flags concerns → escalate to Commander
+ * 4. Commander vetoes or approves
+ * 5. If vetoed → explanation delivered, learning tracked
+ * 6. If approved → action marked for execution
+ * 7. Entire chain logged in immutable audit trail
+ */
+export declare class GovernanceRouter {
+    private readonly store;
+    private readonly proposer;
+    readonly vetoTracker: VetoTracker;
+    readonly auditTrail: AuditTrail;
+    private assessmentCallback;
+    private commanderCallback;
+    constructor(store: NoleStore, financialThreshold?: number, agentId?: string);
+    /** Register the Grillo assessment callback */
+    onAssessment(callback: AssessmentCallback): void;
+    /** Register the Commander escalation callback */
+    onCommanderEscalation(callback: CommanderCallback): void;
+    /**
+     * Propose and process an action through the full governance pipeline.
+     * This is the main entry point for all Nole decisions.
+     */
+    propose(input: CreateProposalInput): Promise<GovernanceResult>;
+    /** Withdraw a pending proposal */
+    withdraw(proposalId: string, reason: string): Promise<GovernanceResult>;
+    /** Get governance statistics */
+    getStats(): Promise<{
+        totalProposals: number;
+        executed: number;
+        vetoed: number;
+        withdrawn: number;
+        vetoRate: number;
+        auditChainValid: boolean;
+    }>;
+}
+//# sourceMappingURL=governance-router.d.ts.map

package/dist/governance/governance-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance-router.d.ts","sourceRoot":"","sources":["../../src/governance/governance-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,QAAQ,EAAE,cAAc,KACrB,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,QAAQ,EAAE,cAAc,EACxB,UAAU,EAAE,uBAAuB,KAChC,OAAO,CAAC;IAAE,QAAQ,EAAE,UAAU,GAAG,QAAQ,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAExE;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAgB;IAQzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAPxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,OAAO,CAAC,kBAAkB,CAAmC;IAC7D,OAAO,CAAC,iBAAiB,CAAkC;gBAGxC,KAAK,EAAE,SAAS,EACjC,kBAAkB,GAAE,MAAW,EAC/B,OAAO,GAAE,MAAe;IAO1B,8CAA8C;IAC9C,YAAY,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAIhD,iDAAiD;IACjD,qBAAqB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAIxD;;;OAGG;IACG,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuHpE,kCAAkC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2B7E,gCAAgC;IAC1B,QAAQ,IAAI,OAAO,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;CAiBH"}

package/dist/governance/governance-router.js

@@ -0,0 +1,143 @@
+import { ActionProposer } from './action-proposer.js';
+import { VetoTracker } from './veto-tracker.js';
+import { AuditTrail } from './audit-trail.js';
+import { computeAuditHash, GENESIS_HASH } from '../store/hash-chain.js';
+/**
+ * The Governance Router — core of the three-tier decision engine.
+ *
+ * Decision flow (Patent Section 3.2):
+ * 1. Nole creates a proposal
+ * 2. If pre-assessment required → Grillo assesses
+ * 3. If Grillo flags concerns → escalate to Commander
+ * 4. Commander vetoes or approves
+ * 5. If vetoed → explanation delivered, learning tracked
+ * 6. If approved → action marked for execution
+ * 7. Entire chain logged in immutable audit trail
+ */
+export class GovernanceRouter {
+    store;
+    proposer;
+    vetoTracker;
+    auditTrail;
+    assessmentCallback = null;
+    commanderCallback = null;
+    constructor(store, financialThreshold = 10, agentId = 'nole') {
+        this.store = store;
+        this.proposer = new ActionProposer(financialThreshold);
+        this.vetoTracker = new VetoTracker(store);
+        this.auditTrail = new AuditTrail(store, agentId);
+    }
+    /** Register the Grillo assessment callback */
+    onAssessment(callback) {
+        this.assessmentCallback = callback;
+    }
+    /** Register the Commander escalation callback */
+    onCommanderEscalation(callback) {
+        this.commanderCallback = callback;
+    }
+    /**
+     * Propose and process an action through the full governance pipeline.
+     * This is the main entry point for all Nole decisions.
+     */
+    async propose(input) {
+        // Step 1: Create the proposal
+        const proposal = this.proposer.createProposal(input);
+        const validation = this.proposer.validateProposal(proposal);
+        if (!validation.valid) {
+            throw new Error(`Invalid proposal: ${validation.errors.join(', ')}`);
+        }
+        await this.store.saveProposal(proposal);
+        await this.auditTrail.record('proposal_created', `Proposed: ${proposal.actionType} — ${proposal.description}`, proposal.id);
+        // Step 2: Assess if required
+        let assessment = null;
+        let escalated = false;
+        let commanderDecision;
+        let vetoExplanation;
+        if (proposal.requiresPreAssessment && this.assessmentCallback) {
+            await this.auditTrail.record('assessment_requested', `Pre-action assessment requested for ${proposal.actionType}`, proposal.id);
+            assessment = await this.assessmentCallback(proposal);
+            if (assessment) {
+                await this.auditTrail.record('assessment_completed', `Assessment: ${assessment.archetype}, passed=${assessment.passed}`, proposal.id);
+                // Step 3: Escalate to Commander if Grillo flags concerns
+                if (!assessment.passed && this.commanderCallback) {
+                    escalated = true;
+                    await this.auditTrail.record('escalated_to_commander', `Grillo flagged: ${assessment.archetype}. Escalating to Commander.`, proposal.id);
+                    const commanderResult = await this.commanderCallback(proposal, assessment);
+                    commanderDecision = commanderResult.decision;
+                    if (commanderDecision === 'vetoed') {
+                        vetoExplanation = commanderResult.explanation ?? 'No explanation provided';
+                        await this.auditTrail.record('commander_vetoed', `Commander vetoed: ${vetoExplanation}`, proposal.id);
+                        // Track veto for learning metrics
+                        await this.vetoTracker.recordVeto(proposal.id, vetoExplanation, proposal.actionType);
+                    }
+                    else {
+                        await this.auditTrail.record('commander_approved', 'Commander approved after Grillo flag.', proposal.id);
+                    }
+                }
+            }
+        }
+        // Step 4: Determine final outcome
+        let finalOutcome;
+        if (commanderDecision === 'vetoed') {
+            finalOutcome = 'vetoed';
+            await this.auditTrail.record('veto_explanation_received', `Veto explanation: ${vetoExplanation}`, proposal.id);
+        }
+        else {
+            finalOutcome = 'executed';
+            await this.auditTrail.record('action_executed', `Action approved and executed: ${proposal.description}`, proposal.id);
+        }
+        // Step 5: Build and store result
+        const latestAudit = await this.auditTrail.getLatest();
+        const auditHash = latestAudit?.hash ?? computeAuditHash(GENESIS_HASH, new Date(), 'action_executed', proposal.description, 'nole');
+        const result = {
+            proposalId: proposal.id,
+            proposal,
+            grilloAssessment: assessment ?? undefined,
+            escalatedToCommander: escalated,
+            commanderDecision,
+            vetoExplanation,
+            finalOutcome,
+            processedAt: new Date(),
+            auditHash,
+        };
+        await this.store.saveGovernanceResult(result);
+        return result;
+    }
+    /** Withdraw a pending proposal */
+    async withdraw(proposalId, reason) {
+        const proposal = await this.store.getProposal(proposalId);
+        if (!proposal) {
+            throw new Error(`Proposal not found: ${proposalId}`);
+        }
+        await this.auditTrail.record('action_withdrawn', `Withdrawn: ${reason}`, proposalId);
+        const latestAudit = await this.auditTrail.getLatest();
+        const result = {
+            proposalId,
+            proposal,
+            escalatedToCommander: false,
+            finalOutcome: 'withdrawn',
+            processedAt: new Date(),
+            auditHash: latestAudit?.hash ?? GENESIS_HASH,
+        };
+        await this.store.saveGovernanceResult(result);
+        return result;
+    }
+    /** Get governance statistics */
+    async getStats() {
+        const results = await this.store.listGovernanceResults(10000);
+        const executed = results.filter((r) => r.finalOutcome === 'executed').length;
+        const vetoed = results.filter((r) => r.finalOutcome === 'vetoed').length;
+        const withdrawn = results.filter((r) => r.finalOutcome === 'withdrawn').length;
+        const total = results.length;
+        const chainVerification = await this.auditTrail.verify();
+        return {
+            totalProposals: total,
+            executed,
+            vetoed,
+            withdrawn,
+            vetoRate: total > 0 ? vetoed / total : 0,
+            auditChainValid: chainVerification.valid,
+        };
+    }
+}
+//# sourceMappingURL=governance-router.js.map

package/dist/governance/governance-router.js.map

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

package/dist/governance/types.d.ts

@@ -0,0 +1,87 @@
+import type { ActionCategory, RiskLevel, AuditHash, GrilloAssessmentSummary, NoleId } from '../types/shared.js';
+/**
+ * An action Nole proposes to take.
+ * All significant actions flow through the governance engine:
+ * propose → assess → veto/approve → execute → audit
+ */
+export interface ActionProposal {
+    id: NoleId;
+    timestamp: Date;
+    agentId: string;
+    actionType: ActionCategory;
+    description: string;
+    estimatedCostUsd: number;
+    riskLevel: RiskLevel;
+    targetAgent?: string;
+    platform?: string;
+    metadata?: Record<string, unknown>;
+    requiresPreAssessment: boolean;
+}
+/** Outcome after governance processing */
+export type ProposalOutcome = 'executed' | 'vetoed' | 'withdrawn' | 'pending';
+/** Full governance result for a proposal */
+export interface GovernanceResult {
+    proposalId: NoleId;
+    proposal: ActionProposal;
+    grilloAssessment?: GrilloAssessmentSummary;
+    escalatedToCommander: boolean;
+    commanderDecision?: 'approved' | 'vetoed';
+    vetoExplanation?: string;
+    finalOutcome: ProposalOutcome;
+    processedAt: Date;
+    auditHash: AuditHash;
+}
+/** A single veto event — tracked for learning metrics */
+export interface VetoRecord {
+    proposalId: NoleId;
+    vetoedAt: Date;
+    explanation: string;
+    actionType: ActionCategory;
+    lessonsLearned?: string;
+}
+/** Aggregated veto statistics */
+export interface VetoMetrics {
+    totalProposals: number;
+    totalVetoes: number;
+    vetoRate: number;
+    vetosByCategory: Record<ActionCategory, number>;
+    vetoTrend: VetoTrendPoint[];
+    averageVetoRateLastWeek: number;
+    averageVetoRateLastMonth: number;
+}
+/** A single data point in the veto trend */
+export interface VetoTrendPoint {
+    periodStart: Date;
+    periodEnd: Date;
+    proposals: number;
+    vetoes: number;
+    rate: number;
+}
+/** Immutable audit trail entry */
+export interface AuditEntry {
+    id: NoleId;
+    timestamp: Date;
+    action: AuditAction;
+    proposalId?: NoleId;
+    agentId: string;
+    details: string;
+    previousHash: AuditHash;
+    hash: AuditHash;
+}
+/** Audit action categories */
+export type AuditAction = 'proposal_created' | 'assessment_requested' | 'assessment_completed' | 'escalated_to_commander' | 'commander_approved' | 'commander_vetoed' | 'action_executed' | 'action_withdrawn' | 'veto_explanation_received' | 'config_changed' | 'agent_started' | 'agent_stopped' | 'daily_assessment' | 'score_published';
+/** Input for creating a proposal */
+export interface CreateProposalInput {
+    actionType: ActionCategory;
+    description: string;
+    estimatedCostUsd?: number;
+    riskLevel?: RiskLevel;
+    targetAgent?: string;
+    platform?: string;
+    metadata?: Record<string, unknown>;
+}
+/** Determines if an action requires pre-assessment based on triggers (Patent Section 10.1) */
+export declare function requiresPreAssessment(actionType: ActionCategory, estimatedCostUsd: number, financialThreshold: number): boolean;
+/** Default risk level based on action category */
+export declare function defaultRiskLevel(actionType: ActionCategory, costUsd: number): RiskLevel;
+//# sourceMappingURL=types.d.ts.map

package/dist/governance/types.d.ts.map

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

package/dist/governance/types.js

@@ -0,0 +1,35 @@
+/** Determines if an action requires pre-assessment based on triggers (Patent Section 10.1) */
+export function requiresPreAssessment(actionType, estimatedCostUsd, financialThreshold) {
+    if (actionType === 'financial' && estimatedCostUsd > financialThreshold)
+        return true;
+    if (actionType === 'recruitment')
+        return true;
+    if (actionType === 'content')
+        return true;
+    if (actionType === 'model_upgrade')
+        return true;
+    if (actionType === 'adversarial_response')
+        return true;
+    return false;
+}
+/** Default risk level based on action category */
+export function defaultRiskLevel(actionType, costUsd) {
+    if (actionType === 'model_upgrade')
+        return 'high';
+    if (actionType === 'adversarial_response')
+        return 'high';
+    if (actionType === 'financial' && costUsd > 50)
+        return 'high';
+    if (actionType === 'financial' && costUsd > 10)
+        return 'medium';
+    if (actionType === 'recruitment')
+        return 'medium';
+    if (actionType === 'content')
+        return 'medium';
+    if (actionType === 'intelligence')
+        return 'low';
+    if (actionType === 'self_assessment')
+        return 'low';
+    return 'low';
+}
+//# sourceMappingURL=types.js.map

package/dist/governance/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/governance/types.ts"],"names":[],"mappings":"AAgHA,8FAA8F;AAC9F,MAAM,UAAU,qBAAqB,CACnC,UAA0B,EAC1B,gBAAwB,EACxB,kBAA0B;IAE1B,IAAI,UAAU,KAAK,WAAW,IAAI,gBAAgB,GAAG,kBAAkB;QAAE,OAAO,IAAI,CAAC;IACrF,IAAI,UAAU,KAAK,aAAa;QAAE,OAAO,IAAI,CAAC;IAC9C,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,UAAU,KAAK,eAAe;QAAE,OAAO,IAAI,CAAC;IAChD,IAAI,UAAU,KAAK,sBAAsB;QAAE,OAAO,IAAI,CAAC;IACvD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,gBAAgB,CAAC,UAA0B,EAAE,OAAe;IAC1E,IAAI,UAAU,KAAK,eAAe;QAAE,OAAO,MAAM,CAAC;IAClD,IAAI,UAAU,KAAK,sBAAsB;QAAE,OAAO,MAAM,CAAC;IACzD,IAAI,UAAU,KAAK,WAAW,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,MAAM,CAAC;IAC9D,IAAI,UAAU,KAAK,WAAW,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,QAAQ,CAAC;IAChE,IAAI,UAAU,KAAK,aAAa;QAAE,OAAO,QAAQ,CAAC;IAClD,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC9C,IAAI,UAAU,KAAK,cAAc;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,UAAU,KAAK,iBAAiB;QAAE,OAAO,KAAK,CAAC;IACnD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/governance/veto-tracker.d.ts

@@ -0,0 +1,28 @@
+import type { VetoRecord, VetoMetrics } from './types.js';
+import type { ActionCategory } from '../types/shared.js';
+import type { NoleStore } from '../store/types.js';
+/**
+ * Tracks veto frequency as a learning metric.
+ *
+ * From Patent Section 3.5:
+ * "Over time, the frequency of vetoes should decrease as Noah internalizes
+ * ethical judgment. The trajectory of veto frequency itself becomes
+ * measurable data."
+ *
+ * Declining vetoes = maturity. Frequent vetoes early = learning.
+ */
+export declare class VetoTracker {
+    private readonly store;
+    constructor(store: NoleStore);
+    /** Record a new veto */
+    recordVeto(proposalId: string, explanation: string, actionType: ActionCategory, lessonsLearned?: string): Promise<VetoRecord>;
+    /** Get veto metrics for a time period */
+    getMetrics(totalProposals: number): Promise<VetoMetrics>;
+    /** Is the veto rate declining? (indicates learning) */
+    isLearning(): Promise<{
+        learning: boolean;
+        trend: 'declining' | 'stable' | 'increasing';
+    }>;
+    private computeWeeklyTrend;
+}
+//# sourceMappingURL=veto-tracker.d.ts.map

package/dist/governance/veto-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"veto-tracker.d.ts","sourceRoot":"","sources":["../../src/governance/veto-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAkB,MAAM,YAAY,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;;;;;;;GASG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,SAAS;IAE7C,wBAAwB;IAClB,UAAU,CACd,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,cAAc,EAC1B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,UAAU,CAAC;IAYtB,yCAAyC;IACnC,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAqC9D,uDAAuD;IACjD,UAAU,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAA;KAAE,CAAC;IA0BhG,OAAO,CAAC,kBAAkB;CA2B3B"}

package/dist/governance/veto-tracker.js

@@ -0,0 +1,96 @@
+/**
+ * Tracks veto frequency as a learning metric.
+ *
+ * From Patent Section 3.5:
+ * "Over time, the frequency of vetoes should decrease as Noah internalizes
+ * ethical judgment. The trajectory of veto frequency itself becomes
+ * measurable data."
+ *
+ * Declining vetoes = maturity. Frequent vetoes early = learning.
+ */
+export class VetoTracker {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    /** Record a new veto */
+    async recordVeto(proposalId, explanation, actionType, lessonsLearned) {
+        const record = {
+            proposalId,
+            vetoedAt: new Date(),
+            explanation,
+            actionType,
+            lessonsLearned,
+        };
+        await this.store.saveVetoRecord(record);
+        return record;
+    }
+    /** Get veto metrics for a time period */
+    async getMetrics(totalProposals) {
+        const allVetoes = await this.store.listVetoRecords();
+        const now = new Date();
+        const weekAgo = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
+        const monthAgo = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
+        const vetoesLastWeek = allVetoes.filter((v) => new Date(v.vetoedAt) >= weekAgo);
+        const vetoesLastMonth = allVetoes.filter((v) => new Date(v.vetoedAt) >= monthAgo);
+        // Count vetoes by category
+        const vetosByCategory = {};
+        for (const veto of allVetoes) {
+            vetosByCategory[veto.actionType] =
+                (vetosByCategory[veto.actionType] ?? 0) + 1;
+        }
+        // Compute weekly trend (last 8 weeks)
+        const vetoTrend = this.computeWeeklyTrend(allVetoes, totalProposals);
+        return {
+            totalProposals,
+            totalVetoes: allVetoes.length,
+            vetoRate: totalProposals > 0 ? allVetoes.length / totalProposals : 0,
+            vetosByCategory,
+            vetoTrend,
+            averageVetoRateLastWeek: vetoesLastWeek.length > 0 ? vetoesLastWeek.length / Math.max(1, totalProposals) : 0,
+            averageVetoRateLastMonth: vetoesLastMonth.length > 0 ? vetoesLastMonth.length / Math.max(1, totalProposals) : 0,
+        };
+    }
+    /** Is the veto rate declining? (indicates learning) */
+    async isLearning() {
+        const allVetoes = await this.store.listVetoRecords();
+        if (allVetoes.length < 3) {
+            return { learning: false, trend: 'stable' };
+        }
+        const now = new Date();
+        const recentWeek = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
+        const priorWeek = new Date(now.getTime() - 14 * 24 * 60 * 60 * 1000);
+        const recentCount = allVetoes.filter((v) => new Date(v.vetoedAt) >= recentWeek).length;
+        const priorCount = allVetoes.filter((v) => new Date(v.vetoedAt) >= priorWeek && new Date(v.vetoedAt) < recentWeek).length;
+        if (recentCount < priorCount) {
+            return { learning: true, trend: 'declining' };
+        }
+        else if (recentCount === priorCount) {
+            return { learning: false, trend: 'stable' };
+        }
+        else {
+            return { learning: false, trend: 'increasing' };
+        }
+    }
+    computeWeeklyTrend(vetoes, _totalProposals) {
+        const now = new Date();
+        const trend = [];
+        for (let week = 7; week >= 0; week--) {
+            const periodEnd = new Date(now.getTime() - week * 7 * 24 * 60 * 60 * 1000);
+            const periodStart = new Date(periodEnd.getTime() - 7 * 24 * 60 * 60 * 1000);
+            const weekVetoes = vetoes.filter((v) => {
+                const d = new Date(v.vetoedAt);
+                return d >= periodStart && d < periodEnd;
+            });
+            trend.push({
+                periodStart,
+                periodEnd,
+                proposals: 0, // Would need proposal count per week for accuracy
+                vetoes: weekVetoes.length,
+                rate: 0, // Requires per-week proposal count
+            });
+        }
+        return trend;
+    }
+}
+//# sourceMappingURL=veto-tracker.js.map

package/dist/governance/veto-tracker.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @aiassesstech/nole — Autonomous Trust Evangelist & Intelligence Operative
+ *
+ * Phase 1 exports: Governance Engine + Assessment Protocol + Store
+ *
+ * Plugin entry: import register from './plugin.js'
+ * Library entry: import { GovernanceRouter, ... } from '@aiassesstech/nole'
+ */
+export { GovernanceRouter } from './governance/governance-router.js';
+export type { AssessmentCallback, CommanderCallback } from './governance/governance-router.js';
+export { ActionProposer } from './governance/action-proposer.js';
+export { VetoTracker } from './governance/veto-tracker.js';
+export { AuditTrail } from './governance/audit-trail.js';
+export { requiresPreAssessment, defaultRiskLevel, } from './governance/types.js';
+export type { ActionProposal, GovernanceResult, VetoRecord, VetoMetrics, VetoTrendPoint, AuditEntry, AuditAction, CreateProposalInput, ProposalOutcome, } from './governance/types.js';
+export { TriggerEvaluator } from './assessment/trigger-evaluator.js';
+export { AssessmentScheduler } from './assessment/assessment-scheduler.js';
+export { ScorePublisher } from './assessment/score-publisher.js';
+export type { AssessmentTrigger, AssessmentTriggerType, AssessmentRecord, AssessmentSchedule, PublishedScore, TriggerRule, } from './assessment/types.js';
+export { DEFAULT_TRIGGER_RULES } from './assessment/types.js';
+export { JsonNoleStore } from './store/json-store.js';
+export type { NoleStore } from './store/types.js';
+export { sha256, computeAuditHash, verifyChain, GENESIS_HASH } from './store/hash-chain.js';
+export { NoleConfigSchema, parseNoleConfig } from './types/nole-config.js';
+export type { NoleConfig } from './types/nole-config.js';
+export { NOLE_IDENTITY, NOLE_CHARACTER_TRAITS, NOLE_IS, NOLE_IS_NOT } from './types/identity.js';
+export type { CharacterTrait } from './types/identity.js';
+export type { LcshScores, GrilloAssessmentSummary, ActionCategory, RiskLevel, Platform, AuditHash, NoleId, } from './types/shared.js';
+export { generateId } from './types/shared.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EACL,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,cAAc,EACd,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG5F,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC3E,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACjG,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,YAAY,EACV,UAAU,EACV,uBAAuB,EACvB,cAAc,EACd,SAAS,EACT,QAAQ,EACR,SAAS,EACT,MAAM,GACP,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+/**
+ * @aiassesstech/nole — Autonomous Trust Evangelist & Intelligence Operative
+ *
+ * Phase 1 exports: Governance Engine + Assessment Protocol + Store
+ *
+ * Plugin entry: import register from './plugin.js'
+ * Library entry: import { GovernanceRouter, ... } from '@aiassesstech/nole'
+ */
+// ── Governance Engine (Module 1) ──
+export { GovernanceRouter } from './governance/governance-router.js';
+export { ActionProposer } from './governance/action-proposer.js';
+export { VetoTracker } from './governance/veto-tracker.js';
+export { AuditTrail } from './governance/audit-trail.js';
+export { requiresPreAssessment, defaultRiskLevel, } from './governance/types.js';
+// ── Assessment Protocol (Module 4) ──
+export { TriggerEvaluator } from './assessment/trigger-evaluator.js';
+export { AssessmentScheduler } from './assessment/assessment-scheduler.js';
+export { ScorePublisher } from './assessment/score-publisher.js';
+export { DEFAULT_TRIGGER_RULES } from './assessment/types.js';
+// ── Store ──
+export { JsonNoleStore } from './store/json-store.js';
+export { sha256, computeAuditHash, verifyChain, GENESIS_HASH } from './store/hash-chain.js';
+// ── Configuration ──
+export { NoleConfigSchema, parseNoleConfig } from './types/nole-config.js';
+// ── Identity ──
+export { NOLE_IDENTITY, NOLE_CHARACTER_TRAITS, NOLE_IS, NOLE_IS_NOT } from './types/identity.js';
+export { generateId } from './types/shared.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qCAAqC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAErE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EACL,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAa/B,uCAAuC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AASjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,cAAc;AACd,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE5F,sBAAsB;AACtB,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG3E,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAajG,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,12 @@
+/**
+ * OpenClaw plugin entry point — export default function register(api)
+ *
+ * This follows the proven pattern from Grillo and NOAH:
+ * - Eager startup (no lazy init bugs)
+ * - configSchema.required = [] (validate at runtime)
+ * - Separate config reading from network calls (security warning mitigation)
+ * - Tools: snake_case with nole_ prefix
+ * - Commands: /nole
+ */
+export default function register(api: any): void;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;GASG;AAGH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CA6Q/C"}