Files
sasedev-knowledge/deltas/0.0.1/alpha.3.fix.3.md

4.9 KiB

Delta 0.0.1-alpha.3.fix.3 — hygiène Markdown de la matrice de validation

Base requise

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

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

La version devient :

0.0.1-alpha.3.fix.3

Cause du troisième fix

alpha.3.fix.2 a corrigé la documentation publique de ContentFamily.

Les preuves opérateur confirment :

cargo check --workspace                                  PASS
cargo clippy --workspace --all-targets --all-features    PASS
knowledge-domain-lib tests                               3 PASS
knowledge-git-api tests                                  1 PASS
knowledge-sync-api tests                                 1 PASS
Cargo metadata audit                                     PASS

La tranche reste néanmoins FAIL parce que :

git diff --check

signale :

docs/validation/001-VALIDATION_MATRIX.md:216: new blank line at EOF.

Correctif

Le présent fix supprime uniquement la ligne vide supplémentaire en fin de :

docs/validation/001-VALIDATION_MATRIX.md

La matrice conserve une fin de ligne POSIX normale, sans ligne blanche supplémentaire.

Le plan vivant enregistre le FAIL réel de alpha.3.fix.2 et la transition vers alpha.3.fix.3.

Non-régression

Le correctif ne modifie pas :

  • les quatre doc-comments de ContentFamily ;
  • SourceId ;
  • GitRepository ;
  • RepositoryEventSource ;
  • RepositorySyncSignal ;
  • les dépendances entre crates ;
  • le cadrage Web/Maud/Vite ;
  • les décisions PostgreSQL/forge.

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

Fichiers remplacés

VERSION
Cargo.toml
docs/plans/001-V0_0_1_FOUNDATION_PLAN.md
docs/validation/001-VALIDATION_MATRIX.md

Fichier ajouté

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

Aucun fichier n'est supprimé.

Cargo.lock

Le delta ne préfabrique pas Cargo.lock.

La version workspace passant à 0.0.1-alpha.3.fix.3, Cargo peut mettre à jour le lockfile dans le workspace opérateur. Toute modification réelle reste versionnée.

Validation attendue

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

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

git diff --check

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

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

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

matrix_path = Path("docs/validation/001-VALIDATION_MATRIX.md")
matrix_bytes = matrix_path.read_bytes()

assert matrix_bytes.endswith(b"\n")
assert not matrix_bytes.endswith(b"\n\n")

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.3 structural audit: clean")
PY

cargo metadata --format-version 1 --no-deps     > /tmp/sasedev-knowledge-alpha3-fix3-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-fix3-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.3", (
        package["name"],
        package["version"],
    )

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

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

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