Files
Assistant/dev/tasks/GEN2-014-add-explicit-reflex-lifecycle-shadow-reasoning-and-revalidation.json
2026-08-29 01:53:27 +03:00

113 lines
5.5 KiB
JSON

{
"task_id": "GEN2-014",
"task_revision": 1,
"architecture_revision": "ARCH-GEN2-000",
"base_repo_revision": "gen2-integration",
"risk_tier": "E",
"intent": "Дать быстрый локальный путь для проверенных повторяемых задач без закостенения.",
"requirement_ids": [
"REQ-GEN2-014-GOAL",
"REQ-GEN2-014-BOUNDARY",
"REQ-GEN2-014-GATE"
],
"allowed_change_scope": {
"modules": [
"capability"
],
"paths": [
"modules/capability/**",
"contracts/capability/**",
"adapters/postgres/capability_repository.go",
"database/migrations/*.sql",
"cmd/cognitive-worker/**",
"tests/**",
"dev/ACTIVE_TASK.json",
"dev/tasks/GEN2-014-add-explicit-reflex-lifecycle-shadow-reasoning-and-revalidation.json"
]
},
"forbidden_change_scope": {
"paths": [
"security/**",
"go.mod",
"go.sum",
"architecture/**",
".gitea/workflows/**",
"deploy/**",
"adapters/models/**"
]
},
"allowed_architecture_delta": {
"new_cross_module_dependencies": 0,
"new_canonical_owners": 0,
"new_privileges": 0,
"new_third_party_dependencies": 0,
"new_database_owner_roles": 1
},
"contracts": {
"consume": [
"contracts.capability@gen2",
"contracts.cognitive@gen2",
"contracts.epistemics@gen2"
],
"may_change": [
"Only contracts explicitly within GEN2-014 allowed_change_scope; preserve Gen2 owner boundaries and backward compatibility unless this packet says cutover."
]
},
"semantic_owner": "Capability. Follow GEN2 target architecture: owner boundaries are authoritative; Memory remains a read/retrieval fabric, World is not truth owner, SELF is not a God orchestrator.",
"canonical_state": [
"Capability writes Reflex lifecycle; routing reads only ACTIVE applicable reflex",
"No task may create a second canonical owner for an already-owned mutable semantic concept."
],
"state_transitions": [
"task input -> bounded Gen2 change -> FAST verification -> merge to gen2-integration; canonical writer rule: Capability writes Reflex lifecycle; routing reads only ACTIVE applicable reflex"
],
"side_effects_and_privileges": [
"No external mutation may bypass existing Authority -> Commit -> Executor boundaries.",
"Do not weaken architecture/security/test guardrails to make the task pass."
],
"persistence_and_migrations": [
"Database changes must be additive next-numbered migrations only until an explicitly approved retirement task; never edit historical V1 migrations 001-045.",
"At most one canonical writer is active for each semantic state; backfill/shadow reads do not create a second canonical writer.",
"The positive new_database_owner_roles delta in this packet is a devctl-v1 database-surface compatibility gate; it does not authorize cross-owner SQL/FK/JOIN or an extra owner unless explicitly stated by this task."
],
"failure_retry_restart": [
"Rollback rule: disable reflex feature switch; route returns to Skill/model",
"Retries/restarts must not create duplicate external side effects or a second canonical writer.",
"Durable state required by this task must survive process restart; process-local memory is never the only source of truth.",
"Cutover must keep the previous read/compatibility path available until the task or milestone explicitly proves retirement."
],
"assumptions": [
"Program milestone: M3; test profile: FAST.",
"Task branch starts from local gen2-integration; base_repo_revision=gen2-integration must resolve to the untouched integration base while the task branch is active.",
"Codex reads DOMOVOY_CONSTITUTION.md, GEN2_TARGET_ARCHITECTURE.md, GEN2_CANONICAL_DATA_MODEL.md, GEN2_MIGRATION_MAP.md, GEN2_MASTER_PLAN.md and GEN2_EXECUTION_CONTRACT.md before non-trivial edits.",
"Do not expand scope silently. If a required change falls outside allowed paths or changes ownership, return a typed gap and request a task revision.",
"Depends on: GEN2-013."
],
"acceptance_scenarios": [
"GEN2-014-SCN-01: Reflex stable ID/revisions",
"GEN2-014-SCN-02: link Reflex -> originating Skill/evidence",
"GEN2-014-SCN-03: applicability/dependencies",
"GEN2-014-SCN-04: ShadowPolicy/RevalidationPolicy",
"GEN2-014-SCN-05: fallback/escalation Reflex -> Skill -> reasoning",
"GEN2-014-SCN-06: drift/stale detection",
"GEN2-014-SCN-07: candidate/active/suspended/retired states",
"GEN2-014-SCN-08: не считать один успешный run достаточным для promotion",
"GEN2-014-EXIT: частая стабильная задача может выполняться быстро локально и автоматически вернуться к reasoning при сомнении."
],
"required_tests": [
"FAST: go test ./modules/capability/... ./contracts/capability/... ./cmd/cognitive-worker/... ./adapters/postgres",
"FAST: go vet ./modules/capability/... ./contracts/capability/... ./cmd/cognitive-worker/... ./adapters/postgres",
"FAST governance: go run ./cmd/devctl preflight -active dev/ACTIVE_TASK.json",
"FAST scope: go run ./cmd/devctl check-diff -active dev/ACTIVE_TASK.json",
"FAST independent: go run ./cmd/devctl/independent",
"FAST whitespace: git diff --check gen2-integration --"
],
"terminal_gap_states": [
"BLOCKED_BY_SPEC_GAP",
"BLOCKED_BY_ARCHITECTURE_GAP",
"BLOCKED_BY_MISSING_CAPABILITY",
"BLOCKED_BY_CONFLICT",
"REQUIRES_MIGRATION_DECISION"
]
}