Skip to content

feat(desktop): add Help → Product Guide and refresh the guide for checkpoint 3748 - #533

Merged
lastobelus merged 2 commits into
lastcode/mainfrom
lastcode/product-guide-help-and-refresh
Oct 29, 2026
Merged

lastobelus merged 2 commits into
lastcode/mainfrom
lastcode/product-guide-help-and-refresh

Conversation

@lastobelus

@lastobelus lastobelus commented Oct 28, 2026 •

Copy link
Copy Markdown
Owner

The desktop Help menu has no way to open the locally maintained product guide, and the existing six-topic guide was written before the latest built checkpoint.

What changed

  • Help → Product Guide opens the desktop machine's guide in the system default app, whatever thread or connection is selected.
  • Failures warn. A missing guide or a failed open shows a warning. External-link validation is unchanged.
  • Guide refresh. The six topics are checked against built checkpoint lastcode/checkpoint/v0.1.3-nightly.20261027.3748 (2da9a07b51a1878bcbf9066e5c0429df8d7cba8d). Source links point at that exact commit, and the storage, usage-limit and browser explanations are clearer.
  • Local-only notes stay local. The guide's optional companion import is sandboxed and no private content is in the repository.

Validation

  • Tests: 61 focused desktop tests (4 files) and desktop typecheck pass.
  • CI: Quick CI passes at exact head 463c9ca9d23ec56b87f4885c5d40b7db44a0055f against canonical base 0e8e29a90015f6bcc9e9dc5544224dc840f0fc6c. Changed-file lint, targeted format check and git diff --check pass.
  • Browser QA: all six tabs render and switch at 1280 × 800 and 390 × 844 with no horizontal overflow. Keyboard navigation, the usage-limit demonstration and dark appearance were checked. A source link opened the pinned GitHub file.
  • Source links: all 39 unique paths (41 links) exist at the pinned commit.
  • Companion import: an imported private companion stays in an empty-sandbox, opaque-origin frame with CSP; importer script and styles are unchanged.
  • Review: Astra High was clean on the implementation and initial refresh. The later writing edits and two added source links got source-link and browser smoke checks only.

Additional validation notes

  • Native check: selecting Help → Product Guide in an isolated Electron runtime reached the real OS handler and visibly opened the expected guide. The user confirmed the rendered content. Tests also cover custom home and open failures. Menu and shell source remained unchanged through the rebases; this is not a packaged-app installation check. The native after-image is uploaded. The maintainer explicitly waived only the missing before-image; no CI or review gate was waived.
  • Local check: check:changed origin/lastcode/main selects the full repository for the HTML file and was interrupted (exit 130) after reporting a format issue that is now fixed. It has not run to completion.
  • Remote gates: exact-head/current-base GitHub CI and Codex review are required before guarded merge; their current results are recorded in checks and comments.

Model/harness: GPT-6.1-Sol Extra High in Codex; Astra High review; Claude Opus 5.5 High guide prose pass; Claude Sonnet 5.5 High PR text.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 28, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-29T19:59:02.616288Z 463c9ca Manual request
ℹ️ 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@lastobelus lastobelus changed the title feat(desktop): open the product guide from Help feat(desktop): add Help → Product Guide and refresh the guide for checkpoint 3748 Oct 28, 2026
@lastobelus

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 13f60814a1

ℹ️ 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".

@lastobelus

Copy link
Copy Markdown
Owner Author

Validation update for 13f60814a1ec3bc7484bcb154415929d360b29d1: Quick CI and GitHub CI passed; the current-head review finding has a documented scope disposition, and zero review threads remain unresolved. The merge-gate checker reports ready.

The production native menu has also been constructed successfully in an isolated Electron runtime, without a backend or changing the installed app. Actual native menu selection, visibly opening the guide through the OS handler, and authentic before/after menu captures remain unverified. Keeping the PR open for that remaining acceptance.

@lastobelus
lastobelus force-pushed the lastcode/main branch 3 times, most recently from 024232b to 8199ca4 Compare October 29, 2026 12:01
@lastobelus

Copy link
Copy Markdown
Owner Author

Native QA update for 13f60814a1ec3bc7484bcb154415929d360b29d1: selecting Help → Product Guide opened the expected local document through the real OS handler, and the user confirmed the six-topic guide visibly rendered.

The attached image is a lossless rectangular crop of the actual native Help-menu screenshot, limited to the added Product Guide item to exclude private background content. No pixels were regenerated or retouched.

After: Product Guide item in the native Help menu

The before-menu image remains unavailable because screen-capture permission is denied in the automation session. The baseline production menu was verified through the real Electron runtime and accessibility tree, but that is not a visual capture. No before image or capture waiver is claimed.

@lastobelus
lastobelus force-pushed the lastcode/product-guide-help-and-refresh branch from 13f6081 to c0ff597 Compare October 29, 2026 19:12
@lastobelus

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. 🎉

Reviewed commit: c0ff597acd

ℹ️ 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".

Add a trusted local-document entry and explain the six product decisions against a verified built checkpoint.

Carry-Group: incubator

Carry-Observation: This desktop help convenience and its pinned guide are one feature; the Help action does not depend on a selected thread or remote project.
Retain the final clarity edits and exact-checkpoint source links from the resumed writing pass.

Carry-Group: incubator

Carry-Observation: These copy edits belong to the Help-menu product guide and preserve its pinned checkpoint and private-import behavior.
@lastobelus
lastobelus force-pushed the lastcode/product-guide-help-and-refresh branch from c0ff597 to 463c9ca Compare October 29, 2026 19:56
@lastobelus

Copy link
Copy Markdown
Owner Author

The maintainer explicitly waived only the missing native before-image requirement and authorized merge once the current CI and review gates pass. Native Help selection, successful OS handoff, visible guide rendering and the safe uploaded after-image are complete. No baseline capture is claimed. All current-head/current-base CI, review and guarded-merge requirements remain in force.

@lastobelus

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Already looking forward to the next diff.

Reviewed commit: 463c9ca9d2

ℹ️ 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".

@lastobelus
lastobelus merged commit 592ece2 into lastcode/main Oct 29, 2026
22 of 38 checks passed
@lastobelus
lastobelus deleted the lastcode/product-guide-help-and-refresh branch October 29, 2026 20:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant