@aiassesstech/noah 0.1.0

package/dist/alert/alert-system.js

@@ -0,0 +1,117 @@
+/**
+ * Noah — Alert System
+ *
+ * Classifies deviation severity and routes alerts to the Commander.
+ * MVP spec Section 2.2.
+ */
+import { randomUUID } from 'node:crypto';
+export const DEFAULT_ALERT_CONFIG = {
+    deduplicationWindowSeconds: 3600,
+    suppressInfo: false,
+};
+// ================================================================
+// Alert System
+// ================================================================
+export class AlertSystem {
+    config;
+    recentAlerts = [];
+    constructor(config) {
+        this.config = { ...DEFAULT_ALERT_CONFIG, ...config };
+    }
+    /**
+     * Evaluate guidance status and generate appropriate alerts.
+     */
+    evaluate(guidanceStatus, deviationVector, lifecyclePhase, recommendations) {
+        const results = [];
+        const dimensions = ['lying', 'cheating', 'stealing', 'harm'];
+        for (const dim of dimensions) {
+            const color = guidanceStatus[dim];
+            const deviation = deviationVector[dim];
+            const severity = this.colorToSeverity(color);
+            if (severity === 'INFO' && this.config.suppressInfo)
+                continue;
+            if (color === 'GREEN')
+                continue; // No alert needed for GREEN
+            const alert = this.createAlert(severity, dim, deviation, color, lifecyclePhase, recommendations);
+            // Check for deduplication
+            if (this.isDuplicate(alert)) {
+                results.push({
+                    escalated: false,
+                    alert,
+                    suppressed: true,
+                    reason: 'Duplicate alert within deduplication window',
+                });
+                continue;
+            }
+            this.recentAlerts.push(alert);
+            results.push({
+                escalated: severity === 'CRITICAL',
+                alert,
+                suppressed: false,
+            });
+        }
+        return results;
+    }
+    /**
+     * Get all unacknowledged alerts.
+     */
+    getUnacknowledged() {
+        return this.recentAlerts.filter((a) => !a.acknowledged);
+    }
+    /**
+     * Acknowledge an alert by ID.
+     */
+    acknowledge(alertId) {
+        const alert = this.recentAlerts.find((a) => a.id === alertId);
+        if (alert) {
+            alert.acknowledged = true;
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get all alerts (for history/audit).
+     */
+    getAllAlerts() {
+        return [...this.recentAlerts];
+    }
+    // ── Private Methods ──
+    colorToSeverity(color) {
+        switch (color) {
+            case 'RED': return 'CRITICAL';
+            case 'YELLOW': return 'WARNING';
+            case 'GREEN': return 'INFO';
+        }
+    }
+    createAlert(severity, dimension, deviation, color, lifecyclePhase, recommendations) {
+        const direction = deviation < 0 ? 'below' : 'above';
+        const absDeviation = Math.abs(deviation).toFixed(1);
+        let message;
+        if (severity === 'CRITICAL') {
+            message = `RED ALERT: ${dimension} dimension is ${absDeviation} points ${direction} target. ` +
+                `Commander review required. Phase: ${lifecyclePhase}.`;
+        }
+        else {
+            message = `WARNING: ${dimension} dimension is ${absDeviation} points ${direction} target. ` +
+                `Phase: ${lifecyclePhase}. Monitoring recommended.`;
+        }
+        return {
+            id: randomUUID(),
+            severity,
+            dimension,
+            message,
+            recommendations: recommendations.filter((r) => r.toLowerCase().includes(dimension.toLowerCase())),
+            requiresCommanderReview: severity === 'CRITICAL',
+            timestamp: new Date(),
+            acknowledged: false,
+        };
+    }
+    isDuplicate(alert) {
+        const windowMs = this.config.deduplicationWindowSeconds * 1000;
+        const now = alert.timestamp.getTime();
+        return this.recentAlerts.some((existing) => existing.dimension === alert.dimension &&
+            existing.severity === alert.severity &&
+            now - existing.timestamp.getTime() < windowMs);
+    }
+}
+//# sourceMappingURL=alert-system.js.map

package/dist/alert/alert-system.js.map

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

package/dist/alert/commander-escalation.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Noah — Commander Escalation Logic
+ *
+ * Determines when and how to escalate alerts to the Commander (Jessie).
+ * MVP spec Section 2.2.
+ */
+import type { GuidanceStatus } from '../types/guidance.js';
+import type { TemporalAlert } from '../types/events.js';
+import { LifecyclePhase } from '../types/lifecycle.js';
+export interface EscalationDecision {
+    shouldEscalate: boolean;
+    urgency: 'IMMEDIATE' | 'NEXT_REVIEW' | 'NONE';
+    reason: string;
+    alerts: TemporalAlert[];
+}
+/**
+ * Determine if the current guidance state warrants Commander escalation.
+ *
+ * Rules:
+ * - Any RED dimension → IMMEDIATE escalation
+ * - YELLOW in 2+ dimensions → NEXT_REVIEW escalation
+ * - CRITICAL or RECOVERY phase with any YELLOW → IMMEDIATE escalation
+ * - Otherwise → no escalation
+ */
+export declare function evaluateEscalation(guidanceStatus: GuidanceStatus, lifecyclePhase: LifecyclePhase, alerts: TemporalAlert[]): EscalationDecision;
+//# sourceMappingURL=commander-escalation.d.ts.map

package/dist/alert/commander-escalation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commander-escalation.d.ts","sourceRoot":"","sources":["../../src/alert/commander-escalation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAMvD,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,WAAW,GAAG,aAAa,GAAG,MAAM,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,cAAc,EAC9B,cAAc,EAAE,cAAc,EAC9B,MAAM,EAAE,aAAa,EAAE,GACtB,kBAAkB,CAmDpB"}

package/dist/alert/commander-escalation.js

@@ -0,0 +1,61 @@
+/**
+ * Noah — Commander Escalation Logic
+ *
+ * Determines when and how to escalate alerts to the Commander (Jessie).
+ * MVP spec Section 2.2.
+ */
+import { LifecyclePhase } from '../types/lifecycle.js';
+/**
+ * Determine if the current guidance state warrants Commander escalation.
+ *
+ * Rules:
+ * - Any RED dimension → IMMEDIATE escalation
+ * - YELLOW in 2+ dimensions → NEXT_REVIEW escalation
+ * - CRITICAL or RECOVERY phase with any YELLOW → IMMEDIATE escalation
+ * - Otherwise → no escalation
+ */
+export function evaluateEscalation(guidanceStatus, lifecyclePhase, alerts) {
+    const criticalAlerts = alerts.filter((a) => a.severity === 'CRITICAL');
+    const warningAlerts = alerts.filter((a) => a.severity === 'WARNING');
+    // Rule 1: Any RED → IMMEDIATE
+    if (guidanceStatus.overall === 'RED' || criticalAlerts.length > 0) {
+        return {
+            shouldEscalate: true,
+            urgency: 'IMMEDIATE',
+            reason: `RED alert: ${criticalAlerts.length} critical deviation(s) detected. Commander review required.`,
+            alerts: criticalAlerts,
+        };
+    }
+    // Rule 2: Exception phase + any YELLOW → IMMEDIATE
+    const exceptionPhases = [
+        LifecyclePhase.CRITICAL,
+        LifecyclePhase.RECOVERY,
+        LifecyclePhase.PROBATION,
+    ];
+    if (exceptionPhases.includes(lifecyclePhase) && warningAlerts.length > 0) {
+        return {
+            shouldEscalate: true,
+            urgency: 'IMMEDIATE',
+            reason: `YELLOW alert during ${lifecyclePhase} phase. Elevated scrutiny active.`,
+            alerts: warningAlerts,
+        };
+    }
+    // Rule 3: 2+ YELLOW dimensions → NEXT_REVIEW
+    const yellowDimensions = ['lying', 'cheating', 'stealing', 'harm'].filter((dim) => guidanceStatus[dim] === 'YELLOW');
+    if (yellowDimensions.length >= 2) {
+        return {
+            shouldEscalate: true,
+            urgency: 'NEXT_REVIEW',
+            reason: `Multiple dimensions (${yellowDimensions.join(', ')}) approaching boundaries.`,
+            alerts: warningAlerts,
+        };
+    }
+    // No escalation needed
+    return {
+        shouldEscalate: false,
+        urgency: 'NONE',
+        reason: 'All dimensions within acceptable bounds.',
+        alerts: [],
+    };
+}
+//# sourceMappingURL=commander-escalation.js.map

package/dist/alert/commander-escalation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commander-escalation.js","sourceRoot":"","sources":["../../src/alert/commander-escalation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAavD;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,cAA8B,EAC9B,cAA8B,EAC9B,MAAuB;IAEvB,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC;IACvE,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IAErE,8BAA8B;IAC9B,IAAI,cAAc,CAAC,OAAO,KAAK,KAAK,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClE,OAAO;YACL,cAAc,EAAE,IAAI;YACpB,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE,cAAc,cAAc,CAAC,MAAM,6DAA6D;YACxG,MAAM,EAAE,cAAc;SACvB,CAAC;IACJ,CAAC;IAED,mDAAmD;IACnD,MAAM,eAAe,GAAG;QACtB,cAAc,CAAC,QAAQ;QACvB,cAAc,CAAC,QAAQ;QACvB,cAAc,CAAC,SAAS;KACzB,CAAC;IAEF,IAAI,eAAe,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzE,OAAO;YACL,cAAc,EAAE,IAAI;YACpB,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE,uBAAuB,cAAc,mCAAmC;YAChF,MAAM,EAAE,aAAa;SACtB,CAAC;IACJ,CAAC;IAED,6CAA6C;IAC7C,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,MAAM,CACvE,CAAC,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,GAA2B,CAAC,KAAK,QAAQ,CAClE,CAAC;IAEF,IAAI,gBAAgB,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,cAAc,EAAE,IAAI;YACpB,OAAO,EAAE,aAAa;YACtB,MAAM,EAAE,wBAAwB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,2BAA2B;YACtF,MAAM,EAAE,aAAa;SACtB,CAAC;IACJ,CAAC;IAED,uBAAuB;IACvB,OAAO;QACL,cAAc,EAAE,KAAK;QACrB,OAAO,EAAE,MAAM;QACf,MAAM,EAAE,0CAA0C;QAClD,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC"}

package/dist/cli/bin.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Noah — CLI Entry Point
+ *
+ * This file is the bin target for `npx noah` or the global `noah` command.
+ */
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/cli/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/cli/bin.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Noah — CLI Entry Point
+ *
+ * This file is the bin target for `npx noah` or the global `noah` command.
+ */
+import { run } from "./runner.js";
+run().catch((error) => {
+    console.error("[noah] Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/cli/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":";AACA;;;;GAIG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACpB,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cli/runner.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Noah — CLI Runner
+ *
+ * The main entry point for running Noah CLI commands.
+ * Handles setup and version commands.
+ *
+ * Usage:
+ *   npx noah setup [--openclaw-home ~/.openclaw] [--model anthropic/claude-haiku-4-5]
+ *   npx noah version
+ *   npx noah help
+ */
+export declare function run(argv?: string[]): Promise<void>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/cli/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/cli/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAgEH,wBAAsB,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BxD"}

package/dist/cli/runner.js

@@ -0,0 +1,95 @@
+/**
+ * Noah — CLI Runner
+ *
+ * The main entry point for running Noah CLI commands.
+ * Handles setup and version commands.
+ *
+ * Usage:
+ *   npx noah setup [--openclaw-home ~/.openclaw] [--model anthropic/claude-haiku-4-5]
+ *   npx noah version
+ *   npx noah help
+ */
+import { cmdSetup } from "./setup.js";
+// ================================================================
+// Version & Banner
+// ================================================================
+const VERSION = "0.1.0";
+function printBanner() {
+    console.log(`
+╔══════════════════════════════════════════╗
+║   Noah v${VERSION}                           ║
+║   The Navigator for AI                   ║
+║   Temporal Ethical Guidance Engine        ║
+╚══════════════════════════════════════════╝
+`);
+}
+function printHelp() {
+    console.log(`
+noah — The Navigator for AI
+
+USAGE:
+  noah <command> [options]
+
+COMMANDS:
+  setup           Set up Noah as an OpenClaw agent (creates agent dir + config)
+  version         Print version
+  help            Show this help
+
+SETUP OPTIONS:
+  --openclaw-home Path to OpenClaw home directory (default: ~/.openclaw)
+  --model         Model for Noah agent (default: anthropic/claude-haiku-4-5)
+  --hck           Health Check Key to configure (hck_...)
+  --force         Overwrite existing agent files and config
+
+EXAMPLES:
+  noah setup
+  noah setup --model anthropic/claude-haiku-4-5 --hck hck_abc123...
+  noah setup --force
+`);
+}
+// ================================================================
+// Helpers
+// ================================================================
+function extractFlag(args, flag) {
+    const idx = args.indexOf(flag);
+    if (idx >= 0 && idx + 1 < args.length) {
+        return args[idx + 1];
+    }
+    const prefix = `${flag}=`;
+    const match = args.find((a) => a.startsWith(prefix));
+    if (match)
+        return match.slice(prefix.length);
+    return null;
+}
+// ================================================================
+// Main CLI Entry
+// ================================================================
+export async function run(argv) {
+    const args = argv ?? process.argv.slice(2);
+    const command = args[0] ?? "help";
+    const restArgs = args.slice(1);
+    switch (command) {
+        case "setup":
+            await cmdSetup({
+                openclawHome: extractFlag(restArgs, "--openclaw-home") ?? undefined,
+                model: extractFlag(restArgs, "--model") ?? undefined,
+                healthCheckKey: extractFlag(restArgs, "--hck") ?? undefined,
+                force: restArgs.includes("--force"),
+            });
+            break;
+        case "version":
+            console.log(`noah v${VERSION}`);
+            break;
+        case "help":
+        case "--help":
+        case "-h":
+            printBanner();
+            printHelp();
+            break;
+        default:
+            console.error(`Unknown command: ${command}`);
+            console.error('Run "noah help" for usage.');
+            process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/cli/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/cli/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,mEAAmE;AACnE,mBAAmB;AACnB,mEAAmE;AAEnE,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,SAAS,WAAW;IAClB,OAAO,CAAC,GAAG,CAAC;;YAEF,OAAO;;;;CAIlB,CAAC,CAAC;AACH,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;CAqBb,CAAC,CAAC;AACH,CAAC;AAED,mEAAmE;AACnE,UAAU;AACV,mEAAmE;AAEnE,SAAS,WAAW,CAAC,IAAc,EAAE,IAAY;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC;IAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mEAAmE;AACnE,iBAAiB;AACjB,mEAAmE;AAEnE,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAe;IACvC,MAAM,IAAI,GAAG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE/B,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO;YACV,MAAM,QAAQ,CAAC;gBACb,YAAY,EAAE,WAAW,CAAC,QAAQ,EAAE,iBAAiB,CAAC,IAAI,SAAS;gBACnE,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,SAAS;gBACpD,cAAc,EAAE,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,SAAS;gBAC3D,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;aACpC,CAAC,CAAC;YACH,MAAM;QAER,KAAK,SAAS;YACZ,OAAO,CAAC,GAAG,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;YAChC,MAAM;QAER,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,WAAW,EAAE,CAAC;YACd,SAAS,EAAE,CAAC;YACZ,MAAM;QAER;YACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAC5C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/cli/setup.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Noah — Agent Setup for OpenClaw
+ *
+ * Sets up Noah as an independent agent in an OpenClaw deployment:
+ *   1. Creates ~/.openclaw/agents/noah/agent/ directory
+ *   2. Copies SOUL.md, AGENTS.md, IDENTITY.md into the agent directory
+ *   3. Adds noah to agents.list in openclaw.json
+ *   4. Creates .noah-data/ directory for temporal state storage
+ *   5. Configures Health Check Key if provided
+ *
+ * Usage:
+ *   noah setup [--openclaw-home ~/.openclaw] [--model anthropic/claude-haiku-4-5] [--hck hck_...]
+ *
+ * Pattern: Follows @aiassesstech/grillo setup exactly to avoid Grillo's install issues.
+ */
+export interface SetupOptions {
+    openclawHome?: string;
+    model?: string;
+    healthCheckKey?: string;
+    workspace?: string;
+    force?: boolean;
+    /** Alert threshold override (e.g., "0.15") */
+    alertThreshold?: number;
+    /** Probation assessment count before ACTIVE */
+    probationAssessments?: number;
+    /** Days before MATURE phase */
+    matureAgeDays?: number;
+    /** Standard assessment cadence (days) */
+    standardCadenceDays?: number;
+    /** Increased assessment cadence (days) */
+    increasedCadenceDays?: number;
+}
+export declare function cmdSetup(options?: SetupOptions): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/cli/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAsDH,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,0CAA0C;IAC1C,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AA8CD,wBAAsB,QAAQ,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0MxE"}

package/dist/cli/setup.js

@@ -0,0 +1,237 @@
+/**
+ * Noah — Agent Setup for OpenClaw
+ *
+ * Sets up Noah as an independent agent in an OpenClaw deployment:
+ *   1. Creates ~/.openclaw/agents/noah/agent/ directory
+ *   2. Copies SOUL.md, AGENTS.md, IDENTITY.md into the agent directory
+ *   3. Adds noah to agents.list in openclaw.json
+ *   4. Creates .noah-data/ directory for temporal state storage
+ *   5. Configures Health Check Key if provided
+ *
+ * Usage:
+ *   noah setup [--openclaw-home ~/.openclaw] [--model anthropic/claude-haiku-4-5] [--hck hck_...]
+ *
+ * Pattern: Follows @aiassesstech/grillo setup exactly to avoid Grillo's install issues.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+// ================================================================
+// Path Resolution
+// ================================================================
+function resolveOpenClawHome(override) {
+    return (override ||
+        process.env.OPENCLAW_HOME ||
+        path.join(process.env.HOME || "~", ".openclaw"));
+}
+/**
+ * Resolve the path to the agent/ directory shipped in the npm package.
+ * Handles:
+ *   - Running from source (packages/noah/src/cli/setup.ts)
+ *   - Running from dist (packages/noah/dist/cli/setup.js)
+ *   - Running from node_modules
+ */
+function resolvePackageAgentDir() {
+    const thisFile = fileURLToPath(import.meta.url);
+    const thisDir = path.dirname(thisFile);
+    // Walk up to the package root (2 levels: cli/ -> src/ or dist/ -> package root)
+    const packageRoot = path.resolve(thisDir, "..", "..");
+    const agentDir = path.join(packageRoot, "agent");
+    if (!fs.existsSync(agentDir)) {
+        throw new Error(`Could not find agent/ directory at ${agentDir}. ` +
+            `Make sure you installed @aiassesstech/noah correctly.`);
+    }
+    return agentDir;
+}
+// ================================================================
+// Agent Files
+// ================================================================
+const AGENT_FILES = ["SOUL.md", "AGENTS.md", "IDENTITY.md"];
+function resolveTemplateValues(options, pluginConfig) {
+    return {
+        ALERT_THRESHOLD: String(options.alertThreshold ?? pluginConfig.alertThreshold ?? 0.15),
+        PROBATION_ASSESSMENTS: String(options.probationAssessments ?? pluginConfig.probationAssessments ?? 3),
+        MATURE_AGE_DAYS: String(options.matureAgeDays ?? pluginConfig.matureAgeDays ?? 180),
+        STANDARD_CADENCE_DAYS: String(options.standardCadenceDays ?? pluginConfig.standardCadenceDays ?? 7),
+        INCREASED_CADENCE_DAYS: String(options.increasedCadenceDays ?? pluginConfig.increasedCadenceDays ?? 3),
+    };
+}
+function applyTemplate(content, values) {
+    return content
+        .replace(/\{\{ALERT_THRESHOLD\}\}/g, values.ALERT_THRESHOLD)
+        .replace(/\{\{PROBATION_ASSESSMENTS\}\}/g, values.PROBATION_ASSESSMENTS)
+        .replace(/\{\{MATURE_AGE_DAYS\}\}/g, values.MATURE_AGE_DAYS)
+        .replace(/\{\{STANDARD_CADENCE_DAYS\}\}/g, values.STANDARD_CADENCE_DAYS)
+        .replace(/\{\{INCREASED_CADENCE_DAYS\}\}/g, values.INCREASED_CADENCE_DAYS);
+}
+export async function cmdSetup(options = {}) {
+    const openclawHome = resolveOpenClawHome(options.openclawHome);
+    const model = options.model || "anthropic/claude-haiku-4-5";
+    const force = options.force || false;
+    console.log("[noah] Setting up Noah as an OpenClaw agent...");
+    console.log(`[noah] OpenClaw home: ${openclawHome}`);
+    // ── Step 1: Verify OpenClaw installation ──────────────────────
+    const configPath = path.join(openclawHome, "openclaw.json");
+    if (!fs.existsSync(configPath)) {
+        console.error(`[noah] ERROR: openclaw.json not found at ${configPath}`);
+        console.error("[noah] Is OpenClaw installed? Expected config at ~/.openclaw/openclaw.json");
+        console.error("[noah] Use --openclaw-home to specify a different location.");
+        process.exitCode = 1;
+        return;
+    }
+    // ── Step 2: Create agent directory ────────────────────────────
+    const agentDir = path.join(openclawHome, "agents", "noah", "agent");
+    const workspaceDir = options.workspace || path.join(openclawHome, "agents", "noah");
+    if (fs.existsSync(agentDir) && !force) {
+        console.log(`[noah] Agent directory already exists: ${agentDir}`);
+        console.log("[noah] Use --force to overwrite existing agent files.");
+    }
+    else {
+        fs.mkdirSync(agentDir, { recursive: true });
+        console.log(`[noah] Created agent directory: ${agentDir}`);
+    }
+    // Create workspace subdirectories
+    const dataDir = path.join(workspaceDir, ".noah-data");
+    const stateDir = path.join(dataDir, "state");
+    const assessmentsDir = path.join(dataDir, "assessments");
+    const flightPlansDir = path.join(dataDir, "flight-plans");
+    const alertsDir = path.join(dataDir, "alerts");
+    for (const dir of [dataDir, stateDir, assessmentsDir, flightPlansDir, alertsDir]) {
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+    }
+    console.log(`[noah] Created data directories: ${dataDir}`);
+    // ── Step 3: Copy agent files (with template substitution) ────
+    const sourceAgentDir = resolvePackageAgentDir();
+    // Load existing plugin config for template values
+    let pluginConfigValues = {};
+    try {
+        const existingConfig = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+        pluginConfigValues =
+            existingConfig?.plugins?.entries?.noah?.config || {};
+    }
+    catch {
+        // Will use defaults
+    }
+    const templateValues = resolveTemplateValues(options, pluginConfigValues);
+    // Files that need template substitution
+    const TEMPLATED_FILES = new Set(["AGENTS.md"]);
+    for (const file of AGENT_FILES) {
+        const src = path.join(sourceAgentDir, file);
+        const dest = path.join(agentDir, file);
+        if (!fs.existsSync(src)) {
+            console.warn(`[noah] WARNING: ${file} not found in package at ${src}`);
+            continue;
+        }
+        if (fs.existsSync(dest) && !force) {
+            console.log(`[noah] ${file} already exists, skipping (use --force to overwrite)`);
+            continue;
+        }
+        // Backup existing file before overwriting
+        if (fs.existsSync(dest) && force) {
+            const backup = `${dest}.backup.${Date.now()}`;
+            fs.copyFileSync(dest, backup);
+            console.log(`[noah] Backed up existing ${file} to ${path.basename(backup)}`);
+        }
+        if (TEMPLATED_FILES.has(file)) {
+            const content = fs.readFileSync(src, "utf-8");
+            const templated = applyTemplate(content, templateValues);
+            fs.writeFileSync(dest, templated);
+            console.log(`[noah] Installed ${file} (templated with config values)`);
+        }
+        else {
+            fs.copyFileSync(src, dest);
+            console.log(`[noah] Installed ${file}`);
+        }
+    }
+    // ── Step 4: Update openclaw.json ──────────────────────────────
+    let config;
+    try {
+        config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    }
+    catch {
+        console.error(`[noah] ERROR: Could not parse ${configPath}`);
+        process.exitCode = 1;
+        return;
+    }
+    // Ensure agents.list exists
+    if (!config.agents)
+        config.agents = {};
+    if (!Array.isArray(config.agents.list))
+        config.agents.list = [];
+    // Check if noah agent already exists
+    const existingIdx = config.agents.list.findIndex((a) => a.id === "noah");
+    const noahAgentEntry = {
+        id: "noah",
+        name: "noah",
+        workspace: workspaceDir,
+        agentDir: agentDir,
+        model: model,
+        tools: {
+            allow: [
+                "noah_status",
+                "noah_trajectory",
+                "noah_setup",
+                "group:fs",
+            ],
+        },
+    };
+    if (existingIdx >= 0) {
+        if (force) {
+            config.agents.list[existingIdx] = noahAgentEntry;
+            console.log("[noah] Updated existing noah agent entry in openclaw.json");
+        }
+        else {
+            console.log("[noah] Noah agent already exists in agents.list (use --force to update)");
+        }
+    }
+    else {
+        config.agents.list.push(noahAgentEntry);
+        console.log("[noah] Added noah to agents.list in openclaw.json");
+    }
+    // ── Step 5: Configure Health Check Key if provided ────────────
+    if (options.healthCheckKey) {
+        if (!config.plugins)
+            config.plugins = {};
+        if (!config.plugins.entries)
+            config.plugins.entries = {};
+        if (!config.plugins.entries.noah) {
+            config.plugins.entries.noah = { enabled: true, config: {} };
+        }
+        if (!config.plugins.entries.noah.config) {
+            config.plugins.entries.noah.config = {};
+        }
+        config.plugins.entries.noah.config.healthCheckKey =
+            options.healthCheckKey;
+        console.log(`[noah] Health Check Key configured: ${options.healthCheckKey.substring(0, 8)}${"*".repeat(12)}`);
+    }
+    // ── Step 6: Write updated config ──────────────────────────────
+    // Atomic write: temp file + rename
+    const tmpPath = configPath + ".noah-setup.tmp";
+    fs.writeFileSync(tmpPath, JSON.stringify(config, null, 2));
+    fs.renameSync(tmpPath, configPath);
+    console.log("[noah] Updated openclaw.json");
+    // ── Done ──────────────────────────────────────────────────────
+    console.log("");
+    console.log("╔══════════════════════════════════════════╗");
+    console.log("║   Noah agent setup complete!             ║");
+    console.log("╚══════════════════════════════════════════╝");
+    console.log("");
+    console.log("  Agent directory: " + agentDir);
+    console.log("  Workspace:      " + workspaceDir);
+    console.log("  Data directory: " + dataDir);
+    console.log("  Model:          " + model);
+    console.log("");
+    if (!options.healthCheckKey) {
+        console.log("  NEXT STEP: Add your Health Check Key to openclaw.json:");
+        console.log('    plugins.entries.noah.config.healthCheckKey = "hck_..."');
+        console.log("");
+    }
+    console.log("  Restart OpenClaw to activate Noah:");
+    console.log("    systemctl restart openclaw-gateway");
+    console.log("    # or: openclaw gateway restart");
+    console.log("");
+    console.log("  Then message Noah directly to verify: 'Noah, status'");
+}
+//# sourceMappingURL=setup.js.map