j5ik2o/event-store-adapter-js
42.6
Weak · 9 November 2026
9.7k
lines of production code
TypeScript
with Python
6
measurements over time
What this system is
Features
Add executable Event Sourcing examples for memory, DynamoDB, and Spanner backends
The \packages/examples\ directory now includes runnable samples that demonstrate how to implement an Event Sourcing repository using the \event-store-adapter-js\ library. These examples cover a \UserAccount\ aggregate with \UserAccountCreated\ and \UserAccountRenamed\ events, showcasing domain modeling, JSON serialization, and optimistic locking. Users can run the samples against an in-memory store (\npm run example:memory\), a LocalStack DynamoDB container (\npm run example:dynamodb\), or a Cloud Spanner emulator (\npm run example:spanner\), with the latter two requiring Docker and \testcontainers\.
packages/examples · high confidence
Added Okite AI reference submodule
A new Git submodule reference for 'okite-ai' has been added to the repository, pointing to commit 69fa7cb. This allows the project to track and include external documentation or resources from the Okite AI project as a reference.
references · high confidence
Added test artifact cleanup script with validation
A new script (remove-test-artifacts.mjs) has been introduced to automatically remove test-related build outputs (files ending in .test.d.ts or .test.js) from the dist directory. The script validates that the build output directory exists before proceeding, recursively collects test artifacts, removes them along with a specific test support folder, and throws an error if any test artifacts remain after cleanup, helping to ensure build outputs are free of test code.
packages/library/scripts · high confidence
Conformance data manifest tool added
A new Python script (\manifest.py\) has been added to the \tools/conformance\ directory to generate and verify a manifest of conformance test data files. This tool allows users to rebuild a \manifest.json\ containing SHA-256 hashes for all files in the conformance directory or verify that the current file set matches the expected manifest, ensuring data integrity and consistency for the conformance suite.
tools · high confidence
Initial .takt project scaffolding with DDD support and launcher scripts
The .takt directory is introduced, providing the core configuration and workflow scaffolding for the TAKT system. This includes launcher scripts in .takt/bin (run-takt.sh, takt-claude.sh, takt-codex.sh) that manage account-specific environments for Claude and Codex CLIs, a .gitignore to structure the project, and a config.yaml defining rate-limit fallback chains across providers like Claude, Codex, and Ollama. Additionally, the change adds comprehensive Domain-Driven Design (DDD) facets, including personas (ddd-reviewer), policies, knowledge bases for Rust and TypeScript modeling, and instruction sets for planning, implementation, and review steps tailored to DDD workflows.
.takt · high confidence
Initial agent configuration and documentation
This change introduces the foundational configuration for AI agents within the project. It adds a set of rules in \.agents/rules/\ that enforce coding standards, including requiring analysis of existing patterns before writing new code, mandating immutability for non-Rust languages, prohibiting ambiguous naming suffixes, enforcing single-type-per-file organization, and ensuring skill selection transparency. It also includes a command for git commits and a collection of skills in \.agents/skills/\ covering error classification and handling, GitHub issue triage, intent-based code deduplication, Law of Demeter compliance, and OpenSpec workflow management.
.agents · high confidence
Introduce Kiro spec-driven development workflow commands
Adds a comprehensive set of slash commands under \.claude/commands/kiro/\ to support a spec-driven development lifecycle. These commands enable users to initialize specifications (\spec-init\), generate requirements (\spec-requirements\), create technical designs (\spec-design\), generate implementation tasks (\spec-tasks\), and execute tasks using TDD (\spec-impl\). The suite also includes a \spec-quick\ command for automated end-to-end generation, status tracking (\spec-status\), and validation tools for design quality (\validate-design\), implementation gaps (\validate-gap\), and final implementation correctness (\validate-impl\). Additionally, steering management commands (\steering\, \steering-custom\) are provided to maintain persistent project knowledge and create domain-specific context documents.
.claude · high confidence
Library package structure and documentation added
The \packages/library\ directory now contains the core library source, including TypeScript configuration (\tsconfig.json\) and test setup (\jest.config.ts\). Documentation has been refreshed with new English (\README.md\) and Japanese (\README.ja.md\) guides covering installation, usage for Memory, DynamoDB, and Spanner stores, and migration paths. Dual licensing is established with the addition of \LICENSE-MIT\ and \LICENSE-APACHE\ files.
packages/library · high confidence
New launcher scripts for AI coding agents and agent documentation generator
Added a set of shell scripts in the \scripts/\ directory to launch various AI coding assistants (Claude, Codex, Codex.app, Cursor, Gemini, OpenCode) with specific environment configurations and permission-bypass flags, including separate corporate and personal variants for Claude and Codex. Also added \generate-agents-md.sh\ to automatically assemble a combined \AGENTS.md\ documentation file from \COMMON.md\ and rule files located in \.agents/rules/\.
scripts · high confidence
Repository restructured into a pnpm workspace with new tooling and documentation
The project has been reorganized into a pnpm workspace containing three packages: \packages/library\ (the main \event-store-adapter-js\ library), \packages/examples\ (runnable examples), and \packages/tests\ (future test packages). This structural change is supported by the addition of \pnpm-workspace.yaml\, \.npmrc\, and \mise.toml\ (configuring Node.js 24, Java 25, and SBT 1.12.11). The repository now includes comprehensive configuration for development and CI, including \biome.json\ for code formatting/linting, \codecov.yml\ for coverage gates, \renovate.json\ for automated dependency updates, and \.coderabbit.yaml\ for AI-assisted PR reviews. Additionally, the project introduces LLM coding guidelines via \AGENTS.md\ and \COMMON.md\, adds a git submodule for \okite-ai\, and updates the \README.md\ files to reflect the new workspace structure and development commands.
(repo-wide) · high confidence
Behavioural changes
1 commit (0 fixes) modifying python
A change to existing behaviour in python — 1 commit, 1 file: “docs: align user documentation with the shared template (\#1096)” (refs \#1096).
python · medium confidence · unverified
DynamoDB event store implementation with strict input validation and pagination
The DynamoDB event store implementation has been rewritten to include rigorous input validation at initialization, rejecting invalid configurations (such as duplicate table names, missing clients, or invalid retry limits) before any AWS SDK calls are made. The store now handles DynamoDB pagination correctly by iterating through all pages of aggregate events and snapshots, ensuring no data is missed during reads. Additionally, event envelope restoration has been strengthened to validate attribute types and ranges (e.g., sequence numbers, timestamps) and properly classify deserialization errors, improving reliability and error reporting for users interacting with the DynamoDB backend.
packages/library/src/internal · high confidence
Introduces strict contract validation for AggregateId and EventEnvelope
The library now enforces runtime validation rules for core data structures. AggregateId creation rejects type names containing hyphens (rule T-11) and enforces a 1024-byte UTF-8 limit on the combined type name and value (rule T-12), while also ensuring values are well-formed UTF-16. EventEnvelope creation validates that sequence numbers are positive integers (rules W-6, T-9), that occurredAt dates are within valid ranges (rule T-13), and that the input object contains all required fields (rule T-2). These changes ensure that invalid data is rejected early with specific, traceable error codes.
packages/library/src · high confidence
Kiro settings now reference external configuration
The \.kiro/settings\ file has been converted into a symbolic link pointing to \../references/okite-ai/.kiro/settings\. This change centralizes the Kiro configuration, meaning any updates to the settings must now be made in the shared \okite-ai\ reference directory rather than locally within this project.
.kiro · high confidence
Test coverage
1 commit adding/updating tests in packages/library/src/internal/test/api-surface; 9 commits adding/updating tests in packages/library/src/internal/test/conformance; Added end-to-end tests for library consumption and DynamoDB integration.
Dependencies
Update development dependencies and tooling
Updated several development dependencies: @biomejs/biome to v2.4.16, testcontainers to v12.0.1, pnpm to v11.5.1, @aws-sdk/client-dynamodb to v3.1057.0, and typescript-eslint monorepo to v8.60.0.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.
Score
- CAI 49 → 43 (-6.2)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 80 → 78 (-1.4)
- Architecture 99 → 98 (-1.6)
- Maturity 38 → 50 (+11.8)
- Readiness 64 → 56 (-7.7)
- Security 52 → 34 (-18.2)
- Domain Modelling 100 → 100 (+0.0)
- Accessibility 48 → 35 (-13.1)
- Performance 100 → 100 (+0.0)
Resolved (23)
- Cross-context type EventStoreError (library → examples) (packages/examples/src/run-user-account-example.ts)
- Cross-context type Result (library → examples) (packages/examples/src/run-user-account-example.ts)
- Documentation: written for insiders (packages/library/docs/MIGRATION_GUIDE_3.0.ja.md)
- Documentation: written for insiders (packages/library/docs/MIGRATION_GUIDE_4.0.md)
- Hotspot: packages/library/src/internal/test/conformance/conformance-case-executor.ts (packages/library/src/internal/test/conformance/conformance-case-executor.ts)
- Hotspot: packages/library/src/internal/test/conformance/conformance-data-loader.ts (packages/library/src/internal/test/conformance/conformance-data-loader.ts)
- Hotspot: packages/library/src/internal/test/dynamodb-persist-event-observation.ts (packages/library/src/internal/test/dynamodb-persist-event-observation.ts)
- Low coverage: packages/library/src/event-store.ts (packages/library/src/event-store.ts)
- Low coverage: packages/library/src/internal/dynamodb-batch-get.ts (packages/library/src/internal/dynamodb-batch-get.ts)
- Low coverage: packages/library/src/internal/dynamodb-event-envelope-restore.ts (packages/library/src/internal/dynamodb-event-envelope-restore.ts)
- Low coverage: packages/library/src/internal/dynamodb-event-store-input-validation.ts (packages/library/src/internal/dynamodb-event-store-input-validation.ts)
- Low coverage: packages/library/src/internal/dynamodb-event-store.ts (packages/library/src/internal/dynamodb-event-store.ts)
- Low coverage: packages/library/src/internal/dynamodb-get-events.ts (packages/library/src/internal/dynamodb-get-events.ts)
- Low coverage: packages/library/src/internal/dynamodb-get-latest-snapshot.ts (packages/library/src/internal/dynamodb-get-latest-snapshot.ts)
- Low coverage: packages/library/src/internal/dynamodb-item-size.ts (packages/library/src/internal/dynamodb-item-size.ts)
- Low coverage: packages/library/src/internal/dynamodb-latest-snapshot-restore.ts (packages/library/src/internal/dynamodb-latest-snapshot-restore.ts)
- Low coverage: packages/library/src/internal/dynamodb-persist-event-error.ts (packages/library/src/internal/dynamodb-persist-event-error.ts)
- Low coverage: packages/library/src/internal/dynamodb-persist-event.ts (packages/library/src/internal/dynamodb-persist-event.ts)
- Low coverage: packages/library/src/internal/dynamodb-persist-event.ts (packages/library/src/internal/dynamodb-persist-event.ts)
- Low coverage: packages/library/src/internal/dynamodb-store-configuration.ts (packages/library/src/internal/dynamodb-store-configuration.ts)
- …and 3 more
New (50)
- Deprecated: @google-cloud/opentelemetry-cloud-monitoring-exporter (pnpm-lock.yaml)
- Deprecated: @google-cloud/opentelemetry-resource-util (pnpm-lock.yaml)
- Deprecated: @smithy/core (pnpm-lock.yaml)
- Deprecated: uuid (pnpm-lock.yaml)
- High CVE: [GHSA redacted] (pnpm-lock.yaml)
- High: security finding (details withheld)
- Low CVE: [GHSA redacted] (pnpm-lock.yaml)
- Low coverage: packages/library/src/internal/bigtable-event-store.ts (packages/library/src/internal/bigtable-event-store.ts)
- Low coverage: packages/library/src/internal/bigtable-persist-event.ts (packages/library/src/internal/bigtable-persist-event.ts)
- Low coverage: packages/library/src/internal/spanner-aggregate-key.ts (packages/library/src/internal/spanner-aggregate-key.ts)
- Low coverage: packages/library/src/internal/spanner-event-store-input-validation.ts (packages/library/src/internal/spanner-event-store-input-validation.ts)
- Low coverage: packages/library/src/internal/spanner-event-store.ts (packages/library/src/internal/spanner-event-store.ts)
- Low coverage: packages/library/src/internal/spanner-get-events.ts (packages/library/src/internal/spanner-get-events.ts)
- Low coverage: packages/library/src/internal/spanner-get-latest-snapshot.ts (packages/library/src/internal/spanner-get-latest-snapshot.ts)
- Low coverage: packages/library/src/internal/spanner-migration-plan.ts (packages/library/src/internal/spanner-migration-plan.ts)
- Low coverage: packages/library/src/internal/spanner-migration-read.ts (packages/library/src/internal/spanner-migration-read.ts)
- Low coverage: packages/library/src/internal/spanner-migration-write.ts (packages/library/src/internal/spanner-migration-write.ts)
- Low coverage: packages/library/src/internal/spanner-migration.ts (packages/library/src/internal/spanner-migration.ts)
- Low coverage: packages/library/src/internal/spanner-persist-event.ts (packages/library/src/internal/spanner-persist-event.ts)
- Low coverage: packages/library/src/internal/spanner-read-write-transaction.ts (packages/library/src/internal/spanner-read-write-transaction.ts)
- …and 30 more
Changes since last survey
- 34 commits — 34 feature/other, 0 fixes
By area
- (root) — 23 commits
- packages/library — 10 commits
- .github/workflows — 1 commit
Notable commits
- change: Disable Renovate bot by setting enabled to false
- change: [skip ci] version up to 5.1.1-snapshot.0
- change: [skip ci] version up to 5.1.2-snapshot.0
- change: [skip ci] version up to 5.2.1-snapshot.0
- change: chore(deps): Update dependency @aws-sdk/client-dynamodb to v3.1155.0 (#1093)
- change: chore(deps): Update dependency @aws-sdk/client-dynamodb to v3.1156.0 (#1094)
- change: chore(deps): Update dependency @aws-sdk/client-dynamodb to v3.1157.0 (#1106)
- change: chore(deps): Update dependency @aws-sdk/client-dynamodb to v3.1158.0 (#1110)
- change: chore(deps): Update dependency @aws-sdk/client-dynamodb to v3.1159.0 (#1111)
- change: chore(deps): Update dependency @aws-sdk/client-dynamodb to v3.1160.0 (#1114)
- change: chore(deps): Update dependency @aws-sdk/client-dynamodb to v3.1161.0 (#1115)
- change: chore(deps): Update dependency @aws-sdk/client-dynamodb to v3.1162.0 (#1121)
- change: chore(deps): Update dependency @aws-sdk/client-dynamodb to v3.1163.0 (#1123)
- change: chore(deps): Update dependency @biomejs/biome to v2.6.0 (#1091)
- change: chore(deps): Update dependency @biomejs/biome to v2.6.3 (#1098)
- change: chore(deps): Update dependency @biomejs/biome to v2.6.4 (#1112)
- change: chore(deps): Update dependency @biomejs/biome to v2.6.5 (#1120)
- change: chore(deps): Update dependency @google-cloud/bigtable to v7.5.1 (#1113)
- change: chore(deps): Update dependency npm:@fission-ai/openspec to v1.15.0 (#1097)
- change: chore(deps): Update dependency npm:@fission-ai/openspec to v1.16.0 (#1116)
- …and 14 more
Architecture
- Containers 0 added · 0 removed · contexts 1 added · 0 removed · edges 0 added · 0 removed
Added bounded contexts (1)
- python
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
j5ik2o/event-store-adapter-js was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 9 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit cf793e8d5431a30aaf2026277faa0a1027cf5b0e — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-bb0cb800cd0f.