@ninebix/nmt-system 1.0.0

package/dist/src/cli/utils/formatters.d.ts

@@ -0,0 +1,51 @@
+/**
+ * CLI Formatters - Output formatting functions
+ */
+/**
+ * Format inference results
+ */
+export declare function formatInferenceResults(title: string, results: Array<{
+    neuronId?: string;
+    target?: {
+        id: string;
+    };
+    source?: {
+        id: string;
+    };
+    confidence: number;
+    path?: string[];
+    pathLength?: number;
+    explanation?: string;
+}>): string;
+/**
+ * Format causal chain
+ */
+export declare function formatCausalChain(chain: {
+    strength: number;
+    path: Array<{
+        neuronId: string;
+    }>;
+    links: Array<{
+        from: string;
+        to: string;
+        strength: number;
+    }>;
+}): string;
+/**
+ * Format bidirectional inference results
+ */
+export declare function formatBidirectionalResults(results: {
+    forward?: Array<{
+        neuronId: string;
+        confidence: number;
+    }>;
+    backward?: Array<{
+        neuronId: string;
+        confidence: number;
+    }>;
+}): string;
+/**
+ * Format section header
+ */
+export declare function formatHeader(title: string): string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/src/cli/utils/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/formatters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACxB,MAAM,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC,GAAG,MAAM,CAqBV;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9D,GAAG,MAAM,CAmBT;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D,GAAG,MAAM,CAuBT;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/src/cli/utils/formatters.js

@@ -0,0 +1,79 @@
+/**
+ * CLI Formatters - Output formatting functions
+ */
+/**
+ * Format inference results
+ */
+export function formatInferenceResults(title, results) {
+    let output = `${title}:\n`;
+    output += '='.repeat(60) + '\n';
+    if (!results || results.length === 0) {
+        output += '\n  No results found.\n';
+        return output;
+    }
+    for (let i = 0; i < results.length; i++) {
+        const r = results[i];
+        const targetId = r.neuronId ?? r.target?.id ?? r.source?.id ?? 'unknown';
+        output += `\n  #${i + 1} ${targetId}\n`;
+        output += `      Confidence: ${r.confidence.toFixed(4)}\n`;
+        output += `      Path Length: ${r.path?.length || r.pathLength || 1}\n`;
+        if (r.explanation) {
+            output += `      Explanation: ${r.explanation}\n`;
+        }
+    }
+    return output;
+}
+/**
+ * Format causal chain
+ */
+export function formatCausalChain(chain) {
+    let output = 'Causal Chain:\n';
+    output += '='.repeat(60) + '\n';
+    output += `\nTotal Strength: ${chain.strength.toFixed(4)}\n`;
+    output += `Chain Length: ${chain.path.length}\n\n`;
+    for (let i = 0; i < chain.path.length; i++) {
+        const node = chain.path[i];
+        const arrow = i < chain.path.length - 1 ? ' → ' : '';
+        output += `  ${node.neuronId}${arrow}`;
+        if ((i + 1) % 3 === 0)
+            output += '\n';
+    }
+    output += '\n\nCausal Links:\n';
+    for (const link of chain.links) {
+        output += `  ${link.from} → ${link.to} (strength: ${link.strength.toFixed(3)})\n`;
+    }
+    return output;
+}
+/**
+ * Format bidirectional inference results
+ */
+export function formatBidirectionalResults(results) {
+    let output = 'Bidirectional Inference Results:\n';
+    output += '='.repeat(60) + '\n';
+    output += '\nForward (Causes → Effects):\n';
+    if (results.forward && results.forward.length > 0) {
+        for (const r of results.forward.slice(0, 5)) {
+            output += `  → ${r.neuronId} (conf: ${r.confidence.toFixed(3)})\n`;
+        }
+    }
+    else {
+        output += '  (none)\n';
+    }
+    output += '\nBackward (Effects ← Causes):\n';
+    if (results.backward && results.backward.length > 0) {
+        for (const r of results.backward.slice(0, 5)) {
+            output += `  ← ${r.neuronId} (conf: ${r.confidence.toFixed(3)})\n`;
+        }
+    }
+    else {
+        output += '  (none)\n';
+    }
+    return output;
+}
+/**
+ * Format section header
+ */
+export function formatHeader(title) {
+    return `${title}:\n${'='.repeat(60)}\n`;
+}
+//# sourceMappingURL=formatters.js.map

package/dist/src/cli/utils/formatters.js.map

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

