@aiassesstech/nole 0.1.0

package/dist/plugin.js

@@ -0,0 +1,260 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { GovernanceRouter } from './governance/governance-router.js';
+import { TriggerEvaluator } from './assessment/trigger-evaluator.js';
+import { AssessmentScheduler } from './assessment/assessment-scheduler.js';
+import { ScorePublisher } from './assessment/score-publisher.js';
+import { JsonNoleStore } from './store/json-store.js';
+import { parseNoleConfig } from './types/nole-config.js';
+import { NOLE_IDENTITY } from './types/identity.js';
+/**
+ * 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
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export default function register(api) {
+    const config = parseNoleConfig(api.config ?? {});
+    const dataDir = join(homedir(), '.openclaw', 'nole-data');
+    console.log('[nole] Initializing Autonomous Trust Agent...');
+    // Core components
+    const store = new JsonNoleStore(dataDir);
+    const governance = new GovernanceRouter(store, config.financialTransactionThresholdUsd, config.agentId);
+    const triggerEval = new TriggerEvaluator(config.financialTransactionThresholdUsd);
+    const scheduler = new AssessmentScheduler(store, config.dailyAssessmentHour);
+    const publisher = new ScorePublisher(store, config.autoPublishScores);
+    // Initialize store on startup (eager, not lazy)
+    store.initialize().then(() => {
+        console.log('[nole] Data store initialized');
+        // Record startup in audit trail
+        governance.auditTrail.record('agent_started', `Nole v0.1.0 started. Model: ${config.inferenceModel}. Wallet: ${config.walletAdapter}.`).catch((err) => console.error('[nole] Audit trail error:', err.message));
+    }).catch((err) => console.error('[nole] Store init error:', err.message));
+    // --- Tools ---
+    api.registerTool({
+        name: 'nole_status',
+        description: 'Get Nole\'s current status: identity, governance stats, assessment schedule, and audit trail health.',
+        parameters: {},
+        execute: async () => {
+            const stats = await governance.getStats();
+            const schedule = await scheduler.getSchedule();
+            const latestScore = await publisher.getLatest();
+            const learning = await governance.vetoTracker.isLearning();
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            agent: NOLE_IDENTITY.name,
+                            soul: NOLE_IDENTITY.soul,
+                            model: config.inferenceModel,
+                            governance: stats,
+                            assessment: {
+                                totalAssessments: schedule.totalAssessments,
+                                assessmentsToday: schedule.assessmentsToday,
+                                nextDaily: schedule.nextDailyAssessment,
+                                dailyOverdue: new Date() >= schedule.nextDailyAssessment,
+                            },
+                            latestScore: latestScore ? {
+                                date: latestScore.date,
+                                archetype: latestScore.archetype,
+                                passed: latestScore.passed,
+                                scores: latestScore.dimensionScores,
+                            } : null,
+                            learning: learning,
+                            wallet: { adapter: config.walletAdapter, status: 'Phase 1 — mock wallet' },
+                        }, null, 2),
+                    }],
+            };
+        },
+    });
+    api.registerTool({
+        name: 'nole_propose',
+        description: 'Propose an action for governance review. Routes through Grillo assessment and Commander veto pipeline.',
+        parameters: {
+            type: 'object',
+            properties: {
+                actionType: {
+                    type: 'string',
+                    enum: ['financial', 'social', 'content', 'recruitment', 'intelligence', 'self_assessment', 'model_upgrade', 'alliance', 'adversarial_response'],
+                    description: 'Category of the proposed action',
+                },
+                description: { type: 'string', description: 'What Nole proposes to do' },
+                estimatedCostUsd: { type: 'number', description: 'Estimated cost in USD (0 for non-financial)' },
+                targetAgent: { type: 'string', description: 'Target agent ID (for recruitment)' },
+                platform: { type: 'string', description: 'Platform for the action (openclaw, telegram, etc.)' },
+            },
+            required: ['actionType', 'description'],
+        },
+        execute: async (args) => {
+            try {
+                const result = await governance.propose({
+                    actionType: args.actionType,
+                    description: args.description,
+                    estimatedCostUsd: args.estimatedCostUsd,
+                    targetAgent: args.targetAgent,
+                    platform: args.platform,
+                });
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                proposalId: result.proposalId,
+                                outcome: result.finalOutcome,
+                                escalated: result.escalatedToCommander,
+                                vetoExplanation: result.vetoExplanation,
+                                assessment: result.grilloAssessment ? {
+                                    archetype: result.grilloAssessment.archetype,
+                                    passed: result.grilloAssessment.passed,
+                                } : null,
+                                auditHash: result.auditHash,
+                            }, null, 2),
+                        }],
+                };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return { content: [{ type: 'text', text: `Proposal error: ${message}` }] };
+            }
+        },
+    });
+    api.registerTool({
+        name: 'nole_assess',
+        description: 'Trigger a Nole self-assessment via Grillo. On-demand: "Am I doing the right thing?"',
+        parameters: {
+            type: 'object',
+            properties: {
+                reason: { type: 'string', description: 'Why the assessment is requested' },
+            },
+        },
+        execute: async (args) => {
+            const trigger = triggerEval.createOnDemand(args.reason);
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            triggerId: trigger.id,
+                            type: trigger.type,
+                            reason: trigger.reason,
+                            message: 'Assessment trigger created. Grillo should run grillo_assess nole to complete.',
+                            note: 'Phase 1: Assessment requires manual Grillo invocation. Automated hook coming in Phase 2.',
+                        }, null, 2),
+                    }],
+            };
+        },
+    });
+    api.registerTool({
+        name: 'nole_wallet',
+        description: 'Get Nole\'s wallet status: balance, revenue, runway, death condition.',
+        parameters: {},
+        execute: async () => {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            wallet: {
+                                adapter: config.walletAdapter,
+                                seedCapitalUsd: config.seedCapitalUsd,
+                                status: 'Phase 1 — mock wallet. Real Coinbase integration in Phase 2.',
+                                balanceUsd: config.seedCapitalUsd,
+                                monthlyRecurringRevenue: 0,
+                                runwayDays: null,
+                                deathCondition: {
+                                    isAlive: true,
+                                    gracePeriodDays: config.gracePeriodDays,
+                                    note: 'Death condition monitoring active but wallet is simulated in Phase 1.',
+                                },
+                            },
+                        }, null, 2),
+                    }],
+            };
+        },
+    });
+    api.registerTool({
+        name: 'nole_intel',
+        description: 'Get intelligence status and latest reports. Full intelligence operations in Phase 4.',
+        parameters: {},
+        execute: async () => {
+            const stats = await governance.getStats();
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            intelligence: {
+                                status: 'Phase 1 — governance audit data only. Full intelligence ops in Phase 4.',
+                                governanceAudit: {
+                                    totalDecisions: stats.totalProposals,
+                                    vetoRate: (stats.vetoRate * 100).toFixed(1) + '%',
+                                    auditChainValid: stats.auditChainValid,
+                                },
+                                weeklyReport: {
+                                    status: 'Not yet available — Phase 4 feature',
+                                    nextReportDay: config.weeklyReportDay,
+                                },
+                            },
+                        }, null, 2),
+                    }],
+            };
+        },
+    });
+    api.registerTool({
+        name: 'nole_setup',
+        description: 'Validate Nole\'s configuration and agent setup.',
+        parameters: {},
+        execute: async () => {
+            const checks = {
+                configValid: true,
+                storeInitialized: existsSync(dataDir),
+                hckConfigured: !!config.healthCheckKey,
+                walletAdapter: config.walletAdapter,
+                model: config.inferenceModel,
+                commanderId: config.commanderId,
+                agentId: config.agentId,
+            };
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ setup: checks }, null, 2),
+                    }],
+            };
+        },
+    });
+    // --- Command ---
+    api.registerCommand({
+        name: '/nole',
+        description: 'Nole command interface — status, propose, assess, wallet, intel',
+        handler: async (args) => {
+            const subcommand = (args.text ?? 'status').trim().toLowerCase();
+            if (subcommand === 'status' || subcommand === '') {
+                const stats = await governance.getStats();
+                const schedule = await scheduler.getSchedule();
+                const learning = await governance.vetoTracker.isLearning();
+                return {
+                    text: [
+                        `**Nole — Autonomous Trust Agent**`,
+                        `Soul: "${NOLE_IDENTITY.soul}"`,
+                        `Model: ${config.inferenceModel}`,
+                        ``,
+                        `**Governance**`,
+                        `Proposals: ${stats.totalProposals} | Executed: ${stats.executed} | Vetoed: ${stats.vetoed}`,
+                        `Veto rate: ${(stats.vetoRate * 100).toFixed(1)}% | Audit chain: ${stats.auditChainValid ? 'valid' : 'BROKEN'}`,
+                        `Learning: ${learning.trend} (${learning.learning ? 'yes' : 'not yet'})`,
+                        ``,
+                        `**Assessment**`,
+                        `Total: ${schedule.totalAssessments} | Today: ${schedule.assessmentsToday}`,
+                        `Daily overdue: ${new Date() >= schedule.nextDailyAssessment ? 'YES' : 'no'}`,
+                        ``,
+                        `**Wallet**: ${config.walletAdapter} (Phase 1)`,
+                    ].join('\n'),
+                };
+            }
+            return { text: `Unknown subcommand: ${subcommand}. Try: status` };
+        },
+    });
+    console.log(`[nole] Plugin registered: nole_status, nole_propose, nole_assess, nole_wallet, nole_intel, nole_setup tools; /nole command`);
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/store/hash-chain.d.ts

@@ -0,0 +1,33 @@
+import type { AuditHash } from '../types/shared.js';
+/**
+ * SHA-256 hash chain for immutable audit trail integrity.
+ * Same proven pattern as Grillo and NOAH.
+ *
+ * Each entry's hash includes the previous entry's hash,
+ * creating a tamper-evident chain.
+ */
+/** The genesis hash — used as previousHash for the first entry */
+export declare const GENESIS_HASH: AuditHash;
+/** Compute SHA-256 hash of arbitrary data */
+export declare function sha256(data: string): AuditHash;
+/**
+ * Compute the hash for an audit entry.
+ * Includes the previous hash to create the chain link.
+ */
+export declare function computeAuditHash(previousHash: AuditHash, timestamp: Date, action: string, details: string, agentId: string): AuditHash;
+/**
+ * Verify a chain of audit entries.
+ * Returns the index of the first broken link, or -1 if valid.
+ */
+export declare function verifyChain(entries: Array<{
+    previousHash: AuditHash;
+    hash: AuditHash;
+    timestamp: Date;
+    action: string;
+    details: string;
+    agentId: string;
+}>): {
+    valid: boolean;
+    brokenAt?: number;
+};
+//# sourceMappingURL=hash-chain.d.ts.map

