sasedev-knowledge/deltas/0.0.4/alpha.1.md

Delta 0.0.4-alpha.1 — cadrage de la fondation PostgreSQL partagée

Baseline requise

Partir de la stable autoritaire réellement publiée :

tag Knowledge          v0.0.3
commit Knowledge       b3823972449150b72905930b806d4d15471cddce
archive SHA-256        82407dc2a83be878daa65692f975681428d0adc721ff249c3c9020e3a9d1f29d
publish report         sasedev-knowledge-0.0.3-publish.001-report.md = PASS
start prompt           prompts/004-V0_0_4_START_PROMPT.md

Le rapport post-tag fourni confirme la convergence HEAD/tag distant/commentaire ZIP, l'intégrité de l'archive, les douze deltas/histories 0.0.3 et rel.1.fix.1 = PASS.

PGR v0.1.3 reste une provenance historique de l'adoption fermée en 0.0.2. Aucune nouvelle version PGR n'est chargée ou adoptée.

La version devient :

0.0.4-alpha.1

Objet

Fermer le cadrage PostgreSQL avant toute implémentation :

• vérifier la stable v0.0.3, ses owners, architecture, deltas/histories, DEFER et revue d'horizon ;
• comparer les clients/ORM/migrations Rust actuels ;
• sélectionner tokio-postgres comme driver, deadpool-postgres comme pool et Refinery comme migrator, sans ORM ;
• retenir knowledge-store-postgres-lib comme owner futur du pool, des migrations et de l'état PostgreSQL ;
• borner le premier schéma à knowledge_sources et knowledge_source_sync_state ;
• définir une configuration injectée sans fuite de secrets et sans fallback caché ;
• définir une stratégie de tests PostgreSQL réels par schéma éphémère ;
• préparer l'étude 008 et le plan 004 ;
• conserver l'horizon produit existant puisqu'aucune dépendance future n'est invalidée.

Aucun code produit, aucune nouvelle crate, aucune dépendance Cargo/npm, aucune migration SQL et aucun fichier Web ne sont ajoutés dans cette tranche.

CHANGELOG.md reste inchangé conformément au prompt de démarrage : l'entrée 0.0.4 ne sera préparée qu'à l'approche de la stabilisation.

Décisions retenues

owner PostgreSQL   knowledge-store-postgres-lib (à créer en alpha.2)
driver             tokio-postgres 0.7
ORM                aucun
pool               deadpool-postgres 0.14
migrations         SQL versionné + Refinery 0.9
premier schéma     source logique + dernière révision synchronisée
test PostgreSQL    URL explicite + schéma éphémère isolé
autorité contenu   Git

Les types de tokio-postgres, Deadpool et Refinery restent confinés à knowledge-store-postgres-lib. Un backend TLS sera choisi seulement si la connexion de déploiement réellement visée l'exige.

Horizon

Aucun REPLAN d'horizon n'est nécessaire.

Restent :

0.0.5  modèles de contenu et projections
0.0.6  templates publics
0.0.7  templates d'administration
0.0.8  lecture publique Actix Web / Maud
0.0.9  administration Actix Web / Maud et autorisation
0.0.10 gestion, proposition, revue et publication

Gitea/forge, scheduler, recherche avancée, auth, modèles finaux de contenu, administration transverse et sujets Git avancés restent DEFER.

Scope des fichiers

REPLACE :

VERSION
Cargo.toml
README.md
RULES.md
docs/000-README.md
docs/architecture/001-PROJECT_PROFILE.md
docs/architecture/002-KNOWLEDGE_ARCHITECTURE.md
docs/validation/001-VALIDATION_MATRIX.md

ADD :

docs/studies/008-V0_0_4_POSTGRES_FOUNDATION_STUDY.md
docs/plans/004-V0_0_4_POSTGRES_FOUNDATION_PLAN.md
deltas/0.0.4/alpha.1.md

DELETE : aucun.

ROADMAP.md, CHANGELOG.md, prompts/, crates/ et Web/ ne sont pas modifiés.

Aucun history 0.0.4-alpha.1 n'est inclus : il doit refléter uniquement la gate opérateur réelle.

Gate opérateur

Exécuter depuis la racine du dépôt après application du delta.

Version et baseline

test "$(cat VERSION)" = '0.0.4-alpha.1'
grep -F 'version = "0.0.4-alpha.1"' Cargo.toml

grep -F 'Knowledge stable tag       v0.0.3' docs/architecture/001-PROJECT_PROFILE.md
grep -F 'Knowledge stable commit    b3823972449150b72905930b806d4d15471cddce' docs/architecture/001-PROJECT_PROFILE.md
grep -F 'Knowledge archive SHA-256  82407dc2a83be878daa65692f975681428d0adc721ff249c3c9020e3a9d1f29d' docs/architecture/001-PROJECT_PROFILE.md
grep -F 'Knowledge publish report   sasedev-knowledge-0.0.3-publish.001-report.md = PASS' docs/architecture/001-PROJECT_PROFILE.md

test "$(find deltas/0.0.3 -maxdepth 1 -type f -name '*.md' | wc -l)" -eq 12
test "$(find history/0.0.3 -maxdepth 1 -type f -name '*.md' | wc -l)" -eq 12
diff <(find deltas/0.0.3 -maxdepth 1 -type f -name '*.md' -printf '%f\n' | sort) <(find history/0.0.3 -maxdepth 1 -type f -name '*.md' -printf '%f\n' | sort)
grep -A2 '^## Statut$' history/0.0.3/rel.1.fix.1.md | grep -Fx 'PASS'

Cadrage PostgreSQL et autonomie

