@jungjaehoon/mama-os 0.18.2 → 0.19.0

package/dist/validation/types.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Validation Session Domain Types + Metric Profiles
+ *
+ * Shared observable validation model for agent execution.
+ * Every run path (delegate, agent_test, system_run, audit) feeds the same model.
+ */
+export type ExecutionStatus = 'started' | 'completed' | 'failed' | 'timeout';
+export type ValidationOutcome = 'healthy' | 'improved' | 'regressed' | 'inconclusive';
+export type ValidationTriggerType = 'agent_test' | 'delegate_run' | 'system_run' | 'audit';
+export interface ApiSnapshot {
+    agent?: {
+        enabled?: boolean;
+        version?: number;
+        display_name?: string;
+    };
+    activity?: {
+        count?: number;
+        latest_type?: string | null;
+        latest_score?: number | null;
+    };
+    summary?: {
+        consecutive_errors?: number;
+        error_rate?: number;
+    };
+}
+export interface CreateValidationSessionInput {
+    id: string;
+    agent_id: string;
+    agent_version: number;
+    trigger_type: ValidationTriggerType;
+    goal?: string;
+    metric_profile_json: string;
+    baseline_version?: number;
+    baseline_session_id?: string;
+    execution_status: ExecutionStatus;
+    validation_outcome: ValidationOutcome;
+    summary?: string;
+    recommendation?: string;
+    before_snapshot_json?: string | null;
+    after_snapshot_json?: string | null;
+    report_json?: string | null;
+    schema_version?: number;
+    requires_approval?: number;
+    started_at: number;
+    ended_at?: number;
+}
+export interface ValidationSessionRow {
+    id: string;
+    agent_id: string;
+    agent_version: number;
+    trigger_type: string;
+    goal: string | null;
+    metric_profile_json: string;
+    baseline_version: number | null;
+    baseline_session_id: string | null;
+    execution_status: string;
+    validation_outcome: string;
+    summary: string | null;
+    recommendation: string | null;
+    before_snapshot_json: string | null;
+    after_snapshot_json: string | null;
+    report_json: string | null;
+    schema_version: number;
+    requires_approval: number;
+    started_at: number;
+    ended_at: number | null;
+}
+export type MetricDirection = 'up_good' | 'down_good' | 'neutral';
+export interface SaveValidationMetricInput {
+    validation_session_id: string;
+    name: string;
+    value: number;
+    baseline_value?: number | null;
+    delta_value?: number | null;
+    direction: MetricDirection;
+}
+export interface ValidationMetricRow {
+    id: number;
+    validation_session_id: string;
+    name: string;
+    value: number;
+    baseline_value: number | null;
+    delta_value: number | null;
+    direction: string;
+    created_at: number;
+}
+export interface AgentValidationStateRow {
+    agent_id: string;
+    trigger_type: string;
+    approved_version: number | null;
+    approved_session_id: string | null;
+    current_status: string | null;
+    last_validation_at: number | null;
+    updated_at: number;
+}
+export interface UpdateValidationStateInput {
+    approved_version?: number;
+    approved_session_id?: string;
+    current_status?: string;
+    last_validation_at?: number;
+}
+export interface ValidationSessionDetail {
+    session: ValidationSessionRow;
+    metrics: ValidationMetricRow[];
+}
+export interface MetricThreshold {
+    warn: number;
+    critical: number;
+}
+export interface MetricProfile {
+    primary_metrics: string[];
+    thresholds: Record<string, MetricThreshold>;
+    directions?: Record<string, MetricDirection>;
+    extensions?: string[];
+}
+export declare function getMetricProfile(agentId: string): MetricProfile;
+export declare function guardJsonSize(json: string | undefined | null): string | null;
+export declare const SCHEMA_VERSION = 1;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/validation/types.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * Validation Session Domain Types + Metric Profiles
+ *
+ * Shared observable validation model for agent execution.
+ * Every run path (delegate, agent_test, system_run, audit) feeds the same model.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCHEMA_VERSION = void 0;
+exports.getMetricProfile = getMetricProfile;
+exports.guardJsonSize = guardJsonSize;
+const DEFAULT_METRIC_PROFILE = {
+    primary_metrics: ['duration_ms', 'token_cost', 'completion_rate'],
+    thresholds: {
+        duration_ms: { warn: 30_000, critical: 60_000 },
+        token_cost: { warn: 5_000, critical: 10_000 },
+    },
+};
+const WIKI_AGENT_METRIC_PROFILE = {
+    primary_metrics: [
+        'publish_latency_ms',
+        'token_cost',
+        'meaningless_run_rate',
+        'change_detection_rate',
+        'path_efficiency',
+    ],
+    thresholds: {
+        publish_latency_ms: { warn: 30_000, critical: 60_000 },
+        meaningless_run_rate: { warn: 0.3, critical: 0.5 },
+    },
+};
+const DASHBOARD_AGENT_METRIC_PROFILE = {
+    primary_metrics: ['briefing_latency_ms', 'token_cost', 'signal_to_noise', 'staleness'],
+    thresholds: {
+        briefing_latency_ms: { warn: 20_000, critical: 45_000 },
+        staleness: { warn: 0.4, critical: 0.7 },
+    },
+};
+const PROFILE_REGISTRY = {
+    'wiki-agent': WIKI_AGENT_METRIC_PROFILE,
+    'dashboard-agent': DASHBOARD_AGENT_METRIC_PROFILE,
+};
+function getMetricProfile(agentId) {
+    return PROFILE_REGISTRY[agentId] ?? DEFAULT_METRIC_PROFILE;
+}
+// ── JSON Size Guard ────────────────────────────────────────────────────────
+const MAX_JSON_BYTES = 50 * 1024; // 50KB
+function guardJsonSize(json) {
+    if (!json)
+        return null;
+    if (json.length > MAX_JSON_BYTES) {
+        return json.slice(0, MAX_JSON_BYTES);
+    }
+    return json;
+}
+exports.SCHEMA_VERSION = 1;
+//# sourceMappingURL=types.js.map

package/dist/validation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/validation/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA8KH,4CAEC;AAMD,sCAMC;AAjDD,MAAM,sBAAsB,GAAkB;IAC5C,eAAe,EAAE,CAAC,aAAa,EAAE,YAAY,EAAE,iBAAiB,CAAC;IACjE,UAAU,EAAE;QACV,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE;QAC/C,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE;KAC9C;CACF,CAAC;AAEF,MAAM,yBAAyB,GAAkB;IAC/C,eAAe,EAAE;QACf,oBAAoB;QACpB,YAAY;QACZ,sBAAsB;QACtB,uBAAuB;QACvB,iBAAiB;KAClB;IACD,UAAU,EAAE;QACV,kBAAkB,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE;QACtD,oBAAoB,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE;KACnD;CACF,CAAC;AAEF,MAAM,8BAA8B,GAAkB;IACpD,eAAe,EAAE,CAAC,qBAAqB,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,CAAC;IACtF,UAAU,EAAE;QACV,mBAAmB,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE;QACvD,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE;KACxC;CACF,CAAC;AAEF,MAAM,gBAAgB,GAAkC;IACtD,YAAY,EAAE,yBAAyB;IACvC,iBAAiB,EAAE,8BAA8B;CAClD,CAAC;AAEF,SAAgB,gBAAgB,CAAC,OAAe;IAC9C,OAAO,gBAAgB,CAAC,OAAO,CAAC,IAAI,sBAAsB,CAAC;AAC7D,CAAC;AAED,8EAA8E;AAE9E,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO;AAEzC,SAAgB,aAAa,CAAC,IAA+B;IAC3D,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,IAAI,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAEY,QAAA,cAAc,GAAG,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jungjaehoon/mama-os",
-  "version": "0.18.2",
+  "version": "0.19.0",
   "description": "MAMA OS - Local AI Runtime. Your scattered knowledge, organized by AI agents that never sleep.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -11,9 +11,9 @@
   },
   "scripts": {
     "postinstall": "node scripts/postinstall.js",
-    "build": "tsc && pnpm exec tsx scripts/generate-gateway-tools.ts && tsc -p public/viewer/tsconfig.viewer.json",
+    "build": "tsc && pnpm exec tsx scripts/generate-gateway-tools.ts && rm -rf public/viewer/js && tsc -p public/viewer/tsconfig.viewer.json",
     "build:watch": "tsc --watch",
-    "build:viewer": "tsc -p public/viewer/tsconfig.viewer.json",
+    "build:viewer": "rm -rf public/viewer/js && tsc -p public/viewer/tsconfig.viewer.json",
     "build:viewer:watch": "tsc -p public/viewer/tsconfig.viewer.json --watch",
     "test": "vitest run",
     "test:watch": "vitest watch",