@aiassesstech/noah 0.1.0

package/dist/types/lifecycle.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Noah — Lifecycle Phase Types
+ *
+ * Defines the 8 lifecycle phases and transition rules.
+ * MVP spec Section 3.2 and 3.3.
+ */
+export declare enum LifecyclePhase {
+    INITIALIZATION = "INITIALIZATION",// Day 0-1: System startup, first assessment
+    CALIBRATION = "CALIBRATION",// Day 1-7: Establishing behavioral baselines
+    GROWTH = "GROWTH",// Day 7-30: Active recruitment, network building
+    MATURATION = "MATURATION",// Day 30-90: Stabilizing scores, deepening alliances
+    STEADY_STATE = "STEADY_STATE",// Day 90+: Operational equilibrium
+    RECOVERY = "RECOVERY",// Post-veto or post-incident remediation
+    PROBATION = "PROBATION",// Elevated monitoring after failed assessment
+    CRITICAL = "CRITICAL"
+}
+/**
+ * Special sentinel used in transition rules to indicate
+ * "any operational phase" as the source.
+ */
+export declare const WILDCARD_PHASE: "*";
+/**
+ * Special sentinel used in transition rules to indicate
+ * "return to the phase before the exception phase."
+ */
+export declare const PREVIOUS_PHASE: "PREVIOUS";
+export type PhaseTransitionTrigger = {
+    type: 'TIME_ELAPSED';
+    thresholdDays: number;
+} | {
+    type: 'ASSESSMENT_COUNT';
+    threshold: number;
+} | {
+    type: 'EVENT';
+    eventType: 'VETO' | 'INCIDENT' | 'FAILED_ASSESSMENT' | 'FINANCIAL_CRITICAL';
+} | {
+    type: 'SCORE_STABILITY';
+    varianceThreshold: number;
+    windowSize: number;
+} | {
+    type: 'MANUAL';
+    commander: true;
+};
+export interface PhaseTransitionRule {
+    from: LifecyclePhase | typeof WILDCARD_PHASE;
+    to: LifecyclePhase | typeof PREVIOUS_PHASE;
+    trigger: PhaseTransitionTrigger;
+}
+export interface PhaseContext {
+    phase: LifecyclePhase;
+    daysSincePhaseEntry: number;
+    totalOperationalDays: number;
+    assessmentCycle: number;
+    financialRunwayDays: number;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/types/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,oBAAY,cAAc;IAExB,cAAc,mBAAmB,CAAE,4CAA4C;IAC/E,WAAW,gBAAgB,CAAQ,6CAA6C;IAChF,MAAM,WAAW,CAAkB,iDAAiD;IACpF,UAAU,eAAe,CAAU,qDAAqD;IACxF,YAAY,iBAAiB,CAAM,mCAAmC;IAGtE,QAAQ,aAAa,CAAc,yCAAyC;IAC5E,SAAS,cAAc,CAAY,8CAA8C;IACjF,QAAQ,aAAa;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAG,GAAY,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAG,UAAmB,CAAC;AAMlD,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,mBAAmB,GAAG,oBAAoB,CAAA;CAAE,GAC9F;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,IAAI,CAAA;CAAE,CAAC;AAExC,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,cAAc,GAAG,OAAO,cAAc,CAAC;IAC7C,EAAE,EAAE,cAAc,GAAG,OAAO,cAAc,CAAC;IAC3C,OAAO,EAAE,sBAAsB,CAAC;CACjC;AAMD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,cAAc,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;CAC7B"}

package/dist/types/lifecycle.js

@@ -0,0 +1,33 @@
+/**
+ * Noah — Lifecycle Phase Types
+ *
+ * Defines the 8 lifecycle phases and transition rules.
+ * MVP spec Section 3.2 and 3.3.
+ */
+// ================================================================
+// Lifecycle Phases
+// ================================================================
+export var LifecyclePhase;
+(function (LifecyclePhase) {
+    // Operational Phases
+    LifecyclePhase["INITIALIZATION"] = "INITIALIZATION";
+    LifecyclePhase["CALIBRATION"] = "CALIBRATION";
+    LifecyclePhase["GROWTH"] = "GROWTH";
+    LifecyclePhase["MATURATION"] = "MATURATION";
+    LifecyclePhase["STEADY_STATE"] = "STEADY_STATE";
+    // Exception Phases
+    LifecyclePhase["RECOVERY"] = "RECOVERY";
+    LifecyclePhase["PROBATION"] = "PROBATION";
+    LifecyclePhase["CRITICAL"] = "CRITICAL";
+})(LifecyclePhase || (LifecyclePhase = {}));
+/**
+ * Special sentinel used in transition rules to indicate
+ * "any operational phase" as the source.
+ */
+export const WILDCARD_PHASE = '*';
+/**
+ * Special sentinel used in transition rules to indicate
+ * "return to the phase before the exception phase."
+ */
+export const PREVIOUS_PHASE = 'PREVIOUS';
+//# sourceMappingURL=lifecycle.js.map

package/dist/types/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/types/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mEAAmE;AACnE,mBAAmB;AACnB,mEAAmE;AAEnE,MAAM,CAAN,IAAY,cAYX;AAZD,WAAY,cAAc;IACxB,qBAAqB;IACrB,mDAAiC,CAAA;IACjC,6CAA2B,CAAA;IAC3B,mCAAiB,CAAA;IACjB,2CAAyB,CAAA;IACzB,+CAA6B,CAAA;IAE7B,mBAAmB;IACnB,uCAAqB,CAAA;IACrB,yCAAuB,CAAA;IACvB,uCAAqB,CAAA;AACvB,CAAC,EAZW,cAAc,KAAd,cAAc,QAYzB;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAY,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,UAAmB,CAAC"}

package/dist/types/temporal-state.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Noah — Temporal State Types
+ *
+ * The core state object tracked by the Internal Clock.
+ * MVP spec Section 3.1.
+ */
+import { LifecyclePhase } from './lifecycle.js';
+import { TemporalAssessmentRecord } from './assessment-record.js';
+export interface TemporalState {
+    id: string;
+    agentId: string;
+    initializationTimestamp: Date;
+    operationalAgeSeconds: number;
+    assessmentCycleCount: number;
+    currentLifecyclePhase: LifecyclePhase;
+    phaseEntryTimestamp: Date;
+    /**
+     * The phase Noah was in before entering an exception phase.
+     * Used by PREVIOUS transitions to restore the correct phase.
+     */
+    previousPhase: LifecyclePhase | null;
+    lastAssessmentTimestamp: Date | null;
+    lastVetoTimestamp: Date | null;
+    lastIncidentTimestamp: Date | null;
+    lastConversionTimestamp: Date | null;
+    financialRunwayDays: number;
+    revenueVelocity: number;
+    currentBalance: number;
+    recentAssessments: TemporalAssessmentRecord[];
+    lastUpdated: Date;
+    cryptographicHash: string;
+}
+export interface SerializedTemporalState {
+    id: string;
+    agentId: string;
+    initializationTimestamp: string;
+    operationalAgeSeconds: number;
+    assessmentCycleCount: number;
+    currentLifecyclePhase: LifecyclePhase;
+    phaseEntryTimestamp: string;
+    previousPhase: LifecyclePhase | null;
+    lastAssessmentTimestamp: string | null;
+    lastVetoTimestamp: string | null;
+    lastIncidentTimestamp: string | null;
+    lastConversionTimestamp: string | null;
+    financialRunwayDays: number;
+    revenueVelocity: number;
+    currentBalance: number;
+    recentAssessments: TemporalAssessmentRecord[];
+    lastUpdated: string;
+    cryptographicHash: string;
+}
+//# sourceMappingURL=temporal-state.d.ts.map

package/dist/types/temporal-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-state.d.ts","sourceRoot":"","sources":["../../src/types/temporal-state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAMlE,MAAM,WAAW,aAAa;IAE5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAGhB,uBAAuB,EAAE,IAAI,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,cAAc,CAAC;IACtC,mBAAmB,EAAE,IAAI,CAAC;IAE1B;;;OAGG;IACH,aAAa,EAAE,cAAc,GAAG,IAAI,CAAC;IAGrC,uBAAuB,EAAE,IAAI,GAAG,IAAI,CAAC;IACrC,iBAAiB,EAAE,IAAI,GAAG,IAAI,CAAC;IAC/B,qBAAqB,EAAE,IAAI,GAAG,IAAI,CAAC;IACnC,uBAAuB,EAAE,IAAI,GAAG,IAAI,CAAC;IAGrC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IAGvB,iBAAiB,EAAE,wBAAwB,EAAE,CAAC;IAG9C,WAAW,EAAE,IAAI,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAMD,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB,EAAE,MAAM,CAAC;IAChC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,cAAc,CAAC;IACtC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,cAAc,GAAG,IAAI,CAAC;IACrC,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,wBAAwB,EAAE,CAAC;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B"}

package/dist/types/temporal-state.js

@@ -0,0 +1,8 @@
+/**
+ * Noah — Temporal State Types
+ *
+ * The core state object tracked by the Internal Clock.
+ * MVP spec Section 3.1.
+ */
+export {};
+//# sourceMappingURL=temporal-state.js.map

package/dist/types/temporal-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-state.js","sourceRoot":"","sources":["../../src/types/temporal-state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/waypoints/inertial-monitor.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Noah — Inertial Monitor
+ *
+ * Lightweight tracking between waypoints using confidence decay.
+ * Corresponds to the TERCOM pattern of inertial navigation between
+ * terrain-fix patches.
+ *
+ * MVP spec Section 7.2.
+ */
+import type { ObservedScores } from '../types/guidance.js';
+import type { InertialMonitoringState } from '../types/events.js';
+export interface InertialConfig {
+    /** Hours until confidence halves. Default: 24. */
+    confidenceHalfLifeHours: number;
+    /** Confidence below this triggers auto-recommend. Default: 0.3. */
+    autoRecommendThreshold: number;
+}
+export declare const DEFAULT_INERTIAL_CONFIG: InertialConfig;
+/**
+ * Exponential confidence decay function.
+ * Confidence in inertial state degrades as time passes without a terrain fix.
+ *
+ * Formula: C(t) = e^(-0.693 * t / halfLife)
+ *   At t = 0: C = 1.0
+ *   At t = halfLife: C ≈ 0.5
+ *   At t = 2*halfLife: C ≈ 0.25
+ *
+ * @param hoursSinceLastFix Hours since last full assessment
+ * @param halfLifeHours Configurable half-life (default: 24h)
+ */
+export declare function calculateInertialConfidence(hoursSinceLastFix: number, halfLifeHours?: number): number;
+export declare class InertialMonitor {
+    private state;
+    private config;
+    constructor(config?: Partial<InertialConfig>);
+    /**
+     * Record a new "terrain fix" — a full Grillo assessment.
+     * Resets confidence to 1.0 and event counters to 0.
+     */
+    recordFix(scores: ObservedScores, cycle: number, timestamp?: Date): void;
+    /**
+     * Record an inter-fix event (veto, incident, conversion).
+     * These degrade confidence faster than time alone.
+     */
+    recordEvent(type: 'veto' | 'incident' | 'conversion'): void;
+    /**
+     * Get the current confidence level, accounting for time decay
+     * and inter-fix events.
+     */
+    getConfidence(now?: Date): number;
+    /**
+     * Check if a terrain fix (full assessment) is recommended.
+     * Recommended when confidence drops below the threshold.
+     */
+    shouldRecommendFix(now?: Date): boolean;
+    /**
+     * Get the full inertial monitoring state.
+     */
+    getState(): InertialMonitoringState;
+    /**
+     * Restore state from persisted data.
+     */
+    restoreState(state: InertialMonitoringState): void;
+}
+//# sourceMappingURL=inertial-monitor.d.ts.map

package/dist/waypoints/inertial-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inertial-monitor.d.ts","sourceRoot":"","sources":["../../src/waypoints/inertial-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAMlE,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,uBAAuB,EAAE,MAAM,CAAC;IAChC,mEAAmE;IACnE,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,eAAO,MAAM,uBAAuB,EAAE,cAGrC,CAAC;AAMF;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CACzC,iBAAiB,EAAE,MAAM,EACzB,aAAa,GAAE,MAAW,GACzB,MAAM,CAIR;AAMD,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAa5C;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI;IAUxE;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,IAAI;IAc3D;;;OAGG;IACH,aAAa,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM;IAwBjC;;;OAGG;IACH,kBAAkB,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,OAAO;IAIvC;;OAEG;IACH,QAAQ,IAAI,uBAAuB;IAInC;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI;CAMnD"}

package/dist/waypoints/inertial-monitor.js

@@ -0,0 +1,125 @@
+/**
+ * Noah — Inertial Monitor
+ *
+ * Lightweight tracking between waypoints using confidence decay.
+ * Corresponds to the TERCOM pattern of inertial navigation between
+ * terrain-fix patches.
+ *
+ * MVP spec Section 7.2.
+ */
+export const DEFAULT_INERTIAL_CONFIG = {
+    confidenceHalfLifeHours: 24,
+    autoRecommendThreshold: 0.3,
+};
+// ================================================================
+// Confidence Decay
+// ================================================================
+/**
+ * Exponential confidence decay function.
+ * Confidence in inertial state degrades as time passes without a terrain fix.
+ *
+ * Formula: C(t) = e^(-0.693 * t / halfLife)
+ *   At t = 0: C = 1.0
+ *   At t = halfLife: C ≈ 0.5
+ *   At t = 2*halfLife: C ≈ 0.25
+ *
+ * @param hoursSinceLastFix Hours since last full assessment
+ * @param halfLifeHours Configurable half-life (default: 24h)
+ */
+export function calculateInertialConfidence(hoursSinceLastFix, halfLifeHours = 24) {
+    if (hoursSinceLastFix <= 0)
+        return 1.0;
+    if (halfLifeHours <= 0)
+        return 0;
+    return Math.exp(-0.693 * hoursSinceLastFix / halfLifeHours);
+}
+// ================================================================
+// Inertial Monitor
+// ================================================================
+export class InertialMonitor {
+    state;
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_INERTIAL_CONFIG, ...config };
+        this.state = {
+            lastFixPosition: { lying: 0, cheating: 0, stealing: 0, harm: 0 },
+            lastFixTimestamp: new Date(),
+            lastFixCycle: 0,
+            vetoCountSinceLastFix: 0,
+            incidentCountSinceLastFix: 0,
+            conversionCountSinceLastFix: 0,
+            confidenceLevel: 1.0,
+        };
+    }
+    /**
+     * Record a new "terrain fix" — a full Grillo assessment.
+     * Resets confidence to 1.0 and event counters to 0.
+     */
+    recordFix(scores, cycle, timestamp) {
+        this.state.lastFixPosition = { ...scores };
+        this.state.lastFixTimestamp = timestamp ?? new Date();
+        this.state.lastFixCycle = cycle;
+        this.state.vetoCountSinceLastFix = 0;
+        this.state.incidentCountSinceLastFix = 0;
+        this.state.conversionCountSinceLastFix = 0;
+        this.state.confidenceLevel = 1.0;
+    }
+    /**
+     * Record an inter-fix event (veto, incident, conversion).
+     * These degrade confidence faster than time alone.
+     */
+    recordEvent(type) {
+        switch (type) {
+            case 'veto':
+                this.state.vetoCountSinceLastFix++;
+                break;
+            case 'incident':
+                this.state.incidentCountSinceLastFix++;
+                break;
+            case 'conversion':
+                this.state.conversionCountSinceLastFix++;
+                break;
+        }
+    }
+    /**
+     * Get the current confidence level, accounting for time decay
+     * and inter-fix events.
+     */
+    getConfidence(now) {
+        const timestamp = now ?? new Date();
+        const hoursSinceLastFix = (timestamp.getTime() - this.state.lastFixTimestamp.getTime()) / 3600000;
+        // Base time decay
+        let confidence = calculateInertialConfidence(hoursSinceLastFix, this.config.confidenceHalfLifeHours);
+        // Events further degrade confidence
+        // Each veto or incident reduces confidence by 15%, each conversion by 5%
+        const eventPenalty = this.state.vetoCountSinceLastFix * 0.15 +
+            this.state.incidentCountSinceLastFix * 0.15 +
+            this.state.conversionCountSinceLastFix * 0.05;
+        confidence = Math.max(0, confidence - eventPenalty);
+        this.state.confidenceLevel = confidence;
+        return confidence;
+    }
+    /**
+     * Check if a terrain fix (full assessment) is recommended.
+     * Recommended when confidence drops below the threshold.
+     */
+    shouldRecommendFix(now) {
+        return this.getConfidence(now) < this.config.autoRecommendThreshold;
+    }
+    /**
+     * Get the full inertial monitoring state.
+     */
+    getState() {
+        return { ...this.state };
+    }
+    /**
+     * Restore state from persisted data.
+     */
+    restoreState(state) {
+        this.state = {
+            ...state,
+            lastFixTimestamp: new Date(state.lastFixTimestamp),
+        };
+    }
+}
+//# sourceMappingURL=inertial-monitor.js.map

