Skip to content

docs(skill): guide wallet setup from environment - #36

Merged
snissn merged 3 commits into
mainfrom
docs/guided-wallet-setup
Sep 1, 2026
Merged

docs(skill): guide wallet setup from environment#36
snissn merged 3 commits into
mainfrom
docs/guided-wallet-setup

Conversation

@snissn

@snissn snissn commented Aug 31, 2026

Copy link
Copy Markdown
Member

Summary

  • Add a concise DISCOVER → EXPLAIN → ASK setup flow before wallet creation or funding.
  • Reuse suitable existing foc-cli wallets and available custody tooling when present.
  • Explain network, wallet, and funding options for users who are new to the workflow.
  • Make the first-time Calibration example conditional and derive costs from the actual upload requirements.
  • Require an explicit storage runway before estimating costs instead of guessing a financially relevant duration.
  • Match the preflight quote to the planned upload copy count and CDN setting.

Review convergence

The initial internal review found two issues: the recommendation could ignore an existing wallet, and the example hard-coded storage requirements. Both were fixed and re-reviewed cleanly.

Codex found two issues in successive rounds. The skill now resolves an unspecified runway before cost estimation and passes the planned --copies and --withCDN options into the quote. Both threads are resolved.

Validation

  • bun run test: 203 passed, 500 assertions
  • bunx biome check src tests
  • bunx tsc --noEmit
  • bun run build

Scope

Skill guidance only. Faucet details and CLI funding behavior are intentionally handled separately.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Aug 31, 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-08-31T23:09:21.100748Z c951a42 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.

@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: 127acce223

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

Comment thread skills/foc-cli/SKILL.md

@snissn snissn left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Codex review — changes required before merge

Reviewed on exact head 127acce223699fe852323de6a85a68654a30cbe0.

Two workflow gaps need correction:

  1. The ASK phase does not resolve storage runway, although the selected Calibration path later requires --extraRunway <requested-runway-months>. That forces an agent either to guess a financially relevant duration or to stop again after wallet setup. The existing unresolved inline thread identifies this correctly.
  2. The cost example does not carry the intended upload shape through to the quote. wallet costs must use the same --copies and --withCDN choices as the eventual upload; otherwise a non-default request can be underquoted even though the prose says the estimate reflects the actual requirements.

Please resolve the upload parameters needed for planning—at least runway, copy count, and CDN choice when not already specified—and pass them consistently to both the quote and upload. The environment-first wallet discovery and non-replacement guidance otherwise look sound.

GitHub does not permit a reviewer authenticated as the PR author to submit a formal REQUEST_CHANGES review, so this is posted as a blocking comment review.

@snissn

snissn commented Aug 31, 2026

Copy link
Copy Markdown
Member 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: 8df4b27a7b

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

Comment thread skills/foc-cli/SKILL.md Outdated
@snissn

snissn commented Aug 31, 2026

Copy link
Copy Markdown
Member Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Can't wait for the next one!

Reviewed commit: c951a42b3d

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

@snissn

snissn commented Sep 1, 2026

Copy link
Copy Markdown
Member Author

Resolved on current head c951a42b3d9303034e30b37d3f85e3754d3f0fdc (the GPT Pro review covered 127acce223699fe852323de6a85a68654a30cbe0).

  1. 8df4b27 now requires the agent to ask for an unspecified storage runway before running wallet costs.
  2. c951a42 now requires the quote to use the same --copies and --withCDN settings planned for the upload.

Both requested changes are present on the current PR head. No merge performed.

@snissn
snissn requested a review from nijoe1 September 1, 2026 02:55

@nijoe1 nijoe1 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM!

@snissn
snissn merged commit d470459 into main Sep 1, 2026
1 check passed
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.

2 participants