coaiajs 0.3.0 → 0.3.2

package/src/types.ts

@@ -1,281 +0,0 @@
-// coaiajs/src/types.ts — Shared types
-// Union of coaia-narrative + coaia-pde + coaia-planning type systems
-
-// ─── Knowledge Graph Core ────────────────────────────────────────────
-
-export interface Entity {
-  name: string;
-  entityType: string;
-  observations: string[];
-  metadata?: EntityMetadata;
-}
-
-export interface EntityMetadata {
-  dueDate?: string;
-  chartId?: string;
-  phase?: 'germination' | 'assimilation' | 'completion';
-  completionStatus?: boolean;
-  parentChart?: string;
-  parentActionStep?: string;
-  level?: number;
-  createdAt?: string;
-  updatedAt?: string;
-  direction?: string;
-  confidence?: number;
-  implicit?: boolean;
-  pdeId?: string;
-  act?: number;
-  type_dramatic?: string;
-  universes?: string[];
-  timestamp?: string;
-  elementsOfPerformance?: Array<{ description: string; type: 'DESIGN' | 'EXECUTION' }>;
-  mmotEvaluations?: Array<{
-    phase: 'acknowledge' | 'analyze' | 'update' | 'recommit';
-    assessment: string;
-    direction?: 'South' | 'East' | 'West' | 'North';
-    timestamp: string;
-  }>;
-  relationalAlignment?: {
-    assessed: boolean;
-    score: number | null;
-    principles: string[];
-  };
-  fourDirections?: {
-    north_vision: string | null;
-    east_intention: string | null;
-    south_emotion: string | null;
-    west_introspection: string | null;
-  };
-  narrative?: {
-    description: string;
-    prose: string;
-    lessons: string[];
-  };
-  order?: number;
-}
-
-export interface Relation {
-  from: string;
-  to: string;
-  relationType: string;
-  metadata?: RelationMetadata;
-}
-
-export interface RelationMetadata {
-  createdAt?: string;
-  strength?: number;
-  context?: string;
-  description?: string;
-}
-
-export interface KnowledgeGraph {
-  entities: Entity[];
-  relations: Relation[];
-}
-
-export interface McpToolResult {
-  content: Array<{ type: string; text: string }>;
-  isError?: boolean;
-}
-
-// ─── PDE Types ───────────────────────────────────────────────────────
-
-export type Urgency = 'immediate' | 'session' | 'persistent';
-export type Direction = 'east' | 'south' | 'west' | 'north';
-
-export interface PrimaryIntent {
-  action: string;
-  target: string;
-  urgency: Urgency;
-  confidence: number;
-}
-
-export interface SecondaryIntent {
-  action: string;
-  target: string;
-  implicit: boolean;
-  dependency: string | null;
-  confidence: number;
-}
-
-export interface ContextRequirements {
-  files_needed: string[];
-  tools_required: string[];
-  assumptions: string[];
-}
-
-export interface ExpectedOutputs {
-  artifacts: string[];
-  updates: string[];
-  communications: string[];
-}
-
-export interface DirectionItem {
-  text: string;
-  confidence: number;
-  implicit: boolean;
-}
-
-export type DirectionMap = Record<Direction, DirectionItem[]>;
-
-export interface ActionItem {
-  text: string;
-  direction: Direction;
-  dependency: string | null;
-  completed?: boolean;
-}
-
-export interface AmbiguityFlag {
-  text: string;
-  suggestion: string;
-}
-
-export interface DecompositionResult {
-  primary: PrimaryIntent;
-  secondary: SecondaryIntent[];
-  context: ContextRequirements;
-  outputs: ExpectedOutputs;
-  directions: DirectionMap;
-  actionStack: ActionItem[];
-  ambiguities: AmbiguityFlag[];
-}
-
-export interface StoredDecomposition {
-  id: string;
-  timestamp: string;
-  prompt: string;
-  result: DecompositionResult;
-  options: DecompositionOptions;
-  markdownPath?: string;
-}
-
-export interface DecompositionOptions {
-  extractImplicit: boolean;
-  mapDependencies: boolean;
-}
-
-export interface PdeSession {
-  type: 'pde_session';
-  sessionId: string;
-  originalPrompt: string;
-  masterChartId: string;
-  pdeDecompositionId?: string;
-  createdAt: string;
-  updatedAt: string;
-  status: 'active' | 'completed' | 'abandoned';
-  metadata?: Record<string, unknown>;
-}
-
-export const URGENCY_DAYS: Record<string, number> = {
-  immediate: 1,
-  session: 7,
-  persistent: 30,
-};
-
-// ─── Plan Parser Types ───────────────────────────────────────────────
-
-export interface StructuralElement {
-  type: 'desired_outcome' | 'current_reality' | 'action_step' | 'observation';
-  content: string;
-  confidence: number;
-  sourceLines: { start: number; end: number };
-  telescopesInto?: StructuralTensionPlan;
-}
-
-export interface StructuralTensionPlan {
-  title: string;
-  filePath: string;
-  desiredOutcome: StructuralElement | null;
-  currentReality: StructuralElement | null;
-  actionSteps: StructuralElement[];
-  observations: string[];
-  metadata: {
-    parsedAt: string;
-    telescopeLevel: number;
-    parentAction?: string;
-    dueDate?: string;
-    completionStatus: 'pending' | 'in_progress' | 'completed';
-  };
-}
-
-// ─── Langfuse Types ──────────────────────────────────────────────────
-
-export interface ScoreCategory {
-  label: string;
-  value: number;
-}
-
-export interface ScoreConfig {
-  name: string;
-  dataType: 'NUMERIC' | 'CATEGORICAL' | 'BOOLEAN';
-  description?: string;
-  categories?: ScoreCategory[];
-  minValue?: number;
-  maxValue?: number;
-  isArchived?: boolean;
-}
-
-// ─── Pipeline Types ──────────────────────────────────────────────────
-
-export interface PipelineVariable {
-  name: string;
-  type: string;
-  required: boolean;
-  default?: string;
-  description?: string;
-  choices?: string[];
-}
-
-export interface PipelineStep {
-  name: string;
-  observationType: string;
-  description?: string;
-  parent?: string;
-  variables?: Record<string, string>;
-  metadata?: Record<string, unknown>;
-  conditional?: string;
-}
-
-export interface PipelineTemplate {
-  name: string;
-  version: string;
-  description: string;
-  author?: string;
-  createdAt?: string;
-  variables: PipelineVariable[];
-  steps: PipelineStep[];
-  extends?: string;
-  metadata?: Record<string, unknown>;
-}
-
-// ─── Config Types ────────────────────────────────────────────────────
-
-export interface CoaiaConfig {
-  redis?: {
-    url?: string;
-    host?: string;
-    port?: number;
-    password?: string;
-    ssl?: boolean;
-    upstashUrl?: string;
-    upstashToken?: string;
-  };
-  langfuse?: {
-    publicKey?: string;
-    secretKey?: string;
-    baseUrl?: string;
-  };
-  openai?: {
-    apiKey?: string;
-    model?: string;
-  };
-  aws?: {
-    accessKeyId?: string;
-    secretAccessKey?: string;
-    region?: string;
-  };
-  github?: {
-    token?: string;
-  };
-  [key: string]: unknown;
-}