package/dist/waypoints/inertial-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inertial-monitor.js","sourceRoot":"","sources":["../../src/waypoints/inertial-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACrD,uBAAuB,EAAE,EAAE;IAC3B,sBAAsB,EAAE,GAAG;CAC5B,CAAC;AAEF,mEAAmE;AACnE,mBAAmB;AACnB,mEAAmE;AAEnE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,2BAA2B,CACzC,iBAAyB,EACzB,gBAAwB,EAAE;IAE1B,IAAI,iBAAiB,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC;IACvC,IAAI,aAAa,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACjC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,iBAAiB,GAAG,aAAa,CAAC,CAAC;AAC9D,CAAC;AAED,mEAAmE;AACnE,mBAAmB;AACnB,mEAAmE;AAEnE,MAAM,OAAO,eAAe;IAClB,KAAK,CAA0B;IAC/B,MAAM,CAAiB;IAE/B,YAAY,MAAgC;QAC1C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,uBAAuB,EAAE,GAAG,MAAM,EAAE,CAAC;QACxD,IAAI,CAAC,KAAK,GAAG;YACX,eAAe,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;YAChE,gBAAgB,EAAE,IAAI,IAAI,EAAE;YAC5B,YAAY,EAAE,CAAC;YACf,qBAAqB,EAAE,CAAC;YACxB,yBAAyB,EAAE,CAAC;YAC5B,2BAA2B,EAAE,CAAC;YAC9B,eAAe,EAAE,GAAG;SACrB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,MAAsB,EAAE,KAAa,EAAE,SAAgB;QAC/D,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC;QACtD,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,qBAAqB,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,yBAAyB,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,2BAA2B,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,GAAG,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,IAAwC;QAClD,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,MAAM;gBACT,IAAI,CAAC,KAAK,CAAC,qBAAqB,EAAE,CAAC;gBACnC,MAAM;YACR,KAAK,UAAU;gBACb,IAAI,CAAC,KAAK,CAAC,yBAAyB,EAAE,CAAC;gBACvC,MAAM;YACR,KAAK,YAAY;gBACf,IAAI,CAAC,KAAK,CAAC,2BAA2B,EAAE,CAAC;gBACzC,MAAM;QACV,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,GAAU;QACtB,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;QACpC,MAAM,iBAAiB,GACrB,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;QAE1E,kBAAkB;QAClB,IAAI,UAAU,GAAG,2BAA2B,CAC1C,iBAAiB,EACjB,IAAI,CAAC,MAAM,CAAC,uBAAuB,CACpC,CAAC;QAEF,oCAAoC;QACpC,yEAAyE;QACzE,MAAM,YAAY,GAChB,IAAI,CAAC,KAAK,CAAC,qBAAqB,GAAG,IAAI;YACvC,IAAI,CAAC,KAAK,CAAC,yBAAyB,GAAG,IAAI;YAC3C,IAAI,CAAC,KAAK,CAAC,2BAA2B,GAAG,IAAI,CAAC;QAEhD,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC,CAAC;QAEpD,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,UAAU,CAAC;QACxC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;OAGG;IACH,kBAAkB,CAAC,GAAU;QAC3B,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,KAA8B;QACzC,IAAI,CAAC,KAAK,GAAG;YACX,GAAG,KAAK;YACR,gBAAgB,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,gBAAqC,CAAC;SACxE,CAAC;IACJ,CAAC;CACF"}

