approved Visibility internal Owner erik@uvilo.com Approver _ Created 2026-07-31 Updated 2026-07-31

Knowledge Consistency Execute State 8

Plan: Plan 8 — Post-Verify Stale Reference Cleanup Spec sections covered: S1.3 (Forge_Chat_Prompt.md references removed), S1.5 (filesystem paths), S1.6 (forge-discovery tool names), S1.8 (MongoDB references removed), S1.10 (Page Manager bot spawning), S4.4 (JWT Auth Manager removed), S7.2–S7.3 (use-case names, not model-specific names) Prerequisite: Plans 1–7 completed and approved (Execute_Eval 1–7 all passed), Verification completed with findings E2–E10 Executing bot: forge/project-worker

Task Tracking

Execution Log

Task 1 — Fix Forge_Infrastructure.md (E2, E3, E4, E5)

Step 1 (E2): Removed the two MongoDB lines from the Architecture diagram:

├── MongoDB (via Railway "Add Database" — persistent volume, backups enabled)
│   └── Agent configs, conversation history, user data

Updated the existing forge Postgres entry to reflect the expanded role:

├── forge Postgres (via Railway — persistent volume)
│   └── AgentJob table, orchestration state, agent configs, conversation history, user data

Step 2 (E2): Removed MONGO_URI from the Key variables column and MongoDB from the Used by column in the Environment Variables table:

Before: | Infrastructure | MONGO_URI, FORGE_DB_URL, TYPESENSE_URL, TYPESENSE_ADMIN_KEY | MongoDB, Postgres, Typesense |
After: | Infrastructure | FORGE_DB_URL, TYPESENSE_URL, TYPESENSE_ADMIN_KEY | Postgres, Typesense |

Step 3 (E3): Replaced JWT Auth Manager with API-key authentication in the Orchestrator section of the architecture diagram:

Before: │ ├── JWT Auth Manager for session auth
After: │ ├── API-key authentication (service account)

Step 4 (E4): Replaced obsolete forge-discovery tool names in the MCP server details section:

Before: Provides \list_skills`, `find_skill`, `get_skill_details` for skill/project discovery`
After: Provides \forge-discovery__list_departments`, `forge-discovery__list_dept_projects`, `forge-discovery__get_project`, `forge-discovery__list_skills`, `forge-discovery__get_skill`, `forge-discovery__find` for skill/project discovery`

Step 5 (E5): Fixed the incorrect workspace path in the suprsend MCP section:

Before: python3 /workspace/erik/uvilo-os/Forge/Configs/MCP_Servers/suprsend-mcp-proxy.py
After: python3 /workspace/erik@uvilo.com/uvilo-os/Forge/Configs/MCP_Servers/suprsend-mcp-proxy.py

Verify (all pass):

grep -in 'mongodb\|MONGO_URI\|mongo' → no matches
grep -in 'JWT Auth Manager' → no matches
grep -nP '(?<!forge-discovery__)(list_skills|find_skill|get_skill_details)' → no matches
grep -n '/workspace/erik/uvilo-os' → no matches
grep -n 'API-key authentication' → match at line 46 ✅

Task 2 — Fix infrastructure_state.md (E2)

Step 1: Removed the MongoDB row from the Services table: | MongoDB | 8.0.20 (Railway "Add Database") | Yes | Yes |

Step 2: Removed the MONGO_URI row from the Key Connection Variables table: | \MONGO_URI` | MongoDB connection string (include `?authSource=admin`) |`

Verify (pass): grep -in 'mongodb\|MONGO_URI\|mongo' → no matches ✅

Task 3 — Fix Project_Rename/SKILL.md (E5)

Step 1: Fixed the incorrect workspace path in the grep example (Step 7 of the skill):

Before: grep -rl "old/path" /workspace/erik/uvilo-os/ --exclude-dir=...
After: grep -rl "old/path" [[orgRepoRoot]]/ --exclude-dir=... (using the template variable for portability)

Verify (pass): grep -n '/workspace/erik/uvilo-os' → no matches ✅

Task 4 — Fix Forge_Optimizer Reference Files (E6, E7, E4)

Step 1 — example_report.md (E6, E7):

Finding 1 (E6): Replaced Forge/Configs/Agents/Forge_Chat_Prompt.md with the system prompt in the sidebar compliance finding.

Finding 2 (E6 + E7): Replaced the Forge_Chat_Prompt.md reference with the system prompt, replaced “reading the Update Sidebar skill” with “spawning the Page Manager bot”, and replaced “Follow the Manage Pages skill procedure” with the Page Manager bot spawn pattern: Spawn the Page Manager bot via \spawnAgent` with `{ botGroup: ‘forge’, botHandle: ‘page-manager’ }“.

Step 2 — extraction_prompt.md (E6, E4):

Replaced all 5 Forge_Chat_Prompt.md references with the system prompt (lines 18, 19, 21, 27, 36). Replaced get_skill_details with forge-discovery__get_skill (line 75).

Verify (all pass):

grep -rn 'Forge_Chat_Prompt' → no matches ✅
grep -rn 'get_skill_details' → no matches ✅
grep -in 'Manage Pages skill\|manage.pages skill\|manage-pages skill' → no matches ✅

Task 5 — Fix Project Skills and Workflow (E6)

Step 1 — Project_Extract/SKILL.md: Replaced Forge_Chat_Prompt.md with the Persistent Knowledge prompt (Bot database) in the “Ensure everything is findable” step.

Step 2 — Project_Extract_Eval/SKILL.md: Replaced Forge_Chat_Prompt.md with the Persistent Knowledge prompt (Bot database) in the “Review the extraction” step.

Step 3 — Forge_Project_Workflow.md: Replaced Forge_Chat_Prompt.md with the system prompt in the Execute_State checkbox conventions note.

Verify (pass): grep -rn 'Forge_Chat_Prompt' across all 3 files → no matches ✅

Task 6 — Fix Model-Specific Names in Typesense Skills (E8)

Step 1 — Reindex_Typesense/SKILL.md: Replaced the model-specific file reference Forge/Skills/Choose_AI_Model/Models/gpt-5.4-nano.md with the use-case name and Models/ folder: Forge/Skills/Choose_AI_Model/Models/ for the indexing use case’s model-specific quirks.

Step 2 — Typesense_MCP/SKILL.md: Replaced both model-specific file references (gpt-5.4-nano.md and gpt-4o-mini.md) with the same use-case name and Models/ folder reference.

Verify (all pass):

grep -rn 'gpt-5.4-nano\|gpt-4o-mini' → no matches ✅
grep -n 'indexing use case' → matches in both files ✅

Task 7 — Build, Commit, and Push

Build: Ran npm run generate && npx astro build from .internal/. Build succeeded — 951 pages built. (Note: npm run build which includes astro check fails due to pre-existing TypeScript errors in src/components/Search.astro related to the TypeSense docsearch module — this is unrelated to Plan 8 changes. The astro build step itself succeeds.)

Git: All modified files staged, committed, and pushed to dev.