life-my--midst--in

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Repository Overview

This is an implemented interactive CV/résumé system (in–midst–my-life) built around the Inverted Interview paradigm: an employer visits the candidate’s link, answers questions about their role and culture, and the system assembles a role-curated CV view from the candidate’s identity ledger. See docs/INVERTED-INTERVIEW.md for the full paradigm design.

The project has progressed from design documents to a working monorepo implementation with:

3 applications (Next.js frontend, Fastify backend API, Node.js orchestrator)
4 core packages (schema, content-model, core utilities, design-system)
PostgreSQL + Redis persistence layer with migration scripts
Compatibility engine with 5-factor scoring, role-family mapping, and mask resonance
Comprehensive test coverage via Vitest with integration test support

Project Structure

life-my--midst--in/
├── apps/
│   ├── web/              Next.js 16 UI dashboard (3000)
│   ├── api/              Fastify REST API (3001) - Profile CRUD, narrative endpoints, taxonomy
│   └── orchestrator/      Node.js worker service (3002) - Task queue, GitHub webhooks, agent execution
├── packages/
│   ├── schema/           Zod schemas & TypeScript types (identity, profiles, masks, epochs, stages)
│   ├── core/             Business logic (mask matching, crypto, job handling, VCs)
│   ├── content-model/    Narrative generation & JSON-LD transforms
│   └── design-system/    Shared UI primitives
├── infra/                Docker Compose, Helm charts, Dockerfiles, PaaS configs
├── scripts/              Dev utilities (dev-up.sh, dev-shell.sh, migrations)
└── docs/                 Architecture docs and security guidelines

Quick Commands

Workspace & Dependencies

# Install all dependencies (monorepo)
pnpm install

# Update a single package (e.g., Next.js)
pnpm update next

# Check workspace structure
pnpm list --depth=0

Build & Development

# Build all packages (respects Turbo dependency graph)
pnpm build

# Run all dev servers (web, API, orchestrator) in parallel
pnpm dev

# Watch-mode TypeScript checks
pnpm typecheck

# Lint entire monorepo
pnpm lint

Database & Services

# Spin up PostgreSQL + Redis via Docker Compose
scripts/dev-up.sh

# Open psql/redis-cli shell to dev services
scripts/dev-shell.sh

# Run API migrations (idempotent)
pnpm --filter @in-midst-my-life/api migrate

# Run orchestrator migrations (idempotent)
pnpm --filter @in-midst-my-life/orchestrator migrate

# Seed demo data into both services
pnpm --filter @in-midst-my-life/api seed
pnpm --filter @in-midst-my-life/orchestrator seed

Testing

# Run all unit tests
pnpm test

# Watch mode (auto-rerun on changes)
pnpm test:watch

# Run integration tests (requires INTEGRATION_POSTGRES_URL set)
pnpm integration

# Integration tests for specific service
pnpm --filter @in-midst-my-life/api integration
pnpm --filter @in-midst-my-life/orchestrator integration

# Generate coverage report (runs on CI only)
CI=true pnpm test

Single App/Package Tasks

# Run command in specific workspace
pnpm --filter @in-midst-my-life/schema build
pnpm --filter @in-midst-my-life/api dev
pnpm --filter @in-midst-my-life/web test

# Shorthand (if app name is unique)
pnpm --filter web dev
pnpm --filter api test
pnpm --filter orchestrator test:watch

Architecture Patterns

Schema-First Design

All data models are defined in packages/schema/ using Zod. This is the single source of truth:

identity.ts - Identity & personal thesis
profile.ts - Complete user profile
mask.ts - Identity masks (15+ types)
epoch.ts - Temporal periods
stage.ts - Career stages
narrative.ts - Narrative block structure
verification.ts - DID/VC related schemas

Consuming packages import types and validators from here.

Hexagonal Architecture (Ports & Adapters)

API (apps/api) follows hexagonal architecture:

src/validation/ - Input validators (request contracts)
src/services/ - Core business logic (no framework dependencies)
src/routes/ - Fastify route handlers (thin orchestration layer)
src/db/ - Repository pattern (abstracts Postgres)

Narrative Engine (Content Generation)

packages/content-model/ transforms profiles into different outputs:

Mask-filtered views (context-specific identity presentation)
JSON-LD exports (semantic web / LinkedIn consumption)
Narrative blocks with weighting (for LLM ranking)
Timeline rendering with epoch grouping

Mask System

Core matching logic in packages/core/maskMatching.ts:

Given contexts (tags, audience), rank available masks
Each mask filters/transforms profile data differently
Preserves identity invariants while changing presentation
15+ functional masks: Analyst, Synthesist, Artisan, Architect, etc.

Environment & Configuration

Development

# .env.local or environment variables
DATABASE_URL=postgresql://user:pass@localhost:5432/midst_dev
POSTGRES_URL=postgresql://user:pass@localhost:5432/midst_dev  # API specific
REDIS_URL=redis://localhost:6379
NODE_ENV=development

Integration Tests

# Use separate databases to avoid touching dev data
INTEGRATION_POSTGRES_URL=postgresql://user:pass@localhost:5432/midst_test
INTEGRATION_REDIS_URL=redis://localhost:6379/1

Database Names

Keep distinct databases per environment:

midst_dev - Development
midst_test - Unit/integration testing
midst_integration - CI environment
midst_prod - Production

Migrations are idempotent and safe to re-run across environments.

Code Quality Standards

TypeScript: Strict mode enforced (tsconfig.json):

No implicit any
No unused locals/parameters
No implicit returns
ESModuleInterop enabled

Linting: ESLint + Prettier (monorepo root config)

@typescript-eslint rules including strict async/await enforcement
Prettier for formatting consistency
Config: eslint.config.mjs (ESLint 9 flat config), .prettierrc

Testing: Vitest with coverage thresholds (vitest.config.ts)

75% statements, branches, functions, lines (global)
Higher thresholds encouraged for schema/core packages
Coverage enabled only on CI (CI=true)

File Size Limits (from docs/seed.yaml):

Max 1200 LOC per file
Max 200 LOC per function
Max cyclomatic complexity of 10

Module Boundaries

Allowed Imports