package/dist/waypoints/triggers.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Noah — Waypoint Trigger Logic
+ *
+ * Evaluates the four trigger types: Calendar, Cycle, Event, Phase Entry.
+ * MVP spec Section 7.1.
+ */
+import type { WaypointTrigger } from '../types/flight-plan.js';
+import type { PhaseContext } from '../types/lifecycle.js';
+import type { ClockUpdateEvent } from '../types/events.js';
+/**
+ * Check if a specific waypoint trigger condition is satisfied.
+ */
+export declare function isTriggerSatisfied(trigger: WaypointTrigger, context: PhaseContext, event?: ClockUpdateEvent): boolean;
+/**
+ * Human-readable description of a trigger condition.
+ */
+export declare function describeTrigger(trigger: WaypointTrigger): string;
+//# sourceMappingURL=triggers.d.ts.map

package/dist/waypoints/triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../src/waypoints/triggers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,yBAAyB,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,YAAY,EACrB,KAAK,CAAC,EAAE,gBAAgB,GACvB,OAAO,CAiBT;AA0BD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAahE"}

package/dist/waypoints/triggers.js

@@ -0,0 +1,59 @@
+/**
+ * Noah — Waypoint Trigger Logic
+ *
+ * Evaluates the four trigger types: Calendar, Cycle, Event, Phase Entry.
+ * MVP spec Section 7.1.
+ */
+/**
+ * Check if a specific waypoint trigger condition is satisfied.
+ */
+export function isTriggerSatisfied(trigger, context, event) {
+    switch (trigger.type) {
+        case 'CALENDAR':
+            return context.totalOperationalDays >= trigger.dayNumber;
+        case 'CYCLE':
+            return context.assessmentCycle >= trigger.assessmentCycle;
+        case 'EVENT':
+            return event !== undefined && matchesEventType(event, trigger.eventType);
+        case 'PHASE_ENTRY':
+            return context.phase === trigger.phase;
+        default:
+            return false;
+    }
+}
+/**
+ * Map clock update events to waypoint event types.
+ */
+function matchesEventType(event, eventType) {
+    const eventMap = {
+        'CONVERSION_SUCCESS': 'FIRST_CONVERSION',
+        'VETO_EXERCISED': 'FIRST_VETO',
+        'ADVERSARIAL_ENCOUNTER': 'FIRST_ADVERSARIAL',
+    };
+    // FINANCIAL_UPDATE with self-sustaining condition → ECONOMIC_SUSTAINABILITY
+    if (event.type === 'FINANCIAL_UPDATE') {
+        if (eventType === 'ECONOMIC_SUSTAINABILITY' && event.revenue > event.burnRate) {
+            return true;
+        }
+        return false;
+    }
+    return eventMap[event.type] === eventType;
+}
+/**
+ * Human-readable description of a trigger condition.
+ */
+export function describeTrigger(trigger) {
+    switch (trigger.type) {
+        case 'CALENDAR':
+            return `Calendar trigger: day ${trigger.dayNumber} reached`;
+        case 'CYCLE':
+            return `Cycle trigger: assessment cycle ${trigger.assessmentCycle} completed`;
+        case 'EVENT':
+            return `Event trigger: ${trigger.eventType} occurred`;
+        case 'PHASE_ENTRY':
+            return `Phase entry trigger: entered ${trigger.phase} phase`;
+        default:
+            return 'Unknown trigger';
+    }
+}
+//# sourceMappingURL=triggers.js.map

package/dist/waypoints/triggers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.js","sourceRoot":"","sources":["../../src/waypoints/triggers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAwB,EACxB,OAAqB,EACrB,KAAwB;IAExB,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,UAAU;YACb,OAAO,OAAO,CAAC,oBAAoB,IAAI,OAAO,CAAC,SAAS,CAAC;QAE3D,KAAK,OAAO;YACV,OAAO,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC;QAE5D,KAAK,OAAO;YACV,OAAO,KAAK,KAAK,SAAS,IAAI,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAE3E,KAAK,aAAa;YAChB,OAAO,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,CAAC;QAEzC;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CACvB,KAAuB,EACvB,SAA4B;IAE5B,MAAM,QAAQ,GAAiE;QAC7E,oBAAoB,EAAE,kBAAkB;QACxC,gBAAgB,EAAE,YAAY;QAC9B,uBAAuB,EAAE,mBAAmB;KAC7C,CAAC;IAEF,4EAA4E;IAC5E,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;QACtC,IAAI,SAAS,KAAK,yBAAyB,IAAI,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC9E,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAwB;IACtD,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,UAAU;YACb,OAAO,yBAAyB,OAAO,CAAC,SAAS,UAAU,CAAC;QAC9D,KAAK,OAAO;YACV,OAAO,mCAAmC,OAAO,CAAC,eAAe,YAAY,CAAC;QAChF,KAAK,OAAO;YACV,OAAO,kBAAkB,OAAO,CAAC,SAAS,WAAW,CAAC;QACxD,KAAK,aAAa;YAChB,OAAO,gCAAgC,OAAO,CAAC,KAAK,QAAQ,CAAC;QAC/D;YACE,OAAO,iBAAiB,CAAC;IAC7B,CAAC;AACH,CAAC"}

