Rust-hybrid Phase 7: SDK full-index alignment

[jununfly]

This was generated by AI during triage.

What to track

Track Rust-Hybrid Phase 7 implementation for SDK full-index alignment.

Plan: docs/plans/2026-06-19-rust-hybrid-phase-7-sdk-full-index-alignment.md

Phase 7 aligns the programmatic SDK full-index entry points with the CLI rust-hybrid first-user strategy. It changes SDK full-index defaults and explicit engine selection while keeping README/release messaging, packaged smoke, watch/sync semantics, and performance optimization out of scope.

This tracker does not claim final first-user release readiness.

Acceptance criteria

• SDK engine option contract is implemented.
• SDK full-index defaults use rust-hybrid.
• SDK fail-safe behavior matches CLI rust-hybrid process/system failure semantics.
• SDK language-level fallback and Rust-owned per-file gap fallback work.
• npm/embedded SDK shim contract remains aligned.
• Evidence doc is written under docs/benchmarks/.
• Decision doc is written under docs/plans/.
• Decision explicitly does not claim final first-user release readiness.

Child issues

To be linked after creation.

[jununfly]

This was generated by AI during triage.

Phase 7 issue sequence

Execute in this dependency order:

1. Rust-hybrid Phase 7.1: Add SDK engine option contract #264 - SDK engine option contract.
2. Rust-hybrid Phase 7.2: Switch SDK full-index defaults to rust-hybrid #265 - SDK default rust-hybrid full-index path, blocked by Rust-hybrid Phase 7.1: Add SDK engine option contract #264.
3. Rust-hybrid Phase 7.3: Preserve SDK rust-hybrid fallback semantics #266 - SDK hybrid fallback semantics, blocked by Rust-hybrid Phase 7.2: Switch SDK full-index defaults to rust-hybrid #265.
4. Rust-hybrid Phase 7.4: Align npm SDK shim contract #267 - npm SDK shim contract, blocked by Rust-hybrid Phase 7.3: Preserve SDK rust-hybrid fallback semantics #266.
5. Rust-hybrid Phase 7.5: Record SDK alignment evidence and decision #268 - Evidence and decision, blocked by Rust-hybrid Phase 7.4: Align npm SDK shim contract #267.

Plan file:

docs/plans/2026-06-19-rust-hybrid-phase-7-sdk-full-index-alignment.md

[jununfly]

This was generated by AI during triage.

Phase 7 completed in commit 96bf5a2.

Closed child issues:

• Rust-hybrid Phase 7.1: Add SDK engine option contract #264 SDK engine option contract
• Rust-hybrid Phase 7.2: Switch SDK full-index defaults to rust-hybrid #265 SDK default rust-hybrid full-index path
• Rust-hybrid Phase 7.3: Preserve SDK rust-hybrid fallback semantics #266 SDK rust-hybrid fallback semantics
• Rust-hybrid Phase 7.4: Align npm SDK shim contract #267 npm SDK shim contract
• Rust-hybrid Phase 7.5: Record SDK alignment evidence and decision #268 evidence and decision

Artifacts:

• Evidence: docs/benchmarks/2026-06-19-rust-hybrid-phase-7-sdk-alignment-evidence.md
• Decision: docs/plans/2026-06-19-rust-hybrid-phase-7-decision.md

Final validation:

• npm run build
• npx vitest run __tests__/sdk-rust-hybrid.test.ts __tests__/npm-sdk.test.ts __tests__/rust-index-engine-cli.test.ts
• npx vitest run __tests__/rust-indexing-experiment.test.ts
• npm test => 134 passed, 1 skipped; 1835 tests passed, 15 skipped.

Outcome: Phase 7 accepted as SDK full-index alignment. This does not claim final first-user release readiness.