Skip to content

Document goal mode and stabilize pnpm acceptance - #311

Merged
Pepps233 merged 9 commits into
feat/goal-interactive-controlsfrom
docs/goal-mode
Nov 6, 2026
Merged

Pepps233 merged 9 commits into
feat/goal-interactive-controlsfrom
docs/goal-mode

Conversation

@Pepps233

@Pepps233 Pepps233 commented Nov 4, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Document experimental goal mode, recoverable context compaction, and selective archive recall.
Make native pnpm acceptance tolerate transient registry failures during dependency downloads.

Reasoning

Users and SDK integrators need the mode's selection rules, budgets, persistence behavior, and evolution interaction documented alongside its controls.
Cold-store acceptance must also tolerate brief registry outages while continuing to reject corrupt archives.

Changes

  • Document /goal, SDK controls, block markers, archive discovery, recall isolation, and emergency recovery.
  • Explain request budgets, retrieval limits, provenance, pagination, and validation coverage.
  • Correct the command reference to use /clear and /exit.
  • Reserve changelog edits for explicit /cl runs in the repository instructions.
  • Add bounded pnpm fetch retries and a real-process regression using a local registry that returns a dependency tarball HTTP 502 before recovering.

Testing

  • npm run check
  • git diff --check
  • node --test scripts/npm-lifecycle.test.mjs: 3 passed; the registry-resolved HTTP 502 regression failed before the retry fix.
  • Cross-checked the documented commands and behavior against the implementation and faux-provider tests.

- Preserve source evidence without provider signatures or bookkeeping
- Reject oversized and incomplete summaries before archive commits
- Retrieve branch-scoped original evidence without expanding the main conversation
- Bound summary, search, image, and recall requests with shared budgets
- Keep recall helpers isolated from project tools and extensions
- Manage context blocks and recoverable archives throughout session lifecycles
- Restore branch-local mode and retain recall after leaving goal mode
- Suspend evolution without changing global preferences or ingesting recalled evidence
- Verify persistence, cancellation, pressure, retrieval, and replay with faux providers
- Expose session-local goal toggling with persistent footer feedback
- Explain evolution suspension and block incompatible actions
- Verify narrow layouts, busy handling, and both terminal modes
- Document context selection, recovery, and private archive recall
- Describe budgets, lifecycle behavior, and SDK controls
- Correct the clear and exit command references
- Reserve changelog updates for the explicit release-audit workflow
@Pepps233 Pepps233 added documentation Improvements or additions to documentation coding-agent labels Nov 4, 2026
@Pepps233 Pepps233 self-assigned this Nov 4, 2026
- Tolerate transient registry failures during cold-store pnpm acceptance
- Reproduce dependency HTTP 502 recovery with real pnpm while retaining integrity checks
@Pepps233 Pepps233 changed the title docs(coding-agent): explain goal mode Document goal mode and stabilize pnpm acceptance Nov 4, 2026
@Pepps233
Pepps233 added this pull request to stack #315 November 6, 2026 00:56
@Pepps233
Pepps233 merged commit 9007e2b into main Nov 6, 2026
19 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

coding-agent documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant