Skip to content

feat(hardening): improve Live reliability, CLI safety and repo readiness - #34

Merged
Hugo-JC merged 58 commits into
mainfrom
feat/repo-readiness-hardening-v1
Nov 12, 2026
Merged

Hugo-JC merged 58 commits into
mainfrom
feat/repo-readiness-hardening-v1

Conversation

@Hugo-JC

@Hugo-JC Hugo-JC commented Nov 11, 2026 •

Copy link
Copy Markdown
Owner

Summary

Repository-readiness hardening after the merged Visual Intelligence Bundle 1.1.0 work.

Live Inspector reliability

  • Keep the Vite development bootstrap registered after activation so Alt + Shift + I can recreate the inspector after Escape disposes it.
  • Expose controller disposal state and prevent the shortcut's browser default.
  • Observe only direct child-list changes along the selected element's ancestor chain to detect framework detachments without a full DOM scan, including while the panel is hidden.
  • Exclude detached targets from active diffs and report their count in Review Package 1.1.0.
  • Extend plugin and review-package contract tests.

Safer, complete CLI handoff

  • Add a reusable .integra/runs/ output writer that validates paths, rejects symlinked path components and protected inputs, and writes through a temporary file before rename.
  • Route both Direction and Visual Intelligence generators through that writer.
  • Align the Visual Intelligence source-lead limit with the resolver's actual maximum (1–5).
  • Add npm run visual-intelligence:validate for offline validation of received/saved Bundles.
  • Add an isolated end-to-end test covering Direction generation → Bundle generation → Bundle validation, plus protected-input behavior.

QA and performance

  • Remove implicit universal assumptions about 4px spacing grids and nested-surface depth. Those heuristic checks now require a project-supplied baseline.
  • Add a bounded 512-entry tokenization cache in visual-knowledge retrieval.
  • Precompute normalized command triggers once instead of normalizing them for every route request.

Documentation and release clarity

  • Rewrite the root README around the actual workflows and boundaries.
  • Explicitly state that integra-cli is not yet published to npm; provide local distribution validation instead of commands that could install over the canonical skill tree.
  • Update architecture, roadmap, command and agent integration contracts to distinguish implemented capabilities from manual pilots and future work.

Verification

  • GitHub Actions: 7/7 jobs passed — typecheck/tests/fixtures plus six CLI distribution combinations (Node 20/24 × Ubuntu/Windows/macOS).
  • Vitest: 36 test files, 194 tests passed.
  • npm run check passed, including Direction fixtures, Skill and preset validation, visual library, agent assets, command manifest and distribution checks.
  • Visual library validation: 72 visual sources, 10 asset providers, 61 niche mappings, 8 token recipes, 20 layout patterns, 32 rules, 21 anti-patterns, 7 examples and 2 partial observations.
  • Command manifest: 23 commands (1 orchestrator, 11 workflows, 11 modifiers).
  • Distribution smoke tests passed across the OS/Node matrix.

Draft PR for review only. No merge is requested or performed.

@Hugo-JC
Hugo-JC marked this pull request as ready for review November 12, 2026 06:13
@Hugo-JC
Hugo-JC merged commit 130dd75 into main Nov 12, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant