0.0.1-alpha.3.fix.3
This commit is contained in:
6
Cargo.lock
generated
6
Cargo.lock
generated
@@ -4,18 +4,18 @@ version = 4
|
||||
|
||||
[[package]]
|
||||
name = "knowledge-domain-lib"
|
||||
version = "0.0.1-alpha.3.fix.2"
|
||||
version = "0.0.1-alpha.3.fix.3"
|
||||
|
||||
[[package]]
|
||||
name = "knowledge-git-api"
|
||||
version = "0.0.1-alpha.3.fix.2"
|
||||
version = "0.0.1-alpha.3.fix.3"
|
||||
dependencies = [
|
||||
"knowledge-domain-lib",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "knowledge-sync-api"
|
||||
version = "0.0.1-alpha.3.fix.2"
|
||||
version = "0.0.1-alpha.3.fix.3"
|
||||
dependencies = [
|
||||
"knowledge-domain-lib",
|
||||
]
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
# file: Cargo.toml
|
||||
# version: 4
|
||||
# version: 5
|
||||
|
||||
[workspace]
|
||||
resolver = "3"
|
||||
@@ -10,7 +10,7 @@ members = [
|
||||
]
|
||||
|
||||
[workspace.package]
|
||||
version = "0.0.1-alpha.3.fix.2"
|
||||
version = "0.0.1-alpha.3.fix.3"
|
||||
edition = "2024"
|
||||
publish = false
|
||||
repository = "https://git.sasedev.com/Sasedev/sasedev-knowledge"
|
||||
|
||||
192
deltas/0.0.1/alpha.3.fix.3.md
Normal file
192
deltas/0.0.1/alpha.3.fix.3.md
Normal file
@@ -0,0 +1,192 @@
|
||||
<!-- file: deltas/0.0.1/alpha.3.fix.3.md -->
|
||||
<!-- version: 1 -->
|
||||
|
||||
# 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 :
|
||||
|
||||
```text
|
||||
history/0.0.1/alpha.3.fix.2.md = FAIL
|
||||
```
|
||||
|
||||
La version devient :
|
||||
|
||||
```text
|
||||
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 :
|
||||
|
||||
```text
|
||||
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 :
|
||||
|
||||
```text
|
||||
git diff --check
|
||||
```
|
||||
|
||||
signale :
|
||||
|
||||
```text
|
||||
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 :
|
||||
|
||||
```text
|
||||
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
|
||||
|
||||
```text
|
||||
VERSION
|
||||
Cargo.toml
|
||||
docs/plans/001-V0_0_1_FOUNDATION_PLAN.md
|
||||
docs/validation/001-VALIDATION_MATRIX.md
|
||||
```
|
||||
|
||||
## Fichier ajouté
|
||||
|
||||
```text
|
||||
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 :
|
||||
|
||||
```bash
|
||||
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.
|
||||
@@ -1,5 +1,5 @@
|
||||
<!-- file: docs/plans/001-V0_0_1_FOUNDATION_PLAN.md -->
|
||||
<!-- version: 6 -->
|
||||
<!-- version: 7 -->
|
||||
|
||||
# Plan 0.0.1 — fondation SaseDev Knowledge
|
||||
|
||||
@@ -132,7 +132,9 @@ La gate valide la structure et les audits puis échoue dans `knowledge-domain-li
|
||||
|
||||
`alpha.3.fix.1` corrige ce défaut Rust, ajoute une régression directe de construction `SourceId` et précise la trajectoire Web/Maud fournie avant clôture de la tranche ; il ne démarre aucune implémentation frontend ou serveur. Sa gate opérateur reste toutefois **FAIL** : `cargo check` et les tests passent, mais Clippy strict rejette les quatre variantes publiques de `ContentFamily` non documentées sous `missing_docs`.
|
||||
|
||||
`alpha.3.fix.2` corrige exclusivement cette dette de documentation publique et rejoue la gate Rust complète sans modifier les contrats domaine/Git/synchronisation ni le cadrage Web/Maud.
|
||||
`alpha.3.fix.2` corrige exclusivement cette dette de documentation publique et rejoue la gate Rust complète sans modifier les contrats domaine/Git/synchronisation ni le cadrage Web/Maud. Sa gate opérateur reste toutefois **FAIL** malgré le passage de `cargo check`, Clippy strict et des trois suites ciblées : `git diff --check` détecte une ligne vide supplémentaire en fin de `docs/validation/001-VALIDATION_MATRIX.md`.
|
||||
|
||||
`alpha.3.fix.3` corrige exclusivement cette anomalie documentaire de fin de fichier, conserve les corrections Rust déjà validées et rejoue la gate complète avant clôture d'`alpha.3`.
|
||||
|
||||
Le scope fonctionnel de `alpha.3` reste : introduire uniquement les premiers contrats/types nécessaires aux frontières `GitRepository`, source/famille de contenu et synchronisation, avec tests ciblés. Le modèle doit supporter au moins les trois sources initiales sans coder une limite à trois.
|
||||
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
<!-- file: docs/validation/001-VALIDATION_MATRIX.md -->
|
||||
<!-- version: 6 -->
|
||||
<!-- version: 7 -->
|
||||
|
||||
# Matrice de validation Knowledge
|
||||
|
||||
@@ -214,3 +214,20 @@ Le second fix doit prouver :
|
||||
- aucun frontend, serveur Actix, schéma PostgreSQL ou adapter de forge ajouté ;
|
||||
- hygiène Git et documentation propres.
|
||||
|
||||
## Gate de `0.0.1-alpha.3.fix.3`
|
||||
|
||||
Le troisième fix doit prouver :
|
||||
|
||||
- `VERSION = 0.0.1-alpha.3.fix.3` et version workspace identique ;
|
||||
- history `alpha.3.fix.2` `FAIL` committé avant application du fix ;
|
||||
- `docs/validation/001-VALIDATION_MATRIX.md` se termine par exactement une fin de ligne, sans ligne vide supplémentaire ;
|
||||
- `git diff --check` `PASS` avant clôture de tranche ;
|
||||
- documentation des quatre variantes publiques `ContentFamily` conservée ;
|
||||
- aucun `allow(missing_docs)` ajouté et politique `missing_docs` inchangée ;
|
||||
- audits Rust PGR sélectionnés propres ;
|
||||
- `cargo check --workspace` `PASS` ;
|
||||
- Clippy workspace strict `-D warnings` `PASS` ;
|
||||
- les trois suites ciblées `knowledge-domain-lib`, `knowledge-git-api` et `knowledge-sync-api` `PASS` ;
|
||||
- aucune modification fonctionnelle des contrats domaine/Git/synchronisation ;
|
||||
- aucun frontend, serveur Actix, schéma PostgreSQL ou adapter de forge ajouté ;
|
||||
- staging Git propre à la tranche.
|
||||
|
||||
100
history/0.0.1/alpha.3.fix.3.md
Normal file
100
history/0.0.1/alpha.3.fix.3.md
Normal file
@@ -0,0 +1,100 @@
|
||||
<!-- file: history/0.0.1/alpha.3.fix.3.md -->
|
||||
<!-- version: 1 -->
|
||||
|
||||
# History 0.0.1-alpha.3.fix.3 — hygiène Markdown de la matrice de validation
|
||||
|
||||
## Statut
|
||||
|
||||
PASS
|
||||
|
||||
La gate opérateur de `0.0.1-alpha.3.fix.3` exécutée le `2026-09-27` est propre.
|
||||
|
||||
## Baseline opérateur
|
||||
|
||||
`alpha.3.fix.2` `FAIL` a été historisé, committé et poussé avant application du troisième fix :
|
||||
|
||||
```text
|
||||
history/0.0.1/alpha.3.fix.2.md = FAIL
|
||||
commit 3802476
|
||||
message 0.0.1-alpha.3.fix.2
|
||||
branch master
|
||||
push origin/master PASS
|
||||
status clean après push
|
||||
```
|
||||
|
||||
Le push observé a avancé `origin/master` de `fd3d363` à `3802476`.
|
||||
|
||||
## Hygiène documentaire
|
||||
|
||||
Les contrôles suivants passent :
|
||||
|
||||
```text
|
||||
VERSION = 0.0.1-alpha.3.fix.3
|
||||
git diff --check = PASS
|
||||
Knowledge 0.0.1-alpha.3.fix.3 structural audit: clean
|
||||
```
|
||||
|
||||
`docs/validation/001-VALIDATION_MATRIX.md` se termine par une seule fin de ligne et ne produit plus de diagnostic `new blank line at EOF`.
|
||||
|
||||
## Audits Rust PGR
|
||||
|
||||
Les audits sélectionnés passent :
|
||||
|
||||
```text
|
||||
Rust blank-line audit: clean (8 file(s))
|
||||
Rust item-spacing audit: clean (8 file(s))
|
||||
Rust module-order audit: clean (8 file(s))
|
||||
Rust trait-import-block audit: clean (8 file(s))
|
||||
Rust re-export-block audit: clean (8 file(s))
|
||||
Rust export completeness audit: 0 candidate(s) across 3 package(s)
|
||||
```
|
||||
|
||||
## Cargo et Clippy
|
||||
|
||||
Les trois crates sont observées en version `0.0.1-alpha.3.fix.3`.
|
||||
|
||||
Les commandes suivantes passent :
|
||||
|
||||
```text
|
||||
cargo check --workspace PASS
|
||||
cargo clippy --workspace --all-targets --all-features
|
||||
-- -D warnings PASS
|
||||
```
|
||||
|
||||
## Tests ciblés
|
||||
|
||||
Résultats :
|
||||
|
||||
```text
|
||||
knowledge-domain-lib : 3 passed; 0 failed
|
||||
knowledge-git-api : 1 passed; 0 failed
|
||||
knowledge-sync-api : 1 passed; 0 failed
|
||||
```
|
||||
|
||||
Les corrections successives d'`alpha.3` sont donc closes :
|
||||
|
||||
- `alpha.3` : `FAIL` sur construction de `SourceId` ;
|
||||
- `alpha.3.fix.1` : `FAIL` sur `missing_docs` ;
|
||||
- `alpha.3.fix.2` : `FAIL` sur hygiène de fin de fichier ;
|
||||
- `alpha.3.fix.3` : `PASS`.
|
||||
|
||||
## Staging observé
|
||||
|
||||
Après la gate :
|
||||
|
||||
```text
|
||||
M Cargo.lock
|
||||
M Cargo.toml
|
||||
M VERSION
|
||||
A deltas/0.0.1/alpha.3.fix.3.md
|
||||
M docs/plans/001-V0_0_1_FOUNDATION_PLAN.md
|
||||
M docs/validation/001-VALIDATION_MATRIX.md
|
||||
```
|
||||
|
||||
`git diff --cached --check` est propre.
|
||||
|
||||
## Décision
|
||||
|
||||
`0.0.1-alpha.3.fix.3` est `PASS`.
|
||||
|
||||
La transition autorisée est `0.0.1-alpha.4`, consacrée à la baseline Web indépendante et au laboratoire de templates statiques de référence.
|
||||
Reference in New Issue
Block a user