@everfir/az8-cli 0.3.0-preview.3 → 0.3.0

package/CHANGELOG.md

@@ -5,6 +5,40 @@ it does not inherit the Web application or monorepo root version.
 
 ## Unreleased
 
+## 0.3.0 - 2026-07-23
+
+### Added
+
+- Account-aware Workflow discovery and selection, using the same free-account eligibility rule as
+  Web while keeping unavailable historical Definitions inspectable in detail.
+- Web-equivalent default generation Drafts and private local Workflow preferences scoped by
+  environment, authenticated account, and output content type.
+- Truthful terminal Workflow target identity derived from retained launch facts or unique Canvas
+  History, with explicit unresolved and ambiguous states when evidence is insufficient.
+- Daemon-backed collaboration Sessions, manual and generated Text Resources, semantic Prompt
+  reference insertion, structured transfer progress, and bounded download recovery.
+
+### Changed
+
+- `createGenerationTarget` initializes an eligible default Draft in the same undoable interaction;
+  prompt-only `editGenerationDraft` uses the same resolver when a historical target has no Draft.
+- Generation plans preserve their effective prompt and configuration when input modality switches
+  to another Workflow Definition and rebuilds the target Draft.
+- Workflow summary, defaults, planning, reference edits, and generation start reject Definitions
+  unavailable to the authenticated account. `available:free` is treated only as free-tier access,
+  never as pricing evidence.
+- Agent guidance prioritizes one foreground `session watch`, early visible targets, authoritative
+  planning, and explicit reconciliation instead of polling, guessed At syntax, or write retries.
+
+### Safety and compatibility
+
+- Public writes remain semantic Operations backed by internal Commands. No Workflow preference,
+  access rule, or Watch enrichment grants a raw Canvas mutation path.
+- Local preferences contain only a Definition id and sanitized scalar config values; they never
+  contain credentials, prompts, media URLs, or Project data.
+- Stable protocol `1.0`, sequential write blocking, no automatic write retry, and explicit
+  generation acceptance/completion boundaries remain unchanged from `0.2.0`.
+
 ## 0.3.0-preview.3 - 2026-07-23
 
 ### Added

package/README.md

@@ -15,10 +15,10 @@ az8 help
 az8 guide
 ```
 
-For a supplied preview artifact, install the exact immutable tarball instead:
+For a supplied release artifact, install the exact immutable tarball instead:
 
 ```bash
-npm install --global ./everfir-az8-cli-0.3.0-preview.3.tgz
+npm install --global ./everfir-az8-cli-0.3.0.tgz
 az8 --version
 ```
 
@@ -148,14 +148,16 @@ the CLI's local observation-to-delivery delay; neither includes speech recogniti
 host's scheduling time. Repeat only a small bounded sample, keep the Session open between trials,
 and remove the temporary Interest or close the Session afterward.
 
-For generation, create a target with `createGenerationTarget` (including `contentType: "text"`) and
-call `planGeneration` with the returned View Node and a prompt. Execute its returned
+For generation, create a target with `createGenerationTarget` (including `contentType: "text"`).
+Creation initializes an account-eligible default Draft when available and reports
+`draftInitialized`, `definitionId`, and `selectionSource`; it never starts generation. Call
+`planGeneration` with the returned View Node and a prompt. Execute its returned
 `plan.operations` in order, stopping after the first failure. A
 successful `startGeneration` Receipt contains the Workflow Run identity; call `waitWorkflowRun`
 separately when a terminal output is required. Planning and starting are intentionally not one
 transaction. In an active Session, prefer one foreground `session watch`: the system terminal event
-includes Workflow Run, target View Node, and output Core Node identities when supplied by Workflow
-Runtime.
+includes the target View Node only when it can be mapped uniquely from authoritative launch or
+Canvas History facts; unresolved or ambiguous mappings are reported rather than guessed.
 
 For media transfer, `canvas upload` places a verified local image/video/audio file through the
 server-owned Core Node path. After detail query resolves the target's `resolvedCoreNodeId`, `canvas
@@ -315,7 +317,14 @@ Node hierarchy operations, and the Stage 3 Core Node creative loop. Note operati
 `addVisualReference`, `removeVisualReference`, `startGeneration`, `getWorkflowRun`, and
 `waitWorkflowRun`. Capability detail is discoverable through `capabilities.detail`; callers should
 use it instead of hard-coding input schemas. Workflow Definitions are available through
-`workflowDefinitions.summary` and `workflowDefinition.detail` queries.
+`workflowDefinitions.summary` and `workflowDefinition.detail` queries. Summary discovery, default
+Drafts, planning, and generation start use only Definitions available to the authenticated account.
+Detail may retain an unavailable historical Definition for diagnosis with
+`availableForAccount: false` and an `accessReason`.
+
+Workflow tags describe classification, compatibility, access, and rollout rather than price.
+`available:free` means a free-tier account may select the Workflow; it does not mean zero-credit
+generation. Credit claims must come from planning/start estimates or terminal usage records.
 
 Before editing a Draft, an agent can call the read-only `planGeneration` Operation for an existing
 generation target. It recommends a Definition from the target and resolved generation-reference modalities,

package/RELEASE.md

@@ -57,18 +57,18 @@ Before publishing, also run the test-environment acceptance checklist in the pac
 repository-wide `pnpm verify`. Publishing is an external action and requires explicit operator
 authorization:
 
-For a preview candidate, publish the exact retained artifact to the preview channel:
+For the `0.3.0` stable candidate, publish the exact retained artifact to the stable channel only
+after its test-environment acceptance succeeds:
 
 ```bash
-npm publish ./tmp/az8-cli-release/everfir-az8-cli-0.3.0-preview.3.tgz --tag preview
+npm publish ./tmp/az8-cli-release/everfir-az8-cli-0.3.0.tgz --tag latest
 npm view @everfir/az8-cli dist-tags versions --json
 ```
 
 Publish only the exact retained tarball whose SHA-512 appears in its release verification record.
-Do not publish from an unverified source directory. A later stable promotion uses a new stable
-version and `--tag latest`; it never retags or republishes this immutable preview artifact. If the
-obsolete misspelled `prewview` tag still exists, remove that tag without unpublishing its immutable
-version:
+Do not publish from an unverified source directory, retag a preview artifact as stable, or rebuild
+after acceptance. If the obsolete misspelled `prewview` tag still exists, remove that tag without
+unpublishing its immutable version:
 
 ```bash
 npm dist-tag rm @everfir/az8-cli prewview