Skip to main content

​
Full Release Validation

This page is a release checklist around scripts that exist in this repository. It does not define new product behavior. Run the required checks before a public release branch is pushed. Run optional lanes when the release touches that subsystem or when release hardware/secrets are available.

​
Required Local Gate

Start from the Fased repository root:
What this covers:
  • pnpm check: formatting, lint, docs temp guards, auth/channel boundary guards, and Swift env-policy generation check.
  • pnpm build: TypeScript bundle, plugin SDK d.ts, protocol/build metadata, and canvas/export template copies.
  • pnpm ui:build: Control UI production build.
  • pnpm test:fast: unit suite through vitest.unit.config.ts.
  • pnpm test:ui: Control UI test suite plus raw-window-open guard.
  • pnpm test:smoke:agent-flow: composite Provider -> Agent -> Skill -> Chat -> Task -> Memory -> Channel delivery smoke lane.
  • pnpm check:docs: docs formatting, markdown lint, and internal link audit.
  • pnpm exec tsc --noEmit: repository TypeScript gate without emitting files.
If the default Gateway port is occupied from local work, use:

​
Gateway and Runtime Smoke

Run this when Gateway routing, websocket/http behavior, node pairing, sessions, or operator pages changed:
Useful focused lanes:
test:browser-cdp requires a loopback/CDP-capable environment.

​
Task Run History Smoke

Run this focused browser smoke when Agent > Tasks, webhook triggers, workflow templates, workflow graph review, or approval resume behavior changes:
It starts a real Gateway/Control UI test instance and verifies:
  • a webhook trigger can receive a test payload
  • the payload creates a task run-history record
  • Agent > Tasks opens the source task
  • a run-history-backed workflow can be reviewed from that source
  • approval/resume continues the same workflow record
  • domain authority stays outside the workflow layer
This is the focused smoke for task/workflow run history. It does not replace the domain pages: Wallets, Marketplace, Mining, Channels, and Media/Files remain the authority surfaces for their own policies and runtime controls.

​
Docker and Install Smoke

Docker checks are slower and require Docker/Podman-compatible host support. Use them for install, onboarding, plugin, gateway-network, and cleanup changes. Focused lanes:
Full container lane:
Install-script release lanes:
Only run provider-specific install E2E lanes when the required release secrets are available.

​
Live Provider Checks

Live checks require credentials and should not run in normal local development:
Provider-specific live checks may require provider env vars such as MINIMAX_API_KEY, ZAI_API_KEY, or other keys documented by the test itself. Before treating a live failure as a code regression, separate:
  • provider outage or quota/rate limits
  • bad release secrets
  • model catalog changes
  • network/DNS failure on the runner
  • actual runtime regression

​
Mobile and Desktop App Checks

Run only on hosts with the required SDK/toolchain:
Use platform docs for device-specific setup. Do not block a server-only patch on mobile packaging unless the release includes mobile changes.

​
Docs Release Gate

For docs-only release work:
Before public launch docs are final, manually review:
  • install paths: local, Docker/Podman, VPS, Tailscale
  • Agent-first setup: Models, Channels, Skills, Tools, Memory, Tasks, Services
  • wallet funding and Wallet > Skill Grants
  • SAT mining start/stop/readiness
  • Dashboard, Usage, Logs, Advanced > Debug/Nodes
  • screenshots for beginner-critical flows

​
Manual Product Smoke

Use a fresh temporary Agent and verify:
  1. Onboarding creates or reuses a gateway token and opens an auth-ready Control UI URL.
  2. Agent > Models signs in or accepts a provider key and saves primary/fallback model refs.
  3. Chat sends one model-backed reply and Usage records provider/model tokens.
  4. Agent > Skills creates a local skill, enables it for the Agent, and Chat shows the skill was loaded.
  5. Agent > Memory enables session archive, /new or /reset writes an archive when there is content, and diagnostics show the selected Agent’s roots.
  6. Agent > Channels routes a test Telegram/Discord/other channel account to the selected Agent.
  7. Agent > Tasks creates a scheduled task inheriting the Agent model/skills policy, creates a webhook trigger, opens source-specific run-history records, and previews or runs a run-history-backed workflow template.
  8. Wallet page shows role separation and Wallet > Skill Grants does not grant mining/vault roles to generic skills.
  9. Mining page reads status without starting mining, then start/stop works only with the configured mining wallet and approvals.
  10. Advanced > Debug remains operator-only and does not duplicate normal setup flows.

​
Release Notes

Before tagging:
  • Update user-facing docs for new setup surfaces.
  • Add migration notes for config or auth behavior changes.
  • Keep stale fork wording out of public docs unless the behavior exists in Fased code.
  • Run git status --short and review every staged file.
Related docs: