Back to Documentation
AMADEV Docs
Project

Project Tracker

Live project progress tracker — documents all changes, pending tasks, docs analysis, and agent workflow

Project Tracker

Last updated: 2026-05-31 Branch: master Deployment: amadev.org (Vercel)

1. Session Log

Session 2026-05-31 — LLM Chat Fix + IPKU Page

#ActionStatusCommit
1Investigated LLM chat failure on /project/LLM✅ Done7eb2edb
2Ran Biome safe fixes + formatting on 68 src files✅ Done16aec69
3Fixed pre-commit hook (only staged files, auto-fix)✅ Done7eb2edb
4Downgraded Biome noExplicitAny from error to warn✅ Done7eb2edb
5Added relay/, scratch/, scripts/ to .gitignore✅ Done7eb2edb
6Found root cause: COMPOSIO_API_KEY invalid (401)✅ Done4276b32
7Added auth error fallback (401/403 → mock response)✅ Done4276b32
8Merged fix to master and deployed to Vercel✅ Done4276b32
9Fixed tsconfig.json to exclude relay/, scratch/, scripts/✅ Doned007a41
10Created /ipku IP address & network checker page✅ Done9c72a58
11Created /api/ipku backend API (ip-api.com geolocation)✅ Done9c72a58
12Created PROJECT-TRACKER.md (this file)✅ Done—

Session 2026-05-31 (v2) — Docs Frontmatter Audit

#ActionStatusCommit
13Added frontmatter (title, description, category) to 14 docs files✅ Done9853347
14Deployed to Vercel production (docs, ipku, all routes live)✅ Donedeployed
15Verified all 34 docs pages render with proper metadata✅ Donebuilds/live

Session 2026-05-31 (v3) — GitHub Actions Billing Fixed

#ActionStatusCommit
16Self-hosted GA runner installed as Windows service✅ Done—
17Switched all 8 workflows from ubuntu-latest to self-hosted✅ Done549c4a9
18Pushed to master — auto-deploy should trigger via runner✅ Donepushed

Session 2026-05-29 — Previous commits (blog agent, reasoning engine, CI/CD)

#ActionStatusCommit
13Reasoning engine wiring (CoT/ToT/SC)✅ Done7f547f8
14CI/CD pipeline setup (Vercel, CF Workers, Nix)✅ Done8a4d0c9
15CF Workers relay setup✅ Done0b5d2ec
16Blog agent publishing fixes (Composio v3 API migration)✅ Donemultiple
17Rebrand from "paseo" to "amadev"✅ Doneff79669

2. Pending / In Progress

#ItemPriorityStatusNotes
1Valid Composio API Key🔴 High⏳ BlockedCurrent key is expired (401). Need new key from composio.dev
2GitHub Actions billing🔴 High✅ FixedSelf-hosted runner installed on Windows. All 8 switched to self-hosted
3Unit tests🟡 Medium⏳ PendingTests exist in tests/ but coverage is incomplete
4Biome warnings cleanup🟢 Low🔄 Ongoing~20 warnings remain (mostly noExplicitAny, safe fixes already applied)
5Docs audit🟢 Low✅ DoneFrontmatter added to all 14 docs files. Total: 34 docs with valid frontmatter

Blockers

  • GitHub Actions: Billing needs to be resolved for CI/CD to run automatically ✅ Self-hosted runner live
  • Composio API Key: Without a valid key, all AI features fall back to mock responses

3. Documentation Analysis

3.1 All Docs Overview

Total docs: 35 (including this file) Categories: Getting Started (2), AmaStudio (5), Features (6), Configuration (5), Guides (4), Architecture (3), Reference (4), Project (3), Technical (1), UI (1)

SlugCategoryQualityIssues
AMADEV-APIKEYGuides✅ Good—
AMALLM-AGENT-VALIDATIONGuides✅ Good—
amastudio-agentAmaStudio✅ Good—
amastudio-apiAmaStudio✅ Good—
amastudio-knowledgeAmaStudio✅ Good—
amastudio-loginAmaStudio✅ Good—
amastudio-mcpAmaStudio✅ Good—
ARCHITECTUREArchitecture✅ Excellent257 lines, very detailed
best-practicesGuides✅ Good—
catatan-pemakain-semua-fiturReference⚠️ StaleReferences different project (AMA-LTX)
cliFeatures✅ Good—
COMPOSIO_SDK_WORKAROUNDSTechnical✅ Good—
configurationConfiguration✅ Good—
CUSTOM-API-ENDPOINTSGuides✅ Good—
custom-providersConfiguration✅ Good—
GEMINIReference✅ Good—
indexGetting Started✅ Good—
mcpFeatures✅ Good—
MOUSE-TRACKINGUI✅ Good—
planProject⚠️ StalePhase 1-4 mostly unchecked, outdated
providersConfiguration✅ Good—
schedulesFeatures✅ Good—
securityGuides✅ Good—
skillsFeatures✅ Good—
soundchartReference⚠️ ExternalSoundcharts API dump, not project doc
spssProject✅ Good—
sunautoReference⚠️ ExternalSonauto API reference, not project doc
supported-providersConfiguration✅ Good—
voiceFeatures✅ Good—
WEB-SEARCHArchitecture✅ Good—
whyGetting Started✅ Good—
worktreesFeatures✅ Good—
SESSION-PERSISTENCEArchitecture✅ Excellent155 lines, very detailed
PROJECT-TRACKERProject🆕 NewThis file

3.2 Issues Found

  1. 14 files lack frontmatter — ✅ Now all 34 docs have valid frontmatter
  2. 3 stale docs: catatan-pemakain-semua-fitur.md (AMA-LTX project), plan.md (unchecked phases), soundchart.md / sunauto.md (external API dumps)
  3. Missing docs: No doc for /ipku page, no deployment guide, no agent contribution workflow
  4. Mixed languages: Some docs in Indonesian (catatan-pemakain-semua-fitur.md, spss.md), most in English

3.3 Missing Documentation

TopicWhy Needed
IPKU page guideNew feature at /ipku
Deployment guideCurrent deploy is manual via Vercel CLI (GH Actions broken)
Agent contribution workflowHow agents should update PROJECT-TRACKER.md
API key rotationHow to update COMPOSIO_API_KEY
Testing guideHow to run tests, coverage expectations

4. Overall Progress

Feature Completion

Code
Core API (chat, models, tools)    ████████████████░░░░ 80%
Session Persistence               ██████████████████░░ 90%
Reasoning Engine (CoT/ToT/SC)     ██████████████░░░░░░ 70%
Tool Registry (22 tools)          ██████████████████░░ 85%
Admin Dashboard                   ████████████████░░░░ 80%
Web Search                        ████████████████████ 100%
Media Generation (image/video)    ██████████████░░░░░░ 70%
Blog System                       ██████████████████░░ 85%
SPSS Automation                   ██████████████████░░ 85%
Web Reader                        ████████████████████ 100%
Documentation                     ████████████████░░░░ 80%
Tests                             ██████░░░░░░░░░░░░░░ 30%
CI/CD Pipeline                    ████████████░░░░░░░░ 60%

Documentation Completion

Code
Getting Started ████████████████████ 100% (2/2)
AmaStudio       ████████████████████ 100% (5/5)
Features        ████████████████████ 100% (6/6)
Configuration   ████████████████████ 100% (5/5)
Guides          ████████████████████ 100% (2/2)
Project         ████████████░░░░░░░░  50% (1/2 — needs deployment guide)
General         ████████████████░░░░  80% (14 need frontmatter audit)

5. Agent Workflow

All agents MUST update this file when making changes:

Before making changes

  1. Read docs/PROJECT-TRACKER.md to understand current state
  2. Check pending/blocked items to avoid duplicate work

After making changes

  1. Add entry to Session Log with:
    • Date
    • Description of change
    • Status (✅ Done / 🔄 In Progress / ⏳ Pending)
    • Commit hash (if committed)
  2. Update Pending/Blocked items if applicable
  3. Update progress bars if feature completion changed
  4. Update "Last updated" date at the top

Commit format

Code
type(scope): description

feat: new feature
fix: bug fix
chore: maintenance
docs: documentation
refactor: code change
test: testing

6. Quick Reference

CommandDescription
npm run devDev server on :4567
npm run buildProduction build
npm run lintBiome lint
npx prisma generateAfter schema changes
npx vercel --prod --yesManual Vercel deploy (when GH Actions down)

Deploy Process

  1. Merge changes to master
  2. If GH Actions works: push triggers auto-deploy
  3. If GH Actions broken: git checkout master && git merge <branch> && npx vercel --prod --yes
  4. Verify: curl https://amadev.org/api/ipku