Bagas Purwa Sentika
38a0d1af6d
- 1 plan (07-01-PLAN.md) — creates session/SKILL.md - Single-file SKILL.md at ~/.hermes/skills/ngn-agent/session/ - Covers SKIL-04 with 7-step lifecycle procedure - All 14 locked decisions (D-01 through D-14) embedded - Deferred ideas scoped to Phase 8
99 lines
5.1 KiB
Markdown
99 lines
5.1 KiB
Markdown
# Roadmap: ngn-agent
|
|
|
|
## Milestones
|
|
|
|
- ✅ **v1.0 MVP** — Phases 1-4 (shipped 2026-06-14)
|
|
- 🚧 **v1.1 Session Lifecycle, Memory & Reporting** — Phases 5-8 (in planning)
|
|
|
|
## Phases
|
|
|
|
<details>
|
|
<summary>✅ v1.0 MVP (Phases 1-4) — SHIPPED 2026-06-14</summary>
|
|
|
|
- [x] Phase 1: Hermes Install & Provider Setup — completed 2026-06-14
|
|
- [x] Phase 2: Memory, Git & Session Management — completed 2026-06-14
|
|
- [x] Phase 3: Telegram Gateway — completed 2026-06-14
|
|
- [x] Phase 4: Skills & Integrations — completed 2026-06-14
|
|
|
|
</details>
|
|
|
|
### 🚧 v1.1 Session Lifecycle, Memory & Reporting (In Planning)
|
|
|
|
**Milestone Goal:** Productionize session workspace with default repos, upgrade to persistent cross-session memory (hindsight), and operationalize daily reporting with session lifecycle management.
|
|
|
|
- [ ] **Phase 5: Hindsight Memory Provider** — Enable cross-session persistent memory with entity-aware recall via Hindsight Cloud API
|
|
- [ ] **Phase 6: Default Repos & SSH Mount** — Mount DEFAULT_REPOS into every new session workspace with direct host filesystem mounts + SSH credential mounting
|
|
- [ ] **Phase 7: Main Session Skill** — Session lifecycle orchestration skill covering init-to-close workflow
|
|
- [ ] **Phase 8: Cron Reporting** — Daily session summaries, stale session archiving, and Jira integration
|
|
|
|
## Phase Details
|
|
|
|
### Phase 5: Hindsight Memory Provider
|
|
**Goal**: Cross-session persistent memory with entity-aware recall via Hindsight Cloud API
|
|
**Depends on**: Nothing (independent config change)
|
|
**Requirements**: MEM-01
|
|
**Success Criteria** (what must be TRUE):
|
|
1. Agent recalls facts across sessions without user prompting (cross-session semantic recall)
|
|
2. Agent detects similar previous sessions via hindsight similarity search on session start
|
|
3. Memory provider is set to `hindsight` (verifiable in config and agent state)
|
|
4. No memory provider conflicts — only one external provider registered (Hindsight, not MEMORY.md+user)
|
|
**Plans**: 1 plan
|
|
|
|
Plans:
|
|
- [ ] 05-01-PLAN.md — Hindsight Memory Provider: Create config.json, set env var, activate provider, verify
|
|
|
|
### Phase 6: Default Repos & SSH Mount
|
|
**Goal**: Default repos mounted directly from host filesystem into every new session workspace with secure SSH credential mounting for git operations
|
|
**Depends on**: Nothing (independent from Phase 5)
|
|
**Requirements**: REPO-01, REPO-02
|
|
**Success Criteria** (what must be TRUE):
|
|
1. New Hermes session has DEFAULT_REPOS (`rai-ops`, `rai-deployment`, `rai-devtools`) available at `/workspace/repos/`
|
|
2. Container restart doesn't lose cloned repos (host-mounted volume persists across container lifecycle)
|
|
3. User can request additional repo cloning mid-session and agent clones it via git command in Docker
|
|
4. SSH credentials are mounted read-only inside Docker (verified by container inspection)
|
|
5. Session init script completes within 30s timeout and doesn't block agent startup
|
|
**Plans**: 1 plan
|
|
|
|
Plans:
|
|
- [ ] 06-01-PLAN.md — SSH key + repo volume mounts, session-init.sh, DEFAULT_REPOS config
|
|
|
|
### Phase 7: Main Session Skill
|
|
**Goal**: Full session lifecycle orchestration skill covering the `initial-plan.md` workflow — init to close
|
|
**Depends on**: Phase 5 (hindsight for session similarity detection), Phase 6 (repos in workspace)
|
|
**Requirements**: SKIL-04
|
|
**Success Criteria** (what must be TRUE):
|
|
1. Agent detects similar previous sessions via hindsight on session start
|
|
2. Agent prompts for Jira ticket creation (Task type, configurable project, optional epic)
|
|
3. Agent loads relevant Confluence docs for context (searched by tag)
|
|
4. Agent prompts for Jira/Confluence updates at session end
|
|
5. Session summary auto-saved to hindsight (no prompt)
|
|
**Plans**: 1 plan
|
|
|
|
Plans:
|
|
- [ ] 07-01-PLAN.md — Main Session Skill: create session/SKILL.md with full init→work→close lifecycle
|
|
|
|
### Phase 8: Cron Reporting
|
|
**Goal**: Daily operational reporting with stale session archiving and Jira integration
|
|
**Depends on**: Phase 7 (needs SKIL-04 session lifecycle to produce meaningful sessions to report/archive)
|
|
**Requirements**: CRON-01, CRON-02, CRON-03
|
|
**Success Criteria** (what must be TRUE):
|
|
1. Telegram receives daily session summary report at 09:00
|
|
2. Daily report lists active sessions, last activity, token usage
|
|
3. Daily report includes Jira ticket status for active sessions via ngn-jira skill
|
|
4. Sessions inactive >30d are archived to JSON with no data loss (export-before-delete verified)
|
|
5. Archive script supports dry-run mode for safe initial testing before activating cron
|
|
**Plans**: TBD
|
|
|
|
## Progress
|
|
|
|
| Phase | Milestone | Plans Complete | Status | Completed |
|
|
|-------|-----------|----------------|--------|-----------|
|
|
| 1. Hermes Install & Provider Setup | v1.0 | — | Complete | 2026-06-14 |
|
|
| 2. Memory, Git & Session Management | v1.0 | — | Complete | 2026-06-14 |
|
|
| 3. Telegram Gateway | v1.0 | — | Complete | 2026-06-14 |
|
|
| 4. Skills & Integrations | v1.0 | — | Complete | 2026-06-14 |
|
|
| 5. Hindsight Memory Provider | v1.1 | 0/1 | Not started | - |
|
|
| 6. Default Repos & SSH Mount | v1.1 | 0/1 | Not started | - |
|
|
| 7. Main Session Skill | v1.1 | 0/1 | Not started | - |
|
|
| 8. Cron Reporting | v1.1 | 0/TBD | Not started | - |
|