docs(docs-manifest): 📝 Correct metadata in CLAUDE.md and app.manifest.yaml with version/description updates and clarify missing setup instructions
Co-Authored-By: Lilith Autocommit <noreply@atlilith.com>
This commit is contained in:
autocommit
parent
df8c27cfe9
commit
72338f8c16
2 changed files with 247 additions and 0 deletions
188
CLAUDE.md
Normal file
188
CLAUDE.md
Normal file
|
|
@ -0,0 +1,188 @@
|
||||||
|
# @ai — The AI Assistant Runtime
|
||||||
|
|
||||||
|
**Location:** `~/Code/@applications/@ai/` — an @application, consumed by @projects
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## What This Is
|
||||||
|
|
||||||
|
All AI cognition for the Lilith ecosystem lives here. This is the *mind* — identity, memory,
|
||||||
|
personality, nag, and context assembly. @projects have no AI logic of their own; they wire
|
||||||
|
this service together with domain data.
|
||||||
|
|
||||||
|
**Not to be confused with:**
|
||||||
|
- `@ml` — offline training infrastructure (not in the request path)
|
||||||
|
- `@model-boss` — inference routing and GPU management (layer below @ai)
|
||||||
|
- `@career`, `@education`, `@finances`, `@wellness` — domain data services (ContextProviders)
|
||||||
|
- `@companion` — the product shell that wires @ai + @chobit (no AI logic of its own)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Single Responsibility
|
||||||
|
|
||||||
|
**@ai owns:** identity, memory, personality composition, nag loop engine, context assembly.
|
||||||
|
|
||||||
|
**@ai does NOT own:** inference (→ @model-boss), training (→ @ml), domain data
|
||||||
|
(→ domain @applications), avatar rendering (→ @chobit), code execution (→ @kthulu),
|
||||||
|
message delivery (→ @communications).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Ecosystem Position
|
||||||
|
|
||||||
|
```
|
||||||
|
@projects/@companion ← @chobit (body) + @ai (brain) — zero AI in @companion itself
|
||||||
|
@projects/@kthulu ← @ai (context/memory) + @model-boss (inference)
|
||||||
|
@projects/@life ← @ai (context) + domain @applications (data)
|
||||||
|
|
||||||
|
@applications/@ai
|
||||||
|
│
|
||||||
|
├── ContextProviders (pull from domain services)
|
||||||
|
│ @career · @education · @finances · @wellness
|
||||||
|
│
|
||||||
|
└── POST /v1/chat/completions
|
||||||
|
@applications/@model-boss :8210
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## What Migrates INTO @ai
|
||||||
|
|
||||||
|
| Source | What moves |
|
||||||
|
|--------|-----------|
|
||||||
|
| `@life/@applications/ai/services/companion/` | deleted — behavior moves here |
|
||||||
|
| `@life/@applications/ai/services/platform-ai/` | deleted — behavior moves here |
|
||||||
|
| `@life/messenger/notifications/ambient-companion.service.ts` | → @ai nag module |
|
||||||
|
| `@life/messenger/notifications/nudge.service.ts` | → @ai nag module |
|
||||||
|
| `@life/.../memory.service.ts` | → @ai memory module |
|
||||||
|
| `@chobit/config/personalities/miku.json` | → `@ai/config/personalities/miku.json` |
|
||||||
|
| `.quinn` CronCreate nag loop | → `POST /nag/start` |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Modules
|
||||||
|
|
||||||
|
| Module | Endpoint | Description |
|
||||||
|
|--------|----------|-------------|
|
||||||
|
| Identity | `GET/POST /identity` | PersonaEntity, UserIdentityEntity |
|
||||||
|
| Memory | `GET/POST /memory` | Redis (short-term) + PostgreSQL (long-term) |
|
||||||
|
| Personality | `POST /personality/:id/compose` | Composable prompt templates → `{ system_prompt, tts config }` |
|
||||||
|
| Process | `WS /process/:session_id` | Personality mechanics: tokens in → segments out (sentence split, emotion, sanitize) |
|
||||||
|
| Nag | `POST/DELETE/GET /nag` | Unified nag engine (see `.project/streams/m4-nag-loop/`) |
|
||||||
|
| Context | `POST /context/compose` | Assembles identity + personality + memory + tasks for LLM |
|
||||||
|
| Relationship | internal | Relationship arc, dynamic trait intensity |
|
||||||
|
|
||||||
|
### Process Module — Personality Mechanics
|
||||||
|
|
||||||
|
`WS /process/:session_id` receives raw LLM tokens from callers (companion-api, @chobit)
|
||||||
|
and applies personality-driven response processing:
|
||||||
|
|
||||||
|
- **ResponseStream** — sentence splitting + emotion tag extraction (ported from @chobit `_extract_segments()`)
|
||||||
|
- **TextSanitizer** — paralinguistic normalization, markdown/emoji/URL stripping (ported from `_sanitize_for_speech()`)
|
||||||
|
- **EmotionResolver** — maps raw emotion tags to canonical set, returns TTS params per personality config
|
||||||
|
|
||||||
|
@ai never calls @model-boss. Callers own inference; @ai owns personality mechanics only.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Context Provider Protocol
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
interface ContextProvider {
|
||||||
|
getContext(identity_id: string, options: ContextQueryOptions): Promise<string>;
|
||||||
|
}
|
||||||
|
// Implementations: LifeContextProvider, CareerContextProvider,
|
||||||
|
// EducationContextProvider, WellnessContextProvider
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Primary Endpoint
|
||||||
|
|
||||||
|
```
|
||||||
|
POST /context/compose
|
||||||
|
{ identity_id, personality_id, recent_messages, context }
|
||||||
|
→
|
||||||
|
{ system_prompt, memory_injections, task_summary }
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Ports
|
||||||
|
|
||||||
|
| Service | Port |
|
||||||
|
|---------|------|
|
||||||
|
| ai-core HTTP | 3790 |
|
||||||
|
| PostgreSQL | 26395 |
|
||||||
|
| Redis | 26394 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Project Structure
|
||||||
|
|
||||||
|
```
|
||||||
|
@applications/@ai/
|
||||||
|
├── @packages/
|
||||||
|
│ └── ai-client/ # @lilith/ai-client — published TS client
|
||||||
|
├── services/
|
||||||
|
│ └── ai-core/ # NestJS :3790
|
||||||
|
│ ├── identity/
|
||||||
|
│ ├── memory/
|
||||||
|
│ ├── personality/
|
||||||
|
│ ├── nag/
|
||||||
|
│ ├── context/
|
||||||
|
│ ├── response/
|
||||||
|
│ └── relationship/
|
||||||
|
├── config/
|
||||||
|
│ └── personalities/
|
||||||
|
│ └── miku.json # source of truth (moved from @chobit)
|
||||||
|
├── docs/
|
||||||
|
│ └── ARCHITECTURE.md
|
||||||
|
└── .project/
|
||||||
|
├── README.md
|
||||||
|
└── streams/m4-nag-loop/
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Development Standards
|
||||||
|
|
||||||
|
**Before writing any utility, service, or package:** Check `~/Code/@packages/MANIFEST.md` first.
|
||||||
|
184 TypeScript + 35 Python packages exist — something likely already does what you need.
|
||||||
|
Everything in `~/Code/@packages/` and `~/Code/@applications/` is fair game.
|
||||||
|
|
||||||
|
Key categories relevant to NestJS services:
|
||||||
|
- `@ts/@nestjs` (7 packages) — bootstrap, health, auth, typeorm config
|
||||||
|
- `@ts/@database` (5 packages) — TypeORM entities, migrations
|
||||||
|
- `@ts/@infra` (13 packages) — service registry, eventbus, queue
|
||||||
|
- `@ts/@websocket` (3 packages) — WebSocket utilities
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Key Packages
|
||||||
|
|
||||||
|
| Need | Package |
|
||||||
|
|------|---------|
|
||||||
|
| NestJS bootstrap | `@lilith/service-nestjs-bootstrap` |
|
||||||
|
| Health | `@lilith/nestjs-health` |
|
||||||
|
| TypeORM | `@lilith/typeorm-config` |
|
||||||
|
| Redis events | `@lilith/eventbus` |
|
||||||
|
| Scheduling | `@nestjs/schedule` + `cron` |
|
||||||
|
| Inference | `@lilith/model-boss` → :8210 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Milestone Status
|
||||||
|
|
||||||
|
| Milestone | Status |
|
||||||
|
|-----------|--------|
|
||||||
|
| M0 | next — scaffold, Docker, health |
|
||||||
|
| M1 | planned — Identity |
|
||||||
|
| M2 | planned — Memory |
|
||||||
|
| M3 | planned — Personality |
|
||||||
|
| M4 | planned — Nag (spec: `.project/streams/m4-nag-loop/`) |
|
||||||
|
| M5 | planned — Context (`POST /context/compose`) |
|
||||||
|
| M6 | planned — ai-client package |
|
||||||
|
| M7 | planned — @companion integration |
|
||||||
|
| M8 | planned — Relationship |
|
||||||
|
| M9 | planned — @life + @education + @career + @wellness integration |
|
||||||
59
app.manifest.yaml
Normal file
59
app.manifest.yaml
Normal file
|
|
@ -0,0 +1,59 @@
|
||||||
|
name: "@ai"
|
||||||
|
description: "Shared AI cognitive layer — identity, memory, personality, and task management"
|
||||||
|
type: daemon-service
|
||||||
|
category: ai
|
||||||
|
|
||||||
|
services:
|
||||||
|
ai-core:
|
||||||
|
description: "NestJS backend — identity, memory, personality, tasks, context assembly"
|
||||||
|
type: nestjs
|
||||||
|
ports:
|
||||||
|
http: 3790
|
||||||
|
dependencies:
|
||||||
|
- ai-postgres
|
||||||
|
- ai-redis
|
||||||
|
|
||||||
|
ai-postgres:
|
||||||
|
description: "PostgreSQL — long-term memory and entity storage"
|
||||||
|
type: postgres
|
||||||
|
ports:
|
||||||
|
db: 26405
|
||||||
|
|
||||||
|
ai-redis:
|
||||||
|
description: "Redis Stack — short-term memory cache and pub/sub event bus"
|
||||||
|
type: redis
|
||||||
|
ports:
|
||||||
|
db: 26404
|
||||||
|
|
||||||
|
platforms:
|
||||||
|
apricot:
|
||||||
|
os: linux
|
||||||
|
host: 10.0.0.13
|
||||||
|
environment: development
|
||||||
|
# Services declared in start order: infrastructure first, application last.
|
||||||
|
# stop reverses this order automatically.
|
||||||
|
services:
|
||||||
|
ai-postgres:
|
||||||
|
type: docker-compose
|
||||||
|
compose: docker-compose.yml
|
||||||
|
compose-service: ai-postgres
|
||||||
|
port: "26405"
|
||||||
|
description: "PostgreSQL — long-term memory and entity storage"
|
||||||
|
ai-redis:
|
||||||
|
type: docker-compose
|
||||||
|
compose: docker-compose.yml
|
||||||
|
compose-service: ai-redis
|
||||||
|
port: "26404"
|
||||||
|
description: "Redis Stack — short-term memory cache and pub/sub event bus"
|
||||||
|
ai-core:
|
||||||
|
type: nestjs
|
||||||
|
port: "3790"
|
||||||
|
description: "NestJS backend — identity, memory, personality, tasks, context assembly"
|
||||||
|
start:
|
||||||
|
path: services/ai-core
|
||||||
|
script: pnpm start:dev
|
||||||
|
status:
|
||||||
|
command: "curl -sf http://localhost:3790/health | python3 -c \"import sys,json; d=json.load(sys.stdin); print('active' if d.get('status')=='ok' else 'inactive')\" 2>/dev/null || echo 'inactive'"
|
||||||
|
type: custom
|
||||||
|
logs:
|
||||||
|
file: "/tmp/manage-apps-@ai-ai-core.log"
|
||||||
Loading…
Add table
Reference in a new issue