test -f docs/studies/008-V0_0_4_POSTGRES_FOUNDATION_STUDY.md
test -f docs/plans/004-V0_0_4_POSTGRES_FOUNDATION_PLAN.md
test -f deltas/0.0.4/alpha.1.md
test ! -e history/0.0.4/alpha.1.md

grep -F '`tokio-postgres` comme driver PostgreSQL' docs/studies/008-V0_0_4_POSTGRES_FOUNDATION_STUDY.md
grep -F '`deadpool-postgres` comme pool' docs/studies/008-V0_0_4_POSTGRES_FOUNDATION_STUDY.md
grep -F '`refinery` comme owner technique des migrations SQL' docs/studies/008-V0_0_4_POSTGRES_FOUNDATION_STUDY.md
grep -F 'knowledge-store-postgres-lib' docs/studies/008-V0_0_4_POSTGRES_FOUNDATION_STUDY.md
grep -F 'knowledge_sources' docs/studies/008-V0_0_4_POSTGRES_FOUNDATION_STUDY.md
grep -F 'knowledge_source_sync_state' docs/studies/008-V0_0_4_POSTGRES_FOUNDATION_STUDY.md
grep -F 'KNOWLEDGE_POSTGRES_TEST_URL' docs/studies/008-V0_0_4_POSTGRES_FOUNDATION_STUDY.md

grep -F 'Ne pas rechercher, charger ni adopter automatiquement une nouvelle version de PGR.' prompts/004-V0_0_4_START_PROMPT.md
grep -F 'PGR `v0.1.3` reste une provenance historique' docs/plans/004-V0_0_4_POSTGRES_FOUNDATION_PLAN.md

test ! -e crates/knowledge-store-postgres-lib
test ! -e migrations
test ! -e history/0.0.4/alpha.1.md
test -z "$(git status --short -- crates Web CHANGELOG.md ROADMAP.md prompts)"

Documentation puis formatage/audits Rust

git diff --check

python3 -B scripts/audit_markdown_headers.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts deltas history
python3 -B scripts/audit_markdown_links.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts deltas history
python3 -B scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts deltas history

cargo fmt --all
cargo fmt --all -- --check

python3 -B scripts/audit_rust_test_layout.py crates
python3 -B scripts/audit_rust_blank_lines.py crates
python3 -B scripts/audit_rust_item_spacing.py crates
python3 -B scripts/audit_rust_module_order.py crates
python3 -B scripts/audit_rust_trait_import_blocks.py crates
python3 -B scripts/audit_rust_reexport_blocks.py crates
python3 -B scripts/audit_rust_crate_root_facades.py crates
python3 -B scripts/audit_rust_export_completeness.py --root . --summary-only

cargo metadata --format-version 1 --no-deps > /tmp/sasedev-knowledge-0.0.4-alpha.1-metadata.json
cargo check --workspace

alpha.1 ne rejoue pas Clippy, tests workspace, npm/Vite ou smokes HTTP : aucun source Rust, dépendance, frontend ou runtime n'est modifié. cargo check --workspace vérifie néanmoins le manifest après promotion de version.

Structure, horizon et hygiène

python3 -c 'import json; from pathlib import Path; m=json.loads(Path("/tmp/sasedev-knowledge-0.0.4-alpha.1-metadata.json").read_text()); assert len(m["workspace_members"]) == 9; assert {p["name"] for p in m["packages"]} == {"knowledge-app-lib","knowledge-domain-lib","knowledge-git-api","knowledge-git-lib","knowledge-sync-api","knowledge-web-lib","knowledge-pgr-server","knowledge-howtos-server","knowledge-snippets-server"}; print("Knowledge 0.0.4-alpha.1 workspace audit: clean")'

grep -F -- '- `( ) 0.0.4` — fondation PostgreSQL partagée' ROADMAP.md
grep -F -- '- `(h) 0.0.5` — modèles de contenu et projections' ROADMAP.md
grep -F -- '- `(h) 0.0.10` — gestion, proposition, revue et publication' ROADMAP.md

python3 -c 'from pathlib import Path; roots=[Path("README.md"),Path("RULES.md"),Path("ROADMAP.md"),Path("CHANGELOG.md"),Path("docs"),Path("prompts"),Path("deltas"),Path("history")]; paths=[p for r in roots for p in ([r] if r.is_file() else r.rglob("*")) if p.is_file()]; bad=[str(p) for p in paths if (lambda b: b"\r" in b or not b.endswith(b"\n") or b.endswith(b"\n\n") or any(line != line.rstrip(" \t") for line in b.decode("utf-8").splitlines()))(p.read_bytes())]; assert not bad, bad; print(f"Knowledge 0.0.4-alpha.1 text hygiene: clean ({len(paths)} file(s))")'
test -f Cargo.lock
git check-ignore -q Cargo.lock
if git ls-files --error-unmatch Cargo.lock >/dev/null 2>&1; then echo 'Cargo.lock must remain untracked for Knowledge' >&2; exit 1; fi

test -f Web/knowledge-template-lab/package-lock.json

git add -A
git diff --cached --check
git status --short

Transition

PASS

Produire séparément :

history/0.0.4/alpha.1.md

avec les résultats réellement observés. Après application du history, commit/push 0.0.4-alpha.1, puis seulement préparer 0.0.4-alpha.2 qui matérialisera la crate PostgreSQL, tokio-postgres, deadpool-postgres, Refinery et la première migration.

FAIL / PARTIAL / BLOCKED

Produire le history réel, l'appliquer et le committer avant toute correction.

Une correction bornée au cadrage utilise 0.0.4-alpha.1.fix.1. Si le diagnostic invalide le driver/pool/migrator retenu, l'ownership, le schéma ou la stratégie de test, exécuter un REPLAN plutôt que d'absorber une architecture différente dans un fix.