myte 0.0.23 → 0.0.24

package/README.md

@@ -37,13 +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 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 validate --file ./MyteCommandCenter/reviews/feedback/<id>-status.yml`
-- `npx myte feedback apply --file ./MyteCommandCenter/reviews/feedback/<id>-status.yml`
+- `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`
@@ -80,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.23",
+  "version": "0.0.24",
   "description": "Myte developer CLI.",
   "type": "commonjs",
   "license": "MIT",
@@ -16,6 +16,6 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@mytegroupinc/myte-core": "0.0.23"
+    "@mytegroupinc/myte-core": "0.0.24"
   }
 }