cial/cial
1
0
Fork 0
mirror of https://github.com/techforces-ai/Cial.git synced 2026-05-15 19:14:11 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
Upstream Cial — pull mirror of https://github.com/techforces-ai/Cial.git, syncs every 10m
71 commits 2 branches 0 tags 1.1 MiB
TypeScript 85.2%
JavaScript 5.5%
HTML 3.6%
SCSS 2.9%
Shell 1.9%
Other 0.9%
Find a file
Eliot M fd165fdea9 fix(dev-tenant): symlink project .claude/{skills,agents,commands} into harness HOME 
The Claude harness spawned by sessions/process/providers/claude.ts runs with
HOME=$CLAUDE_HOME (= /var/lib/cial/claude-home) and cwd=$HOME by default.
Slash-command discovery walks up from cwd looking for .claude/skills/, but
nothing under /var/lib/cial/... sees /workspace/.claude/. Result: skills
shipped in the repo (cial:self-edit, cial:build, cial:restart) appeared as
"Unknown command".

Entrypoint now symlinks the bind-mounted project .claude/* into the harness
HOME so they're discovered at the user level. Symlinks (not copies) so live
edits via the bind mount take effect on next session spawn without rebuild.
2026-04-29 11:08:22 +00:00
.claude/skills phase(6c): add cial:build + cial:restart skills, widen protocol restart targets 2026-04-29 10:49:42 +00:00
cial-app Await tenant reconcile during app-api boot 2026-04-26 15:31:25 +00:00
cial-core fix(dev-tenant): symlink project .claude/{skills,agents,commands} into harness HOME 2026-04-29 11:08:22 +00:00
cial-platform refactor(core-ui): structured package — components/lib/styles + SCSS bundle 2026-04-26 22:12:24 +00:00
docs phase(6c): self-edit/build/restart endpoints + --unrestricted dev mode 2026-04-29 10:46:13 +00:00
scripts phase(6c): self-edit/build/restart endpoints + --unrestricted dev mode 2026-04-29 10:46:13 +00:00
.editorconfig phase(1): scaffold all 10 workspace packages 2026-04-26 09:33:57 +00:00
.env.example phase(L1): docker compose + Postgres + Better-Auth owner signup 2026-04-26 11:17:53 +00:00
.gitignore Add pnpm dev:tenant — single-tenant native dev mode with hot reload 2026-04-26 15:40:56 +00:00
.nvmrc phase(1): scaffold all 10 workspace packages 2026-04-26 09:33:57 +00:00
.prettierignore phase(1): scaffold all 10 workspace packages 2026-04-26 09:33:57 +00:00
.prettierrc.json phase(1): scaffold all 10 workspace packages 2026-04-26 09:33:57 +00:00
docker-compose.yml phase(L5): SSO handoff app -> tenant Core 2026-04-26 12:26:41 +00:00
eslint.config.js phase(1): scaffold all 10 workspace packages 2026-04-26 09:33:57 +00:00
LICENSE phase(1): scaffold all 10 workspace packages 2026-04-26 09:33:57 +00:00
package.json Add pnpm dev:tenant — single-tenant native dev mode with hot reload 2026-04-26 15:40:56 +00:00
PHASE-5.md phase(5a): sessions schema + REST CRUD 2026-04-26 17:04:37 +00:00
PHASE-6.md phase(6a): supervisor selective-restart IPC + Phase 6 design spec 2026-04-27 00:12:50 +00:00
PLAN-LOCAL.md phase(L0): tenant container runs full Core + Platform stack 2026-04-26 10:46:16 +00:00
PLAN.md phase(1): scaffold all 10 workspace packages 2026-04-26 09:33:57 +00:00
pnpm-lock.yaml refactor(core-ui): structured package — components/lib/styles + SCSS bundle 2026-04-26 22:12:24 +00:00
pnpm-workspace.yaml phase(1): scaffold all 10 workspace packages 2026-04-26 09:33:57 +00:00
README.md phase(1): add pnpm smoke E2E harness 2026-04-26 09:48:48 +00:00
tsconfig.base.json phase(1): scaffold all 10 workspace packages 2026-04-26 09:33:57 +00:00
turbo.json phase(1): scaffold all 10 workspace packages 2026-04-26 09:33:57 +00:00

README.md

Cial

Closed Core. Editable Platform. One container per tenant. Multi-tenant App layer.

See PLAN.md for the build plan and /app/data/cial-production-infrastructure.md for the architecture rationale.

Repository layout

cial/
├─ cial-core/         CLOSED — the harness shipped as a Docker image to every tenant
│   ├─ back/          Express + WS · AI sessions · auth · git engine · vault · DB proxy
│   ├─ front/         Next.js · the rescue UI served at /.cial/*
│   ├─ sdk/           @cial/sdk    — Platform code talks to Core through this
│   ├─ protocol/      @cial/protocol — shared TS types + Zod schemas
│   └─ docker/        Multi-stage Dockerfile · two Linux users (cial + agent)
│
├─ cial-platform/     OPEN — starter cloned into /platform/ of every tenant container
│   ├─ front/         Next.js · the editable user-owned frontend
│   └─ back/          Node · the editable user-owned backend
│
└─ cial-app/          CLOSED — multi-tenant ops layer
    ├─ api/           Next.js · owner signup, billing, admin
    ├─ orchestrator/  Fly Machines provisioning
    ├─ router/        Subdomain → tenant Machine ID
    ├─ scheduler/     Central cron / trigger fabric
    └─ docker/        Dockerfile for App itself

Stack

  • Node 22 · pnpm 9 · turbo 2
  • TypeScript 5.7 strict · NodeNext
  • Express 4 (Core Back, Platform Back, App orchestrator)
  • Next.js 16 with Turbopack (Core Front, Platform Front, App api)
  • better-sqlite3 (per-tenant DB) · Postgres + Drizzle (App DB)
  • Better-Auth · Zod · pino
  • ESLint 9 (flat) · Prettier

Common commands

pnpm install              # install all workspace deps
pnpm dev                  # run everything in parallel
pnpm build                # build everything
pnpm typecheck            # tsc --noEmit across packages
pnpm lint                 # eslint
pnpm format               # prettier --write
pnpm smoke                # boot all 5 services on isolated ports + probe

Per-package:

pnpm --filter @cial/back dev
pnpm --filter @cial/platform-front build

Architecture conventions (Express services)

  • Modular layout: src/modules/<feature>/{routes,service,repository,schemas,types}.ts
  • Routes never touch the database
  • Services never touch Express (req/res)
  • Repositories never touch services (data access only)
  • Validation at the edge with Zod
  • Dependency injection by hand at src/index.ts
  • Centralized error middleware (last app.use)
  • Structured logs via pino · no console.log
  • Graceful shutdown on SIGTERM/SIGINT

Smoke harness

pnpm smoke boots every service on isolated high ports (18000–18100), polls each one until it responds, runs an HTTP probe matrix (health + a 501-stub envelope check on Core Back), then tears everything down. Exits 0 on success.

Service Port Probe
@cial/back 18080 /healthz → 200, /vault → 501 envelope
@cial/platform-back 18081 /health → 200
@cial/app-api 18100 /api/health → 200
@cial/front 18001 /.cial → 200
@cial/platform-front 18000 / → 200

Status

Scaffolding only. See PLAN.md for the phased implementation plan.