AgentLayer v0.2.0-alpha.1
AgentLayer v0.2.0-alpha.1
AgentLayer v0.2.0-alpha.1 introduces the first public alpha shape for AgentLayer: a scoped npm alpha
CLI quickstart, clearer reports, real-world scan feedback loops, and the first local AgentLayer CI
alpha.
Highlights
agentlayer baseline <url>saves a compactagentlayer-baseline/v1JSON report.agentlayer compare <url>writes anagentlayer-comparison/v1JSON report.--fail-on task-regressionblocks when a task that passed in the baseline becomes partial,
failed, or missing.--fail-on missing-artifactblocks when a generated artifact from the baseline is absent in the
current scan.--fail-on score-drop --min-score-delta 5blocks only when the overall score drop exceeds the
configured threshold.- Compare reports include machine-readable comparison JSON, a human-readable CLI summary,
recommendations, and anexitCode. - Generated reports explain score weights, task reasons, evidence, missing evidence, next fixes, and
Critical/Warning/Suggestion recommendation labels. docs/scoring.mddocuments the deterministic scoring model and limitations.examples/real-worldincludes 10 anonymized bounded public-site scan summaries and heuristic
notes.- New issue templates collect real scan feedback, false positives, and confusing recommendations.
- Two real-world heuristic issues have focused fixes: blog/resource page-type false positives and
navigation-only demo/contact wording. examples/ciincludes copyable public-site and local-fixture GitHub Actions examples.- A manual published CLI smoke workflow can verify
pnpm dlx @junyi5910/agentlayer-cliafter npm
publish. docs/release-checklist.mddocuments publish order, smoke tests, and when to sync GitHub.docs/launch/launch-posts.mdanddocs/launch/share-your-scan.mdprovide post-publish outreach
copy for collecting real scans.docs/ci.mddocuments local baseline/compare usage and a GitHub Actions alpha workflow.
Example
pnpm dlx @junyi5910/agentlayer-cli baseline https://example.com \
--out ./agentlayer-baseline.json \
--max-pages 20
pnpm dlx @junyi5910/agentlayer-cli compare https://example.com \
--baseline ./agentlayer-baseline.json \
--out ./agentlayer-compare.json \
--fail-on task-regression \
--fail-on missing-artifact \
--fail-on score-drop \
--min-score-delta 5 \
--max-pages 20Limitations
- Local-first only; there is no hosted AgentLayer CI service.
- No PR comment bot yet.
- No official compliance guarantee for MCP, WebMCP,
llms.txt, Agent Skills, or future standards. - Use the scoped npm alpha CLI for public-site trials. Repo-local commands are only for repository
checkouts and fixture development. - This alpha publishes
@junyi5910/agentlayer-coreand@junyi5910/agentlayer-cli. - Do not use the unscoped
agentlayerpackage name. - The scanner does not crawl authenticated/private areas, submit forms, or perform destructive
actions.
Links
- CI docs: https://github.com/Qqqq5910/agentlayer/blob/main/docs/ci.md
- README: https://github.com/Qqqq5910/agentlayer#readme
- Changelog: https://github.com/Qqqq5910/agentlayer/blob/main/CHANGELOG.md
- Demo: https://agentlayer-readonly-demo.vercel.app
- Pinned scan feedback issue: #1
- Feedback guide: https://github.com/Qqqq5910/agentlayer/blob/main/docs/feedback.md