package/src/version.ts

@@ -1,39 +0,0 @@
-// coaiajs/src/version.ts — single source of truth for the runtime version.
-// Reads package.json at runtime so the CLI banner, the MCP handshake, and the
-// published package can never drift apart again.
-
-import { readFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const PACKAGE_NAME = 'coaiajs';
-
-let cached: string | undefined;
-
-/** Resolved version of the installed `coaiajs` package. */
-export function getPackageVersion(): string {
-  if (cached) return cached;
-
-  const here = dirname(fileURLToPath(import.meta.url));
-  // dist/src/version.js -> package root is two levels up.
-  // src/version.ts (ts-node/tsx) -> package root is one level up.
-  const candidates = [join(here, '..', '..', 'package.json'), join(here, '..', 'package.json')];
-
-  for (const candidate of candidates) {
-    let raw: string;
-    try {
-      raw = readFileSync(candidate, 'utf8');
-    } catch {
-      continue; // not at this depth; try the next candidate
-    }
-    const pkg = JSON.parse(raw) as { name?: string; version?: string };
-    if (pkg.name === PACKAGE_NAME && pkg.version) {
-      cached = pkg.version;
-      return cached;
-    }
-  }
-
-  throw new Error(
-    `Unable to resolve ${PACKAGE_NAME} version: no package.json found near ${here}`,
-  );
-}

package/test/config.test.mjs

@@ -1,93 +0,0 @@
-import assert from 'node:assert/strict';
-import { mkdirSync, writeFileSync, mkdtempSync } from 'node:fs';
-import { join } from 'node:path';
-import { tmpdir } from 'node:os';
-import test from 'node:test';
-
-import { findEnvFiles, readConfig, resetConfig } from '../dist/src/config.js';
-
-const REDIS_ENV_KEYS = [
-  'COAIAJS_ENV_PATH',
-  'COAIAPY_ENV_PATH',
-  'UPSTASH_REDIS_REST_URL',
-  'UPSTASH_REDIS_REST_TOKEN',
-  'KV_REST_API_URL',
-  'KV_REST_API_TOKEN',
-  'KV_URL',
-  'REDIS_URL',
-  'REDIS_HOST',
-  'REDIS_PORT',
-  'REDIS_PASSWORD',
-  'REDIS_SSL',
-  'UPSTASH_HOST',
-  'UPSTASH_PASSWORD',
-];
-
-function withCleanEnv(fn) {
-  const originalEnv = {};
-  for (const key of REDIS_ENV_KEYS) {
-    originalEnv[key] = process.env[key];
-    delete process.env[key];
-  }
-  const originalHome = process.env.HOME;
-  const originalCwd = process.cwd();
-
-  try {
-    return fn();
-  } finally {
-    process.chdir(originalCwd);
-    process.env.HOME = originalHome;
-    for (const key of REDIS_ENV_KEYS) {
-      if (originalEnv[key] === undefined) {
-        delete process.env[key];
-      } else {
-        process.env[key] = originalEnv[key];
-      }
-    }
-    resetConfig();
-  }
-}
-
-test('loads ~/.coaia/.env when cwd .env is absent', () => withCleanEnv(() => {
-  const root = mkdtempSync(join(tmpdir(), 'coaiajs-env-'));
-  const home = join(root, 'home');
-  const project = join(root, 'project');
-  mkdirSync(join(home, '.coaia'), { recursive: true });
-  mkdirSync(project, { recursive: true });
-  writeFileSync(join(home, '.coaia', '.env'), 'REDIS_HOST=127.0.0.1\nREDIS_PORT=6388\n');
-
-  process.env.HOME = home;
-  process.chdir(project);
-
-  assert.deepEqual(findEnvFiles(), [join(home, '.coaia', '.env')]);
-  const cfg = readConfig();
-
-  assert.equal(cfg.redis?.host, '127.0.0.1');
-  assert.equal(cfg.redis?.port, 6388);
-}));
-
-test('keeps system env above dotenv files', () => withCleanEnv(() => {
-  const root = mkdtempSync(join(tmpdir(), 'coaiajs-env-priority-'));
-  mkdirSync(root, { recursive: true });
-  writeFileSync(join(root, '.env'), 'REDIS_HOST=from-file\nREDIS_PORT=6388\n');
-  process.chdir(root);
-  process.env.REDIS_HOST = 'from-system';
-
-  const cfg = readConfig();
-
-  assert.equal(cfg.redis?.host, 'from-system');
-  assert.equal(cfg.redis?.port, 6388);
-}));
-
-test('uses coaiapy-compatible Redis alias priority', () => withCleanEnv(() => {
-  process.env.UPSTASH_REDIS_REST_URL = 'https://upstash.example.com';
-  process.env.UPSTASH_REDIS_REST_TOKEN = 'upstash-token';
-  process.env.REDIS_URL = 'redis://redis.example.com:6380';
-  process.env.KV_URL = 'rediss://kv.example.com:6379';
-
-  const cfg = readConfig();
-
-  assert.equal(cfg.redis?.upstashUrl, 'https://upstash.example.com');
-  assert.equal(cfg.redis?.upstashToken, 'upstash-token');
-  assert.equal(cfg.redis?.url, 'rediss://kv.example.com:6379');
-}));

package/tsconfig.json

@@ -1,26 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "strict": true,
-    "esModuleInterop": true,
-    "outDir": "./dist",
-    "rootDir": ".",
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true
-  },
-  "include": [
-    "src/**/*",
-    "mcp/**/*"
-  ],
-  "exclude": [
-    "node_modules",
-    "dist",
-    "tests"
-  ]
-}