@polderlabs/bizar-omp 0.7.0 → 0.7.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +6 -4
- package/dist/cli/agents-ink.d.ts.map +1 -1
- package/dist/cli/agents-ink.js +5 -3
- package/dist/cli/agents-ink.js.map +1 -1
- package/dist/cli/agents.d.ts.map +1 -1
- package/dist/cli/agents.js +26 -8
- package/dist/cli/agents.js.map +1 -1
- package/dist/cli/doctor.d.ts +4 -4
- package/dist/cli/main.js +0 -0
- package/dist/cli/omb.js +0 -0
- package/dist/core/recovery.d.ts.map +1 -1
- package/dist/core/recovery.js +10 -5
- package/dist/core/recovery.js.map +1 -1
- package/dist/core/transitions.d.ts +4 -0
- package/dist/core/transitions.d.ts.map +1 -1
- package/dist/core/transitions.js +12 -2
- package/dist/core/transitions.js.map +1 -1
- package/dist/core/types.d.ts +46 -0
- package/dist/core/types.d.ts.map +1 -1
- package/dist/extension.d.ts +2 -0
- package/dist/extension.d.ts.map +1 -1
- package/dist/extension.js +174 -16
- package/dist/extension.js.map +1 -1
- package/dist/omp/compatibility.d.ts +5 -5
- package/dist/omp/compatibility.d.ts.map +1 -1
- package/dist/omp/compatibility.js +2 -2
- package/dist/omp/compatibility.js.map +1 -1
- package/dist/omp/daemon-service.d.ts.map +1 -1
- package/dist/omp/daemon-service.js +53 -20
- package/dist/omp/daemon-service.js.map +1 -1
- package/dist/omp/daemon.d.ts.map +1 -1
- package/dist/omp/daemon.js +57 -17
- package/dist/omp/daemon.js.map +1 -1
- package/dist/omp/dashboard-html.js +5 -5
- package/dist/omp/dispatch-admission.js +1 -1
- package/dist/omp/dispatch-admission.js.map +1 -1
- package/dist/omp/model-role-assignment.d.ts +4 -0
- package/dist/omp/model-role-assignment.d.ts.map +1 -1
- package/dist/omp/model-role-assignment.js +84 -8
- package/dist/omp/model-role-assignment.js.map +1 -1
- package/dist/omp/omb-sessions.d.ts +22 -7
- package/dist/omp/omb-sessions.d.ts.map +1 -1
- package/dist/omp/omb-sessions.js +83 -11
- package/dist/omp/omb-sessions.js.map +1 -1
- package/dist/omp/omb-settings.d.ts +15 -1
- package/dist/omp/omb-settings.d.ts.map +1 -1
- package/dist/omp/omb-settings.js +107 -31
- package/dist/omp/omb-settings.js.map +1 -1
- package/dist/omp/rpc.d.ts +8 -0
- package/dist/omp/rpc.d.ts.map +1 -1
- package/dist/omp/session-activity.d.ts +5 -0
- package/dist/omp/session-activity.d.ts.map +1 -1
- package/dist/omp/session-activity.js +17 -0
- package/dist/omp/session-activity.js.map +1 -1
- package/dist/omp/tmux.d.ts.map +1 -1
- package/dist/omp/tmux.js +110 -14
- package/dist/omp/tmux.js.map +1 -1
- package/dist/services/candidate-verify.d.ts.map +1 -1
- package/dist/services/candidate-verify.js +44 -1
- package/dist/services/candidate-verify.js.map +1 -1
- package/dist/services/inspector.d.ts +5 -1
- package/dist/services/inspector.d.ts.map +1 -1
- package/dist/services/inspector.js +11 -2
- package/dist/services/inspector.js.map +1 -1
- package/dist/services/native-review-ingest.d.ts +35 -0
- package/dist/services/native-review-ingest.d.ts.map +1 -0
- package/dist/services/native-review-ingest.js +14 -0
- package/dist/services/native-review-ingest.js.map +1 -0
- package/dist/tools/integrate.d.ts.map +1 -1
- package/dist/tools/integrate.js +13 -0
- package/dist/tools/integrate.js.map +1 -1
- package/dist/tools/workflow.d.ts +9 -0
- package/dist/tools/workflow.d.ts.map +1 -1
- package/dist/tools/workflow.js +25 -2
- package/dist/tools/workflow.js.map +1 -1
- package/docs/compatibility/baseline.json +8 -7
- package/docs/compatibility/supported-surfaces.json +2 -1
- package/docs/development/ci-release-implementation-guide.md +1259 -0
- package/docs/development/contributing-and-releasing.md +117 -0
- package/docs/development/omp-compatibility-update-guide.md +117 -0
- package/docs/releases/0.7.1.md +15 -0
- package/docs/releases/native-stable.md +11 -1
- package/docs/releases/npm-publishing.md +23 -4
- package/docs/releases/support-matrix.md +1 -1
- package/package.json +2 -1
- package/rules/oflow-gitlab.md +6 -0
- package/skills/oflow-gitlab-context/SKILL.md +49 -0
- package/skills/omp-native-development/SKILL.md +1 -1
- package/skills/omp-native-development/references/accuracy-and-versioning.md +1 -1
- package/skills/omp-native-development/references/source-manifest.json +3 -3
- package/dist/src/cli/agents-ink.d.ts +0 -25
- package/dist/src/cli/agents-ink.js +0 -517
- package/dist/src/cli/agents-ink.js.map +0 -1
- package/dist/src/cli/agents.d.ts +0 -14
- package/dist/src/cli/agents.js +0 -197
- package/dist/src/cli/agents.js.map +0 -1
- package/dist/src/cli/directory-selector.d.ts +0 -60
- package/dist/src/cli/directory-selector.js +0 -208
- package/dist/src/cli/directory-selector.js.map +0 -1
- package/dist/src/cli/doctor.d.ts +0 -41
- package/dist/src/cli/doctor.js +0 -31
- package/dist/src/cli/doctor.js.map +0 -1
- package/dist/src/cli/install.d.ts +0 -129
- package/dist/src/cli/install.js +0 -164
- package/dist/src/cli/install.js.map +0 -1
- package/dist/src/cli/main.d.ts +0 -2
- package/dist/src/cli/main.js +0 -117
- package/dist/src/cli/main.js.map +0 -1
- package/dist/src/cli/migrate.d.ts +0 -18
- package/dist/src/cli/migrate.js +0 -14
- package/dist/src/cli/migrate.js.map +0 -1
- package/dist/src/cli/omb-commands.d.ts +0 -29
- package/dist/src/cli/omb-commands.js +0 -107
- package/dist/src/cli/omb-commands.js.map +0 -1
- package/dist/src/cli/omb-daemon.d.ts +0 -2
- package/dist/src/cli/omb-daemon.js +0 -135
- package/dist/src/cli/omb-daemon.js.map +0 -1
- package/dist/src/cli/omb-dashboard.d.ts +0 -12
- package/dist/src/cli/omb-dashboard.js +0 -113
- package/dist/src/cli/omb-dashboard.js.map +0 -1
- package/dist/src/cli/omb-invocation.d.ts +0 -8
- package/dist/src/cli/omb-invocation.js +0 -41
- package/dist/src/cli/omb-invocation.js.map +0 -1
- package/dist/src/cli/omb-runtime.d.ts +0 -41
- package/dist/src/cli/omb-runtime.js +0 -371
- package/dist/src/cli/omb-runtime.js.map +0 -1
- package/dist/src/cli/omb-tray.d.ts +0 -2
- package/dist/src/cli/omb-tray.js +0 -38
- package/dist/src/cli/omb-tray.js.map +0 -1
- package/dist/src/cli/omb.d.ts +0 -2
- package/dist/src/cli/omb.js +0 -31
- package/dist/src/cli/omb.js.map +0 -1
- package/dist/src/cli/omp-theme.d.ts +0 -17
- package/dist/src/cli/omp-theme.js +0 -22
- package/dist/src/cli/omp-theme.js.map +0 -1
- package/dist/src/cli/process.d.ts +0 -6
- package/dist/src/cli/process.js +0 -54
- package/dist/src/cli/process.js.map +0 -1
- package/dist/src/cli/run.d.ts +0 -2
- package/dist/src/cli/run.js +0 -5
- package/dist/src/cli/run.js.map +0 -1
- package/dist/src/cli/setup-ui.d.ts +0 -37
- package/dist/src/cli/setup-ui.js +0 -90
- package/dist/src/cli/setup-ui.js.map +0 -1
- package/dist/src/core/acceptance.d.ts +0 -32
- package/dist/src/core/acceptance.js +0 -87
- package/dist/src/core/acceptance.js.map +0 -1
- package/dist/src/core/errors.d.ts +0 -20
- package/dist/src/core/errors.js +0 -30
- package/dist/src/core/errors.js.map +0 -1
- package/dist/src/core/evidence.d.ts +0 -10
- package/dist/src/core/evidence.js +0 -35
- package/dist/src/core/evidence.js.map +0 -1
- package/dist/src/core/policies.d.ts +0 -10
- package/dist/src/core/policies.js +0 -60
- package/dist/src/core/policies.js.map +0 -1
- package/dist/src/core/recovery.d.ts +0 -6
- package/dist/src/core/recovery.js +0 -56
- package/dist/src/core/recovery.js.map +0 -1
- package/dist/src/core/transitions.d.ts +0 -13
- package/dist/src/core/transitions.js +0 -59
- package/dist/src/core/transitions.js.map +0 -1
- package/dist/src/core/types.d.ts +0 -256
- package/dist/src/core/types.js +0 -2
- package/dist/src/core/types.js.map +0 -1
- package/dist/src/extension.d.ts +0 -60
- package/dist/src/extension.js +0 -538
- package/dist/src/extension.js.map +0 -1
- package/dist/src/index.d.ts +0 -29
- package/dist/src/index.js +0 -30
- package/dist/src/index.js.map +0 -1
- package/dist/src/omp/autonomous-settings.d.ts +0 -14
- package/dist/src/omp/autonomous-settings.js +0 -65
- package/dist/src/omp/autonomous-settings.js.map +0 -1
- package/dist/src/omp/capabilities.d.ts +0 -23
- package/dist/src/omp/capabilities.js +0 -6
- package/dist/src/omp/capabilities.js.map +0 -1
- package/dist/src/omp/compatibility.d.ts +0 -30
- package/dist/src/omp/compatibility.js +0 -34
- package/dist/src/omp/compatibility.js.map +0 -1
- package/dist/src/omp/completion.d.ts +0 -7
- package/dist/src/omp/completion.js +0 -10
- package/dist/src/omp/completion.js.map +0 -1
- package/dist/src/omp/config.d.ts +0 -10
- package/dist/src/omp/config.js +0 -14
- package/dist/src/omp/config.js.map +0 -1
- package/dist/src/omp/context.d.ts +0 -15
- package/dist/src/omp/context.js +0 -3
- package/dist/src/omp/context.js.map +0 -1
- package/dist/src/omp/daemon-service.d.ts +0 -25
- package/dist/src/omp/daemon-service.js +0 -483
- package/dist/src/omp/daemon-service.js.map +0 -1
- package/dist/src/omp/daemon.d.ts +0 -48
- package/dist/src/omp/daemon.js +0 -194
- package/dist/src/omp/daemon.js.map +0 -1
- package/dist/src/omp/dashboard-html.d.ts +0 -3
- package/dist/src/omp/dashboard-html.js +0 -419
- package/dist/src/omp/dashboard-html.js.map +0 -1
- package/dist/src/omp/dispatch-admission.d.ts +0 -2
- package/dist/src/omp/dispatch-admission.js +0 -12
- package/dist/src/omp/dispatch-admission.js.map +0 -1
- package/dist/src/omp/integration-recovery.d.ts +0 -10
- package/dist/src/omp/integration-recovery.js +0 -18
- package/dist/src/omp/integration-recovery.js.map +0 -1
- package/dist/src/omp/isolation-policy.d.ts +0 -14
- package/dist/src/omp/isolation-policy.js +0 -9
- package/dist/src/omp/isolation-policy.js.map +0 -1
- package/dist/src/omp/lifecycle.d.ts +0 -14
- package/dist/src/omp/lifecycle.js +0 -14
- package/dist/src/omp/lifecycle.js.map +0 -1
- package/dist/src/omp/memory.d.ts +0 -16
- package/dist/src/omp/memory.js +0 -4
- package/dist/src/omp/memory.js.map +0 -1
- package/dist/src/omp/model-role-assignment.d.ts +0 -296
- package/dist/src/omp/model-role-assignment.js +0 -559
- package/dist/src/omp/model-role-assignment.js.map +0 -1
- package/dist/src/omp/model-roles.d.ts +0 -19
- package/dist/src/omp/model-roles.js +0 -6
- package/dist/src/omp/model-roles.js.map +0 -1
- package/dist/src/omp/omb-sessions.d.ts +0 -122
- package/dist/src/omp/omb-sessions.js +0 -512
- package/dist/src/omp/omb-sessions.js.map +0 -1
- package/dist/src/omp/omb-settings.d.ts +0 -35
- package/dist/src/omp/omb-settings.js +0 -104
- package/dist/src/omp/omb-settings.js.map +0 -1
- package/dist/src/omp/result-reconciliation.d.ts +0 -2
- package/dist/src/omp/result-reconciliation.js +0 -9
- package/dist/src/omp/result-reconciliation.js.map +0 -1
- package/dist/src/omp/rpc.d.ts +0 -67
- package/dist/src/omp/rpc.js +0 -4
- package/dist/src/omp/rpc.js.map +0 -1
- package/dist/src/omp/run-log.d.ts +0 -25
- package/dist/src/omp/run-log.js +0 -24
- package/dist/src/omp/run-log.js.map +0 -1
- package/dist/src/omp/session-activity.d.ts +0 -70
- package/dist/src/omp/session-activity.js +0 -361
- package/dist/src/omp/session-activity.js.map +0 -1
- package/dist/src/omp/session-controls.d.ts +0 -17
- package/dist/src/omp/session-controls.js +0 -14
- package/dist/src/omp/session-controls.js.map +0 -1
- package/dist/src/omp/tmux.d.ts +0 -89
- package/dist/src/omp/tmux.js +0 -445
- package/dist/src/omp/tmux.js.map +0 -1
- package/dist/src/omp/tray-icons.d.ts +0 -5
- package/dist/src/omp/tray-icons.js +0 -78
- package/dist/src/omp/tray-icons.js.map +0 -1
- package/dist/src/omp/tray.d.ts +0 -23
- package/dist/src/omp/tray.js +0 -167
- package/dist/src/omp/tray.js.map +0 -1
- package/dist/src/services/budget.d.ts +0 -19
- package/dist/src/services/budget.js +0 -10
- package/dist/src/services/budget.js.map +0 -1
- package/dist/src/services/candidate-local.d.ts +0 -13
- package/dist/src/services/candidate-local.js +0 -15
- package/dist/src/services/candidate-local.js.map +0 -1
- package/dist/src/services/candidates.d.ts +0 -20
- package/dist/src/services/candidates.js +0 -100
- package/dist/src/services/candidates.js.map +0 -1
- package/dist/src/services/evidence-bundle.d.ts +0 -17
- package/dist/src/services/evidence-bundle.js +0 -21
- package/dist/src/services/evidence-bundle.js.map +0 -1
- package/dist/src/services/inspector.d.ts +0 -11
- package/dist/src/services/inspector.js +0 -6
- package/dist/src/services/inspector.js.map +0 -1
- package/dist/src/services/lessons.d.ts +0 -13
- package/dist/src/services/lessons.js +0 -11
- package/dist/src/services/lessons.js.map +0 -1
- package/dist/src/services/projection.d.ts +0 -21
- package/dist/src/services/projection.js +0 -10
- package/dist/src/services/projection.js.map +0 -1
- package/dist/src/services/readiness.d.ts +0 -4
- package/dist/src/services/readiness.js +0 -35
- package/dist/src/services/readiness.js.map +0 -1
- package/dist/src/services/recipes.d.ts +0 -15
- package/dist/src/services/recipes.js +0 -42
- package/dist/src/services/recipes.js.map +0 -1
- package/dist/src/services/recovery.d.ts +0 -19
- package/dist/src/services/recovery.js +0 -9
- package/dist/src/services/recovery.js.map +0 -1
- package/dist/src/services/review.d.ts +0 -15
- package/dist/src/services/review.js +0 -9
- package/dist/src/services/review.js.map +0 -1
- package/dist/src/storage/journal-recovery.d.ts +0 -10
- package/dist/src/storage/journal-recovery.js +0 -33
- package/dist/src/storage/journal-recovery.js.map +0 -1
- package/dist/src/storage/journal.d.ts +0 -12
- package/dist/src/storage/journal.js +0 -82
- package/dist/src/storage/journal.js.map +0 -1
- package/dist/src/storage/migrations.d.ts +0 -22
- package/dist/src/storage/migrations.js +0 -107
- package/dist/src/storage/migrations.js.map +0 -1
- package/dist/src/storage/repository-identity.d.ts +0 -11
- package/dist/src/storage/repository-identity.js +0 -67
- package/dist/src/storage/repository-identity.js.map +0 -1
- package/dist/src/storage/resources.d.ts +0 -66
- package/dist/src/storage/resources.js +0 -148
- package/dist/src/storage/resources.js.map +0 -1
- package/dist/src/tools/evidence.d.ts +0 -8
- package/dist/src/tools/evidence.js +0 -9
- package/dist/src/tools/evidence.js.map +0 -1
- package/dist/src/tools/integrate.d.ts +0 -13
- package/dist/src/tools/integrate.js +0 -90
- package/dist/src/tools/integrate.js.map +0 -1
- package/dist/src/tools/result.d.ts +0 -9
- package/dist/src/tools/result.js +0 -2
- package/dist/src/tools/result.js.map +0 -1
- package/dist/src/tools/verify.d.ts +0 -13
- package/dist/src/tools/verify.js +0 -61
- package/dist/src/tools/verify.js.map +0 -1
- package/dist/src/tools/workflow.d.ts +0 -8
- package/dist/src/tools/workflow.js +0 -65
- package/dist/src/tools/workflow.js.map +0 -1
- package/dist/src/workflows/direct.d.ts +0 -9
- package/dist/src/workflows/direct.js +0 -2
- package/dist/src/workflows/direct.js.map +0 -1
- package/dist/src/workflows/implement.d.ts +0 -2
- package/dist/src/workflows/implement.js +0 -4
- package/dist/src/workflows/implement.js.map +0 -1
- package/dist/src/workflows/plan.d.ts +0 -17
- package/dist/src/workflows/plan.js +0 -6
- package/dist/src/workflows/plan.js.map +0 -1
- package/dist/src/workflows/research.d.ts +0 -15
- package/dist/src/workflows/research.js +0 -2
- package/dist/src/workflows/research.js.map +0 -1
- package/dist/src/workflows/review.d.ts +0 -15
- package/dist/src/workflows/review.js +0 -2
- package/dist/src/workflows/review.js.map +0 -1
- package/dist/src/workflows/verify.d.ts +0 -9
- package/dist/src/workflows/verify.js +0 -2
- package/dist/src/workflows/verify.js.map +0 -1
- package/dist/tests/acceptance.test.d.ts +0 -1
- package/dist/tests/acceptance.test.js +0 -27
- package/dist/tests/acceptance.test.js.map +0 -1
- package/dist/tests/agents.test.d.ts +0 -1
- package/dist/tests/agents.test.js +0 -369
- package/dist/tests/agents.test.js.map +0 -1
- package/dist/tests/candidates.test.d.ts +0 -1
- package/dist/tests/candidates.test.js +0 -60
- package/dist/tests/candidates.test.js.map +0 -1
- package/dist/tests/core.test.d.ts +0 -1
- package/dist/tests/core.test.js +0 -39
- package/dist/tests/core.test.js.map +0 -1
- package/dist/tests/daemon.test.d.ts +0 -1
- package/dist/tests/daemon.test.js +0 -157
- package/dist/tests/daemon.test.js.map +0 -1
- package/dist/tests/dashboard.test.d.ts +0 -1
- package/dist/tests/dashboard.test.js +0 -414
- package/dist/tests/dashboard.test.js.map +0 -1
- package/dist/tests/directory-selector.test.d.ts +0 -1
- package/dist/tests/directory-selector.test.js +0 -93
- package/dist/tests/directory-selector.test.js.map +0 -1
- package/dist/tests/doctor.test.d.ts +0 -1
- package/dist/tests/doctor.test.js +0 -32
- package/dist/tests/doctor.test.js.map +0 -1
- package/dist/tests/install.test.d.ts +0 -1
- package/dist/tests/install.test.js +0 -101
- package/dist/tests/install.test.js.map +0 -1
- package/dist/tests/integration.test.d.ts +0 -1
- package/dist/tests/integration.test.js +0 -49
- package/dist/tests/integration.test.js.map +0 -1
- package/dist/tests/journal.test.d.ts +0 -1
- package/dist/tests/journal.test.js +0 -50
- package/dist/tests/journal.test.js.map +0 -1
- package/dist/tests/model-role-assignment.test.d.ts +0 -1
- package/dist/tests/model-role-assignment.test.js +0 -294
- package/dist/tests/model-role-assignment.test.js.map +0 -1
- package/dist/tests/omb-runtime.test.d.ts +0 -1
- package/dist/tests/omb-runtime.test.js +0 -554
- package/dist/tests/omb-runtime.test.js.map +0 -1
- package/dist/tests/omb-session-actions.test.d.ts +0 -1
- package/dist/tests/omb-session-actions.test.js +0 -191
- package/dist/tests/omb-session-actions.test.js.map +0 -1
- package/dist/tests/omb-settings.test.d.ts +0 -1
- package/dist/tests/omb-settings.test.js +0 -82
- package/dist/tests/omb-settings.test.js.map +0 -1
- package/dist/tests/omp-contract.test.d.ts +0 -1
- package/dist/tests/omp-contract.test.js +0 -362
- package/dist/tests/omp-contract.test.js.map +0 -1
- package/dist/tests/process.test.d.ts +0 -1
- package/dist/tests/process.test.js +0 -12
- package/dist/tests/process.test.js.map +0 -1
- package/dist/tests/psmux-windows.test.d.ts +0 -1
- package/dist/tests/psmux-windows.test.js +0 -105
- package/dist/tests/psmux-windows.test.js.map +0 -1
- package/dist/tests/recovery.test.d.ts +0 -1
- package/dist/tests/recovery.test.js +0 -9
- package/dist/tests/recovery.test.js.map +0 -1
- package/dist/tests/resources.test.d.ts +0 -1
- package/dist/tests/resources.test.js +0 -55
- package/dist/tests/resources.test.js.map +0 -1
- package/dist/tests/session-activity.test.d.ts +0 -1
- package/dist/tests/session-activity.test.js +0 -159
- package/dist/tests/session-activity.test.js.map +0 -1
- package/dist/tests/setup-ui.test.d.ts +0 -1
- package/dist/tests/setup-ui.test.js +0 -37
- package/dist/tests/setup-ui.test.js.map +0 -1
- package/dist/tests/storage-integrity.test.d.ts +0 -1
- package/dist/tests/storage-integrity.test.js +0 -88
- package/dist/tests/storage-integrity.test.js.map +0 -1
- package/dist/tests/tmux.test.d.ts +0 -1
- package/dist/tests/tmux.test.js +0 -239
- package/dist/tests/tmux.test.js.map +0 -1
- package/dist/tests/tray.test.d.ts +0 -1
- package/dist/tests/tray.test.js +0 -37
- package/dist/tests/tray.test.js.map +0 -1
- package/dist/tests/verification.test.d.ts +0 -1
- package/dist/tests/verification.test.js +0 -61
- package/dist/tests/verification.test.js.map +0 -1
- package/dist/tests/workflow-features.test.d.ts +0 -1
- package/dist/tests/workflow-features.test.js +0 -82
- package/dist/tests/workflow-features.test.js.map +0 -1
- package/dist/tests/workflow-safety.test.d.ts +0 -1
- package/dist/tests/workflow-safety.test.js +0 -57
- package/dist/tests/workflow-safety.test.js.map +0 -1
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
# Contributing and Releasing BizarHarness-OMP
|
|
2
|
+
|
|
3
|
+
## Overview
|
|
4
|
+
|
|
5
|
+
This runbook is the policy for human and agent contribution plus the local
|
|
6
|
+
release process. It complements:
|
|
7
|
+
|
|
8
|
+
- `AGENTS.md` — coding-agent authority rules.
|
|
9
|
+
- `docs/development/ci-release-implementation-guide.md` — source-grounded
|
|
10
|
+
architecture and current CI/release flow.
|
|
11
|
+
|
|
12
|
+
## Normal contribution
|
|
13
|
+
|
|
14
|
+
A normal PR:
|
|
15
|
+
|
|
16
|
+
1. Branches from current `main`.
|
|
17
|
+
2. Has one logical change. Refactors are split from behavioural fixes.
|
|
18
|
+
3. Adds tests that fail without the change and pass with it.
|
|
19
|
+
4. Updates documentation alongside behaviour changes.
|
|
20
|
+
5. Adds a CHANGELOG entry under `## [Unreleased]`.
|
|
21
|
+
|
|
22
|
+
A normal PR MUST NOT:
|
|
23
|
+
|
|
24
|
+
- Edit `package.json` version, `package-lock.json` root version,
|
|
25
|
+
`docs/compatibility/baseline.json -> package.version`,
|
|
26
|
+
`CHANGELOG.md` historical entries, or `docs/releases/native-stable.md`.
|
|
27
|
+
- Create or push a `v*` tag.
|
|
28
|
+
- Call `npm publish` or `gh release create`.
|
|
29
|
+
- Mark a release as completed in the changelog.
|
|
30
|
+
|
|
31
|
+
## Verification gates
|
|
32
|
+
|
|
33
|
+
The contributor gate is `make check`:
|
|
34
|
+
|
|
35
|
+
```sh
|
|
36
|
+
make check # typecheck + test + verify:package + verify:docs + verify:security
|
|
37
|
+
make check-full # check + verify:omp + release preflight (requires a qualified local OMP host)
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
The release gate is `make check-full` plus `node scripts/verify-release-state.mjs --strict-network`.
|
|
41
|
+
|
|
42
|
+
## Release process
|
|
43
|
+
|
|
44
|
+
The release is owned by `scripts/release.mjs`, which the maintainer invokes
|
|
45
|
+
locally:
|
|
46
|
+
|
|
47
|
+
```sh
|
|
48
|
+
npm run release -- patch # bumps 0.7.0 -> 0.7.1
|
|
49
|
+
npm run release -- minor # bumps 0.7.0 -> 0.8.0
|
|
50
|
+
npm run release -- major # bumps 0.7.0 -> 1.0.0
|
|
51
|
+
npm run release -- 0.8.0 # explicit version (must be > current)
|
|
52
|
+
npm run release -- preflight # only runs the preflight gate
|
|
53
|
+
npm run release -- 0.8.0 --dry-run # reports the planned mutation without applying it
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
The orchestrator refuses to operate unless:
|
|
57
|
+
|
|
58
|
+
- the working tree is clean,
|
|
59
|
+
- the current branch is `main`,
|
|
60
|
+
- the registry reports a version not greater than the local one,
|
|
61
|
+
- the requested bump is greater than the current version,
|
|
62
|
+
- the proposed tag does not already exist on the remote,
|
|
63
|
+
- `CHANGELOG.md` contains a populated `[Unreleased]` section.
|
|
64
|
+
|
|
65
|
+
It performs the following mutations in order:
|
|
66
|
+
|
|
67
|
+
1. `npm version <target> --no-git-tag-version --ignore-scripts` so npm keeps
|
|
68
|
+
`package.json` and both lockfile root version fields consistent.
|
|
69
|
+
2. Update `docs/compatibility/baseline.json -> package.version`.
|
|
70
|
+
3. Promote `CHANGELOG.md ## [Unreleased]` to `## <version> — released <iso-date>`
|
|
71
|
+
and leave a fresh `## [Unreleased]` section behind.
|
|
72
|
+
4. Generate `docs/releases/<version>.md` from the promoted changelog entry.
|
|
73
|
+
5. Commit the bump as `chore: bump version to <version>`.
|
|
74
|
+
6. Push `main` and `refs/tags/v<version>` atomically.
|
|
75
|
+
|
|
76
|
+
The unified CI workflow (`.github/workflows/ci.yml`) generates its runtime
|
|
77
|
+
matrices from `.github/ci-policy.json`, `package.json`, and the OMP
|
|
78
|
+
compatibility source. PRs test every supported Node line; ordinary `main`
|
|
79
|
+
pushes use one line. CI builds and uploads one package artifact, reuses it for
|
|
80
|
+
native OMP qualification, and runs a stable `CI required` fan-in job. On a
|
|
81
|
+
release commit, CI verifies the matching tag and strict release preflight,
|
|
82
|
+
publishes the artifact to npm through Trusted Publishing and to GitHub
|
|
83
|
+
Packages through `GITHUB_TOKEN`, verifies both registry copies, then creates
|
|
84
|
+
the GitHub release with the tarball and receipt. Write credentials are scoped
|
|
85
|
+
to the job that needs them.
|
|
86
|
+
|
|
87
|
+
CI MUST NOT create tags, push to the repository, or run `npm version`. Tag
|
|
88
|
+
creation is exclusively the local release script's responsibility.
|
|
89
|
+
|
|
90
|
+
## Emergency override
|
|
91
|
+
|
|
92
|
+
If CI is billing-blocked at the org level (the documented escape hatch for
|
|
93
|
+
private repositories where trusted publishing cannot be attested), the
|
|
94
|
+
operator:
|
|
95
|
+
|
|
96
|
+
1. Bumps `package.json` and regenerates the lockfile.
|
|
97
|
+
2. Packs: `npm pack --ignore-scripts`.
|
|
98
|
+
3. Publishes: `NPM_CONFIG_PROVENANCE=false npm publish --ignore-scripts`.
|
|
99
|
+
4. Tags the merge commit locally: `git tag vX.Y.Z <sha> && git push origin vX.Y.Z`.
|
|
100
|
+
5. Creates the GitHub release manually.
|
|
101
|
+
6. Records the override in the release notes and the audit log.
|
|
102
|
+
|
|
103
|
+
## CHANGELOG discipline
|
|
104
|
+
|
|
105
|
+
- One entry per PR under `## [Unreleased]`. Bullet points are imperative
|
|
106
|
+
mood: "Add", "Fix", "Refactor", "Remove".
|
|
107
|
+
- Promote via `scripts/release.mjs`. Never hand-edit `## X.Y.Z` headings.
|
|
108
|
+
- `## [Unreleased]` must have at least one entry, or the release script
|
|
109
|
+
refuses to proceed.
|
|
110
|
+
|
|
111
|
+
## Compatibility updates
|
|
112
|
+
|
|
113
|
+
OMP compatibility updates (changing `SUPPORTED_OMP.version` or
|
|
114
|
+
`QUALIFIED_OMP_VERSIONS`) MUST go through `scripts/update-omp-compatibility.mjs`.
|
|
115
|
+
The script does not bump the Bizar package version — that is the release
|
|
116
|
+
script's responsibility. A compatibility update is followed by a release
|
|
117
|
+
when the maintainer decides the new baseline should ship.
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
# Updating OMP Compatibility
|
|
2
|
+
|
|
3
|
+
This guide covers how to update the plugin's OMP compatibility markers when a
|
|
4
|
+
new OMP version is released. It does **not** cover releasing a new version of
|
|
5
|
+
BizarHarness-OMP itself — see `docs/development/contributing-and-releasing.md`
|
|
6
|
+
for that process.
|
|
7
|
+
|
|
8
|
+
## What changes
|
|
9
|
+
|
|
10
|
+
The update script (`scripts/update-omp-compatibility.mjs`) updates:
|
|
11
|
+
|
|
12
|
+
| File | What changes |
|
|
13
|
+
|---|---|
|
|
14
|
+
| `src/omp/compatibility.ts` | `SUPPORTED_OMP` version + commit; adds to `QUALIFIED_OMP_VERSIONS` |
|
|
15
|
+
| `.github/workflows/ci.yml` | pinned `@oh-my-pi/pi-coding-agent@<version>` |
|
|
16
|
+
| `.github/workflows/omp-compatibility.yml` | pinned `@oh-my-pi/pi-coding-agent@<version>` |
|
|
17
|
+
| `docs/compatibility/baseline.json` | `omp.testedVersion`, `omp.testedCommit`, `omp.previouslyQualifiedVersions` |
|
|
18
|
+
| `docs/compatibility/supported-surfaces.json` | `qualified[0]` (new version), inserts old version |
|
|
19
|
+
| `README.md` | OMP version strings in text and inline links |
|
|
20
|
+
| `skills/omp-native-development/SKILL.md` | qualification target fingerprint |
|
|
21
|
+
| `skills/omp-native-development/references/accuracy-and-versioning.md` | qualification target + npm integrity |
|
|
22
|
+
| `skills/omp-native-development/references/source-manifest.json` | current qualification block |
|
|
23
|
+
|
|
24
|
+
The script **does not** bump the Bizar package version or touch `package.json`,
|
|
25
|
+
`package-lock.json`, or `CHANGELOG.md`. Those are owned by the release
|
|
26
|
+
orchestrator (`scripts/release.mjs`).
|
|
27
|
+
|
|
28
|
+
## Prerequisites
|
|
29
|
+
|
|
30
|
+
You need three values from the new OMP release:
|
|
31
|
+
|
|
32
|
+
1. **Version tag** — e.g. `18.2.9`.
|
|
33
|
+
2. **Release commit SHA** — the full 40-char git commit hash of the `can1357/oh-my-pi` tag.
|
|
34
|
+
3. **npm integrity value** — the `sha512-…` string for the npm package at that version.
|
|
35
|
+
|
|
36
|
+
To get the integrity value:
|
|
37
|
+
|
|
38
|
+
```sh
|
|
39
|
+
npm view @oh-my-pi/pi-coding-agent@<version> dist.integrity
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
To get the release commit, check the OMP repo's tag:
|
|
43
|
+
|
|
44
|
+
```sh
|
|
45
|
+
git ls-remote https://github.com/can1357/oh-my-pi.git refs/tags/<version>
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Or look at `node_modules/@oh-my-pi/pi-coding-agent/.npm/package.json` after
|
|
49
|
+
installing the new version — it contains the `repository.commit` field.
|
|
50
|
+
|
|
51
|
+
## Running the update
|
|
52
|
+
|
|
53
|
+
```sh
|
|
54
|
+
node scripts/update-omp-compatibility.mjs \
|
|
55
|
+
--version 18.2.9 \
|
|
56
|
+
--commit 5e0fc867f8a58dfe8812b5e99b2e7b6a0313da6c \
|
|
57
|
+
--integrity sha512-...
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
The script exits with error if the target version is not strictly greater than
|
|
61
|
+
the current `SUPPORTED_OMP.version` in `src/omp/compatibility.ts`.
|
|
62
|
+
|
|
63
|
+
On success it prints a JSON summary:
|
|
64
|
+
|
|
65
|
+
```json
|
|
66
|
+
{
|
|
67
|
+
"ok": true,
|
|
68
|
+
"omp": { "from": "18.2.8", "to": "18.2.9", "commit": "5e0fc867…" },
|
|
69
|
+
"changed": ["src/omp/compatibility.ts", "docs/compatibility/baseline.json", "…"],
|
|
70
|
+
"packageVersion": "0.7.0"
|
|
71
|
+
}
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
## After the update
|
|
75
|
+
|
|
76
|
+
1. **Review the diff** — especially `src/omp/compatibility.ts` and
|
|
77
|
+
`docs/compatibility/baseline.json`. The `packageVersion` in the output
|
|
78
|
+
confirms which Bizar version the change was qualified against; it should
|
|
79
|
+
match the current `package.json` version.
|
|
80
|
+
|
|
81
|
+
2. **Run the qualification gate** — with a local qualified OMP host:
|
|
82
|
+
|
|
83
|
+
```sh
|
|
84
|
+
BIZAR_OMP_PACKAGE_ROOT=/path/to/18.2.9/node_modules/@oh-my-pi/pi-coding-agent \
|
|
85
|
+
BIZAR_OMP_BIN=/path/to/18.2.9/node_modules/.bin/omp \
|
|
86
|
+
npm run verify:omp
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
If you don't have a local host yet, install one:
|
|
90
|
+
|
|
91
|
+
```sh
|
|
92
|
+
mkdir -p /tmp/omp-host && cd /tmp/omp-host
|
|
93
|
+
npm install @oh-my-pi/pi-coding-agent@<version>
|
|
94
|
+
BIZAR_OMP_PACKAGE_ROOT=/tmp/omp-host/node_modules/@oh-my-pi/pi-coding-agent \
|
|
95
|
+
BIZAR_OMP_BIN=/tmp/omp-host/node_modules/.bin/omp \
|
|
96
|
+
npm run verify:omp
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
3. **Open a PR** with the compatibility changes. Use
|
|
100
|
+
`.github/PULL_REQUEST_TEMPLATE.md`. Add a CHANGELOG entry under
|
|
101
|
+
`## [Unreleased]` describing the OMP version bump.
|
|
102
|
+
|
|
103
|
+
4. **Merge** — after CI passes, merge the PR. This does not trigger a
|
|
104
|
+
Bizar release; the compatibility update ships independently of the version
|
|
105
|
+
schedule.
|
|
106
|
+
|
|
107
|
+
5. **Release when ready** — once the maintainer decides the new OMP baseline
|
|
108
|
+
should ship, run `npm run release -- <kind>` per
|
|
109
|
+
`docs/development/contributing-and-releasing.md`. The release script
|
|
110
|
+
references the now-current `SUPPORTED_OMP` and `QUALIFIED_OMP_VERSIONS`.
|
|
111
|
+
|
|
112
|
+
## Rollback
|
|
113
|
+
|
|
114
|
+
If the compatibility update causes problems, revert the PR branch. The
|
|
115
|
+
`previouslyQualifiedVersions` list in `baseline.json` records all past tested
|
|
116
|
+
versions; the test suite (`tests/install.test.ts`) pins specific OMP versions
|
|
117
|
+
that must be updated alongside this script.
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# 0.7.1
|
|
2
|
+
|
|
3
|
+
- Avoid redundant lockfile-only npm install during release preparation, which fails under project script-approval policy.
|
|
4
|
+
- Generate and commit versioned GitHub release notes from the promoted changelog during release preparation.
|
|
5
|
+
- Restructure CI into generated runtime matrices and validation, packaging, native qualification, release, and publication phases; publish verified release artifacts to npm and GitHub Packages with isolated permissions.
|
|
6
|
+
- Make session actions generation-checked, show unhosted journals as liveness-unknown unless their native PID is confirmed, bind tmux recovery to native session identity, expose independent host/activity/outcome fields, and reject stale settings writes.
|
|
7
|
+
- OMP compatibility bump: 18.2.8 → 18.2.11 (commit e415159).
|
|
8
|
+
- CI/release migration (per `docs/development/ci-release-implementation-guide.md`): unified `.github/workflows/ci.yml` with verify / package-contract / bun-compatibility / release jobs; the release job is gated on the `chore: bump version to *` commit-message prefix and trusts an existing `v<version>` tag rather than creating one; legacy `immutable-tag.yml` and `release.yml` removed.
|
|
9
|
+
- Local release orchestrator (`scripts/release.mjs` + `scripts/release-lib.mjs`) owns the version bump, lockfile regeneration, baseline.json, CHANGELOG `[Unreleased]` promotion, and the atomic push of `main` and `refs/tags/v<version>`. CI only verifies.
|
|
10
|
+
- Preflight gate (`scripts/verify-release-state.mjs --strict-network`); immutable release-receipt generator (`scripts/create-release-receipt.mjs`); OMP-only compatibility updater (`scripts/update-omp-compatibility.mjs`) that no longer bumps the Bizar package version.
|
|
11
|
+
- PR template (`.github/PULL_REQUEST_TEMPLATE.md`) and contributor runbook (`docs/development/contributing-and-releasing.md`).
|
|
12
|
+
- Contract tests for the workflow (`tests/workflow-contract.test.ts`) and the release library (`tests/release.test.ts`).
|
|
13
|
+
- OMP compatibility bump: 18.2.8 → 18.2.10 (commit `da58b16`).
|
|
14
|
+
|
|
15
|
+
- OMP compatibility bump: 18.2.8 → 18.2.9 (commit 8cd6f8c6).
|
|
@@ -1,3 +1,13 @@
|
|
|
1
1
|
# Native release policy
|
|
2
2
|
|
|
3
|
-
The package is releasable when
|
|
3
|
+
The package is releasable when `make check:full` passes against the
|
|
4
|
+
supported OMP/Bun baseline, `scripts/verify-release-state.mjs --strict-network`
|
|
5
|
+
passes, and the local release script has run successfully.
|
|
6
|
+
|
|
7
|
+
The current stable release is recorded in `package.json` (npm-published),
|
|
8
|
+
`docs/compatibility/baseline.json -> package.version` (verified at every
|
|
9
|
+
release), and the `v<version>` tag on `main`.
|
|
10
|
+
|
|
11
|
+
The release script owns this pointer; do not hand-edit it. CI verifies it.
|
|
12
|
+
|
|
13
|
+
See `docs/development/contributing-and-releasing.md` for the runbook.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Package publishing
|
|
2
2
|
|
|
3
3
|
Package: `@polderlabs/bizar-omp` (public). Repository remains private.
|
|
4
4
|
|
|
@@ -9,14 +9,33 @@ Configure the package's npm **Trusted Publisher** as:
|
|
|
9
9
|
| Provider | GitHub Actions |
|
|
10
10
|
| Organization or user | `PolderLabs` |
|
|
11
11
|
| Repository | `BizarHarness-OMP` |
|
|
12
|
-
| Workflow filename | `
|
|
12
|
+
| Workflow filename | `ci.yml` |
|
|
13
13
|
| Environment | Leave blank |
|
|
14
14
|
| Allowed actions | Direct `npm publish` |
|
|
15
15
|
|
|
16
|
-
The
|
|
16
|
+
The repository is linked through `package.json#repository`. npm remains the public distribution registry. The unified `.github/workflows/ci.yml` release pipeline uses GitHub-hosted runners, a policy-selected Node line, npm `>=11.5.1`, and `id-token: write` in the npm publication job; no npm token secret is required. Do not use `npm whoami` to test OIDC: token exchange happens during publication.
|
|
17
17
|
|
|
18
|
-
|
|
18
|
+
The same validated tarball is also published to GitHub Packages as
|
|
19
|
+
`@polderlabs/bizar-omp`. The first GitHub package inherits this private
|
|
20
|
+
repository's visibility and permissions. Its workflow job receives
|
|
21
|
+
`packages: write` and uses `GITHUB_TOKEN`; no personal access token is stored
|
|
22
|
+
as a repository secret. GitHub Packages consumers outside Actions need a
|
|
23
|
+
Personal Access Token (classic) with package read access and a scoped npm
|
|
24
|
+
registry entry such as:
|
|
25
|
+
|
|
26
|
+
```ini
|
|
27
|
+
@polderlabs:registry=https://npm.pkg.github.com
|
|
28
|
+
//npm.pkg.github.com/:_authToken=${GITHUB_PACKAGES_TOKEN}
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Keep the token in the user's environment, not in a committed `.npmrc`. Verify
|
|
32
|
+
that the first package is linked to this repository and inherits its access
|
|
33
|
+
permissions; organization policy can disable automatic inheritance. Do not
|
|
34
|
+
change package visibility as part of an ordinary release.
|
|
35
|
+
|
|
36
|
+
Release procedure: the operator runs `npm run release -- <kind|version>` locally (e.g. `patch`, `minor`, `0.7.1`). The local orchestrator (`scripts/release.mjs`) atomically increments `package.json`, regenerates the lockfile, updates `docs/compatibility/baseline.json -> package.version`, promotes the CHANGELOG `[Unreleased]` section, commits `chore: bump version to <version>`, and pushes `main` + `refs/tags/v<version>` atomically. CI never creates tags. The release pipeline discovers the tag at HEAD on `main`, runs strict release preflight, tests and qualifies one packed artifact, then publishes that artifact to both registries. Each publisher refuses to replace an existing version with different integrity. A partial registry failure is retried by rerunning CI after correcting the cause; the successful registry's immutable version is verified and retained. Published versions cannot be overwritten.
|
|
19
37
|
|
|
20
38
|
The repository is private, so npm provenance is disabled; OIDC authentication still works. Do not advertise provenance for this release. If repository visibility changes, reevaluate provenance separately.
|
|
21
39
|
|
|
22
40
|
Reference: [npm trusted publishing documentation](https://docs.npmjs.com/trusted-publishers/).
|
|
41
|
+
GitHub's npm registry setup: [Working with the npm registry](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-npm-registry).
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
| --- | --- |
|
|
5
5
|
| Node | 22.x and 24.x in CI |
|
|
6
6
|
| Bun | 1.3.14 compatibility job |
|
|
7
|
-
| OMP | 18.2.
|
|
7
|
+
| OMP | 18.2.9 at release commit `8cd6f8c619e89e935b6c6c5c91f6a4d20f6d7a75`; 18.2.8 remains regression-qualified |
|
|
8
8
|
| Install | `npx --yes @polderlabs/bizar-omp setup` is the supported full install; `omp plugin install <package-spec>` is extension-only and `omp plugin link <checkout>` is for development |
|
|
9
9
|
| Security | Trusted in-process extension; native task isolation required for managed editing |
|
|
10
10
|
| Workflow state | Journal v2 validation, candidate-bound acceptance, bounded inspection/projection, and offline evidence bundles are locally qualified; v1 state remains legacy input |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@polderlabs/bizar-omp",
|
|
3
|
-
"version": "0.7.
|
|
3
|
+
"version": "0.7.1",
|
|
4
4
|
"description": "Native oh-my-pi engineering workflow extension with typed evidence and serialized integration.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"engines": {
|
|
@@ -40,6 +40,7 @@
|
|
|
40
40
|
"typecheck": "tsc -p tsconfig.json --noEmit",
|
|
41
41
|
"test": "vitest run",
|
|
42
42
|
"test:watch": "vitest",
|
|
43
|
+
"release": "node scripts/release.mjs",
|
|
43
44
|
"verify:package": "npm run build && node scripts/verify-package.mjs",
|
|
44
45
|
"verify:docs": "node scripts/check-generated-docs.mjs",
|
|
45
46
|
"verify:security": "node scripts/check-secrets.mjs",
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
# oflow GitLab rules
|
|
2
|
+
- Treat `oflow` CLI JSON output as the only GitLab story-context surface; never call GitLab REST/GraphQL directly from Bizar work when an `.oflow` contract exists in the repository.
|
|
3
|
+
- Refresh (`--refresh`) at session and mutation boundaries; cached reads are orientation only and never proof of current remote state.
|
|
4
|
+
- Every remote GitLab write goes through `oflow plan -> approve -> apply -> verify`; a runtime MCP server does not bypass the gates.
|
|
5
|
+
- If a refresh fails, stop remote mutations; report the failure instead of planning against stale data.
|
|
6
|
+
- Never read, copy, or persist the oflow GitLab token; it lives outside the repository by design.
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: oflow-gitlab-context
|
|
3
|
+
description: Use the oflow CLI as the GitLab story-context and guarded-write layer for Bizar work in repositories that carry an .oflow contract. Covers session rhythm (work --mine, sync --summary, cached reads), story context and acceptance evidence, and the plan -> approve -> apply -> verify mutation gates. Trigger when the repository has .oflow/WORKFLOW.md, the task mentions GitLab stories/iterations/boards, or a Bizar objective needs current remote planning truth as acceptance evidence.
|
|
4
|
+
---
|
|
5
|
+
# oflow GitLab context
|
|
6
|
+
|
|
7
|
+
`oflow` is a host-neutral CLI that turns GitLab planning data into compact
|
|
8
|
+
agent context and guards every remote write. OMP hosts discover its contract
|
|
9
|
+
through the managed `.omp/AGENTS.md` bridge and `/oflow-*` commands that
|
|
10
|
+
`oflow install` writes. This skill uses the CLI; it never talks to GitLab HTTP
|
|
11
|
+
directly.
|
|
12
|
+
|
|
13
|
+
## Session rhythm
|
|
14
|
+
|
|
15
|
+
1. At a session or mutation boundary, refresh: `oflow work --mine --refresh
|
|
16
|
+
--json` and `oflow sync --summary --refresh --json`.
|
|
17
|
+
2. While exploring, read cache only: `oflow work --mine --cached --json` and
|
|
18
|
+
`oflow sync --summary --cached --json`. A cache miss for the exact query
|
|
19
|
+
returns an error, never a different snapshot.
|
|
20
|
+
3. Load focused evidence only when needed: `oflow context --story <iid> --json`
|
|
21
|
+
and `oflow assess --story <iid> --json`.
|
|
22
|
+
4. After any apply, refresh again before planning the next change.
|
|
23
|
+
|
|
24
|
+
If a refresh fails, continue local analysis but never apply a remote mutation;
|
|
25
|
+
cached data is orientation, not proof of current remote state.
|
|
26
|
+
|
|
27
|
+
## Writes
|
|
28
|
+
|
|
29
|
+
Every supported remote write goes through `oflow plan <op> ...`, `oflow approve
|
|
30
|
+
<plan-file>`, `oflow apply <plan-file>`, `oflow verify --plan <plan-file>`.
|
|
31
|
+
Plans capture target state and `updated_at` preconditions; apply re-reads the
|
|
32
|
+
target immediately before writing and refuses to overwrite a newer change.
|
|
33
|
+
MCP tools, if the runtime has a GitLab MCP server, do not bypass these gates.
|
|
34
|
+
|
|
35
|
+
## Evidence for Bizar
|
|
36
|
+
|
|
37
|
+
Use `oflow verify --story <iid> --json` as host-observed acceptance evidence
|
|
38
|
+
when an objective's criteria reference GitLab delivery state: it checks
|
|
39
|
+
acceptance evidence lines and the latest successful pipeline matching the MR
|
|
40
|
+
head SHA. Report the command and its output digest; do not paraphrase GitLab
|
|
41
|
+
state from memory.
|
|
42
|
+
|
|
43
|
+
## Boundaries
|
|
44
|
+
|
|
45
|
+
- The token lives in the user's oflow config directory, never in the repo.
|
|
46
|
+
- The GitLab MCP endpoint (`/api/v4/mcp`) needs the fine-grained
|
|
47
|
+
`MCP tool: Execute` permission; without it the endpoint answers
|
|
48
|
+
`403 insufficient_granular_scope`. oflow's own reads never require it.
|
|
49
|
+
- `oflow` does not push source code; repository work still flows through git.
|
|
@@ -9,7 +9,7 @@ Treat this skill as a source-grounded engineering procedure, not an assertion of
|
|
|
9
9
|
|
|
10
10
|
## Establish the target before implementing
|
|
11
11
|
|
|
12
|
-
Read [accuracy-and-versioning.md](references/accuracy-and-versioning.md) first. The current qualification target is `can1357/oh-my-pi` v18.2.
|
|
12
|
+
Read [accuracy-and-versioning.md](references/accuracy-and-versioning.md) first. The current qualification target is `can1357/oh-my-pi` v18.2.9 at commit `8cd6f8c619e89e935b6c6c5c91f6a4d20f6d7a75`; OMP 18.2.6, 18.2.5, and 18.2.4 remain separately tested compatibility versions. The bundled research corpus remains pinned to main commit `dbf3afad4894bde827d90f965e77b3fe1c5a95e5`, dated 2026-09-17, and must not be presented as the current release source.
|
|
13
13
|
|
|
14
14
|
Record the developer's actual OMP package version, lockfile/integrity, source commit when available, Bun version, execution mode, profile, cwd, and relevant settings. Never print secrets. Verify the exact exports and behavior of that target, rather than assuming these snapshots apply unchanged. A missing environment or unrun test means UNKNOWN or NOT RUN, never PASS.
|
|
15
15
|
|
|
@@ -18,7 +18,7 @@ Separate five kinds of statement: DOCUMENTED, SOURCE-OBSERVED, TESTED, PROPOSED
|
|
|
18
18
|
|
|
19
19
|
## Target fingerprint
|
|
20
20
|
|
|
21
|
-
Current qualification target: `v18.2.
|
|
21
|
+
Current qualification target: `v18.2.9@8cd6f8c619e89e935b6c6c5c91f6a4d20f6d7a75`, npm integrity `sha512-VnU6Udlp9sjmZI2WuwIJmKV2MP3Y1sCkwES2Yiq9MAhlSlLLRhXIx2Ijn2I1nHtYur9WoU/OQGvjN8+FH3Z9xg==`.
|
|
22
22
|
Previous compatibility targets: `v18.2.6@78b753124d11f8dd3ae73e2524125890ff7c977e`, `v18.2.5@37273117021129e96bd05d8277b140ec3fd61990` and `v18.2.4@1c0303b1f2ec515cbf4b44a9a49d68a029531aac`.
|
|
23
23
|
Research source: `can1357/oh-my-pi@dbf3afad4894bde827d90f965e77b3fe1c5a95e5`; it remains a source/documentation corpus pin, not a claim about the current package release. Compare artifacts/commits, not just a semver string.
|
|
24
24
|
|
|
@@ -5,9 +5,9 @@
|
|
|
5
5
|
"reference_date": "2026-09-17",
|
|
6
6
|
"docs_tree_sha": "c0055f49ceb172ff6da9490cf74773e9b187966b",
|
|
7
7
|
"current_qualification": {
|
|
8
|
-
"tag": "v18.2.
|
|
9
|
-
"commit": "
|
|
10
|
-
"npm_integrity": "sha512-
|
|
8
|
+
"tag": "v18.2.9",
|
|
9
|
+
"commit": "8cd6f8c619e89e935b6c6c5c91f6a4d20f6d7a75",
|
|
10
|
+
"npm_integrity": "sha512-VnU6Udlp9sjmZI2WuwIJmKV2MP3Y1sCkwES2Yiq9MAhlSlLLRhXIx2Ijn2I1nHtYur9WoU/OQGvjN8+FH3Z9xg==",
|
|
11
11
|
"qualification": "Runtime-qualified by the Bizar packed-install contract; the bundled docs/source inventory remains pinned to the research commit below."
|
|
12
12
|
},
|
|
13
13
|
"comparison_release": {
|
|
@@ -1,25 +0,0 @@
|
|
|
1
|
-
import { type OmbSessionInfo } from "../omp/omb-sessions.js";
|
|
2
|
-
import type { OmbSettings } from "../omp/omb-settings.js";
|
|
3
|
-
export type AgentsHubAction = {
|
|
4
|
-
type: "quit";
|
|
5
|
-
} | {
|
|
6
|
-
type: "attach";
|
|
7
|
-
session: OmbSessionInfo;
|
|
8
|
-
} | {
|
|
9
|
-
type: "new";
|
|
10
|
-
projectCwd: string;
|
|
11
|
-
task: string;
|
|
12
|
-
sessionId: string;
|
|
13
|
-
} | {
|
|
14
|
-
type: "rename";
|
|
15
|
-
session: OmbSessionInfo;
|
|
16
|
-
nextId: string;
|
|
17
|
-
} | {
|
|
18
|
-
type: "delete";
|
|
19
|
-
session: OmbSessionInfo;
|
|
20
|
-
nextSessionName?: string;
|
|
21
|
-
} | {
|
|
22
|
-
type: "settings";
|
|
23
|
-
settings: OmbSettings;
|
|
24
|
-
};
|
|
25
|
-
export declare function runInkAgentsHub(cwd: string, env: NodeJS.ProcessEnv, sessions: OmbSessionInfo[], settings: OmbSettings, initialSelectedName?: string, openNewSession?: boolean): Promise<AgentsHubAction>;
|