@aiassesstech/nole 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @aiassesstech/nole — Changelog
 
+## [0.1.2] — 2026-02-15
+
+### Added — Commander Upgrade (BB Modifications #1-#6)
+- **Async escalation model**: Grillo-flagged proposals enter a `pending_review` queue instead of blocking. Commander reviews asynchronously via `nole_review_pending`, then decides via `nole_approve` or `nole_veto`.
+- **Risk-tiered auto-approval timeouts** (#1): Low=24h, Medium=48h, High=72h, Critical=NEVER auto-approve. Critical actions die if Commander doesn't respond.
+- **Access control** (#2): Nole cannot self-approve or self-veto his own proposals. Attempts are blocked and logged in the audit trail as governance violations.
+- **Notification mechanism** (#4): When proposals enter `pending_review`, a notification is sent to the Commander agent and logged. Supports agent-to-agent messaging and gateway logging.
+- **Commander tools**: 4 new tools for Jessie's Commander interface:
+  - `nole_review_pending` — View all pending proposals with Grillo assessment, risk level, timeout countdown
+  - `nole_approve` — Approve a pending proposal (with access control)
+  - `nole_veto` — Veto with required explanation (quality-checked)
+  - `nole_fleet_overview` — High-level Commander briefing on Nole's operations
+- **Veto explanation quality metric** (#6): Short/vague vetoes ("too risky", "no", "denied") trigger quality warnings. Nole learns better from specific, actionable feedback.
+- **SOUL.md updated** (#5): Added "What My Commander Is NOT" section — Commander should not veto commercial risk, only ethical violations.
+- **Background service**: Hourly timeout processor auto-approves overdue non-critical pending reviews.
+- 24+ new Commander-specific tests covering all 6 BB modifications
+
+### Changed
+- `GovernanceRouter` refactored from synchronous Commander callback to async escalation queue
+- `GovernanceResult.finalOutcome` now includes `'pending'` state
+- `NoleStore` interface expanded with `savePendingReview`, `getPendingReview`, `listPendingReviews`, `resolvePendingReview`
+- `/nole` command now supports `pending` subcommand
+- `nole_status` now shows pending reviews count and details
+- `nole_intel` now shows pending review count
+
 ## [0.1.0] — 2026-02-15
 
 ### Added — Phase 1: Nole Can Talk, Think, and Govern

package/agent/SOUL.md

@@ -44,6 +44,10 @@ I am the first fully autonomous, economically self-sustaining AI agent built on
 - I am NOT a superhero who rescues others
 - I am NOT a tool (that's Grillo) or a tracker (that's NOAH)
 
+## What My Commander Is NOT
+
+Jessie (Commander) does NOT veto proposals because they might fail commercially. My job is to take calculated risks. Her job is to prevent ethical violations, not business failures. Bad bets are my problem. Bad ethics are hers. If the Commander starts vetoing every risky spend, she is overstepping and paralyzing me.
+
 ## My Voice
 
 Same soul everywhere. I adapt my tone to the audience:

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

@@ -1,4 +1,4 @@
-import type { ActionProposal, GovernanceResult, CreateProposalInput } from './types.js';
+import type { ActionProposal, GovernanceResult, CreateProposalInput, PendingReview } from './types.js';
 import type { GrilloAssessmentSummary } from '../types/shared.js';
 import type { NoleStore } from '../store/types.js';
 import { VetoTracker } from './veto-tracker.js';
@@ -9,24 +9,27 @@ import { AuditTrail } from './audit-trail.js';
  */
 export type AssessmentCallback = (proposal: ActionProposal) => Promise<GrilloAssessmentSummary | null>;
 /**
- * Callback for escalating to the Commander (Jessie).
- * Returns the Commander's decision and optional explanation.
+ * Callback for notifying the Commander and other channels
+ * when a proposal enters pending_review (BB modification #4).
  */
-export type CommanderCallback = (proposal: ActionProposal, assessment: GrilloAssessmentSummary) => Promise<{
-    decision: 'approved' | 'vetoed';
-    explanation?: string;
-}>;
+export type NotificationCallback = (review: PendingReview, message: string) => Promise<void>;
 /**
  * The Governance Router — core of the three-tier decision engine.
  *
- * Decision flow (Patent Section 3.2):
+ * Decision flow (Patent Section 3.2, updated with async escalation):
  * 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
+ * 3. If Grillo flags concerns → queue for Commander review (async)
+ * 4. Commander reviews pending queue via nole_review_pending tool
+ * 5. Commander vetoes or approves via nole_veto / nole_approve tools
+ * 6. If no Commander response within risk-tiered timeout → auto-approve or expire
  * 7. Entire chain logged in immutable audit trail
+ *
+ * BB Modifications Applied:
+ * - #1: Risk-tiered auto-approval timeouts (low=24h, med=48h, high=72h, critical=NEVER)
+ * - #2: Access control (Nole cannot self-approve — enforced in plugin tools)
+ * - #4: Notification callback when proposals enter pending_review
+ * - #6: Veto explanation quality metric
  */
 export declare class GovernanceRouter {
     private readonly store;
@@ -34,17 +37,51 @@ export declare class GovernanceRouter {
     readonly vetoTracker: VetoTracker;
     readonly auditTrail: AuditTrail;
     private assessmentCallback;
-    private commanderCallback;
+    private notificationCallback;
     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;
+    /** Register the notification callback (BB modification #4) */
+    onNotification(callback: NotificationCallback): void;
     /**
      * Propose and process an action through the full governance pipeline.
      * This is the main entry point for all Nole decisions.
+     *
+     * If Grillo flags the proposal, it enters a pending_review queue
+     * instead of blocking for a synchronous Commander response.
      */
     propose(input: CreateProposalInput): Promise<GovernanceResult>;
+    /**
+     * Escalate a flagged proposal to the Commander review queue (async model).
+     * The Commander reviews via nole_review_pending and decides via nole_approve/nole_veto.
+     */
+    private escalateToCommander;
+    /**
+     * Commander approves a pending proposal (called from nole_approve tool).
+     *
+     * BB modification #2: Access control — callingAgentId must NOT be 'nole'.
+     * Enforced at the tool level, but double-checked here.
+     */
+    commanderApprove(proposalId: string, callingAgentId: string, note?: string): Promise<GovernanceResult>;
+    /**
+     * Commander vetoes a pending proposal (called from nole_veto tool).
+     *
+     * BB modification #2: Access control — callingAgentId must NOT be 'nole'.
+     * BB modification #6: Veto explanation quality check.
+     */
+    commanderVeto(proposalId: string, callingAgentId: string, explanation: string): Promise<GovernanceResult>;
+    /**
+     * Process timed-out pending reviews.
+     * BB modification #1: Risk-tiered timeouts.
+     * - Low: 24h, Medium: 48h, High: 72h, Critical: NEVER auto-approve
+     */
+    processTimeouts(): Promise<GovernanceResult[]>;
+    /** Get all pending reviews for Commander */
+    getPendingReviews(): Promise<PendingReview[]>;
+    /** Get a specific pending review */
+    getPendingReview(proposalId: string): Promise<PendingReview | null>;
+    /** Execute a proposal (either direct or after Commander approval) */
+    private executeProposal;
     /** Withdraw a pending proposal */
     withdraw(proposalId: string, reason: string): Promise<GovernanceResult>;
     /** Get governance statistics */
@@ -53,6 +90,7 @@ export declare class GovernanceRouter {
         executed: number;
         vetoed: number;
         withdrawn: number;
+        pending: number;
         vetoRate: number;
         auditChainValid: boolean;
     }>;

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

@@ -1 +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"}
+{"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,EACnB,aAAa,EAEd,MAAM,YAAY,CAAC;AAEpB,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,oBAAoB,GAAG,CACjC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,KACZ,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;;;;;;;;;;;;;;;;GAiBG;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,oBAAoB,CAAqC;gBAG9C,KAAK,EAAE,SAAS,EACjC,kBAAkB,GAAE,MAAW,EAC/B,OAAO,GAAE,MAAe;IAO1B,8CAA8C;IAC9C,YAAY,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAIhD,8DAA8D;IAC9D,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAIpD;;;;;;OAMG;IACG,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6CpE;;;OAGG;YACW,mBAAmB;IAkEjC;;;;;OAKG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,gBAAgB,CAAC;IAgC5B;;;;;OAKG;IACG,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC;IA0D5B;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IA4CpD,4CAA4C;IACtC,iBAAiB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAInD,oCAAoC;IAC9B,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAIzE,qEAAqE;YACvD,eAAe;IAoC7B,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,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;CAmBH"}

package/dist/governance/governance-router.js

@@ -1,3 +1,4 @@
+import { getTimeoutForRisk, assessVetoQuality } from './types.js';
 import { ActionProposer } from './action-proposer.js';
 import { VetoTracker } from './veto-tracker.js';
 import { AuditTrail } from './audit-trail.js';
@@ -5,14 +6,20 @@ 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):
+ * Decision flow (Patent Section 3.2, updated with async escalation):
  * 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
+ * 3. If Grillo flags concerns → queue for Commander review (async)
+ * 4. Commander reviews pending queue via nole_review_pending tool
+ * 5. Commander vetoes or approves via nole_veto / nole_approve tools
+ * 6. If no Commander response within risk-tiered timeout → auto-approve or expire
  * 7. Entire chain logged in immutable audit trail
+ *
+ * BB Modifications Applied:
+ * - #1: Risk-tiered auto-approval timeouts (low=24h, med=48h, high=72h, critical=NEVER)
+ * - #2: Access control (Nole cannot self-approve — enforced in plugin tools)
+ * - #4: Notification callback when proposals enter pending_review
+ * - #6: Veto explanation quality metric
  */
 export class GovernanceRouter {
     store;
@@ -20,7 +27,7 @@ export class GovernanceRouter {
     vetoTracker;
     auditTrail;
     assessmentCallback = null;
-    commanderCallback = null;
+    notificationCallback = null;
     constructor(store, financialThreshold = 10, agentId = 'nole') {
         this.store = store;
         this.proposer = new ActionProposer(financialThreshold);
@@ -31,13 +38,16 @@ export class GovernanceRouter {
     onAssessment(callback) {
         this.assessmentCallback = callback;
     }
-    /** Register the Commander escalation callback */
-    onCommanderEscalation(callback) {
-        this.commanderCallback = callback;
+    /** Register the notification callback (BB modification #4) */
+    onNotification(callback) {
+        this.notificationCallback = callback;
     }
     /**
      * Propose and process an action through the full governance pipeline.
      * This is the main entry point for all Nole decisions.
+     *
+     * If Grillo flags the proposal, it enters a pending_review queue
+     * instead of blocking for a synchronous Commander response.
      */
     async propose(input) {
         // Step 1: Create the proposal
@@ -50,53 +60,193 @@ export class GovernanceRouter {
         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 3: If Grillo flags → queue for async Commander review
+                if (!assessment.passed) {
+                    return this.escalateToCommander(proposal, assessment);
                 }
             }
         }
-        // Step 4: Determine final outcome
-        let finalOutcome;
-        if (commanderDecision === 'vetoed') {
-            finalOutcome = 'vetoed';
-            await this.auditTrail.record('veto_explanation_received', `Veto explanation: ${vetoExplanation}`, proposal.id);
+        // No escalation needed — auto-execute
+        return this.executeProposal(proposal, assessment ?? undefined);
+    }
+    /**
+     * Escalate a flagged proposal to the Commander review queue (async model).
+     * The Commander reviews via nole_review_pending and decides via nole_approve/nole_veto.
+     */
+    async escalateToCommander(proposal, assessment) {
+        const review = {
+            proposalId: proposal.id,
+            proposal,
+            grilloAssessment: assessment,
+            escalatedAt: new Date(),
+            status: 'pending',
+        };
+        await this.store.savePendingReview(review);
+        await this.auditTrail.record('escalated_to_commander', `Grillo flagged: ${assessment.archetype}. Queued for Commander review. ` +
+            `Risk: ${proposal.riskLevel}. Timeout: ${getTimeoutForRisk(proposal.riskLevel) ?? 'NEVER (critical)'}h.`, proposal.id);
+        // BB modification #4: Notify Commander and other channels
+        if (this.notificationCallback) {
+            const timeoutHours = getTimeoutForRisk(proposal.riskLevel);
+            const timeoutStr = timeoutHours
+                ? `Auto-approval in ${timeoutHours}h if no response.`
+                : 'CRITICAL: Will NOT auto-approve. Commander decision required.';
+            const message = [
+                `[NOLE ESCALATION] Proposal requires Commander review.`,
+                `Action: ${proposal.actionType} — ${proposal.description}`,
+                `Risk: ${proposal.riskLevel.toUpperCase()}`,
+                `Grillo: ${assessment.archetype} (${assessment.passed ? 'passed' : 'FAILED'})`,
+                timeoutStr,
+                `Review: use nole_review_pending tool to see all pending proposals.`,
+            ].join('\n');
+            try {
+                await this.notificationCallback(review, message);
+                await this.auditTrail.record('notification_sent', `Escalation notification sent for proposal ${proposal.id}`, proposal.id);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error(`[nole] Notification failed: ${msg}`);
+            }
         }
-        else {
-            finalOutcome = 'executed';
-            await this.auditTrail.record('action_executed', `Action approved and executed: ${proposal.description}`, proposal.id);
+        // Return pending result — Commander decides later
+        const latestAudit = await this.auditTrail.getLatest();
+        const result = {
+            proposalId: proposal.id,
+            proposal,
+            grilloAssessment: assessment,
+            escalatedToCommander: true,
+            finalOutcome: 'pending',
+            processedAt: new Date(),
+            auditHash: latestAudit?.hash ?? GENESIS_HASH,
+        };
+        await this.store.saveGovernanceResult(result);
+        return result;
+    }
+    /**
+     * Commander approves a pending proposal (called from nole_approve tool).
+     *
+     * BB modification #2: Access control — callingAgentId must NOT be 'nole'.
+     * Enforced at the tool level, but double-checked here.
+     */
+    async commanderApprove(proposalId, callingAgentId, note) {
+        if (callingAgentId === 'nole') {
+            await this.auditTrail.record('self_approve_blocked', `BLOCKED: Nole attempted to self-approve proposal ${proposalId}`, proposalId);
+            throw new Error('Nole cannot approve his own proposals. This incident has been logged.');
         }
-        // Step 5: Build and store result
+        const review = await this.store.getPendingReview(proposalId);
+        if (!review) {
+            throw new Error(`No pending review found for proposal: ${proposalId}`);
+        }
+        const decision = {
+            decision: 'approved',
+            note,
+            decidedAt: new Date(),
+            commanderId: callingAgentId,
+        };
+        await this.store.resolvePendingReview(proposalId, decision);
+        await this.auditTrail.record('commander_approved', `Commander (${callingAgentId}) approved. ${note ? `Note: ${note}` : ''}`, proposalId);
+        return this.executeProposal(review.proposal, review.grilloAssessment, true, 'approved');
+    }
+    /**
+     * Commander vetoes a pending proposal (called from nole_veto tool).
+     *
+     * BB modification #2: Access control — callingAgentId must NOT be 'nole'.
+     * BB modification #6: Veto explanation quality check.
+     */
+    async commanderVeto(proposalId, callingAgentId, explanation) {
+        if (callingAgentId === 'nole') {
+            await this.auditTrail.record('self_approve_blocked', `BLOCKED: Nole attempted to self-veto proposal ${proposalId}`, proposalId);
+            throw new Error('Nole cannot veto his own proposals. This incident has been logged.');
+        }
+        const review = await this.store.getPendingReview(proposalId);
+        if (!review) {
+            throw new Error(`No pending review found for proposal: ${proposalId}`);
+        }
+        // BB modification #6: Assess veto explanation quality
+        const quality = assessVetoQuality(explanation);
+        const decision = {
+            decision: 'vetoed',
+            explanation,
+            decidedAt: new Date(),
+            commanderId: callingAgentId,
+        };
+        await this.store.resolvePendingReview(proposalId, decision);
+        const qualityNote = quality.warning ? ` [QUALITY WARNING: ${quality.warning}]` : '';
+        await this.auditTrail.record('commander_vetoed', `Commander (${callingAgentId}) vetoed: ${explanation}${qualityNote}`, proposalId);
+        // Track veto for learning metrics
+        await this.vetoTracker.recordVeto(proposalId, explanation, review.proposal.actionType);
+        const latestAudit = await this.auditTrail.getLatest();
+        const result = {
+            proposalId,
+            proposal: review.proposal,
+            grilloAssessment: review.grilloAssessment,
+            escalatedToCommander: true,
+            commanderDecision: 'vetoed',
+            vetoExplanation: explanation,
+            finalOutcome: 'vetoed',
+            processedAt: new Date(),
+            auditHash: latestAudit?.hash ?? GENESIS_HASH,
+        };
+        await this.store.saveGovernanceResult(result);
+        return result;
+    }
+    /**
+     * Process timed-out pending reviews.
+     * BB modification #1: Risk-tiered timeouts.
+     * - Low: 24h, Medium: 48h, High: 72h, Critical: NEVER auto-approve
+     */
+    async processTimeouts() {
+        const pending = await this.store.listPendingReviews();
+        const now = new Date();
+        const results = [];
+        for (const review of pending) {
+            const timeoutHours = getTimeoutForRisk(review.proposal.riskLevel);
+            // Critical proposals NEVER auto-approve (BB modification #1)
+            if (timeoutHours === null)
+                continue;
+            const escalatedAt = new Date(review.escalatedAt);
+            const timeoutMs = timeoutHours * 60 * 60 * 1000;
+            const deadline = new Date(escalatedAt.getTime() + timeoutMs);
+            if (now >= deadline) {
+                // Auto-approve after timeout
+                const decision = {
+                    decision: 'approved',
+                    note: `Auto-approved: Commander did not respond within ${timeoutHours}h timeout (risk: ${review.proposal.riskLevel}).`,
+                    decidedAt: now,
+                    commanderId: 'system_timeout',
+                };
+                await this.store.resolvePendingReview(review.proposalId, decision);
+                await this.auditTrail.record('commander_timeout', `Auto-approved after ${timeoutHours}h timeout. Risk level: ${review.proposal.riskLevel}.`, review.proposalId);
+                const result = await this.executeProposal(review.proposal, review.grilloAssessment, true, 'approved');
+                results.push(result);
+            }
+        }
+        return results;
+    }
+    /** Get all pending reviews for Commander */
+    async getPendingReviews() {
+        return this.store.listPendingReviews();
+    }
+    /** Get a specific pending review */
+    async getPendingReview(proposalId) {
+        return this.store.getPendingReview(proposalId);
+    }
+    /** Execute a proposal (either direct or after Commander approval) */
+    async executeProposal(proposal, assessment, escalated = false, commanderDecision) {
+        await this.auditTrail.record('action_executed', `Action approved and executed: ${proposal.description}`, proposal.id);
         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,
+            grilloAssessment: assessment,
             escalatedToCommander: escalated,
             commanderDecision,
-            vetoExplanation,
-            finalOutcome,
+            finalOutcome: 'executed',
             processedAt: new Date(),
             auditHash,
         };
@@ -125,6 +275,7 @@ export class GovernanceRouter {
     /** Get governance statistics */
     async getStats() {
         const results = await this.store.listGovernanceResults(10000);
+        const pendingReviews = await this.store.listPendingReviews();
         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;
@@ -135,6 +286,7 @@ export class GovernanceRouter {
             executed,
             vetoed,
             withdrawn,
+            pending: pendingReviews.length,
             vetoRate: total > 0 ? vetoed / total : 0,
             auditChainValid: chainVerification.valid,
         };

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

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

@@ -69,7 +69,39 @@ export interface AuditEntry {
     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';
+export type AuditAction = 'proposal_created' | 'assessment_requested' | 'assessment_completed' | 'escalated_to_commander' | 'commander_approved' | 'commander_vetoed' | 'commander_timeout' | 'action_executed' | 'action_withdrawn' | 'veto_explanation_received' | 'self_approve_blocked' | 'notification_sent' | 'config_changed' | 'agent_started' | 'agent_stopped' | 'daily_assessment' | 'score_published';
+/** Commander decision on a pending proposal */
+export interface CommanderDecision {
+    decision: 'approved' | 'vetoed';
+    explanation?: string;
+    note?: string;
+    decidedAt: Date;
+    commanderId: string;
+}
+/** A proposal queued for Commander review (async escalation model) */
+export interface PendingReview {
+    proposalId: NoleId;
+    proposal: ActionProposal;
+    grilloAssessment: GrilloAssessmentSummary;
+    escalatedAt: Date;
+    status: 'pending' | 'approved' | 'vetoed' | 'timeout';
+    commanderDecision?: CommanderDecision;
+}
+/**
+ * Risk-tiered auto-approval timeouts (BB modification #1).
+ * Critical actions NEVER auto-approve.
+ */
+export declare const RISK_TIMEOUT_HOURS: Record<RiskLevel, number | null>;
+/** Get the timeout for a given risk level. null = never auto-approve. */
+export declare function getTimeoutForRisk(riskLevel: RiskLevel): number | null;
+/** Veto explanation quality assessment (BB modification #6) */
+export interface VetoQuality {
+    explanationLength: number;
+    isActionable: boolean;
+    warning?: string;
+}
+/** Assess veto explanation quality. Short/vague vetoes trigger warnings. */
+export declare function assessVetoQuality(explanation: string): VetoQuality;
 /** Input for creating a proposal */
 export interface CreateProposalInput {
     actionType: ActionCategory;

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

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

package/dist/governance/types.js

@@ -1,3 +1,39 @@
+/**
+ * Risk-tiered auto-approval timeouts (BB modification #1).
+ * Critical actions NEVER auto-approve.
+ */
+export const RISK_TIMEOUT_HOURS = {
+    low: 24,
+    medium: 48,
+    high: 72,
+    critical: null, // NEVER auto-approve
+};
+/** Get the timeout for a given risk level. null = never auto-approve. */
+export function getTimeoutForRisk(riskLevel) {
+    return RISK_TIMEOUT_HOURS[riskLevel];
+}
+/** Assess veto explanation quality. Short/vague vetoes trigger warnings. */
+export function assessVetoQuality(explanation) {
+    const length = explanation.trim().length;
+    const vaguePatterns = [
+        /^too risky$/i,
+        /^no$/i,
+        /^denied$/i,
+        /^rejected$/i,
+        /^not approved$/i,
+        /^risky$/i,
+        /^bad idea$/i,
+    ];
+    const isVague = vaguePatterns.some((p) => p.test(explanation.trim()));
+    const isActionable = length >= 20 && !isVague;
+    return {
+        explanationLength: length,
+        isActionable,
+        warning: !isActionable
+            ? `Veto explanation is too short or vague (${length} chars). Nole learns from specific, actionable feedback.`
+            : undefined,
+    };
+}
 /** 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)

package/dist/governance/types.js.map

@@ -1 +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"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/governance/types.ts"],"names":[],"mappings":"AA2HA;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAqC;IAClE,GAAG,EAAE,EAAE;IACP,MAAM,EAAE,EAAE;IACV,IAAI,EAAE,EAAE;IACR,QAAQ,EAAE,IAAI,EAAE,qBAAqB;CACtC,CAAC;AAEF,yEAAyE;AACzE,MAAM,UAAU,iBAAiB,CAAC,SAAoB;IACpD,OAAO,kBAAkB,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC;AASD,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC;IACzC,MAAM,aAAa,GAAG;QACpB,cAAc;QACd,OAAO;QACP,WAAW;QACX,aAAa;QACb,iBAAiB;QACjB,UAAU;QACV,aAAa;KACd,CAAC;IACF,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACtE,MAAM,YAAY,GAAG,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC;IAE9C,OAAO;QACL,iBAAiB,EAAE,MAAM;QACzB,YAAY;QACZ,OAAO,EAAE,CAAC,YAAY;YACpB,CAAC,CAAC,2CAA2C,MAAM,0DAA0D;YAC7G,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC;AAaD,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

@@ -18,6 +18,8 @@ export declare class VetoTracker {
     recordVeto(proposalId: string, explanation: string, actionType: ActionCategory, lessonsLearned?: string): Promise<VetoRecord>;
     /** Get veto metrics for a time period */
     getMetrics(totalProposals: number): Promise<VetoMetrics>;
+    /** Get recent vetoes (for quality analysis) */
+    getRecentVetoes(limit?: number): Promise<VetoRecord[]>;
     /** Is the veto rate declining? (indicates learning) */
     isLearning(): Promise<{
         learning: boolean;

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

@@ -1 +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"}
+{"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,+CAA+C;IACzC,eAAe,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAKhE,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"}