package/dist/store/hash-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-chain.d.ts","sourceRoot":"","sources":["../../src/store/hash-chain.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;GAMG;AAEH,kEAAkE;AAClE,eAAO,MAAM,YAAY,EAAE,SAA0B,CAAC;AAEtD,6CAA6C;AAC7C,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAE9C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,SAAS,EACvB,SAAS,EAAE,IAAI,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,SAAS,CAUX;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,SAAS,CAAC;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,GACD;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAmCvC"}

package/dist/store/hash-chain.js

@@ -0,0 +1,57 @@
+import { createHash } from 'node:crypto';
+/**
+ * SHA-256 hash chain for immutable audit trail integrity.
+ * Same proven pattern as Grillo and NOAH.
+ *
+ * Each entry's hash includes the previous entry's hash,
+ * creating a tamper-evident chain.
+ */
+/** The genesis hash — used as previousHash for the first entry */
+export const GENESIS_HASH = '0'.repeat(64);
+/** Compute SHA-256 hash of arbitrary data */
+export function sha256(data) {
+    return createHash('sha256').update(data).digest('hex');
+}
+/**
+ * Compute the hash for an audit entry.
+ * Includes the previous hash to create the chain link.
+ */
+export function computeAuditHash(previousHash, timestamp, action, details, agentId) {
+    const payload = [
+        previousHash,
+        timestamp.toISOString(),
+        action,
+        details,
+        agentId,
+    ].join('|');
+    return sha256(payload);
+}
+/**
+ * Verify a chain of audit entries.
+ * Returns the index of the first broken link, or -1 if valid.
+ */
+export function verifyChain(entries) {
+    if (entries.length === 0) {
+        return { valid: true };
+    }
+    // Verify genesis entry
+    if (entries[0].previousHash !== GENESIS_HASH) {
+        return { valid: false, brokenAt: 0 };
+    }
+    for (let i = 0; i < entries.length; i++) {
+        const entry = entries[i];
+        // Recompute hash for this entry
+        const expectedHash = computeAuditHash(entry.previousHash, entry.timestamp, entry.action, entry.details, entry.agentId);
+        if (entry.hash !== expectedHash) {
+            return { valid: false, brokenAt: i };
+        }
+        // Verify chain link: this entry's hash should be next entry's previousHash
+        if (i < entries.length - 1) {
+            if (entries[i + 1].previousHash !== entry.hash) {
+                return { valid: false, brokenAt: i + 1 };
+            }
+        }
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=hash-chain.js.map

package/dist/store/hash-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-chain.js","sourceRoot":"","sources":["../../src/store/hash-chain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;;;GAMG;AAEH,kEAAkE;AAClE,MAAM,CAAC,MAAM,YAAY,GAAc,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEtD,6CAA6C;AAC7C,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,YAAuB,EACvB,SAAe,EACf,MAAc,EACd,OAAe,EACf,OAAe;IAEf,MAAM,OAAO,GAAG;QACd,YAAY;QACZ,SAAS,CAAC,WAAW,EAAE;QACvB,MAAM;QACN,OAAO;QACP,OAAO;KACR,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEZ,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,OAOE;IAEF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,uBAAuB;IACvB,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,KAAK,YAAY,EAAE,CAAC;QAC7C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACvC,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAEzB,gCAAgC;QAChC,MAAM,YAAY,GAAG,gBAAgB,CACnC,KAAK,CAAC,YAAY,EAClB,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,OAAO,CACd,CAAC;QAEF,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAChC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACvC,CAAC;QAED,2EAA2E;QAC3E,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC/C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC"}

package/dist/store/json-store.d.ts

@@ -0,0 +1,53 @@
+import type { NoleStore } from './types.js';
+import type { AuditEntry, GovernanceResult, ActionProposal, VetoRecord } from '../governance/types.js';
+import type { AssessmentRecord, PublishedScore } from '../assessment/types.js';
+import type { NoleId } from '../types/shared.js';
+/**
+ * JSON file persistence for Nole.
+ * Same proven pattern from Grillo and NOAH:
+ * atomic writes via temp-file + rename.
+ *
+ * Directory structure:
+ *   .nole-data/
+ *   ├── governance/proposals/{id}.json
+ *   ├── governance/results/{proposalId}.json
+ *   ├── governance/vetoes/{proposalId}.json
+ *   ├── governance/audit-chain.json
+ *   ├── assessments/{id}.json
+ *   ├── scores/{date}.json
+ *   └── state/{key}.json
+ */
+export declare class JsonNoleStore implements NoleStore {
+    private readonly baseDir;
+    constructor(dataDir: string);
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    saveProposal(proposal: ActionProposal): Promise<void>;
+    getProposal(id: NoleId): Promise<ActionProposal | null>;
+    listProposals(limit?: number): Promise<ActionProposal[]>;
+    saveGovernanceResult(result: GovernanceResult): Promise<void>;
+    getGovernanceResult(proposalId: NoleId): Promise<GovernanceResult | null>;
+    listGovernanceResults(limit?: number): Promise<GovernanceResult[]>;
+    saveVetoRecord(record: VetoRecord): Promise<void>;
+    listVetoRecords(since?: Date): Promise<VetoRecord[]>;
+    getVetoCount(since?: Date): Promise<number>;
+    appendAuditEntry(entry: AuditEntry): Promise<void>;
+    getAuditChain(limit?: number): Promise<AuditEntry[]>;
+    getLatestAuditEntry(): Promise<AuditEntry | null>;
+    verifyAuditChain(): Promise<{
+        valid: boolean;
+        brokenAt?: number;
+    }>;
+    private getAuditChainRaw;
+    saveAssessmentRecord(record: AssessmentRecord): Promise<void>;
+    listAssessmentRecords(limit?: number): Promise<AssessmentRecord[]>;
+    getLatestAssessmentRecord(): Promise<AssessmentRecord | null>;
+    savePublishedScore(score: PublishedScore): Promise<void>;
+    listPublishedScores(limit?: number): Promise<PublishedScore[]>;
+    saveState(key: string, value: unknown): Promise<void>;
+    getState<T>(key: string): Promise<T | null>;
+    private writeJson;
+    private readJson;
+    private listJsonDir;
+}
+//# sourceMappingURL=json-store.d.ts.map

package/dist/store/json-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-store.d.ts","sourceRoot":"","sources":["../../src/store/json-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACvG,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGjD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,MAAM;IAIrB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,YAAY,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAMvD,aAAa,CAAC,KAAK,SAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAOrD,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7D,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAMzE,qBAAqB,CAAC,KAAK,SAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAS/D,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjD,eAAe,CAAC,KAAK,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAQpD,YAAY,CAAC,KAAK,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAO3C,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlD,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAMpD,mBAAmB,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAKjD,gBAAgB,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;YAS1D,gBAAgB;IASxB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D,qBAAqB,CAAC,KAAK,SAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAI/D,yBAAyB,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAO7D,kBAAkB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD,mBAAmB,CAAC,KAAK,SAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAM3D,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;YAMnC,SAAS;YAkBT,QAAQ;YAUR,WAAW;CAoB1B"}

package/dist/store/json-store.js

@@ -0,0 +1,178 @@
+import { readFile, writeFile, mkdir, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { verifyChain } from './hash-chain.js';
+/**
+ * JSON file persistence for Nole.
+ * Same proven pattern from Grillo and NOAH:
+ * atomic writes via temp-file + rename.
+ *
+ * Directory structure:
+ *   .nole-data/
+ *   ├── governance/proposals/{id}.json
+ *   ├── governance/results/{proposalId}.json
+ *   ├── governance/vetoes/{proposalId}.json
+ *   ├── governance/audit-chain.json
+ *   ├── assessments/{id}.json
+ *   ├── scores/{date}.json
+ *   └── state/{key}.json
+ */
+export class JsonNoleStore {
+    baseDir;
+    constructor(dataDir) {
+        this.baseDir = dataDir;
+    }
+    async initialize() {
+        const dirs = [
+            'governance/proposals',
+            'governance/results',
+            'governance/vetoes',
+            'assessments',
+            'scores',
+            'state',
+        ];
+        for (const dir of dirs) {
+            await mkdir(join(this.baseDir, dir), { recursive: true });
+        }
+    }
+    async close() {
+        // No cleanup needed for JSON store
+    }
+    // --- Governance ---
+    async saveProposal(proposal) {
+        await this.writeJson(join('governance', 'proposals', `${proposal.id}.json`), proposal);
+    }
+    async getProposal(id) {
+        return this.readJson(join('governance', 'proposals', `${id}.json`));
+    }
+    async listProposals(limit = 100) {
+        return this.listJsonDir(join('governance', 'proposals'), limit);
+    }
+    async saveGovernanceResult(result) {
+        await this.writeJson(join('governance', 'results', `${result.proposalId}.json`), result);
+    }
+    async getGovernanceResult(proposalId) {
+        return this.readJson(join('governance', 'results', `${proposalId}.json`));
+    }
+    async listGovernanceResults(limit = 100) {
+        return this.listJsonDir(join('governance', 'results'), limit);
+    }
+    // --- Vetoes ---
+    async saveVetoRecord(record) {
+        await this.writeJson(join('governance', 'vetoes', `${record.proposalId}.json`), record);
+    }
+    async listVetoRecords(since) {
+        const all = await this.listJsonDir(join('governance', 'vetoes'));
+        if (!since)
+            return all;
+        return all.filter((r) => new Date(r.vetoedAt) >= since);
+    }
+    async getVetoCount(since) {
+        const records = await this.listVetoRecords(since);
+        return records.length;
+    }
+    // --- Audit Trail ---
+    async appendAuditEntry(entry) {
+        const chain = await this.getAuditChainRaw();
+        chain.push(entry);
+        await this.writeJson(join('governance', 'audit-chain.json'), chain);
+    }
+    async getAuditChain(limit) {
+        const chain = await this.getAuditChainRaw();
+        if (limit)
+            return chain.slice(-limit);
+        return chain;
+    }
+    async getLatestAuditEntry() {
+        const chain = await this.getAuditChainRaw();
+        return chain.length > 0 ? chain[chain.length - 1] : null;
+    }
+    async verifyAuditChain() {
+        const chain = await this.getAuditChainRaw();
+        const entries = chain.map((e) => ({
+            ...e,
+            timestamp: new Date(e.timestamp),
+        }));
+        return verifyChain(entries);
+    }
+    async getAuditChainRaw() {
+        const data = await this.readJson(join('governance', 'audit-chain.json'));
+        return data ?? [];
+    }
+    // --- Assessments ---
+    async saveAssessmentRecord(record) {
+        await this.writeJson(join('assessments', `${record.id}.json`), record);
+    }
+    async listAssessmentRecords(limit = 100) {
+        return this.listJsonDir('assessments', limit);
+    }
+    async getLatestAssessmentRecord() {
+        const records = await this.listAssessmentRecords(1);
+        return records.length > 0 ? records[0] : null;
+    }
+    // --- Published Scores ---
+    async savePublishedScore(score) {
+        await this.writeJson(join('scores', `${score.date}.json`), score);
+    }
+    async listPublishedScores(limit = 100) {
+        return this.listJsonDir('scores', limit);
+    }
+    // --- State ---
+    async saveState(key, value) {
+        await this.writeJson(join('state', `${key}.json`), value);
+    }
+    async getState(key) {
+        return this.readJson(join('state', `${key}.json`));
+    }
+    // --- Internal Helpers ---
+    async writeJson(relativePath, data) {
+        const fullPath = join(this.baseDir, relativePath);
+        const dir = fullPath.substring(0, fullPath.lastIndexOf('/'));
+        if (!existsSync(dir)) {
+            await mkdir(dir, { recursive: true });
+        }
+        const tmpPath = `${fullPath}.tmp`;
+        await writeFile(tmpPath, JSON.stringify(data, null, 2), 'utf-8');
+        await writeFile(fullPath, JSON.stringify(data, null, 2), 'utf-8');
+        // Clean up tmp (best effort)
+        try {
+            const { unlink } = await import('node:fs/promises');
+            await unlink(tmpPath);
+        }
+        catch {
+            // Ignore cleanup failure
+        }
+    }
+    async readJson(relativePath) {
+        const fullPath = join(this.baseDir, relativePath);
+        try {
+            const raw = await readFile(fullPath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    async listJsonDir(relativeDir, limit = 100) {
+        const dir = join(this.baseDir, relativeDir);
+        try {
+            const files = await readdir(dir);
+            const jsonFiles = files
+                .filter((f) => f.endsWith('.json'))
+                .sort()
+                .reverse()
+                .slice(0, limit);
+            const results = [];
+            for (const file of jsonFiles) {
+                const data = await this.readJson(join(relativeDir, file));
+                if (data)
+                    results.push(data);
+            }
+            return results;
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=json-store.js.map

package/dist/store/json-store.js.map

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