Skip to content

feat: seal-cli integration — index schema v1, stable IDs, branch-aware builds, manifest generation - #3

Merged
mattaereal merged 8 commits into
mainfrom
develop
May 15, 2026
Merged

feat: seal-cli integration — index schema v1, stable IDs, branch-aware builds, manifest generation#3
mattaereal merged 8 commits into
mainfrom
develop

Conversation

@mattaereal

Copy link
Copy Markdown
Collaborator

Summary

This PR delivers the full seal-cli integration layer for the SEAL Frameworks MCP server.

What's changed

  • Index schema v1 — structured, typed index format consumed by seal-cli
  • Stable IDs (path#anchor) — deterministic section identifiers for canonical referencing
  • Branch-aware builds — separate main and develop indexes built from isolated checkouts
  • Manifest generation — SHA256 manifest for integrity verification by the CLI
  • CI fixes — pinned pnpm via packageManager, corrected --content-dir in index workflows, added manifest step

Artifacts

On merge, the Build Main Index workflow will publish:

  • main-index.json
  • manifest.json

These are consumed by seal update --source release.

mattaereal and others added 8 commits April 14, 2026 21:56
Fix onboarding: setup.sh, build:mcp, and README quick-start commands
fix: add pnpm install step to CI workflows
…e builds, manifest generation

Indexer improvements:
- Schema version 1 with source_url, github_url, description, status, content_hash
- Stable section IDs using path#anchor format
- Fixed repo URLs to include docs/pages/ path
- Improved MDX normalizer to strip stray closing tags
- Added manifest.json generation with SHA256 checksums

MCP server improvements:
- Cache MiniSearch instances per branch instead of rebuilding on every query
- Updated all tools to return new metadata fields
- Fixed compare-service GitHub URLs

Build & setup:
- setup.sh now clones separate main/develop checkouts
- pnpm pinned via .npmrc and packageManager field
- Added generate-manifest.ts script

Documentation:
- Added docs/mcp/CLI.md explaining CLI/indexer relationship

Refs security-alliance/frameworks#478
- Remove hardcoded pnpm 9; auto-detect from packageManager field
- Add frameworks repo checkout step (security-alliance/frameworks)
- Pass --content-dir to index:build so MDX content is available
- Add manifest generation step
- Include manifest.json in release artifacts

Fixes GHA failures caused by pnpm 9 vs lockfile mismatch
and missing content directory in CI environment.
@mattaereal
mattaereal merged commit 15ecfdb into main May 15, 2026
2 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.

2 participants