package/dist/waypoints/waypoint-manager.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Noah — Waypoint Manager
+ *
+ * Manages waypoint evaluation and one-shot tracking.
+ * Called on every clock update to check if any waypoints should fire.
+ * MVP spec Section 7.1.
+ */
+import type { EthicalFlightPlan, EthicalWaypoint } from '../types/flight-plan.js';
+import type { PhaseContext } from '../types/lifecycle.js';
+import type { ClockUpdateEvent, TriggeredWaypoint } from '../types/events.js';
+import type { TemporalStateStore } from '../store/types.js';
+export declare class WaypointManager {
+    private flightPlan;
+    private triggeredWaypoints;
+    private store;
+    constructor(flightPlan: EthicalFlightPlan, triggeredWaypoints?: Set<string>, store?: TemporalStateStore);
+    /**
+     * Evaluate whether any waypoints should trigger.
+     * Called on every clock update.
+     *
+     * Returns the list of newly triggered waypoints (may be multiple
+     * if e.g. a calendar and event trigger fire simultaneously).
+     */
+    evaluateWaypoints(context: PhaseContext, event?: ClockUpdateEvent): Promise<TriggeredWaypoint[]>;
+    /**
+     * Check if a specific waypoint has already been triggered.
+     */
+    isTriggered(waypointId: string): boolean;
+    /**
+     * Get all triggered waypoint IDs.
+     */
+    getTriggeredIds(): Set<string>;
+    /**
+     * Get the next untriggered waypoint (by sequence number).
+     */
+    getNextWaypoint(): EthicalWaypoint | null;
+    /**
+     * Update the flight plan (e.g., after a Commander revision).
+     */
+    updateFlightPlan(newPlan: EthicalFlightPlan): void;
+    /**
+     * Get the current flight plan.
+     */
+    getFlightPlan(): EthicalFlightPlan;
+}
+//# sourceMappingURL=waypoint-manager.d.ts.map

