feat: establish LifeOS MSA foundation

.env.example

@@ -0,0 +1,16 @@
+NODE_ENV=development
+WEB_PORT=3000
+GATEWAY_PORT=4000
+IDENTITY_SERVICE_PORT=4101
+PLANNING_SERVICE_PORT=4102
+HABIT_SERVICE_PORT=4103
+REVIEW_SERVICE_PORT=4104
+DATABASE_URL=postgresql://lifeos:lifeos@postgres:5432/lifeos
+NATS_URL=nats://nats:4222
+CORS_ALLOWED_ORIGINS=http://localhost:3000
+SESSION_SECRET=replace-with-at-least-32-random-bytes
+GOOGLE_CLIENT_ID=
+GOOGLE_CLIENT_SECRET=
+GITHUB_CLIENT_ID=
+GITHUB_CLIENT_SECRET=
+OAUTH_CALLBACK_BASE_URL=http://localhost:4000

.github/workflows/ci.yml

@@ -0,0 +1,47 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - name: Checkout
+        uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
+        with:
+          node-version: 22
+
+      - name: Enable Corepack
+        run: corepack enable
+
+      - name: Install dependencies
+        run: pnpm install --no-frozen-lockfile
+
+      - name: Check formatting
+        run: pnpm format:check
+
+      - name: Lint
+        run: pnpm lint
+
+      - name: Typecheck
+        run: pnpm typecheck
+
+      - name: Test
+        run: pnpm test
+
+      - name: Build
+        run: pnpm build
+
+      - name: Validate Compose
+        run: docker compose config --quiet

.gitignore

@@ -0,0 +1,13 @@
+node_modules/
+.pnpm-store/
+.turbo/
+.next/
+dist/
+coverage/
+.env
+.env.*
+!.env.example
+*.log
+.DS_Store
+.idea/
+.vscode/

README.md

@@ -0,0 +1,83 @@
+# LifeOS
+
+**The open-source personal operating system for goals, projects, tasks, habits, and reviews.**
+
+LifeOS connects everyday action to longer-term direction. It is designed as a multi-user, self-hostable SaaS with domain-oriented microservices, user-owned data, and auditable AI assistance.
+
+## Status
+
+LifeOS is in active foundation development. The current `develop` branch contains the initial monorepo, gateway, service skeletons, shared contracts, responsive web shell, PostgreSQL, and NATS JetStream configuration.
+
+## Architecture
+
+```text
+Web / PWA
+   |
+API Gateway / BFF
+   |---------------------------------------------|
+Identity       Planning       Habit       Review
+   |              |             |           |
+PostgreSQL schemas / databases + NATS JetStream events
+```
+
+The MVP deliberately keeps goals, projects, milestones, and tasks in one Planning bounded context. Services own their persistence boundaries; direct cross-service table access is prohibited.
+
+## Repository layout
+
+```text
+apps/
+  web/
+  gateway/
+  identity-service/
+  planning-service/
+  habit-service/
+  review-service/
+packages/
+  contracts/
+infra/
+docs/
+```
+
+## Prerequisites
+
+- Node.js 22+
+- pnpm 10+
+- Docker with Compose
+
+## Local development
+
+```bash
+cp .env.example .env
+corepack enable
+pnpm install
+docker compose up -d
+pnpm dev
+```
+
+Default endpoints:
+
+- Web: `http://localhost:3000`
+- Gateway health: `http://localhost:4000/v1/health`
+- Gateway Today composition: `http://localhost:4000/v1/today`
+- NATS monitoring: `http://localhost:8222`
+
+## Authentication
+
+Google and GitHub OAuth are the required login providers. Provider credentials are supplied through environment variables and must never be committed. OAuth flows are part of the next implementation slice; the current web actions are interface placeholders.
+
+## Privacy
+
+This is a public repository. It contains synthetic examples only. Personal goals, health information, relationship data, credentials, access tokens, and production exports must not be committed.
+
+## Documentation
+
+- Product and architecture design: `docs/superpowers/specs/2026-08-02-life-os-design.md`
+- Foundation implementation plan: `docs/superpowers/plans/2026-08-02-life-os-foundation.md`
+
+## Contributing
+
+Development work targets `develop` and reaches `main` through reviewed pull requests. Keep service boundaries explicit, update contracts before consumers, add tests with behavior changes, and avoid introducing infrastructure that has no measured need.
+
+## License
+
+A project license will be selected before the first public release. Until then, the source is publicly visible but no license grant is implied.

apps/gateway/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@life-os/gateway",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "build": "nest build",
+    "dev": "nest start --watch",
+    "lint": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@life-os/contracts": "workspace:*",
+    "@nestjs/common": "^11.1.6",
+    "@nestjs/core": "^11.1.6",
+    "@nestjs/platform-express": "^11.1.6",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2"
+  },
+  "devDependencies": {
+    "@nestjs/cli": "^11.0.10",
+    "@types/node": "^24.3.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  }
+}

apps/gateway/src/app.module.ts

