SwarmCraft
Discovery and PlanningGuide

Docs

Prepare and authorize the Discovery Package

Validate the reviewed documents and selected sources, inspect the exact immutable text package, and explicitly authorize its upload.

Prepare and authorize the Discovery Package

Package preparation freezes the reviewed discovery into one deterministic text package. It does not call Codex or Copilot and does not generate tasks, identifiers, assertions, summaries, or a hidden Blueprint.

Prepare in VS Code

  1. Confirm all nine curated documents are reviewed or justified NOT_APPLICABLE.
  2. Confirm the complete selected supporting-source set.
  3. Select Prepare Discovery Package in the Deep Discovery sidebar.
  4. Wait for review, source, safety, digest, and preview milestones.

Preparation normally finishes in seconds. It validates the versioned binding, review state, selected-source digests, sidecar state, secrets, file types, package bytes, and estimated server-generation token budget.

If validation fails, correct the reported document or source issue and prepare again. SwarmCraft does not ask AI to repair package JSON or silently remove content.

Optional deterministic CLI checks

The extension runs the customer CLI internally. You can repeat the same content-safe validation from a shell:

swarmcraft discovery prepare --workspace .
swarmcraft discovery validate --workspace .

Direct CLI use reads the same discovery binding and cannot bypass account, API-origin, schema, source-selection, or review checks.

Inspect the exact preview

The preview lists:

  • every curated and supporting path included
  • curated and supporting counts
  • review state and source role
  • byte and token estimates
  • SHA-256 digest
  • server-processing disclosure
  • the rule that reviewed curated documents take precedence

Read the complete list. The upload consent is bound to this immutable digest; any selected input change invalidates the prepared package and requires a new preview.

Authorize upload

Select Upload Discovery Package only after the preview matches your intent. SwarmCraft sends metadata-only policy preflight first, then requests explicit digest-bound consent before sending the exact package text.

The API deterministically revalidates the package, encrypts the admitted snapshot at rest, and associates it with your account. Unselected repository files, binary originals, and unrelated working-tree content are not sent.

After admission, continue with Unlock the Deep Discovery project.