Skip to content

v0.2.0

Latest
Latest

Choose a tag to compare

View all tags
@zackabrah zackabrah released this 15 Jul 04:03
· 1 commit to main since this release
Immutable release. Only release title and notes can be modified.
v0.2.0
fb1813c

Scopeglass v0.2.0

demo

Website: https://zackabrah.github.io/scopeglass/

Diagnostic ruleset version 2. Reports keep schema version 1, but ruleset-observable behavior changed — scopeglass check outcomes can differ from v0.1.0 on the same tree. Review the changes below before upgrading in CI gates.

  • Ruleset version: 2 (was 1)
  • Report schema version: 1 (unchanged)
  • Supported Node.js: >=22.17.0
  • License: MIT
  • Package integrity (sha512): sha512-rWiJ78+6zuuFVF/7yb+crUgKR9q7eNbKMSn75YxdRNPWgEDJ9dnSf0c/q7ZqnomKF1jaVO8tE2NWyIdIrpe9Dg==

Changed (behavioral — can affect check)

  • A symlinked or junctioned AGENTS.md is now followed when it resolves to a regular file inside the analysis root (the common AGENTS.md -> CLAUDE.md layout). Broken links, links escaping the root, and links resolving to non-files remain fatal unsafe-symlink errors; the resolved file passes the same open-descriptor identity checks.
  • Only root-level headings update the section stack. A heading nested inside a blockquote or list item no longer relabels later instructions.
  • Same-line instruction ordering ties now break on the numeric instruction ordinal instead of lexicographic ID comparison.
  • The npm package no longer ships tasks/plan.md (still in the repository).

Fixed

  • HTML report no longer overflows horizontally at extreme text zoom (200% on a 320px viewport): the hero title, instruction cards, eyebrow labels, and scope-heading metadata now wrap instead of pushing their grid tracks wider than the container. Verified across Chromium, Firefox, and WebKit.

Documentation

  • Clarified that the parser-sensitive syntax budgets, not the byte limits, are the practical input ceiling, and that exceeding any hard limit is fatal rather than a diagnostic.
  • Redesigned the README (theme-aware logo, benefits-first overview, badges, quick navigation); logo ships in docs/assets/.
  • Restyled the HTML report and logo on a monochrome, geometric design system with a single green accent; the report follows the OS color scheme (light/dark) while print output stays light.
  • Redesigned the terminal layout: instruction text leads each entry with section, source, kind, and precedence on a metadata line beneath it; entries are separated by a gutter rule; ordinals align past nine entries; diagnostic sources use tree connectors; and the policy block is separated from the report. Color applies only to Scopeglass-owned structure; repository text stays escaped and unstyled.

Known limitations

  • Ruleset v2 can change check results versus v0.1.0 on an unchanged tree — treat this as a gating-behavior bump, not a no-op patch.
  • Practical input size is bounded by parser-sensitive syntax budgets, not the raw byte limits; exceeding any hard limit is fatal (no diagnostic).
  • Local Markdown reference checks resolve relative links from the scope's recorded (display) directory. For a symlinked AGENTS.md, that is the symlink's directory, not the link target's — by design, matching the reported scope.path.

Security

Report suspected vulnerabilities privately via GitHub Security Advisories:
https://github.com/zackabrah/scopeglass/security/advisories/new

Verify after install

npm install --global scopeglass@0.2.0
scopeglass --version   # 0.2.0
npm view scopeglass@0.2.0 dist.integrity   # compare with the approved staged candidate

Full changelog: v0.1.0...v0.2.0

Assets 3
Loading