package/dist/src/cli/utils/helpers.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CLI Helpers - Utility functions for argument parsing
+ */
+import type { CommandResult, CommandConfig } from '../types.js';
+/**
+ * Extract numeric flag from arguments
+ */
+export declare function extractFlag(args: string[], flag: string, defaultValue: number): number;
+/**
+ * Extract string flag from arguments
+ */
+export declare function extractStringFlag(args: string[], flag: string, defaultValue: string): string;
+/**
+ * Check if flag exists in arguments
+ */
+export declare function hasFlag(args: string[], flag: string): boolean;
+/**
+ * Format output based on config (JSON or human-readable)
+ */
+export declare function formatOutput(result: CommandResult, config: CommandConfig): void;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/src/cli/utils/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhE;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAMtF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAM5F;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAc/E"}

package/dist/src/cli/utils/helpers.js

@@ -0,0 +1,51 @@
+/**
+ * CLI Helpers - Utility functions for argument parsing
+ */
+/**
+ * Extract numeric flag from arguments
+ */
+export function extractFlag(args, flag, defaultValue) {
+    const idx = args.indexOf(flag);
+    if (idx !== -1 && idx + 1 < args.length) {
+        return parseFloat(args[idx + 1]) || defaultValue;
+    }
+    return defaultValue;
+}
+/**
+ * Extract string flag from arguments
+ */
+export function extractStringFlag(args, flag, defaultValue) {
+    const idx = args.indexOf(flag);
+    if (idx !== -1 && idx + 1 < args.length) {
+        return args[idx + 1];
+    }
+    return defaultValue;
+}
+/**
+ * Check if flag exists in arguments
+ */
+export function hasFlag(args, flag) {
+    return args.includes(flag);
+}
+/**
+ * Format output based on config (JSON or human-readable)
+ */
+export function formatOutput(result, config) {
+    if (config.json) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        if (result.success) {
+            if (typeof result.data === 'string') {
+                console.log(result.data);
+            }
+            else if (result.data) {
+                console.log(result.data);
+            }
+        }
+        else {
+            console.error(`Error: ${result.error}`);
+        }
+    }
+}
+//# sourceMappingURL=helpers.js.map

package/dist/src/cli/utils/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../../src/cli/utils/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAc,EAAE,IAAY,EAAE,YAAoB;IAC5E,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACxC,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC;IACnD,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAc,EAAE,IAAY,EAAE,YAAoB;IAClF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,IAAc,EAAE,IAAY;IAClD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAqB,EAAE,MAAqB;IACvE,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;SAAM,CAAC;QACN,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACpC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;iBAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBACvB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,UAAU,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/cli/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * CLI Utils - Export all utility modules
+ */
+export { extractFlag, extractStringFlag, hasFlag, formatOutput, } from './helpers.js';
+export { formatInferenceResults, formatCausalChain, formatBidirectionalResults, formatHeader, } from './formatters.js';
+export { type ValidationError, type ValidationResult, type FieldValidator, type FieldSchema, type CommandSchema, isValidUUID, isValidNeuronId, numberInRange, isValidProbability, isValidStrength, isValidPriority, isPositiveInt, isNonEmptyString, isValidDate, validateSchema, validateArgs, validationError, missingArgError, neuronIdSchema, strengthSchema, prioritySchema, depthSchema, limitSchema, } from './validators.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/cli/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,0BAA0B,EAC1B,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,aAAa,EAElB,WAAW,EACX,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,WAAW,EAEX,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,EAEf,cAAc,EACd,cAAc,EACd,cAAc,EACd,WAAW,EACX,WAAW,GACZ,MAAM,iBAAiB,CAAC"}

package/dist/src/cli/utils/index.js

@@ -0,0 +1,13 @@
+/**
+ * CLI Utils - Export all utility modules
+ */
+export { extractFlag, extractStringFlag, hasFlag, formatOutput, } from './helpers.js';
+export { formatInferenceResults, formatCausalChain, formatBidirectionalResults, formatHeader, } from './formatters.js';
+export { 
+// Validators
+isValidUUID, isValidNeuronId, numberInRange, isValidProbability, isValidStrength, isValidPriority, isPositiveInt, isNonEmptyString, isValidDate, 
+// Functions
+validateSchema, validateArgs, validationError, missingArgError, 
+// Common schemas
+neuronIdSchema, strengthSchema, prioritySchema, depthSchema, limitSchema, } from './validators.js';
+//# sourceMappingURL=index.js.map

package/dist/src/cli/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cli/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,0BAA0B,EAC1B,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO;AAOL,aAAa;AACb,WAAW,EACX,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,WAAW;AACX,YAAY;AACZ,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe;AACf,iBAAiB;AACjB,cAAc,EACd,cAAc,EACd,cAAc,EACd,WAAW,EACX,WAAW,GACZ,MAAM,iBAAiB,CAAC"}

package/dist/src/cli/utils/validators.d.ts

