@mytegroupinc/myte-core 0.0.53 → 0.0.54

package/README.md

@@ -44,7 +44,7 @@ This package exists so the public wrapper can stay small and versioned cleanly.
   `MyteCommandCenter/feedback-sync/comment-attachments`; binary formats remain
   visible as metadata-only context. Raw S3/object-storage URLs are not written
   into local sync artifacts.
-- `feedback status|edit|assign|archive|refine` writes reviewable local YAML artifacts.
+- `feedback status|edit|document-add|assign|archive|refine` writes reviewable local YAML artifacts.
 - `feedback submit|revise|comment` are live writes that require `--confirm-write --approval-artifact <path>`.
 - `feedback review|move|undo|apply` are governed writes with backend permission checks but no approval artifact flags.
 - `feedback-sync|get|history|reviews|prd-versions|prd-diff|validate` are read/sync/validation commands with no approval artifact flags.
@@ -90,6 +90,8 @@ Only selected project-key writes require a server-validated approval envelope. T
   with ordered PRD documents. List every file/title/client ref and the matching
   count in the approval artifact.
 - Feedback submit/revise/comment artifacts are usually the same YAML or markdown file being submitted. For inline text or stdin, use a separate approval memo with the feedback id or request id and exact content.
+- `feedback document-add --feedback-id <id> --prd-file ./document.md` creates a governed proposal to append one linked PRD document to the existing Feedback context. The addition is not live until the normal `feedback submit` -> owner/delegate `feedback review` flow applies it.
+- Governed document additions preserve existing document IDs, append a new stable document, create a new immutable PRD version, and emit `feedback_prd_document_added` so the Feedback context bubble/notification feed can link users back to the updated PRD context. Existing PRD sets may grow to twelve documents; new `create-prd --document-set` uploads remain capped at three.
 - Team, owner, and client update artifacts should name the audience and include the exact message body or a complete summary. Client updates should include target contact ids when used.
 - `feedback review --request-ids`, `feedback move --feedback-ids`, `mission status --mission-ids`, `mission archive --mission-ids`, and `run-qaqc --mission-ids` are batched governed writes, but they are marked `Not required` and should not receive approval artifact flags.
 - The package does not bundle the large MyteCody engine binary or the async
@@ -249,7 +251,8 @@ Agent rule: never guess `suggestion_id`. If `mission-ops.yml` is missing or stal
 | `feedback-sync` | Pulls non-archived feedback metadata, comments, and PRD context into `MyteCommandCenter`. | Read-only project-key API call; archived Feedback is intentionally excluded. |
 | `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 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 document-add` | Creates a local YAML proposal to append one linked Markdown PRD document to an existing Feedback item. | Owner-only field; normal submit/review/apply flow, stale protection, idempotency, version history, and notification apply. |
 | `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. | Requires `--confirm-write --approval-artifact <path>`; does not mutate live feedback before approval. |

package/cli.js

@@ -220,6 +220,7 @@ function printHelp() {
     "  myte feedback history --feedback-id <id> [--limit 50] [--json]",
     "  myte feedback status --feedback-id <id> --status frozen|todo|in_progress|in_review|completed|deployed|rejected|archived --reason \"...\"",
     "  myte feedback edit --feedback-id <id> [--title \"...\"] [--feedback-text \"...\"] [--prd-file ./document.md] [--document-id <id>] [--priority High] [--reason \"...\"]",
+    "  myte feedback document-add --feedback-id <id> --prd-file ./document.md [--title \"...\"] [--filename name.md] [--client-ref ref] [--reason \"...\"]",
     "  myte feedback assign --feedback-id <id> --user-id <id> [--reason \"...\"]",
     "  myte feedback archive --feedback-id <id> --reason \"...\"",
     "  myte feedback submit --file ./MyteCommandCenter/reviews/feedback/<id>-edit.yml --confirm-write --approval-artifact <path> [--json]",
@@ -354,6 +355,7 @@ function printHelp() {
     "  - get/history read current feedback snapshots and audited event history through the project-key API",
     "  - prd-versions/prd-diff expose retained PRD versions and backend-generated per-document text diffs",
     "  - edit/refine with --prd-file updates a review artifact only; --document-id targets one document in a PRD document set",
+    "  - document-add creates a governed review artifact that appends one linked PRD document; approval applies it through the same stale-safe PRD version flow",
     "  - validate/apply send artifacts to /api/project-assistant/feedback/<id>/refinement/* for validation or owner-direct apply",
     "  - The backend owns authorization, stale snapshot checks, allowed field/transition rules, and history",
     "  - apply is idempotent and does not rewrite local feedback.yml; run feedback-sync after apply to refresh local state",
@@ -379,7 +381,8 @@ function printHelp() {
     "  - reviews: list open/terminal/all requests or inspect one request",
     "  - review: approve, reject, request_changes, or cancel; backend restricts this to owner/delegate capability",
     "  - move: direct audited board movement for allowed states; governed transitions remain backend-authorized",
-    "  - comment: create a text-only comment on one Feedback item",
+    "  - document-add: create a governed proposal to append one linked PRD document to an existing Feedback item",
+    "  - comment: create a text-only comment on one Feedback item",
     "  - undo: reverse an audited board event when conflict checks allow it",
     "  - prd-versions: list retained PRD baselines/revisions for a feedback item",
     "  - prd-diff: fetch backend-generated text diff between PRD versions",
@@ -474,6 +477,7 @@ function printHelp() {
     "  myte feedback review --request-id 507f1f77bcf86cd799439022 --action approve --reason \"Looks correct\" --json",
     "  myte feedback move --feedback-id 507f1f77bcf86cd799439011 --to-state in_progress --reason \"Started\" --json",
     "  myte feedback comment --feedback-id 507f1f77bcf86cd799439011 --body-file ./comments/implementation.md --confirm-write --approval-artifact ./comments/implementation.md --json",
+    "  myte feedback document-add --feedback-id 507f1f77bcf86cd799439011 --prd-file ./drafts/sidebar-branding.md --title \"Individual Use Sidebar Branding\" --reason \"Link governed UX addendum to the Feedback context.\"",
     "  myte feedback validate --file ./MyteCommandCenter/reviews/feedback/507f1f77bcf86cd799439011-status.yml --json",
     "  myte feedback apply --file ./MyteCommandCenter/reviews/feedback/507f1f77bcf86cd799439011-status.yml --json",
     "  myte suggestions create --file ./suggestions/create.yml --confirm-write --approval-artifact ./suggestions/create.yml",
@@ -6653,7 +6657,50 @@ async function buildFeedbackDraftForCommand(args, subcommand) {
       process.exit(1);
     }
     changes.assigned_user_id = feedbackChange(firstNonEmptyString(item.assigned_user_id), assignee);
-  } else if (action === "edit" || action === "refine") {
+  } else if (action === "document-add") {
+    const prdFile = firstNonEmptyString(
+      args["prd-file"],
+      args.prdFile,
+      args.prd_file,
+      args["document-file"],
+      args.documentFile,
+      args.document_file,
+      args._?.[2],
+    );
+    if (!prdFile) {
+      console.error("Missing --prd-file for feedback document-add.");
+      process.exit(1);
+    }
+    const proposedPath = resolveInputFile(prdFile, "PRD document addition");
+    const proposedMarkdown = fs.readFileSync(proposedPath, "utf8");
+    if (!proposedMarkdown.trim()) {
+      console.error("PRD document markdown cannot be empty.");
+      process.exit(1);
+    }
+    if (proposedMarkdown.length > 250000) {
+      console.error("PRD document markdown must be at most 250000 characters.");
+      process.exit(1);
+    }
+    const filename = firstNonEmptyString(
+      args.filename,
+      args["file-name"],
+      args.fileName,
+      path.basename(proposedPath),
+    );
+    const derivedTitle = firstNonEmptyString(
+      args.title,
+      String(proposedMarkdown.match(/^#\s+(.+)$/m)?.[1] || "").trim(),
+      path.basename(proposedPath, path.extname(proposedPath)),
+      "Linked PRD document",
+    );
+    const clientRef = firstNonEmptyString(args["client-ref"], args.clientRef, args.client_ref, filename);
+    changes.prd_document_addition = feedbackChange(null, {
+      source_markdown: proposedMarkdown,
+      title: derivedTitle,
+      filename,
+      client_ref: clientRef,
+    });
+  } else if (action === "edit" || action === "refine") {
     const title = firstNonEmptyString(args.title);
     if (title) changes.title = feedbackChange(firstNonEmptyString(item.title), title);
 
@@ -6730,7 +6777,7 @@ async function buildFeedbackDraftForCommand(args, subcommand) {
       }
     }
   } else {
-    console.error("Unknown feedback draft command. Use status, edit, assign, archive, or refine.");
+    console.error("Unknown feedback draft command. Use status, edit, document-add, assign, archive, or refine.");
     process.exit(1);
   }
 
@@ -7640,7 +7687,7 @@ async function runFeedback(args) {
     printHelp();
     return;
   }
-  if (["status", "edit", "assign", "archive", "refine"].includes(subcommand)) {
+  if (["status", "edit", "document-add", "assign", "archive", "refine"].includes(subcommand)) {
     await buildFeedbackDraftForCommand(args, subcommand);
     return;
   }
@@ -7688,7 +7735,7 @@ async function runFeedback(args) {
     await runFeedbackGetOrHistory(args, subcommand);
     return;
   }
-  console.error("Unknown feedback command. Use status, edit, assign, archive, submit, revise, reviews, review, move, comment, undo, prd-versions, prd-diff, get, history, validate, or apply.");
+  console.error("Unknown feedback command. Use status, edit, document-add, assign, archive, submit, revise, reviews, review, move, comment, undo, prd-versions, prd-diff, get, history, validate, or apply.");
   process.exit(1);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mytegroupinc/myte-core",
-  "version": "0.0.53",
+  "version": "0.0.54",
   "description": "Myte CLI core implementation.",
   "type": "commonjs",
   "main": "cli.js",