intelligence-radar/README.md

53 lines
2.7 KiB
Markdown
Raw Normal View History

# Intelligence Radar
2026-09-13 20:11:45 +00:00
Epistemic observatory and task-specific machine intelligence capability and economics advisor.
The v0.2 implementation combines a **Compendium**, a source-capture **Radar**, and
an executable **Capability Advisor**. Read [INTENT](INTENT.md), [scope](SCOPE.md),
and [the operating contracts](docs/data-contracts.md).
## Run locally
Requires Python 3.11+ and Make. No package installation or API key is needed.
```bash
make check
make demo-advisor
python3 -m intelligence_radar ingest catalog/sources.json
python3 -m intelligence_radar advise examples/source-backed-task.json \
--catalog catalog/reviewed-2026-09-13.json --as-of 2026-09-13
python3 -m intelligence_radar --help
```
The advisor selects five measurements, checks constraints, ranks evidenced profiles,
estimates workload cost scenarios, and records outcomes for empirical success bounds.
Saved recommendations can be rendered with `report` and verified with `replay`.
The source-backed example makes evidence gaps visible; the synthetic demo exercises
complete ranking without claiming real model performance.
Source captures retain original bytes and retrieval receipts. Changed sources create
review-needed observations. Daily/weekly jobs run through `run-due`; `health` shows
results. See [scheduling and data contracts](docs/data-contracts.md).
## Knowledge and operations
| Path | Purpose |
| --- | --- |
| `IntelligenceConceptModel.md`, `compendium/` | Concept model and accessible theory maps |
| `ArchitectureBlueprint.md`, `ResearchProgram.md` | Target architecture and research program |
| `BenchmarkCatalog.md`, `catalog/` | Candidate measurement instruments; imported seeds need verification |
| `SourceCatalog.md`, `watchlist/` | Source discovery and editorial coverage |
| `TaskModelEvaluationMethod.md`, `policies/`, `task-router/` | Authoritative method, policies, and operational templates |
| `data/observations/` | Immutable, content-addressed observation envelopes |
| `digests/`, `frontier/`, `research/` | Dated editorial artifacts; imported drafts are marked unverified |
| `ops/` | Runbook, cadence, and scheduling status |
| `history/` | Unmodified source archives and checksums |
| `docs/integration-review.md` | Evaluation, conflicts, and integration decisions |
| `workplans/` | Canonical Coulomb work records projected into Statehub |
Imported September 2026 rankings and prices are research leads, not validated
recommendations. The local user timer is managed separately from the historical external automation IDs.
Statehub: domain `infotech`, topic `custodian`, prefix `IR-WP-`.
Commit workplan edits, then run `make sync` (pushes commits and reconciles Statehub). See [agent instructions](AGENTS.md).