From 6d8b76b447ea9a143d117057c88865f10f296387 Mon Sep 17 00:00:00 2001 From: Artyom Date: Fri, 30 Oct 2026 12:32:42 +0300 Subject: [PATCH] lab2 --- .claude/commands/opsx/apply.md | 181 ++ .claude/commands/opsx/archive.md | 225 ++ .claude/commands/opsx/explore.md | 193 ++ .claude/commands/opsx/propose.md | 145 ++ .claude/commands/opsx/sync.md | 258 ++ .claude/commands/opsx/update.md | 87 + .claude/hooks/lint-python.sh | 45 + .claude/settings.json | 17 + .claude/skills/openspec-apply-change/SKILL.md | 185 ++ .../skills/openspec-archive-change/SKILL.md | 182 ++ .claude/skills/openspec-explore/SKILL.md | 308 +++ .claude/skills/openspec-propose/SKILL.md | 149 ++ .claude/skills/openspec-sync-specs/SKILL.md | 262 ++ .../skills/openspec-update-change/SKILL.md | 91 + .dockerignore | 24 + .env.example | 5 + .github/workflows/application.yml | 58 + .gitignore | 8 + AGENTS.md | 61 + Dockerfile | 47 + Makefile | 118 +- REPORT.md | 550 +++- compose.yaml | 149 ++ evidence/cache.txt | 27 + evidence/checks.txt | 17 + evidence/environment.txt | 41 + evidence/explain-history.txt | 80 + evidence/faults.txt | 73 + evidence/kdf.txt | 14 + evidence/load-c64-1.json | 17 + evidence/load-c64-2.json | 17 + evidence/load-c64-3.json | 17 + evidence/load.txt | 67 + evidence/migrations.txt | 36 + evidence/persistence.txt | 14 + evidence/schema.txt | 111 + evidence/secrets.txt | 13 + evidence/sigterm.txt | 21 + evidence/student-tests.txt | 329 +++ evidence/track/bench.json | 2260 +++++++++++++++++ evidence/track/plans.txt | 552 ++++ evidence/track/recovery.json | 608 +++++ evidence/track/summary.txt | 66 + .../.openspec.yaml | 4 + .../2026-09-29-add-lab1-messenger/design.md | 177 ++ .../2026-09-29-add-lab1-messenger/proposal.md | 38 + .../specs/lab1-event-publication/spec.md | 102 + .../specs/lab1-inmemory-capacity/spec.md | 60 + .../specs/lab1-messenger-chats/spec.md | 85 + .../specs/lab1-messenger-history/spec.md | 106 + .../specs/lab1-messenger-identity/spec.md | 84 + .../specs/lab1-service-operability/spec.md | 164 ++ .../2026-09-29-add-lab1-messenger/tasks.md | 94 + .../.openspec.yaml | 5 + .../design.md | 66 + .../proposal.md | 37 + .../tasks.md | 47 + .../.openspec.yaml | 5 + .../design.md | 104 + .../proposal.md | 39 + .../specs/lab1-event-publication/spec.md | 48 + .../specs/lab1-inmemory-capacity/spec.md | 16 + .../specs/lab1-messenger-chats/spec.md | 32 + .../specs/lab1-messenger-history/spec.md | 21 + .../specs/lab1-messenger-identity/spec.md | 58 + .../specs/lab1-service-operability/spec.md | 56 + .../specs/lab2-auth-sessions/spec.md | 123 + .../specs/lab2-persistent-storage/spec.md | 76 + .../tasks.md | 52 + .../.openspec.yaml | 4 + .../design.md | 51 + .../proposal.md | 30 + .../specs/lab2-query-plan-recovery/spec.md | 51 + .../tasks.md | 22 + .../.openspec.yaml | 4 + .../design.md | 62 + .../proposal.md | 34 + .../specs/lab2-dependency-failures/spec.md | 37 + .../specs/lab2-history-index/spec.md | 24 + .../specs/lab2-session-cache/spec.md | 56 + .../tasks.md | 38 + .../.openspec.yaml | 4 + .../design.md | 37 + .../proposal.md | 33 + .../specs/lab1-event-publication/spec.md | 32 + .../specs/lab1-messenger-chats/spec.md | 30 + .../specs/lab1-service-operability/spec.md | 43 + .../tasks.md | 25 + .../.openspec.yaml | 4 + .../design.md | 31 + .../proposal.md | 32 + .../specs/lab1-event-publication/spec.md | 20 + .../specs/lab1-messenger-chats/spec.md | 31 + .../specs/lab1-messenger-history/spec.md | 46 + .../specs/lab2-session-cache/spec.md | 21 + .../tasks.md | 19 + openspec/config.yaml | 138 + .../notes/architecture-patterns-python.md | 349 +++ openspec/specs/lab1-event-publication/spec.md | 107 + openspec/specs/lab1-messenger-chats/spec.md | 95 + openspec/specs/lab1-messenger-history/spec.md | 116 + .../specs/lab1-messenger-identity/spec.md | 50 + .../specs/lab1-service-operability/spec.md | 184 ++ openspec/specs/lab2-auth-sessions/spec.md | 123 + .../specs/lab2-dependency-failures/spec.md | 37 + openspec/specs/lab2-history-index/spec.md | 24 + .../specs/lab2-persistent-storage/spec.md | 76 + .../specs/lab2-query-plan-recovery/spec.md | 51 + openspec/specs/lab2-session-cache/spec.md | 62 + pyproject.toml | 115 + scripts/evidence-cache.sh | 35 + scripts/evidence-environment.sh | 22 + scripts/evidence-load.sh | 25 + scripts/evidence-migrations.sh | 26 + scripts/evidence-sigterm.sh | 61 + scripts/evidence-storage.sh | 35 + scripts/evidence-toolchain.sh | 27 + scripts/persistence-evidence.sh | 17 + scripts/restart.sh | 6 + scripts/secrets.sh | 20 + scripts/sql/explain-history.sql | 59 + scripts/sql/seed-history.sql | 40 + scripts/sql/track-seed.sql | 50 + scripts/sql/track-setup.sql | 28 + scripts/track.py | 675 +++++ src/messenger/__init__.py | 0 src/messenger/gunicorn_conf.py | 41 + src/messenger/identity/__init__.py | 0 .../identity/application/__init__.py | 0 src/messenger/identity/application/bus.py | 5 + .../identity/application/commands.py | 22 + .../identity/application/handlers.py | 80 + src/messenger/identity/application/ports.py | 53 + src/messenger/identity/application/queries.py | 43 + src/messenger/identity/config.py | 12 + src/messenger/identity/domain/__init__.py | 0 src/messenger/identity/domain/errors.py | 17 + src/messenger/identity/domain/events.py | 25 + src/messenger/identity/domain/models.py | 62 + src/messenger/identity/domain/values.py | 54 + .../identity/entrypoints/__init__.py | 0 .../identity/entrypoints/authentication.py | 98 + src/messenger/identity/entrypoints/errors.py | 12 + src/messenger/identity/entrypoints/http.py | 57 + src/messenger/identity/entrypoints/ioc.py | 117 + src/messenger/identity/entrypoints/journal.py | 20 + src/messenger/identity/entrypoints/schemas.py | 42 + .../identity/infrastructure/__init__.py | 0 .../identity/infrastructure/argon2.py | 35 + .../identity/infrastructure/postgres.py | 121 + .../identity/infrastructure/valkey.py | 113 + src/messenger/main.py | 103 + src/messenger/messaging/__init__.py | 0 .../messaging/application/__init__.py | 0 src/messenger/messaging/application/bus.py | 5 + .../messaging/application/commands.py | 19 + .../messaging/application/handlers.py | 51 + src/messenger/messaging/application/ports.py | 41 + .../messaging/application/queries.py | 73 + src/messenger/messaging/config.py | 7 + src/messenger/messaging/domain/__init__.py | 0 src/messenger/messaging/domain/errors.py | 21 + src/messenger/messaging/domain/events.py | 24 + src/messenger/messaging/domain/keys.py | 3 + src/messenger/messaging/domain/models.py | 130 + src/messenger/messaging/domain/values.py | 39 + .../messaging/entrypoints/__init__.py | 0 src/messenger/messaging/entrypoints/errors.py | 14 + src/messenger/messaging/entrypoints/http.py | 79 + src/messenger/messaging/entrypoints/ioc.py | 65 + .../messaging/entrypoints/journal.py | 27 + .../messaging/entrypoints/schemas.py | 72 + .../messaging/infrastructure/__init__.py | 0 .../messaging/infrastructure/cursor.py | 59 + .../messaging/infrastructure/postgres.py | 179 ++ src/messenger/migrate.py | 75 + src/messenger/migrations/0001_init.sql | 46 + src/messenger/shared/__init__.py | 0 src/messenger/shared/application/__init__.py | 0 src/messenger/shared/application/commands.py | 2 + src/messenger/shared/application/errors.py | 2 + .../shared/application/messagebus.py | 115 + src/messenger/shared/application/ports.py | 42 + src/messenger/shared/config.py | 47 + src/messenger/shared/domain/__init__.py | 0 src/messenger/shared/domain/errors.py | 4 + src/messenger/shared/domain/events.py | 6 + src/messenger/shared/entrypoints/__init__.py | 0 src/messenger/shared/entrypoints/actor.py | 16 + src/messenger/shared/entrypoints/config.py | 9 + src/messenger/shared/entrypoints/errors.py | 133 + src/messenger/shared/entrypoints/health.py | 19 + src/messenger/shared/entrypoints/ioc.py | 54 + src/messenger/shared/entrypoints/pipeline.py | 170 ++ src/messenger/shared/entrypoints/schemas.py | 21 + .../shared/infrastructure/__init__.py | 0 src/messenger/shared/infrastructure/clock.py | 17 + src/messenger/shared/infrastructure/ids.py | 8 + .../shared/infrastructure/logging.py | 113 + .../shared/infrastructure/postgres.py | 115 + student-tests/api/test_access.py | 105 + student-tests/api/test_bounded_contexts.py | 228 ++ student-tests/api/test_cache.py | 146 ++ student-tests/api/test_concurrency.py | 88 + student-tests/api/test_consistency.py | 188 ++ student-tests/api/test_events.py | 112 + student-tests/api/test_migrations.py | 69 + student-tests/api/test_negative.py | 196 ++ student-tests/api/test_operability.py | 162 ++ student-tests/api/test_pagination.py | 156 ++ student-tests/api/test_pool.py | 27 + student-tests/api/test_sessions.py | 172 ++ student-tests/api/test_timeout.py | 97 + student-tests/api/test_wire_format.py | 67 + student-tests/conftest.py | 204 ++ student-tests/fakes.py | 23 + student-tests/stack/test_faults.py | 267 ++ student-tests/stand.py | 101 + student-tests/unit/test_authentication.py | 64 + student-tests/unit/test_cursor.py | 56 + student-tests/unit/test_domain.py | 183 ++ uv.lock | 1037 ++++++++ 222 files changed, 19685 insertions(+), 18 deletions(-) create mode 100644 .claude/commands/opsx/apply.md create mode 100644 .claude/commands/opsx/archive.md create mode 100644 .claude/commands/opsx/explore.md create mode 100644 .claude/commands/opsx/propose.md create mode 100644 .claude/commands/opsx/sync.md create mode 100644 .claude/commands/opsx/update.md create mode 100755 .claude/hooks/lint-python.sh create mode 100644 .claude/settings.json create mode 100644 .claude/skills/openspec-apply-change/SKILL.md create mode 100644 .claude/skills/openspec-archive-change/SKILL.md create mode 100644 .claude/skills/openspec-explore/SKILL.md create mode 100644 .claude/skills/openspec-propose/SKILL.md create mode 100644 .claude/skills/openspec-sync-specs/SKILL.md create mode 100644 .claude/skills/openspec-update-change/SKILL.md create mode 100644 .github/workflows/application.yml create mode 100644 AGENTS.md create mode 100644 Dockerfile create mode 100644 compose.yaml create mode 100644 evidence/cache.txt create mode 100644 evidence/checks.txt create mode 100644 evidence/environment.txt create mode 100644 evidence/explain-history.txt create mode 100644 evidence/faults.txt create mode 100644 evidence/kdf.txt create mode 100644 evidence/load-c64-1.json create mode 100644 evidence/load-c64-2.json create mode 100644 evidence/load-c64-3.json create mode 100644 evidence/load.txt create mode 100644 evidence/migrations.txt create mode 100644 evidence/persistence.txt create mode 100644 evidence/schema.txt create mode 100644 evidence/secrets.txt create mode 100644 evidence/sigterm.txt create mode 100644 evidence/student-tests.txt create mode 100644 evidence/track/bench.json create mode 100644 evidence/track/plans.txt create mode 100644 evidence/track/recovery.json create mode 100644 evidence/track/summary.txt create mode 100644 openspec/changes/archive/2026-09-29-add-lab1-messenger/.openspec.yaml create mode 100644 openspec/changes/archive/2026-09-29-add-lab1-messenger/design.md create mode 100644 openspec/changes/archive/2026-09-29-add-lab1-messenger/proposal.md create mode 100644 openspec/changes/archive/2026-09-29-add-lab1-messenger/specs/lab1-event-publication/spec.md create mode 100644 openspec/changes/archive/2026-09-29-add-lab1-messenger/specs/lab1-inmemory-capacity/spec.md create mode 100644 openspec/changes/archive/2026-09-29-add-lab1-messenger/specs/lab1-messenger-chats/spec.md create mode 100644 openspec/changes/archive/2026-09-29-add-lab1-messenger/specs/lab1-messenger-history/spec.md create mode 100644 openspec/changes/archive/2026-09-29-add-lab1-messenger/specs/lab1-messenger-identity/spec.md create mode 100644 openspec/changes/archive/2026-09-29-add-lab1-messenger/specs/lab1-service-operability/spec.md create mode 100644 openspec/changes/archive/2026-09-29-add-lab1-messenger/tasks.md create mode 100644 openspec/changes/archive/2026-10-12-typed-boundary-schemas/.openspec.yaml create mode 100644 openspec/changes/archive/2026-10-12-typed-boundary-schemas/design.md create mode 100644 openspec/changes/archive/2026-10-12-typed-boundary-schemas/proposal.md create mode 100644 openspec/changes/archive/2026-10-12-typed-boundary-schemas/tasks.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/.openspec.yaml create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/design.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/proposal.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/specs/lab1-event-publication/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/specs/lab1-inmemory-capacity/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/specs/lab1-messenger-chats/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/specs/lab1-messenger-history/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/specs/lab1-messenger-identity/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/specs/lab1-service-operability/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/specs/lab2-auth-sessions/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/specs/lab2-persistent-storage/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/tasks.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-query-plan-recovery/.openspec.yaml create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-query-plan-recovery/design.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-query-plan-recovery/proposal.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-query-plan-recovery/specs/lab2-query-plan-recovery/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-query-plan-recovery/tasks.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-session-cache-and-resilience/.openspec.yaml create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-session-cache-and-resilience/design.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-session-cache-and-resilience/proposal.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-session-cache-and-resilience/specs/lab2-dependency-failures/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-session-cache-and-resilience/specs/lab2-history-index/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-session-cache-and-resilience/specs/lab2-session-cache/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-session-cache-and-resilience/tasks.md create mode 100644 openspec/changes/archive/2026-10-28-harden-lab2-after-review/.openspec.yaml create mode 100644 openspec/changes/archive/2026-10-28-harden-lab2-after-review/design.md create mode 100644 openspec/changes/archive/2026-10-28-harden-lab2-after-review/proposal.md create mode 100644 openspec/changes/archive/2026-10-28-harden-lab2-after-review/specs/lab1-event-publication/spec.md create mode 100644 openspec/changes/archive/2026-10-28-harden-lab2-after-review/specs/lab1-messenger-chats/spec.md create mode 100644 openspec/changes/archive/2026-10-28-harden-lab2-after-review/specs/lab1-service-operability/spec.md create mode 100644 openspec/changes/archive/2026-10-28-harden-lab2-after-review/tasks.md create mode 100644 openspec/changes/archive/2026-10-28-harden-lab2-second-review/.openspec.yaml create mode 100644 openspec/changes/archive/2026-10-28-harden-lab2-second-review/design.md create mode 100644 openspec/changes/archive/2026-10-28-harden-lab2-second-review/proposal.md create mode 100644 openspec/changes/archive/2026-10-28-harden-lab2-second-review/specs/lab1-event-publication/spec.md create mode 100644 openspec/changes/archive/2026-10-28-harden-lab2-second-review/specs/lab1-messenger-chats/spec.md create mode 100644 openspec/changes/archive/2026-10-28-harden-lab2-second-review/specs/lab1-messenger-history/spec.md create mode 100644 openspec/changes/archive/2026-10-28-harden-lab2-second-review/specs/lab2-session-cache/spec.md create mode 100644 openspec/changes/archive/2026-10-28-harden-lab2-second-review/tasks.md create mode 100644 openspec/config.yaml create mode 100644 openspec/notes/architecture-patterns-python.md create mode 100644 openspec/specs/lab1-event-publication/spec.md create mode 100644 openspec/specs/lab1-messenger-chats/spec.md create mode 100644 openspec/specs/lab1-messenger-history/spec.md create mode 100644 openspec/specs/lab1-messenger-identity/spec.md create mode 100644 openspec/specs/lab1-service-operability/spec.md create mode 100644 openspec/specs/lab2-auth-sessions/spec.md create mode 100644 openspec/specs/lab2-dependency-failures/spec.md create mode 100644 openspec/specs/lab2-history-index/spec.md create mode 100644 openspec/specs/lab2-persistent-storage/spec.md create mode 100644 openspec/specs/lab2-query-plan-recovery/spec.md create mode 100644 openspec/specs/lab2-session-cache/spec.md create mode 100644 pyproject.toml create mode 100755 scripts/evidence-cache.sh create mode 100755 scripts/evidence-environment.sh create mode 100755 scripts/evidence-load.sh create mode 100755 scripts/evidence-migrations.sh create mode 100755 scripts/evidence-sigterm.sh create mode 100755 scripts/evidence-storage.sh create mode 100755 scripts/evidence-toolchain.sh create mode 100755 scripts/persistence-evidence.sh create mode 100755 scripts/restart.sh create mode 100755 scripts/secrets.sh create mode 100644 scripts/sql/explain-history.sql create mode 100644 scripts/sql/seed-history.sql create mode 100644 scripts/sql/track-seed.sql create mode 100644 scripts/sql/track-setup.sql create mode 100644 scripts/track.py create mode 100644 src/messenger/__init__.py create mode 100644 src/messenger/gunicorn_conf.py create mode 100644 src/messenger/identity/__init__.py create mode 100644 src/messenger/identity/application/__init__.py create mode 100644 src/messenger/identity/application/bus.py create mode 100644 src/messenger/identity/application/commands.py create mode 100644 src/messenger/identity/application/handlers.py create mode 100644 src/messenger/identity/application/ports.py create mode 100644 src/messenger/identity/application/queries.py create mode 100644 src/messenger/identity/config.py create mode 100644 src/messenger/identity/domain/__init__.py create mode 100644 src/messenger/identity/domain/errors.py create mode 100644 src/messenger/identity/domain/events.py create mode 100644 src/messenger/identity/domain/models.py create mode 100644 src/messenger/identity/domain/values.py create mode 100644 src/messenger/identity/entrypoints/__init__.py create mode 100644 src/messenger/identity/entrypoints/authentication.py create mode 100644 src/messenger/identity/entrypoints/errors.py create mode 100644 src/messenger/identity/entrypoints/http.py create mode 100644 src/messenger/identity/entrypoints/ioc.py create mode 100644 src/messenger/identity/entrypoints/journal.py create mode 100644 src/messenger/identity/entrypoints/schemas.py create mode 100644 src/messenger/identity/infrastructure/__init__.py create mode 100644 src/messenger/identity/infrastructure/argon2.py create mode 100644 src/messenger/identity/infrastructure/postgres.py create mode 100644 src/messenger/identity/infrastructure/valkey.py create mode 100644 src/messenger/main.py create mode 100644 src/messenger/messaging/__init__.py create mode 100644 src/messenger/messaging/application/__init__.py create mode 100644 src/messenger/messaging/application/bus.py create mode 100644 src/messenger/messaging/application/commands.py create mode 100644 src/messenger/messaging/application/handlers.py create mode 100644 src/messenger/messaging/application/ports.py create mode 100644 src/messenger/messaging/application/queries.py create mode 100644 src/messenger/messaging/config.py create mode 100644 src/messenger/messaging/domain/__init__.py create mode 100644 src/messenger/messaging/domain/errors.py create mode 100644 src/messenger/messaging/domain/events.py create mode 100644 src/messenger/messaging/domain/keys.py create mode 100644 src/messenger/messaging/domain/models.py create mode 100644 src/messenger/messaging/domain/values.py create mode 100644 src/messenger/messaging/entrypoints/__init__.py create mode 100644 src/messenger/messaging/entrypoints/errors.py create mode 100644 src/messenger/messaging/entrypoints/http.py create mode 100644 src/messenger/messaging/entrypoints/ioc.py create mode 100644 src/messenger/messaging/entrypoints/journal.py create mode 100644 src/messenger/messaging/entrypoints/schemas.py create mode 100644 src/messenger/messaging/infrastructure/__init__.py create mode 100644 src/messenger/messaging/infrastructure/cursor.py create mode 100644 src/messenger/messaging/infrastructure/postgres.py create mode 100644 src/messenger/migrate.py create mode 100644 src/messenger/migrations/0001_init.sql create mode 100644 src/messenger/shared/__init__.py create mode 100644 src/messenger/shared/application/__init__.py create mode 100644 src/messenger/shared/application/commands.py create mode 100644 src/messenger/shared/application/errors.py create mode 100644 src/messenger/shared/application/messagebus.py create mode 100644 src/messenger/shared/application/ports.py create mode 100644 src/messenger/shared/config.py create mode 100644 src/messenger/shared/domain/__init__.py create mode 100644 src/messenger/shared/domain/errors.py create mode 100644 src/messenger/shared/domain/events.py create mode 100644 src/messenger/shared/entrypoints/__init__.py create mode 100644 src/messenger/shared/entrypoints/actor.py create mode 100644 src/messenger/shared/entrypoints/config.py create mode 100644 src/messenger/shared/entrypoints/errors.py create mode 100644 src/messenger/shared/entrypoints/health.py create mode 100644 src/messenger/shared/entrypoints/ioc.py create mode 100644 src/messenger/shared/entrypoints/pipeline.py create mode 100644 src/messenger/shared/entrypoints/schemas.py create mode 100644 src/messenger/shared/infrastructure/__init__.py create mode 100644 src/messenger/shared/infrastructure/clock.py create mode 100644 src/messenger/shared/infrastructure/ids.py create mode 100644 src/messenger/shared/infrastructure/logging.py create mode 100644 src/messenger/shared/infrastructure/postgres.py create mode 100644 student-tests/api/test_access.py create mode 100644 student-tests/api/test_bounded_contexts.py create mode 100644 student-tests/api/test_cache.py create mode 100644 student-tests/api/test_concurrency.py create mode 100644 student-tests/api/test_consistency.py create mode 100644 student-tests/api/test_events.py create mode 100644 student-tests/api/test_migrations.py create mode 100644 student-tests/api/test_negative.py create mode 100644 student-tests/api/test_operability.py create mode 100644 student-tests/api/test_pagination.py create mode 100644 student-tests/api/test_pool.py create mode 100644 student-tests/api/test_sessions.py create mode 100644 student-tests/api/test_timeout.py create mode 100644 student-tests/api/test_wire_format.py create mode 100644 student-tests/conftest.py create mode 100644 student-tests/fakes.py create mode 100644 student-tests/stack/test_faults.py create mode 100644 student-tests/stand.py create mode 100644 student-tests/unit/test_authentication.py create mode 100644 student-tests/unit/test_cursor.py create mode 100644 student-tests/unit/test_domain.py create mode 100644 uv.lock diff --git a/.claude/commands/opsx/apply.md b/.claude/commands/opsx/apply.md new file mode 100644 index 00000000..31c4fa24 --- /dev/null +++ b/.claude/commands/opsx/apply.md @@ -0,0 +1,181 @@ +--- +name: "OPSX: Apply" +description: "Implement tasks from an OpenSpec change (Experimental)" +allowed-tools: Bash(openspec:*) +category: "Workflow" +tags: ["workflow", "artifacts", "experimental"] +--- + +Implement tasks from an OpenSpec change. + +**Store selection:** If the user names a store (a store is a standalone OpenSpec repo registered on this machine) or the work lives in one, run `openspec store list --json` to discover registered store ids, then pass `--store ` on the commands that read or write specs and changes (`new change`, `status`, `instructions`, `list`, `show`, `validate`, `archive`, `doctor`, `context`, `view`). Once selected, treat `--store ` as sticky for the rest of the workflow. Every unscoped example of those commands below is shorthand: before running it, append the flag. For example, run `openspec status --change "" --json --store ""`, not the unscoped form shown below. Other commands do not take the flag. Hints printed by commands already carry the flag; keep it on follow-ups. Without a store, commands act on the nearest local `openspec/` root. + +**Input**: Optionally specify a change name (e.g., `/opsx:apply add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes. + +**Steps** + +1. **Select the change** + + If a name is provided, use it. Otherwise: + - Infer from conversation context if the user mentioned a change + - Auto-select if only one active change exists + - If ambiguous, run `openspec list --json` to get available changes and ask the user to select one + + Always announce: "Using change: " and how to override (e.g., `/opsx:apply `). + +2. **Check status to understand the schema** + ```bash + openspec status --change "" --json + ``` + Parse the JSON to understand: + - `schemaName`: The workflow being used (e.g., "spec-driven") + - `planningHome`, `changeRoot`, and `actionContext`: planning scope and edit constraints + - Which artifact contains the tasks (typically "tasks" for spec-driven, check status for others) + +3. **Get apply instructions** + + ```bash + openspec instructions apply --change "" --json + ``` + + This returns: + - `contextFiles`: artifact ID -> array of concrete file paths (varies by schema - could be proposal/specs/design/tasks or spec/tests/implementation/docs) + - Progress (total, complete, remaining) + - Task list with status + - Dynamic instruction based on current state + - Optional `context`: current required project instruction input from the selected root + - Optional `operationGuidance`: current advisory guidance for apply + + **Handle states:** + - If `state: "blocked"` (missing artifacts): show message, suggest using `/opsx:continue` (if it is not installed, run `openspec status --change "" --json` to see the next artifact and `openspec instructions --change "" --json` for how to create it) + - If `state: "all_done"`: congratulate, suggest archive + - Otherwise: proceed to implementation + + Treat `context` as a required prompt-level input. Read and consider it, and + apply relevant project facts, conventions, and constraints while implementing. + Treat `operationGuidance` as optional additive advice. Read and consider every + entry, and follow entries that are applicable and compatible with the built-in + workflow. + + Keep both fields separate from CLI-returned state, missing artifacts, tasks, + progress, `contextFiles`, and the built-in `instruction`. They are not + evidence of task completion, do not replace the built-in instruction, and do + not permit bypassing a blocked state. If context conflicts with the built-in + instruction, an explicit user choice, or a CLI-controlled value, report the + conflict and preserve the controlling value. If guidance is inapplicable or + conflicts with those controlling inputs, do not follow it and explain why. + These are prompt-level behavior contracts, not enforceable checks. + +4. **Read context files** + + Read every file path listed under `contextFiles` from the apply instructions output. + The files depend on the schema being used: + - **spec-driven**: proposal, specs, design, tasks + - Other schemas: follow the contextFiles from CLI output + + Do not copy `context` or `operationGuidance` verbatim into implementation + files or planning artifacts unless the user separately asks for that content. + +5. **Show current progress** + + Display: + - Schema being used + - Progress: "N/M tasks complete" + - Remaining tasks overview + - Dynamic instruction from CLI + +6. **Implement tasks (loop until done or blocked)** + + For each pending task: + - Show which task is being worked on + - Make the code changes required + - Keep changes minimal and focused + - Mark task complete in the tasks file: `- [ ]` → `- [x]` + - Continue to next task + + **Pause if:** + - Task is unclear → ask for clarification + - Implementation reveals a design issue → suggest updating artifacts + - Error or blocker encountered → report and wait for guidance + - User interrupts + +7. **On completion or pause, show status** + + Display: + - Tasks completed this session + - Overall progress: "N/M tasks complete" + - If all done: suggest archive + - If paused: explain why and wait for guidance + +**Output During Implementation** + +``` +## Implementing: (schema: ) + +Working on task 3/7: +[...implementation happening...] +✓ Task complete + +Working on task 4/7: +[...implementation happening...] +✓ Task complete +``` + +**Output On Completion** + +``` +## Implementation Complete + +**Change:** +**Schema:** +**Progress:** 7/7 tasks complete ✓ + +### Completed This Session +- [x] Task 1 +- [x] Task 2 +... + +All tasks complete! You can archive this change with `/opsx:archive`. +``` + +**Output On Pause (Issue Encountered)** + +``` +## Implementation Paused + +**Change:** +**Schema:** +**Progress:** 4/7 tasks complete + +### Issue Encountered + + +**Options:** +1.