Go to file
saravanakumardb1 878c644dd8 feat(platform): wire shared platform packages into mobile + refactor web blob-client (DRY)
Phase 1 — Platform SDK integration:
- Mobile: added @bytelyst/telemetry-client, feature-flag-client, kill-switch-client, blob-client deps
- Mobile: created src/lib/platform.ts — centralized platform init (telemetry, flags, kill-switch, blob)
- Mobile: wired initPlatform() into root layout startup
- Web: refactored blob-client.ts to use shared @bytelyst/blob-client (eliminates hand-rolled SAS fetch code)
- Web: added @bytelyst/blob-client dep

DRY: Both web and mobile now use the same @bytelyst/blob-client package for blob operations.

Verification: web typecheck + mobile typecheck pass.
2026-03-10 19:29:00 -07:00
backend feat(mcp): add update-note, link-notes, extract-tasks, attach-artifact MCP tools 2026-03-10 18:53:28 -07:00
docs docs: add AGENTS.md, README.md, and update roadmap with session commit refs 2026-03-10 19:01:48 -07:00
mobile feat(platform): wire shared platform packages into mobile + refactor web blob-client (DRY) 2026-03-10 19:29:00 -07:00
shared feat(identity): lock NoteLett product identity across all surfaces 2026-03-10 18:47:01 -07:00
web feat(platform): wire shared platform packages into mobile + refactor web blob-client (DRY) 2026-03-10 19:29:00 -07:00
.gitignore fix(repo): restore web lint and ignore generated artifacts 2026-03-10 10:30:49 -07:00
AGENTS.md docs: add AGENTS.md, README.md, and update roadmap with session commit refs 2026-03-10 19:01:48 -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

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