Skip to content

docs: improve install guidance for older pip/editable installs#5

Open
stablegenius49 wants to merge 1 commit into
agent-intent:mainfrom
stablegenius49:docs/install-guidance-for-older-pip
Open

docs: improve install guidance for older pip/editable installs#5
stablegenius49 wants to merge 1 commit into
agent-intent:mainfrom
stablegenius49:docs/install-guidance-for-older-pip

Conversation

@stablegenius49

Copy link
Copy Markdown

Summary

Improves setup docs to reduce failures on environments with older pip/editable-install support.

Changes

  • README
    • Adds explicit python -m pip install --upgrade pip step before editable install
    • Adds non-editable fallback note: pip install ".[dev]"
  • CONTRIBUTING
    • Adds same pip upgrade step and fallback note

Why

Issue #2 highlighted common failures in pyproject/hatchling repos when editable install is attempted with older pip tooling.

Closes #2

Signed-off-by: Stable Genius <259448942+stablegenius49@users.noreply.github.com>
LembaGang added a commit to LembaGang/verifiable-intent that referenced this pull request May 3, 2026
Stacked on v0.5.9-draft-d1-coverage-alignment (commit 486ae6d) which itself
stacks on v0.5.8 (0380ece) and v0.5.7 (21a156c). Applies six specific
corrections from Douglas's May 4 review of the v0.5.7-v0.5.9 stack and
his same-day follow-up tightening Fix agent-intent#5.

Scope of this revision:

- D.2 Organisation row corrected to "InsumerAPI (insumermodel.com)".
  InsumerAPI is the entity operating the environment.wallet_state issuer
  infrastructure (the RFC 6982 reference implementation D.2 documents),
  mirroring D.1's "Headless Oracle (headlessoracle.com)" pattern.
- §9 v0.5.7-draft row body updated correspondingly to reference
  "InsumerAPI (Douglas Borthwick)" rather than the prior wording that
  attributed the implementation to a different entity.
- D.2 Agent-native key provisioning row updated to "USDC/USDT/BTC
  on-chain payment". Production behaviour at POST /v1/keys/buy accepts
  USDC and USDT on EVM chains and Solana, plus BTC on Bitcoin, per
  Douglas's confirmation against PR agent-intent#22 v0.6.4 commit fc6d955 §7.4.
- §9 v0.5.8-draft and v0.5.9-draft row bodies updated to remove co-author
  attribution. Both patches were HO-side housekeeping with no Douglas
  input. The v0.5.8 and v0.5.9 commit message trailers were also
  dropped via amend+rebase in this sprint to align shipped state with
  what was committed to in correspondence. Only v0.5.7 (Appendix D
  listing both implementations as shared editorial work) warranted the
  co-author attribution and retains it.
- D.2 License row added between the existing Reference verifier row
  and the closing prose paragraph, mirroring D.1's License-row pattern,
  with final wording: "Proprietary. Copyright 2026 Douglas Borthwick."
  Two-sentence form is the cleaner default matching the posture across
  Douglas's other published surfaces; spec body does not carry patent-
  prosecution context where it would not serve standards-track readers.

Structural alignment between D.1 and D.2 (whether D.2 needs Operational
Since, Architectural rationale, or other rows mirroring D.1) is a
separate question and out of scope for v0.5.10.

This commit is the result of a stack rewrite that collapsed an earlier
v0.5.10 + v0.5.11 pair (where v0.5.11 added the License row tightening
on top of v0.5.10) into a single v0.5.10 commit with the License row
already at its final wording from the start. The collapse keeps
retracted-text quoting out of the changelog and commit-message prose
that working-group reviewers will read.

Document header stays at 0.5-draft; v0.5.10 is a patch-level refinement
stacked on v0.5.9 / v0.5.8 / v0.5.7 (not independent). No semantic
changes to spec body, no algorithm changes, no security-model changes,
no §4 schema changes, no Headless Oracle code changes required, test
count unchanged (1031+ baseline).

Co-Authored-By: Douglas Borthwick <256362537+douglasborthwick-crypto@users.noreply.github.com>
LembaGang added a commit to LembaGang/verifiable-intent that referenced this pull request May 31, 2026
Stacked on v0.5.9-draft-d1-coverage-alignment (commit 486ae6d) which itself
stacks on v0.5.8 (0380ece) and v0.5.7 (21a156c). Applies six specific
corrections from Douglas's May 4 review of the v0.5.7-v0.5.9 stack and
his same-day follow-up tightening Fix agent-intent#5.

Scope of this revision:

- D.2 Organisation row corrected to "InsumerAPI (insumermodel.com)".
  InsumerAPI is the entity operating the environment.wallet_state issuer
  infrastructure (the RFC 6982 reference implementation D.2 documents),
  mirroring D.1's "Headless Oracle (headlessoracle.com)" pattern.
- §9 v0.5.7-draft row body updated correspondingly to reference
  "InsumerAPI (Douglas Borthwick)" rather than the prior wording that
  attributed the implementation to a different entity.
- D.2 Agent-native key provisioning row updated to "USDC/USDT/BTC
  on-chain payment". Production behaviour at POST /v1/keys/buy accepts
  USDC and USDT on EVM chains and Solana, plus BTC on Bitcoin, per
  Douglas's confirmation against PR agent-intent#22 v0.6.4 commit fc6d955 §7.4.
- §9 v0.5.8-draft and v0.5.9-draft row bodies updated to remove co-author
  attribution. Both patches were HO-side housekeeping with no Douglas
  input. The v0.5.8 and v0.5.9 commit message trailers were also
  dropped via amend+rebase in this sprint to align shipped state with
  what was committed to in correspondence. Only v0.5.7 (Appendix D
  listing both implementations as shared editorial work) warranted the
  co-author attribution and retains it.
- D.2 License row added between the existing Reference verifier row
  and the closing prose paragraph, mirroring D.1's License-row pattern,
  with final wording: "Proprietary. Copyright 2026 Douglas Borthwick."
  Two-sentence form is the cleaner default matching the posture across
  Douglas's other published surfaces; spec body does not carry patent-
  prosecution context where it would not serve standards-track readers.

Structural alignment between D.1 and D.2 (whether D.2 needs Operational
Since, Architectural rationale, or other rows mirroring D.1) is a
separate question and out of scope for v0.5.10.

This commit is the result of a stack rewrite that collapsed an earlier
v0.5.10 + v0.5.11 pair (where v0.5.11 added the License row tightening
on top of v0.5.10) into a single v0.5.10 commit with the License row
already at its final wording from the start. The collapse keeps
retracted-text quoting out of the changelog and commit-message prose
that working-group reviewers will read.

Document header stays at 0.5-draft; v0.5.10 is a patch-level refinement
stacked on v0.5.9 / v0.5.8 / v0.5.7 (not independent). No semantic
changes to spec body, no algorithm changes, no security-model changes,
no §4 schema changes, no Headless Oracle code changes required, test
count unchanged (1031+ baseline).

Co-Authored-By: Douglas Borthwick <256362537+douglasborthwick-crypto@users.noreply.github.com>
Signed-off-by: Michael Msebenzi <127877551+LembaGang@users.noreply.github.com>
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.

docs: make installation instructions robust for older pip (hatchling + editable installs)

1 participant