Milestone 2’s core deterministic scanner path

README.md

@@ -46,3 +46,30 @@ Then add abilities, capabilities, features, and evidence under that repository a
 curl http://127.0.0.1:8000/repos/1/ability-map
 curl 'http://127.0.0.1:8000/search?q=classify'
 ```
+
+## Deterministic Analysis
+
+For local development, repository URLs may be local filesystem paths. Trigger a deterministic scan:
+
+```bash
+curl -X POST http://127.0.0.1:8000/repos/1/analysis-runs \
+  -H 'content-type: application/json' \
+  -d '{}'
+```
+
+Or override the scan source path explicitly:
+
+```bash
+curl -X POST http://127.0.0.1:8000/repos/1/analysis-runs \
+  -H 'content-type: application/json' \
+  -d '{"source_path":"/path/to/repository"}'
+```
+
+Inspect recorded facts:
+
+```bash
+curl http://127.0.0.1:8000/repos/1/analysis-runs
+curl http://127.0.0.1:8000/repos/1/observed-facts
+```
+
+The deterministic scanner records observed facts only: languages, documentation files, examples, tests, package manifests, configuration files, framework hints, and likely API/CLI interfaces.