From 86015bfccd25eeebd234fff725b9c08d17b1c1e2 Mon Sep 17 00:00:00 2001 From: Andy Dixon Date: Wed, 26 Aug 2026 22:49:32 +0100 Subject: [PATCH] docs: consistency pass after the review README status, release notes and predictions/personality docs no longer describe 0.2 work as future or 0.1 as current; predictions.md states which processes create predictions and which do not; ENVIRONMENT.md records that the host cluster now has pgvector. --- README.md | 2 +- docs/ENVIRONMENT.md | 2 +- docs/RELEASE_NOTES.md | 4 ++++ docs/personality.md | 2 +- docs/predictions.md | 2 +- 5 files changed, 8 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index c88255d..3eb8d06 100644 --- a/README.md +++ b/README.md @@ -113,7 +113,7 @@ noemactl fork dani --snapshot --name dani-test ## Status -Version 0.1.0: all sixteen phases of [PLAN.md](PLAN.md) are implemented. Highlights beyond the first milestone: goals and motivation, predictions and calibration, metacognition, reflection and consolidation, the relationship graph, the capability and policy layer, integrations (research folder, git, Prometheus, webhooks), dreaming, snapshots and forks, cognitive replay, experiments, export/import, TOTP. See [CHANGELOG.md](CHANGELOG.md), [docs/RELEASE_NOTES.md](docs/RELEASE_NOTES.md) and the API document at [docs/openapi.json](docs/openapi.json) (also served at `/api/v1/openapi.json`). +Version 0.1.0: all sixteen phases of [PLAN.md](PLAN.md) are implemented. Since then the epistemic honesty review (PLAN.md §7, summarised in [docs/epistemics.md](docs/epistemics.md)) separated assertions from beliefs, recorded evidence provenance, labelled every score as uncalibrated, added explicit unknowns, temporal beliefs, per-subject source reliability, runtime identity for replay, cognitive forks per model, a causal timeline, audited redaction and Amazon Bedrock. Highlights beyond the first milestone: goals and motivation, predictions and calibration, metacognition, reflection and consolidation, the relationship graph, the capability and policy layer, integrations (research folder, git, Prometheus, webhooks), dreaming, snapshots and forks, cognitive replay, experiments, export/import, TOTP. See [CHANGELOG.md](CHANGELOG.md), [docs/RELEASE_NOTES.md](docs/RELEASE_NOTES.md) and the API document at [docs/openapi.json](docs/openapi.json) (also served at `/api/v1/openapi.json`). ## Licence diff --git a/docs/ENVIRONMENT.md b/docs/ENVIRONMENT.md index 0c638bd..0f6e45a 100644 --- a/docs/ENVIRONMENT.md +++ b/docs/ENVIRONMENT.md @@ -6,7 +6,7 @@ Recorded at project start (2026-09-14) on the primary development machine. |---|---|---| | Go | 1.26.1 linux/amd64 (`GOTOOLCHAIN=auto`) | `go 1.26` in `go.mod`; stdlib `net/http` routing, `log/slog`, `embed` | | Git | 2.43.0, no `init.defaultBranch` configured | default branch is `master` (git's default) | -| PostgreSQL | 16 local cluster on 5432 **without pgvector**; `pgvector/pgvector:pg16` image available | Dev/test DB is the compose container on **5433**. Vector features are optional and detected at migration time | +| PostgreSQL | 16 local cluster on 5432 with the `postgresql-16-pgvector` package installed (since 2026-09-15); `pgvector/pgvector:pg16` image available | Dev/test DB is the compose container on **5433**. Vector features are optional and detected at migration time | | Docker | Engine + Compose v5.5 | `deploy/docker-compose.yml` provides db + app | | Static analysis | staticcheck 2026.2.1, gosec, govulncheck in `~/go/bin` | `make lint`, `make security` | | golangci-lint | not installed | not required; staticcheck + vet + gosec suffice | diff --git a/docs/RELEASE_NOTES.md b/docs/RELEASE_NOTES.md index 32fde67..998bb09 100644 --- a/docs/RELEASE_NOTES.md +++ b/docs/RELEASE_NOTES.md @@ -16,6 +16,10 @@ First release: every phase of the plan is implemented, tested and documented. `go vet`, `go test -race ./...`, staticcheck, gosec (G104 excluded) and govulncheck are clean with Go 1.26.8. +## Since 0.1.0 (unreleased) + +The review pass recorded in PLAN.md §7 and summarised in [epistemics.md](epistemics.md) is in the [Unreleased] section of the changelog. Its remaining limitations are listed at the end of that document. + ## Known limits - Replays diverge honestly when retrieval scoring depends on wall-clock recency; a virtual clock for replay is future work. diff --git a/docs/personality.md b/docs/personality.md index d357a44..61d8d41 100644 --- a/docs/personality.md +++ b/docs/personality.md @@ -29,7 +29,7 @@ A template is a reusable personality. When a mind is based on a template, each v ## Traits and the runtime -Later phases consume the personality as follows: +The runtime consumes the personality as follows: - attention weights are biased by traits such as curiosity and novelty preference; - affect baselines derive from traits (patience, confidence); diff --git a/docs/predictions.md b/docs/predictions.md index 63a6139..67f1135 100644 --- a/docs/predictions.md +++ b/docs/predictions.md @@ -25,7 +25,7 @@ Outcomes emit `prediction_resolved` or, for refutations, `prediction_error` with - Operators, through the Predictions page, the API or `noemactl`. - Causal hypotheses: when the associate process turns "A may have caused B" into a belief, a prediction is derived automatically — the effect should recur within 24 hours if the cause is real — with the belief's confidence, so a miss lowers the hypothesis. -- Later phases add predictions from consolidation and reflection. +- Reflection reads calibration over the last ninety days and raises an overconfidence warning through metacognition; it does not create predictions. Consolidation creates none either. Prediction outcomes also feed source reliability (docs/beliefs.md). ## Calibration