docs: frozen v1.0 bundle format specs (manifest, agent-card, o1 package structure)

2026-08-03 19:56:51 +03:00
commit e2f76e4027
4 changed files with 221 additions and 0 deletions
@@ -0,0 +1,64 @@
+# O1 Package — Structure & Phase-1 Pilot (DRAFT)
+
+The first business-in-a-box: consignment refurbished-electronics arbitrage.
+Package id `hitridge-business-o1`.
+
+## Package tree
+
+```
+hitridge-business-o1/
+├── manifest.json                 # the contract (spec v1.0)
+├── modules/                      # layer 1: Odoo addon modules
+│   ├── aura_business_core/       # generic venture core (schema, auth, layout)
+│   └── hitridge_venture_o1/      # O1 models: seller, unit, order, warranty,
+│                                 #   price-guide content, pipeline views
+├── agents/                       # layer 2: neutral specialist cards + prompts
+│   ├── o1-sellers-recruiter.json
+│   ├── o1-test-operator.json
+│   ├── o1-closer.json
+│   └── o1-compliance.json
+│   └── prompts/                  # external prompt markdown per agent
+├── brain/                        # layer 3: runtime/memory
+│   ├── brain.py                  # capability ships...
+│   └── seeds/o1/                 # ...memories are EMPTY seeds at install
+├── docs/                         # layer 4: business documents
+│   ├── playbook.md               # O1 operating manual (90-day plan)
+│   ├── agreement-template.odt    # BG consignment agreement
+│   ├── test-checklist.md         # unit intake test + report template
+│   └── price-guide-starter.md    # content engine seed
+├── config/
+│   ├── channels.json             # OLX/forums target list (BG)
+│   └── pricing-rules.json        # intake→sale spread + price-drop ladder
+├── install.sh                    # target-side verifier + installer (pull)
+└── VALIDATE                        # output of validate-depo.sh (must pass)
+```
+
+## Phase-1 pilot slice (what we build first)
+
+| Item | Contents | Acceptance |
+|---|---|---|
+| 1. Manifest spec | `manifest-spec.md` frozen | validate-depo.sh accepts it |
+| 2. Agent-card spec | `agent-card-spec.md` frozen | validator rejects malformed cards |
+| 3. Converter | neutral card ↔ opencode md (both directions) | round-trip → identical hash |
+| 4. O1 skeleton | manifest + core module stub + **2 agents** (sellers-recruiter, compliance) + docs stubs | package validates; 2 specialists runnable on THIS machine from neutral cards |
+| 5. Tool registry | names → implementations (odoo.*, file.*, script.run) | card tools resolve |
+
+Pilot deliberately ships **2 of 4 agents** (sellers-recruiter, compliance) —
+they exercise the widest tool/memory/gate spread. test-operator and closer
+are added in phase 2 once the pipeline is proven.
+
+## Phase-1 acceptance (hard)
+
+1. `validate-depo.sh` passes on `hitridge-business-o1` (exit 0, no warnings).
+2. Both pilot agents launch on this machine **from the neutral cards**
+   (via converter → opencode), not from hand-written md.
+3. Manifest round-trip: `manifest.json` → convert → convert back → identical.
+4. No secrets in package (secrets_scan clean).
+5. Nothing deployed anywhere — target install is phase 2.
+
+## Sequencing after pilot
+
+- Phase 2: `install.sh` + target verification on a throwaway Odoo (Aura tower).
+- Phase 3: depot repo (git + signed tags) + local mirror (`depot-state.json`).
+- Phase 4: remaining agents + runtime/chat UI (Level 2 from earlier discussion).
+- Phase 5: on-demand bridge sessions (MCP/API), default-disconnected.