@gonovus-ai/spec-flow-cli 0.2.0 → 0.3.1

package/README.md

@@ -1,22 +1,32 @@
 # SpecFlow CLI
 
-The next CLI contract is **0.2.0**, coordinated with the official Skill's exact
-pin. Directory, Spec and Product Map results can return `capabilityId: null`;
-unassigned search results have `capabilityPath: []`. Consumers of 0.1.x must
-handle these absent placements before upgrading. Omit `--capability-id` on
-creation, and use `--capability-id none` on `spec update` to clear placement;
-omitting that update option preserves the current placement. Existing grouped
-requests and nested Capability paths retain their meaning. The HTTP service
-continues under `/v1` with regenerated OpenAPI inputs; clients must update their
-nullable response handling together. This source change does not publish either
-artifact or change already released Skill tags.
+To create a delivery Project, request `project: ["create"]` on its owning
+`WorkspaceKnowledge` grant at CLI login. Current Workspace Role permissions still
+apply. After creation, authorize the returned ID as a separate `ProjectTasks`
+grant before managing its tasks; creation grants no task access or Workspace
+administration authority.
+
+The byte-only `work-item asset put --reservation-file <path> --file <path>`
+accepts signed S3 and Azure BlockBlob reservations, including reservations from
+`map screen image-reserve`. Save reservation JSON in an owner-only file and keep
+its URL out of logs. Uploading bytes alone does not attach an asset; complete the
+matching task or Screen finalization command separately.
+
+The current CLI contract is **0.3.1**, coordinated with the official Skill's exact
+pin. It breaks 0.2.0 callers: Spec, Capability, Glossary, Proposal and
+authoring-history commands address shared knowledge with `--workspace-id` instead of
+`--project-id`, `project directory` is replaced by `spec list`, Session grants
+separate `WorkspaceKnowledge` and `ProjectTasks` targets, and Workspace read-only
+Tokens replace Project Tokens. Failures also carry the public `error.code`, the HTTP
+`error.status` and optional field-level `error.issues`, and Workspace-scoped Product
+Map commands are new. Upgrade the Skill and the CLI together.
 
 `@gonovus-ai/spec-flow-cli` uses OAuth Device Authorization to create an independent
 seven-day Better Auth CLI Session. It supports the Node.js 24 runtime line;
 Node.js 22 and unverified future major versions are intentionally unsupported.
 
 ```bash
-npm install --global @gonovus-ai/spec-flow-cli@0.2.0
+npm install --global @gonovus-ai/spec-flow-cli@0.3.1
 specflow auth login
 specflow auth status
 specflow auth logout
@@ -53,7 +63,7 @@ SPEC_FLOW_API_URL=https://specflow.example specflow project create --name "Payme
 SPEC_FLOW_API_URL=https://specflow.example specflow project archive --project-id <project-id> --expected-version '"1"'
 SPEC_FLOW_API_URL=https://specflow.example specflow project restore --project-id <project-id> --expected-version '"2"'
 SPEC_FLOW_API_URL=https://specflow.example specflow project trash --project-id <project-id> --expected-version '"2"'
-SPEC_FLOW_API_URL=https://specflow.example specflow project directory --project-id <project-id>
+SPEC_FLOW_API_URL=https://specflow.example specflow spec list --workspace-id <workspace-id>
 SPEC_FLOW_API_URL=https://specflow.example specflow spec read --project-id <project-id> --spec-id <spec-id>
 SPEC_FLOW_API_URL=https://specflow.example specflow spec current --project-id <project-id> --spec-id <spec-id>
 SPEC_FLOW_API_URL=https://specflow.example specflow spec revision --project-id <project-id> --spec-id <spec-id> --revision-id <revision-id>
@@ -62,11 +72,11 @@ SPEC_FLOW_API_URL=https://specflow.example specflow spec edit --project-id <proj
 SPEC_FLOW_API_URL=https://specflow.example specflow spec assign-scenario-ids --project-id <project-id> --spec-id <spec-id>
 SPEC_FLOW_API_URL=https://specflow.example specflow spec publish --project-id <project-id> --spec-id <spec-id>
 SPEC_FLOW_API_URL=https://specflow.example specflow glossary edit --project-id <project-id> --entries '[{"id":"payment","canonicalTerm":"Payment","definition":"A completed transfer.","usageNote":null}]'
-SPEC_FLOW_API_URL=https://specflow.example specflow proposal create-spec --project-id <project-id> --spec-id <spec-id> --baseline-content "$(cat payments.md)" --proposed-content "$(cat payments.md)" --agent-revision <revision> --agent-model <model> --source-reference-ids '["source-id"]'
-SPEC_FLOW_API_URL=https://specflow.example specflow proposal list --project-id <project-id> --target-kind Spec --spec-id <spec-id> --status Open
-SPEC_FLOW_API_URL=https://specflow.example specflow proposal apply --project-id <project-id> --proposal-id <proposal-id> --change-ids '["hunk-1"]'
-SPEC_FLOW_API_URL=https://specflow.example specflow proposal discard --project-id <project-id> --proposal-id <proposal-id>
-SPEC_FLOW_API_URL=https://specflow.example specflow authoring-history --project-id <project-id>
+SPEC_FLOW_API_URL=https://specflow.example specflow proposal create-spec --workspace-id <workspace-id> --spec-id <spec-id> --baseline-content "$(cat payments.md)" --proposed-content "$(cat payments.md)" --agent-revision <revision> --agent-model <model> --source-reference-ids '["source-id"]'
+SPEC_FLOW_API_URL=https://specflow.example specflow proposal list --workspace-id <workspace-id> --target-kind Spec --spec-id <spec-id> --status Open
+SPEC_FLOW_API_URL=https://specflow.example specflow proposal apply --workspace-id <workspace-id> --proposal-id <proposal-id> --change-ids '["hunk-1"]'
+SPEC_FLOW_API_URL=https://specflow.example specflow proposal discard --workspace-id <workspace-id> --proposal-id <proposal-id>
+SPEC_FLOW_API_URL=https://specflow.example specflow authoring-history --workspace-id <workspace-id>
 ```
 
 Every official CLI service request sends the versioned `@gonovus-ai/spec-flow-cli/<version>`
@@ -117,7 +127,7 @@ command/result pairs are the supported schemas:
 | `project restore`                                                                                       | `{ project: ProjectSummary }`                                                                                         |
 | `project trash`                                                                                         | `{ project: ProjectSummary }`                                                                                         |
 | `project context`                                                                                       | `{ project: ProjectContext, publishedGlossary: PublishedGlossary \| null }`                                           |
-| `project directory`                                                                                     | `{ capabilities: Capability[], permissions: Permissions, specs: SpecSummary[] }`                                      |
+| `spec list`                                                                                     | `{ capabilities: Capability[], permissions: Permissions, specs: SpecSummary[] }`                                      |
 | `spec search`                                                                                           | `{ nextCursor: string \| null, results: SearchResult[], totalCount: number }`                                         |
 | `work-item resource-link list`                                                                          | `{ links: WorkItemResourceLink[], canCreateLink: boolean, canReadSpecs: boolean }`                                    |
 | `work-item resource-link add`                                                                           | `{ linkId: string, link: WorkItemResourceLink \| null, replayed: boolean }`                                           |