Releases

現行Stable、履歴、Capability、制約、Upgrade境界をrelease authorityに照合して調べる。

BlackOpsのLatest Experimental StableはFramework／Skeleton 1.2.1です。Versionを固定したSkeletonをInstallし、ApplicationのHTTP入口とCLIの公開結果を確認できます。未Release Surfaceはこのドキュメントで明示します。Documentation WebsiteはCloudflare Pages（https://blackops-php.pages.dev）へ公開しています。

BlackOps固有のOperation、Claim、Journal、Outcome等はGlossaryで確認できます。

BlackOpsはExperimentalです。1.x Minor間のBackward CompatibilityとProduction Readinessを保証しません。ApplicationはDatabase Credential、Deployment、Process Supervision、Authentication／Authorization、Access Control、Encryption、Retention Policy、Operational Monitoringを所有します。

Release NotesとMigration

Stable 1.1.0から公開済み1.2.0へ移行する場合は、CHANGELOG.mdの差分とUPGRADE.mdのBackup、9つのMigration、Rollback境界を順に確認してください。公開PackageのComposer／Generator更新は、実際のannotated Tag 1.1.0を起点にしたFramework Update Consumerで検証済みです。

Stable 1.2.1と過去StableのCapability

Stable Applicationを作る場合はVersionを明示します。

composer create-project blackops/skeleton my-app 1.2.1

1.3.0のAudit Trail計画

BlackOps 1.3.0では、業務・セキュリティ・管理操作の監査ログを追加する計画です。まだ公開していないため、現在のStable 1.2.1の機能として利用できません。

たとえば「誰が、どの請求先情報を変更し、変更が成功したか」を後から確認できるようにする記録です。どの業務操作を記録するか、Actionと対象（Resource）をどう表すかはApplicationが明示します。FrameworkがHandlerの完了だけから業務操作や対象を自動推測する仕組みではありません。

現在の記録とは役割が異なります。

RetentionのPurge Audit、Observer Replay、Storage Key Rotationに伴う限定的な運用記録は、それぞれの現行運用契約に属します。これらやLifecycle Journalを汎用Audit Trailの完成版として扱いません。

1.3.0では、Operationとの相関、監査ログの閲覧範囲、記録の種類と保持方針を検討します。現行のLifecycle記録はJournal、Sensitive Projectionと責任分界はBlackOpsの#[Sensitive]とPHPの#[SensitiveParameter]で確認してください。

Available Runtime Surface

• PHP 8.5、PSR-7／15／17 HTTP Boundary、FrankenPHP Reference Runtime
• Typed Operation、OperationValue、Native Outcome／Void、業務拒否Exception
• Inline LifecycleとJSON Response
• PostgreSQL Deferred受付、Claim、Retry、Heartbeat、Fencing、Crash Recovery、Dead Letter
• Operation IDで取得するTyped Outcome
• Canonical JournalとSensitive Observed Projection
• Versioned Operation／HTTP ManifestとCompiled Symfony DI Container
• BlackOps所有の7 Value Validation AttributeとSymfony Validator Backend
• Global PSR-15 HTTP Middleware、Authentication Contract、Durable ActorContext
• #[Authorize]とInline／Deferred Worker再認可
• Named DBAL Connection、Default Connection／DatabaseManager Constructor Injection
• Operation／Container管理Serviceの#[Transactional]、Nested Required、Rollback-only
• #[AfterCommit] Queue、Failure Reporter、HTTP／Deferred Connection Lifecycle
• Doctrine PostgreSQL Migration
• Payload、Journal、Outcome、Dead LetterのRetention、Hold、Purge Audit、Scheduler
• Operation IDからLifecycle／Attempt／Outcome Availabilityを読むSafe Human／JSON Diagnostics
• 既定無効・Loopback限定・Token必須・Read-onlyのDevelopment Local Viewer
• Process起動時に一度解決するApplication／Framework JSONL LoggingとOperation／Attempt／Correlation ID相関
• OpenTelemetry API-only Provider Composition、W3C Context、固定Metric、OperationalHealth Query（Application-owned）
• HTTP Operationから生成するFramework-neutral TypeScript ESM Operation Object
• Readonly Metadata、.url()、.toRequest()、Typed .fetch()とFrontend Drift Check
• 認可前Subject Projection、Unknown／Deny 404、認可済みExpired 410を持つPublic Status Query／HTTP Resource
• 7 Stateを一回取得するGenerated .status()と、Abort／Deadline必須の有限.wait()
• 起動時に一回評価するTyped Environment／Configuration Closure
• Server Fetch、Base URL、Header、CredentialをRequest単位で固定するGenerated Bound Client
• Symfony #[AsCommand]のBuild-time Discovery／Constructor DIと#[ConsoleCommand] Operation Adapter
• Opaque Token、Hash保存、TTL、Touch、Rotation、Revocation、Cleanupを持つOpt-in Session Coreとmake:auth
• Build-time Discovery、Compiled Container DI、明示順の子Seederを持つDatabase Seederとdatabase:seed／make:seeder
• Application-owned Identity、Ephemeral Auth Operation、SvelteKit BFF、Post／Comment、Deferred Digest、Browser User Journeyを統合したBlackOps Board Reference Application

