From 719fb1e07a9990d34057ef04f049df43c112943c Mon Sep 17 00:00:00 2001 From: Bagas Purwa Sentika Date: Sun, 14 Jun 2026 18:06:39 +0800 Subject: [PATCH] docs: define milestone v1.1 requirements --- .planning/PROJECT.md | 13 +++---- .planning/REQUIREMENTS.md | 71 +++++++++++++++++++++++++++++++++++++++ 2 files changed, 78 insertions(+), 6 deletions(-) create mode 100644 .planning/REQUIREMENTS.md diff --git a/.planning/PROJECT.md b/.planning/PROJECT.md index 8f28096..abce618 100644 --- a/.planning/PROJECT.md +++ b/.planning/PROJECT.md @@ -27,12 +27,13 @@ The agent must NEVER mutate real infrastructure beyond what the limited IAM role ### Active -- [ ] **REPO-01**: Every new Hermes session auto-clones DEFAULT_REPOS (rai-ops, rai-deployment, rai-devtools) -- [ ] **REPO-02**: User can request additional repos to clone on demand during a session -- [ ] **MEM-05**: Long-term memory upgraded to hindsight (persistent cross-session recall) -- [ ] **CRON-01**: Daily report summarizing active sessions sent via Telegram gateway -- [ ] **CRON-02**: Stale sessions (inactive >30d) auto-archived with history preserved -- [ ] **CRON-03**: Daily report updates Jira with session progress +- [ ] **MEM-01**: Hindsight memory provider enabled for cross-session recall +- [ ] **REPO-01**: DEFAULT_REPOS auto-cloned into new sessions via shell_init_files +- [ ] **REPO-02**: On-demand additional repo cloning during session +- [ ] **SKIL-04**: Main ngn-agent session skill — session init, Jira ticket creation, doc loading, session-end updates +- [ ] **CRON-01**: Daily session summary report delivered via Telegram +- [ ] **CRON-02**: Stale session auto-archive (30d inactivity) with JSON export +- [ ] **CRON-03**: Daily report integrates Jira ticket status via ngn-jira ### Out of Scope diff --git a/.planning/REQUIREMENTS.md b/.planning/REQUIREMENTS.md new file mode 100644 index 0000000..990f361 --- /dev/null +++ b/.planning/REQUIREMENTS.md @@ -0,0 +1,71 @@ +# 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 | TBD | Pending | +| REPO-01 | TBD | Pending | +| REPO-02 | TBD | Pending | +| SKIL-04 | TBD | Pending | +| CRON-01 | TBD | Pending | +| CRON-02 | TBD | Pending | +| CRON-03 | TBD | Pending | + +--- + +*Requirements defined: 2026-06-14* +*Ready for roadmap: yes*