[codex] Add AgentOps metadata consistency quality gate

[ootakazuhiko]

Summary

• Add a stdlib-only metadata/navigation consistency check for book-config.json, package.json, Jekyll config, front matter, navigation, and public assets.
• Add the check to local npm test and Book QA, and document it in the README.
• Keep generated docs/ metadata stable by updating the root index source and build config generator.
• Refresh production lockfile transitive versions for minimatch / brace-expansion so npm audit --omit=dev --omit=optional is clean.

Validation

• npm ci
• npm run check:metadata
• npm test
• npm audit --omit=dev --omit=optional
• git diff --check
• CI-pinned itdojp/book-formatter@da2a49e7d2dcd9e1fa885e910c458130fe8d73a4 checks: unicode, textlint, internal links, layout risk, markdown structure
• Jekyll build from docs/ and built-site smoke for top, chapter 01, chapter 11, and appendix B
• Negative fixtures: package homepage drift, missing navigation target, duplicate navigation target; CRLF front matter positive fixture

Part of itdojp/it-engineer-knowledge-architecture#167

[ootakazuhiko]

@copilot review

[ootakazuhiko]

@copilot review

[Copilot]

@copilot review

Reviewed the latest PR state (commit d243ce0). Local validation is passing (npm test), and I did not find additional actionable issues to change in this branch.

[ootakazuhiko]

レビュー本文・インラインコメント・review thread を確認しました。

• Copilot SWE agent の本文コメントは「最新 PR 状態で追加の actionable issue はない」という確認内容でした。
• check_pr_review_completeness.py --repo itdojp/GitHub-AgentOps-book --pr 50 --format json は status=ok、unresolved_threads=0、review_comments=0、review_threads=0 でした。
• PR head d243ce0 の CI は qa / test / docs-forbidden がすべて成功しています。

そのため、レビュー起因の追加修正は不要と判断します。

[Copilot]

@copilot review

Re-reviewed the branch at d243ce0. After reinstalling deps (npm ci), npm test passes and I don’t see additional actionable fixes to apply.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d243ce0708

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

メタデータ検証をビルド後にも実行する

npm test では check:metadata が build:validate より前に実行されるため、build:validate 内の npm run build が docs/ を再生成した後の成果物はこの新しい整合性ゲートで検証されません。scripts/build-simple.js や src/ の変更で生成後の docs/_config.yml、front matter、navigation が不整合になっても、事前に存在していた docs/ が通っていればローカルの品質ゲートは検出できないため、少なくともビルド後に check:metadata を実行する順序にする必要があります。

Useful? React with 👍 / 👎.

[Copilot]

Pull request overview

Adds a stdlib-only quality gate to keep published book metadata and navigation consistent across book-config.json, package.json, Jekyll config, front matter, navigation, and required public assets—then wires it into local and CI checks.

Changes:

• Add scripts/check-metadata-consistency.js and expose it as npm run check:metadata.
• Extend the build generator to emit homepage / repository_url in docs/_config.yml, and align metadata fields across config/front matter.
• Run the new check in npm test and in Book QA workflow; refresh lockfile transitive versions.

Reviewed changes

Copilot reviewed 9 out of 10 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
scripts/check-metadata-consistency.js	New stdlib-only metadata/navigation/assets consistency checker for published docs/.
scripts/build-simple.js	Emit homepage and repository_url in generated Jekyll config.
README.md	Document the new metadata/navigation consistency check in local quality gate section.
package.json	Add check:metadata script and integrate it into npm test; add bugs + homepage metadata.
package-lock.json	Update transitive versions for brace-expansion / minimatch.
index.md	Add description/author/version to top-page front matter (source).
docs/index.md	Add description/author/version to published top-page front matter.
docs/_config.yml	Add homepage and repository_url keys.
book-config.json	Add homepage and repository to book metadata.
.github/workflows/book-qa.yml	Run npm run check:metadata as part of Book QA.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.