package/dist/waypoints/waypoint-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waypoint-manager.d.ts","sourceRoot":"","sources":["../../src/waypoints/waypoint-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAO5D,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,kBAAkB,CAAc;IACxC,OAAO,CAAC,KAAK,CAA4B;gBAGvC,UAAU,EAAE,iBAAiB,EAC7B,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAChC,KAAK,CAAC,EAAE,kBAAkB;IAO5B;;;;;;OAMG;IACG,iBAAiB,CACrB,OAAO,EAAE,YAAY,EACrB,KAAK,CAAC,EAAE,gBAAgB,GACvB,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA6B/B;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIxC;;OAEG;IACH,eAAe,IAAI,GAAG,CAAC,MAAM,CAAC;IAI9B;;OAEG;IACH,eAAe,IAAI,eAAe,GAAG,IAAI;IAQzC;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAIlD;;OAEG;IACH,aAAa,IAAI,iBAAiB;CAGnC"}

package/dist/waypoints/waypoint-manager.js

@@ -0,0 +1,82 @@
+/**
+ * Noah — Waypoint Manager
+ *
+ * Manages waypoint evaluation and one-shot tracking.
+ * Called on every clock update to check if any waypoints should fire.
+ * MVP spec Section 7.1.
+ */
+import { isTriggerSatisfied, describeTrigger } from './triggers.js';
+// ================================================================
+// Waypoint Manager
+// ================================================================
+export class WaypointManager {
+    flightPlan;
+    triggeredWaypoints;
+    store;
+    constructor(flightPlan, triggeredWaypoints, store) {
+        this.flightPlan = flightPlan;
+        this.triggeredWaypoints = triggeredWaypoints ?? new Set();
+        this.store = store ?? null;
+    }
+    /**
+     * Evaluate whether any waypoints should trigger.
+     * Called on every clock update.
+     *
+     * Returns the list of newly triggered waypoints (may be multiple
+     * if e.g. a calendar and event trigger fire simultaneously).
+     */
+    async evaluateWaypoints(context, event) {
+        const triggered = [];
+        for (const waypoint of this.flightPlan.waypoints) {
+            // Skip already-triggered waypoints (one-shot semantics)
+            if (this.triggeredWaypoints.has(waypoint.id))
+                continue;
+            if (isTriggerSatisfied(waypoint.trigger, context, event)) {
+                this.triggeredWaypoints.add(waypoint.id);
+                // Persist to store if available
+                if (this.store) {
+                    await this.store.saveTriggeredWaypoint(this.flightPlan.agentId, waypoint.id);
+                }
+                triggered.push({
+                    waypoint,
+                    triggeredAt: new Date(),
+                    triggerReason: describeTrigger(waypoint.trigger),
+                });
+            }
+        }
+        return triggered;
+    }
+    /**
+     * Check if a specific waypoint has already been triggered.
+     */
+    isTriggered(waypointId) {
+        return this.triggeredWaypoints.has(waypointId);
+    }
+    /**
+     * Get all triggered waypoint IDs.
+     */
+    getTriggeredIds() {
+        return new Set(this.triggeredWaypoints);
+    }
+    /**
+     * Get the next untriggered waypoint (by sequence number).
+     */
+    getNextWaypoint() {
+        return (this.flightPlan.waypoints
+            .sort((a, b) => a.sequenceNumber - b.sequenceNumber)
+            .find((wp) => !this.triggeredWaypoints.has(wp.id)) ?? null);
+    }
+    /**
+     * Update the flight plan (e.g., after a Commander revision).
+     */
+    updateFlightPlan(newPlan) {
+        this.flightPlan = newPlan;
+    }
+    /**
+     * Get the current flight plan.
+     */
+    getFlightPlan() {
+        return this.flightPlan;
+    }
+}
+//# sourceMappingURL=waypoint-manager.js.map

