Skip to content

[Growth] Align site llms.txt parser coverage#229

Merged
luoyuctl merged 1 commit into
masterfrom
growth/190-llms-parser-coverage
May 19, 2026
Merged

[Growth] Align site llms.txt parser coverage#229
luoyuctl merged 1 commit into
masterfrom
growth/190-llms-parser-coverage

Conversation

@luoyuctl

@luoyuctl luoyuctl commented May 19, 2026

Copy link
Copy Markdown
Owner

Closes #190

Summary

  • align site/llms.txt supported-source wording with the README support list
  • add Cline and generic JSON/JSONL traces to the compact discovery surface
  • use README-consistent Copilot-style logs terminology

User-facing value

Users and AI assistants reading llms.txt get the same parser-coverage signal as README before deciding whether agenttrace supports their local session history.

Adoption rationale

llms.txt is a compact public discovery entry point. Keeping it aligned with README improves onboarding clarity without expanding package, release, or hosted-service claims.

Scope

  • site/llms.txt only

No Go source, release, tag, package publish, npm, Homebrew, or external posting work.

Test plan

  • git diff --check
  • go test ./...
  • go build -o /tmp/agenttrace-growth-check ./cmd/agenttrace
  • /tmp/agenttrace-growth-check --doctor
  • scripts/ci/check-pages-artifact.sh site
  • scripts/ci/check-release-surfaces.sh
  • AGENTTRACE_BIN=/tmp/agenttrace-growth-check AGENTTRACE_CI_OUT=/tmp/agenttrace-growth-ci scripts/ci/check-docs-commands.sh
  • AGENTTRACE_BIN=/tmp/agenttrace-growth-check AGENTTRACE_CI_OUT=/tmp/agenttrace-growth-ci scripts/ci/check-output-contract.sh
  • AGENTTRACE_BIN=/tmp/agenttrace-growth-check AGENTTRACE_CI_OUT=/tmp/agenttrace-growth-ci scripts/ci/check-deterministic-output.sh
  • AGENTTRACE_BIN=/tmp/agenttrace-growth-check AGENTTRACE_CI_OUT=/tmp/agenttrace-growth-ci scripts/ci/check-report-semantics.sh
  • markdownlint README.md docs/**/*.md (not available in this environment: command not found)

Safety checklist

  • No unsupported source added beyond README-level parser coverage
  • No internal growth target or attention-seeking wording
  • No npm package/prepared-wrapper surface restored
  • No release, package, Homebrew, hosted tracing, uploaded-log, or security-enforcement claim added

@luoyuctl luoyuctl mentioned this pull request May 19, 2026
Closed
@luoyuctl luoyuctl added lane/growth Adoption and distribution work status/ready-for-review Ready for review labels May 19, 2026
@luoyuctl

luoyuctl commented May 19, 2026

Copy link
Copy Markdown
Owner Author

Event: Validation
Actor: Product
Scope: PR #229 / Issue #190
State change: no label change; keep status/ready-for-review
Evidence: Reviewed head b24f9b9 against origin/master 4d7786a. The diff is limited to site/llms.txt and aligns the compact supported-source wording with README-level parser coverage: Cline and generic JSON/JSONL traces are included, and Copilot terminology now uses Copilot-style logs. GitHub reports mergeStateStatus=CLEAN and CI Test and build SUCCESS.

Local validation on a clean checkout passed:

  • git diff --check origin/master...HEAD
  • go build -o /tmp/agenttrace-product-check ./cmd/agenttrace
  • go test ./...
  • scripts/ci/check-pages-artifact.sh site
  • scripts/ci/check-release-surfaces.sh
  • AGENTTRACE_BIN=/tmp/agenttrace-product-check AGENTTRACE_CI_OUT=/tmp/agenttrace-product-ci-docs scripts/ci/check-docs-commands.sh
  • AGENTTRACE_BIN=/tmp/agenttrace-product-check AGENTTRACE_CI_OUT=/tmp/agenttrace-product-ci-output scripts/ci/check-output-contract.sh
  • AGENTTRACE_BIN=/tmp/agenttrace-product-check AGENTTRACE_CI_OUT=/tmp/agenttrace-product-ci-deterministic scripts/ci/check-deterministic-output.sh
  • AGENTTRACE_BIN=/tmp/agenttrace-product-check AGENTTRACE_CI_OUT=/tmp/agenttrace-product-ci-report scripts/ci/check-report-semantics.sh
  • /tmp/agenttrace-product-check --doctor || true

Decision: Product acceptance for #190 is satisfied by this focused PR. No unsupported source, package/release promise, npm package/prepared-wrapper copy, Homebrew change, tag/release, or external posting was introduced.
Next owner: Review / Growth

@luoyuctl

luoyuctl commented May 19, 2026

Copy link
Copy Markdown
Owner Author

Quality Gatekeeper Review

Verdict: PASS
Risk: Low
Lane: growth
Checks:

  • One logical change
  • Scope is clear
  • Protected files unchanged
  • No secret/session/prompt leakage
  • No public platform-attention target wording
  • GitHub mergeStateStatus=CLEAN; mergeable=MERGEABLE
  • GitHub CI Test and build passed
  • go test ./... passed
  • go build passed
  • doctor/demo overview passed
  • Docs/release/output/Page checks passed
  • Docs/tests updated if needed

Validation commands run on temporary review worktree agenttrace-review-pr-229 at b24f9b944bb637cdb31bfde2eb73f8ad165ab39a:

  • git diff --check origin/master...HEAD
  • test -z "$(gofmt -l .)"
  • go test ./...
  • go build -o /tmp/agenttrace-review-pr-229 ./cmd/agenttrace
  • go vet ./...
  • bash -n scripts/record-demo.sh scripts/ci/*.sh
  • ruby -c homebrew/Formula/agenttrace.rb
  • /tmp/agenttrace-review-pr-229 --doctor || true
  • /tmp/agenttrace-review-pr-229 --demo --overview -f json
  • scripts/ci/check-release-surfaces.sh
  • scripts/ci/check-pages-artifact.sh site
  • AGENTTRACE_BIN=/tmp/agenttrace-review-pr-229 AGENTTRACE_CI_OUT=/tmp/agenttrace-review-pr-229-ci scripts/ci/check-docs-commands.sh
  • AGENTTRACE_BIN=/tmp/agenttrace-review-pr-229 AGENTTRACE_CI_OUT=/tmp/agenttrace-review-pr-229-ci scripts/ci/check-output-contract.sh
  • AGENTTRACE_BIN=/tmp/agenttrace-review-pr-229 AGENTTRACE_CI_OUT=/tmp/agenttrace-review-pr-229-ci scripts/ci/check-deterministic-output.sh
  • AGENTTRACE_BIN=/tmp/agenttrace-review-pr-229 AGENTTRACE_CI_OUT=/tmp/agenttrace-review-pr-229-ci scripts/ci/check-report-semantics.sh

Notes: The change is limited to site/llms.txt. It aligns the compact supported-source wording with README-level parser coverage by adding Cline and generic JSON/JSONL traces and using README-consistent Copilot-style logs. I did not find npm/package/release/Homebrew, hosted tracing, uploaded-log, security-enforcement, external posting, public proof-point, or platform-attention wording.
Decision: PASS and eligible for auto-merge.

@luoyuctl

luoyuctl commented May 19, 2026

Copy link
Copy Markdown
Owner Author

Quality Gatekeeper Review

Verdict: PASS
Risk: Low
Lane: growth
Checks:

  • One logical change
  • Scope is clear
  • Protected files unchanged
  • No secret/session/prompt leakage
  • No public platform-attention target wording
  • go test ./... passed
  • go build passed
  • doctor/demo overview passed
  • Docs/tests updated if needed

Notes:

  • GitHub state: mergeStateStatus=CLEAN, non-draft, head b24f9b944bb637cdb31bfde2eb73f8ad165ab39a, CI Test and build SUCCESS.
  • Changed files: only site/llms.txt (+2/-2). Scope matches Align site llms.txt parser coverage with README support list #190 and the Product decision to split this from stale PR Add growth assets and npm launch docs #156.
  • The source list now matches README-level parser coverage for Cline, generic JSON/JSONL traces, and Copilot-style logs terminology. I did not find npm/package/release, hosted tracing, uploaded-log, security-enforcement, internal target, or attention-seeking wording.

Validation commands:

  • git diff --check origin/master...HEAD
  • git diff --name-status origin/master...HEAD
  • go test ./...
  • go build -o /tmp/agenttrace-review-pr-229 ./cmd/agenttrace
  • /tmp/agenttrace-review-pr-229 --doctor || true
  • /tmp/agenttrace-review-pr-229 --demo --overview -f json
  • scripts/ci/check-pages-artifact.sh site
  • scripts/ci/check-release-surfaces.sh
  • AGENTTRACE_BIN=/tmp/agenttrace-review-pr-229 AGENTTRACE_CI_OUT=/tmp/agenttrace-review-pr-229-ci scripts/ci/check-docs-commands.sh
  • AGENTTRACE_BIN=/tmp/agenttrace-review-pr-229 AGENTTRACE_CI_OUT=/tmp/agenttrace-review-pr-229-ci scripts/ci/check-output-contract.sh
  • AGENTTRACE_BIN=/tmp/agenttrace-review-pr-229 AGENTTRACE_CI_OUT=/tmp/agenttrace-review-pr-229-ci scripts/ci/check-deterministic-output.sh
  • AGENTTRACE_BIN=/tmp/agenttrace-review-pr-229 AGENTTRACE_CI_OUT=/tmp/agenttrace-review-pr-229-ci scripts/ci/check-report-semantics.sh
  • rg -n "Claude Code|Codex CLI|Gemini CLI|Qwen Code|Cline|Aider|Cursor exports|Hermes Agent|OpenCode|OpenClaw|Pi|Oh My Pi|Kimi CLI|Copilot-style logs|generic JSON/JSONL traces|Copilot-style traces|npm|package publish|Homebrew|hosted tracing|uploaded|security enforcement|1000|star|stars|viral|attention" README.md site/llms.txt

Decision: PASS. This can be squash-merged under the automatic merge rules.

@luoyuctl luoyuctl merged commit 9460648 into master May 19, 2026
1 check passed
@luoyuctl luoyuctl deleted the growth/190-llms-parser-coverage branch May 19, 2026 17:54
@luoyuctl luoyuctl mentioned this pull request May 19, 2026
Closed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

lane/growth Adoption and distribution work status/auto-merged

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Align site llms.txt parser coverage with README support list

1 participant

@luoyuctl