codeanalyzer-typescript v1.6.0

[rahlk]

codeanalyzer-typescript v1.6.0 — the graph resolves to text

No breaking changes. Nothing to migrate; every addition below is new surface on the Neo4j
projection. The analysis.json projection is byte-for-byte unchanged from 1.5.3.

The Neo4j graph can now resolve any span to its text

Before this release the two projections disagreed about the primary text, and the graph was the
one that was wrong. analysis.json carries each module's whole-file source; the graph carried
only a content hash and a line pair, while :TSCallable kept a code property — a slice of the
source the graph itself no longer held. The practical effect: nothing narrower than a callable
resolved to text on the graph backend. A class's text, a call site's text, a single statement's
text — none of it was reachable without going back to the JSON.

Two additions fix it, and they work only together:

• :TSModule now carries source — the whole file. It is always present: an empty file
  yields "", never an absent property, so a consumer can never confuse "the projection didn't
  carry this" with "the file is empty".
• Every span now carries columns and UTF-8 byte offsets — start_column, end_column,
  start_byte, end_byte, beside the line pair it already had, across ten node labels.

Together they make any node's text a byte slice of its module's source:

// given a node's start_byte/end_byte and its module's source
Buffer.from(source, 'utf8').subarray(start_byte, end_byte).toString('utf8')

Those are byte offsets, not character offsets, so slice with a byte-aware API — Buffer in
Node, source.encode("utf-8")[lo:hi] in Python. String.slice() runs short the moment a
multibyte character precedes the span.

Why the property names look like the Java analyzer's

They are the Java analyzer's. start_column / end_column / start_byte / end_byte were coined
in codeanalyzer-java and adopted here verbatim, so one slicing rule works across languages: a
database holding both languages previously had sliceable Java nodes and unsliceable TypeScript
ones, and a cross-language "give me the text at this span" query could not be written at all.

Detecting the addition

schema_version stays at 2.0.0 — the graph contract number moves only when every CLDK analyzer
re-baselines together. So these properties are detected by presence, not by a version check.

:TSCallable.code is unchanged and still present, even though it is now derivable. Nothing that
reads it needs to change.

Known limitation

If you reach the graph through python-sdk's TypeScript Neo4j backend, that backend currently
queries the older v1 graph shape and will not surface these properties yet — see
codellm-devkit/python-sdk#391. Direct Cypher and the in-memory backend are unaffected.

Also in this release

• Release automation now records this analyzer's emitted schemas in codellm-devkit/codeanalyzer-schema
  on every tag, so the published graph contract and JSON samples stay in step with what ships (#199).
  Internal; no effect on analyzer behaviour.

Upgrade

PyPI:

pip install -U "codeanalyzer-typescript==1.6.0"

Homebrew:

brew upgrade codellm-devkit/homebrew-tap/codeanalyzer-typescript

Shell installer (prebuilt binary; macOS and Linux):

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/codellm-devkit/codeanalyzer-typescript/releases/latest/download/cants-installer.sh | sh

Download

File	Platform
cants-macosx_11_0_arm64	Apple Silicon macOS
cants-macosx_10_12_x86_64	Intel macOS
cants-manylinux2014_x86_64	x86-64 Linux
cants-manylinux2014_aarch64	ARM64 Linux
cants-win_amd64.exe	x64 Windows
cants-installer.sh	Shell installer
schema.json	Neo4j schema contract
analyzing-cants-graphs-skill.tar.gz	Consumer query skill (tarball)
analyzing-cants-graphs-SKILL.md	Consumer query skill (SKILL.md only)

Links

• GitHub Release v1.6.0
• Design record for this change: docs/design/specs/graph-carries-source-and-byte-offsets.md
• Issue: #201 · PR: #204
• Commits in this release: v1.5.3...v1.6.0

This repository keeps no CHANGELOG.md; the release notes and the linked spec are the record.