myte 0.0.22 → 0.0.24

package/README.md

@@ -37,9 +37,22 @@ The CLI searches for `.env` in the current folder and then up parent directories
 - `npx myte bootstrap`
 - `npx myte sync-qaqc`
 - `npx myte feedback-sync`
+- `npx myte feedback get --feedback-id <id>`
+- `npx myte feedback history --feedback-id <id>`
 - `npx myte feedback status --feedback-id <id> --status in_review --reason "Ready for review"`
-- `npx myte feedback validate --file ./MyteCommandCenter/reviews/feedback/<id>-status.yml`
-- `npx myte feedback apply --file ./MyteCommandCenter/reviews/feedback/<id>-status.yml`
+- `npx myte feedback edit --feedback-id <id> --title "Updated title" --feedback-text "Updated body" --reason "Clarify scope"`
+- `npx myte feedback assign --feedback-id <id> --user-id <user_id> --reason "Assign to builder"`
+- `npx myte feedback archive --feedback-id <id> --reason "Superseded"`
+- `npx myte feedback validate --file ./MyteCommandCenter/reviews/feedback/<id>-edit.yml`
+- `npx myte feedback submit --file ./MyteCommandCenter/reviews/feedback/<id>-edit.yml`
+- `npx myte feedback reviews --status open`
+- `npx myte feedback revise --request-id <id> --file ./MyteCommandCenter/reviews/feedback/<id>-edit.yml`
+- `npx myte feedback review --request-id <id> --action approve --reason "Looks correct"`
+- `npx myte feedback move --feedback-id <id> --to-state in_progress --reason "Started"`
+- `npx myte feedback undo --feedback-id <id> --event-id <event_id> --reason "Undo accidental move"`
+- `npx myte feedback prd-versions --feedback-id <id>`
+- `npx myte feedback prd-diff --feedback-id <id> --version-id <version_id> --compare-to <base_version_id>`
+- `npx myte feedback apply --file ./MyteCommandCenter/reviews/feedback/<id>-edit.yml`
 - `npx myte suggestions sync`
 - `npx myte query "Summarize the current branch changes" --with-diff`
 - `npx myte create-prd ./drafts/auth-prd.md`
@@ -50,7 +63,9 @@ The CLI searches for `.env` in the current folder and then up parent directories
 ## Behavior
 
 - `bootstrap`, `sync-qaqc`, `feedback-sync`, and `suggestions sync` write project-scoped local context under `MyteCommandCenter` in the current workspace unless `--output-dir` is provided.
-- `feedback status|edit|assign|archive` writes local review artifacts under `MyteCommandCenter/reviews/feedback`; `feedback validate|apply` sends those artifacts to the backend, where authorization, stale snapshot checks, allowed transitions, and history are enforced.
+- `feedback status|edit|assign|archive` writes local review artifacts under `MyteCommandCenter/reviews/feedback`; `feedback submit|revise|reviews|review` routes proposed edits through the backend owner-review membrane.
+- `feedback move|undo|prd-versions|prd-diff|history` calls the project-key Feedback API while authorization, stale snapshot checks, allowed transitions, and history remain enforced by the backend.
+- `feedback validate|apply` remains available for validation and owner-direct apply paths.
 - `query --with-diff` is stricter than the snapshot commands. It requires project repositories to be configured by the project owner or builder, and it requires at least one matching local project repo to be resolved for diff collection.
 - If diff-scoped repo configuration is missing or no local project repo can be resolved, `query --with-diff` exits with an error instead of silently dropping diff context.
 - Most markdown files are excluded from diff context by default so code and runtime configuration changes dominate the payload. Key instruction files such as `README.md` and `AGENTS.md` remain eligible.
@@ -63,7 +78,7 @@ The CLI searches for `.env` in the current folder and then up parent directories
 - `mission status`: update mission state
 - `sync-qaqc`: refresh active mission QAQC context locally
 - `feedback-sync`: refresh feedback and PRD context locally
-- `feedback status|edit|assign|archive|validate|apply|history|get`: create reviewable feedback refinement artifacts and apply them through the project-key API
+- `feedback status|edit|assign|archive|submit|revise|reviews|review|move|undo|prd-versions|prd-diff|validate|apply|history|get`: create reviewable feedback artifacts and operate the governed Feedback API
 - `suggestions sync|create|revise|review`: work with mission suggestion workflow state
 - `query`: ask the project assistant, optionally with local diff context
 - `ai`: use the Myte AI gateway
@@ -74,3 +89,68 @@ The CLI searches for `.env` in the current folder and then up parent directories
 
 - The package ships the CLI only. Internal rollout notes, validation logs, and project-specific operating docs are not part of the public npm contract.
 - The public `myte` package is the supported entrypoint. The scoped `@mytegroupinc/myte-core` package is the implementation dependency used by the wrapper.
+
+## Feedback Action Map
+
+| Command | What It Does | Governance |
+| --- | --- | --- |
+| `feedback-sync` | Pulls feedback metadata, comments, and PRD context into `MyteCommandCenter`. | Read-only project-key API call. |
+| `feedback get` | Reads one feedback item's current server snapshot and `snapshot_hash`. | Read-only; backend checks project access. |
+| `feedback status` | Creates a local YAML proposal to change canonical lifecycle state. | No live mutation until `submit` and owner/delegate review, except owner-direct `apply`. |
+| `feedback edit` / `feedback refine` | Creates a local YAML proposal for title, description/body, priority, due date, tags, or notes. | Content changes go through owner-review membrane. |
+| `feedback assign` | Creates a local YAML proposal to change assignee. | Goes through review unless applied through owner-direct path. |
+| `feedback archive` | Creates a local YAML proposal to archive. | Archive is governed by backend owner/delegate capability. |
+| `feedback submit` | Sends a local proposal artifact to the backend as a review request. | Does not mutate live feedback before approval. |
+| `feedback revise` | Resubmits the original submitter's request after `request_changes`. | Only valid for the original submitter and `needs_changes` requests. |
+| `feedback reviews` | Lists review requests or fetches one request by `--request-id`. | Read-only; response includes backend permissions. |
+| `feedback review` | Approves, rejects, requests changes, or cancels a review request. | Backend restricts approval/review decisions to Project Owner or elevated delegate for Feedback scope. |
+| `feedback move` | Moves a card across allowed board states directly with an audit event. | Safe states are direct; governed states such as archive/reject/deploy remain backend-authorized. |
+| `feedback undo` | Reverses an audited board event when there is no conflict. | Backend validates event ownership/project scope and conflict state. |
+| `feedback prd-versions` | Lists retained PRD baselines/revisions for a feedback item. | Read-only; old S3 objects are retained by reference. |
+| `feedback prd-diff` | Fetches backend-generated text diff for PRD versions. | Read-only; backend controls version access. |
+| `feedback history` | Lists audited feedback board/refinement events. | Read-only; backend checks project access. |
+| `feedback validate` | Sends an artifact to backend validation without mutation. | Useful before submit or owner-direct apply. |
+| `feedback apply` | Applies an artifact through the owner-direct/emergency path. | Not the normal collaborator flow; normal flow is `submit` -> `review`. |
+
+## Direct Project API Surface
+
+All routes use `Authorization: Bearer <MYTE_API_KEY>`. The CLI adds idempotency and client-session headers on mutation routes.
+
+Read/sync routes:
+
+- `GET /api/project-assistant/config`
+- `GET /api/project-assistant/bootstrap`
+- `GET /api/project-assistant/qaqc-sync`
+- `GET /api/project-assistant/feedback-sync`
+- `GET /api/project-assistant/feedback/<feedback_id>`
+- `GET /api/project-assistant/feedback/<feedback_id>/refinement/history`
+- `GET /api/project-assistant/feedback-review-requests`
+- `GET /api/project-assistant/feedback-review-requests/<request_id>`
+- `GET /api/project-assistant/feedback/<feedback_id>/events`
+- `GET /api/project-assistant/feedback/<feedback_id>/prd/versions`
+- `GET /api/project-assistant/feedback/<feedback_id>/prd/versions/<version_id>/diff`
+- `GET /api/project-assistant/suggestions`
+- `GET /api/project-assistant/run-qaqc/<batch_id>`
+
+Mutation routes:
+
+- `POST /api/project-assistant/query`
+- `POST /api/project-assistant/run-qaqc`
+- `POST /api/project-assistant/mission-status-update`
+- `POST /api/project-assistant/project-comment`
+- `POST /api/project-assistant/update-owner`
+- `POST /api/project-assistant/client-update-drafts`
+- `POST /api/project-assistant/create-prd`
+- `POST /api/project-assistant/create-prds`
+- `POST /api/project-assistant/feedback/<feedback_id>/refinement/validate`
+- `POST /api/project-assistant/feedback/<feedback_id>/refinement/requests`
+- `POST /api/project-assistant/feedback-review-requests/<request_id>/revise`
+- `POST /api/project-assistant/feedback/<feedback_id>/refinement/apply`
+- `POST /api/project-assistant/feedback-review-requests/<request_id>/review`
+- `POST /api/project-assistant/feedback-review-requests/<request_id>/request-changes`
+- `POST /api/project-assistant/feedback-review-requests/<request_id>/cancel`
+- `POST /api/project-assistant/feedback/<feedback_id>/board-move`
+- `POST /api/project-assistant/feedback/<feedback_id>/events/<event_id>/undo`
+- `POST /api/project-assistant/suggestions`
+- `POST /api/project-assistant/suggestions/revise`
+- `POST /api/project-assistant/suggestions/review`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myte",
-  "version": "0.0.22",
+  "version": "0.0.24",
   "description": "Myte developer CLI.",
   "type": "commonjs",
   "license": "MIT",
@@ -16,6 +16,6 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@mytegroupinc/myte-core": "0.0.22"
+    "@mytegroupinc/myte-core": "0.0.24"
   }
 }