Release Notes: v0.10.0¶

Release Date: 2026-07-27

Summary¶

This release adds the OmniDevX Kiro CLI collector, bringing AWS Kiro local developer telemetry into the OmniDevX event model. The collector reads Kiro's local SQLite database and optional ~/.kiro_sessions archives, then emits canonical session, usage, and tool events for reporting through omnidevx-core.

Highlights¶

Kiro CLI historical collector for OmniDevX.
Local SQLite support via the pure-Go modernc.org/sqlite driver.
Optional support for kiro-usage-style archived snapshots.
Estimated token usage with explicit reduced-confidence provenance.
Documentation for Kiro local store behavior, format drift, and usage.

What's New¶

Features¶

OmniDevX Kiro CLI Collector¶

The new omnidevx package implements the omnidevx-core.Collector interface for AWS Kiro CLI local usage:

import (
    kiro "github.com/plexusone/omni-aws/omnidevx"
    core "github.com/plexusone/omnidevx-core"
)

collector, err := kiro.New(kiro.Config{
    DBPath:      "", // default OS-specific Kiro CLI database
    SessionsDir: "", // default ~/.kiro_sessions
})
result, err := collector.Collect(ctx, core.CollectRequest{
    Period:  core.Period{Start: weekStart, End: weekEnd},
    Subject: core.SubjectRef{PersonID: "person:jane"},
})

The collector emits:

ai.session.started / ai.session.ended
ai.usage.recorded
ai.tool.completed

Local Store Support¶

Kiro CLI history is read from:

macOS: ~/Library/Application Support/kiro-cli/data.sqlite3
Linux: ~/.local/share/kiro-cli/data.sqlite3
Optional archive snapshots: ~/.kiro_sessions/*.json

The collector handles both conversations_v2 and conversations table shapes, along with metadata-rich turns and user/assistant/tool object pairs.

Historical Estimation¶

Kiro local records do not always expose exact token accounting. When exact request metadata is unavailable, token usage is estimated from local conversation history using a configurable characters-per-token ratio. Estimated usage events include token_estimation_method=chars_per_token and carry reduced history-mode confidence.

Documentation¶

Documentation now includes:

Kiro CLI collector setup and usage.
OS-specific local data paths.
Archive snapshot support.
Format-stability notes for Kiro's internal local records.
Event mapping details and estimation caveats.

See docs/omnidevx/index.md for complete documentation.

Installation¶

go get github.com/plexusone/omni-aws@v0.10.0

Migration Guide¶

From v0.9.0¶

No breaking changes. This is a purely additive release introducing the OmniDevX Kiro CLI collector.

To use the collector:

Add the package:

import kiro "github.com/plexusone/omni-aws/omnidevx"

Create a collector:

collector, err := kiro.New(kiro.Config{})

Persist events through omnidevx-core/store if desired:

st, err := store.Open(store.Options{})
result, err := collector.Collect(ctx, core.CollectRequest{})
written, err := st.Write(ctx, result.Events)

Full Changelog¶

See CHANGELOG.md for the complete list of changes.