{
  "id": "page:docs-generated-cli-examples-verification",
  "_kind": "Page",
  "_file": "wiki/docs/generated/cli-examples-verification.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/generated/cli-examples-verification.md",
    "sourceKind": "repo-docs",
    "title": "CLI Example Verification Index",
    "displayName": "CLI Example Verification Index",
    "slug": "docs/generated/cli-examples-verification",
    "articlePath": "wiki/docs/generated/cli-examples-verification.md",
    "article": "\n# CLI Example Verification Index\n\nGenerated by `scripts/generate-cli-examples-artifacts.cjs`.\nLast refreshed: 2026-06-07.\n\nPublished surfaces: `docs/cli-examples.md`, `packages/babysitter-sdk/src/testing/README.md`, and `library/reference/sdk.md`.\n\n## Canonical Workflow\n\n| Step | Command | Implementation | Artifact |\n| --- | --- | --- | --- |\n| Install workspace dependencies from a fresh checkout | `npm ci` | `package-lock.json` | `node_modules/` |\n| Build the SDK CLI used by the smoke harness | `npm run build --workspace=@a5c-ai/babysitter-sdk` | `packages/babysitter-sdk/package.json#scripts.build` | `packages/babysitter-sdk/dist/` |\n| Generate repo docs artifacts, including this traceability index | `npm run docs:prepare` | `package.json#scripts.docs:prepare` | `docs/generated/cli-examples-verification.md` |\n| Run the real CLI smoke harness | `npm run docs:examples:smoke` | `package.json#scripts.docs:examples:smoke` | `packages/babysitter-sdk/test-fixtures/cli/runs/smoke/` |\n| Validate fenced code samples and command references in staged docs | `npm run docs:snippets` | `package.json#scripts.docs:snippets` | `artifacts/docs-qa/docs-code-samples-report.json` |\n| Run the full docs quality suite | `npm run docs:qa` | `package.json#scripts.docs:qa` | `artifacts/docs-qa/` |\n\n## Verification Matrix\n\n| Docs Surface | Verification Command | Backing Implementation | Reviewable Evidence |\n| --- | --- | --- | --- |\n| CLI walkthrough command flow in docs/cli-examples.md | `npm run docs:examples:smoke` | `packages/babysitter-sdk/scripts/smoke-cli.js` | `packages/babysitter-sdk/test-fixtures/cli/runs/smoke/` |\n| Repo-published command references and fenced examples | `npm run docs:snippets` | `scripts/docs-code-samples-check.cjs` | `artifacts/docs-qa/docs-code-samples-report.json` |\n| Markdown/style validation for published docs | `npm run docs:lint` | `package.json#scripts.docs:lint` | `stdout/stderr from markdownlint-cli2 and docs-style-check.cjs` |\n| Deterministic SDK harness APIs referenced from docs | `npm run test --workspace=@a5c-ai/babysitter-sdk` | `packages/babysitter-sdk/package.json#scripts.test` | `packages/babysitter-sdk/src/testing/__tests__/runHarness.test.ts, packages/babysitter-sdk/src/testing/__tests__/parallelHarness.test.ts, packages/babysitter-sdk/src/runtime/__tests__/deterministicHarness.test.ts` |\n| Generated CLI/docs traceability inventory | `npm run docs:examples:generate` | `scripts/generate-cli-examples-artifacts.cjs` | `docs/generated/cli-examples-verification.{md,json}` |\n\n## Script Inventory\n\n### Root Scripts\n\n| Script | Command |\n| --- | --- |\n| build:runtime | `npm run build:runtime:genty-platform-deps && npm run build --workspace=@a5c-ai/genty-platform` |\n| docs:prepare | `node ./scripts/generate-process-library-doc-artifacts.cjs && node ./scripts/generate-cli-examples-artifacts.cjs && node ./scripts/ensure-webpackbar-patch.cjs` |\n| docs:examples:generate | `node ./scripts/generate-cli-examples-artifacts.cjs` |\n| docs:examples:smoke | `npm run smoke:cli --workspace=@a5c-ai/babysitter-sdk` |\n| docs:examples:verify | `npm run build --workspace=@a5c-ai/babysitter-sdk && npm run docs:prepare && npm run docs:examples:smoke && npm run docs:qa` |\n| docs:lint | `npm run docs:lint:markdown && npm run docs:lint:style` |\n| docs:snippets | `node ./scripts/docs-code-samples-check.cjs` |\n| docs:qa | `npm run docs:lint && npm run docs:snippets && npm run docs:links && npm run docs:freshness` |\n\n### SDK Scripts\n\n| Script | Command |\n| --- | --- |\n| build | `tsc --build tsconfig.json && node scripts/copy-template-assets.cjs` |\n| test | `vitest run` |\n| smoke:cli | `node scripts/smoke-cli.js --runs-dir packages/babysitter-sdk/test-fixtures/cli/runs/smoke` |\n\n## Smoke Harness Contract\n\n- Command: `npm run smoke:cli --workspace=@a5c-ai/babysitter-sdk`\n- Implementation: `packages/babysitter-sdk/scripts/smoke-cli.js`\n- Default runs directory: `packages/babysitter-sdk/test-fixtures/cli/runs/smoke`\n- Supported flags: `--runs-dir`, `--cli`, `--keep`\n\n## Notes\n\n- The current CLI smoke harness does not publish a --record baseline surface.\n- The current repo does not define docs:testing-readme or docs:snippets:* package-local scripts.\n- The CLI/example verification path only requires the SDK build; it does not depend on the broader build:runtime umbrella command.\n- Use docs:examples:verify for the end-to-end repo workflow that combines docs generation, smoke verification, and docs QA.\n\n## Source Files\n\n- `package.json`\n- `packages/babysitter-sdk/package.json`\n- `packages/babysitter-sdk/scripts/smoke-cli.js`\n- `scripts/docs-code-samples-check.cjs`\n- `scripts/docs-style-check.cjs`\n- `scripts/docs-freshness-report.cjs`\n- `docs/cli-examples.md`\n- `packages/babysitter-sdk/src/testing/README.md`\n- `library/reference/sdk.md`\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs",
      "to": "page:docs-generated-cli-examples-verification",
      "kind": "contains_page"
    }
  ]
}