generated from coulomb/repo-seed
166 lines
5.3 KiB
Markdown
166 lines
5.3 KiB
Markdown
---
|
|
id: KONT-WP-0015
|
|
type: workplan
|
|
title: "First Release Readiness"
|
|
domain: markitect
|
|
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.
|