bytelyst/learning_ai_notes
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
126 Commits 2 Branches 0 Tags 19 MiB
TypeScript 94.8%
Shell 3.9%
JavaScript 0.6%
CSS 0.4%
Dockerfile 0.2%
513ee5a6a5
Go to file
saravanakumardb1 513ee5a6a5 docs: comprehensive gap analysis — 29 numbered gaps across 5 categories 
Systematic audit of backend (7 modules, 24 tests), web (6 pages, 12
components, 6 tests), and mobile (4 tabs, 0 tests) against PRD.

Key findings:
- 5 bugs (extraction-client SSR crash, missing standalone output,
  N+1 queries, registration-only backend tests, tsconfig exclude)
- 8 missing features (no web note create, no import/export, no
  sharing, no summarization, no relationship UI, zero mobile tests)
- 5 DevOps gaps (no Dockerfiles, no docker-compose, no CI, no E2E)
- 5 code quality issues (duplicate types, mock-data leftovers, N+1)
- 2 documentation gaps (roadmap checklists not updated)

Includes 7-sprint prioritized implementation plan with estimates.
2026-03-19 06:56:24 -07:00
.github chore(docs): regenerate AI agent config files 2026-03-10 22:56:39 -07:00
backend fix(auth): JWKS URL-tracking singleton + expanded test coverage 2026-03-12 11:22:04 -07:00
docs docs: comprehensive gap analysis — 29 numbered gaps across 5 categories 2026-03-19 06:56:24 -07:00
mobile feat(mobile): wire review note input to inbox approve/reject 2026-03-10 19:41:39 -07:00
shared feat(identity): lock NoteLett product identity across all surfaces 2026-03-10 18:47:01 -07:00
web fix(web): wrap search + workspaces pages in Suspense for useSearchParams prerendering 2026-03-12 17:18:12 -07:00
.aider.conf.yml chore(docs): regenerate AI agent config files 2026-03-10 22:56:39 -07:00
.clinerules chore(docs): regenerate AI agent config files 2026-03-10 22:56:39 -07:00
.cursorrules chore(docs): regenerate AI agent config files 2026-03-10 22:56:39 -07:00
.editorconfig chore(docs): regenerate AI agent config files 2026-03-10 22:56:39 -07:00
.gitignore fix(repo): restore web lint and ignore generated artifacts 2026-03-10 10:30:49 -07:00
.windsurfrules chore(docs): regenerate AI agent config files 2026-03-10 22:56:39 -07:00
AGENTS.md docs: update AGENTS.md with api-helpers.ts and corrected test counts 2026-03-10 19:57:40 -07:00
CLAUDE.md chore(docs): regenerate AI agent config files 2026-03-10 22:56:39 -07:00
package-lock.json feat(notes): scaffold product surfaces and backend MCP slices 2026-03-10 08:53:07 -07:00
README.md docs: add AGENTS.md, README.md, and update roadmap with session commit refs 2026-03-10 19:01:48 -07:00

README.md

NoteLett

Structured notes platform for humans and AI agents — part of the ByteLyst ecosystem.

Quick Start

# Backend (port 4016)
cd backend && npm install && npm run dev

# Web (port 3000)
cd web && npm install && npm run dev -- --webpack

# Mobile
cd mobile && npm install && npm start

Architecture

Surface Stack Port
Backend Fastify 5 + TypeScript ESM 4016
Web Next.js 16 + React 19 3000
Mobile Expo + React Native 8081
Platform platform-service (shared) 4003
Extraction extraction-service (shared) 4005

Key Features

  • 6 backend modules: notes, workspaces, relationships, tasks, artifacts, agent actions
  • 8 MCP tools: list, get, search, create_draft, update, link_notes, extract_tasks, attach_artifact
  • Agent audit trail: every write tool records agent action history
  • Datastore abstraction: Cosmos DB in production, in-memory for tests
  • Platform integrations: auth (JWT), telemetry, diagnostics, feature flags, kill-switch, blob storage

Environment

Copy backend/.env.example to backend/.env and fill in:

  • JWT_SECRET — shared secret with platform-service
  • COSMOS_ENDPOINT / COSMOS_KEY — Azure Cosmos DB credentials (or use DB_PROVIDER=memory)

Tests

cd backend && npm test    # 18 tests (10 files)
cd web && npm test        # 6 tests (5 files)

Docs