62 lines
2.3 KiB
Markdown
62 lines
2.3 KiB
Markdown
# Task 11 report
|
|
|
|
Status: completed on 2026-08-08.
|
|
|
|
## Scope delivered
|
|
|
|
- Updated operator-facing documentation for the internal Qdrant + Ollama architecture.
|
|
- Tightened documentation contract tests to require the current four-service-plus-init topology,
|
|
CPU-first/GPU-override guidance, fixed internal model/dimensions, schema-v3 migration wording,
|
|
one-collection-per-workspace ownership, and Qdrant backup/restore safety.
|
|
- Updated stable repo guidance in `AGENTS.md` and the current snapshot in `PROJECT_STATE.md`.
|
|
- Rewrote the workspace diagnostic protocol to the schema-v3/internal-semantic-service contract.
|
|
- Updated the memory guide to describe Qdrant as the derived persistent index.
|
|
- Updated the runtime secret-bundle guide to remove active vector/embedding secret guidance.
|
|
|
|
## Files changed
|
|
|
|
- `README.md`
|
|
- `AGENTS.md`
|
|
- `PROJECT_STATE.md`
|
|
- `docs/install/local-workspace-registry.md`
|
|
- `docs/install/server-workspace-registry.md`
|
|
- `docs/installazione-docker-4-contesti.md`
|
|
- `docs/workspace-diagnostic-protocol.md`
|
|
- `docs/gestione-memory.md`
|
|
- `deploy/secrets/README.md`
|
|
- `scripts/verify-workspace-install-docs.sh`
|
|
- `scripts/test-verify-workspace-install-docs.sh`
|
|
|
|
## Verification
|
|
|
|
Fresh successful runs:
|
|
|
|
```sh
|
|
./scripts/test-verify-workspace-install-docs.sh
|
|
./scripts/verify-workspace-install-docs.sh --fixtures-only
|
|
git diff --check
|
|
```
|
|
|
|
Key outcomes:
|
|
|
|
- internal semantic infrastructure documentation contract passed
|
|
- all existing install/manual fixture contracts still passed
|
|
- diff hygiene passed with no whitespace/errors
|
|
|
|
## Self-review notes
|
|
|
|
- The updated docs now match the code-backed Compose topology: `frontend`, `core`, `qdrant`,
|
|
`embedding`, and `embedding-model-init`.
|
|
- Active manuals no longer instruct operators to configure external vector or embedding runtime
|
|
endpoints/secrets.
|
|
- Qdrant backup/restore wording now matches the helper scripts' exact confirmation and rollback
|
|
behavior.
|
|
- Legacy descriptor handling is documented as explicit schema-v3 migration only; no silent
|
|
semantic-data migration is claimed.
|
|
|
|
## Residual concerns
|
|
|
|
- The broader repository still contains historical design/spec material that references older
|
|
pgvector/external-embedding architecture; this task intentionally updated operator/current-state
|
|
documentation and the corresponding contract tests, not historical planning documents.
|