---
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.