Apps can import from packages/*
packages/content-model, packages/core can import from packages/schema
Each package has defined public API (see index.ts exports)

Forbidden Imports

Apps cannot import from each other (web ↔ api ↔ orchestrator)
packages/schema cannot import from packages/content-model or packages/core
No direct DB access outside repository layer

API Contracts

Health & Metrics

GET /health - Returns { status: "ok" } JSON
GET /ready - Returns 200 if dependencies healthy
GET /metrics - Prometheus-format metrics (plain text)

Taxonomy Endpoints (all with pagination/filters)

GET /taxonomy/masks - List all identity masks
GET /taxonomy/epochs - List all temporal epochs
GET /taxonomy/stages - List all career stages

Profile Endpoints

GET /profiles/:id - Fetch complete profile
POST /profiles/:id/masks/select - Select mask context
POST /profiles/:id/narrative - Generate narrative blocks
GET /profiles/:id/export/jsonld - Semantic export
GET /profiles/:id/export/vc - Verifiable credential export
GET /profiles/:id/export/pdf - PDF resume

See apps/api/openapi.yaml for full contract.

Orchestrator Tasks

Worker service at :3002:

GET /tasks - List queued tasks
GET /tasks/:id/history - Task execution history
POST /webhooks/github - GitHub webhook ingestion
Task execution via worker loop (Redis-backed queue)

Docker Compose Stack

Full local development with infra/docker-compose.yml:

# Bring up all services (with migrations/seeds)
docker-compose -f infra/docker-compose.yml --profile init up

# Or step by step
docker-compose -f infra/docker-compose.yml up postgres redis
docker-compose -f infra/docker-compose.yml up api orchestrator
docker-compose -f infra/docker-compose.yml up web

Services:

postgres:5432 - Primary database
redis:6379 - Caching & task queue
api:3001 - Fastify server
orchestrator:3002 - Worker service
web:3000 - Next.js app (not in compose; run pnpm dev separately)

Integration Testing

Tests that touch real DB/Redis require INTEGRATION_* env vars:

Missing vars → integration tests skipped (safe for CI without external services)
Set vars → full integration tests run

Example:

# In CI/CD, either:
# 1. Skip integration (don't set INTEGRATION_* vars)
# 2. Run against test databases (set vars, use separate DBs)

INTEGRATION_POSTGRES_URL=postgresql://localhost/midst_test \
INTEGRATION_REDIS_URL=redis://localhost/1 \
  pnpm integration

Design Philosophy (from docs/seed.yaml)

Modular monorepo with these principles:

Schema-first: Lock data model before UI/business logic
Hexagonal architecture: Core logic independent from frameworks
Functional core, imperative shell: Pure functions in core packages, side effects at app boundaries
Repository pattern: Abstract data access behind interfaces
Dependency injection: Make dependencies explicit

Project Status

The project is feature-complete (65+ commits on master, zero open issues/PRs). All roadmap phases (0–7) plus API hardening, polish sprints, and dependency upgrades are done. See docs/CHANGELOG.md for full history.

Useful References

docs/seed.yaml - Repository “genome” with full constraints/standards
docs/MANIFEST.md - Complete file catalog
docs/archived/CONSOLIDATED-SPECIFICATIONS.md - Technical specs
docs/SECURITY.md - Security checklist for secrets/env isolation
README.md - User-facing project overview

Common Tasks

Adding a new API endpoint

Define request/response schemas in packages/schema/
Write service logic in apps/api/src/services/
Add route in apps/api/src/routes/
Add tests in apps/api/test/
Update apps/api/openapi.yaml

Modifying the profile schema

Edit packages/schema/src/profile.ts
Update content transformation in packages/content-model/src/narrative.ts
Update API seed data in apps/api/src/scripts/seed.ts
Run migrations if DB schema changes needed
Test: pnpm test (unit) + pnpm integration (with live DB)

Running a single test file

# From monorepo root
pnpm --filter @in-midst-my-life/api test -- src/services/maskMatching.test.ts

# From within app/package directory
cd apps/api && pnpm test -- src/services/maskMatching.test.ts

Debugging database issues

# Open interactive psql to dev database
scripts/dev-shell.sh

# View migration history
\d schema_migrations;

# Check current state
SELECT COUNT(*) FROM profiles;
SELECT * FROM masks LIMIT 5;

System Context (auto-generated — do not edit)

Organ: ORGAN-III (Commerce)	Tier: standard	Status: GRADUATED
Org: `organvm-iii-ergon`	Repo: `life-my--midst--in`

Edges

Produces → ORGAN-IV: product-artifact
Produces → organvm-vi-koinonia/community-hub: community_signal
Produces → organvm-vii-kerygma/social-automation: distribution_signal
Consumes ← ORGAN-IV: governance-rules

Siblings in Commerce

classroom-rpg-aetheria, gamified-coach-interface, trade-perpetual-future, fetch-familiar-friends, sovereign-ecosystem--real-estate-luxury, public-record-data-scrapper, search-local--happy-hour, multi-camera--livestream--framework, universal-mail--automation, mirror-mirror, the-invisible-ledger, enterprise-plugin, virgil-training-overlay, tab-bookmark-manager, a-i-chat--exporter … and 16 more

Governance

Strictly unidirectional flow: I→II→III. No dependencies on Theory (I).

Last synced: 2026-04-14T21:31:55Z

Active Handoff Protocol

If .conductor/active-handoff.md exists, READ IT FIRST before doing any work. It contains constraints, locked files, conventions, and completed work from the originating agent. You MUST honor all constraints listed there.

If the handoff says “CROSS-VERIFICATION REQUIRED”, your self-assessment will NOT be trusted. A different agent will verify your output against these constraints.

Session Review Protocol

At the end of each session that produces or modifies files:

Run organvm session review --latest to get a session summary
Check for unimplemented plans: organvm session plans --project .
Export significant sessions: organvm session export <id> --slug <slug>
Run organvm prompts distill --dry-run to detect uncovered operational patterns

Transcripts are on-demand (never committed):

organvm session transcript <id> — conversation summary
organvm session transcript <id> --unabridged — full audit trail
organvm session prompts <id> — human prompts only

System Library

Plans: 269 indexed | Chains: 5 available | SOPs: 121 active Discover: organvm plans search <query> | organvm chains list | organvm sop lifecycle Library: meta-organvm/praxis-perpetua/library/

Active Directives

Scope	Phase	Name	Description
system	any	atomic-clock	The Atomic Clock
system	any	execution-sequence	Execution Sequence
system	any	multi-agent-dispatch	Multi-Agent Dispatch
system	any	session-handoff-avalanche	Session Handoff Avalanche
system	any	system-loops	System Loops
system	any	prompting-standards	Prompting Standards
system	any	research-standards-bibliography	APPENDIX: Research Standards Bibliography
system	any	phase-closing-and-forward-plan	METADOC: Phase-Closing Commemoration & Forward Attack Plan
system	any	research-standards	METADOC: Architectural Typology & Research Standards
system	any	sop-ecosystem	METADOC: SOP Ecosystem — Taxonomy, Inventory & Coverage
system	any	autonomous-content-syndication	SOP: Autonomous Content Syndication (The Broadcast Protocol)
system	any	autopoietic-systems-diagnostics	SOP: Autopoietic Systems Diagnostics (The Mirror of Eternity)
system	any	background-task-resilience	background-task-resilience
system	any	cicd-resilience-and-recovery	SOP: CI/CD Pipeline Resilience & Recovery
system	any	community-event-facilitation	SOP: Community Event Facilitation (The Dialectic Crucible)
system	any	context-window-conservation	context-window-conservation
system	any	conversation-to-content-pipeline	SOP — Conversation-to-Content Pipeline
system	any	cross-agent-handoff	SOP: Cross-Agent Session Handoff
system	any	cross-channel-publishing-metrics	SOP: Cross-Channel Publishing Metrics (The Echo Protocol)
system	any	data-migration-and-backup	SOP: Data Migration and Backup Protocol (The Memory Vault)
system	any	document-audit-feature-extraction	SOP: Document Audit & Feature Extraction
system	any	dynamic-lens-assembly	SOP: Dynamic Lens Assembly
system	any	essay-publishing-and-distribution	SOP: Essay Publishing & Distribution
system	any	formal-methods-applied-protocols	SOP: Formal Methods Applied Protocols
system	any	formal-methods-master-taxonomy	SOP: Formal Methods Master Taxonomy (The Blueprint of Proof)
system	any	formal-methods-tla-pluscal	SOP: Formal Methods — TLA+ and PlusCal Verification (The Blueprint Verifier)
system	any	generative-art-deployment	SOP: Generative Art Deployment (The Gallery Protocol)
system	any	market-gap-analysis	SOP: Full-Breath Market-Gap Analysis & Defensive Parrying
system	any	mcp-server-fleet-management	SOP: MCP Server Fleet Management (The Server Protocol)
system	any	multi-agent-swarm-orchestration	SOP: Multi-Agent Swarm Orchestration (The Polymorphic Swarm)
system	any	network-testament-protocol	SOP: Network Testament Protocol (The Mirror Protocol)
system	any	open-source-licensing-and-ip	SOP: Open Source Licensing and IP (The Commons Protocol)
system	any	performance-interface-design	SOP: Performance Interface Design (The Stage Protocol)
system	any	pitch-deck-rollout	SOP: Pitch Deck Generation & Rollout
system	any	polymorphic-agent-testing	SOP: Polymorphic Agent Testing (The Adversarial Protocol)
system	any	promotion-and-state-transitions	SOP: Promotion & State Transitions
system	any	recursive-study-feedback	SOP: Recursive Study & Feedback Loop (The Ouroboros)
system	any	repo-onboarding-and-habitat-creation	SOP: Repo Onboarding & Habitat Creation
system	any	research-to-implementation-pipeline	SOP: Research-to-Implementation Pipeline (The Gold Path)
system	any	security-and-accessibility-audit	SOP: Security & Accessibility Audit
system	any	session-self-critique	session-self-critique
system	any	smart-contract-audit-and-legal-wrap	SOP: Smart Contract Audit and Legal Wrap (The Ledger Protocol)
system	any	source-evaluation-and-bibliography	SOP: Source Evaluation & Annotated Bibliography (The Refinery)
system	any	stranger-test-protocol	SOP: Stranger Test Protocol
system	any	strategic-foresight-and-futures	SOP: Strategic Foresight & Futures (The Telescope)
system	any	styx-pipeline-traversal	SOP: Styx Pipeline Traversal (The 7-Organ Transmutation)
system	any	system-dashboard-telemetry	SOP: System Dashboard Telemetry (The Panopticon Protocol)
system	any	the-descent-protocol	the-descent-protocol
system	any	the-membrane-protocol	the-membrane-protocol
system	any	theoretical-concept-versioning	SOP: Theoretical Concept Versioning (The Epistemic Protocol)
system	any	theory-to-concrete-gate	theory-to-concrete-gate
system	any	typological-hermeneutic-analysis	SOP: Typological & Hermeneutic Analysis (The Archaeology)
unknown	any	SOP-SS-ATM-001_001-atomic-decomposition	SOP-SS-ATM-001_001: Atomic Decomposition & Coverage Proof
unknown	any	SOP-SS-CLT-001_001-ontology_client_decisions	SOP-SS-CLT-001_001-ontology_client_decisions
unknown	any	SOP-SS-CNT-001_001-content-extraction-and-node-injection	SOP-SS-CNT-001_001: Content Extraction & Node Injection
unknown	any	SOP-SS-ISS-001-001-ontology-issue-specification	SOP-SS-ISS-001-001-ontology-issue-specification
unknown	any	SOP-SS-PRC-001_001-ontology_meta_process	SOP-SS-PRC-001-001-ontology-meta-process
unknown	any	SOP-SS-QAB-001_001-project-board-qa	SOP-SS-QAB-001_001-project-board-qa
unknown	any	SOP-SS-TRK-001_001-ontology_issue_tracking	SOP-SS-TRK-001_001-ontology_issue_tracking
unknown	any	registry	SOP Registry — Sovereign Systems

Linked skills: cicd-resilience-and-recovery, continuous-learning-agent, evaluation-to-growth, genesis-dna, multi-agent-workforce-planner, promotion-and-state-transitions, quality-gate-baseline-calibration, repo-onboarding-and-habitat-creation, structural-integrity-audit

Prompting (Anthropic): context 200K tokens, format: XML tags, thinking: extended thinking (budget_tokens)

Ecosystem Status

delivery: 2/2 live, 0 planned
revenue: 0/1 live, 1 planned
marketing: 0/3 live, 1 planned
community: 0/1 live, 0 planned
content: 0/2 live, 0 planned
listings: 0/1 live, 1 planned

Run: organvm ecosystem show life-my--midst--in organvm ecosystem validate --organ III

External Mirrors (Network Testament)

technical (5): eslint/eslint, prettier/prettier, microsoft/TypeScript, vitejs/vite, vitest-dev/vitest

Convergences: 20 Run: organvm network map --repo life-my--midst--in organvm network suggest

Entity Identity (Ontologia)

UID: ent_repo_01KKKX3RVNV2N0RS3YQ1XPSMZ0 Matched by: primary_name

Resolve: organvm ontologia resolve life-my--midst--in History: organvm ontologia history ent_repo_01KKKX3RVNV2N0RS3YQ1XPSMZ0

Live System Variables (Ontologia)

Variable	Value	Scope	Updated
`active_repos`	89	global	2026-04-14
`archived_repos`	54	global	2026-04-14
`ci_workflows`	107	global	2026-04-14
`code_files`	0	global	2026-04-14
`dependency_edges`	60	global	2026-04-14
`operational_organs`	10	global	2026-04-14
`published_essays`	29	global	2026-04-14
`repos_with_tests`	0	global	2026-04-14
`sprints_completed`	33	global	2026-04-14
`test_files`	0	global	2026-04-14
`total_organs`	10	global	2026-04-14
`total_repos`	145	global	2026-04-14
`total_words_formatted`	0	global	2026-04-14
`total_words_numeric`	0	global	2026-04-14
`total_words_short`	0K+	global	2026-04-14

Metrics: 9 registered	Observations: 32128 recorded
Resolve: `organvm ontologia status`	Refresh: `organvm refresh`

System Density (auto-generated)

AMMOI: 58%	Edges: 42	Tensions: 33	Clusters: 5	Adv: 23	Events(24h): 32336
Structure: 8 organs / 145 repos / 1654 components (depth 17)	Inference: 98%	Organs: META-ORGANVM:65%, ORGAN-I:53%, ORGAN-II:48%, ORGAN-III:54% +5 more
Last pulse: 2026-04-14T21:31:36	Δ24h: -1.0%	Δ7d: n/a

Dialect Identity (Trivium)

Dialect: EXECUTABLE_ALGORITHM

Classical Parallel: Arithmetic

Translation Role: The Engineering — proves that proofs compute

Strongest translations: I (formal), II (structural), VII (structural)

Scan: organvm trivium scan III <OTHER> Matrix: organvm trivium matrix Synthesize: organvm trivium synthesize

Logos Documentation Layer

Status: MISSING

Symmetry: 0.0 (VACUUM)

Nature demands a documentation counterpart. This formation maintains its narrative record in docs/logos/.

The Tetradic Counterpart

Telos (Idealized Form) — The dream and theoretical grounding.
Pragma (Concrete State) — The honest account of what exists.
Praxis (Remediation Plan) — The attack vectors for evolution.
Receptio (Reception) — The account of the constructed polis.

Alchemical I/O

Source & Transmutation — Narrative of inputs, process, and returns.

Compliance: Formation is currently void.

⚡ Conductor OS Integration

This repository is a managed component of the ORGANVM meta-workspace.

Orchestration: Use conductor patch for system status and work queue.
Lifecycle: Follow the FRAME -> SHAPE -> BUILD -> PROVE workflow.
Governance: Promotions are managed via conductor wip promote.
Intelligence: Conductor MCP tools are available for routing and mission synthesis.

This site is open source. Improve this page.