pgr/deltas/0.0.1/alpha.3.fix.2.md

Delta 0.0.1-alpha.3.fix.2 — documentation publique ContentFamily

Base requise

État 0.0.1-alpha.3.fix.1 committé et poussé après application du history :

history/0.0.1/alpha.3.fix.1.md = FAIL

La version devient :

0.0.1-alpha.3.fix.2

Cause du second fix

Le premier fix a corrigé l'erreur E0423 :

• cargo check --workspace termine ;
• les trois suites ciblées passent ;
• SourceId::new("pgr") est couvert par régression.

La gate reste néanmoins FAIL parce que Clippy est exécuté avec :

-D warnings

et transforme en erreurs quatre warnings missing_docs sur les variantes publiques :

ContentFamily::Pgr
ContentFamily::Howto
ContentFamily::Snippet
ContentFamily::ProjectLocal

La politique missing_docs est intentionnelle. Le correctif ne doit donc ni la réduire ni introduire #[allow(missing_docs)].

Correctif

Le fichier :

crates/knowledge-domain-lib/src/content_family.rs

documente explicitement chacune des quatre variantes publiques.

Aucun variant, contrat, type, trait, dépendance ou comportement n'est modifié.

Scope

Le fix reste strictement correctif.

Il ne modifie pas :

• GitRepository ;
• RepositoryEventSource ;
• RepositorySyncSignal ;
• le modèle de sources ;
• la trajectoire Web/Maud/Vite ;
• les décisions PostgreSQL/forge ;
• les frontières des trois applications Web.

Aucun frontend, serveur Actix, adapter Gitea, schéma PostgreSQL ou nouvelle crate n'est ajouté.

Fichiers remplacés

VERSION
Cargo.toml
crates/knowledge-domain-lib/src/content_family.rs
docs/plans/001-V0_0_1_FOUNDATION_PLAN.md
docs/validation/001-VALIDATION_MATRIX.md

Fichier ajouté

deltas/0.0.1/alpha.3.fix.2.md

Aucun fichier n'est supprimé.

Cargo.lock

Le delta ne livre pas de lockfile préfabriqué. Les packages héritent de la version workspace 0.0.1-alpha.3.fix.2; Cargo peut donc mettre à jour Cargo.lock dans l'environnement opérateur. Toute modification réelle du lockfile reste versionnée.

Validation attendue

Après application du history alpha.3.fix.1 FAIL, commit/push de alpha.3.fix.1, puis extraction du présent delta :

test "$(cat VERSION)" = "0.0.1-alpha.3.fix.2"

git diff --check

python3 - <<'PY'
from pathlib import Path
import tomllib

with Path("Cargo.toml").open("rb") as handle:
    root_manifest = tomllib.load(handle)

assert root_manifest["workspace"]["package"]["version"] == "0.0.1-alpha.3.fix.2"

content = Path(
    "crates/knowledge-domain-lib/src/content_family.rs"
).read_text(encoding="utf-8")

for variant in ("Pgr", "Howto", "Snippet", "ProjectLocal"):
    marker = f"    {variant},"
    index = content.index(marker)
    prefix = content[:index].rstrip().splitlines()
    assert prefix[-1].lstrip().startswith("///"), variant

assert "allow(missing_docs)" not in content
assert "missing_docs = \"warn\"" in Path("Cargo.toml").read_text(encoding="utf-8")

print("Knowledge 0.0.1-alpha.3.fix.2 structural audit: clean")
PY

cargo metadata --format-version 1 --no-deps     > /tmp/sasedev-knowledge-alpha3-fix2-metadata.json

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

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_export_completeness.py --root .

cargo check --workspace

cargo clippy     --workspace     --all-targets     --all-features     --     -D warnings

cargo test -p knowledge-domain-lib --all-targets --all-features
cargo test -p knowledge-git-api --all-targets --all-features
cargo test -p knowledge-sync-api --all-targets --all-features

test -f Cargo.lock
if git check-ignore -q Cargo.lock; then
    echo 'Cargo.lock must remain versioned' >&2
    exit 1
fi

python3 - <<'PY'
import json
from pathlib import Path

metadata = json.loads(
    Path("/tmp/sasedev-knowledge-alpha3-fix2-metadata.json").read_text(encoding="utf-8")
)

packages = {package["name"] for package in metadata["packages"]}
assert packages == {
    "knowledge-domain-lib",
    "knowledge-git-api",
    "knowledge-sync-api",
}, packages

for package in metadata["packages"]:
    assert package["version"] == "0.0.1-alpha.3.fix.2", (
        package["name"],
        package["version"],
    )

print("Knowledge 0.0.1-alpha.3.fix.2 Cargo metadata audit: clean")
PY

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

Ne pas committe alpha.3.fix.2 avant production de son history à partir des résultats opérateur.