kontextual-engine/workplans/KONT-WP-0015-first-release-readiness.md

id: KONT-WP-0015 type: workplan title: "First Release Readiness" domain: communication repo: kontextual-engine status: completed owner: codex topic_slug: markitect planning_priority: high planning_order: 16 created: "2026-05-14" updated: "2026-05-14" state_hub_workstream_id: "cb525023-1139-4d6c-9226-d6fdd1f5fd8f" depends_on_workplans: - KONT-WP-0016--- # KONT-WP-0015: First Release Readiness ## Purpose Prepare kontextual-engine for a controlled 0.1.0 preview release. The goal is not to add broad new scope; it is to make the current foundation reproducible, honest, operable, and easy to validate. ## References - docs/first-release-readiness.md - docs/cmis-1-1-capability-scorecard.md - docs/cmis-opencmis-tck-release-readiness-evidence-2026-05-14T003705Z.md - docs/release-runbook-0.1.0.md - docs/release-security-configuration-storage-review.md - CHANGELOG.md - docs/blob-storage-content-streaming-workplan.md - workplans/KONT-WP-0016-cmis-read-side-contract-maturity.md - pyproject.toml - tests/ - /home/worsch/guide-board - /home/worsch/open-cmis-tck ## Architecture Boundary This workplan should harden the release envelope without changing the engine's scope. CMIS remains a profiled Browser Binding adapter above native services. Blob storage, policy, audit, and State Hub integration remain authoritative release concerns. KONT-WP-0016 is a pre-release dependency unless explicitly waived for an internal-only release. ## D15.1 - Final Verification Pass task id: KONT-WP-0015-T001 status: done priority: high state_hub_task_id: "82ee46b4-d865-4741-b60c-083f06210c4d" Acceptance: - Full venv test suite passes. - Focused CMIS tests pass without skipped service dependencies. - OpenCMIS selected baseline is rerun after final release edits. - Performance drift warnings are either absent under a quiet system or recorded as advisory release notes. ## D15.2 - Packaging And Install Smoke task id: KONT-WP-0015-T002 status: done priority: high state_hub_task_id: "7e5398e0-0c54-44cc-b63c-04bc9f0edabb" Acceptance: - pyproject.toml version and optional extras are release-appropriate. - Wheel and source distribution build successfully. - A clean install can import kontextual_engine and create the FastAPI app with service extras installed. - Release artifacts do not depend on local sibling repos unless the optional extras explicitly declare that boundary. ## D15.3 - Security, Configuration, And Storage Review task id: KONT-WP-0015-T003 status: done priority: high state_hub_task_id: "724b6882-f76e-4452-91d8-e56dda215cfe" Acceptance: - CMIS access-point profiles and default exposure are reviewed. - Production-facing CMIS endpoints require HTTPS termination. - Actor headers, service-account expectations, and profile gates are documented. - Local blob and S3 backend configuration are documented with backup/restore expectations. - Secrets and credentials are not embedded in examples or runtime defaults. ## D15.4 - Operations And Runbook Readiness task id: KONT-WP-0015-T004 status: done priority: medium state_hub_task_id: "298b2628-139e-4e74-8790-dd0e92d091f3" Acceptance: - Health checks, logs, performance history, and accepted local warnings are documented in a release runbook. - Known limitations are listed in release notes. - Rollback and data-safety expectations are documented for preview deployments. - State Hub consistency check passes and registers this workplan. ## D15.5 - Release Notes And Tag Gate task id: KONT-WP-0015-T005 status: done priority: medium state_hub_task_id: "bf42c477-2d21-48dc-9469-a6ce90982928" Acceptance: - Release notes summarize implemented capabilities, CMIS evidence, storage posture, and known limitations. - Any waived gate has an explicit rationale and follow-up workplan item. - The release tag is created only after the go/no-go gates are complete or intentionally waived. ## Implementation Evidence Completed on 2026-05-14 for the controlled 0.1.0 preview: - Full venv suite passed: .venv/bin/python -m pytest -q -> 166 passed, 15 skipped in 42.23s. - Focused CMIS tests passed: .venv/bin/python -m pytest tests/cmis/test_cmis_browser_binding_api.py tests/cmis/test_cmis_runtime_browser_binding.py tests/cmis/test_cmis_compliance_flags.py tests/cmis/test_cmis_contract_examples.py -q -> 37 passed. - OpenCMIS selected baseline persisted: run-20260514T003705Z, completed, 0 unexpected findings, object/content passed, only local HTTP loopback warning remains. - Packaging smoke passed: python3 -m build --sdist --wheel --outdir /tmp/kontextual-release-smoke-20260514T010625Z/dist produced wheel and sdist. - Clean install smoke passed: installed /tmp/kontextual-release-smoke-20260514T010625Z/dist/kontextual_engine-0.1.0-py3-none-any.whl[service] into a throwaway venv and verified package version, FastAPI app creation, and runtime attachment. - pyproject.toml license metadata was modernized to the SPDX-style string MIT, removing the setuptools license-table deprecation warning from release builds. - Release runbook, security/configuration/storage review, and changelog were added. No release tag was created by this workplan. The tag gate is documented in docs/release-runbook-0.1.0.md; tagging remains a deliberate operator action after final review of the target deployment.