@mytegroupinc/myte-core 0.0.23 → 0.0.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +65 -0
  2. package/cli.js +22 -0
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -24,3 +24,68 @@ This package exists so the public wrapper can stay small and versioned cleanly.
24
24
  - `feedback validate|apply` remains available for validation and owner-direct apply paths; live authorization, stale checks, and history stay server-side.
25
25
  - `query --with-diff` requires project repos to be configured for diff collection and fails fast when no matching local project repo can be resolved.
26
26
  - Public package documentation is intentionally minimal. Internal rollout and design notes are not part of the npm package contract.
27
+
28
+ ## Feedback Action Map
29
+
30
+ | Command | What It Does | Governance |
31
+ | --- | --- | --- |
32
+ | `feedback-sync` | Pulls feedback metadata, comments, and PRD context into `MyteCommandCenter`. | Read-only project-key API call. |
33
+ | `feedback get` | Reads one feedback item's current server snapshot and `snapshot_hash`. | Read-only; backend checks project access. |
34
+ | `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`. |
35
+ | `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. |
36
+ | `feedback assign` | Creates a local YAML proposal to change assignee. | Goes through review unless applied through owner-direct path. |
37
+ | `feedback archive` | Creates a local YAML proposal to archive. | Archive is governed by backend owner/delegate capability. |
38
+ | `feedback submit` | Sends a local proposal artifact to the backend as a review request. | Does not mutate live feedback before approval. |
39
+ | `feedback revise` | Resubmits the original submitter's request after `request_changes`. | Only valid for the original submitter and `needs_changes` requests. |
40
+ | `feedback reviews` | Lists review requests or fetches one request by `--request-id`. | Read-only; response includes backend permissions. |
41
+ | `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. |
42
+ | `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. |
43
+ | `feedback undo` | Reverses an audited board event when there is no conflict. | Backend validates event ownership/project scope and conflict state. |
44
+ | `feedback prd-versions` | Lists retained PRD baselines/revisions for a feedback item. | Read-only; old S3 objects are retained by reference. |
45
+ | `feedback prd-diff` | Fetches backend-generated text diff for PRD versions. | Read-only; backend controls version access. |
46
+ | `feedback history` | Lists audited feedback board/refinement events. | Read-only; backend checks project access. |
47
+ | `feedback validate` | Sends an artifact to backend validation without mutation. | Useful before submit or owner-direct apply. |
48
+ | `feedback apply` | Applies an artifact through the owner-direct/emergency path. | Not the normal collaborator flow; normal flow is `submit` -> `review`. |
49
+
50
+ ## Direct Project API Surface
51
+
52
+ All routes use `Authorization: Bearer <MYTE_API_KEY>`. The CLI adds idempotency and client-session headers on mutation routes.
53
+
54
+ Read/sync routes:
55
+
56
+ - `GET /api/project-assistant/config`
57
+ - `GET /api/project-assistant/bootstrap`
58
+ - `GET /api/project-assistant/qaqc-sync`
59
+ - `GET /api/project-assistant/feedback-sync`
60
+ - `GET /api/project-assistant/feedback/<feedback_id>`
61
+ - `GET /api/project-assistant/feedback/<feedback_id>/refinement/history`
62
+ - `GET /api/project-assistant/feedback-review-requests`
63
+ - `GET /api/project-assistant/feedback-review-requests/<request_id>`
64
+ - `GET /api/project-assistant/feedback/<feedback_id>/events`
65
+ - `GET /api/project-assistant/feedback/<feedback_id>/prd/versions`
66
+ - `GET /api/project-assistant/feedback/<feedback_id>/prd/versions/<version_id>/diff`
67
+ - `GET /api/project-assistant/suggestions`
68
+ - `GET /api/project-assistant/run-qaqc/<batch_id>`
69
+
70
+ Mutation routes:
71
+
72
+ - `POST /api/project-assistant/query`
73
+ - `POST /api/project-assistant/run-qaqc`
74
+ - `POST /api/project-assistant/mission-status-update`
75
+ - `POST /api/project-assistant/project-comment`
76
+ - `POST /api/project-assistant/update-owner`
77
+ - `POST /api/project-assistant/client-update-drafts`
78
+ - `POST /api/project-assistant/create-prd`
79
+ - `POST /api/project-assistant/create-prds`
80
+ - `POST /api/project-assistant/feedback/<feedback_id>/refinement/validate`
81
+ - `POST /api/project-assistant/feedback/<feedback_id>/refinement/requests`
82
+ - `POST /api/project-assistant/feedback-review-requests/<request_id>/revise`
83
+ - `POST /api/project-assistant/feedback/<feedback_id>/refinement/apply`
84
+ - `POST /api/project-assistant/feedback-review-requests/<request_id>/review`
85
+ - `POST /api/project-assistant/feedback-review-requests/<request_id>/request-changes`
86
+ - `POST /api/project-assistant/feedback-review-requests/<request_id>/cancel`
87
+ - `POST /api/project-assistant/feedback/<feedback_id>/board-move`
88
+ - `POST /api/project-assistant/feedback/<feedback_id>/events/<event_id>/undo`
89
+ - `POST /api/project-assistant/suggestions`
90
+ - `POST /api/project-assistant/suggestions/revise`
91
+ - `POST /api/project-assistant/suggestions/review`
package/cli.js CHANGED
@@ -234,8 +234,12 @@ function printHelp() {
234
234
  " myte update-owner --subject \"<text>\" [--body-markdown \"...\"] [--body-file ./update.md] [--json]",
235
235
  " myte update-client --subject \"<text>\" [--body-markdown \"...\"] [--body-file ./update.md] [--target-contact-ids <id1,id2>] [--json]",
236
236
  " myte feedback-sync [--status <value>] [--source <value>] [--with-prd-text|--no-with-prd-text] [--output-dir ./MyteCommandCenter] [--json]",
237
+ " myte feedback get --feedback-id <id> [--json]",
238
+ " myte feedback history --feedback-id <id> [--limit 50] [--json]",
237
239
  " myte feedback status --feedback-id <id> --status todo|in_progress|in_review|completed|deployed|rejected|archived --reason \"...\"",
238
240
  " myte feedback edit --feedback-id <id> [--title \"...\"] [--feedback-text \"...\"] [--priority High] [--reason \"...\"]",
241
+ " myte feedback assign --feedback-id <id> --user-id <id> [--reason \"...\"]",
242
+ " myte feedback archive --feedback-id <id> --reason \"...\"",
239
243
  " myte feedback submit --file ./MyteCommandCenter/reviews/feedback/<id>-edit.yml [--json]",
240
244
  " myte feedback revise --request-id <id> --file ./MyteCommandCenter/reviews/feedback/<id>-edit.yml [--json]",
241
245
  " myte feedback reviews [--status open|terminal|all] [--request-id <id>] [--json]",
@@ -326,14 +330,32 @@ function printHelp() {
326
330
  "",
327
331
  "feedback review contract:",
328
332
  " - Draft commands write review artifacts under MyteCommandCenter/reviews/feedback/*.yml for local IDE diff review",
333
+ " - status/edit/assign/archive/refine create local proposals only; they do not mutate live feedback by themselves",
329
334
  " - submit/revise route artifacts through the owner-review membrane before live feedback mutation",
330
335
  " - reviews/review expose owner/delegate approval, rejection, request-changes, and cancel decisions",
331
336
  " - move/undo operate safe board states directly; governed states remain backend-authorized",
337
+ " - get/history read current feedback snapshots and audited event history through the project-key API",
332
338
  " - prd-versions/prd-diff expose retained PRD versions and backend-generated text diffs",
333
339
  " - validate/apply send artifacts to /api/project-assistant/feedback/<id>/refinement/* for validation or owner-direct apply",
334
340
  " - The backend owns authorization, stale snapshot checks, allowed field/transition rules, and history",
335
341
  " - apply is idempotent and does not rewrite local feedback.yml; run feedback-sync after apply to refresh local state",
336
342
  "",
343
+ "feedback action map:",
344
+ " - feedback-sync: pull board/PRD context into MyteCommandCenter for IDE work",
345
+ " - get: read one feedback item's current server snapshot and snapshot_hash",
346
+ " - status/edit/assign/archive/refine: create reviewable local YAML artifacts; no live mutation",
347
+ " - submit: submit a local artifact as a pending owner-review request",
348
+ " - revise: resubmit the original submitter's request after request_changes",
349
+ " - reviews: list open/terminal/all requests or inspect one request",
350
+ " - review: approve, reject, request_changes, or cancel; backend restricts this to owner/delegate capability",
351
+ " - move: direct audited board movement for allowed states; governed transitions remain backend-authorized",
352
+ " - undo: reverse an audited board event when conflict checks allow it",
353
+ " - prd-versions: list retained PRD baselines/revisions for a feedback item",
354
+ " - prd-diff: fetch backend-generated text diff between PRD versions",
355
+ " - history: list board/refinement events for audit review",
356
+ " - validate: server-side validation of an artifact without mutation",
357
+ " - apply: owner-direct/emergency apply path; normal collaborative flow is submit -> review",
358
+ "",
337
359
  "Options:",
338
360
  " --with-diff Include deterministic git diffs (project-scoped; fails fast if no project repos are configured or resolved)",
339
361
  " --diff-limit <chars> Truncate diff context to N chars (default: 500000)",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mytegroupinc/myte-core",
3
- "version": "0.0.23",
3
+ "version": "0.0.24",
4
4
  "description": "Myte CLI core implementation.",
5
5
  "type": "commonjs",
6
6
  "main": "cli.js",