@@ -0,0 +1,162 @@
+/**
+ * CLI Input Validation Utilities
+ *
+ * Provides schema-based validation for CLI command arguments.
+ * Ensures type safety and provides clear error messages.
+ *
+ * @module cli/utils/validators
+ */
+import type { CommandResult } from '../types.js';
+/**
+ * Validation error with field context
+ */
+export interface ValidationError {
+    field: string;
+    message: string;
+    value?: unknown;
+}
+/**
+ * Validation result
+ */
+export interface ValidationResult<T = Record<string, unknown>> {
+    valid: boolean;
+    errors: ValidationError[];
+    data?: T;
+}
+/**
+ * Field validator function type
+ */
+export type FieldValidator<T = unknown> = (value: unknown, fieldName: string) => {
+    valid: boolean;
+    error?: string;
+    value?: T;
+};
+/**
+ * Field schema definition
+ */
+export interface FieldSchema<T = unknown> {
+    required?: boolean;
+    type: 'string' | 'number' | 'boolean' | 'uuid' | 'embedding' | 'array';
+    min?: number;
+    max?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: RegExp;
+    enum?: T[];
+    default?: T;
+    validator?: FieldValidator<T>;
+    description?: string;
+}
+/**
+ * Command argument schema
+ */
+export type CommandSchema = Record<string, FieldSchema>;
+/**
+ * UUID format validator
+ */
+export declare const isValidUUID: FieldValidator<string>;
+/**
+ * Neuron ID validator (more permissive than UUID)
+ */
+export declare const isValidNeuronId: FieldValidator<string>;
+/**
+ * Numeric range validator factory
+ */
+export declare function numberInRange(min: number, max: number): FieldValidator<number>;
+/**
+ * Probability validator (0-1)
+ */
+export declare const isValidProbability: FieldValidator<number>;
+/**
+ * Strength validator (0-1)
+ */
+export declare const isValidStrength: FieldValidator<number>;
+/**
+ * Priority validator (1-10)
+ */
+export declare const isValidPriority: FieldValidator<number>;
+/**
+ * Positive integer validator
+ */
+export declare const isPositiveInt: FieldValidator<number>;
+/**
+ * Non-empty string validator
+ */
+export declare const isNonEmptyString: FieldValidator<string>;
+/**
+ * ISO8601 date validator
+ */
+export declare const isValidDate: FieldValidator<string>;
+/**
+ * Validate an object against a schema
+ *
+ * @param data - Object to validate
+ * @param schema - Schema to validate against
+ * @returns Validation result with errors or validated data
+ *
+ * @example
+ * ```typescript
+ * const schema = {
+ *   neuronId: { type: 'uuid', required: true },
+ *   strength: { type: 'number', min: 0, max: 1, default: 0.5 },
+ *   name: { type: 'string', minLength: 1, maxLength: 100 }
+ * };
+ *
+ * const result = validateSchema({ neuronId: 'abc123', strength: '0.8' }, schema);
+ * if (result.valid) {
+ *   console.log(result.data); // { neuronId: 'abc123', strength: 0.8 }
+ * } else {
+ *   console.log(result.errors);
+ * }
+ * ```
+ */
+export declare function validateSchema<T extends Record<string, unknown>>(data: Record<string, unknown>, schema: CommandSchema): ValidationResult<T>;
+/**
+ * Extract and validate arguments from CLI args array
+ *
+ * @param args - CLI argument array
+ * @param schema - Schema defining expected arguments
+ * @param positionalFields - Fields to extract positionally (in order)
+ * @returns Validation result
+ *
+ * @example
+ * ```typescript
+ * const schema = {
+ *   neuronId: { type: 'uuid', required: true },
+ *   depth: { type: 'number', min: 1, max: 20, default: 5 }
+ * };
+ *
+ * const result = validateArgs(['neuron-123', '--depth', '10'], schema, ['neuronId']);
+ * // result.data = { neuronId: 'neuron-123', depth: 10 }
+ * ```
+ */
+export declare function validateArgs(args: string[], schema: CommandSchema, positionalFields?: string[]): ValidationResult;
+/**
+ * Create a validation error CommandResult
+ */
+export declare function validationError(errors: ValidationError[]): CommandResult;
+/**
+ * Create a CommandResult for missing required argument
+ */
+export declare function missingArgError(argName: string, usage: string): CommandResult;
+/**
+ * Common schema for neuron ID argument
+ */
+export declare const neuronIdSchema: FieldSchema;
+/**
+ * Common schema for strength parameter
+ */
+export declare const strengthSchema: FieldSchema;
+/**
+ * Common schema for priority parameter
+ */
+export declare const prioritySchema: FieldSchema;
+/**
+ * Common schema for depth parameter
+ */
+export declare const depthSchema: FieldSchema;
+/**
+ * Common schema for limit parameter
+ */
+export declare const limitSchema: FieldSchema;
+//# sourceMappingURL=validators.d.ts.map

package/dist/src/cli/utils/validators.d.ts.map

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