Trajectory Core Service

# From repository root
cd services/trajectory-core

# Install dependencies
pnpm install

# Set up database
pnpm prisma generate
pnpm prisma migrate dev

# Seed with sample data (optional)
pnpm prisma db seed

# Start development server (with hot reload)
pnpm dev

# Server runs at http://localhost:3003

# Run all tests
pnpm test

# Run tests in watch mode
pnpm test:watch

# Run with coverage
pnpm test:coverage

# Build for production
pnpm build

# Run production build
pnpm start

trajectory-core/
├── src/
│   ├── domain/              # Core business logic (pure functions)
│   │   ├── types.ts         # TypeScript interfaces
│   │   ├── physics.ts       # Physics calculations (T, A, G, M, η)
│   │   └── skillGraph.ts    # Skill graph operations
│   │
│   ├── services/            # Application services
│   │   ├── LifeStateService.ts      # State management
│   │   ├── StateEstimator.ts        # State estimation & transitions
│   │   ├── SkillService.ts          # Skill graph CRUD
│   │   ├── ProjectService.ts        # Project management
│   │   ├── PlannerService.ts        # Scenario planning
│   │   ├── TransitionBuilder.ts     # State transition logic
│   │   └── UnifiedSearchService.ts  # Multi-dimensional search
│   │
│   ├── routes/              # Express route handlers
│   │   ├── state.ts         # /api/state/*
│   │   ├── skills.ts        # /api/skills/*
│   │   ├── projects.ts      # /api/projects/*
│   │   ├── physics.ts       # /api/physics/*
│   │   └── ragpp.ts         # /api/ragpp/*
│   │
│   ├── evaluation/          # Testing & quality assurance
│   │   ├── SampleDataGenerator.ts
│   │   ├── StateAwarenessEval.ts
│   │   └── RecommendationQualityEval.ts
│   │
│   ├── scripts/             # Utility scripts
│   │   └── ragpp-demo.ts    # RAG++ demonstration
│   │
│   └── index.ts             # Express server setup
│
├── prisma/
│   ├── schema.prisma        # Database schema
│   ├── migrations/          # Migration history
│   └── seed.ts              # Sample data seeding
│
├── tests/                   # Test files
│   ├── unit/
│   └── integration/
│
└── package.json

import { computeEscapeIndex, computeThrust } from './domain/physics';

// Compute thrust from skills and alignment
const thrust = computeThrust(
  skills,           // SkillBelief[]
  utilization,      // Map<skillId, utilizationRate>
  alignment,        // 0-1
  weights           // Optional skill weights
);

// Compute escape index
const eta = computeEscapeIndex(
  thrust,           // Productive power
  gravity,          // Environmental constraints
  mass              // System complexity
);

// η = T / (G × M)

model User {
  id        String   @id @default(cuid())
  email     String   @unique
  name      String
  createdAt DateTime @default(now())
}

model SkillBelief {
  id         String   @id @default(cuid())
  userId     String
  skillName  String
  level      Float    // 0-10
  confidence Float    // 0-1 (Bayesian confidence)
  evidence   String[] // Supporting evidence
  updatedAt  DateTime @updatedAt
}

model Project {
  id          String   @id @default(cuid())
  userId      String
  name        String
  description String
  status      ProjectStatus // active, paused, completed, archived
  alignment   Float    // Computed alignment score
  createdAt   DateTime @default(now())
}

model LifeState {
  id           String   @id @default(cuid())
  userId       String
  thrust       Float
  alignment    Float
  gravity      Float
  mass         Float
  escapeIndex  Float    // η
  regime       String   // falling, approaching, threshold, escaping, free
  timestamp    DateTime @default(now())
}

http://localhost:3003

# Database
DATABASE_URL="file:./dev.db"  # SQLite (dev)
# DATABASE_URL="postgresql://user:pass@localhost:5432/trajectoryos"  # PostgreSQL (prod)

# Server
PORT=3003
NODE_ENV=development

# Python ML Services (when available)
SKILL_MODEL_URL=http://localhost:5001
ALIGNMENT_MODEL_URL=http://localhost:5002
GRAVITY_MASS_URL=http://localhost:5003
LIFE_STATE_MODEL_URL=http://localhost:5004

# IRCP Service
IRCP_SERVICE_URL=http://localhost:8001

# Redis (optional, for caching)
REDIS_URL=redis://localhost:6379

# CORS
CORS_ORIGIN=http://localhost:3000

# Terminal 1: Start trajectory-core
cd services/trajectory-core
pnpm dev

# Terminal 2: Start web dashboard (optional)
cd apps/web
pnpm dev

# Terminal 3: Watch tests
cd services/trajectory-core
pnpm test:watch

# Create a new migration
pnpm prisma migrate dev --name descriptive_migration_name

# Reset database (⚠️ destroys data)
pnpm prisma migrate reset

# Open Prisma Studio (database GUI)
pnpm prisma studio
# Visit http://localhost:5555

# Lint
pnpm lint

# Format
pnpm format

# Type check
pnpm type-check

tests/
├── unit/
│   ├── physics.test.ts       # Pure physics functions
│   ├── skillGraph.test.ts    # Skill graph logic
│   └── stateEstimator.test.ts
│
├── integration/
│   ├── api.test.ts           # API endpoint tests
│   ├── database.test.ts      # Prisma operations
│   └── services.test.ts      # Service layer integration
│
└── e2e/
    └── scenarios.test.ts     # End-to-end user scenarios

# All tests
pnpm test

# Specific test file
pnpm test physics.test.ts

# With coverage
pnpm test:coverage

# Update snapshots
pnpm test -u

import { computeEscapeIndex } from '../src/domain/physics';

describe('Life Physics', () => {
  it('calculates escape index correctly', () => {
    const eta = computeEscapeIndex(
      10,  // thrust
      2,   // gravity
      5    // mass
    );

    expect(eta).toBe(1.0);  // 10 / (2 × 5) = 1.0
  });

  it('detects escaping regime', () => {
    const eta = computeEscapeIndex(15, 2, 5);  // 1.5
    const regime = interpretEscapeIndex(eta);

    expect(regime.status).toBe('free');
  });
});

# Build
pnpm build

# Output in dist/
ls dist/

# Run production server
NODE_ENV=production pnpm start

# Dockerfile included in service directory
FROM node:20-alpine
WORKDIR /app
COPY package.json pnpm-lock.yaml ./
RUN npm install -g pnpm && pnpm install --frozen-lockfile
COPY . .
RUN pnpm prisma generate && pnpm build
EXPOSE 3003
CMD ["pnpm", "start"]

docker build -t trajectoryos-core .
docker run -p 3003:3003 trajectoryos-core