This repository has been archived on 2026-11-17. You can view files and clone it, but cannot push or open issues or pull requests.
gitgram-ai/gitgram/docs/IMPLEMENTATION_PLAN.md
caelum0x 49b183818c Unify gitgram + aitimemachine into the monorepo (de-submodule) and merge vendored engines
Convert gitgram/ and aitimemachine/ from embedded git repos (which showed as
opaque submodule gitlinks on GitHub) into fully-tracked first-party content.

AITM now merges its 7 vendored repos as first-party engines:
- memory: beads (Go task DAG) + context7 (docs SDK), unified into saved_contexts
- git: vendored C git (bundled binary) + gitnexus (in-process code intelligence)
- agentic: a2a (@a2a-js/sdk) + pal (AITM-managed Python subprocess)

Includes the full session's product build: Gitgram web/mobile/backend features,
AITM website/CLI/MCP, the unified memory layer, engine build tooling
(scripts/build-engines.sh, Dockerfile, CI), docs (README, ENGINES.md, ARCHITECTURE.md),
and extensive test suites.

Build artifacts, node_modules, external/, and gemini-cli are gitignored.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-23 14:14:09 +03:00

12 KiB

Gitgram Implementation Plan

Executive Summary

Based on comprehensive codebase analysis, here's the prioritized implementation plan across Backend, Web, and Mobile.


Current State Overview

Platform Completeness Critical Gaps
Backend ~70% 30+ stubbed endpoints, missing CRUD operations
Web ~75% Account deletion, comment threading, notifications
Mobile ~55-60% Live streaming, scheduled posts, advanced search

Phase 9: Backend Critical Fixes

9.1 Stubbed Endpoints (HIGH PRIORITY)

File: src/controllers/authController.ts

Endpoint Status Action
forgotPassword() Stub Implement email flow
resetPassword() Stub Implement token validation
verifyEmail() Stub Implement verification logic
googleAuth() Stub Implement OAuth

File: src/controllers/userController.ts

Endpoint Status Action
switchAccount() 501 Implement account switching
linkAccount() 501 Add LinkedAccount model
unlinkAccount() 501 Implement unlinking
updateInterests() Incomplete Add interests field

9.2 Missing CRUD Operations

Comments

POST   /api/v1/posts/:id/comments/:commentId/like   - Like comment
PUT    /api/v1/posts/:id/comments/:commentId        - Update comment
DELETE /api/v1/posts/:id/comments/:commentId        - Delete comment

Messages

PUT    /api/v1/messages/:id          - Edit message
DELETE /api/v1/messages/:id          - Delete message
POST   /api/v1/messages/:id/report   - Report message
POST   /api/v1/chats/:id/members     - Add member to group
DELETE /api/v1/chats/:id/members/:userId - Remove member
DELETE /api/v1/chats/:id             - Delete chat

Stories

PUT    /api/v1/stories/:id           - Update story
POST   /api/v1/stories/:id/archive   - Archive story
GET    /api/v1/stories/:id/viewers   - Get story viewers

Reels

PUT    /api/v1/reels/:id             - Update reel
POST   /api/v1/reels/:id/share       - Share reel
POST   /api/v1/reels/:id/report      - Report reel

Scheduled Posts

GET    /api/v1/scheduled-posts       - List scheduled posts
GET    /api/v1/scheduled-posts/:id   - Get single scheduled post
PUT    /api/v1/scheduled-posts/:id   - Update scheduled post
DELETE /api/v1/scheduled-posts/:id   - Cancel scheduled post

Repositories

PUT    /api/v1/repositories/:owner/:name         - Update repository
DELETE /api/v1/repositories/:owner/:name         - Delete repository
GET    /api/v1/repositories/:owner/:name/followers - Get followers
POST   /api/v1/repositories/:owner/:name/bookmark  - Bookmark repo
DELETE /api/v1/repositories/:owner/:name/bookmark  - Remove bookmark

9.3 Missing Services Exposure

Service File Action
Content Insights contentInsightsService.ts Create routes
Data Export dataExportService.ts Create GDPR endpoints
AB Testing abTestingService.ts Create admin routes
GitHub Recommendations githubRecommendationService.ts Expose endpoints

9.4 New Backend Models Needed

// Add to schema.prisma

model LinkedAccount {
  id         String   @id @default(cuid())
  userId     String
  provider   String   // github, google
  providerId String
  email      String?
  createdAt  DateTime @default(now())

  user User @relation(fields: [userId], references: [id], onDelete: Cascade)

  @@unique([provider, providerId])
  @@index([userId])
}

model CommentLike {
  id        String   @id @default(cuid())
  commentId String
  userId    String
  createdAt DateTime @default(now())

  @@unique([commentId, userId])
}

model StoryArchive {
  id        String   @id @default(cuid())
  storyId   String
  userId    String
  createdAt DateTime @default(now())
}

model FollowRequest {
  id          String   @id @default(cuid())
  requesterId String
  targetId    String
  status      String   @default("pending") // pending, accepted, rejected
  createdAt   DateTime @default(now())

  @@unique([requesterId, targetId])
}

Phase 10: Web Critical Fixes

10.1 Account Management (HIGH PRIORITY)

Fix Account Deletion (/settings/account/page.tsx)

// Current: Shows toast "Account deletion not implemented"
// Needed: Full deletion flow with confirmation and data export option

Implement:

  • Confirmation modal with password verification
  • Data export before deletion option
  • 30-day grace period before permanent deletion
  • Email confirmation

10.2 Comment System Enhancement

Missing Features:

  • Comment threading/replies
  • Comment likes
  • Comment filtering (newest/top)
  • Comment pinning (for post author)
  • Comment editing/deletion

Files to modify:

  • components/Comments.tsx
  • app/post/[id]/comments/page.tsx
  • Add services/commentService.ts

10.3 Missing Pages to Create

Page Route Priority
Mutual Connections /users/mutual/[username] High
Follow Requests /requests High
Drafts /drafts Medium
Story Archive /archive/stories Medium
Content Appeal /appeal/[reportId] Medium
Creator Studio /creator Medium
Insights Detail /insights/[postId] Low

10.4 UI Component Gaps

Missing Components:

components/
├── MentionInput.tsx      # @mention autocomplete
├── HashtagInput.tsx      # #hashtag autocomplete
├── ImageEditor.tsx       # Crop, filters, adjustments
├── VideoTrimmer.tsx      # Trim, effects
├── CommentThread.tsx     # Threaded comments
├── FollowRequestCard.tsx # Accept/reject follow
├── DraftCard.tsx         # Draft post preview
└── InsightChart.tsx      # Detailed analytics charts

10.5 Real-time Features

WebSocket Integration Needed:

  • Live notification badge updates
  • Real-time comment updates
  • Typing indicators in DMs
  • Online status indicators

Phase 11: Mobile Critical Fixes

11.1 Missing Dependencies

# Install immediately
npm install @react-native-community/datetimepicker

11.2 Missing Screens

Screen Route Priority
Live Stream /(tabs)/live High
Scheduled Posts /(tabs)/scheduled High (needs datetime picker)
Code Snippets /(tabs)/snippets High
Help Center /help Medium
Terms/Privacy /legal Medium
Claim Repository /claim/[repo] Medium

11.3 State Management

Create Missing Stores:

// store/feedStore.ts
// store/postStore.ts
// store/messageStore.ts
// store/notificationStore.ts
// store/uiStore.ts

11.4 Push Notifications Enhancement

Missing:

  • Deep linking from notification tap
  • Notification action handling
  • Notification preferences UI
  • Notification sound customization

File: services/pushNotificationService.ts

// Add notification tap handler
Notifications.addNotificationResponseReceivedListener(response => {
  const { type, id } = response.notification.request.content.data;
  // Navigate to appropriate screen based on type
});

11.5 Feature Parity with Web

Feature Web Mobile Action
Google OAuth Yes No Implement
Advanced Search Yes Partial Add filters
Code Snippets Yes No Create screens
Data Export Yes No Add screen
Live Streaming Partial No Implement

Phase 12: Cross-Platform Improvements

12.1 API Consistency

Standardize Response Format:

interface APIResponse<T> {
  success: boolean;
  data?: T;
  error?: {
    code: string;
    message: string;
  };
  pagination?: {
    page: number;
    limit: number;
    total: number;
    hasMore: boolean;
  };
}

12.2 Shared Types

Create shared type definitions for:

  • User profiles
  • Posts/content
  • Notifications
  • API responses

12.3 Error Handling

Implement consistent error handling:

  • Backend: Structured error responses
  • Web: Error boundaries and toast notifications
  • Mobile: Error boundaries and alert dialogs

Implementation Priority Matrix

Immediate (Week 1-2)

Task Platform Impact
Fix account deletion Web Critical
Implement forgotPassword/resetPassword Backend Critical
Install datetime picker Mobile Critical
Comment CRUD operations Backend High

Short-term (Week 3-4)

Task Platform Impact
Comment threading Web + Backend High
Follow requests system All High
Push notification deep linking Mobile High
Message edit/delete Backend Medium

Medium-term (Week 5-8)

Task Platform Impact
Story archive All Medium
Code snippets mobile Mobile Medium
Creator studio Web Medium
Advanced search filters Mobile Medium

Long-term (Week 9+)

Task Platform Impact
Live streaming All High
Video editing Web + Mobile Medium
NFT integration All Low

File Changes Summary

Backend (New Files)

src/controllers/
├── commentActionsController.ts    # Comment likes, edit, delete
├── followRequestController.ts     # Follow request management
├── dataExportController.ts        # GDPR data export
├── linkedAccountController.ts     # Account linking
└── insightsController.ts          # Content insights

src/routes/
├── commentActions.ts
├── followRequests.ts
├── dataExport.ts
├── linkedAccounts.ts
└── insights.ts

Backend (Modified Files)

src/controllers/authController.ts      # Implement stubs
src/controllers/userController.ts      # Implement stubs
src/controllers/messageController.ts   # Add edit/delete
src/controllers/storiesController.ts   # Add update/archive
src/controllers/reelsController.ts     # Add update/share
src/routes/scheduledPosts.ts           # Add full CRUD
prisma/schema.prisma                   # Add new models

Web (New Files)

app/
├── requests/page.tsx              # Follow requests
├── drafts/page.tsx                # Draft posts
├── archive/stories/page.tsx       # Story archive
├── creator/page.tsx               # Creator studio
├── appeal/[reportId]/page.tsx     # Content appeal
└── users/mutual/[username]/page.tsx

components/
├── MentionInput.tsx
├── HashtagInput.tsx
├── ImageEditor.tsx
├── CommentThread.tsx
├── FollowRequestCard.tsx
└── DraftCard.tsx

services/
├── commentService.ts
├── followRequestService.ts
└── insightsService.ts

Mobile (New Files)

app/
├── (tabs)/live.tsx               # Live streaming
├── (tabs)/snippets.tsx           # Code snippets
├── scheduled.tsx                 # Scheduled posts
├── help.tsx                      # Help center
├── legal.tsx                     # Terms/Privacy
└── claim/[repo].tsx              # Claim repository

store/
├── feedStore.ts
├── postStore.ts
├── messageStore.ts
├── notificationStore.ts
└── uiStore.ts

components/
├── LiveStreamPlayer.tsx
├── SnippetCard.tsx
└── SchedulePostPicker.tsx

Estimated Effort

Phase Effort Duration
Phase 9 (Backend) High 2-3 weeks
Phase 10 (Web) Medium 2 weeks
Phase 11 (Mobile) Medium 2 weeks
Phase 12 (Cross-platform) Low 1 week

Total Estimated Time: 7-8 weeks for full implementation


Next Steps

  1. Review and approve this plan
  2. Set up task tracking (GitHub Issues/Projects)
  3. Begin with immediate priorities
  4. Weekly progress reviews