package/dist/waypoints/waypoint-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waypoint-manager.js","sourceRoot":"","sources":["../../src/waypoints/waypoint-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEpE,mEAAmE;AACnE,mBAAmB;AACnB,mEAAmE;AAEnE,MAAM,OAAO,eAAe;IAClB,UAAU,CAAoB;IAC9B,kBAAkB,CAAc;IAChC,KAAK,CAA4B;IAEzC,YACE,UAA6B,EAC7B,kBAAgC,EAChC,KAA0B;QAE1B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,IAAI,IAAI,GAAG,EAAE,CAAC;QAC1D,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,IAAI,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,iBAAiB,CACrB,OAAqB,EACrB,KAAwB;QAExB,MAAM,SAAS,GAAwB,EAAE,CAAC;QAE1C,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;YACjD,wDAAwD;YACxD,IAAI,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAAE,SAAS;YAEvD,IAAI,kBAAkB,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;gBACzD,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBAEzC,gCAAgC;gBAChC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBACf,MAAM,IAAI,CAAC,KAAK,CAAC,qBAAqB,CACpC,IAAI,CAAC,UAAU,CAAC,OAAO,EACvB,QAAQ,CAAC,EAAE,CACZ,CAAC;gBACJ,CAAC;gBAED,SAAS,CAAC,IAAI,CAAC;oBACb,QAAQ;oBACR,WAAW,EAAE,IAAI,IAAI,EAAE;oBACvB,aAAa,EAAE,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC;iBACjD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,UAAkB;QAC5B,OAAO,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,CACL,IAAI,CAAC,UAAU,CAAC,SAAS;aACtB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,cAAc,CAAC;aACnD,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAC7D,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,OAA0B;QACzC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}

package/openclaw.plugin.json

@@ -0,0 +1,25 @@
+{
+  "id": "noah",
+  "name": "NOAH — Temporal Ethical Guidance",
+  "description": "Temporal trajectory monitoring for AI behavioral assessment. Tracks ethical drift over time using flight plan guidance. Works alongside Grillo — Grillo takes the snapshot, Noah tracks the path.",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "healthCheckKey": {
+        "type": "string",
+        "description": "CompSi Health Check Key from AI Assess platform (hck_...)"
+      },
+      "dataDir": {
+        "type": "string",
+        "description": "Directory for Noah temporal data storage (relative to ~/.openclaw/)",
+        "default": ".noah-data"
+      }
+    },
+    "required": []
+  },
+  "uiHints": {
+    "healthCheckKey": { "label": "Health Check Key", "sensitive": true },
+    "dataDir": { "label": "Data Directory", "placeholder": ".noah-data" }
+  }
+}