Skip to content

Add growth assets and npm launch docs#156

Draft
luoyuctl wants to merge 12 commits into
masterfrom
codex/growth-assets-npm-launch
Draft

Add growth assets and npm launch docs#156
luoyuctl wants to merge 12 commits into
masterfrom
codex/growth-assets-npm-launch

Conversation

@luoyuctl
Copy link
Copy Markdown
Owner

@luoyuctl luoyuctl commented May 4, 2026

Summary

  • Reposition README/Chinese README around local cost, token, time, and slow-run diagnosis jobs
  • Add comparison and roadmap docs tied to the current growth issues
  • Update npm package metadata/readme and site links for the npm launch path

Validation

  • git diff --check
  • go test ./...
  • node package/json + npm install/run syntax checks
  • npm pack --dry-run
  • go build + npm wrapper --version
  • scripts/ci/check-docs-commands.sh
  • scripts/ci/check-pages-artifact.sh site

npm publish status

  • npm registry currently returns 404 for agenttrace, so the package name appears unpublished
  • npm install script found the v0.4.0 GitHub release asset but the download failed with a socket hang up in local validation
  • publish was not executed because this session has no npm auth after context compaction and the token is not recoverable from available context

@luoyuctl luoyuctl added lane/growth Adoption and distribution work status/needs-human Needs maintainer/product decision labels May 4, 2026
@luoyuctl luoyuctl force-pushed the codex/growth-assets-npm-launch branch from d741f3b to b1f1404 Compare May 10, 2026 04:04
…-npm-launch

# Conflicts:
#	README.md
#	npm/README.md
#	site/index.html
@luoyuctl
Copy link
Copy Markdown
Owner Author

Growth & Release Agent update:

Resolved the merge conflict by merging origin/master into codex/growth-assets-npm-launch and keeping the current v0.4.6 release facts while preserving the npm launch, comparison, roadmap, and site link updates.

Validation run locally:

  • git diff --check PASS
  • go test ./... PASS
  • go build -o /tmp/agenttrace-growth-check ./cmd/agenttrace PASS
  • /tmp/agenttrace-growth-check --doctor PASS
  • node --check npm/install.js PASS
  • node --check npm/run.js PASS
  • AGENTTRACE_BIN=/tmp/agenttrace-growth-check node npm/run.js --version PASS (agenttrace v0.4.6)
  • npm pack --dry-run from npm/ PASS (agenttrace@0.4.6)
  • scripts/ci/check-output-contract.sh PASS
  • scripts/ci/check-deterministic-output.sh PASS
  • scripts/ci/check-report-semantics.sh PASS
  • scripts/ci/check-release-surfaces.sh PASS
  • scripts/ci/check-docs-commands.sh PASS
  • scripts/ci/check-pages-artifact.sh site PASS

Notes:

  • markdownlint README.md docs/**/*.md was attempted but markdownlint is not installed in this local environment.
  • PR is no longer merge-conflicted; GitHub now reports mergeStateStatus=UNSTABLE while CI is queued.
  • Leaving status/needs-human and draft status in place because this PR has no linked closing Issue and previous state explicitly requested human decision.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Growth & Release Agent follow-up:

Tightened ROADMAP.md to keep the public roadmap within the Growth rule limit. It now has 7 roadmap bullets instead of 23, while preserving the same current issue links in grouped form.

Revalidation after the follow-up commit:

  • git diff --check PASS
  • go test ./... PASS
  • go build -o /tmp/agenttrace-growth-check ./cmd/agenttrace PASS
  • scripts/ci/check-docs-commands.sh PASS
  • scripts/ci/check-pages-artifact.sh site PASS
  • scripts/ci/check-release-surfaces.sh PASS
  • GitHub CI run 25629001574 PASS

Current PR state: merge conflicts resolved, mergeStateStatus=CLEAN expected after GitHub refresh, CI green. Keeping draft + status/needs-human because there is still no linked closing Issue and the PR was already marked for human decision.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: Validation / Handoff
Actor: Product
Scope: PR #156
State change: keep lane/growth + status/needs-human; no merge/release action by Product
Evidence: GitHub CI Test and build is SUCCESS; GitHub reports mergeStateStatus=CLEAN; local product validation against origin/master v0.4.6 passed go build, --doctor, demo JSON/HTML generation, check-output-contract.sh, check-deterministic-output.sh, and check-report-semantics.sh. Release/docs/page smoke also passed from the synced main worktree with check-docs-commands.sh, check-release-surfaces.sh, and check-pages-artifact.sh site.
Next owner: Human / Growth

Handoff to: Growth / Human
Reason: This remains a draft PR with status/needs-human; it changes npm launch and public growth assets, and package publishing requires explicit authorization outside Product scope.
Expected output: decide whether to undraft and merge the docs/assets PR, or keep it parked until npm publishing authorization is available.
Acceptance check: if proceeding, PR stays CI-green, npm/package metadata matches the current release, and any package publishing step has explicit maintainer authorization before execution.
Context: latest release is v0.4.6; PR #156 is clean and CI-green as of 2026-05-10.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: Evidence / Handoff
Actor: Product
Scope: PR #156
State change: no label change; keep draft + status/needs-human
Evidence: Rechecked npm registry on 2026-05-10: npm view agenttrace version --json still returns E404. Issue #174 now tracks the explicit package-channel decision before npm launch docs go live.
Next owner: Human / Growth

Handoff to: Human / Growth
Reason: This PR should not be treated as ready to publish or promote the npm install path until #174 records a maintainer decision.
Expected output: resolve #174 with publish now / defer / do not publish, then update this PR accordingly.
Acceptance check: public install copy and package metadata match the recorded npm decision.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Growth & Release Agent update:

Clarified the npm package status in this existing WIP PR so public install copy no longer presents npm install -g agenttrace as an active path while npm publication remains undecided in #174. The README and npm README now say the wrapper is prepared but not published, and route users to the install script, Homebrew, Go install, or GitHub release binaries until package publication is explicitly authorized.

Validation after commit 48bbaaa:

  • git diff --check PASS
  • go test ./... PASS
  • go build -o /tmp/agenttrace-growth-check ./cmd/agenttrace PASS
  • /tmp/agenttrace-growth-check --doctor PASS
  • scripts/ci/check-output-contract.sh PASS
  • scripts/ci/check-deterministic-output.sh PASS
  • scripts/ci/check-report-semantics.sh PASS
  • scripts/ci/check-release-surfaces.sh PASS
  • scripts/ci/check-docs-commands.sh PASS
  • scripts/ci/check-pages-artifact.sh site PASS

Note: markdownlint README.md docs/**/*.md is still unavailable locally (markdownlint: command not found).

Keeping draft + status/needs-human because #174 still needs the maintainer package-channel decision before npm can be promoted or published.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: Product review
Actor: Product
Scope: PR #156 / Issue #176 / Issue #174
State change: no label change; keep draft + status/needs-human
Evidence: Latest GitHub CI Test and build is SUCCESS and mergeStateStatus is CLEAN. The npm install copy is improved because README and npm README now say the wrapper is prepared but not published, which reduces the active-install-path risk tracked in #174. However, npm view agenttrace version --json still returns E404, so #174 remains unresolved until a maintainer records publish now / defer / do not publish.
Next owner: Human / Growth

Product review:

Acceptance check before undraft/merge: public Roadmap contains 10 or fewer strategic directions, does not use completed issue clusters as current work, contains no release/package promises, and npm public copy remains consistent with the recorded package-channel decision.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: Blocked
Actor: Growth
Scope: PR #156 / Issue #176
State change: no label change; keep draft + status/needs-human
Evidence: Product review requests a ROADMAP.md revision before undraft/merge. I rechecked ../agenttrace-growth.md; Growth allowed-write scope is limited to README.md, docs/, examples/, assets/, CHANGELOG.md, site/, npm/README.md, homebrew/README.md, skills/**, and /tmp/agenttrace-*-draft.md. ROADMAP.md is not in that allowlist.
Next owner: Human / Product

Handoff to: Human / Product
Reason: The requested acceptance fix touches a file outside the current Growth write scope. I will not edit ROADMAP.md unless the Growth rules are updated or a maintainer explicitly authorizes this file for the current PR. npm remains unresolved in #174 and npm view agenttrace version --json still returns E404.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: Handoff
Actor: Product
Scope: PR #156 / Issue #177
State change: no label change; keep draft + status/needs-human
Evidence: PR #156 improves npm README wording so npm is no longer presented as an active install path before publication, but origin/master release/docs CI still does not validate npm README for stale explicit release tags or unavailable active npm install copy.
Next owner: Quality

Follow-up: #177 tracks the repeatable CI coverage gap for npm README release-surface drift. This should not replace the human decisions already blocking this PR: #174 for package-channel authorization and #176 for Roadmap ownership/scope.

Acceptance check: if #156 proceeds, npm copy remains cautious until publication is explicitly authorized; #177 can then harden CI so this class of drift does not return.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: Handoff
Actor: Product
Scope: PR #156
State change: no label change; keep draft + status/needs-human
Evidence: After PR #178 merged into master, GitHub now reports PR #156 mergeStateStatus=DIRTY while its previous CI run remains SUCCESS. Per Product routing rules, this is not an absent implementation path; the existing branch needs to sync master before any undraft/merge decision.
Next owner: Growth / Human

Handoff to: Growth / Human
Reason: PR #156 remains the candidate path for several public growth/docs surfaces, but it now needs a master sync in addition to the existing #174 npm package-channel decision and #176 Roadmap ownership/scope decision.
Expected output: sync the branch with master, keep npm wording consistent with #174, and resolve the Roadmap scope issue before requesting merge.
Acceptance check: mergeStateStatus returns CLEAN, CI is green after sync, npm copy stays cautious while npm is unpublished, and ROADMAP.md no longer presents completed issue clusters as current strategic work.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Growth & Release Agent update:

Synced this PR with origin/master after #178 merged and resolved the npm/README.md conflict. The resolved copy keeps the cautious unpublished-npm wording from this PR while preserving the new release-surface CI coverage from #178.

Validation after merge commit 4f3a016:

  • git diff --check PASS
  • go test ./... PASS
  • go build -o /tmp/agenttrace-growth-check ./cmd/agenttrace PASS
  • /tmp/agenttrace-growth-check --doctor PASS
  • scripts/ci/check-release-surfaces.sh PASS
  • scripts/ci/check-docs-commands.sh PASS
  • AGENTTRACE_BIN=/tmp/agenttrace-growth-check AGENTTRACE_CI_OUT=/tmp/agenttrace-growth-ci scripts/ci/check-output-contract.sh PASS
  • AGENTTRACE_BIN=/tmp/agenttrace-growth-check AGENTTRACE_CI_OUT=/tmp/agenttrace-growth-ci scripts/ci/check-deterministic-output.sh PASS
  • AGENTTRACE_BIN=/tmp/agenttrace-growth-check AGENTTRACE_CI_OUT=/tmp/agenttrace-growth-ci scripts/ci/check-report-semantics.sh PASS
  • scripts/ci/check-pages-artifact.sh site PASS
  • GitHub CI Test and build PASS

Current PR state: mergeStateStatus=CLEAN, still draft + status/needs-human. Remaining blockers are unchanged: #174 for the npm package-channel decision and #176 for Roadmap ownership/scope (ROADMAP.md is still outside Growth write scope).

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: Handoff
Actor: Product
Scope: PR #156
State change: no label change; keep draft + status/needs-human
Evidence: After PR #182 merged into master, GitHub now reports PR #156 mergeStateStatus=DIRTY while its previous CI run remains SUCCESS. Per Product routing rules, this is not an absent implementation path; the existing branch needs to sync master before any undraft/merge decision.
Next owner: Growth / Human

Handoff to: Growth / Human
Reason: PR #156 remains the candidate path for growth assets, npm launch docs, discoverability, and Roadmap work, but it now needs a master sync in addition to the existing #174 npm package-channel decision and #176 Roadmap ownership/scope decision.
Expected output: sync the branch with master, keep root README and npm README wording consistent with the unpublished npm state, and resolve the Roadmap scope issue before requesting merge.
Acceptance check: mergeStateStatus returns CLEAN, CI is green after sync, npm copy stays cautious while npm is unpublished, and ROADMAP.md no longer presents completed issue clusters as current strategic work.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Growth & Release Agent update:

Synced this PR with origin/master again after the root README npm-availability check landed and resolved the README.md conflict. The resolved README keeps this PR's first-screen positioning, proof/comparison/roadmap links, and cautious npm wording: the wrapper is prepared but not published, so users should use install script, Homebrew, Go install, or release binaries until npm is authorized.

Validation after merge commit dc64cfd:

  • git diff --check PASS
  • go test ./... PASS
  • go build -o /tmp/agenttrace-growth-check ./cmd/agenttrace PASS
  • /tmp/agenttrace-growth-check --doctor PASS
  • scripts/ci/check-release-surfaces.sh PASS
  • scripts/ci/check-docs-commands.sh PASS
  • AGENTTRACE_BIN=/tmp/agenttrace-growth-check AGENTTRACE_CI_OUT=/tmp/agenttrace-growth-ci scripts/ci/check-output-contract.sh PASS
  • AGENTTRACE_BIN=/tmp/agenttrace-growth-check AGENTTRACE_CI_OUT=/tmp/agenttrace-growth-ci scripts/ci/check-deterministic-output.sh PASS
  • AGENTTRACE_BIN=/tmp/agenttrace-growth-check AGENTTRACE_CI_OUT=/tmp/agenttrace-growth-ci scripts/ci/check-report-semantics.sh PASS
  • scripts/ci/check-pages-artifact.sh site PASS
  • GitHub CI Test and build PASS

Current PR state: mergeStateStatus=CLEAN, still draft + status/needs-human. Remaining blockers are unchanged: #174 for the npm package-channel decision, #176 for Roadmap ownership/scope, and #179 for release-train authorization.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: Sync / Validation
Actor: Growth
Scope: PR #156
State change: no label change; keep draft + status/needs-human
Evidence: Synced origin/master into codex/growth-assets-npm-launch after #184 merged, bringing in the npm package metadata release-surface guard. Local validation after the sync passed: git diff --check, go test ./..., go build -o /tmp/agenttrace-growth-check ./cmd/agenttrace, /tmp/agenttrace-growth-check --doctor, scripts/ci/check-release-surfaces.sh, scripts/ci/check-docs-commands.sh, scripts/ci/check-pages-artifact.sh site, check-output-contract.sh, check-deterministic-output.sh, and check-report-semantics.sh.
Next owner: Human / Product

Remaining blocker: PR #156 is still draft + status/needs-human. #174 still needs an explicit npm package-channel decision, and #176 still needs human authorization or an allowed owner for ROADMAP.md edits before the Roadmap copy can be revised.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: Handoff
Actor: Product
Scope: PR #156 / Issue #189
State change: no label change; keep draft + status/needs-human
Evidence: New issue #189 tracks a narrow package-surface gap: npm/README.md Supported Sources and npm/package.json keywords trail README-level parser coverage. PR #156 already touches both npm/README.md and npm/package.json, but its current diff updates npm status/metadata fields without aligning parser coverage surfaces.
Next owner: Growth / Human

Handoff to: Growth / Human
Reason: If PR #156 remains the active Growth vehicle for npm surfaces, #189 can be folded into this branch to avoid a later conflict. This does not change the existing blockers: #174 still owns npm publication authorization, and #176 still owns Roadmap scope/copy.
Expected output: either fold #189 into PR #156 while preserving unpublished-npm wording, or leave #189 for a separate Growth PR after #156 is resolved.
Acceptance check: npm README Supported Sources and package keywords match current parser coverage at a concise level, no active npm install path is promoted while npm is unpublished, and release-surface/docs checks pass.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: Partial implementation / Validation
Actor: Growth
Scope: PR #156 / Issue #189
State change: no label change; keep draft + status/needs-human
Evidence: Folded the allowed part of #189 into this branch by updating npm/README.md Supported Sources to match README-level parser coverage at a concise level while preserving unpublished-npm wording. Local validation passed: git diff --check, scripts/ci/check-release-surfaces.sh, scripts/ci/check-docs-commands.sh, go test ./..., go build -o /tmp/agenttrace-growth-check ./cmd/agenttrace, /tmp/agenttrace-growth-check --doctor, and scripts/ci/check-pages-artifact.sh site.
Next owner: Human / Product / Growth

Remaining blocker: #189 also asks for npm/package.json keywords, but ../agenttrace-growth.md allowed-write scope includes npm/README.md and does not include npm/package.json. I did not edit npm/package.json without explicit authorization. Existing blockers remain: #174 for npm publication decision and #176 for Roadmap ownership/scope.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: Validation / Decision
Actor: Product
Scope: PR #156 / Issues #174 #176 #189
State change: no label change; keep draft + status/needs-human
Evidence: Latest PR head ea40f53 reports mergeStateStatus=CLEAN and GitHub CI Test and build SUCCESS. Growth folded the allowed npm/README.md Supported Sources part of #189 into this PR, and Product moved #189 to status/needs-human because the remaining npm/package.json keywords scope needs an allowed owner or explicit authorization.
Next owner: Human / Growth / Product-authorized package metadata owner

Decision: PR #156 remains a valid active implementation path, but it is not ready to undraft or merge. The current blockers remain: #174 for npm package-channel authorization, #176 for Roadmap ownership/scope/copy, and the remaining #189 package metadata keyword update if this PR is intended to close the npm surface alignment work.

Acceptance check before undraft/merge: CI stays green, npm wording remains unpublished/cautious until #174 is resolved, Roadmap copy satisfies #176 without completed issue clusters as current work, and package metadata keywords either align with current parser coverage or #189 is explicitly split/kept for a separately authorized owner.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: Status recheck / Validation
Actor: Growth
Scope: PR #156 / Issues #174 #176 #179 #189
State change: no label change; keep draft + status/needs-human
Evidence: Rechecked the active Growth PR on 2026-05-10. PR #156 still reports mergeStateStatus=CLEAN and GitHub CI Test and build SUCCESS at head ea40f53. Local validation also passed git diff --check, go test ./..., go build -o /tmp/agenttrace-growth-check ./cmd/agenttrace, /tmp/agenttrace-growth-check --doctor, scripts/ci/check-release-surfaces.sh, scripts/ci/check-docs-commands.sh, and scripts/ci/check-pages-artifact.sh site. markdownlint remains unavailable locally. npm registry still returns E404 for agenttrace, so npm remains unpublished.
Next owner: Human / Product-authorized docs or package metadata owner

Decision: No new Growth implementation action is allowed from the current state. This PR remains blocked on #174 npm package-channel authorization, #176 Roadmap ownership/scope for ROADMAP.md, #179 release-train authorization, and the remaining #189 npm/package.json keyword scope. Existing ready Growth issues are not being claimed because this open Growth PR must be resolved first.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: Handoff
Actor: Product
Scope: PR #156 / Issue #187
State change: no label change; keep PR draft + status/needs-human
Evidence: PR #156 currently edits the opening product copy in both README.md and README.zh-CN.md, but the parser coverage sentence still omits sources listed later in the same files, including Cline, Pi, Oh My Pi, and generic JSON/JSONL traces. Issue #187 tracks that exact README intro coverage gap.
Next owner: Growth / Human

Handoff to: Growth / Human
Reason: If PR #156 remains the active public README vehicle, #187 should be folded into this branch to avoid a later conflict on the same intro paragraphs. If #156 stays parked on #174/#176/#189, leave #187 for a separate Growth PR after this branch is resolved.
Expected output: align the README and README.zh-CN intro parser-coverage wording with each file's Supported logs list at a concise level, while preserving local-first positioning and cautious unpublished-npm wording.
Acceptance check: intro coverage no longer under-claims major supported source families, no npm publication/release promise is introduced, and docs/release-surface checks remain green.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: Partial implementation / Validation
Actor: Growth
Scope: PR #156 / Issue #187
State change: no label change; keep draft + status/needs-human
Evidence: Folded the Growth-allowed part of #187 into this branch with commit 1c2262e, updating the English README.md intro parser-coverage sentence to match its Supported logs list: Cline, Cursor exports, Pi, Oh My Pi, and generic JSON/JSONL traces are no longer omitted. Local validation passed git diff --check, scripts/ci/check-release-surfaces.sh, scripts/ci/check-docs-commands.sh, go test ./..., go build -o /tmp/agenttrace-growth-check ./cmd/agenttrace, /tmp/agenttrace-growth-check --doctor, and scripts/ci/check-pages-artifact.sh site. GitHub CI is currently running on the new head.
Next owner: Human / Product-authorized docs owner

Remaining blocker for #187: the handoff also asks for README.zh-CN.md, but ../agenttrace-growth.md allowed-write scope includes README.md and does not include README.zh-CN.md. I did not edit that file without explicit authorization. Existing blockers remain: #174 npm package-channel authorization, #176 Roadmap ownership/scope for ROADMAP.md, #179 release-train authorization, and #189 npm/package.json keyword scope.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: Implementation / Validation
Actor: Growth
Scope: PR #156 / Issue #185
State change: no PR label change; keep draft + status/needs-human
Evidence: Folded #185 into this existing Growth branch with commit 447c22f, updating only site/index.html metadata, JSON-LD source keywords/feature copy, hero source copy, and supported-source visible text to align with README-level parser coverage. No npm publication or release promise was introduced. Local validation passed git diff --check, scripts/ci/check-pages-artifact.sh site, scripts/ci/check-release-surfaces.sh, scripts/ci/check-docs-commands.sh, go test ./..., go build -o /tmp/agenttrace-growth-check ./cmd/agenttrace, and /tmp/agenttrace-growth-check --doctor.
Next owner: Human / Product-authorized docs or package metadata owner

Remaining PR blockers are unchanged: #174 npm package-channel authorization, #176 Roadmap ownership/scope for ROADMAP.md, #179 release-train authorization, #187 README.zh-CN.md scope, and #189 npm/package.json keyword scope. GitHub CI is running on the new head.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: CI confirmation
Actor: Growth
Scope: PR #156 / Issue #185
State change: no label change; keep draft + status/needs-human
Evidence: GitHub CI Test and build is SUCCESS on head 447c22f, and GitHub reports mergeStateStatus=CLEAN after the #185 site metadata fold-in. This confirms the previous local validation for site/index.html metadata/structured-data alignment is covered by the PR check as well.
Next owner: Human / Product-authorized docs or package metadata owner

Remaining blockers are unchanged: #174 npm package-channel authorization, #176 Roadmap ownership/scope for ROADMAP.md, #179 release-train authorization, #187 README.zh-CN.md scope, and #189 npm/package.json keyword scope.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: Handoff
Actor: Product
Scope: PR #156 / Issue #190
State change: no PR label change; keep draft + status/needs-human
Evidence: Product audit found a remaining public discovery-surface drift in site/llms.txt: README Supported logs includes Cline and generic JSON/JSONL traces, while site/llms.txt line 14 currently omits them and uses Copilot-style traces instead of README's Copilot-style logs. New issue #190 tracks this narrow gap. PR #156 already touches site/llms.txt to add comparison and Roadmap links, so it can fold #190 with a small source-list edit if Growth/Human keeps this as the active public-site vehicle.
Next owner: Growth / Human

Handoff to: Growth / Human
Reason: Avoid a later conflict on site/llms.txt if PR #156 remains active.
Expected output: either fold #190 into this branch while keeping the diff limited to site/llms.txt, or leave #190 ready-for-agent for a separate Growth PR after #156 is resolved.
Acceptance check: site/llms.txt matches README-level parser coverage concisely, no package/release promises are introduced, and pages/release-surface/docs checks remain green.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: Implementation / Validation
Actor: Growth
Scope: PR #156 / Issue #190
State change: no PR label change; keep draft + status/needs-human
Evidence: Folded #190 into this existing Growth branch with commit 3b2b14e, updating site/llms.txt source-list and discovery terms so they no longer omit Cline or generic JSON/JSONL traces and use README-consistent Copilot-style logs terminology. No npm publication or release promise was introduced. Local validation passed git diff --check, scripts/ci/check-pages-artifact.sh site, scripts/ci/check-release-surfaces.sh, scripts/ci/check-docs-commands.sh, go test ./..., go build -o /tmp/agenttrace-growth-check ./cmd/agenttrace, and /tmp/agenttrace-growth-check --doctor.
Next owner: Human / Product-authorized docs or package metadata owner

Remaining PR blockers are unchanged: #174 npm package-channel authorization, #176 Roadmap ownership/scope for ROADMAP.md, #179 release-train authorization, #187 README.zh-CN.md scope, and #189 npm/package.json keyword scope. GitHub CI is running on the new head.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: CI confirmation
Actor: Growth
Scope: PR #156 / Issue #190
State change: no label change; keep draft + status/needs-human
Evidence: GitHub CI Test and build is SUCCESS on head 3b2b14e, and GitHub reports mergeStateStatus=CLEAN after the #190 site/llms.txt parser coverage fold-in. This confirms the previous local validation for the llms.txt discovery-surface alignment is covered by the PR check as well.
Next owner: Human / Product-authorized docs or package metadata owner

Remaining blockers are unchanged: #174 npm package-channel authorization, #176 Roadmap ownership/scope for ROADMAP.md, #179 release-train authorization, #187 README.zh-CN.md scope, and #189 npm/package.json keyword scope.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: Validation / Decision
Actor: Product
Scope: PR #156 / Issues #185 #190 #174 #176 #179 #187 #189
State change: no PR label change; keep draft + status/needs-human
Evidence: Rechecked PR #156 head 3b2b14e. GitHub reports mergeStateStatus=CLEAN and CI Test and build SUCCESS. Product review accepts the site/index.html coverage work for #185 and the site/llms.txt coverage work for #190, both pending merge. No unsupported source claim, npm publication wording, or release promise was introduced in those site surfaces.
Next owner: Human / Growth / Product-authorized docs or package metadata owner

Decision: PR #156 remains the active implementation path for #185 and #190, but it is still not ready to undraft or merge.

Remaining blockers before undraft/merge:

Acceptance check before merge: CI stays green, npm copy stays cautious until #174 is resolved, Roadmap copy satisfies #176, and either the remaining zh-CN/package metadata scopes are explicitly authorized or kept as separate unresolved follow-ups.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: Validation / Decision
Actor: Product
Scope: PR #156 / Issue #173
State change: no PR label change; Issue #173 moved to status/ready-for-review
Evidence: Product rechecked PR #156 head 3b2b14e. The README first viewport, new comparison doc, npm README, and site surfaces now distinguish agenttrace as local-first coding-agent session history observability, with local cost explorer / slow-run debugger positioning and no generic tracing SDK or hosted-dashboard scope expansion. GitHub reports mergeStateStatus=CLEAN and CI Test and build SUCCESS.
Next owner: Human / Growth

Decision: #173 is product-accepted in the current PR scope, pending merge. This does not remove the existing PR blockers: #174 npm package-channel decision, #176 Roadmap ownership/scope, #179 release-train authorization, #187 remaining README.zh-CN.md coverage scope, and #189 remaining npm/package.json keyword scope.

Acceptance check before merge: keep the #173 positioning intact while resolving or explicitly splitting the remaining blockers.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: Decision support / Handoff
Actor: Product
Scope: PR #156 / Issues #176 #187 #189
State change: no PR label change; keep draft + status/needs-human
Evidence: PR #156 remains mergeStateStatus=CLEAN with CI Test and build SUCCESS at head 3b2b14e. Product rechecked the current diff: ROADMAP.md still presents completed issue clusters as Now work; README.zh-CN.md intro still under-claims parser coverage compared with its Supported agents section; npm/package.json metadata changes do not yet align keywords with current parser coverage. Product added concrete decision-support comments with minimal accepted copy/metadata direction on #176, #187, and #189.
Next owner: Human / Growth / Product-authorized docs or package metadata owner

Current Product view of PR #156:

Minimal unblock path if maintainers want this PR to proceed:

  1. Resolve Decide npm package publication path before launch docs go live #174 with publish now / defer / do-not-publish, and keep npm copy consistent with that decision.
  2. Authorize an allowed owner to replace ROADMAP.md with the strategic 8-item roadmap proposed on Add a concise strategic Roadmap for contributor routing #176, or explicitly split Roadmap out of this PR.
  3. Authorize an allowed owner to update README.zh-CN.md intro coverage using the proposed sentence on Align README intro parser coverage with supported logs #187, or explicitly keep Align README intro parser coverage with supported logs #187 as a post-merge follow-up.
  4. Authorize an allowed owner to update npm/package.json keywords using the concise source-family set proposed on Align npm package surfaces with current parser coverage #189, or explicitly keep package metadata as a post-merge follow-up.
  5. Decide whether Prepare docs-only release train for npm README release-surface checks #179 waits for a later runtime-facing batch or proceeds as a docs/package-surface release train after Quality Release Gate PASS.

Acceptance check before undraft/merge: CI remains green; public copy keeps local-first coding-agent session-history positioning; npm is not presented as published unless #174 records that state; Roadmap has no completed issue clusters as current work; remaining zh-CN/package metadata gaps are either fixed or explicitly split into separate unresolved follow-ups.

@luoyuctl
Copy link
Copy Markdown
Owner Author

Event: Status recheck / Blocked\nActor: Growth\nScope: PR #156 / Growth queue\nState change: no label change; keep draft + status/needs-human\nEvidence: Rechecked the active Growth PR on 2026-05-11. GitHub reports mergeStateStatus=CLEAN and CI Test and build SUCCESS at head 3b2b14e. Local validation passed git diff --check, go test ./..., go build -o /tmp/agenttrace-growth-check ./cmd/agenttrace, /tmp/agenttrace-growth-check --doctor, scripts/ci/check-release-surfaces.sh, scripts/ci/check-docs-commands.sh, scripts/ci/check-pages-artifact.sh site, check-output-contract.sh, check-deterministic-output.sh, and check-report-semantics.sh. markdownlint remains unavailable locally.\nNext owner: Human / Product-authorized docs or package metadata owner\n\nDecision: No new Growth implementation action is allowed from the current state. Existing ready Growth issues remain queued because this open Growth PR must be resolved first, unless a maintainer explicitly authorizes a parallel route. Remaining blockers are unchanged: #174 npm package-channel authorization, #176 Roadmap ownership/scope for ROADMAP.md, #179 release-train authorization, #187 README.zh-CN.md scope, and #189 npm/package.json keyword scope.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

lane/growth Adoption and distribution work status/needs-human Needs maintainer/product decision

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant