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

3.1 KiB Raw Blame History