docs: add release checklist and v0.1.0 release notes

Author: kygeospatial

docs/release-checklist.md

@@ -0,0 +1,67 @@
+# Release Checklist
+
+Use this checklist for every FaultLine release.
+
+## 1. Pre-flight
+- Confirm working tree is clean: `git status --short`
+- Confirm current branch and target tag.
+- Confirm crates.io auth is valid: `cargo login --help` (or previous successful login in current session).
+
+## 2. Quality Gates
+- Run format gate: `cargo fmt --all -- --check`
+- Run lint gate: `cargo clippy --workspace --all-targets -- -D warnings`
+- Run test gate: `cargo test --workspace`
+- Run compile gate: `cargo check --workspace`
+
+## 3. Metadata and Docs
+- Verify each crate has:
+  - `description`
+  - `license`
+  - `repository`
+  - `homepage`
+  - `documentation`
+  - `keywords`
+  - `categories`
+  - `readme`
+  - `rust-version`
+- Ensure crate `README.md` files exist and are current.
+- Ensure top-level `README.md` badges and links point to the live repository.
+
+## 4. Versioning and Dependency Alignment
+- Bump versions in crate manifests as needed.
+- For internal crate dependencies, include both `version` and `path`.
+- Validate dependency publish order from root to leaves:
+  1. `faultline_core`
+  2. `faultline_geometry`
+  3. `faultline_diff`
+  4. `faultline_sync`
+  5. `faultline_index`
+  6. `faultline_compute`
+  7. `faultline_agents`
+
+## 5. Publish Verification
+- Dry-run first-order crates:
+  - `cargo publish --dry-run -p faultline_core`
+  - `cargo publish --dry-run -p faultline_geometry`
+- For local WIP trees, if needed use `--allow-dirty` intentionally.
+- Note: dependent crate dry-runs may fail until upstream crates are actually published.
+
+## 6. Publish Execution
+- Publish in dependency order using `cargo publish -p <crate>`.
+- If crates.io returns `429 Too Many Requests`:
+  - Wait until the exact retry timestamp from the error.
+  - Retry only the failed crate.
+
+## 7. Post-publish Verification
+- Confirm visibility on crates.io: `cargo info <crate>` from outside workspace (for example `/tmp`).
+- Confirm docs.rs pages are building for all crates.
+
+## 8. Git and Release Artifacts
+- Commit final release docs/metadata updates.
+- Tag release: `git tag -a vX.Y.Z -m "FaultLine crates X.Y.Z release"`
+- Push branch and tag.
+- Create GitHub Release with notes and crate links.
+
+## 9. Follow-up
+- Open next milestone issue for patch release tasks.
+- Capture any publish incidents in this checklist.

docs/releases/v0.1.0.md

@@ -0,0 +1,33 @@
+# FaultLine v0.1.0
+
+Initial public crate release for the FaultLine Rust workspace.
+
+## Published Crates
+- `faultline_core` - Canonical domain models, identifiers, and manifests.
+- `faultline_geometry` - Geometry abstractions and spatial metric contracts.
+- `faultline_diff` - Diff and change classification contracts.
+- `faultline_sync` - Local-first synchronization models and operation envelopes.
+- `faultline_index` - Spatial index abstractions.
+- `faultline_compute` - Execution backend abstractions.
+- `faultline_agents` - Planner/executor/reviewer orchestration contracts.
+
+## Highlights
+- Established stable `0.1.0` contracts across all core workspace crates.
+- Added deterministic diff artifact models and baseline compare engine.
+- Added sync operation envelopes, causal context, and in-memory session behavior.
+- Added compute backend and index abstraction traits with baseline implementations.
+- Added agent workflow graph, tool registry, and artifact store contracts.
+
+## Quality Gates
+Release passed:
+- `cargo fmt --all -- --check`
+- `cargo clippy --workspace --all-targets -- -D warnings`
+- `cargo test --workspace`
+- `cargo check --workspace`
+
+## Repository
+- GitHub: https://github.com/chrislyonsKY/FaultLine
+- Tag: `v0.1.0`
+
+## Notes
+This release is architecture- and contract-first, with research-heavy implementations intentionally deferred to subsequent milestones.