> For the complete documentation index, see [llms.txt](https://faction-os.gitbook.io/faction-os-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://faction-os.gitbook.io/faction-os-docs/.spec_system/archive/sessions/phase12-session01-codex-plugin-packaging/implementation-notes.md). # Implementation Notes **Session ID**: `phase12-session01-codex-plugin-packaging` **Package**: Cross-cutting **Started**: 2026-05-31 17:23 **Last Updated**: 2026-05-31 17:34 *** ## Session Progress | Metric | Value | | ------------------- | ------- | | Tasks Completed | 23 / 23 | | Estimated Remaining | 0 hours | | Blockers | 0 | *** ### Task T023 - Finalize session handoff **Started**: 2026-05-31 17:33 **Completed**: 2026-05-31 17:34 **Duration**: 1 minute **Notes**: * Created the implementation summary. * Marked all tasks and completion checklist items complete. * Final handoff to Session 02: plugin packaging is deferred, direct user-level Codex hooks remain supported, and plugin install/cache/trust/uninstall are not claimed. **Files Changed**: * `.spec_system/specs/phase12-session01-codex-plugin-packaging/IMPLEMENTATION_SUMMARY.md` - Added session closeout summary. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T023 and completion checklist complete. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Logged final handoff and updated progress. **BQC Fixes**: * N/A - session finalization only. *** ### Task T022 - Run format, lint, diff, ASCII/LF, and sensitive review **Started**: 2026-05-31 17:32 **Completed**: 2026-05-31 17:33 **Duration**: 1 minute **Notes**: * Root Biome format check passed. * Root Biome lint passed. * `git diff --check` passed. * ASCII and LF checks passed for touched docs and session artifacts. * Sensitive-string review found only negative-policy wording such as "must not log raw prompts" and API route examples; no token-like values, raw payload evidence, temp homes, or broad local paths were found. **Commands**: * `npm run format:check` * `npm run lint` * `git diff --check` * Targeted ASCII/LF and sensitive-string shell scan over touched files. **Files Changed**: * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T022 complete and updated progress. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Logged quality gate results. **BQC Fixes**: * Error information boundaries: reviewed touched artifacts for sensitive-string and raw-payload leakage. *** ### Task T021 - Verify plugin validation is not overclaimed **Started**: 2026-05-31 17:32 **Completed**: 2026-05-31 17:32 **Duration**: <1 minute **Notes**: * Verified no plugin manifest exists, so plugin manifest validation is N/A. * Scanned touched docs and session artifacts for passed plugin-package validation claims. * Updated the validation plan with the N/A result. **Commands**: * `if [ -e .codex-plugin/plugin.json ]; then ...; else printf 'plugin-manifest=absent; plugin-validation=n/a\n'; fi` * `rg -n "plugin install.*Pass|plugin cache.*Pass|plugin trust.*Pass|plugin uninstall.*Pass|plugin-validation=passed|plugin package.*passed" ...` **Files Changed**: * `.spec_system/specs/phase12-session01-codex-plugin-packaging/codex-plugin-validation-plan.md` - Added manifest N/A and no-overclaim scan result. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T021 complete and updated progress. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Logged plugin validation no-overclaim check. **BQC Fixes**: * Failure path completeness: plugin package validation is recorded as N/A, not passed. *** ### Task T020 - Run focused CLI and hooks tests **Started**: 2026-05-31 17:31 **Completed**: 2026-05-31 17:31 **Duration**: <1 minute **Notes**: * Focused Codex installer and hook-map tests passed. * No installer or hook runtime code changed; tests confirm the direct-hook baseline still holds. **Commands**: * `npx vitest run apps/cli/tests/codexInstaller.test.js apps/hooks/tests/codexHookMap.test.js` **Results**: * Test files: 2 passed. * Tests: 20 passed. **Files Changed**: * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T020 complete and updated progress. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Logged focused test result. **BQC Fixes**: * N/A - test execution only. *** ### Task T019 - Update implementation notes with branch closeout **Started**: 2026-05-31 17:57 **Completed**: 2026-05-31 17:59 **Duration**: 2 minutes **Notes**: * Added selected branch, rationale, docs touched, open questions closed, carried-forward reconsideration criteria, and privacy review. * Confirmed branch evidence is no-manifest deferral. **Files Changed**: * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Added selected branch closeout details and task log. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T019 complete and updated progress. **BQC Fixes**: * Error information boundaries: privacy review explicitly limits tracked evidence fields and excludes sensitive Codex-shaped values. *** ### Task T018 - Record branch validation evidence **Started**: 2026-05-31 17:54 **Completed**: 2026-05-31 17:57 **Duration**: 3 minutes **Notes**: * Added deferral evidence to the validation plan. * Recorded plugin install, cache refresh, plugin trust review, and plugin uninstall as N/A because no plugin package exists. * Recorded artifact absence without raw local paths. **Files Changed**: * `.spec_system/specs/phase12-session01-codex-plugin-packaging/codex-plugin-validation-plan.md` - Added deferral evidence. * `README.md` - Updated high-level Codex plugin deferral wording. * `docs/README_docs.md` - Updated docs routing for the finalized Session 01 decision. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T018 complete and updated progress. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Logged validation evidence. **BQC Fixes**: * Failure path completeness: validation plan marks plugin checks N/A and does not represent skipped plugin validation as passed. *** ### Task T017 - Update developer workflow notes **Started**: 2026-05-31 17:53 **Completed**: 2026-05-31 17:54 **Duration**: 1 minute **Notes**: * Updated development docs to treat plugin packaging as explicitly deferred. * Preserved the direct hook workflow and manual `/hooks` trust-review guidance. * Avoided any hosted auth, telemetry, remote execution, or trusted-erasure claims. **Files Changed**: * `docs/development.md` - Added selected branch workflow note. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T017 complete and updated progress. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Logged developer docs update. **BQC Fixes**: * Error information boundaries: docs warn not to claim plugin validation unless a later isolated validation exists. *** ### Task T016 - Update hook contract docs **Started**: 2026-05-31 17:52 **Completed**: 2026-05-31 17:53 **Duration**: 1 minute **Notes**: * Updated the Codex CLI hook contract with explicit Phase 12 Session 01 deferral wording. * Preserved direct user-level hooks as the only supported Codex install surface for this release. * Added no-claim wording for plugin manifest, marketplace, cache, trust, and uninstall validation. **Files Changed**: * `docs/api/event-api-hook-contracts.md` - Added selected-branch install-surface wording. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T016 complete and updated progress. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Logged hook contract docs update. **BQC Fixes**: * Contract alignment: API contract now matches the deferral branch and avoids unsupported plugin claims. *** ### Task T015 - Update hook package docs **Started**: 2026-05-31 17:50 **Completed**: 2026-05-31 17:52 **Duration**: 2 minutes **Notes**: * Updated hook docs with Phase 12 Session 01 deferral wording. * Added current plugin-bundled hook trust-review behavior from OpenAI docs. * Added future plugin reuse boundaries requiring the same hook map, handlers, and redaction helpers. **Files Changed**: * `apps/hooks/README_hooks.md` - Clarified plugin deferral, plugin trust behavior, and reuse boundaries. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T015 complete and updated progress. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Logged hook docs update. **BQC Fixes**: * Trust boundary enforcement: docs now state plugin-bundled hooks still require `/hooks` review and are not automatically trusted. *** ### Task T014 - Update CLI docs for baseline and deferral **Started**: 2026-05-31 17:47 **Completed**: 2026-05-31 17:50 **Duration**: 3 minutes **Notes**: * Updated CLI docs to state that Phase 12 Session 01 explicitly defers plugin packaging. * Preserved direct user-level Codex hooks plus `/hooks` review as the supported path. * Removed wording that made plugin packaging sound like an unresolved phase question. **Files Changed**: * `apps/cli/README_cli.md` - Clarified direct Codex hook support and plugin deferral. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T014 complete and updated progress. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Logged CLI docs update. **BQC Fixes**: * Contract alignment: docs now match the selected branch and avoid claiming plugin packaging support. *** ### Task T013 - Implement selected deferral branch artifact **Started**: 2026-05-31 17:45 **Completed**: 2026-05-31 17:47 **Duration**: 2 minutes **Notes**: * Verified no plugin package artifacts exist in the repository. * Recorded explicit no-manifest deferral in the decision record. * Did not create `.codex-plugin/`, `.agents/plugins/marketplace.json`, or `plugins/`. **Commands**: * `find . -maxdepth 3 \( -path './.codex-plugin' -o -path './.agents/plugins/marketplace.json' -o -path './plugins' \) -print` * `test ! -e .codex-plugin && test ! -e .agents/plugins/marketplace.json && test ! -e plugins` **Files Changed**: * `.spec_system/specs/phase12-session01-codex-plugin-packaging/codex-plugin-packaging-decision.md` - Added no-manifest branch artifact. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T013 complete and updated progress. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Logged selected branch artifact. **BQC Fixes**: * State freshness on re-entry: branch artifact is based on current repository state and records plugin validation as N/A instead of passed. *** ### Task T012 - Record final packaging decision and handoff **Started**: 2026-05-31 17:44 **Completed**: 2026-05-31 17:45 **Duration**: 1 minute **Notes**: * Finalized the defer decision. * Added release implications, known limitations, and Session 02 no-overclaim boundaries. **Files Changed**: * `.spec_system/specs/phase12-session01-codex-plugin-packaging/codex-plugin-packaging-decision.md` - Added release implications and known limitations. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T012 complete and updated progress. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Logged final decision handoff. **BQC Fixes**: * Failure path completeness: decision record explains what is claimed and what is not claimed for release closeout. *** ### Task T011 - Evaluate Codex plugin value **Started**: 2026-05-31 17:43 **Completed**: 2026-05-31 17:44 **Duration**: 1 minute **Notes**: * Added plugin value evaluation for maintenance, distribution, trust review, runtime reuse, and privacy. * Confirmed plugin packaging adds no current trust-review benefit and would add cache/marketplace maintenance. **Files Changed**: * `.spec_system/specs/phase12-session01-codex-plugin-packaging/codex-plugin-packaging-decision.md` - Added plugin value evaluation. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T011 complete and updated progress. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Logged plugin value evaluation. **BQC Fixes**: * Contract alignment: decision explicitly avoids creating a duplicate runtime path for plugin packaging. *** ### Task T010 - Evaluate direct user-level Codex hooks **Started**: 2026-05-31 17:41 **Completed**: 2026-05-31 17:43 **Duration**: 2 minutes **Notes**: * Added direct hook evidence evaluation for install, run and ingest, status, doctor, uninstall, and `/hooks` trust review. * Carried forward Phase 11's explicit live trust-review exception instead of overclaiming automation. **Files Changed**: * `.spec_system/specs/phase12-session01-codex-plugin-packaging/codex-plugin-packaging-decision.md` - Added direct hook evidence evaluation. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T010 complete and updated progress. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Logged direct-hook evaluation. **BQC Fixes**: * Error information boundaries: evidence stays summarized by capability and does not include raw command output or payloads. *** ### Task T009 - Define pass/fail decision gate **Started**: 2026-05-31 17:40 **Completed**: 2026-05-31 17:41 **Duration**: 1 minute **Notes**: * Added an explicit proceed branch, failure handling, and selected defer branch to the decision record. * Confirmed package files are gated behind all criteria passing. **Files Changed**: * `.spec_system/specs/phase12-session01-codex-plugin-packaging/codex-plugin-packaging-decision.md` - Added decision gate. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T009 complete and updated progress. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Logged gate definition. **BQC Fixes**: * Duplicate action prevention: decision gate prevents package files or marketplace state from being created after a failed criterion. *** ### Task T008 - Map reusable hook assets and redaction rules **Started**: 2026-05-31 17:38 **Completed**: 2026-05-31 17:40 **Duration**: 2 minutes **Notes**: * Reviewed `apps/hooks/README_hooks.md`, `apps/hooks/hooks.codex.json`, and hook helper boundaries. * Added a reusable hook asset map to the decision record. * Confirmed any future plugin branch must reuse the existing hook map, handlers, helper redaction rules, and API contract rather than fork a second runtime path. **Files Changed**: * `.spec_system/specs/phase12-session01-codex-plugin-packaging/codex-plugin-packaging-decision.md` - Added reusable hook asset map. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T008 complete and updated progress. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Logged hook asset mapping. **BQC Fixes**: * Contract alignment: documented that future plugin packaging must not diverge from the existing hook event contract or redaction implementation. *** ### Task T007 - Map direct user-level Codex hook baseline **Started**: 2026-05-31 17:37 **Completed**: 2026-05-31 17:38 **Duration**: 1 minute **Notes**: * Reviewed `apps/cli/README_cli.md` and `apps/cli/src/installers/codex.js`. * Mapped direct install, backup, merge, diagnostics, trust-review guidance, and uninstall behavior into the decision record. * Confirmed docs already identify direct user-level Codex hooks as the supported setup path. **Files Changed**: * `.spec_system/specs/phase12-session01-codex-plugin-packaging/codex-plugin-packaging-decision.md` - Added direct-hook baseline map. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T007 complete and updated progress. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Logged CLI baseline mapping. **BQC Fixes**: * N/A - documentation mapping only. *** ### Task T006 - Create validation plan **Started**: 2026-05-31 17:34 **Completed**: 2026-05-31 17:37 **Duration**: 3 minutes **Notes**: * Created a branch-specific validation plan for the deferral decision. * Recorded plugin install, cache refresh, plugin trust review, and plugin uninstall as not applicable rather than passed. * Added future plugin validation steps for a later session if packaging is reopened. **Files Changed**: * `.spec_system/specs/phase12-session01-codex-plugin-packaging/codex-plugin-validation-plan.md` - Added validation plan. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T006 complete and updated progress. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Logged validation-plan creation. **BQC Fixes**: * Error information boundaries: explicit evidence rules prevent raw payloads, token-like values, transcripts, MCP arguments, and broad paths from tracked artifacts. *** ### Task T005 - Create packaging decision record **Started**: 2026-05-31 17:28 **Completed**: 2026-05-31 17:34 **Duration**: 6 minutes **Notes**: * Created the decision record with source references, criteria matrix, selected defer branch, direct-hook baseline map, plugin review, no-overclaim fields, final decision, and future reconsideration gate. * Used current OpenAI Codex hook and plugin docs plus Phase 11 validation evidence. **Files Changed**: * `.spec_system/specs/phase12-session01-codex-plugin-packaging/codex-plugin-packaging-decision.md` - Added source-backed decision record. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T005 complete and updated progress. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Logged decision-record creation. **BQC Fixes**: * Error information boundaries: decision record uses source names, labels, and relative paths only; it does not include raw command output, temp paths, prompts, patch bodies, transcripts, MCP arguments, or token-like values. *** ### Task T004 - Prepare isolated validation plan **Started**: 2026-05-31 17:27 **Completed**: 2026-05-31 17:28 **Duration**: 1 minute **Notes**: * Added the session validation isolation plan before running any package validation. * Scoped install/cache/uninstall checks to temporary homes only. * Defined docs review boundaries and tracked-evidence redaction rules. **Files Changed**: * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Added validation isolation plan and task log. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T004 complete and updated progress. **BQC Fixes**: * Error information boundaries: planned tracked artifacts to omit temp paths, raw outputs, token-like values, prompts, patch bodies, transcript paths, MCP arguments, and broad paths. *** ### Task T003 - Inventory Phase 11 direct hook evidence **Started**: 2026-05-31 17:26 **Completed**: 2026-05-31 17:27 **Duration**: 1 minute **Notes**: * Reviewed the Phase 11 Codex end-to-end validation record. * Direct user-level Codex install, idempotent reinstall, status, doctor, uninstall, server ingest replay, browser replay, privacy review, focused tests, format, lint, typecheck, `git diff --check`, ASCII/LF, and sensitive-string review were recorded as passing. * Live `/hooks` trust review remains an explicit exception because it requires interactive human trust; validation used source-backed fixture replay and did not use trust-bypass flags. **Files Changed**: * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T003 complete and updated progress. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Logged evidence inventory. **BQC Fixes**: * N/A - evidence review only. *** ### Task T002 - Review Codex hook, config, and plugin sources **Started**: 2026-05-31 17:24 **Completed**: 2026-05-31 17:26 **Duration**: 2 minutes **Notes**: * Reviewed `apps/hooks/README_hooks.md` for current Codex source-map, trust-review, and privacy boundaries. * Reviewed current OpenAI docs for Codex hooks and plugin packaging before creating any package files. * Confirmed plugin-bundled hooks remain non-managed hooks that require `/hooks` review; plugin install does not bypass trust. * Confirmed plugin distribution adds marketplace/cache mechanics and optional bundled hook paths, not a separate FactionOS runtime requirement. **Files Changed**: * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T002 complete and updated progress. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Logged source review. **BQC Fixes**: * N/A - source review only. *** ### Task T001 - Verify prerequisites and dependency ordering **Started**: 2026-05-31 17:23 **Completed**: 2026-05-31 17:24 **Duration**: 1 minute **Notes**: * Confirmed Phase 12 has two sessions and Session 01 is the active current session. * Confirmed Session 02 depends on this packaging decision before release closeout. * Confirmed prerequisites point back to completed Phase 11 validation and Phase 10 Codex installer work. **Files Changed**: * `.spec_system/specs/phase12-session01-codex-plugin-packaging/tasks.md` - Marked T001 complete and updated progress. * `.spec_system/specs/phase12-session01-codex-plugin-packaging/implementation-notes.md` - Logged prerequisite review. **BQC Fixes**: * N/A - documentation and evidence review only. *** ## Task Log ### 2026-05-31 - Session Start **Environment verified**: * [x] Prerequisites confirmed * [x] Tools available * [x] Directory structure ready **Commands**: * `bash .spec_system/scripts/analyze-project.sh --json` passed and selected `phase12-session01-codex-plugin-packaging`. * `bash .spec_system/scripts/check-prereqs.sh --json --env` passed for the workspace. **Initial decision posture**: * Session is cross-cutting. * Direct user-level Codex hook support is the validated baseline. * Package files will not be created unless all Phase 12 criteria pass. *** ## Validation Isolation Plan Selected branch: pending decision gate. For any branch that runs install, trust, cache, or uninstall checks: * Use temporary `CODEX_HOME` and `FACTIONOS_HOME` values created outside the repository. * Do not read or mutate real user Codex, Claude, FactionOS, plugin, marketplace, or cache state. * Record labels, counts, booleans, command names, and source URLs only. * Omit temp paths, raw command output, raw hook payloads, prompt text, patch bodies, transcript paths, MCP argument bodies, token-like values, and broad local paths from tracked artifacts. * If packaging is deferred, record plugin install, cache refresh, and uninstall checks as not applicable rather than passed. Docs review boundaries: * `apps/cli/README_cli.md` * `apps/hooks/README_hooks.md` * `docs/api/event-api-hook-contracts.md` * `docs/development.md` * `README.md` *** ## Selected Branch Decision: defer Codex plugin packaging. Rationale: * Direct user-level Codex hooks are already validated. * Current Codex plugin docs confirm plugin-bundled hooks still require the same non-managed `/hooks` trust review. * No Session 02 release closeout requirement needs a repo marketplace, workspace sharing, bundled skill, MCP server, app integration, or official plugin publication. * Plugin install/cache/uninstall validation would add release cost without a concrete release benefit. Docs touched: * `README.md` * `docs/README_docs.md` * `docs/development.md` * `docs/api/event-api-hook-contracts.md` * `apps/cli/README_cli.md` * `apps/hooks/README_hooks.md` Open questions closed: * Codex plugin packaging for this release: defer. * Direct hook baseline: keep supported. * Plugin install/cache/trust/uninstall validation: N/A for deferral. Carried forward: * Reconsider a plugin only when team distribution, workspace sharing, bundled skills, MCP servers, apps, or official plugin publishing become release goals. Privacy review: * Decision and validation artifacts use source references, labels, counts, and relative repo paths only. * No raw Codex prompts, patch bodies, terminal output, transcript paths, MCP argument bodies, token-like values, credentials, temp homes, or broad local paths are recorded. *** --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://faction-os.gitbook.io/faction-os-docs/.spec_system/archive/sessions/phase12-session01-codex-plugin-packaging/implementation-notes.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.