72 lines
3.1 KiB
Markdown
72 lines
3.1 KiB
Markdown
# Milestone v1.1 Requirements
|
|
|
|
**Milestone:** v1.1 — Session Lifecycle, Memory & Reporting
|
|
**Core Value:** Agent must NEVER mutate real infrastructure beyond what the limited IAM role permits
|
|
**Target:** Productionize session workspace, persistent memory, and operational reporting
|
|
|
|
## Requirements
|
|
|
|
### Memory (MEM)
|
|
|
|
- [ ] **MEM-01**: Hindsight memory provider enabled for cross-session entity-aware recall
|
|
- Details: Switch from built-in MEMORY.md/USER.md to Hindsight Cloud API
|
|
- Config: `memory.provider: hindsight`, `HINDSIGHT_API_KEY` in .env
|
|
- Verification: Agent recalls facts across sessions without user prompting
|
|
|
|
### Repository Workspace (REPO)
|
|
|
|
- [ ] **REPO-01**: DEFAULT_REPOS (`rai-ops`, `rai-deployment`, `rai-devtools`) auto-cloned into every new Hermes session
|
|
- Details: `shell_init_files` script clones to host-mounted `/workspace/repos/` volume
|
|
- Config: `terminal.shell_init_files`, `terminal.docker_volumes` (SSH mount + workspace volume)
|
|
- Verification: New session has repos available at `/workspace/repos/`
|
|
- [ ] **REPO-02**: User can request additional repos to clone on demand during a session
|
|
- Details: Agent can clone arbitrary repos via git command in Docker
|
|
- Verification: User says "clone rai-pipeline", agent clones it
|
|
|
|
### Main Session Skill (SKIL)
|
|
|
|
- [ ] **SKIL-04**: Main ngn-agent session orchestration skill covering the initial-plan.md workflow
|
|
- Details: Hermes SKILL.md defining session lifecycle — detect similar prev sessions (via hindsight), load DEFAULT_REPOS, create Jira ticket per session, load Confluence docs, update docs/Jira at session end
|
|
- Verification: Agent follows the full session workflow on a new task
|
|
|
|
### Cron Reporting (CRON)
|
|
|
|
- [ ] **CRON-01**: Daily session summary report delivered via Telegram at 09:00
|
|
- Details: Hermes skill-backed cron job. Lists active sessions, last activity, token usage
|
|
- Verification: Telegram receives daily report
|
|
- [ ] **CRON-02**: Stale session auto-archive (30d inactivity) — export to JSON, delete from live DB
|
|
- Details: `no_agent` cron script using SessionDB API. Weekly (Sunday 06:00). Dry-run mode first
|
|
- Verification: Sessions inactive >30d archived, no data loss
|
|
- [ ] **CRON-03**: Daily report includes Jira ticket status via ngn-jira skill
|
|
- Details: Report queries Jira for tickets related to active sessions
|
|
- Verification: Daily report contains Jira ticket summaries
|
|
|
|
## Future (v1.2+)
|
|
|
|
- Archive restore script (JSON files are text-searchable; low urgency)
|
|
- On-demand repo cloning as dedicated skill
|
|
- Custom ngn-agent plugin package
|
|
|
|
## Out of Scope
|
|
|
|
- Custom scheduler — Hermes cron already handles this
|
|
- Custom memory provider implementation — Hindsight is production-ready and bundled
|
|
- Persistent Docker image with pre-cloned repos — would be large and stale quickly
|
|
|
|
## Traceability
|
|
|
|
| Requirement | Phase | Status |
|
|
|-------------|-------|--------|
|
|
| MEM-01 | Phase 5 | Pending |
|
|
| REPO-01 | Phase 6 | Pending |
|
|
| REPO-02 | Phase 6 | Pending |
|
|
| SKIL-04 | Phase 7 | Pending |
|
|
| CRON-01 | Phase 8 | Pending |
|
|
| CRON-02 | Phase 8 | Pending |
|
|
| CRON-03 | Phase 8 | Pending |
|
|
|
|
---
|
|
|
|
*Requirements defined: 2026-06-14*
|
|
*Ready for roadmap: yes*
|