BlackOps BoardはFramework／Skeleton Packageとは別のExample Applicationで、試験的なLocal Reference Applicationです。公開Hostも提供していません。BoardはApplication SourceとLocal Runtime手順を維持し、外部公開／デプロイの対象外です。Documentation Websiteの公開先は上記Cloudflare Pagesです。

Known Constraints

Stable 1.2.1の公開Surfaceでは通常／--no-scripts Install、Project Root CLI、Compile、12 Migration、HTTP、Worker retryからCompleted、Sensitive redactionを確認できます。HTTP後のnon-root operation:inspectは、bind-mountされたvar/log/journal.jsonlがHTTP Processでroot-ownedになる環境ではdiagnostics.storage_failedを返します。Journalのmasked dataだけを確認し、これは確認済みのownership limitationとして扱います。

• Session Coreは提供するが、User／Password／Registration Policy、Cookie／CSRF、JWT／OAuth／API Key、Actor Repository、Permission StoreはApplication責務
• Production Status Authorization Policy、Tenant Model、Role／Permission Repositoryは提供しない
• 無限Wait、任意Backoff／Jitter、Global Generated Client、Cache／Offline Queueは提供しない
• Transactional Outboxは同一Named Connectionへの原子登録、有限Relay、Retry／Backoff、Lease／Fencing、Dead Letter再開を提供する（at-least-once。外部配送のExactly Onceは提供しない）
• Canonical Journal、Deferred Payload／Context、Outcome、Outbox、Dead Letter、Idempotencyの復元可能FieldはBOPD v1 Envelopeで保護する。Key Material、KMS Vendor操作、Replica／Backup上の旧Key確認、旧Key削除は提供しない
• Remote OpenTelemetry Backend、Grafana Cloud、CloudWatch、SQS、Kafka、SQLite、MySQL Adapterは提供しない。Local Docker Collectorと固定DigestのGrafana LGTMはApplicationが明示的に起動するDevelopment／Demo／Test検証手順だけを提供する
• Observer Replay CLIはCanonical Journalを変更せず、現在のSensitive Projectionを再適用する有限Batch／Checkpoint／Resume／Audit操作として提供する。Admin UIは提供しない
• Array／Nested ObjectのHTTP Binding、宣言的DB照合、Cross-field Attribute、Custom Callbackは提供しない。Count Validatorは実装済みだが現行HTTP BinderからArrayを渡せない
• Production CertificationやExperimental Public API Contractを超える互換性保証は提供しない。1.x Minor間のBackward Compatibilityも保証しない
• DiagnosticsのPublic PHP Query APIとRemote Viewerは提供しない。OpenTelemetry／Metric／Healthの本番Backend、Remote Dashboard、Collector／LGTM自動起動も提供しない
• Application Schedule Daemon、Supervisor／Kubernetes／systemd Manifest Generator、Schedule-specific Retentionは提供しない。one-shot CLIはScheduled Operationの手順で外部Supervisorから起動する

これらの不在はApplication側のSecurity／Operations設計が不要であることを意味しません。Capability表とApplication／Frameworkの責務境界を確認し、Deployment前に必要なAdapterと運用責務を明示してください。

次にStableをInstallする

現行Releaseの提供範囲を確認したら、InstallでVersionを固定したSkeleton作成へ進みます。