docs: runbook for the first companyOS kernel deployment (SuperCleanOS) #1

Merged

john merged 2 commits from feat/superclean-runbook into dev 2026-07-27 00:30:26 +00:00

Conversation 0 Commits 2 Files changed 2 +105 -1

john commented 2026-07-27 00:27:18 +00:00

Owner

Copy link

Three phases. Phase 0 is the only one safe to run today.

Phase 0 lands an include_object filter in superclean-sys2/backend/alembic/env.py. Without it, autogenerate against a production-derived database proposes a DROP for all nine kernel tables. Changes no production state and is worth doing regardless.

Phase 1 creates the nine tables in SuperClean's production database. Gated on human approval.

Phase 2 has superclean-api import the library and read the shared database directly rather than calling the kernel over HTTP.

Collision check run against the live schema on 2026-07-27: superclean_prod_db holds 30 tables plus alembic_version, none intersecting the kernel's nine or alembic_version_kernel.

Three phases. Phase 0 is the only one safe to run today. **Phase 0** lands an `include_object` filter in `superclean-sys2/backend/alembic/env.py`. Without it, autogenerate against a production-derived database proposes a DROP for all nine kernel tables. Changes no production state and is worth doing regardless. **Phase 1** creates the nine tables in SuperClean's production database. Gated on human approval. **Phase 2** has `superclean-api` import the library and read the shared database directly rather than calling the kernel over HTTP. Collision check run against the live schema on 2026-07-27: `superclean_prod_db` holds 30 tables plus `alembic_version`, none intersecting the kernel's nine or `alembic_version_kernel`.

john added 1 commit 2026-07-27 00:27:18 +00:00

docs: runbook for the first companyOS kernel deployment (SuperCleanOS) ... 95942d920b

Phase 0 lands the autogenerate filter in superclean-sys2 and touches no production
state. Phase 1 creates the nine kernel tables in SuperClean's production database and
is gated on human approval. Phase 2 has superclean-api import the library rather than
call the API over HTTP.

Collision check done against the live schema on 2026-07-27: superclean_prod_db holds
30 tables plus alembic_version, none of which intersect the kernel's nine or
alembic_version_kernel.

john referenced this pull request from a commit 2026-07-27 00:28:56 +00:00

fix(ci): doc-only changes must not fail Detect Changes

john added 1 commit 2026-07-27 00:28:56 +00:00

fix(ci): doc-only changes must not fail Detect Changes ... 7959b8588a

On a doc-only diff the first grep -v filters every path out, the second grep gets
empty input and exits 1, and the runner's shell fails the step. PR #1 — a pure docs
change — went red on exactly this.

The same line is present in haskos-engineering's workflow and has the same latent
bug there.

john merged commit aaac56bc53 into dev 2026-07-27 00:30:26 +00:00

john referenced this pull request from a commit 2026-07-27 00:30:27 +00:00

Merge pull request 'docs: runbook for the first companyOS kernel deployment (SuperCleanOS)' (#1) from feat/superclean-runbook into dev

john deleted branch feat/superclean-runbook 2026-07-27 00:30:27 +00:00

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels

No items

No labels

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

haskytech/companyos-kernel!1

No description provided.