Changelog¶
All notable changes to Infinity-Context (icx) are documented in this file.
The format is based on Keep a Changelog, this project adheres to Semantic Versioning, and is distributed under the GNU General Public License v3.0 or later (GPL-3.0-or-later) (LICENSE).
[Unreleased]¶
Documentation¶
- Documentation site built with Zensical and published to GitHub Pages
(https://doublegate.github.io/Infinity-Context/):
zensical.toml,scripts/build_docs_site.py(stagesdocs/and the root pages, points links that leave the site at GitHub, builds the navigation) and.github/workflows/docs.yml(strict build on pull requests, deploy frommain; Zensical pinned, actions pinned by SHA). - ADR-0007 (proposed): opt-in memory-mapped seqlock bus (
icx-shm), tracked in #32. - Markdown lint: blank-line fixes across non-frozen documents.
Changed¶
- Version-numbered file names replaced with descriptive ones, so names stay valid for every
release: the 42
*_v1NN.rs/redact_issue24.rsintegration tests (for exampleredact_v120.rs->redact_regression_fixtures.rs,redact_v110.rs->redact_recall_and_losslessness.rs,window_eviction_v121.rs->window_eviction_accounting.rs; the version a test was added in stays in its doc comment), theredact-*-v120.binfuzz fixtures, the property-test regression file, andto-dos/v1.2.0-remediation.md->to-dos/codex-audit-remediation.md. ADRs, frozen audits, release notes, the AHTL v1 format andref-docs/keep their names. The gitleaks path allowlist names the same two fixture files under both names, since history keeps the old paths. .gitignore:archive/folders (local archives, never committed) and the docs-site build output (.site-src/,site/).
Tests¶
- Regression tests for multi-word and multi-line values under sensitive JSON keys.
[1.3.1] - 2026-11-22¶
Fixes #28, #29 and #30. Release notes:
docs/releases/v1.3.1/.
Highlights¶
v1.3.1 hides a value after a sensitive key from its first quote to the end of the line, so secrets
inside code (env::var("K").unwrap_or("..."), x or "...", template and prefixed literals) no
longer stay visible in icx's stored copy (#29). A call head such as env::var( stays visible;
later text on the line is hidden with the value. Complete JSON lines, such as minified API output,
are parsed instead, so only the sensitive values are hidden. It also rejects CLI
flags with a missing or flag-shaped value (#28), and aligns hook fail-open replies with each
adapter's own no-op (#30). Details: v1.3.1 release notes.
Changed¶
- Redaction (#29): after a sensitive key, a value that holds any quote is hidden from its first
quote to the end of the line, as one marker. A call head right before that quote stays visible
(
password = env::var([REDACTED:ENV_SECRET]); any other value is hidden from its start, since a bare head could itself be the secret (hunter2 "note"). There is deliberately no quote pairing, no field boundary and no key detection: each was bypassed in review (a stray quote shifted the pairing; redacted key names hid later sensitive keys). So later text on the same line is hidden with the value, JSON keys and later CLI flags included. Pinned by a corpus of every reported shape and a property test over random code shapes. - Redaction (#29): after a sensitive key, no exemption (null default, type annotation, code expression, token counter) applies when a quote follows on the line.
- Redaction (#29): a line that is one complete JSON object or array, such as minified API
output, is redacted structurally by a strict RFC 8259 scanner. The value of a sensitive key, of
any type, becomes
"[REDACTED:CONFIG_SECRET]". Every other string is redacted on its own, with its key as context. Formatting and key order are kept, and the edited line must still parse. Anything that is not valid JSON, or nests deeper than 128 levels, keeps the first-quote rule. String values are decoded before redaction (UTF-16 surrogate pairs included), so escaped newlines and\uXXXXescapes cannot hide a key; embedded JSON and digest lines inside a string keep their own context, and a line with a complete inline key block stays on the JSON path. - Redaction (#29): a backtick inside a type annotation, or a quote in a YAML block header's
comment (
password: | # "..."), is hidden too. A 7 KB minified API list with"token"first now keeps over 99% of its text instead of 0.5%.
Fixed¶
- CLI (#28): every value-taking flag (
--dir,--lines,--idle-exit,--max-requests,--listen,--provider,--upstream,--profile,--context-tokens, ...) rejects a missing, flag-shaped (--dir --raw,-h) or blank value instead of taking the next flag or falling back to a default.icx hookstill fails open. - Hook fail-open replies (#30) come from one function in
icx-adapters. They have the shape of each adapter's own no-op, pinned by a test againstAntigravityAdapter: agy unknown events return{}, and agy Subagent events returninjectStepswithoutterminationBehavior. Hermes gets{}. Blank--agent/--eventvalues are rejected. - Muse (#30): a Bash result with an empty
outputfalls back tostdout/stderr.
Documentation¶
- Muse loads MCP servers only in a trusted workspace; hooks run either way (deployment guide §2.6, adapter spec §6).
- README reworked as a user-facing landing page: a Getting Started section (verified release-binary install, per-agent setup links, first steps), a CLI Usage section, ADR-0006, the v1.2.0 audit and release notes in the documentation lists, and badges grouped in a titled table by topic. The per-release "What Changed" summaries and the phase-by-phase roadmap history moved into this changelog as "Highlights" under each version.
.gitignore: an in-repo workspace store (icx.sqlite3and its WAL/SHM files),install.key, and local agent and environment files.- Release notes state that stored content is not re-checked after an upgrade.
Build¶
- The Antigravity PR review pins
AGY_PRINT_TIMEOUTto 15 minutes (a 79 KB diff timed out at the scaled 367 s);.gitignorealready excludes Playwright MCP output (.playwright-mcp/).
[1.3.0] - 2026-11-21¶
Adds Meta Muse Code as a fifth agent. Release notes:
docs/releases/v1.3.0/.
Highlights¶
v1.3.0 adds Meta Muse Code as a fifth agent (icx hook --agent muse). The adapter follows the
hook contract observed on Muse 1.4.25: session start and each prompt receive icx's tail slot and
recall, and every tool output is captured for recall and deref. Muse does not let hooks replace
tool output, so icx does not shrink output inside Muse; its value there is the shared working
context across agents. It also hides more quoted text inside function calls under secret-looking
keys and rejects --dir without a folder. Upgrade every agent to v1.3.0 before wiring Muse. Details:
v1.3.0 release notes, setup in the
deployment guide §2.6.
Added¶
- Meta Muse Code adapter (
icx hook --agent muse,AgentKind::Muse,MuseAdapter). Built from Muse Code 1.4.25's observed hook contract (probe hooks on a real session): Claude-Code-shaped payloads,additionalContexton SessionStart/UserPromptSubmit/PostToolUse,hookEventNamerequired inhookSpecificOutput. SessionStart and UserPromptSubmit return the tail slot and recall; PostToolUse/PostToolUseFailure capture the output (the Bash tool's JSON result is unwrapped to its text and exit code). Muse rejects replacing tool output, so icx stores and recalls Muse output but does not shrink it. Every other event gets{}; no reply has anull.icx doctordetects the Muse binary and settings. Setup: deployment guide §2.6. AgentKind::from_repris now the single decoder of the agent byte on the telemetry bus, and a test round-trips every variant, so a new agent cannot be decoded asGenericMcp(which would echo Muse's own events back to it as sibling activity).
Fixed¶
- Redaction: a value that starts with a call (dotted names allowed, e.g.
pydantic.SecretStr("..."),field(default="..."),unwrap_or(x, "...")) has every quoted literal in its argument list redacted, not only one directly after the first(; union type annotations (str | None = "...") keep their literal defaults redacted (review of #25). - CLI: a
--dirwith no value (trailing, followed by another flag, or empty) is rejected instead of falling back to the default workspace; everyicx hookfail-open path replies with the agent's own no-op for that event (agy:allowon PreToolUse,stopon Stop). - Muse adapter review (#27): only the Bash tool's JSON result is unwrapped (other tools' JSON text
is stored verbatim); subagent identity falls back to
child_session_id; a PostCompactcompact_summaryis stored. - Deployment guide (review of #26): the ai-memory MCP JSON example carries
--server-urland an expanded path; the agy wrapper requirement sits next to the globalhooks.jsonexample; the daemon save-failure text matches v1.2.2.
Known limitations¶
- Redaction of quoted secrets inside code-shaped values (chained calls, operator chains, template and prefixed literals, lambdas) is incomplete, as in v1.2.2; the redesign is tracked in #29.
Compatibility¶
AgentKindgains value 8 (muse). A v1.2.x binary cannot read a workspace in which a Muse event was recorded; upgrade every agent before wiring Muse.
[1.2.2] - 2026-11-21¶
Supersedes v1.2.1, which was tagged but never published: a redactor panic was found after
tagging. v1.2.2 contains every v1.2.1 change below plus these fixes (issue #24).
Release notes: docs/releases/v1.2.2/.
Highlights¶
v1.2.2 is a follow-up to v1.2.0 and supersedes v1.2.1, which was tagged but not published
after a redactor crash was found (fixed here, with an exhaustive no-panic test). Commands and paths are now indexed by component, so searching
for seq 1 400 finds the output of Bash:seq 1 400; the index format is ICXHDC05 and existing
indexes are rebuilt on first load. Token counts (max_tokens: 4096) and code type annotations
(token: String) are no longer hidden as secrets. The daemon survives a transient save failure
without acknowledging it, and history eviction never empties the window when keeping some fits.
Details: v1.2.2 release notes.
Fixed¶
- Redactor panic (denial of service). A quoted literal inside a call that ended in a backslash
at the end of the input (
api_key = Some("abc\) stepped past the last byte and panicked, failing that hook and stopping the workspace daemon until the next hook restarted it. The escape skip is now bounded to the line, and an exhaustive test runs every combination of up to five risky fragments after four sensitive prefixes without a panic. - Literals inside nested call wrappers (
Some(String::from("...")),Box::new(Secret::new('...'))) are redacted. - Python
Optional[str],list[str]and Rust&'a mut Tannotations are recognised (they were over-redacted); a literal default after one (password: Optional[str] = "...") is still redacted, while= None/= Trueare not secrets. - Every subcommand rejects a repeated
--dirinstead of silently using the last one;icx hookstill fails open (prints{}). ICXHDC04tokens are now shape-validated likeICXHDC05ones before their postings are dropped.
[1.2.1] - 2026-11-21 (tagged, not published)¶
Follow-up to v1.2.0: the review suggestions left open on PR #22 and two regressions found by re-checking the real v1.1.0 workspaces on this release's own machine after the upgrade.
Fixed¶
- Recall of commands and paths. Lookup tokens joined by
:or/(Bash:seq,crates/icx-hdc) are now also indexed by component, so a query forseq 1 400ranks the command's own output first instead of documents that merely mention it. The snapshot format isICXHDC05; postings inICXHDC04snapshots (older tokenizer) are validated and dropped, and the MMU rebuilds them from the CAS event log on first load. v1.2.0 cannot readICXHDC05. - Token counts are no longer redacted.
max_tokens: 4096,"input_tokens": 1234,--max-tokens 2048,MAX_TOKENS=8192and other*_TOKENScounters lost their values to the v1.2.0 plural-key rule. Credentials under such keys are still caught by the value detectors;NPM_READ_TOKENand other non-counter keys keep the key rule. A numeric value (at most 10 digits) under any plural*_TOKENSkey (epoch_rollover_tokens: 16_384) is a counter too. Neither exemption applies to keys naming a credential (AUTH,ACCESS,SESSION,API, ...). - Type annotations are no longer redacted.
let token: String = ...,api_keys: HashMap<String, Key>,andpassword: &strare code, not credentials (an exact recognised type name ending the value; anything else keeps the key rule). Code bindings to a call or path expression (let q_tokens = Self::query_tokens(q)) are not env assignments; a literal assigned in code (let api_key = "...",token: String = "...") is still redacted. - Literals wrapped in a call are redacted.
api_key: Some("..."),String::from('...'): the value span used to stop at the opening quote and leave the literal visible (also in v1.2.0). - CSV digests after a closed bracket.
logs[1].txt,...,<sha256>keeps its public digest; only an unclosed[before the value marks a flow sequence. - Step eviction no longer empties history needlessly. When half the history allowance cannot be reached while keeping an epoch, a step evicts the fewest epochs that fit.
- Daemon:
- a failed dispatch is never saved, so the client's in-process retry is the only ingestion;
- a transient save failure is reported (never acknowledged) and the unsaved state is discarded, and the daemon keeps serving, exiting only after 5 consecutive save failures;
- bytes after the request line are rejected as a protocol error (one request per connection).
icx context-budgetrejects a repeated option and names the flag in number errors.- The vocabulary cap admits an entry's tokens in first-occurrence order rather than lexicographic order, and a stored subject cut at 64 KiB no longer indexes a token fragment.
- The release-gate self-test uses the system temp directory instead of
/tmp/Infinity-Context.
Checked¶
- Re-scanning all 2,092 artifacts stored by the v1.1.0/v1.2.0 install on the release machine with
the v1.2.1 rules left 14 lines that would gain a marker: all are synthetic test fixtures, review
quotes or the
16_384literal now exempted. No stored credential was found.
Verified, no change¶
AssembledWindow::total_cached_prefix_byteswith an empty pinned head matches the rendered prefix (regression test added).- YAML
''escapes inside flow sequences and block scalars under sequence entries were already handled (regression tests added).
[1.2.0] - 2026-11-21¶
Remediation and bounded-context release candidate for the independent audit in docs/codex/.
Qualification results and remaining release decisions are tracked in
docs/releases/v1.2.0/.
Highlights¶
v1.2.0 remediates the independent audit of v1.1.0 in docs/codex/
(findings ICX-CODEX-001 .. ICX-CODEX-102) plus the defects found in its pre-release review.
Measured results, compatibility and open items are in the
v1.2.0 release notes; current contracts are defined by
ADR 0006.
- Bounded context: the icx-managed window now has a total budget (
icx context-budget). At saturation old history is evicted in large steps behind one stableICX:HISTORY_OMITTEDframe, so the prompt prefix stays byte-stable between steps; omitted history stays dereferenceable. - Recall: exact lexical postings back the HDC/fractal recall, ranked by inverse document frequency, so a unique identifier is never filtered out and outranks common words.
- Redaction: YAML block, multi-line and flow-sequence secrets are hidden, redaction is idempotent, and public digests (checksums, commit ids) are no longer over-redacted.
- Durability: the daemon replies only after the store save succeeds, survives lock contention, and no longer holds the workspace lock while reading a request.
- Integrations: strict MCP request validation; Codex hook replies carry no unsupported output field and no JSON nulls.
- Releases: binaries are built by CI from the tag for static musl and glibc 2.35+, with
SHA256SUMS, build provenance and third-party notices. - Upgrade: v1.2.0 rebuilds workspaces into the ICXHDC04 snapshot format on first use.
v1.1.0 cannot read an upgraded workspace (it fails closed and loses nothing), so upgrade the
single
icxbinary used by all agents and keep a backup if you may downgrade. SeeUPGRADING.md.
Migration¶
- HDC derived snapshots now use
ICXHDC04with exact token postings. Version 03 remains readable and the MMU rebuilds it from preserved CAS events. Older binaries cannot read 04: retain a pre-upgrade workspace backup for downgrade. CAS identities and unversioned Q15fcwords do not change; incorrect Q1.14 wire labels are superseded by ADR 0006. - icx-managed context now defaults to a bounded 32,768-unit policy, reserving 4,096 units each for
external input/tool schemas and completion.
icx context-budgetinspects/sets the persisted policy. The estimator is a conservative one-UTF8-byte allowance, not a provider tokenizer; callers must account for their actual external prompt. Model changes can invalidate prefixes. - MCP requires valid JSON-RPC envelopes, typed arguments, an explicit operation and the canonical
advertised tool name
icx. Invalid aliases/arguments now return errors rather than status or accidental mutations. Native-hook alias recognition is unchanged.
Fixed¶
- YAML sensitive scalars are redacted across literal/folded blocks and indented plain-value
continuations, including
=-containing values, tagged/anchored headers and list mappings. Public fields after dedent remain intact. Redaction uses normalized continuation classification so the audit's vendor-token/idempotence counterexamples stabilize on the first pass (ICX-CODEX-001, ICX-CODEX-006). Existing stored artifacts are not rewritten. - Public Profile A skeleton rendering neutralizes raw packet/header delimiters as ASCII bracket pairs; standalone parsing rejects unescaped nested markers (ICX-CODEX-002). Existing ordinary skeletons and percent literals retain their interpretation. Exact CAS content is unchanged.
- Exact token postings prevent approximate candidate rejection of stored unique identifiers, including multilingual identifiers. Lexical match coverage ranks ahead of HDC/fractal ties; common-token queries can require exhaustive refinement (ICX-CODEX-004).
- Snapshot loads reject nonfinite/out-of-range numerical state and inconsistent cached summaries, bundler readouts and 04 posting/Bloom metadata (ICX-CODEX-003).
- Bus readers reject coherent slots whose sequence differs from the expected ring position; extreme public chunker sizes no longer overflow arithmetic (ICX-CODEX-032/033).
- Daemon success replies follow persistence under the workspace lock; save failure returns an error and nonzero daemon result. SQLite WAL uses FULL commit synchronization (ICX-CODEX-030).
- Codex PostToolUse captures eligible output without emitting the unsupported replacement field. Supported prompt/start recall remains; replacement capability is explicitly false (035).
- Window assembly selects fitting whole recent frames without deleting cold history. Structured recall preserves useful handles and leaves unsent sibling-bus events queued (101).
- Release packaging requires successful trusted CI and REUSE evidence for the exact tagged commit, and rechecks before external writes. Missing, partial, failed or expired evidence blocks release; a partial failed-job rerun may require a complete workflow rerun (070).
- Benchmarks measure 1k and 10k scans independently and preserve strict timing-gate failures; numerical, corruption, protocol and mutation regressions strengthen assertion coverage (072/073). Current specifications supersede historical capability guarantees, and the worked U+28C7 example now displays the matching Braille glyph (005/100/102).
Release-review fixes (independent review of the candidate before submission):
- Redaction: a line ending in a sensitive YAML block header (
password: |) no longer exempts earlier assignments on the same line ({api_key: x, password: |leakedx). Multi-line plain scalars whose continuation lines are less indented than the first, multi-line single- and double-quoted scalars, and flow-sequence values (password: [x]) are now hidden. Plural collection keys (api_keys,tokens,DB_PASSWORDS) are sensitive;max_passes,bypassandaddressesare not. - Context window: once the budget is reached, history is evicted in large steps (down to half
the history allowance) behind one stable
ICX:HISTORY_OMITTEDmarker frame, instead of one epoch per turn. Consecutive windows now share their prefix between eviction steps (0.94 byte reuse at saturation in the 8,192-unit test, previously 0.01); omitted epochs stay dereferenceable through the handles in the marker. The eviction point persists with the controller state. - Lexical index: tokens longer than 256 bytes are not posted, so a long hex/minified run can no longer make the persisted ICXHDC04 snapshot undecodable; stored subjects are capped at 64 KiB. Ranking weights matched query tokens by inverse document frequency, so a rare exact identifier outranks stop-word matches, and very common tokens no longer pull the whole corpus into exact scoring (the candidate set is bounded). Snapshot format and version are unchanged.
- Bus:
poll_since_with_lossderives loss from the same head observation as the delivered events, so concurrent publishers can no longer make it under-report overwritten events. - Redaction no longer hides public digests. The v1.1.0 rule is unchanged (a high-entropy hex
run of 32+ characters on a line containing
=or:is redacted) except for 40-, 64- and 128-character digests in recognised contexts:sha1:/sha256:/sha384:/sha512:/blake3:labels,sha256sumlines,commit <hex>lines, CSV fields and Markdown table cells. Stored output can therefore still be checked againstSHA256SUMS. Sensitive key names are unaffected. - YAML/JSON comment and key-separator detection ignores
#and:inside quoted values, so a colon inside an open quoted secret no longer leaves its continuation lines unredacted and a#inside a closed quoted value no longer redacts the following public lines; single-quoted values honour the''escape. - A
]inside a quoted element of a sensitive flow sequence (password: ["a]b", "c"]) no longer ends redaction early. - Text after the closing quote of a multi-line quoted secret is classified like any other line, so a key block or a new block/quoted secret opened there is still hidden.
- The CSV-cell digest exemption no longer applies to quoted elements or flow sequences
(
keys: ["a", "<hex>", "b"]keeps the strict hex rule). icx context-budget --help/-hprint usage instead of a missing-value error.- The
ICX:HISTORY_OMITTEDframe uses the same⟪…⟫delimiters as the other icx markers. - Tests write to a per-user directory under the system temp dir instead of the fixed
/tmp/Infinity-Context/v120, which could collide between users. - Daemon: a workspace-lock timeout or reload failure now fails only that request (the client
falls back to in-process handling) instead of stopping the daemon. The request is read and
parsed before the lock is taken, under one 10 s deadline for the whole read, so a slow or
silent client can no longer hold the workspace lock and starve hooks and
mcp-serve. - Codex hook replies omit null members (
"reason": null,"systemMessage": null); Codex CLI 0.171 marked hooks returning them as failed. - The CLI integration test now runs
icx status/derefagainst a private temporary state directory instead of the invoking user's default workspace. - Exact parallel HDC scan:
icx_hdc::hv::hamming_distances,nearestandpar_map_orderedsplit inputs of at least 2,048 vectors across up to 8 scoped threads (nounsafe; results identical to a sequential pass, ties to the lowest index). Recall scores large candidate sets with it. Theicx benchmark10k gate now measures this scan against a measured 2,000 µs ceiling (slowest of 10 quiet-host runs, 1,354 µs, times 1.5); the single-threaded 10k figure is still reported, ungated. The previous 1,500 µs ceiling was an unmeasured extrapolation of the cache-resident 1k gate, and the 12.8 MB single-threaded scan is memory-bandwidth bound.
Added¶
-
icx benchmark --jsonemits measured component values, build flags, target, CPU, fixture hash and gate outcomes.scripts/benchmark_series.pyrecords independent processes, warm-up exclusion and dispersion; measurements are not end-to-end hook/model guarantees. -
Release workflow (
.github/workflows/release.yml): a version-tag push builds Linux x86-64 binaries (baseline and x86-64-v3) as static musl and as glibc 2.35+ builds, writesSHA256SUMS, attests build provenance and attaches them to a draft GitHub release whose notes are the tag's CHANGELOG section. The tagged commit must be onmain. - Release archives include
THIRD-PARTY-NOTICES.txt(generated bycargo-about) with the license texts of the statically linked crates, plus musl's notice in the musl builds; the file is also attached to each release on its own.
Removed¶
- The Unicode and ISO/IEC JTC 1/SC 2/WG 2 publications in
ref-docs/unicode-braille-patterns/(the U+2800 code chart, the Unicode 5.2.0 chapter 15 extract, WG2 N1203/N1279/N1303/N1353/N1453/N1603/N1703/N1770 and UTC 1996-002/027.2) are no longer redistributed: their Unicode-3.0 annotation covers Unicode data files, not these documents (ICX-CODEX-071).SOURCES.mdthere lists each document with its official source (byte-identical copies verified for three) and the SHA-256 of the copy previously distributed; the Unicode Character Database files remain. Git history is unchanged. - Raw audit/qualification logs and mutation inventories (42 files, 42.4 MB) moved out of the
repository into the
icx-v1.2.0-raw-evidence.tar.gzrelease asset, indexed with checksums indocs/releases/v1.2.0/RAW-EVIDENCE.md. Summaries, triage and all referenced evidence remain.
[1.1.0] - 2026-11-20¶
Remediation release for the adversarial audit of v1.0.0 in docs/claude/.
Finding IDs (ICX-AUD-NNN) refer to that audit; per-finding status is in
docs/claude/12-v1.1.0-remediation-status.md.
Highlights¶
v1.1.0 is a remediation release that follows an internal audit of v1.0.0 (findings ICX-AUD-001 through ICX-AUD-055, in docs/claude/). Workspaces now default to a private per-project directory under $XDG_STATE_HOME/icx/workspaces/ and are stored in a single owner-sealed SQLite file. A repository-local .icx/ from v1.0.x is no longer loaded implicitly and must be adopted with icx trust. Hook cost no longer grows with workspace size: on a 338-artifact workspace an in-process hook fell from 940 ms to 14 ms, and with the new resident icx daemon the median on a workspace of about 2,000 artifacts is 3.1 ms. The proxy now requires a per-install token. Hook outputs were aligned with the current Claude Code, Codex, Antigravity (agy) and MCP contracts. The cache figure was renamed to what it measures, a byte-weighted prefix-reuse proxy. The bus reports dropped publishes instead of reporting success. Ten arXiv PDFs that may not be redistributed were removed. The full list follows below; corrections to the research corpus are in ref-docs/corrections-2026-11-18.md.
Migration¶
- Workspaces now live under
$XDG_STATE_HOME/icx/workspaces/<project-hash>/in a singleicx.sqlite3. A repository-local.icx/is ignored with a warning; adopt one you own withicx trust --dir <path>. v1.0.x JSON stores are migrated on first load without deleting them. icx proxyrequires the install token: use the base URL it prints (http://127.0.0.1:49380/t/<token>) or sendx-icx-token. Non-loopback binds need--allow-remote.icx derefframes output as untrusted data by default; use--rawfor exact bytes.
Security¶
- Repository-shipped
.icx/workspaces are no longer loaded into agent context; workspaces are owner-checked, 0700/0600, sealed with a per-install key and MAC-verified (ICX-AUD-010, -013). - The proxy authenticates clients and binds loopback only by default. The curl header files that
carry upstream API keys are written to the private runtime directory (
$XDG_RUNTIME_DIR/icx) and stale ones are swept on start (ICX-AUD-012, -020). - icx structural markers anywhere in untrusted input, including the latest message, are escaped
unless they are byte-identical to a block icx emitted; deref output carries a
trust=untrusted_dataprovenance header (ICX-AUD-011). - Bounded hook stdin, MCP lines (4 MiB, oversized lines drained without buffering) and fold depth (64) (ICX-AUD-014).
- Only structural tool-call/-result blocks for the icx pager are exempt from marker
neutralization; tool output that merely contains
"name": "icx"is not. - Reopening a store resets widened
icx.sqlite3,-waland-shmmodes to0600. install.keyis checked (regular file, owner, mode) before it is read, so a FIFO is refused instead of blocking; only a missing key is created.icx encode-ahtlrefuses an untrusted workspace instead of printing a handle it never stored.icx trustadopts a store's content but not its emitted-block digests, so a planted digest cannot exempt forged markers from escaping. MCPgrepresults carry the sametrust=untrusted_dataprovenance header asderefandslice.icx mcp-serveandicx proxyre-verify the workspace per request, so a latericx trusttakes effect and a workspace whose ownership, mode or seal changed is no longer used.- Proxy curl header files go to a directory verified to be ours and private
(
$XDG_RUNTIME_DIR/icx, else<tmp>/icx-<uid>) and stale ones are swept every minute. - Redactor: URL userinfo passwords for every scheme, SendGrid, Slack app/webhook, GitLab,
DigitalOcean, Shopify and Twilio formats, more key names, multi-line values, single-line PEM,
and bounded unterminated key blocks (ICX-AUD-015, -016). A key with no inline value redacts
only a following scalar line: nested mappings, comments and prose ending in
key:are kept. Token-only URL userinfo (https://<token>@host, 16+ mixed or 32+ token characters) is redacted. A quoted continuation value is treated as a nested key only if its closing quote precedes the separator. Private-key banners are matched within one-----BEGIN ...-----banner, and text around a key block is kept. - agy
transcriptPathopens non-blocking without following symlinks; the bus file refuses symlinks, foreign owners and permissive modes (ICX-AUD-018, -019). - Hooks never echo input fields back as decisions (Claude Code, Codex and agy PreToolUse; agy PostInvocation) and never force an agent to continue (agy Stop) (ICX-AUD-007, -009).
Fixed¶
- Hook latency no longer grows with workspace size: SQLite store with append-only rows, persisted HDC index snapshot, and a bit-sliced bundler. 338 artifacts: 940 ms to 14 ms per hook in process; about 3 ms median through the resident daemon (ICX-AUD-001, -047, -050).
- Storage is lossless after redaction: CRLF, trailing newlines and literal delimiters survive; escaping applies only to model-facing views (ICX-AUD-021).
- 64-bit handle collisions are refused instead of overwriting, in both the CAS and the DAG, including Hermes carried-AHTL lines and subagent summaries (ICX-AUD-022, -023).
- The daemon flushes and releases the workspace lock at most 1 s after the first unsaved change even under continuous hook traffic. A failed flush keeps the unsaved state in memory, releases the lock and retries every second; after 5 consecutive failures it logs an error and drops the changes so the daemon can exit. Requests that never reach a handler (malformed, wrong protocol) do not trigger a save.
- Concurrent first use of the install key, and concurrent
prepareof one workspace, no longer collide on temp files or observe a directory before its seal is written. - A save refuses to seal a snapshot older than the store on disk (another writer committed since it was loaded). If the tables do not hold exactly the in-memory rows (rows removed or planted behind the process), they are rewritten from memory before sealing. A new workspace's unsaved state survives a first flush that failed after creating the store file. The daemon logs an error when another writer's newer store replaces its unsaved changes.
- Emitted-block digests are stored in an append-only, seal-covered table instead of being rewritten inside the state blob on every save.
- Epoch headers are hex everywhere and epoch ids are u32 (ICX-AUD-024); invalid
slice_hintvalues are neither rendered nor parsed (ICX-AUD-025); clause chains are parsed iteratively and capped at 64 links (ICX-AUD-026). - Associative recall of a unique token in 1,000 log documents: top-1 5.1% to 99.0%, top-5 5.6% to 99.7% (ICX-AUD-049); one hit per artifact (ICX-AUD-042).
- Claude Code: shape-preserving
updatedToolOutput, plain-text PreCompact instructions,last_assistant_messageon SubagentStop, and no model-facing output on PostCompact or SubagentStop (ICX-AUD-004). Codex: no duplicatedadditionalContext(ICX-AUD-005). - Anthropic proxy placement: client breakpoints are preserved, icx's breakpoint goes on a content block, at most 4 in total, and 1h TTLs are inherited (ICX-AUD-003).
- The bus reports dropped publishes and reader loss instead of returning success (ICX-AUD-054).
- FastCDC uses spread masks (mean chunk 13.2 KiB to 10.6 KiB at an 8 KiB target) (ICX-AUD-027).
Added¶
icx daemon(resident workspace over a private Unix socket),icx trust,ICX_NO_DAEMON,ICX_DAEMON_AUTOSTART,ICX_STATE_HOMEandICX_CONFIG_HOME.- MCP dual-era support:
initializenegotiation for 2024-11-05 through 2025-11-25, plusserver/discoverand per-request versions for 2026-07-28 (ICX-AUD-008). - Optional wall-clock event times, enabled for CLI workspaces (ICX-AUD-048).
SeqlockTelemetryBus::dropped_publishesandpoll_since_with_loss(ICX-AUD-054).WireProxyTransformer::serve_http_listener_gatedwith a per-requestWorkspaceGate.- proptest invariants for the codec, cargo-fuzz targets (
fuzz/), and a cargo-deny gate (ICX-AUD-039, -040).
Changed¶
- The benchmark's cache line is a byte-weighted prefix-reuse proxy over all turns, seal turns included (95.46% on the synthetic transcript), gated at 90%. Compression and CAS fixtures are labelled and the CAS fixture is no longer a single chunk (ICX-AUD-002, -027, -028).
- CI actions are pinned to commit SHAs; the toolchain is pinned to 1.100.0 (ICX-AUD-040).
icx-proxyandicx-adaptersdeclareGPL-3.0-or-later AND AGPL-3.0-or-later, matching REUSE; LICENSING.md's description of GPL section 13 is corrected (ICX-AUD-034).- Specifications, threat model, deployment guide, README and the AHTL PDF volume describe v1.1.0
behaviour; canonical figures are in
docs/numbers.md(ICX-AUD-017, -030, -031, -046, -051).
Removed¶
- 10 arXiv PDFs whose license does not permit redistribution; INDEX.md links to arXiv (ICX-AUD-036).
- Unused proxy dependencies
icx-codecandserde(ICX-AUD-041);icx-clidepends onserdeandrustixonly on Unix. - Personal paths and an agent conversation id from tracked files (ICX-AUD-038).
Known limitations¶
- Fractal suffix depth is still inferred from distance and can report false positives (ICX-AUD-052).
- Codex does not yet apply
updatedMCPToolOutput; under Codex icx indexes output but does not shrink it. The Codex rollout tailer does not read.jsonl.zstfiles and is not wired into the CLI (ICX-AUD-005). - No Hermes Python shim ships with icx (ICX-AUD-006).
- The rest of the derived state (DAG, epochs, HDC event log, graph) is still rewritten in full on each save, so flush cost grows with history. The daemon flushes after any dispatched request, including hooks that change nothing.
- Licensing and patent governance text (PATENTS.md, CLA.md, COMMERCIAL.md) is unchanged by owner decision (ICX-AUD-035).
[1.0.0] - 2026-11-18¶
Highlights¶
Phase 5: Long-Horizon Verification, 9-SLO Benchmark Suite, AHTL Exactness Closure & Production Release (Overview (Sprints 5.1–5.2)).
500-turn (> 8.4 MB / > 2.1M raw tokens) Needle-in-a-Haystack / OOLONG & prefix-cache simulator with passkey recall, 4-agent shared-file bus verification across Claude Code, Antigravity CLI, Codex, and Hermes, full 256-bit Blake3Digest collision guards in CasStore::put_bytes_checked, adaptive Stage-1 HdcAssociativeIndex candidate scaling ((entries.len() / 64).clamp(16, 512)), bijective AhtlClause key/value escaping, enhanced icx doctor [--dir <PATH>] (verify_all_integrity + verify_all_merkle_integrity_with_cas), and 9-SLO icx benchmark scorecard.
Added¶
- Phase 5 Sprint 2 — Bijective
AhtlClauseEscaping, Enhancedicx doctorWorkspace Integrity Verifier, 9-SLOicx benchmarkSuite &v1.0.0Production Release (crates/icx-codec,crates/icx-core,crates/icx-adapters,crates/icx-cli,docs/,ref-docs/): - Added bijective
escape_clause_key(%->%25,:->%3A,⋮->%E2%8B%AE,⇒->%E2%87%92,↦->%E2%86%A6,⟦->%E2%9F%A6,⟧->%E2%9F%A7,\n->%0A,\r->%0D),escape_clause_val, andunescape_clause_fieldtoAhtlClause::renderandAhtlClause::parse(T-52-002) so programmaticAhtlClauseinstances round-trip losslessly regardless of embedded delimiter characters. - Upgraded
CasStore::put_bytes_checkedto precomputeVec<(ChunkLineSpan, ArtifactId, Blake3Digest)>in a single pass and verify both intra-batch andself.chunks64-bitcidcollisions before inserting chunks, and addedhas_indexed_occurrence_for,get_occurrence_record_for, and allocation-freeis_ppr_stop_wordinInfinityContextMmu. - Upgraded
icx doctor [--dir <PATH>](T-52-001,crates/icx-cli/src/main.rs) withPATH-aware binary discovery,/dev/shmwritability inspection, and full workspaceCasStore::verify_all_integrity()+MerkleContextDag::verify_all_merkle_integrity_with_cas(Some(&mmu.cas))cryptographic verification ([VERIFIED] Workspace Storage & Merkle-DAG). - Expanded
icx benchmark(T-52-001,crates/icx-cli/src/main.rs) to execute and report all 9 SLO rows fromdocs/performance.md§1 (10,240-bit HDC Bind + Permute,10,240-bit HDC Hamming Scan,Fractal IFS Suffix Match,Two-Stage HDC + CSR PPR,AHTL Compression Ratio,FastCDC + BLAKE3 CAS Ingest (64K),Atomic Seqlock Broadcast,Full Synchronous Hook Round-Trip, and50-Turn NIH + Cache-Epoch). - Synchronized
docs/ahtl/08-v1-reference-implementation-blueprint.md,docs/performance.md,docs/virtual-memory-and-dag-engine.md(§5 CAS availability/retention/backup policy),ref-docs/ahtl-exactness-review-and-analysis.md(§§2.5–2.6 all 7 minimum standardsENFORCEDinv1.0.0),docs/deployment-and-agent-integration-guide.md,README.md, andto-dos/ROADMAP.md(T-52-002). - Phase 5 Sprint 1 — 500-Turn (
> 2.1MToken) Needle-in-a-Haystack / OOLONG & Prefix-Cache Simulator, 4-Agent Shared-File/dev/shmTelepathy Verification & AHTL Exactness Hardening (crates/icx-core,crates/icx-hdc,crates/icx-adapters,crates/icx-proxy): - Added full 256-bit
Blake3Digestcollision verification on both top-level 64-bitArtifactIdandL0chunk hits inCasStore::put_bytes_checkedplus single-passCasStore::verify_all_integrity(T-51-001). - Upgraded
HdcAssociativeIndex::query_associativewith adaptive Stage-1 candidate scaling ((entries.len() / 64).clamp(16, 512)) so multi-thousand-artifact corpora maintain high Stage-1 recall (T-51-001). - Upgraded
InfinityContextMmuwith punctuation-stripped, stop-word-filtered PPR seed extraction inbuild_ephemeral_tail_slotand per-agent occurrence isolation (agent_occurrences,agent_reordered_occurrences,truncate_agent_suffix) so multi-agent proxy and Hermes sessions sharing oneInfinityContextMmunever clobber each other's positional occurrence caches (T-51-001,T-51-002). - Eliminated unnecessary textual response buffer cloning when no
⟪!icx:deref(...)⟫marker is present inWireProxyTransformer::relay_upstream_response_with_eof. - Implemented
sprint_5_1_500_turn_two_million_token_nih_oolong_and_prefix_cache_simulation(> 8.4 MB/> 2.1Mraw tokens across 500 turns,>= 94.0%prefix-cache hit ratio,< 32,768active window tokens, 100% passkey recall & byte-exact dereference at turns3,47,189,412) andsprint_5_1_four_agent_shared_shm_telepathy_and_sub_100us_propagation(ClaudeCode->Antigravity->Codex->Hermes->McpPagerServerover shared-file/dev/shmring in< 100 µs) incrates/icx-adapters/src/lib.rs(T-51-001,T-51-002).
[0.5.0] - 2026-11-18¶
Highlights¶
Phase 4: Cross-Agent Adapters, Polymorphic MCP Pager & Cache-Epoch Wire Proxy (Overview (Sprints 4.1–4.3)).
AgentHookAdapter trait, ClaudeCodeAdapter, CodexAdapter + bounded CodexRolloutTailer, AntigravityAdapter (exit 0, UI-silent systemMessage, 512 KiB tail-window transcriptPath fallback), HermesAdapter (ContextEngine & MemoryProvider v2 with tool_calls group preservation and occurrence-aligned ingest_or_reuse_at_index), < 180 token Single-Tool Polymorphic McpPagerServer (icx with ⟪ICX:PROVENANCE│...⟫ redaction honesty, 16-hex ambiguity recovery hints, and bidirectional xagent), WireProxyTransformer (Anthropic, OpenAI, Gemini, SSE ⟪!icx:deref(...)⟫ expansion, and safe TcpListener icx proxy), and the comprehensive Deployment & Agent Integration Guide.
Added¶
- Phase 4 Sprint 3 — Single-Tool Polymorphic
McpPagerServer(icx), Multi-Provider + SSEWireProxyTransformer, Local HTTP Proxy (icx proxy) &v1.0.0Deployment Guide (crates/icx-adapters,crates/icx-proxy,crates/icx-cli,docs/deployment-and-agent-integration-guide.md): - Expanded
McpPagerServer(T-43-001) withschema_token_estimate() < 180,"expand"operation alias,notifications/initializedandpingJSON-RPC methods,isErrorstatus flagging, structured 16-hex disambiguation guidance onIcxError::AmbiguousHandlePrefix, in-band⟪ICX:PROVENANCE│id=...│redacted=...│exactness=post_sanitization_cas⟫headers onderef/expand/slicewhenFLAG_IS_REDACTEDis set orprovenance: trueis requested, sanitizedfoldbranch labels/summaries withsync_global_dag_root(),id-scoped or globalredacted_artifactsreporting inop: "status", and bidirectionalop: "xagent"(publishing ontommu.buswhenqis non-empty, polling whenqis empty/omitted). - Expanded
WireProxyTransformer(T-43-002) withProviderFormat(Anthropic,OpenAI,Gemini), Anthropic content-block array virtualization (textandtool_resultblocks withicxpager exemption andcache_controlstripping),transform_gemini_request(contents[].parts[].text),expand_inline_deref_directives(⟪!icx:deref(#icx:<hex>)⟫and⟪!icx:deref(#icx:<hex>,start:end)⟫),transform_sse_chunk,transform_for_provider,handle_http_request, and safestd::net::TcpListenerserve_http_listener. - Expanded
icx-cliwith--agent hermesand--dir <PATH>onicx hook,--dir <PATH>onicx mcp-serveandicx status,--provider geminiand workspace persistence onicx proxy-transform, and theicx proxyHTTP/1.1 & SSE reverse-proxy subcommand. - Authored
docs/deployment-and-agent-integration-guide.md(1,279lines) covering standalone (Mode A) and dual-stack (Mode Bwithai-memory) architecture, setup/configuration for Claude Code, OpenAI Codex CLI, Google Antigravity CLI (agy), Hermes Agent, and MCP/ACP clients, prompt-cache coexistence, operational best practices, quantified pros/cons, and 4 end-to-end turn-by-turn use cases. - Phase 4 Sprint 2 — Google Antigravity CLI (
agy) Adapter & Hermes AgentContextEngine/MemoryProviderBridge (crates/icx-adapters,crates/icx-core): - Expanded
AntigravityAdapter(T-42-001) withPostInvocation(force_continue),PreToolUse(overwrite),PostToolUsenon-error filtering + bounded512 KiBtail-windowtranscriptPathJSONL fallback (read_transcript_step),conversationIdcorrelation tagging (attach_conversation_id), andStop#icx:<16-hex>sealed-epoch handle reporting while strictly enforcing process exit code0. - Expanded
HermesAdapter(T-42-002) to implement the full HermesContextEngineandMemoryProvider(PRE_COMPRESS_CHECKPOINT_API_VERSION = 2) contract:select_context,prune_tool_results_only,compress,on_turn_complete,on_pre_compress, andhandle_hook, withtool_callsgroup preservation acrossprotect_first_n/mid_slice/tail_slice, multimodal non-text archiving, and occurrence-alignedingest_or_reuse_at_index(MerkleContextDag::find_turn/find_turn_any_role). - Phase 4 Sprint 1 —
AgentHookAdapterTrait,ClaudeCodeAdapter,CodexAdapter&CodexRolloutTailer(crates/icx-adapters,crates/icx-core): - Implemented
AgentHookAdapterandAdapterError, clear-state functional supersession inInfinityContextMmu(("fail", "0")and("status", "PASS")inBiTemporalGraph), atomic workspace snapshot persistence (mmu_state.json,cas_store.json,bitemporal_graph.json,icx-fabric-v1.shm),ClaudeCodeAdapter(SessionStartICX:LEGEND,PreToolUse,PostToolUselines=1..<L>+updatedMCPToolOutput,SubagentStart/SubagentStop),CodexAdapter(strictadditionalProperties: falsewire schemas), and boundedCodexRolloutTailer(T-41-001,T-41-002).
[0.4.0] - 2026-11-17¶
Highlights¶
Phase 3: 10,240-Bit HDC, Contractive IFS Fractal Archive (FCGA), Titans-Inspired Surprise Gate & Bi-Temporal CSR Graph (PPR) (Overview (Sprints 3.1–3.3)).
10,240-bit Hypervector algebraic engine (BitXor/BitXorAssign, unbind, inverse_permute, from_seed_framed, bind_role_filler, encode_sequence, cosine_bipolar, sub_hypervector_64, dedup_fingerprint_u128), Infini-attention Delta-Rule HdcBundler with coordinate-parity tie-breaking and 128-bit deduplication, two-stage 16-byte EntrySummary L2-cache pre-screened HdcAssociativeIndex (AssociativeMemoryIndex), Contractive IFS FractalCoord (verified_suffix_depth, to_q1_14/from_q1_14, 64-bit Morton Z-order morton_z64, @o1:o2 octal quadrant addressing) and FractalTrajectoryArchive verified against Theorem 3.2 bounds (\(K \in 1..=32\)), TitansSurpriseGate (apply_idle_decay, observe_with_exit_code, Delta-Rule novelty gating), and BiTemporalGraph with automatic functional relation supersession, atomic JSON persistence, and CsrGraphSnapshot \(O(V + E)\) Personalized PageRank (PPR).
Added¶
- Phase 3 Sprint 3 — Bi-Temporal CSR Knowledge Graph (
CsrGraphSnapshot), Functional Contradiction Supersession & HippoRAG Personalized PageRank (crates/icx-store,crates/icx-adapters,crates/icx-cli): - Enhanced
BiTemporalGraph::upsert_edge(T-33-001) so any existing active edge (t_invalid.is_none()) sharing(source_entity, relation)on a functional relation (is_functional == true) is automatically superseded (t_invalid = Some(now_ms),t_tx_end = Some(now_ms)), guaranteeing at most one active edge per functional(source_entity, relation)pair across all timestamps. - Added
CsrGraphSnapshot(nodes,row_ptr,col_idx,weights,inv_out_weight,prov_row_ptr,prov_ids),BiTemporalGraph::build_csr, andCsrGraphSnapshot::run_ppr(T-33-002) executing HippoRAG Personalized PageRank (arXiv:2405.14831) power iteration over flat cache-contiguous Compressed Sparse Row (CSR) arrays with \(O(V + E)\) scalar dangling-node mass redistribution. - Added
BiTemporalGraph::{entity_count, edges, query_edges_to, query_relation, invalidate_edge, save_to_dir, load_from_dir}for incoming/relation time-travel queries, explicit invalidation, and atomic JSON persistence (bitemporal_graph.json). - Expanded
InfinityContextMmu::ingest_payloadfunctional-relation classification (status,test_status,return_type,fail,pass,exit_code) and added two-stageHdcAssociativeIndex+ CSRPersonalizedPageRanklatency verification toicx benchmark(crates/icx-cli/src/main.rs). - Phase 3 Sprint 2 — Contractive IFS
FractalTrajectoryArchive, Boundary-Aware Inverse-IFS Suffix Verification &TitansSurpriseGateMomentum Decay (crates/icx-hdc): - Expanded
FractalCoord(T-32-001) witheuclidean_distance(\(L_2\)), boundary-aware inverse-IFS suffix verification (verified_suffix_depth), signedQ1.14fixed-point quantization (to_q1_14/from_q1_14, scale \(2^{14} = 16,384\)), uniform half-open dyadic 64-bit Morton Z-order prefix codes (morton_z64),@o1:o2octal quadrant addressing (encode_octal_addr/decode_octal_addr), andFractalTrajectoryArchive(record_step,insert_coord,query_shared_suffix), verified against Theorem 3.2 contractive bounds (\(d_\infty \le 2^{1-K}\) and \(d_2 \le 4 d_\infty \le 2^{3-K}\)) across all \(K \in 1..=32\). - Expanded
TitansSurpriseGate(T-32-002) withRetentionTier::PinVerbatim,with_eta_and_alpha(withNaNsanitization),momentum(),eta(),alpha(),events_seen(),memory_trace(), uncapped exponential idle decayapply_idle_decay(steps)(\(S_t \leftarrow (1 - \alpha)^{\text{steps}} S_t\)),observe_with_exit_code, and Delta-Rule novelty gating (is_anomalywith \(\nu_t \ge 0.05\), or routine with \(\nu_t \ge 0.15\)) so repetitive boilerplate never saturates \(M_t\). - Integrated
FractalTrajectoryArchiveandobserve_event_with_exit_codeintoHdcAssociativeIndex. - Phase 3 Sprint 1 — 10,240-Bit HDC/HRR Algebraic Engine, Infini-Attention Delta Bundler & Two-Stage Associative Index (
crates/icx-hdc): - Expanded
Hypervector(T-31-001) withBitXor/BitXorAssign(^,^=),unbind,inverse_permute(\(\Pi_{-s} \Pi_s = I\)),from_seed_framed(4-byte little-endian length-framed domain/token hashing),bind_role_filler,encode_sequence,popcount,cosine_bipolar,sub_hypervector_64, and non-linear 128-bitdedup_fingerprint_u128. - Upgraded
HdcBundler(T-31-002) withBTreeSet<u128>non-linear fingerprint deduplication (recorded only after thesim < 0.85similarity gate accepts a vector),add_weighted_unique, deterministic coordinate-parity tie-breaking (((word_idx ^ bit) & 1) == 0),count(),reset(), andunbind_query(). - Defined
AssociativeMemoryIndexand upgradedHdcAssociativeIndex::query_associativewith a two-stage L2-cache pre-screening pipeline over 16-byteEntrySummaryrecords (hv_sub64,subj_bloom32,quadrant_u16,surprise_q8,flags).
[0.3.0] - 2026-11-17¶
Highlights¶
Phase 2: Alien Holographic Token Lattice (AHTL), Braille-256, Multi-Language Skeletonizers & 4-Tier Secret Redaction (Overview (Sprints 2.1–2.3)).
Dual-Profile AHTL v1.0 wire codec (Profile A AhtlWirePacketV1 & Profile B AhtlPacket, EpochHeader, AhtlStream, ContextCodec) with bijective %25/%23L escaping, Unicode Braille-256 (8-byte & 64-byte) bijection (byte_to_braille_utf8, braille_utf8_to_byte, ChannelBHologram), 1-Lipschitz 64-band HDC spectral folding (Hypervector::spectral_bands_64, from_u64_seed, hv_digest_u64, hamming_distance_simd), FractalCoord::encode_fc_hex64 / decode_fc_hex64, multi-language StructuralSkeletonizer (Rust, Python, TS/JS, Go, C/C++ + cargo test/clippy, pytest, tsc/vitest/jest, go test + unified git diff hunks), and 4-Tier SecretRedactor with Shannon entropy gating (\(H(S)\)) and FLAG_IS_REDACTED tagging, cross-referenced against docs/ahtl/AHTL_v1_Complete_Technical_Specification_Volume.pdf.
Added¶
- Phase 2 Sprint 3 — 4-Tier Pre-Ingestion
SecretRedactor, Shannon Character Entropy Gate,FLAG_IS_REDACTEDTagging & AHTL v1.0 Volume Cross-Verification (crates/icx-codec,crates/icx-adapters,crates/icx-hdc,docs/ahtl/): - Expanded
SecretRedactorinto a 4-tier defense-in-depth scrubbing pipeline (T-23-001):- Tier 0 — AHTL Structural Delimiter Neutralization:
SecretRedactor::escape_ahtl_delimitersescapes⟪-><<,⟫->>>,⟦->[[, and⟧->]]so untrusted payloads can never forgeAhtlPacket,AhtlWirePacketV1, orEpochHeaderboundaries. - Tier 1 — Multi-Line Cryptographic Block Removal: Stateful stripping of
-----BEGIN ... PRIVATE KEY-----PEM blocks (RSA,EC,OPENSSH,DSA,ENCRYPTED) and-----BEGIN PGP PRIVATE KEY BLOCK-----blocks. - Tier 2 — 28 Vendor Credential Prefixes, JWTs, Connection URLs, CLI Flags & Key-Value Assignments: Cursor-advancing token scanner for Anthropic (
sk-ant-*), OpenAI (sk-proj-*,sk-svcacct-*,sk-*), Stripe (sk_live_*,rk_live_*,sk_test_*,rk_test_*,whsec_*), GitHub (ghp_*,gho_*,ghu_*,ghs_*,ghr_*,github_pat_*), AWS (AKIA*,ASIA*), GCP (AIza*), Hugging Face (hf_*), NPM (npm_*), PyPI (pypi-*), Slack (xox[bparso]-*),ai-memory(aim_*), 3-segment Base64URL JWT tokens (eyJ...), database/broker connection URLs (postgres://,postgresql://,mysql://,mongodb://,mongodb+srv://,redis://,rediss://,amqp://,amqps://), CLI flags (--api-key=,--token=,--password=,--secret=, etc.),Authorization: Bearer/Basic, and single-line/multi-key.env, JSON, and YAML secret assignments (including backslash-escaped quotes\"). - Tier 3 — Shannon Character Entropy Gate (\(H(S)\)):
SecretRedactor::shannon_entropycomputes character Shannon entropy \(H(S) = -\sum P(c)\log_2 P(c)\) in bits/char and redacts unprefixed high-entropy Base64/mixed tokens (\(|S| \ge 24\), \(H(S) > 4.35\)) and hex assignment tokens (\(|S| \ge 32\), \(H(S) > 3.50\)) while exempting file paths, URLs, source code identifiers, and#icx:/fc:/hv:handles.
- Tier 0 — AHTL Structural Delimiter Neutralization:
- Updated
InfinityContextMmu::ingest_payloadto setFLAG_IS_REDACTED(1 << 7) onreceipt.hologram_bytes[7]wheneverSecretRedactorscrubs content, verified by end-to-end zero-leakage tests across CAS, Merkle-DAG, HDC, Bi-Temporal Graph, and/dev/shmSeqlock Bus. - Cross-referenced all 57 pages of
docs/ahtl/AHTL_v1_Complete_Technical_Specification_Volume.pdfagainst the workspace implementation: added 4-way unrolledHypervector::hamming_distance_simd(Chapter 08 §3), alignedChannelBHologrambyteB[7](TIER_MASK = 0b11bits0..=1+FLAG_HAS_ANOMALY/FLAG_IS_MUTATED/FLAG_IS_FOLDED/FLAG_IS_SEALED/FLAG_IS_TELEPATHY/FLAG_IS_REDACTEDbits2..=7, Chapter 02 §4.1), and pinned Canonical Test Vectors 1 & 2 incrates/icx-codec/src/ahtl.rs(Chapter 01 §§6.1–6.2). - Phase 2 Sprint 2 — Multi-Language AST/Lexical, Unified Diff & Multi-Ecosystem Diagnostic Log
StructuralSkeletonizer(crates/icx-codec/src/skeleton.rs): - Expanded
StructuralSkeletonizer::skeletonize_source(T-22-001) to extract top-level declarations (fn,struct,enum,trait,impl,class,interface,type) acrossRust,Python,TypeScript/JavaScript,Go, andC/C++with quote-, Rust-lifetime- ('a), and comment-aware brace/indentation line-span tracking (L<start>-<end>), contiguous header import folding (imports:L<a>-<b>(N)including Goimport (...)blocks), module headers (mod@L<n>), and paired---/+++unifiedgit difffile &@@ ... @@hunk extraction. - Expanded
StructuralSkeletonizer::skeletonize_log(T-22-002) with line-anchored multi-ecosystem compiler and test-runner log detection and compression (cargo test/clippy,pytest,tsc/vitest/jest,go test), achieving>= 25x(39.6xmeasured) compression on 500-test logs while unconditionally preserving 100% of failing test names (!FAIL:<test_name>) and deduplicating repeated pytest summary entries. - Phase 2 Sprint 1 — AHTL v1.0 Dual-Profile Codec, Braille-256 Bijection & 1-Lipschitz 64-Band Spectral Projection (
crates/icx-codec,crates/icx-hdc,crates/icx-cli): - Implemented
byte_to_braille_utf8,braille_utf8_to_byte,encode_braille_64,decode_braille_64,sketch_hamming_distance,spectral_hamming_distance_64, andChannelBHologramincrates/icx-codec/src/braille.rs, verified by exhaustive 256-byte bijection and 10,000-sample randomized Hamming isometry property tests (T-21-001). - Implemented
Hypervector::from_u64_seed(SplitMix64),Hypervector::spectral_bands_64(1-Lipschitz 20-bit sub-block majority voting + 8-sub-block byte packing across 160u64words),Hypervector::hv_digest_u64, andFractalCoord::encode_fc_hex64/decode_fc_hex64(T-21-001). - Implemented Profile A
AhtlWirePacketV1(⟦AHTL v1│#icx:<12-hex>│fc:<64-hex>│hv:<16-hex>│<64-Braille>│<skeleton>⟧), enhanced Profile BAhtlPacket(slice_hint,hologram_tag,compact_48bit_handle, bijective%25/%23Lsubject escaping,⇒causal chains),EpochHeader,WirePacket,AhtlStream,ContextCodectrait, andicx encode-ahtl --profile <a|b>CLI support (T-21-002).
[0.2.0] - 2026-11-17¶
Highlights¶
Phase 1: Core CAS, Merkle-DAG (LCM), /dev/shm Seqlock Bus & Zero-unsafe Enforcement (Overview (Sprints 1.1–1.4)).
Two-threshold Normalized FastCDC with LineIndexEntry selective chunk line slicing, 48-bit (#icx:<12-hex>) and 64-bit (#icx:<16-hex>) BLAKE3 CAS handle resolution with ambiguity guards, 4-tier MerkleContextDag (L1..L4 + ToolArtifact) with nested Context-Folding and L3 -> L4 epoch compaction, a 200-turn prefix-cache simulation, the AtomicU32/AtomicU64 in-process SeqlockTelemetryBus with a file-backed variant, permanent workspace-wide unsafe_code = "forbid", Rust Edition 2024 / MSRV 1.100, and >= 95% Codecov gate.
Added¶
- Phase 1 Sprint 4 — 100% Zero-
unsafeConversion, Permanent Workspace-Wideunsafe_code = "forbid"Gate &>= 95%Codecov Enforcement (crates/icx-bus,crates/icx-proxy,crates/icx-adapters,crates/icx-cli,.github/workflows/ci.yml): - Refactored
SeqlockTelemetryBus,FabricHeader(64 B), andSeqlockSlot(4,096 B) incrates/icx-bus/src/ring.rsto 100% safeAtomicU32andAtomicU64word-packed structures ([AtomicU64; 496]forahtl_words,[AtomicU64; 4]forhdc_sketch,[AtomicU64; 4]forfractal_q15_words,AtomicU64forpacked_meta) and safe/dev/shmpositional I/O (std::os::unix::fs::FileExt::{read_exact_at, write_all_at}+File::try_lock), removingmemmap2and eliminating all 11unsafeblocks (T-14-002). - Enforced
[lints] workspace = true(unsafe_code = "forbid") across all 8 workspace crates and added an automatedEnforce workspace-wide zero-unsafe policyCI step in.github/workflows/ci.yml(T-14-003). - Added
WireProxyTransformer::transform_openai_request(crates/icx-proxy/src/wire.rs) and expanded unit and integration test suites across all 8 crates to achieve96.13%workspace line coverage (>= 95.20%in every crate), raising the CIcargo-llvm-covfloor to--fail-under-lines 95andcodecov.ymltargets to95%(T-14-004). - Phase 1 Sprint 3 — Lock-Free
/dev/shmSeqlock Telepathy Bus, Workspace Isolation & CLIinit/deref(crates/icx-bus,crates/icx-adapters,crates/icx-cli): - Enriched 64-byte
FabricHeader(root_seqlock: AtomicU32,active_agents_mask: AtomicU64,global_dag_root: [AtomicU64; 4]) and 4,096-byteSeqlockSlot(packet_kind: u8) with compile-time size and alignment assertions (T-13-001). - Hardened
SeqlockTelemetryBus::open_shared_filewith0o600owner-only Unix permissions, magic (ICX_SHM_MAGIC) and schema version (ICX_SHM_VERSION) validation (BusError::UnsupportedVersion,BusError::InsecurePermissions), per-slot atomiccompare_exchange_weakwriter serialization, UTF-8 char-boundary-safe inline packet copying, volatile slot accesses,poll_workspace_since, and the 8-writer × 8-reader × 10,000-message concurrent Seqlock stress test (T-13-002). - Wired
InfinityContextMmuto updateFabricHeader::global_dag_rooton epoch rollover and poll workspace-scoped telepathy viapoll_workspace_since, and addedicx initandicx deref <HANDLE> [--lines START:END]CLI subcommands. - Phase 1 Sprint 2 — Lossless Merkle-DAG (
LCM), Nested Context-Folding & Cache-Epoch Budget Retargeting (crates/icx-core): - Added structured
ToolArtifactNode(DagNode::ToolArtifact) with domain-separatedb"ICX_DAG_TOOL_V1"hashing (ToolArtifactNode::compute_merkle_digest) andMerkleContextDag::append_tool_artifact(T-12-001). - Upgraded
MerkleContextDagbranch state to a nested stack (branch_stack: Vec<OpenBranch>,active_branch_depth), addedexpand_branchfor lossless recursiveL2 -> L1branch expansion, addedfold_epochsforL3 -> L4hierarchical epoch compaction, and addedverify_merkle_integrityfor cryptographic verification of anyL1,L2,L3, orL4node (T-12-001,T-12-002). - Added provider-tuned
EpochControllerConfig::anthropic_default()(16,384rollover tokens,6protected turns,2,048tail slot) andopenai_default()(8,192rollover tokens),CacheEpochController::record_node,zone1_compressed_tokens, level-order pairwiseretarget_budget(L3 -> L4folding), and the 200-turn Prefix-Cache Simulation Test verifying>= 94%average prefix-cache hit rate (T-12-003). - Phase 1 Sprint 1 — Normalized FastCDC, Dual-Profile
#icx:<hex>Handle Resolution & Selective Chunk Line Slicing (crates/icx-core,crates/icx-adapters): - Implemented
ArtifactId::parse_prefix_range,ArtifactId::to_short_hex12,ArtifactId::to_short_handle, andCasStore::resolve_handlesupporting both 64-bit (#icx:<16-hex>) and 48-bit (#icx:<12-hex>) handles with \(O(\log N)\)BTreeMap::rangelookup and fail-closed prefix ambiguity detection (IcxError::AmbiguousHandlePrefix), wired intoMcpPagerServer(deref,slice,grep). - Upgraded
chunk_bytes(crates/icx-core/src/chunker.rs) to two-threshold Normalized FastCDC (mask_sbeforeavg_size,mask_lfromavg_sizetomax_size) and added streamingchunk_bytes_with_lines(ChunkLineSpan). - Added
LineIndexEntrytoStoredArtifact(crates/icx-core/src/cas.rs), enablingCasStore::deref_linesto verify and read only the intersectingL0chunks for[start_line..=end_line], addedput_bytes_checked(ICX_MAX_INGEST_BYTES = 64 MiBSTRIDE DoS bound),grep_cold_with_context,ContentAddressedStoretrait implementation, and atomic directory persistence (save_to_dir/load_from_dir). - AHTL v1.0 Master Specification Volume & Foundational Reference Archives (
docs/ahtl/,ref-docs/): - Complete 9-document normative specification suite (
docs/ahtl/README.mdand Chapters01–08) and 55-page printable technical volume (docs/ahtl/AHTL_v1_Complete_Technical_Specification_Volume.pdf) covering ISO/IEC 14977 EBNF grammar, ISO/TR 11548-1 Braille-256 spectral bijection (0x00..0xFF), contractive IFS Chaos-Game coordinates (fc:<64-hex>), \(Q_{10240}\) Boolean hypercube HDC algebra (hv:<16-hex>), homomorphic AST skeletonization & 3-tier secret redaction, FastCDC + BLAKE3 Merkle-DAG virtual handles (#icx:<hex>), Transformer induction-head attention mechanics, and the v1.0 Rust reference implementation blueprint. - Four primary reference archives in
ref-docs/separating generated diagrams (images/generated/) from retrieved archival figures (images/retrieved/):ref-docs/unicode-braille-patterns/,ref-docs/blake3-cryptographic-hash/,ref-docs/hypercube-and-hamming-geometry/, andref-docs/ahtl-foundations/. - Automated Antigravity CLI (
agy) Pull Request Review & CI/CD Hardening (.github/,scripts/): - Self-hosted Antigravity PR review workflow (
.github/workflows/antigravity-review.yml), review rubric (.github/agy-review.md), deterministic parser and deduplicating GitHub comment publisher (scripts/agy-review.sh), and 16-case offline regression harness (scripts/agy-review-selftest.sh). - Automated Contributor License Agreement (
CLA.md) verification workflow (.github/workflows/cla.yml) and commit-author / co-author, PR-description, and PR-comment signature verifier with offline selftest suite (.github/scripts/cla-check.sh). - Expanded CI pipeline (
.github/workflows/ci.yml) addingcargo-llvm-covLCOV workspace coverage reporting withcodecov/codecov-action@v5and checksum-pinnedgitleaksv8.30.1secret scanning alongsidecheckandagyself-tests. - Repository code ownership (
.github/CODEOWNERS), weekly Cargo + GitHub Actions dependency updates (.github/dependabot.yml), Codecov project/patch/component coverage configuration (codecov.yml), Gitleaks ruleset extension (.gitleaks.toml), CodeRabbit v2 review configuration (.coderabbit.yaml), and GitHub Copilot instructions (.github/copilot-instructions.md).
Changed¶
- Toolchain, Cargo Workspace Dependencies & GitHub Actions Bumps (
Cargo.toml,.github/workflows/): - Upgraded workspace Rust edition to
2024and MSRV (rust-version) to1.100(rustc 1.100.0). - Bumped workspace crate version requirements to current latest releases (
blake3 = "1.8.7",serde = "1.0.229",serde_json = "1.0.154",thiserror = "2.0.21",memmap2 = "0.9.12"). - Bumped
actions/checkoutfromv4tov7across.github/workflows/ci.yml,.github/workflows/cla.yml, and.github/workflows/reuse.yml, and bumpedcodecov/codecov-actionfromv5tov7in.github/workflows/ci.yml. - Five-Plane Patent-Pending Notice & README Badge Matrix (
PATENTS.md,README.md): - Reconciled
PATENTS.mdto explicitly enumerate the five pending invention families across all five architectural planes of Infinity-Context (icx) (AHTL& Braille-256 symbolic codec, Virtual Context MMU & 4-tierBLAKE3Merkle-DAG with subtask context-folding, 10,240-bitHDC+ Delta-Rule bundler + Contractive IFSFCGAarchive, Titans surprise-gated bi-temporalPPR+ 4-zone prefix-cache epoch controller, and lock-free/dev/shmseqlock telepathy ring bus + multi-harness hook fabric + polymorphicicxMCP pager). - Optimized the
README.mdhero badge block into four balanced, width-verified rows covering CI, REUSE 3.3, CLA, Codecov, Antigravity (agy) PR review, Gitleaks, licensing, 5 pending patent families, verified performance benchmarks, and supported agent harnesses.
[0.1.0] - 2026-11-16¶
Highlights¶
Phase 0: Research, REA Forensics, Specifications & Workspace Bootstrap (Overview).
38-source deep research report, 22 indexed arXiv papers (ref-docs/papers/; 10 of the PDFs were removed in v1.1.0 because their license does not permit redistribution), REA binary/SQLite forensics on Claude Code, Codex, Antigravity CLI (agy), and Hermes (ref-docs/agent-internals/), 13 normative specs + 4 ADRs (docs/), 9-chapter AHTL v1.0 specification volume (docs/ahtl/), multi-tier GPL-3.0/AGPL-3.0/CC-BY-NC-ND-4.0 + 5-family patent IP governance (REUSE 3.3), and 8-crate workspace bootstrap.
Added¶
- Licensing, Patent-Pending IP Protection & REUSE 3.3 Governance:
- Multi-tier IP protection framework (
LICENSING.md,PATENTS.md,COMMERCIAL.md,CLA.md,REUSE.toml,LICENSES/) verified at 100% REUSE 3.3 compliance (uvx reuse lint):GPL-3.0-or-later(LICENSE/COPYING) for core workspace code,GPL-3.0-or-later AND AGPL-3.0-or-laterfor networked proxy/MCP crates (icx-proxy,icx-adapters),CC-BY-NC-ND-4.0 AND LicenseRef-InfinityContext-Commercialfor specifications, mathematical derivations, and artwork, plus patent-pending and commercial reservation inPATENTS.mdandCOMMERCIAL.md. - Research & Forensics Corpus (
ref-docs/): - Initial project concept (
ref-docs/initial-concept.md) and 38-source Deep-Research Technical Report (ref-docs/research-report.md). - Downloaded 22 primary arXiv research PDFs into
ref-docs/papers/with full mathematical synthesis (ref-docs/papers/INDEX.md). - Reverse-Engineer-Anything (
rea) binary and SQLite forensic ledger covering Claude Code2.1.326, OpenAI Codex0.169.0, Google Antigravity CLIagy, Hermes Agent, andai-memory(ref-docs/agent-internals/rea-binary-and-sqlite-forensics.md). - Cross-agent hook and wire interception matrix (
ref-docs/agent-internals/cross-agent-hook-and-wire-matrix.md), industry prior-art comparison (ref-docs/prior-art/github-and-industry-landscape.md), and mathematical derivations ofAHTL, 10,240-bitHDC/HRR, Contractive IFSFCGA, and Titans Surprise Gating (ref-docs/novel-methods/non-human-neural-codecs-and-holographic-context.md). - Implementation Specifications (
docs/): - 13 implementation-grade specification documents (
architecture.md,alien-holographic-codec.md,virtual-memory-and-dag-engine.md,hyperdimensional-and-fractal-index.md,agent-adapters-and-interception.md,wire-protocol-and-shm-bus.md,data-model.md,interfaces.md,performance.md,security-and-threat-model.md,testing-strategy.md,build-and-tooling.md,glossary.md). - 4 Michael Nygard Architecture Decision Records in
docs/adr/(ADR-0001throughADR-0004). - Normative Mermaid diagram sources in
docs/diagrams/and dark/light vector SVGs indocs/images/. - Hierarchical Roadmap & Sprint Plans (
to-dos/): - 5-Phase, 14-Sprint hierarchical roadmap (
to-dos/ROADMAP.md), Phase 0 precursory setup checklist (to-dos/phase-0-precursory-setup/overview.md), and ticket specificationsT-11-001throughT-52-002. - 8-Crate Rust Workspace (
crates/): icx-core:IcxHandle(#icx:<16-hex>), Gear-hashFastCdcChunker,zstd-compressedBLAKE3CasStore, 4-levelMerkleContextDag(LCM), andCacheEpochController.icx-hdc: 10,240-bitHypervector([u64; 160]), Infini-attention Delta-RuleHdcBundler, Contractive IFSFractalCoord,TitansSurpriseGate, andHdcAssociativeIndex.icx-codec:AhtlPacketnon-human BPE-aligned symbolic codec, Unicode Braille-256 bijection (U+2800..U+28FF),StructuralSkeletonizer, and pre-hashSecretRedactor.icx-store:BiTemporalGraph([t_valid, t_invalid)x[t_created, t_expired)) and HippoRAGPersonalizedPageRank(PPR).icx-bus: Lock-free POSIX/dev/shm/icx-fabric-v1.shmSeqlockTelemetryBus(512 x 2,048-byte#[repr(C, align(64))]slots).icx-adapters:InfinityContextMmu,ClaudeCodeAdapter,CodexAdapter,AntigravityAdapter(strict exit code0),HermesAdapter, and Single-Tool PolymorphicMcpPagerServer.icx-proxy:WireProxyTransformerfor Anthropic 4-slotcache_control: {"type": "ephemeral"}and OpenAI 1,024-token prefix cache alignment.icx-cli:icxbinary supportinghook,mcp-serve,proxy-transform,encode-ahtl,decode-ahtl,status,doctor, andbenchmark.- Branding, Icons & Relationship Graphs (
images/,assets/): - Graphviz relationship diagrams (
images/infinity-context-architecture.{dot,png,svg}andimages/infinity-context-crate-graph.{dot,png,svg}). - Multi-resolution icon packs (
assets/icons/), 3:1 wide banners (assets/branding/icx-banner-{1500x500,1200x400,900x300}.png), full 16:9 hero banner (images/InfinityContext_Full-Logo.png), web manifest (assets/web/), Linux.desktoplauncher (assets/linux/), and1280x640GitHub Social Preview card (assets/branding/icx-social-preview-1280x640.{png,svg}).