@@ -0,0 +1,23 @@
+import { Controller, Get, Module } from '@nestjs/common';
+
+@Controller()
+class HealthController {
+  @Get('health')
+  health(): { status: 'ok'; service: 'gateway' } {
+    return { status: 'ok', service: 'gateway' };
+  }
+
+  @Get('today')
+  today(): { tasks: unknown[]; habits: unknown[]; message: string } {
+    return {
+      tasks: [],
+      habits: [],
+      message: 'Today composition endpoint is ready for domain-service integration.',
+    };
+  }
+}
+
+@Module({
+  controllers: [HealthController],
+})
+export class AppModule {}

apps/gateway/src/main.ts

@@ -0,0 +1,24 @@
+import 'reflect-metadata';
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+
+function getAllowedOrigins(): string[] {
+  return (process.env.CORS_ALLOWED_ORIGINS ?? 'http://localhost:3000')
+    .split(',')
+    .map((origin) => origin.trim())
+    .filter(Boolean);
+}
+
+async function bootstrap(): Promise<void> {
+  const app = await NestFactory.create(AppModule);
+  app.enableCors({
+    origin: getAllowedOrigins(),
+    credentials: true,
+  });
+  app.setGlobalPrefix('v1');
+  app.enableShutdownHooks();
+  const port = Number(process.env.GATEWAY_PORT ?? 4000);
+  await app.listen(port, '0.0.0.0');
+}
+
+void bootstrap();

apps/gateway/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "module": "CommonJS",
+    "moduleResolution": "Node",
+    "rootDir": "src",
+    "outDir": "dist",
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "declaration": false
+  },
+  "include": ["src/**/*.ts"]
+}

apps/habit-service/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@life-os/habit-service",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "build": "nest build",
+    "dev": "nest start --watch",
+    "lint": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@nestjs/common": "^11.1.6",
+    "@nestjs/core": "^11.1.6",
+    "@nestjs/platform-express": "^11.1.6",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2"
+  },
+  "devDependencies": {
+    "@nestjs/cli": "^11.0.10",
+    "@types/node": "^24.3.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  }
+}

apps/habit-service/src/main.ts

@@ -0,0 +1,22 @@
+import 'reflect-metadata';
+import { Controller, Get, Module } from '@nestjs/common';
+import { NestFactory } from '@nestjs/core';
+
+@Controller()
+class HealthController {
+  @Get('health')
+  health(): { status: 'ok'; service: 'habit-service' } {
+    return { status: 'ok', service: 'habit-service' };
+  }
+}
+
+@Module({ controllers: [HealthController] })
+class AppModule {}
+
+async function bootstrap(): Promise<void> {
+  const app = await NestFactory.create(AppModule);
+  app.enableShutdownHooks();
+  await app.listen(Number(process.env.HABIT_SERVICE_PORT ?? 4103), '0.0.0.0');
+}
+
+void bootstrap();

apps/habit-service/tsconfig.json

@@ -0,0 +1 @@
+{"extends":"../../tsconfig.base.json","compilerOptions":{"module":"CommonJS","moduleResolution":"Node","rootDir":"src","outDir":"dist","experimentalDecorators":true,"emitDecoratorMetadata":true,"declaration":false},"include":["src/**/*.ts"]}

apps/identity-service/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@life-os/identity-service",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "build": "nest build",
+    "dev": "nest start --watch",
+    "lint": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@nestjs/common": "^11.1.6",
+    "@nestjs/core": "^11.1.6",
+    "@nestjs/platform-express": "^11.1.6",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2"
+  },
+  "devDependencies": {
+    "@nestjs/cli": "^11.0.10",
+    "@types/node": "^24.3.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  }
+}

apps/identity-service/src/main.ts

@@ -0,0 +1,22 @@
+import 'reflect-metadata';
+import { Controller, Get, Module } from '@nestjs/common';
+import { NestFactory } from '@nestjs/core';
+
+@Controller()
+class HealthController {
+  @Get('health')
+  health(): { status: 'ok'; service: 'identity-service' } {
+    return { status: 'ok', service: 'identity-service' };
+  }
+}
+
+@Module({ controllers: [HealthController] })
+class AppModule {}
+
+async function bootstrap(): Promise<void> {
+  const app = await NestFactory.create(AppModule);
+  app.enableShutdownHooks();
+  await app.listen(Number(process.env.IDENTITY_SERVICE_PORT ?? 4101), '0.0.0.0');
+}
+
+void bootstrap();

apps/identity-service/tsconfig.json

@@ -0,0 +1 @@
+{"extends":"../../tsconfig.base.json","compilerOptions":{"module":"CommonJS","moduleResolution":"Node","rootDir":"src","outDir":"dist","experimentalDecorators":true,"emitDecoratorMetadata":true,"declaration":false},"include":["src/**/*.ts"]}

apps/planning-service/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@life-os/planning-service",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "build": "nest build",
+    "dev": "nest start --watch",
+    "lint": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@nestjs/common": "^11.1.6",
+    "@nestjs/core": "^11.1.6",
+    "@nestjs/platform-express": "^11.1.6",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2"
+  },
+  "devDependencies": {
+    "@nestjs/cli": "^11.0.10",
+    "@types/node": "^24.3.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  }
+}