diff --git a/docs/ecosystem/README.md b/docs/ecosystem/README.md index 5cceb6a5..38411c99 100644 --- a/docs/ecosystem/README.md +++ b/docs/ecosystem/README.md @@ -26,6 +26,7 @@ Recommended structure: - [`ECOSYSTEM_MARKETPLACE_UNIFICATION.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/ECOSYSTEM_MARKETPLACE_UNIFICATION.md) — shared marketplace model - [`ECOSYSTEM_PERSONAL_TIMELINE_PRD.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/ECOSYSTEM_PERSONAL_TIMELINE_PRD.md) — unified user activity stream - [`PHASE1_TRANSCRIPT_NOTE_MEMORY_EXECUTION_PLAN.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/PHASE1_TRANSCRIPT_NOTE_MEMORY_EXECUTION_PLAN.md) — execution-ready plan for the first golden flow +- [`delegation/`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/delegation) — ready-to-send task packs and launcher lines for Saravana, Codex, Windsurf, and Cursor - [`adoption/`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/adoption) — per-product adoption notes Ownership model: diff --git a/docs/ecosystem/delegation/CODEX_PHASE1_INTEGRATION_REVIEW.md b/docs/ecosystem/delegation/CODEX_PHASE1_INTEGRATION_REVIEW.md new file mode 100644 index 00000000..7404f230 --- /dev/null +++ b/docs/ecosystem/delegation/CODEX_PHASE1_INTEGRATION_REVIEW.md @@ -0,0 +1,48 @@ +# Codex Phase 1 Integration Review + +> **Role:** Codex +> **Repo Lead:** cross-repo +> **Goal:** finish Phase 1 by reviewing delegated outputs, closing any contract drift, and recording final status + +## Scope + +- review NoteLett Phase 1 verification output +- review MindLyst Phase 1 verification output +- validate against: + - [`ECOSYSTEM_AGENT_OPERATING_MODEL.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/ECOSYSTEM_AGENT_OPERATING_MODEL.md) + - [`ECOSYSTEM_IMPLEMENTATION_TRACKER.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/ECOSYSTEM_IMPLEMENTATION_TRACKER.md) + - [`PHASE1_TRANSCRIPT_NOTE_MEMORY_EXECUTION_PLAN.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/PHASE1_TRANSCRIPT_NOTE_MEMORY_EXECUTION_PLAN.md) + - [`packages/events/src/ecosystem.ts`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/packages/events/src/ecosystem.ts) + +## Owned Work + +- final cross-repo review +- final event-lineage review +- final tracker/doc updates +- final end-to-end walkthrough assessment + +## Do Not Touch + +- unrelated product features +- Phase 2 implementation +- broad refactors outside the Phase 1 flow unless required to close a concrete bug + +## Review Checklist + +- artifact shapes still match shared contracts +- event causation and parent lineage are preserved +- no repo introduced contract drift +- verification evidence is real and recorded +- tracker reflects actual completion state + +## Expected Output + +- approve or reject delegated work +- apply any required integration fixes +- update tracker/docs with final evidence + +## Launch One-Liner + +```bash +git pull origin main && read /Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/delegation/CODEX_PHASE1_INTEGRATION_REVIEW.md and execute it exactly within its ownership boundaries +``` diff --git a/docs/ecosystem/delegation/CURSOR_MINDLYST_PHASE1_VERIFICATION.md b/docs/ecosystem/delegation/CURSOR_MINDLYST_PHASE1_VERIFICATION.md new file mode 100644 index 00000000..2dcd2034 --- /dev/null +++ b/docs/ecosystem/delegation/CURSOR_MINDLYST_PHASE1_VERIFICATION.md @@ -0,0 +1,56 @@ +# Cursor Task: MindLyst Phase 1 Verification + +> **Role:** Cursor +> **Repo:** `learning_multimodal_memory_agents` +> **Priority:** current Phase 1 blocker + +## Goal + +Finish the narrow MindLyst verification path for the note -> memory step so the Phase 1 flow is locally testable. + +## Owned Files And Modules + +- `mindlyst-native/web/src/lib/ecosystem-phase1.*` +- `mindlyst-native/web/src/app/api/memory/route.ts` +- `mindlyst-native/web/src/__tests__/api-memory.test.ts` +- minimal web test/tooling config only if required for this exact path + +## Do Not Touch + +- mobile/native app code +- unrelated product features +- shared ecosystem contracts in `learning_ai_common_plat` +- broad web toolchain churn unrelated to the Phase 1 path + +## Required Outcome + +- focused tests run for the Phase 1 memory import path +- `memory.entry.created` keeps upstream note-linked event causation when available +- latest memory event index persistence is covered +- any tooling fix stays minimal and local to this path + +## Verification + +Run the narrowest focused test command that proves the path works. Target files: + +- `mindlyst-native/web/src/lib/ecosystem-phase1.test.ts` +- `mindlyst-native/web/src/__tests__/api-memory.test.ts` + +Record the exact command and result. + +## Tracker Update + +If verification changes from blocked to verified, update: + +- [`ECOSYSTEM_IMPLEMENTATION_TRACKER.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/ECOSYSTEM_IMPLEMENTATION_TRACKER.md) +- [`PHASE1_TRANSCRIPT_NOTE_MEMORY_EXECUTION_PLAN.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/PHASE1_TRANSCRIPT_NOTE_MEMORY_EXECUTION_PLAN.md) + +## Review Gate + +Return the result to Codex for review before claiming completion. + +## Launch One-Liner + +```bash +git pull origin main && read /Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/delegation/CURSOR_MINDLYST_PHASE1_VERIFICATION.md and execute it exactly within its ownership boundaries +``` diff --git a/docs/ecosystem/delegation/README.md b/docs/ecosystem/delegation/README.md new file mode 100644 index 00000000..13f10442 --- /dev/null +++ b/docs/ecosystem/delegation/README.md @@ -0,0 +1,39 @@ +# Delegation Pack + +> Ready-to-send task files for Saravana, Codex, Windsurf, and Cursor. +> Use these files when assigning bounded ecosystem work to another coding agent. + +--- + +## Current Delegation Set + +- [`SARAVANA_COORDINATION.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/delegation/SARAVANA_COORDINATION.md) +- [`CODEX_PHASE1_INTEGRATION_REVIEW.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/delegation/CODEX_PHASE1_INTEGRATION_REVIEW.md) +- [`WINDSURF_NOTELETT_PHASE1_VERIFICATION.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/delegation/WINDSURF_NOTELETT_PHASE1_VERIFICATION.md) +- [`CURSOR_MINDLYST_PHASE1_VERIFICATION.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/delegation/CURSOR_MINDLYST_PHASE1_VERIFICATION.md) + +--- + +## Standard Launcher Pattern + +Give an agent a one-liner in this form: + +```bash +git pull origin main && read the task file at and execute it exactly within its ownership boundaries +``` + +Example: + +```bash +git pull origin main && read /Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/delegation/WINDSURF_NOTELETT_PHASE1_VERIFICATION.md and execute it exactly within its ownership boundaries +``` + +--- + +## Rules + +- task files must stay bounded +- task files must name owned files or modules +- task files must name do-not-touch boundaries +- task files must include verification expectations +- Codex reviews delegated outputs before ecosystem completion is claimed diff --git a/docs/ecosystem/delegation/SARAVANA_COORDINATION.md b/docs/ecosystem/delegation/SARAVANA_COORDINATION.md new file mode 100644 index 00000000..6eeb4795 --- /dev/null +++ b/docs/ecosystem/delegation/SARAVANA_COORDINATION.md @@ -0,0 +1,32 @@ +# Saravana Coordination Task + +> **Role:** Saravana +> **Purpose:** sequencing, approval, and merge authority for the current Phase 1 completion work + +## Goal + +Coordinate the final Phase 1 verification push without changing the technical contract. + +## Scope + +- confirm that Windsurf owns NoteLett verification +- confirm that Cursor owns MindLyst verification +- keep Codex as final reviewer for cross-repo completion +- decide when to stop Phase 1 and when to begin Phase 2 + +## Do Not Touch + +- shared artifact schema unless Codex recommends a contract change +- broad Phase 2 rollout before Phase 1 walkthrough is closed + +## Expected Output + +- clear approval on task ownership +- clear approval on merge order +- final signoff when Codex reports Phase 1 ready + +## Launch One-Liner + +```bash +git pull origin main && read /Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/delegation/SARAVANA_COORDINATION.md and use it as the current coordination brief +``` diff --git a/docs/ecosystem/delegation/WINDSURF_NOTELETT_PHASE1_VERIFICATION.md b/docs/ecosystem/delegation/WINDSURF_NOTELETT_PHASE1_VERIFICATION.md new file mode 100644 index 00000000..82aa91f5 --- /dev/null +++ b/docs/ecosystem/delegation/WINDSURF_NOTELETT_PHASE1_VERIFICATION.md @@ -0,0 +1,60 @@ +# Windsurf Task: NoteLett Phase 1 Verification + +> **Role:** Windsurf +> **Repo:** `learning_ai_notes` +> **Priority:** current Phase 1 blocker + +## Goal + +Finish the NoteLett verification path for the transcript -> note step so the Phase 1 flow is execution-verified, not just code-complete. + +## Owned Files And Modules + +- `backend/src/lib/ecosystem-phase1.*` +- `backend/src/modules/ecosystem-phase1/*` +- backend test/config files only if needed for this exact verification path + +## Do Not Touch + +- `web/` +- `mobile/` +- shared ecosystem contracts in `learning_ai_common_plat` +- unrelated NoteLett features + +## Required Outcome + +- backend Phase 1 import path runs locally +- focused tests cover: + - transcript artifact import + - note artifact creation + - `artifact.created` + - `artifact.linked` + - upstream event causation propagation +- no contract drift from `@bytelyst/events` + +## Verification + +Run the narrowest real command that proves the path works. Preferred: + +```bash +pnpm --filter @notelett/backend run test +``` + +If repo setup requires a narrower command, use it and record the exact command plus result. + +## Tracker Update + +If verification changes from blocked to verified, update: + +- [`ECOSYSTEM_IMPLEMENTATION_TRACKER.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/ECOSYSTEM_IMPLEMENTATION_TRACKER.md) +- [`PHASE1_TRANSCRIPT_NOTE_MEMORY_EXECUTION_PLAN.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/PHASE1_TRANSCRIPT_NOTE_MEMORY_EXECUTION_PLAN.md) + +## Review Gate + +Return the result to Codex for review before claiming completion. + +## Launch One-Liner + +```bash +git pull origin main && read /Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/delegation/WINDSURF_NOTELETT_PHASE1_VERIFICATION.md and execute it exactly within its ownership boundaries +```