# 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*